@agoric/client-utils 0.1.1-other-dev-3eb1a1d.0 → 0.1.1-other-dev-d15096d.0.d15096d

package/dist/tsconfig.build.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/chain.js","../src/cli.js","../src/clients.js","../src/clock-timer.js","../src/main.ts","../src/marshalTables.js","../src/network-config.js","../src/rpc.js","../src/signing-client.ts","../src/signing-smart-wallet-kit.ts","../src/smart-wallet-kit.js","../src/sync-tools.js","../src/types.ts","../src/vstorage-kit.js","../src/vstorage.js","../src/wallet-utils.js","../src/codegen/binary.ts","../src/codegen/decimals.ts","../src/codegen/helpers.ts","../src/codegen/index.ts","../src/codegen/json-safe.ts","../src/codegen/utf8.ts","../src/codegen/varint.ts","../src/codegen/agoric/bundle.ts","../src/codegen/agoric/rpc.query.ts","../src/codegen/agoric/rpc.tx.ts","../src/codegen/agoric/swingset/genesis.ts","../src/codegen/agoric/swingset/msgs.rpc.msg.ts","../src/codegen/agoric/swingset/msgs.ts","../src/codegen/agoric/swingset/query.rpc.Query.ts","../src/codegen/agoric/swingset/query.ts","../src/codegen/agoric/swingset/swingset.ts","../src/codegen/agoric/vbank/genesis.ts","../src/codegen/agoric/vbank/msgs.ts","../src/codegen/agoric/vbank/query.rpc.Query.ts","../src/codegen/agoric/vbank/query.ts","../src/codegen/agoric/vbank/vbank.ts","../src/codegen/agoric/vibc/msgs.rpc.msg.ts","../src/codegen/agoric/vibc/msgs.ts","../src/codegen/agoric/vlocalchain/vlocalchain.ts","../src/codegen/agoric/vstorage/genesis.ts","../src/codegen/agoric/vstorage/query.rpc.Query.ts","../src/codegen/agoric/vstorage/query.ts","../src/codegen/agoric/vstorage/vstorage.ts","../src/codegen/agoric/vtransfer/genesis.ts","../src/codegen/amino/amino.ts","../src/codegen/amino/bundle.ts","../src/codegen/circle/bundle.ts","../src/codegen/circle/rpc.query.ts","../src/codegen/circle/rpc.tx.ts","../src/codegen/circle/cctp/v1/attester.ts","../src/codegen/circle/cctp/v1/burn_message.ts","../src/codegen/circle/cctp/v1/burning_and_minting_paused.ts","../src/codegen/circle/cctp/v1/events.ts","../src/codegen/circle/cctp/v1/genesis.ts","../src/codegen/circle/cctp/v1/max_message_body_size.ts","../src/codegen/circle/cctp/v1/message.ts","../src/codegen/circle/cctp/v1/nonce.ts","../src/codegen/circle/cctp/v1/per_message_burn_limit.ts","../src/codegen/circle/cctp/v1/query.rpc.Query.ts","../src/codegen/circle/cctp/v1/query.ts","../src/codegen/circle/cctp/v1/remote_token_messenger.ts","../src/codegen/circle/cctp/v1/sending_and_receiving_messages_paused.ts","../src/codegen/circle/cctp/v1/signature_threshold.ts","../src/codegen/circle/cctp/v1/token_pair.ts","../src/codegen/circle/cctp/v1/tx.rpc.msg.ts","../src/codegen/circle/cctp/v1/tx.ts","../src/codegen/cosmos/bundle.ts","../src/codegen/cosmos/rpc.query.ts","../src/codegen/cosmos/rpc.tx.ts","../src/codegen/cosmos/app/runtime/v1alpha1/module.ts","../src/codegen/cosmos/app/v1alpha1/module.ts","../src/codegen/cosmos/auth/module/v1/module.ts","../src/codegen/cosmos/auth/v1beta1/auth.ts","../src/codegen/cosmos/auth/v1beta1/genesis.ts","../src/codegen/cosmos/auth/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/auth/v1beta1/query.ts","../src/codegen/cosmos/auth/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/auth/v1beta1/tx.ts","../src/codegen/cosmos/authz/module/v1/module.ts","../src/codegen/cosmos/authz/v1beta1/authz.ts","../src/codegen/cosmos/authz/v1beta1/event.ts","../src/codegen/cosmos/authz/v1beta1/genesis.ts","../src/codegen/cosmos/authz/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/authz/v1beta1/query.ts","../src/codegen/cosmos/authz/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/authz/v1beta1/tx.ts","../src/codegen/cosmos/bank/module/v1/module.ts","../src/codegen/cosmos/bank/v1beta1/authz.ts","../src/codegen/cosmos/bank/v1beta1/bank.ts","../src/codegen/cosmos/bank/v1beta1/genesis.ts","../src/codegen/cosmos/bank/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/bank/v1beta1/query.ts","../src/codegen/cosmos/bank/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/bank/v1beta1/tx.ts","../src/codegen/cosmos/base/abci/v1beta1/abci.ts","../src/codegen/cosmos/base/node/v1beta1/query.rpc.Service.ts","../src/codegen/cosmos/base/node/v1beta1/query.ts","../src/codegen/cosmos/base/query/v1beta1/pagination.ts","../src/codegen/cosmos/base/reflection/v2alpha1/reflection.ts","../src/codegen/cosmos/base/v1beta1/coin.ts","../src/codegen/cosmos/circuit/module/v1/module.ts","../src/codegen/cosmos/circuit/v1/query.rpc.Query.ts","../src/codegen/cosmos/circuit/v1/query.ts","../src/codegen/cosmos/circuit/v1/tx.rpc.msg.ts","../src/codegen/cosmos/circuit/v1/tx.ts","../src/codegen/cosmos/circuit/v1/types.ts","../src/codegen/cosmos/consensus/module/v1/module.ts","../src/codegen/cosmos/consensus/v1/query.rpc.Query.ts","../src/codegen/cosmos/consensus/v1/query.ts","../src/codegen/cosmos/consensus/v1/tx.rpc.msg.ts","../src/codegen/cosmos/consensus/v1/tx.ts","../src/codegen/cosmos/crisis/module/v1/module.ts","../src/codegen/cosmos/crypto/ed25519/keys.ts","../src/codegen/cosmos/crypto/hd/v1/hd.ts","../src/codegen/cosmos/crypto/keyring/v1/record.ts","../src/codegen/cosmos/crypto/multisig/keys.ts","../src/codegen/cosmos/crypto/multisig/v1beta1/multisig.ts","../src/codegen/cosmos/crypto/secp256k1/keys.ts","../src/codegen/cosmos/crypto/secp256r1/keys.ts","../src/codegen/cosmos/distribution/module/v1/module.ts","../src/codegen/cosmos/distribution/v1beta1/distribution.ts","../src/codegen/cosmos/distribution/v1beta1/genesis.ts","../src/codegen/cosmos/distribution/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/distribution/v1beta1/query.ts","../src/codegen/cosmos/distribution/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/distribution/v1beta1/tx.ts","../src/codegen/cosmos/evidence/module/v1/module.ts","../src/codegen/cosmos/feegrant/module/v1/module.ts","../src/codegen/cosmos/feegrant/v1beta1/feegrant.ts","../src/codegen/cosmos/feegrant/v1beta1/genesis.ts","../src/codegen/cosmos/feegrant/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/feegrant/v1beta1/query.ts","../src/codegen/cosmos/feegrant/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/feegrant/v1beta1/tx.ts","../src/codegen/cosmos/genutil/module/v1/module.ts","../src/codegen/cosmos/gov/module/v1/module.ts","../src/codegen/cosmos/gov/v1/genesis.ts","../src/codegen/cosmos/gov/v1/gov.ts","../src/codegen/cosmos/gov/v1/query.rpc.Query.ts","../src/codegen/cosmos/gov/v1/query.ts","../src/codegen/cosmos/gov/v1/tx.rpc.msg.ts","../src/codegen/cosmos/gov/v1/tx.ts","../src/codegen/cosmos/gov/v1beta1/genesis.ts","../src/codegen/cosmos/gov/v1beta1/gov.ts","../src/codegen/cosmos/gov/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/gov/v1beta1/query.ts","../src/codegen/cosmos/gov/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/gov/v1beta1/tx.ts","../src/codegen/cosmos/group/module/v1/module.ts","../src/codegen/cosmos/group/v1/events.ts","../src/codegen/cosmos/group/v1/genesis.ts","../src/codegen/cosmos/group/v1/query.rpc.Query.ts","../src/codegen/cosmos/group/v1/query.ts","../src/codegen/cosmos/group/v1/tx.rpc.msg.ts","../src/codegen/cosmos/group/v1/tx.ts","../src/codegen/cosmos/group/v1/types.ts","../src/codegen/cosmos/ics23/v1/proofs.ts","../src/codegen/cosmos/mint/module/v1/module.ts","../src/codegen/cosmos/mint/v1beta1/genesis.ts","../src/codegen/cosmos/mint/v1beta1/mint.ts","../src/codegen/cosmos/mint/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/mint/v1beta1/query.ts","../src/codegen/cosmos/mint/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/mint/v1beta1/tx.ts","../src/codegen/cosmos/msg/textual/v1/textual.ts","../src/codegen/cosmos/msg/v1/msg.ts","../src/codegen/cosmos/nft/module/v1/module.ts","../src/codegen/cosmos/params/module/v1/module.ts","../src/codegen/cosmos/params/v1beta1/params.ts","../src/codegen/cosmos/params/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/params/v1beta1/query.ts","../src/codegen/cosmos/query/v1/query.ts","../src/codegen/cosmos/reflection/v1/reflection.ts","../src/codegen/cosmos/slashing/module/v1/module.ts","../src/codegen/cosmos/staking/module/v1/module.ts","../src/codegen/cosmos/staking/v1beta1/authz.ts","../src/codegen/cosmos/staking/v1beta1/genesis.ts","../src/codegen/cosmos/staking/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/staking/v1beta1/query.ts","../src/codegen/cosmos/staking/v1beta1/staking.ts","../src/codegen/cosmos/staking/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/staking/v1beta1/tx.ts","../src/codegen/cosmos/store/internal/kv/v1beta1/kv.ts","../src/codegen/cosmos/store/snapshots/v1/snapshot.ts","../src/codegen/cosmos/store/streaming/abci/grpc.ts","../src/codegen/cosmos/store/v1beta1/commit_info.ts","../src/codegen/cosmos/store/v1beta1/listening.ts","../src/codegen/cosmos/tx/config/v1/config.ts","../src/codegen/cosmos/tx/signing/v1beta1/signing.ts","../src/codegen/cosmos/tx/v1beta1/service.rpc.Service.ts","../src/codegen/cosmos/tx/v1beta1/service.ts","../src/codegen/cosmos/tx/v1beta1/tx.ts","../src/codegen/cosmos/upgrade/module/v1/module.ts","../src/codegen/cosmos/upgrade/v1beta1/query.rpc.Query.ts","../src/codegen/cosmos/upgrade/v1beta1/query.ts","../src/codegen/cosmos/upgrade/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/upgrade/v1beta1/tx.ts","../src/codegen/cosmos/upgrade/v1beta1/upgrade.ts","../src/codegen/cosmos/vesting/module/v1/module.ts","../src/codegen/cosmos/vesting/v1beta1/tx.rpc.msg.ts","../src/codegen/cosmos/vesting/v1beta1/tx.ts","../src/codegen/cosmos/vesting/v1beta1/vesting.ts","../src/codegen/cosmos_proto/bundle.ts","../src/codegen/cosmos_proto/cosmos.ts","../src/codegen/gogoproto/bundle.ts","../src/codegen/gogoproto/gogo.ts","../src/codegen/google/bundle.ts","../src/codegen/google/api/annotations.ts","../src/codegen/google/api/http.ts","../src/codegen/google/protobuf/any.ts","../src/codegen/google/protobuf/descriptor.ts","../src/codegen/google/protobuf/duration.ts","../src/codegen/google/protobuf/empty.ts","../src/codegen/google/protobuf/timestamp.ts","../src/codegen/ibc/bundle.ts","../src/codegen/ibc/rpc.query.ts","../src/codegen/ibc/rpc.tx.ts","../src/codegen/ibc/applications/interchain_accounts/controller/v1/controller.ts","../src/codegen/ibc/applications/interchain_accounts/controller/v1/query.rpc.Query.ts","../src/codegen/ibc/applications/interchain_accounts/controller/v1/query.ts","../src/codegen/ibc/applications/interchain_accounts/controller/v1/tx.rpc.msg.ts","../src/codegen/ibc/applications/interchain_accounts/controller/v1/tx.ts","../src/codegen/ibc/applications/interchain_accounts/genesis/v1/genesis.ts","../src/codegen/ibc/applications/interchain_accounts/host/v1/host.ts","../src/codegen/ibc/applications/interchain_accounts/host/v1/query.rpc.Query.ts","../src/codegen/ibc/applications/interchain_accounts/host/v1/query.ts","../src/codegen/ibc/applications/interchain_accounts/host/v1/tx.rpc.msg.ts","../src/codegen/ibc/applications/interchain_accounts/host/v1/tx.ts","../src/codegen/ibc/applications/interchain_accounts/v1/account.ts","../src/codegen/ibc/applications/interchain_accounts/v1/metadata.ts","../src/codegen/ibc/applications/interchain_accounts/v1/packet.ts","../src/codegen/ibc/applications/transfer/v1/authz.ts","../src/codegen/ibc/applications/transfer/v1/genesis.ts","../src/codegen/ibc/applications/transfer/v1/query.rpc.Query.ts","../src/codegen/ibc/applications/transfer/v1/query.ts","../src/codegen/ibc/applications/transfer/v1/transfer.ts","../src/codegen/ibc/applications/transfer/v1/tx.rpc.msg.ts","../src/codegen/ibc/applications/transfer/v1/tx.ts","../src/codegen/ibc/applications/transfer/v2/packet.ts","../src/codegen/ibc/core/channel/v1/channel.ts","../src/codegen/ibc/core/channel/v1/genesis.ts","../src/codegen/ibc/core/channel/v1/query.rpc.Query.ts","../src/codegen/ibc/core/channel/v1/query.ts","../src/codegen/ibc/core/channel/v1/tx.rpc.msg.ts","../src/codegen/ibc/core/channel/v1/tx.ts","../src/codegen/ibc/core/channel/v1/upgrade.ts","../src/codegen/ibc/core/client/v1/client.ts","../src/codegen/ibc/core/client/v1/genesis.ts","../src/codegen/ibc/core/client/v1/query.rpc.Query.ts","../src/codegen/ibc/core/client/v1/query.ts","../src/codegen/ibc/core/client/v1/tx.rpc.msg.ts","../src/codegen/ibc/core/client/v1/tx.ts","../src/codegen/ibc/core/commitment/v1/commitment.ts","../src/codegen/ibc/core/connection/v1/connection.ts","../src/codegen/ibc/core/connection/v1/genesis.ts","../src/codegen/ibc/core/connection/v1/query.rpc.Query.ts","../src/codegen/ibc/core/connection/v1/query.ts","../src/codegen/ibc/core/connection/v1/tx.rpc.msg.ts","../src/codegen/ibc/core/connection/v1/tx.ts","../src/codegen/ibc/lightclients/localhost/v1/localhost.ts","../src/codegen/ibc/lightclients/localhost/v2/localhost.ts","../src/codegen/ibc/lightclients/solomachine/v1/solomachine.ts","../src/codegen/ibc/lightclients/solomachine/v2/solomachine.ts","../src/codegen/ibc/lightclients/solomachine/v3/solomachine.ts","../src/codegen/ibc/lightclients/tendermint/v1/tendermint.ts","../src/codegen/ibc/lightclients/wasm/v1/genesis.ts","../src/codegen/ibc/lightclients/wasm/v1/query.rpc.Query.ts","../src/codegen/ibc/lightclients/wasm/v1/query.ts","../src/codegen/ibc/lightclients/wasm/v1/tx.rpc.msg.ts","../src/codegen/ibc/lightclients/wasm/v1/tx.ts","../src/codegen/ibc/lightclients/wasm/v1/wasm.ts","../src/codegen/icq/bundle.ts","../src/codegen/icq/rpc.query.ts","../src/codegen/icq/rpc.tx.ts","../src/codegen/icq/v1/genesis.ts","../src/codegen/icq/v1/icq.ts","../src/codegen/icq/v1/packet.ts","../src/codegen/icq/v1/query.rpc.Query.ts","../src/codegen/icq/v1/query.ts","../src/codegen/icq/v1/tx.rpc.msg.ts","../src/codegen/icq/v1/tx.ts","../src/codegen/noble/bundle.ts","../src/codegen/noble/rpc.tx.ts","../src/codegen/noble/dollar/vaults/v1/tx.rpc.msg.ts","../src/codegen/noble/dollar/vaults/v1/tx.ts","../src/codegen/noble/dollar/vaults/v1/vaults.ts","../src/codegen/noble/swap/v1/algorithm.ts","../src/codegen/noble/swap/v1/swap.ts","../src/codegen/noble/swap/v1/tx.rpc.msg.ts","../src/codegen/noble/swap/v1/tx.ts","../src/codegen/stride/bundle.ts","../src/codegen/stride/rpc.query.ts","../src/codegen/stride/rpc.tx.ts","../src/codegen/stride/epochs/genesis.ts","../src/codegen/stride/epochs/query.rpc.Query.ts","../src/codegen/stride/epochs/query.ts","../src/codegen/stride/records/callbacks.ts","../src/codegen/stride/records/genesis.ts","../src/codegen/stride/records/params.ts","../src/codegen/stride/records/query.rpc.Query.ts","../src/codegen/stride/records/query.ts","../src/codegen/stride/records/records.ts","../src/codegen/stride/stakedym/genesis.ts","../src/codegen/stride/stakedym/query.rpc.Query.ts","../src/codegen/stride/stakedym/query.ts","../src/codegen/stride/stakedym/stakedym.ts","../src/codegen/stride/stakedym/tx.rpc.msg.ts","../src/codegen/stride/stakedym/tx.ts","../src/codegen/stride/stakeibc/address_unbonding.ts","../src/codegen/stride/stakeibc/callbacks.ts","../src/codegen/stride/stakeibc/epoch_tracker.ts","../src/codegen/stride/stakeibc/genesis.ts","../src/codegen/stride/stakeibc/gov.ts","../src/codegen/stride/stakeibc/host_zone.ts","../src/codegen/stride/stakeibc/ica_account.ts","../src/codegen/stride/stakeibc/packet.ts","../src/codegen/stride/stakeibc/params.ts","../src/codegen/stride/stakeibc/query.rpc.Query.ts","../src/codegen/stride/stakeibc/query.ts","../src/codegen/stride/stakeibc/trade_route.ts","../src/codegen/stride/stakeibc/tx.rpc.msg.ts","../src/codegen/stride/stakeibc/tx.ts","../src/codegen/stride/stakeibc/validator.ts","../src/codegen/stride/staketia/genesis.ts","../src/codegen/stride/staketia/query.rpc.Query.ts","../src/codegen/stride/staketia/query.ts","../src/codegen/stride/staketia/staketia.ts","../src/codegen/stride/staketia/tx.rpc.msg.ts","../src/codegen/stride/staketia/tx.ts","../src/codegen/tendermint/bundle.ts","../src/codegen/tendermint/abci/types.ts","../src/codegen/tendermint/crypto/keys.ts","../src/codegen/tendermint/crypto/proof.ts","../src/codegen/tendermint/libs/bits/types.ts","../src/codegen/tendermint/p2p/types.ts","../src/codegen/tendermint/types/block.ts","../src/codegen/tendermint/types/evidence.ts","../src/codegen/tendermint/types/params.ts","../src/codegen/tendermint/types/types.ts","../src/codegen/tendermint/types/validator.ts","../src/codegen/tendermint/version/types.ts"],"version":"5.9.3"}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+import type { Brand, Issuer } from '@agoric/ertp';
+import type { ContractRecord, FeeConfig, PoolMetrics, TransactionRecord } from '@agoric/fast-usdc';
+import type { OutcomeRecord, QuestionDetails } from '@agoric/governance/src/types.js';
+import type { BookDataNotification } from '@agoric/inter-protocol/src/auction/auctionBook.js';
+import type { AuctionParamRecord } from '@agoric/inter-protocol/src/auction/params.js';
+import type { ScheduleNotification } from '@agoric/inter-protocol/src/auction/scheduler.js';
+import type { MetricsNotification as VaultDirectorMetrics } from '@agoric/inter-protocol/src/vaultFactory/vaultDirector.js';
+import type { CurrentWalletRecord, UpdateRecord } from '@agoric/smart-wallet/src/smartWallet.js';
+import type { AssetInfo } from '@agoric/vats/src/vat-bank.js';
+import type { StatusFor } from '@aglocal/portfolio-contract/src/type-guards.js';
+import type { Installation, Instance } from '@agoric/zoe/src/zoeService/types.js';
+type PublishedTypeMap = {
+    'auction.governance': {
+        current: AuctionParamRecord;
+    };
+    'auction.schedule': ScheduleNotification;
+    'vaultFactory.metrics': VaultDirectorMetrics;
+    'agoricNames.installation': Array<[string, Installation]>;
+    'agoricNames.instance': Array<[string, Instance]>;
+    'agoricNames.brand': Array<[string, Brand]>;
+    'agoricNames.issuer': Array<[string, Issuer]>;
+    'agoricNames.vbankAsset': Array<[string, AssetInfo]>;
+    fastUsdc: ContractRecord;
+    'fastUsdc.feeConfig': FeeConfig;
+    'fastUsdc.poolMetrics': PoolMetrics;
+    ymax0: StatusFor['contract'];
+    ymax1: StatusFor['contract'];
+    'ymax0.portfolios': StatusFor['portfolios'];
+    'ymax1.portfolios': StatusFor['portfolios'];
+};
+/**
+ * Utility type to the type that would result from unmarshalling the latest
+ * value at a vstorage `published` path.
+ */
+export type TypedPublished<T extends string> = T extends keyof PublishedTypeMap ? PublishedTypeMap[T] : T extends `wallet.${string}.current` ? CurrentWalletRecord : T extends `wallet.${string}` ? UpdateRecord : T extends `ymax${'0' | '1'}.portfolios.portfolio${number}` ? StatusFor['portfolio'] : T extends `ymax${'0' | '1'}.portfolios.portfolio${number}.positions.${string}` ? StatusFor['position'] : T extends `ymax${'0' | '1'}.portfolios.portfolio${number}.pendingTx.tx${number}` ? StatusFor['pendingTx'] : T extends `ymax${'0' | '1'}.portfolios.portfolio${number}.flows.flow${number}` ? StatusFor['flow'] : T extends `ymax${'0' | '1'}.portfolios.portfolio${number}.flows.flow${number}.steps` ? StatusFor['flowSteps'] : T extends `committees.${string}.latestQuestion` ? QuestionDetails : T extends `committees.${string}.latestOutcome` ? OutcomeRecord : T extends `vaultFactory.managers.manager${number}.metrics` ? VaultDirectorMetrics : T extends `fastUsdc.txns.${string}` ? TransactionRecord : T extends `auction.book${number}` ? BookDataNotification : unknown;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAChB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,IAAI,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAC5H,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACb,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACT,MAAM,qCAAqC,CAAC;AAG7C,KAAK,gBAAgB,GAAG;IACtB,oBAAoB,EAAE;QAAE,OAAO,EAAE,kBAAkB,CAAA;KAAE,CAAC;IACtD,kBAAkB,EAAE,oBAAoB,CAAC;IACzC,sBAAsB,EAAE,oBAAoB,CAAC;IAC7C,0BAA0B,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC1D,sBAAsB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClD,mBAAmB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5C,oBAAoB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,wBAAwB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACrD,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB,EAAE,SAAS,CAAC;IAChC,sBAAsB,EAAE,WAAW,CAAC;IACpC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7B,kBAAkB,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAC5C,kBAAkB,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,gBAAgB,GAC3E,gBAAgB,CAAC,CAAC,CAAC,GACnB,CAAC,SAAS,UAAU,MAAM,UAAU,GAClC,mBAAmB,GACnB,CAAC,SAAS,UAAU,MAAM,EAAE,GAC1B,YAAY,GACZ,CAAC,SAAS,OAAO,GAAG,GAAG,GAAG,wBAAwB,MAAM,EAAE,GACxD,SAAS,CAAC,WAAW,CAAC,GACtB,CAAC,SAAS,OAAO,GAAG,GAAG,GAAG,wBAAwB,MAAM,cAAc,MAAM,EAAE,GAC5E,SAAS,CAAC,UAAU,CAAC,GACrB,CAAC,SAAS,OAAO,GAAG,GAAG,GAAG,wBAAwB,MAAM,gBAAgB,MAAM,EAAE,GAC9E,SAAS,CAAC,WAAW,CAAC,GACtB,CAAC,SAAS,OAAO,GAAG,GAAG,GAAG,wBAAwB,MAAM,cAAc,MAAM,EAAE,GAC5E,SAAS,CAAC,MAAM,CAAC,GACjB,CAAC,SAAS,OAAO,GAAG,GAAG,GAAG,wBAAwB,MAAM,cAAc,MAAM,QAAQ,GAClF,SAAS,CAAC,WAAW,CAAC,GACtB,CAAC,SAAS,cAAc,MAAM,iBAAiB,GAC7C,eAAe,GACf,CAAC,SAAS,cAAc,MAAM,gBAAgB,GAC5C,aAAa,GACb,CAAC,SAAS,gCAAgC,MAAM,UAAU,GACxD,oBAAoB,GACpB,CAAC,SAAS,iBAAiB,MAAM,EAAE,GACjC,iBAAiB,GACjB,CAAC,SAAS,eAAe,MAAM,EAAE,GAC/B,oBAAoB,GACpB,OAAO,CAAC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+// @file types for the client-utils package
+// NB: this doesn't follow best practices for TS in JS because this package will likely soon be written in TS
+export {};
+// static string keys are defined in PublishedTypeMap
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,6GAA6G;;AA8E7G,qDAAqD"}

package/dist/vstorage-kit.d.ts

@@ -0,0 +1,59 @@
+export { boardSlottingMarshaller };
+export function makeFromBoard(): {
+    convertSlotToVal: (boardId: any, iface: any) => any;
+};
+export namespace storageHelper {
+    function parseCapData(txt: {
+        value: string;
+    } | string): {
+        blockHeight: any;
+        capDatas: {
+            body: string;
+            slots: string[];
+        }[];
+    };
+    function unserializeTxt(txt: {
+        value: string;
+    } | string, ctx: IdMap): any[];
+    function parseMany(capDataStrings: string[]): {
+        body: string;
+        slots: string[];
+    }[];
+}
+export function makeAgoricNames(ctx: IdMap, vstorage: VStorage): Promise<AgoricNamesRemotes>;
+export function makeVstorageKit({ fetch }: {
+    fetch: typeof window.fetch;
+}, networkConfig: MinimalNetworkConfig): {
+    fromBoard: {
+        convertSlotToVal: (boardId: any, iface: any) => any;
+    };
+    marshaller: Omit<import("@endo/marshal").Marshal<any>, "serialize" | "unserialize">;
+    networkConfig: MinimalNetworkConfig;
+    readLatestHead: (path: string) => Promise<T>;
+    readPublished: <T extends string>(subpath: T) => Promise<TypedPublished<T>>;
+    unserializeHead: (txt: string | {
+        value: string;
+    }) => unknown;
+    vstorage: {
+        readStorageMeta: <T extends "children" | "data">(path?: string, { kind, height }?: {
+            kind?: T | undefined;
+            height?: number | bigint | undefined;
+        }) => Promise<T extends "children" ? QueryChildrenMetaResponse : QueryDataMetaResponse>;
+        readStorage: <T extends "children" | "data">(path?: string, opts?: {
+            kind?: T | undefined;
+            height?: number | bigint | undefined;
+        }) => Promise<T extends "children" ? import("@agoric/cosmic-proto/agoric/vstorage/query.js").QueryChildrenResponse : import("@agoric/cosmic-proto/agoric/vstorage/query.js").QueryDataResponse>;
+        readLatest(path?: string): Promise<import("@agoric/cosmic-proto/agoric/vstorage/query.js").QueryDataResponse>;
+        keys(path?: string): Promise<string[]>;
+        readAt(path: string, height?: number): Promise<import("@agoric/internal/src/lib-chainStorage.js").StreamCell<unknown>>;
+        readFully(path: string, minHeight?: number | string): Promise<string[]>;
+    };
+};
+export type IdMap = ReturnType<typeof makeFromBoard>;
+export type VstorageKit = ReturnType<typeof makeVstorageKit>;
+import { boardSlottingMarshaller } from '@agoric/vats/tools/board-utils.js';
+import type { VStorage } from './vstorage.js';
+import type { AgoricNamesRemotes } from '@agoric/vats/tools/board-utils.js';
+import type { MinimalNetworkConfig } from './network-config.js';
+import type { TypedPublished } from './types.js';
+//# sourceMappingURL=vstorage-kit.d.ts.map

package/dist/vstorage-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vstorage-kit.d.ts","sourceRoot":"","sources":["../src/vstorage-kit.js"],"names":[],"mappings":";AAkBO;;EAWN;;IAMe,2BADD;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GAAG,MAAM;;;kBAuBhB,MAAM;mBAAS,MAAM,EAAE;;MAd3C;IAKe,6BAHJ;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GAAG,MAAM,OACzB,KAAK,SAOf;IAEU,mCADC,MAAM,EAAE;cAGC,MAAM;eAAS,MAAM,EAAE;QAS3C;;AAUI,qCAJI,KAAK,YACL,QAAQ,GACN,OAAO,CAAC,kBAAkB,CAAC,CAqBvC;AAMM,2CAHI;IAAE,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,CAAA;CAAE,iBAC9B,oBAAoB;;;;;;2BAgBV,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC;oBAc3B,CAAC,SAAS,MAAM,WAAW,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;2BArBrD,MAAM,GAAG;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,KAAK,OAAO;;;;;;;;;;;;;;;EAuCxD;oBArHa,UAAU,CAAC,OAAO,aAAa,CAAC;0BAsHhC,UAAU,CAAC,OAAO,eAAe,CAAC;wCAjJzC,mCAAmC;8BASf,eAAe;wCACL,mCAAmC;0CAHjC,qBAAqB;oCAC3B,YAAY"}

package/dist/vstorage-kit.js

@@ -0,0 +1,130 @@
+import { boardSlottingMarshaller, makeBoardRemote, } from '@agoric/vats/tools/board-utils.js';
+import { assertAllDefined } from '@agoric/internal';
+import { makeVStorage } from './vstorage.js';
+export { boardSlottingMarshaller };
+/**
+ * @import {MinimalNetworkConfig} from './network-config.js';
+ * @import {TypedPublished} from './types.js';
+ * @import {VStorage} from './vstorage.js';
+ * @import {AgoricNamesRemotes} from '@agoric/vats/tools/board-utils.js';
+ * @import {BoardRemote} from '@agoric/vats/tools/board-utils.js';
+ */
+/** @deprecated */
+export const makeFromBoard = () => {
+    const cache = new Map();
+    const convertSlotToVal = (boardId, iface) => {
+        if (cache.has(boardId)) {
+            return cache.get(boardId);
+        }
+        const val = makeBoardRemote({ boardId, iface });
+        cache.set(boardId, val);
+        return val;
+    };
+    return harden({ convertSlotToVal });
+};
+/** @typedef {ReturnType<typeof makeFromBoard>} IdMap */
+/** @deprecated */
+export const storageHelper = {
+    /** @param { {value: string} | string } txt */
+    parseCapData: txt => {
+        /** @type {{ value: string }} */
+        const { value } = typeof txt === 'string' ? JSON.parse(txt) : txt;
+        const specimen = JSON.parse(value);
+        const { blockHeight, values } = specimen;
+        assert(values, `empty values in specimen ${value}`);
+        const capDatas = storageHelper.parseMany(values);
+        return { blockHeight, capDatas };
+    },
+    /**
+     * @param { {value: string} | string } txt
+     * @param {IdMap} ctx
+     */
+    unserializeTxt: (txt, ctx) => {
+        const { capDatas } = storageHelper.parseCapData(txt);
+        return capDatas.map(capData => boardSlottingMarshaller(ctx.convertSlotToVal).fromCapData(capData));
+    },
+    /** @param {string[]} capDataStrings array of stringified capData */
+    parseMany: capDataStrings => {
+        assert(capDataStrings && capDataStrings.length);
+        /** @type {{ body: string, slots: string[] }[]} */
+        const capDatas = capDataStrings.map(s => JSON.parse(s));
+        for (const capData of capDatas) {
+            assert(typeof capData === 'object' && capData !== null);
+            assert('body' in capData && 'slots' in capData);
+            assert(typeof capData.body === 'string');
+            assert(Array.isArray(capData.slots));
+        }
+        return capDatas;
+    },
+};
+harden(storageHelper);
+/**
+ * @deprecated
+ * @param {IdMap} ctx
+ * @param {VStorage} vstorage
+ * @returns {Promise<AgoricNamesRemotes>}
+ */
+export const makeAgoricNames = async (ctx, vstorage) => {
+    assertAllDefined({ ctx, vstorage });
+    const reverse = {};
+    const entries = await Promise.all(['brand', 'instance', 'vbankAsset'].map(async (kind) => {
+        const content = await vstorage.readLatest(`published.agoricNames.${kind}`);
+        /** @type {Array<[string, BoardRemote]>} */
+        const parts = storageHelper.unserializeTxt(content, ctx).at(-1);
+        for (const [name, remote] of parts) {
+            if ('getBoardId' in remote) {
+                reverse[remote.getBoardId()] = name;
+            }
+        }
+        return [kind, Object.fromEntries(parts)];
+    }));
+    return { ...Object.fromEntries(entries), reverse };
+};
+/**
+ * @param {{ fetch: typeof window.fetch }} io
+ * @param {MinimalNetworkConfig} networkConfig
+ */
+export const makeVstorageKit = ({ fetch }, networkConfig) => {
+    try {
+        const vstorage = makeVStorage({ fetch }, networkConfig);
+        const fromBoard = makeFromBoard();
+        const marshaller = boardSlottingMarshaller(fromBoard.convertSlotToVal);
+        /** @type {(txt: string | {value: string}) => unknown} */
+        const unserializeHead = txt => storageHelper.unserializeTxt(txt, fromBoard).at(-1);
+        /**
+         * Read latest at path and unmarshal it
+         * @template T
+         * @type {(path: string) => Promise<T>}
+         */
+        const readLatestHead = path => 
+        // @ts-expect-error cast
+        vstorage.readLatest(path).then(unserializeHead);
+        /**
+         * Read latest at published path and unmarshal it.
+         *
+         * Note this does not perform a runtime check to verify the shape. The
+         * static types come from the spec of what is supposed to be written to
+         * vstorage, which is validated in testing of the chain code that is run
+         * in consensus.
+         *
+         * @type {<T extends string>(subpath: T) => Promise<TypedPublished<T>>}
+         */
+        const readPublished = subpath => 
+        // @ts-expect-error cast
+        readLatestHead(`published.${subpath}`);
+        return {
+            fromBoard,
+            marshaller,
+            networkConfig,
+            readLatestHead,
+            readPublished,
+            unserializeHead,
+            vstorage,
+        };
+    }
+    catch (err) {
+        throw Error(`RPC failure (${networkConfig.rpcAddrs}): ${err.message}`);
+    }
+};
+/** @typedef {ReturnType<typeof makeVstorageKit>} VstorageKit */
+//# sourceMappingURL=vstorage-kit.js.map

package/dist/vstorage-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vstorage-kit.js","sourceRoot":"","sources":["../src/vstorage-kit.js"],"names":[],"mappings":"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"}

package/dist/vstorage.d.ts

@@ -0,0 +1,59 @@
+export function makeAbciQuery<T extends "data" | "children">(path?: string, { kind, height }?: {
+    kind?: T | undefined;
+    height?: number | bigint | undefined;
+}): `/abci_query?${string}`;
+export function makeVStorage({ fetch }: {
+    fetch: typeof window.fetch;
+}, config: MinimalNetworkConfig): {
+    readStorageMeta: <T extends "children" | "data">(path?: string, { kind, height }?: {
+        kind?: T | undefined;
+        height?: number | bigint | undefined;
+    }) => Promise<T extends "children" ? QueryChildrenMetaResponse : QueryDataMetaResponse>;
+    readStorage: <T extends "children" | "data">(path?: string, opts?: {
+        kind?: T | undefined;
+        height?: number | bigint | undefined;
+    }) => Promise<T extends "children" ? QueryChildrenResponse : QueryDataResponse>;
+    /**
+     *
+     * @param {string} path
+     * @returns {Promise<QueryDataResponse>} latest vstorage value at path
+     */
+    readLatest(path?: string): Promise<QueryDataResponse>;
+    /**
+     * Keys of children at the path
+     *
+     * @param {string} path
+     * @returns {Promise<string[]>}
+     */
+    keys(path?: string): Promise<string[]>;
+    /**
+     * @param {string} path
+     * @param {number} [height] default is highest
+     * @returns {Promise<StreamCell<unknown>>}
+     */
+    readAt(path: string, height?: number): Promise<StreamCell<unknown>>;
+    /**
+     * Read values going back as far as available
+     *
+     * @param {string} path
+     * @param {number | string} [minHeight]
+     * @returns {Promise<string[]>}
+     */
+    readFully(path: string, minHeight?: number | string): Promise<string[]>;
+};
+export type QueryMetaResponseBase = {
+    blockHeight?: bigint;
+    log?: string;
+};
+export type QueryChildrenMetaResponse = QueryMetaResponseBase & {
+    result: QueryChildrenResponse;
+};
+export type QueryDataMetaResponse = QueryMetaResponseBase & {
+    result: QueryDataResponse;
+};
+export type VStorage = ReturnType<typeof makeVStorage>;
+import type { MinimalNetworkConfig } from './network-config.js';
+import { QueryChildrenResponse } from '@agoric/cosmic-proto/agoric/vstorage/query.js';
+import { QueryDataResponse } from '@agoric/cosmic-proto/agoric/vstorage/query.js';
+import type { StreamCell } from '@agoric/internal/src/lib-chainStorage.js';
+//# sourceMappingURL=vstorage.d.ts.map

package/dist/vstorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vstorage.d.ts","sourceRoot":"","sources":["../src/vstorage.js"],"names":[],"mappings":"AA6CO,8BAP4B,CAAC,SAAtB,MAAM,GAAG,UAAW,SACvB,MAAM,qBAEd;IAAiB,IAAI;IACU,MAAM;CACrC,GAAU,eAAe,MAAM,EAAE,CAYnC;AAaM,wCAHJ;IAAoC,KAAK,EAAjC,OAAO,MAAM,CAAC,KAAK;CAC3B,UAAQ,oBAAoB;sBA4BM,CAAC,SAAtB,UAAU,GAAG,MAAO,SACvB,MAAM,qBAEd;QAAiB,IAAI;QACU,MAAM;KACrC,KAAU,OAAO,CAAC,CAAC,SAAS,UAAU,GAAG,yBAAyB,GAAG,qBAAqB,CAAC;kBA6C3D,CAAC,SAAtB,UAAU,GAAG,MAAO,SACvB,MAAM,SAEd;QAAiB,IAAI;QACU,MAAM;KACrC,KAAU,OAAO,CAAC,CAAC,SAAS,UAAU,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;IAWpF;;;;OAIG;sBAFQ,MAAM,GACJ,OAAO,CAAC,iBAAiB,CAAC;IAKvC;;;;;OAKG;gBAFQ,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,CAAC;IAM9B;;;;OAIG;iBAHQ,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,WAAW,OAAO,CAAC,CAAC;IASzC;;;;;;OAMG;oBAHQ,MAAM,cACN,MAAM,GAAG,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC;EAyCjC;oCAlLY;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;wCACtC,qBAAqB,GAAG;IAAE,MAAM,EAAE,qBAAqB,CAAA;CAAE;oCACzD,qBAAqB,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE;uBAiLpD,UAAU,CAAC,OAAO,YAAY,CAAC;0CA9NN,qBAAqB;sCANrD,+CAA+C;kCAA/C,+CAA+C;gCAKzB,0CAA0C"}

package/dist/vstorage.js

@@ -0,0 +1,204 @@
+import { decodeBase64 } from '@endo/base64';
+import { encodeHex } from '@agoric/internal/src/hex.js';
+import { StreamCellShape } from '@agoric/internal/src/lib-chainStorage.js';
+import { mustMatch } from '@agoric/internal';
+import { QueryChildrenRequest, QueryChildrenResponse, QueryDataRequest, QueryDataResponse, } from '@agoric/cosmic-proto/agoric/vstorage/query.js';
+/**
+ * @import {AbciQueryResponse} from '@cosmjs/tendermint-rpc';
+ * @import {JsonSafe} from '@agoric/cosmic-proto';
+ * @import {StreamCell} from '@agoric/internal/src/lib-chainStorage.js';
+ * @import {MinimalNetworkConfig} from './network-config.js';
+ */
+const kindToRpc = /** @type {const} */ ({
+    __proto__: null,
+    children: '/agoric.vstorage.Query/Children',
+    data: '/agoric.vstorage.Query/Data',
+});
+// TODO move down to cosmic-proto, probably generated with Telescope
+const codecs = {
+    __proto__: null,
+    '/agoric.vstorage.Query/Children': {
+        request: QueryChildrenRequest,
+        response: QueryChildrenResponse,
+    },
+    '/agoric.vstorage.Query/Data': {
+        request: QueryDataRequest,
+        response: QueryDataResponse,
+    },
+};
+/**
+ * @template {'data' | 'children'} T
+ * @param {string} [path]
+ * @param {object} [opts]
+ * @param {T} [opts.kind]
+ * @param {number | bigint} [opts.height] 0 is the same as omitting height and implies the highest block
+ * @returns {`/abci_query?${string}`}
+ */
+export const makeAbciQuery = (path = 'published', { kind = /** @type {T} */ ('children'), height = 0 } = {}) => {
+    const rpc = kindToRpc[kind];
+    const { request } = codecs[rpc];
+    const buf = request.toProto({ path });
+    const hexData = encodeHex(buf);
+    return `/abci_query?path=%22${rpc}%22&data=0x${hexData}&height=${height}`;
+};
+/**
+ * @typedef {{ blockHeight?: bigint, log?: string }} QueryMetaResponseBase
+ * @typedef {QueryMetaResponseBase & { result: QueryChildrenResponse }} QueryChildrenMetaResponse
+ * @typedef {QueryMetaResponseBase & { result: QueryDataResponse }} QueryDataMetaResponse
+ */
+/**
+ * @param {object} powers
+ * @param {typeof window.fetch} powers.fetch
+ * @param {MinimalNetworkConfig} config
+ */
+export const makeVStorage = ({ fetch }, config) => {
+    /**
+     * @template {'data' | 'children'} T
+     * @param {string} vstoragePath
+     * @param {object} [opts]
+     * @param {T} [opts.kind]
+     * @param {number | bigint} [opts.height] 0 is the same as omitting height and implies the highest block
+     * @returns {Promise<{result: {response: JsonSafe<AbciQueryResponse>}}>}
+     */
+    const getVstorageJson = async (vstoragePath, { kind = /** @type {T} */ ('children'), height = 0 } = {}) => {
+        const url = config.rpcAddrs[0] + makeAbciQuery(vstoragePath, { kind, height });
+        const res = await fetch(url, { keepalive: true });
+        return res.json();
+    };
+    /**
+     * Make a vstorage Children or Data query, returning the decoded result along
+     * with response metadata derived from fields documented at
+     * https://docs.cometbft.com/v1.0/spec/abci/abci++_methods#query (for
+     * successful responses, `log` and `height` [as `blockHeight`], and for error
+     * responses, `codespace` and `code`).
+     *
+     * @template {'children' | 'data'} T
+     * @param {string} [path]
+     * @param {object} [opts]
+     * @param {T} [opts.kind]
+     * @param {number | bigint} [opts.height] 0 is the same as omitting height and implies the highest block
+     * @returns {Promise<T extends 'children' ? QueryChildrenMetaResponse : QueryDataMetaResponse>}
+     */
+    const readStorageMeta = async (path = 'published', { kind = /** @type {T} */ ('children'), height = 0 } = {}) => {
+        await null;
+        const rpc = kindToRpc[kind];
+        const codec = codecs[rpc];
+        /** @type {Awaited<ReturnType<typeof getVstorageJson>>} */
+        let data;
+        try {
+            data = await getVstorageJson(path, { kind, height });
+        }
+        catch (err) {
+            throw Error(`cannot read ${kind} of ${path}: ${err.message}`);
+        }
+        const { result: { response }, } = data;
+        if (response?.code !== 0) {
+            /** @type {any} */
+            const err = Error(`error code ${response?.code} reading ${kind} of ${path}: ${response.log}`);
+            err.code = response?.code;
+            err.codespace = response?.codespace;
+            throw err;
+        }
+        const { value: b64Value } = response;
+        const result = codec.response.decode(decodeBase64(b64Value));
+        /** @type {QueryMetaResponseBase} */
+        const metaResponseBase = {
+            blockHeight: response.height === undefined ? undefined : BigInt(response.height),
+            log: response.log,
+        };
+        // @ts-expect-error cast
+        return { ...metaResponseBase, result };
+    };
+    /**
+     * @template {'children' | 'data'} T
+     * @param {string} [path]
+     * @param {object} [opts]
+     * @param {T} [opts.kind]
+     * @param {number | bigint} [opts.height] 0 is the same as omitting height and implies the highest block
+     * @returns {Promise<T extends 'children' ? QueryChildrenResponse : QueryDataResponse>}
+     */
+    const readStorage = async (path = 'published', opts = {}) => {
+        const respWithMetadata = await readStorageMeta(path, opts);
+        // @ts-expect-error cast
+        return respWithMetadata.result;
+    };
+    const vstorage = {
+        readStorageMeta,
+        readStorage,
+        /**
+         *
+         * @param {string} path
+         * @returns {Promise<QueryDataResponse>} latest vstorage value at path
+         */
+        async readLatest(path = 'published') {
+            return readStorage(path, { kind: 'data' });
+        },
+        /**
+         * Keys of children at the path
+         *
+         * @param {string} path
+         * @returns {Promise<string[]>}
+         */
+        async keys(path = 'published') {
+            const response = await readStorage(path, { kind: 'children' });
+            return response.children;
+        },
+        /**
+         * @param {string} path
+         * @param {number} [height] default is highest
+         * @returns {Promise<StreamCell<unknown>>}
+         */
+        async readAt(path, height = undefined) {
+            const response = await readStorage(path, { kind: 'data', height });
+            /** @type {unknown} */
+            const cell = harden(JSON.parse(response.value));
+            mustMatch(cell, StreamCellShape);
+            return cell;
+        },
+        /**
+         * Read values going back as far as available
+         *
+         * @param {string} path
+         * @param {number | string} [minHeight]
+         * @returns {Promise<string[]>}
+         */
+        async readFully(path, minHeight = undefined) {
+            const parts = [];
+            // undefined the first iteration, to query at the highest
+            /** @type {string | undefined} */
+            let blockHeight;
+            await null;
+            do {
+                // console.debug('READING', { blockHeight });
+                let values;
+                try {
+                    ({ blockHeight, values } = await vstorage.readAt(path, blockHeight === undefined ? undefined : Number(blockHeight) - 1));
+                    // console.debug('readAt returned', { blockHeight });
+                }
+                catch (err) {
+                    if (
+                    // CosmosSDK ErrInvalidRequest with particular message text;
+                    // misrepresentation of pruned data
+                    // TODO replace after incorporating a fix to
+                    // https://github.com/cosmos/cosmos-sdk/issues/19992
+                    err.codespace === 'sdk' &&
+                        err.code === 18 &&
+                        err.message.match(/pruned/)) {
+                        // console.error(err);
+                        break;
+                    }
+                    throw err;
+                }
+                parts.push(values.reverse());
+                // console.debug('PUSHED', values);
+                // console.debug('NEW', { blockHeight, minHeight });
+                if (minHeight && Number(blockHeight) <= Number(minHeight))
+                    break;
+            } while (Number(blockHeight) > 0);
+            return /** @type {string[]} */ (parts.flat());
+        },
+    };
+    return vstorage;
+};
+/** @typedef {ReturnType<typeof makeVStorage>} VStorage */
+//# sourceMappingURL=vstorage.js.map

package/dist/vstorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vstorage.js","sourceRoot":"","sources":["../src/vstorage.js"],"names":[],"mappings":"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"}