@agoric/client-utils 0.1.1-dev-1c730f2.0 → 0.1.1-dev-f80bb26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/client-utils",
-  "version": "0.1.1-dev-1c730f2.0+1c730f2",
+  "version": "0.1.1-dev-f80bb26.0+f80bb26",
   "description": "Utilities for building Agoric clients",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -13,6 +13,8 @@
   ],
   "scripts": {
     "build": "exit 0",
+    "prepack": "tsc --build tsconfig.build.json",
+    "postpack": "git clean -f '*.d.ts*' '*.tsbuildinfo'",
     "test": "ava",
     "test:c8": "c8 --all $C8_OPTIONS ava",
     "test:xs": "exit 0",
@@ -27,12 +29,12 @@
     "ts-blank-space": "^0.6.1"
   },
   "dependencies": {
-    "@agoric/casting": "0.4.3-dev-1c730f2.0+1c730f2",
-    "@agoric/cosmic-proto": "0.4.1-dev-1c730f2.0+1c730f2",
-    "@agoric/ertp": "0.16.3-dev-1c730f2.0+1c730f2",
-    "@agoric/internal": "0.3.3-dev-1c730f2.0+1c730f2",
-    "@agoric/smart-wallet": "0.5.4-dev-1c730f2.0+1c730f2",
-    "@agoric/vats": "0.15.2-dev-1c730f2.0+1c730f2",
+    "@agoric/casting": "0.4.3-dev-f80bb26.0+f80bb26",
+    "@agoric/cosmic-proto": "0.4.1-dev-f80bb26.0+f80bb26",
+    "@agoric/ertp": "0.16.3-dev-f80bb26.0+f80bb26",
+    "@agoric/internal": "0.3.3-dev-f80bb26.0+f80bb26",
+    "@agoric/smart-wallet": "0.5.4-dev-f80bb26.0+f80bb26",
+    "@agoric/vats": "0.15.2-dev-f80bb26.0+f80bb26",
     "@cosmjs/stargate": "^0.33.0",
     "@cosmjs/tendermint-rpc": "^0.33.0",
     "@endo/base64": "^1.0.9",
@@ -60,5 +62,5 @@
     ],
     "timeout": "20m"
   },
-  "gitHead": "1c730f2199678c14aec52792a0663d93a63741b1"
+  "gitHead": "f80bb26afd3941d14a34ff01ecdfa29913ee4e47"
 }

package/src/chain.d.ts

@@ -0,0 +1,11 @@
+export function pollBlocks(opts: {
+    client: StargateClient;
+    delay: (ms: number) => Promise<void>;
+    period?: number;
+    retryMessage?: string;
+}): <T>(l: (b: {
+    time: string;
+    height: number;
+}) => Promise<T>) => Promise<T>;
+import type { StargateClient } from '@cosmjs/stargate';
+//# sourceMappingURL=chain.d.ts.map

package/src/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["chain.js"],"names":[],"mappings":"AAaO,iCARI;IACN,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CA2BrF;oCArCgC,kBAAkB"}

package/src/cli.d.ts

@@ -0,0 +1,6 @@
+export function fetchEnvNetworkConfig({ env, fetch }: {
+    env: typeof process.env;
+    fetch: typeof globalThis.fetch;
+}): Promise<MinimalNetworkConfig>;
+import type { MinimalNetworkConfig } from './network-config.js';
+//# sourceMappingURL=cli.d.ts.map

package/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["cli.js"],"names":[],"mappings":"AAeO,sDAJI;IAAE,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,KAAK,EAAE,uBAAY,CAAA;CAAE,GAC9C,OAAO,CAAC,oBAAoB,CAAC,CAOzC;0CAhBsC,qBAAqB"}

package/src/clock-timer.d.ts

@@ -0,0 +1,9 @@
+export function makeIntervalIterable(intervalMs: number, { setTimeout, clearTimeout, now }: IntervalIO): {
+    [Symbol.asyncIterator]: () => AsyncGenerator<number, void, void>;
+};
+export type IntervalIO = {
+    setTimeout: typeof setTimeout;
+    clearTimeout: typeof clearTimeout;
+    now: typeof Date.now;
+};
+//# sourceMappingURL=clock-timer.d.ts.map

package/src/clock-timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock-timer.d.ts","sourceRoot":"","sources":["clock-timer.js"],"names":[],"mappings":"AAiBO,iDANI,MAAM,qCACN,UAAU,GACR;IACZ,CAAK,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;CACjE,CAkCH;;gBA7Ca,OAAO,UAAU;kBACjB,OAAO,YAAY;SACnB,OAAO,IAAI,CAAC,GAAG"}

package/src/main.d.ts

@@ -0,0 +1,10 @@
+export * from "./cli.js";
+export * from "./network-config.js";
+export * from "./rpc.js";
+export * from "./smart-wallet-kit.js";
+export * from "./sync-tools.js";
+export * from "./vstorage.js";
+export * from "./vstorage-kit.js";
+export * from "./wallet-utils.js";
+export * from "./types-index.js";
+//# sourceMappingURL=main.d.ts.map

package/src/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["main.js"],"names":[],"mappings":""}

package/src/main.js

@@ -8,4 +8,4 @@ export * from './vstorage-kit.js';
 export * from './wallet-utils.js';
 
 // eslint-disable-next-line import/export -- just types
-export * from './types.js';
+export * from './types-index.js';

package/src/network-config.d.ts

@@ -0,0 +1,15 @@
+export function toNetworkConfigUrl(agoricNetSubdomain: any): string;
+export function toRpcUrl(agoricNetSubdomain: any): string;
+export namespace LOCAL_CONFIG {
+    let rpcAddrs: string[];
+    let chainName: string;
+}
+export const LOCAL_CONFIG_KEY: "local";
+export function fetchNetworkConfig(spec: string, { fetch }: {
+    fetch: typeof globalThis.fetch;
+}): Promise<MinimalNetworkConfig>;
+export type MinimalNetworkConfig = {
+    rpcAddrs: string[];
+    chainName: string;
+};
+//# sourceMappingURL=network-config.d.ts.map

package/src/network-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-config.d.ts","sourceRoot":"","sources":["network-config.js"],"names":[],"mappings":"AAIO,oEACoD;AAEpD,0DAC6C;;;;;AAQpD,+BAAgC,OAAO,CAAC;AASjC,yCAJI,MAAM,aACN;IAAE,KAAK,EAAE,uBAAY,CAAA;CAAE,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAkBzC;mCAxCY;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE"}

package/src/rpc.d.ts

@@ -0,0 +1,13 @@
+export function pickEndpoint({ rpcAddrs }: {
+    rpcAddrs: any;
+}): any;
+export function makeTendermint34Client(endpoint: string, { fetch }: {
+    fetch: typeof window.fetch;
+}): Promise<Tendermint34Client>;
+export function makeStargateClient(config: MinimalNetworkConfig, { fetch }: {
+    fetch: typeof window.fetch;
+}): Promise<StargateClient>;
+import { Tendermint34Client } from '@cosmjs/tendermint-rpc';
+import type { MinimalNetworkConfig } from './network-config.js';
+import { StargateClient } from '@cosmjs/stargate';
+//# sourceMappingURL=rpc.d.ts.map

package/src/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["rpc.js"],"names":[],"mappings":"AASO;;QAAkD;AAOlD,iDAJI,MAAM,aACN;IAAE,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,CAAA;CAAE,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAKvC;AAOM,2CAJI,oBAAoB,aACpB;IAAE,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,CAAA;CAAE,GAC5B,OAAO,CAAC,cAAc,CAAC,CAMnC;mCA5BkC,wBAAwB;0CAGpB,qBAAqB;+BAJ7B,kBAAkB"}

package/src/smart-wallet-kit.d.ts

@@ -0,0 +1,46 @@
+export function makeSmartWalletKit({ fetch, delay }: {
+    fetch: typeof globalThis.fetch;
+    delay: (ms: number) => Promise<void>;
+}, networkConfig: MinimalNetworkConfig): Promise<{
+    agoricNames: import("@agoric/vats/tools/board-utils.js").AgoricNamesRemotes;
+    networkConfig: MinimalNetworkConfig;
+    getLastUpdate: (addr: string) => Promise<UpdateRecord>;
+    getCurrentWalletRecord: (addr: string) => Promise<CurrentWalletRecord>;
+    storedWalletState: (from: string, minHeight?: number | string) => Promise<{
+        invitationsReceived: Map<import("@agoric/smart-wallet/src/offers.js").OfferId, {
+            acceptedIn: import("@agoric/smart-wallet/src/offers.js").OfferId;
+            description: string;
+            instance: Instance;
+        }>;
+        offerStatuses: Map<import("@agoric/smart-wallet/src/offers.js").OfferId, import("@agoric/smart-wallet/src/offers.js").OfferStatus>;
+        balances: Map<Brand, Amount>;
+    }>;
+    pollOffer: (from: string, id: string | number, minHeight: number | string, untilNumWantsSatisfied?: boolean) => Promise<import("@agoric/smart-wallet/src/offers.js").OfferStatus>;
+    fromBoard: {
+        convertSlotToVal: (boardId: any, iface: any) => any;
+    };
+    marshaller: Omit<import("@endo/marshal").Marshal<string | null>, "serialize" | "unserialize">;
+    readLatestHead: (path: string) => Promise<unknown>;
+    readPublished: <T extends string>(subpath: T) => Promise<import("./types.js").TypedPublished<T>>;
+    unserializeHead: (txt: string | {
+        value: string;
+    }) => unknown;
+    vstorage: {
+        readStorage: <T extends "children" | "data">(path?: string, { kind, height }?: {
+            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 SmartWalletKit = EReturn<typeof makeSmartWalletKit>;
+import type { MinimalNetworkConfig } from './network-config.js';
+import type { UpdateRecord } from '@agoric/smart-wallet/src/smartWallet.js';
+import type { CurrentWalletRecord } from '@agoric/smart-wallet/src/smartWallet.js';
+import type { Brand } from '@agoric/ertp/src/types.js';
+import type { Amount } from '@agoric/ertp/src/types.js';
+import type { EReturn } from '@endo/far';
+//# sourceMappingURL=smart-wallet-kit.d.ts.map

package/src/smart-wallet-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-wallet-kit.d.ts","sourceRoot":"","sources":["smart-wallet-kit.js"],"names":[],"mappings":"AAqBO,qDAJJ;IAAuC,KAAK,EAApC,OAAO,UAAU,CAAC,KAAK;IACc,KAAK,EAA1C,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;CACrC,iBAAQ,oBAAoB;;;0BAoElB,MAAM,KACJ,OAAO,CAAC,YAAY,CAAC;mCAOvB,MAAM,KACJ,OAAO,CAAC,mBAAmB,CAAC;8BAnE9B,MAAM,cACN,MAAM,GAAC,MAAM;;;;;;;;;sBA0Bb,MAAM,MACN,MAAM,GAAC,MAAM,aACb,MAAM,GAAC,MAAM,2BACb,OAAO;;;;;;;;;;;;;;;;;;;;GAqDnB;6BACa,QAAQ,OAAO,kBAAkB,CAAC;0CAxGT,qBAAqB;kCADR,yCAAyC;yCAAzC,yCAAyC;2BAD7D,2BAA2B;4BAA3B,2BAA2B;6BADjC,WAAW"}

package/src/sync-tools.d.ts

@@ -0,0 +1,72 @@
+export function sleep(ms: number, { log, setTimeout }: {
+    log: (message: string) => void;
+    setTimeout: typeof global.setTimeout;
+}): Promise<any>;
+export function retryUntilCondition<T = unknown>(operation: () => Promise<T>, condition: (result: T) => boolean, message: string, { maxRetries, retryIntervalMs, reusePromise, renderResult, log, setTimeout, }: RetryOptions & {
+    log?: typeof console.log;
+    setTimeout: typeof global.setTimeout;
+}): Promise<T>;
+export function waitUntilContractDeployed(contractName: string, ambientAuthority: {
+    log: (message: string) => void;
+    follow: () => object;
+    setTimeout: typeof global.setTimeout;
+}, options: WaitUntilOptions): Promise<{
+    [k: string]: any;
+}>;
+export function waitUntilAccountFunded(destAcct: string, io: {
+    log?: (message: string) => void;
+    query: () => Promise<object>;
+    setTimeout: typeof global.setTimeout;
+}, threshold: {
+    denom: string;
+    value: number;
+}, options: WaitUntilOptions): Promise<any>;
+export function waitUntilOfferResult(addr: string, offerId: string, waitForPayouts: boolean, io: {
+    log?: typeof console.log;
+    follow: () => object;
+    setTimeout: typeof global.setTimeout;
+}, options: WaitUntilOptions): Promise<any>;
+export function waitUntilInvitationReceived(addr: string, io: {
+    follow: () => object;
+    log: typeof console.log;
+    setTimeout: typeof global.setTimeout;
+}, options: WaitUntilOptions): Promise<any>;
+export function waitUntilOfferExited(addr: string, offerId: string, io: {
+    follow: () => object;
+    log: typeof console.log;
+    setTimeout: typeof global.setTimeout;
+}, options: WaitUntilOptions): Promise<any>;
+export function waitUntilElectionResult(committeePathBase: string, expectedResult: {
+    outcome: string;
+    deadline: bigint;
+}, io: {
+    vstorage: import("./vstorage-kit").VstorageKit;
+    log: typeof console.log;
+    setTimeout: typeof global.setTimeout;
+}, options: WaitUntilOptions): Promise<ElectionResult>;
+export type RetryOptions = {
+    maxRetries?: number | undefined;
+    retryIntervalMs?: number | undefined;
+    reusePromise?: boolean | undefined;
+    renderResult?: ((value: unknown) => unknown) | undefined;
+};
+export type WaitUntilOptions = RetryOptions & {
+    errorMessage: string;
+};
+export type CosmosBalanceThreshold = {
+    denom: string;
+    value: number;
+};
+export type ElectionResult = {
+    latestOutcome: {
+        outcome: string;
+        question: import("@endo/marshal").RemotableObject;
+    };
+    latestQuestion: {
+        closingRule: {
+            deadline: bigint;
+        };
+        questionHandle: import("@endo/marshal").RemotableObject;
+    };
+};
+//# sourceMappingURL=sync-tools.d.ts.map

package/src/sync-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-tools.d.ts","sourceRoot":"","sources":["sync-tools.js"],"names":[],"mappings":"AAmCO,0BAHI,MAAM,uBACN;IAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,gBAM7E;AAYG,oCAPO,CAAC,uBACJ,MAAM,OAAO,CAAC,CAAC,CAAC,aAChB,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,WACtB,MAAM,iFACN,YAAY,GAAG;IAAC,GAAG,CAAC,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,GAC7E,OAAO,CAAC,CAAC,CAAC,CAqEtB;AAiCM,wDAJI,MAAM,oBACN;IAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAE,WAC9F,gBAAgB;;GAiB1B;AA0BM,iDALI,MAAM,MACN;IAAE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,aACtG;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,WAC9B,gBAAgB,gBAa1B;AAqCM,2CANI,MAAM,WACN,MAAM,kBACN,OAAO,MACP;IAAE,GAAG,CAAC,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAE,WACxF,gBAAgB,gBAmB1B;AAwBM,kDAJI,MAAM,MACN;IAAE,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,WACtF,gBAAgB,gBAa1B;AA0BM,2CALI,MAAM,WACN,MAAM,MACN;IAAE,MAAM,EAAE,MAAM,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IAAC,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CAAC,WACtF,gBAAgB,gBAa1B;AA+EM,2DAZI,MAAM,kBACN;IACN,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,MACO;IACN,QAAQ,EAAE,OAAO,gBAAgB,EAAE,WAAW,CAAC;IAC/C,GAAG,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC;IACxB,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,CAAA;CACrC,WACO,gBAAgB,2BAoB1B;;;;;4BAtZqB,OAAO,KAAK,OAAO;;+BAE5B,YAAY,GAAG;IAAC,YAAY,EAAE,MAAM,CAAA;CAAC;;WAGpC,MAAM;WACN,MAAM;;6BAqTP;IACR,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,eAAe,EAAE,eAAe,CAAA;KAClD,CAAC;IACF,cAAc,EAAE;QACd,WAAW,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAClC,cAAc,EAAE,OAAO,eAAe,EAAE,eAAe,CAAA;KACxD,CAAA;CACF"}

package/src/types-index.d.ts

@@ -0,0 +1,2 @@
+// Export all the types this package provides
+export type * from './types.js';

package/src/types.d.ts

@@ -1,54 +1,28 @@
-// @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
-
-import type {
-  OutcomeRecord,
-  QuestionDetails,
-} from '@agoric/governance/src/types.js';
-import type { MetricsNotification as VaultManagerMetrics } from '@agoric/inter-protocol/src/vaultFactory/vaultManager.js';
-import type {
-  CurrentWalletRecord,
-  UpdateRecord,
-} from '@agoric/smart-wallet/src/smartWallet.js';
-import type {
-  ContractRecord,
-  PoolMetrics,
-  TransactionRecord,
-} from '@agoric/fast-usdc';
-
-// For static string key types. String template matching has to be in the ternary below.
+import type { Brand } 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 { Instance } from '@agoric/zoe/src/zoeService/types.js';
 type PublishedTypeMap = {
-  'auction.governance': { current: AuctionParamRecord };
-  'auction.schedule': ScheduleNotification;
-  'vaultFactory.metrics': { rewardPoolAllocation: RewardPoolAllocationRecord };
+    'auction.governance': {
+        current: AuctionParamRecord;
+    };
+    'auction.schedule': ScheduleNotification;
+    'vaultFactory.metrics': VaultDirectorMetrics;
+    'agoricNames.instance': Array<[string, Instance]>;
+    'agoricNames.brand': Array<[string, Brand]>;
+    fastUsdc: ContractRecord;
+    'fastUsdc.feeConfig': FeeConfig;
+    'fastUsdc.poolMetrics': PoolMetrics;
 };
-
 /**
  * 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 `committees.${string}.latestQuestion`
-        ? QuestionDetails
-        : T extends `committees.${string}.latestOutcome`
-          ? OutcomeRecord
-          : T extends `vaultFactory.managers.manager${number}.metrics`
-            ? VaultManagerMetrics
-            : T extends 'agoricNames.instance'
-              ? Array<[string, Instance]>
-              : T extends 'agoricNames.brand'
-                ? Array<[string, Brand]>
-                : T extends 'fastUsdc'
-                  ? ContractRecord
-                  : T extends 'fastUsdc.feeConfig'
-                    ? FeeConfig
-                    : T extends 'fastUsdc.poolMetrics'
-                      ? PoolMetrics
-                      : T extends `fastUsdc.txns.${string}`
-                        ? TransactionRecord
-                        : unknown;
+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 `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/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,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,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAGpE,KAAK,gBAAgB,GAAG;IACtB,oBAAoB,EAAE;QAAE,OAAO,EAAE,kBAAkB,CAAA;KAAE,CAAC;IACtD,kBAAkB,EAAE,oBAAoB,CAAC;IACzC,sBAAsB,EAAE,oBAAoB,CAAC;IAC7C,sBAAsB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClD,mBAAmB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB,EAAE,SAAS,CAAC;IAChC,sBAAsB,EAAE,WAAW,CAAC;CACrC,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,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/src/types.ts

@@ -0,0 +1,58 @@
+// @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
+
+import type { Brand } 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 { Instance } from '@agoric/zoe/src/zoeService/types.js';
+
+// For static string key types. String template matching has to be in the ternary below.
+type PublishedTypeMap = {
+  'auction.governance': { current: AuctionParamRecord };
+  'auction.schedule': ScheduleNotification;
+  'vaultFactory.metrics': VaultDirectorMetrics;
+  'agoricNames.instance': Array<[string, Instance]>;
+  'agoricNames.brand': Array<[string, Brand]>;
+  fastUsdc: ContractRecord;
+  'fastUsdc.feeConfig': FeeConfig;
+  'fastUsdc.poolMetrics': PoolMetrics;
+};
+
+/**
+ * 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 `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;
+// static string keys are defined in PublishedTypeMap

package/src/vstorage-kit.d.ts

@@ -0,0 +1,53 @@
+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<import("@agoric/vats/tools/board-utils.js").AgoricNamesRemotes>;
+export function makeVstorageKit({ fetch }: {
+    fetch: typeof window.fetch;
+}, config: MinimalNetworkConfig): {
+    fromBoard: {
+        convertSlotToVal: (boardId: any, iface: any) => any;
+    };
+    marshaller: Omit<import("@endo/marshal").Marshal<string | null>, "serialize" | "unserialize">;
+    readLatestHead: (path: string) => Promise<unknown>;
+    readPublished: <T extends string>(subpath: T) => Promise<TypedPublished<T>>;
+    unserializeHead: (txt: string | {
+        value: string;
+    }) => unknown;
+    vstorage: {
+        readStorage: <T extends "children" | "data">(path?: string, { kind, height }?: {
+            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 { MinimalNetworkConfig } from './network-config.js';
+import type { TypedPublished } from './types-index.js';
+//# sourceMappingURL=vstorage-kit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vstorage-kit.d.ts","sourceRoot":"","sources":["vstorage-kit.js"],"names":[],"mappings":";AAgBO;;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,OAAO,mCAAmC,EAAE,kBAAkB,CAAC,CAqBnF;AAMM,2CAHI;IAAE,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,CAAA;CAAE,UAC9B,oBAAoB;;;;;2BAeV,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC;oBAajC,CAAC,SAAS,MAAM,WAAW,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;2BAnBrD,MAAM,GAAG;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,KAAK,OAAO;;;;;;;;;;;EAoCxD;oBAlHa,UAAU,CAAC,OAAO,aAAa,CAAC;0BAmHhC,UAAU,CAAC,OAAO,eAAe,CAAC;wCA5IzC,mCAAmC;8BASf,eAAe;0CAFH,qBAAqB;oCAC3B,kBAAkB"}

package/src/vstorage-kit.js

@@ -9,7 +9,7 @@ export { boardSlottingMarshaller };
 
 /**
  * @import {MinimalNetworkConfig} from './network-config.js';
- * @import {TypedPublished} from './types.js';
+ * @import {TypedPublished} from './types-index.js';
  * @import {VStorage} from './vstorage.js';
  */
 

package/src/vstorage.d.ts

@@ -0,0 +1,45 @@
+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): {
+    readStorage: <T extends "children" | "data">(path?: string, { kind, height }?: {
+        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 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/src/vstorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vstorage.d.ts","sourceRoot":"","sources":["vstorage.js"],"names":[],"mappings":"AA6CO,8BAP4B,CAAC,SAAtB,MAAM,GAAG,UAAW,SACvB,MAAM,qBAEd;IAAiB,IAAI;IACU,MAAM;CACrC,GAAU,eAAe,MAAM,EAAE,CAYnC;AAOM,wCAHJ;IAAoC,KAAK,EAAjC,OAAO,MAAM,CAAC,KAAK;CAC3B,UAAQ,oBAAoB;kBAsBM,CAAC,SAAtB,UAAU,GAAG,MAAO,SACvB,MAAM,qBAEd;QAAiB,IAAI;QACU,MAAM;KACrC,KAAU,OAAO,CAAC,CAAC,SAAS,UAAU,GAAG,qBAAqB,GAAE,iBAAiB,CAAE;IAsCpF;;;;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;uBACa,UAAU,CAAC,OAAO,YAAY,CAAC;0CA3LN,qBAAqB;sCANrD,+CAA+C;kCAA/C,+CAA+C;gCAKzB,0CAA0C"}

package/src/wallet-utils.d.ts

@@ -0,0 +1,42 @@
+/** @typedef {import('./smart-wallet-kit.js').SmartWalletKit} WalletUtils  */
+/** @deprecated use `makeSmartWalletKit` */
+export const makeWalletUtils: ({ fetch, delay }: {
+    fetch: typeof globalThis.fetch;
+    delay: (ms: number) => Promise<void>;
+}, networkConfig: import("./network-config.js").MinimalNetworkConfig) => Promise<{
+    agoricNames: import("@agoric/vats/tools/board-utils.js").AgoricNamesRemotes;
+    networkConfig: import("./network-config.js").MinimalNetworkConfig;
+    getLastUpdate: (addr: string) => Promise<import("@agoric/smart-wallet/src/smartWallet.js").UpdateRecord>;
+    getCurrentWalletRecord: (addr: string) => Promise<import("@agoric/smart-wallet/src/smartWallet.js").CurrentWalletRecord>;
+    storedWalletState: (from: string, minHeight?: number | string) => Promise<{
+        invitationsReceived: Map<import("@agoric/smart-wallet/src/offers.js").OfferId, {
+            acceptedIn: import("@agoric/smart-wallet/src/offers.js").OfferId;
+            description: string;
+            instance: Instance;
+        }>;
+        offerStatuses: Map<import("@agoric/smart-wallet/src/offers.js").OfferId, import("@agoric/smart-wallet/src/offers.js").OfferStatus>;
+        balances: Map<globalThis.Brand, globalThis.Amount>;
+    }>;
+    pollOffer: (from: string, id: string | number, minHeight: number | string, untilNumWantsSatisfied?: boolean) => Promise<import("@agoric/smart-wallet/src/offers.js").OfferStatus>;
+    fromBoard: {
+        convertSlotToVal: (boardId: any, iface: any) => any;
+    };
+    marshaller: Omit<import("@endo/marshal").Marshal<string | null>, "serialize" | "unserialize">;
+    readLatestHead: (path: string) => Promise<unknown>;
+    readPublished: <T extends string>(subpath: T) => Promise<import("./types.js").TypedPublished<T>>;
+    unserializeHead: (txt: string | {
+        value: string;
+    }) => unknown;
+    vstorage: {
+        readStorage: <T extends "children" | "data">(path?: string, { kind, height }?: {
+            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 WalletUtils = import("./smart-wallet-kit.js").SmartWalletKit;
+//# sourceMappingURL=wallet-utils.d.ts.map

package/src/wallet-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-utils.d.ts","sourceRoot":"","sources":["wallet-utils.js"],"names":[],"mappings":"AAIA,6EAA6E;AAE7E,2CAA2C;AAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAkD;0BAHpC,OAAO,uBAAuB,EAAE,cAAc"}