Merge pull request #1176 from Agoric/mk/offer-up-doc-updates

docs: update contract walkthru

Author: mujahidkay

main/guides/zoe/assets/trade-offer-safety-1.mmd

@@ -10,9 +10,9 @@ sequenceDiagram
   end
 
   box skyblue Contract Instance
-  participant C as gameAssetContract
+  participant C as offer-up.contract
   end
 
     A-)Zoe: getPublicFacet(instance)
     A-)+Zoe: getTerms(instance)
-    Zoe--)-A: { issuers, brands, joinPrice }
+    Zoe--)-A: { issuers, brands, tradePrice }

main/guides/zoe/assets/trade-offer-safety-1.svg

@@ -10,9 +10,9 @@ sequenceDiagram
   end
 
   box skyblue Contract
-  participant C as gameAssetContract
+  participant C as offer-up.contract
   end
 
-    A-)C: makeJoinInvitation()
+    A-)C: makeTradeInvitation()
     A-)Zoe: offer(toJoin, proposal, { Price })
-    A-)Zoe: E(seat).getPayout('Places')
+    A-)Zoe: E(seat).getPayout('Items')

main/guides/zoe/assets/trade-offer-safety-2.mmd

@@ -10,12 +10,12 @@ sequenceDiagram
   end
 
   box skyblue Contract
-  participant C as gameAssetContract
+  participant C as offer-up.contract
   end
 
-    A-)C: makeJoinInvitation()
+    A-)C: makeTradeInvitation()
     activate C
-    C--)Zoe: makeInvitation(joinHandler, ...)
+    C--)Zoe: makeInvitation(tradeHandler, ...)
     deactivate C
     activate Zoe
     Zoe--)-C: invitation
@@ -26,4 +26,4 @@ sequenceDiagram
 
     Zoe--)Zoe: escrow Price pmt
 
-    Zoe--)-C: joinHandler(gameSeat)
+    Zoe--)-C: tradeHandler(buyerSeat)

main/guides/zoe/assets/trade-offer-safety-2.svg

@@ -10,10 +10,10 @@ sequenceDiagram
   end
 
   box skyblue Contract
-  participant C as gameAssetContract
+  participant C as offer-up.contract
   end
 
-    Zoe--)C: joinHandler(gameSeat)
+    Zoe--)C: tradeHandler(buyerSeat)
     activate C
     C--)C: check proposal
     C--)Zoe: mintGains(want)
@@ -25,4 +25,4 @@ sequenceDiagram
 
     Zoe--)Zoe: check offer safety
 
-    C--)Zoe: playerSeat.exit(true)
+    C--)Zoe: buyerSeat.exit(true)

main/guides/zoe/assets/trade-offer-safety-3.mmd

@@ -10,11 +10,11 @@ sequenceDiagram
   end
 
   box skyblue Contract
-  participant C as gameAssetContract
+  participant C as offer-up.contract
   end
 
-    A-)+Zoe: E(seat).getPayout('Places')
+    A-)+Zoe: E(seat).getPayout('Items')
     Note over Zoe: ... many steps above ...
-    Zoe--)-A: placesPayment
-    A-)+Zoe: E(issuers.Place).getAmountOf(placesPayment)
-    Zoe--)-A: { brand: Place brand,<br> value: [['Park Place, 1n], ['Boardwalk', 1n]]
+    Zoe--)-A: itemsPayment
+    A-)+Zoe: E(issuers.Items).getAmountOf(itemsPayment)
+    Zoe--)-A: { brand: Item brand,<br> value: [['map', 1n], ['scroll', 1n]]