Vstorage journey - 4daydapp

[sufyaankhan]

User Story: As a Developer I should be able to read the docs and understand what vstorage is, how I can leverage vstorage, how it should be used in the context of the dapp-agorics-basics

E.g. vstorage is a journey of requesting powers within a core-eval, creating a storage node, passing the storage node in privateArgs to a contract, using the storage node within a contract, reading from vstorage via raw HTTPS or ui-kit.

There have also been requests to exhaustively document the hierarchy and schema of vstorage.

[dckc]

Querying VStorage has a relevant diagram. It only shows querying with agd and agoric follow, not HTTP nor ui-kit.

[dckc]

In order for a UI to show the remaining inventory, the contract should probably publish the allocation of inventorySeat to vstorage. @LuqiPan here's hoping I can have docs sufficient for you to do that after we land PR 8.

https://github.com/Agoric/dapp-agoric-basics/pull/8#discussion_r1486630828

[dckc]

@samsiegart just wrote:

the usual pattern is to write data to vstorage, return a publicSubscribers entry in the offer result corresponding to that path, then published.wallet.

.current will tell you which vstorage path to read to get your data for that offer.

[dckc]

Large overlap with these:

• 758

• 765

[dckc]

re vstorage reference docs, I'm leaving this somewhat obscure stuff to a vstorage discussion...

• https://github.com/Agoric/agoric-sdk/discussions/9115

[dckc]

more on reference docs...

• test-vstorage-ref.js.md WIP