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.

Agoric/dapp-agoric-basics#8 (comment)

[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:

• Document off-chain data lookup (aka vstorage RPC) #758
• Document how to read stored subscriptions for governance, metrics, etc #765

[dckc]

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

• what are the vstorage root keys other than 'published'? agoric-sdk#9115

[dckc]

more on reference docs...

• test-vstorage-ref.js.md WIP