Skip to content

Latest commit

 

History

History
92 lines (63 loc) · 2.55 KB

flowDiagram.md

File metadata and controls

92 lines (63 loc) · 2.55 KB
Raw

context: Agoric/agoric-sdk#4657

Story: seller1 is a venue with tickets in section1, section2, ... the price for all tickets in section1 is the same but maybe different from the price in section2.

Deploy script:

sequenceDiagram

actor seller1
participant Zoe

seller1 ->> Zoe: install contract
seller1 ->> Zoe: start contract
Zoe -->> seller1: creatorInvitation
Loading 
sequenceDiagram

dapp ->> walletBridge: offer(invitationQuery, {want: NFT amounts, give: 0})
Zoe -->> dapp: mintSeat
dapp ->> mintSeat: getPayout("Tickets")
mintSeat -->> dapp: tickets

dapp ->> mintSeat: getOfferResult
mintSeat -->> dapp: { invitationMakers: { "List": .. }}

dapp ->> walletBridge: continuingOffer(priorOfferId: ...,  description: "List")

dapp ->> Zoe: offer(listingInvitation1, {want: $10, give: section1NFTx100})
Zoe -->> dapp: section1seat
Loading

Buyer buys ticket:

sequenceDiagram
actor buyer1

buyer1 ->> contract: getBuyerInvitation({ section: 1, qty: 3})
contract -->> buyer1: buyInvitation3

buyer1 ->> Zoe: offer(buyInvitation3, {give: $30, want: makeCopyBag(section1, 3)})
Zoe -->> buyer1: buyerSeat1
buyer1 ->> buyerSeat1: getPayout("Ticket")
buyerSeat1 -->> buyer1: 3 tickets in section1
Loading

Semi-fungible tokens

We're familiar with: AmountMath.make(simoleans, 10)

If you have 100 seats in section1 that you consider equivalent, you can do:

AmountMath.make(seatBrand, makeCopyBag("section1", 100))

Some code suggests that a harden() is needed:

AmountMath.make(seatBrand, harden(makeCopyBag("section1", 100)))

test-attestation has some examples.

Continuing Invitation Pattern

contract part: offer result includes:

    invitationMakers: Far('invitation makers', {
      AdjustBalances: vault.makeAdjustBalancesInvitation,
      CloseVault: vault.makeCloseInvitation,
      TransferVault: vault.makeTransferInvitation,
    }),

https://github.com/Agoric/agoric-sdk/blob/master/packages/run-protocol/src/vaultFactory/vaultKit.js

dapp part: to act on the result of a previous offer:

    continuingInvitation: {
      priorOfferId: vaultToManageId,
      description: 'AdjustBalances',
    },

https://github.com/Agoric/dapp-treasury/blob/main/ui/src/components/vault/VaultManagement/makeAdjustVaultOffer.js

an example of a dapp using an invitationQuery: https://github.com/Agoric/agoric-sdk/blob/104fbfe120990cd9d1f81c436aa176017e7df7f8/packages/wallet/api/test/test-lib-wallet.js#L1148-L1173