@agoric/internal 0.3.3-mainnet1B-dev-867dea5.0 → 0.3.3-orchestration-dev-096c4e8.0

package/README.md

@@ -10,11 +10,16 @@ Like all `@agoric` packages it follows Semantic Versioning. Unlike the others, i
 
 # Design
 
-It must be the lowest agoric-sdk package in any import graph. Therefore it must never depend on another agoric-sdk package. If there's a module in an another agoric-package that has no agoric-sdk dependencies, it can be moved into this package.
+It is meant to be a home for modules that have no Agoric-specific dependencies themselves. It does depend on a these other @agoric packages but they are all destined to migrate out of the repo,
+
+- base-zone
+- store
+- assert
+
+This package may not take dependencies on any others in this repository.
 
 It must never export ambient types.
 
 It should not be imported by deep imports. Eventually this will be enforced by [`exports`](https://nodejs.org/api/packages.html#exports) but the tooling isn't ready:
     - https://github.com/import-js/eslint-plugin-import/issues/1810
     - https://github.com/microsoft/TypeScript/issues/33079 (or some related problem with JSdoc types)
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/internal",
-  "version": "0.3.3-mainnet1B-dev-867dea5.0+867dea5",
+  "version": "0.3.3-orchestration-dev-096c4e8.0+096c4e8",
   "description": "Externally unsupported utilities internal to agoric-sdk",
   "type": "module",
   "main": "src/index.js",
@@ -9,7 +9,7 @@
   },
   "scripts": {
     "build": "exit 0",
-    "prepack": "tsc --build jsconfig.build.json",
+    "prepack": "tsc --build tsconfig.build.json",
     "postpack": "git clean -f '*.d.ts*'",
     "test": "ava",
     "test:nyc": "exit 0",
@@ -17,22 +17,30 @@
     "lint-fix": "yarn lint:eslint --fix",
     "lint": "run-s --continue-on-error lint:*",
     "lint:eslint": "eslint .",
-    "lint:types": "tsc -p jsconfig.json"
+    "lint:types": "tsc"
   },
   "dependencies": {
-    "@agoric/zone": "0.2.3-mainnet1B-dev-867dea5.0+867dea5",
-    "@endo/far": "0.2.18",
-    "@endo/marshal": "0.8.5",
-    "@endo/patterns": "0.2.2",
-    "@endo/promise-kit": "0.2.56",
-    "@endo/stream": "0.3.25",
+    "@agoric/assert": "0.6.1-orchestration-dev-096c4e8.0+096c4e8",
+    "@agoric/base-zone": "0.1.1-orchestration-dev-096c4e8.0+096c4e8",
+    "@endo/common": "^1.1.0",
+    "@endo/far": "^1.0.4",
+    "@endo/init": "^1.0.4",
+    "@endo/marshal": "^1.3.0",
+    "@endo/patterns": "^1.2.0",
+    "@endo/promise-kit": "^1.0.4",
+    "@endo/stream": "^1.1.0",
     "anylogger": "^0.21.0",
     "jessie.js": "^0.3.2"
   },
   "devDependencies": {
-    "@endo/init": "0.5.56",
-    "ava": "^5.2.0",
-    "tsd": "^0.28.1"
+    "@endo/init": "^1.0.4",
+    "ava": "^5.3.0",
+    "tsd": "^0.30.4"
+  },
+  "ava": {
+    "require": [
+      "@endo/init/debug.js"
+    ]
   },
   "author": "Agoric",
   "license": "Apache-2.0",
@@ -42,5 +50,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "867dea564f773bcf9b8332241358eb0e5608eab7"
+  "typeCoverage": {
+    "atLeast": 92.83
+  },
+  "gitHead": "096c4e8fce80e9a509b0e1a30fda11736c4570e1"
 }

package/src/batched-deliver.d.ts

@@ -1,15 +1,15 @@
 /**
- * @typedef {(message: any[], ackNum: number) => void} DeliverMessages
+ * @typedef {(message: unknown[], ackNum: number) => Promise<void>} DeliverMessages
  */
 /**
  * @param {DeliverMessages} deliver
- * @param {{ clearTimeout: NodeJS.clearTimeout, setTimeout: NodeJS.setTimeout }} io
+ * @param {{ clearTimeout: import('node:timers').clearTimeout, setTimeout: import('node:timers').setTimeout }} io
  * @param {number} batchTimeoutMs
  */
 export function makeBatchedDeliver(deliver: DeliverMessages, { clearTimeout, setTimeout }: {
-    clearTimeout: NodeJS.clearTimeout;
-    setTimeout: NodeJS.setTimeout;
-}, batchTimeoutMs?: number): (newMessages: any[], ackNum: number) => void;
+    clearTimeout: typeof clearTimeout;
+    setTimeout: typeof setTimeout;
+}, batchTimeoutMs?: number): (message: unknown[], ackNum: number) => Promise<void>;
 export const DEFAULT_BATCH_TIMEOUT_MS: 1000;
-export type DeliverMessages = (message: any[], ackNum: number) => void;
+export type DeliverMessages = (message: unknown[], ackNum: number) => Promise<void>;
 //# sourceMappingURL=batched-deliver.d.ts.map

package/src/batched-deliver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batched-deliver.d.ts","sourceRoot":"","sources":["batched-deliver.js"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;GAIG;AACH,4CAJW,eAAe,gCACf;IAAE,kCAAkC;IAAC,8BAA6B;CAAE,mBACpE,MAAM,gDAsChB;AA/CD,4CAA6C;wCAGtB,GAAG,EAAE,UAAU,MAAM,KAAK,IAAI"}
+{"version":3,"file":"batched-deliver.d.ts","sourceRoot":"","sources":["batched-deliver.js"],"names":[],"mappings":"AAKA;;GAEG;AAEH;;;;GAIG;AACH,4CAJW,eAAe,gCACf;IAAE,kCAAiD;IAAC,8BAA4C;CAAE,mBAClG,MAAM,aANM,OAAO,EAAE,UAAU,MAAM,KAAK,QAAQ,IAAI,CAAC,CA8CjE;AAjDD,4CAA6C;wCAGtB,OAAO,EAAE,UAAU,MAAM,KAAK,QAAQ,IAAI,CAAC"}

package/src/batched-deliver.js

@@ -1,14 +1,15 @@
 // @jessie-check
+// @ts-check
 
 export const DEFAULT_BATCH_TIMEOUT_MS = 1000;
 
 /**
- * @typedef {(message: any[], ackNum: number) => void} DeliverMessages
+ * @typedef {(message: unknown[], ackNum: number) => Promise<void>} DeliverMessages
  */
 
 /**
  * @param {DeliverMessages} deliver
- * @param {{ clearTimeout: NodeJS.clearTimeout, setTimeout: NodeJS.setTimeout }} io
+ * @param {{ clearTimeout: import('node:timers').clearTimeout, setTimeout: import('node:timers').setTimeout }} io
  * @param {number} batchTimeoutMs
  */
 export function makeBatchedDeliver(
@@ -16,8 +17,10 @@ export function makeBatchedDeliver(
   { clearTimeout, setTimeout },
   batchTimeoutMs = DEFAULT_BATCH_TIMEOUT_MS,
 ) {
+  /** @type {unknown[]} */
   let batchedMessages = [];
   let latestAckNum = 0;
+  /** @type {NodeJS.Timeout} */
   let deliverTimeout;
 
   /**
@@ -34,7 +37,7 @@ export function makeBatchedDeliver(
         // Transfer the batched messages to the deliver function.
         const msgs = batchedMessages;
         batchedMessages = [];
-        deliver(msgs, latestAckNum);
+        void deliver(msgs, latestAckNum);
       }, batchTimeoutMs);
     }
 

package/src/callback.d.ts

@@ -1,23 +1,30 @@
-export function callSync<I extends (...args: unknown[]) => any>(callback: import("./types").SyncCallback<I>, ...args: Parameters<I>): ReturnType<I>;
-export function callE<I extends (...args: unknown[]) => any>(callback: import("./types").Callback<I>, ...args: Parameters<I>): Promise<Awaited<ReturnType<I>>>;
-export function makeSyncFunctionCallback<I extends (...args: unknown[]) => any, T extends (...args: [...B, ...Parameters<I>]) => ReturnType<I> = I, B extends unknown[] = []>(target: T, ...bound: B): import("./types").SyncCallback<I>;
-export function makeFunctionCallback<I extends (...args: unknown[]) => any, T extends import("@endo/far").ERef<(...args: [...B, ...Parameters<I>]) => ReturnType<I>> = import("@endo/far").ERef<I>, B extends unknown[] = []>(target: T, ...bound: B): import("./types").Callback<I>;
-export function makeSyncMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends { [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; } = { [x_1 in P]: I; }, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): import("./types").SyncCallback<I>;
-export function makeMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends import("@endo/far").ERef<{ [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; }> = import("@endo/far").ERef<{ [x_1 in P]: I; }>, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): import("./types").Callback<I>;
-export function isCallback(callback: any): callback is import("./types").Callback<any>;
-export function prepareAttenuator<M extends PropertyKey>(zone: import('@agoric/zone').Zone, methodNames: M[], { interfaceGuard, tag }?: {
-    interfaceGuard?: InterfaceGuard | undefined;
+export function callSync<I extends (...args: unknown[]) => any>(callback: import("./types.js").SyncCallback<I>, ...args: Parameters<I>): ReturnType<I>;
+export function callE<I extends (...args: unknown[]) => any>(callback: import("./types.js").Callback<I>, ...args: Parameters<I>): Promise<Awaited<ReturnType<I>>>;
+export function makeSyncFunctionCallback<I extends (...args: unknown[]) => any, T extends (...args: [...B, ...Parameters<I>]) => ReturnType<I> = I, B extends unknown[] = []>(target: T, ...bound: B): import("./types.js").SyncCallback<I>;
+export function makeFunctionCallback<I extends (...args: unknown[]) => any, T extends import("@endo/far").ERef<(...args: [...B, ...Parameters<I>]) => ReturnType<I>> = import("@endo/far").ERef<I>, B extends unknown[] = []>(target: T, ...bound: B): import("./types.js").Callback<I>;
+export function makeSyncMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends { [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; } = { [x_1 in P]: I; }, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): import("./types.js").SyncCallback<I>;
+export function makeMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends import("@endo/far").ERef<{ [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; }> = import("@endo/far").ERef<{ [x_1 in P]: I; }>, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): import("./types.js").Callback<I>;
+export function isCallback(callback: any): callback is import("./types.js").Callback<any>;
+export function prepareAttenuator<M extends PropertyKey>(zone: import('@agoric/base-zone').Zone, methodNames: M[], { interfaceGuard, tag }?: {
+    interfaceGuard?: import("@endo/patterns").InterfaceGuard<{ [K in M]: import("@endo/patterns").MethodGuard; }> | undefined;
     tag?: string | undefined;
 }): (args_0: {
     target?: any;
     isSync?: boolean | undefined;
-    overrides?: { [K in M]?: import("./types").Callback<any> | null | undefined; } | undefined;
-}) => { [K_1 in M]: (this: any, ...args: unknown[]) => any; } & import("@endo/eventual-send").RemotableBrand<{}, { [K_1 in M]: (this: any, ...args: unknown[]) => any; }>;
-export function prepareGuardedAttenuator(zone: import('@agoric/zone').Zone, interfaceGuard: InterfaceGuard, opts?: {
+    overrides?: { [K_1 in M]?: import("./types.js").Callback<any> | null | undefined; } | undefined;
+}) => import("@endo/exo/src/exo-makers.js").Guarded<{ [K_2 in M]: (this: any, ...args: unknown[]) => any; }>;
+export function prepareGuardedAttenuator<G extends import("@endo/patterns").InterfaceGuard<Record<PropertyKey, import("@endo/patterns").MethodGuard>>>(zone: import('@agoric/base-zone').Zone, interfaceGuard: G, opts?: {
     tag?: string | undefined;
 } | undefined): MakeAttenuator<any>;
-export type MakeAttenuator<T> = MakeAttenuator<T>;
-export type Callback<I extends (...args: unknown[]) => any> = import('./types').Callback<I>;
-export type SyncCallback<I extends (...args: unknown[]) => any> = import('./types').SyncCallback<I>;
-export type Farable<T> = import('@endo/eventual-send').RemotableBrand<{}, T> & T;
+export type MakeAttenuator<T extends import("@endo/exo/src/exo-tools.js").Methods> = (args_0: {
+    target?: any;
+    isSync?: boolean | undefined;
+    overrides?: {
+        [x: string]: import("./types.js").Callback<any> | null | undefined;
+        [x: number]: import("./types.js").Callback<any> | null | undefined;
+        [x: symbol]: import("./types.js").Callback<any> | null | undefined;
+    } | undefined;
+}) => import('@endo/exo/src/exo-makers.js').Farable<T>;
+export type Callback<I extends (...args: unknown[]) => any> = import('./types.js').Callback<I>;
+export type SyncCallback<I extends (...args: unknown[]) => any> = import('./types.js').SyncCallback<I>;
 //# sourceMappingURL=callback.d.ts.map

package/src/callback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["callback.js"],"names":[],"mappings":"AAuDO,6CALiB,OAAO,EAAE,KAAK,GAAG,sFAWxC;AAWM,0CALiB,OAAO,EAAE,KAAK,GAAG,oGAWxC;AAaM,6DAPiB,OAAO,EAAE,KAAK,GAAG,2JAaxC;AAeM,yDATiB,OAAO,EAAE,KAAK,GAAG,2MAexC;AAiBM,2DAXiB,OAAO,EAAE,KAAK,GAAG,iOAoBxC;AAiBM,uDAXiB,OAAO,EAAE,KAAK,GAAG,iRAmBxC;AAOM,qCAHI,GAAG,+CAeb;AAcM,+DAPI,OAAO,cAAc,EAAE,IAAI;IAGL,cAAc;IAEtB,GAAG;;aAkEb,GAAG;;;2BAxDgB,GAAG,WAAW,OAAO,EAAE,KAAK,GAAG,4EAA/B,GAAG,WAAW,OAAO,EAAE,KAAK,GAAG,KA2FhE;AAWM,+CALI,OAAO,cAAc,EAAE,IAAI,kBAC3B,cAAc;;oCAYxB;;yCA5SuB,OAAO,EAAE,KAAK,GAAG,IAC5B,OAAO,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;6CAIlB,OAAO,EAAE,KAAK,GAAG,IAC5B,OAAO,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;yBAGpB,OAAO,qBAAqB,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC"}
+{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["callback.js"],"names":[],"mappings":"AAsDO,6CALiB,OAAO,EAAE,KAAK,GAAG,yFAWxC;AAWM,0CALiB,OAAO,EAAE,KAAK,GAAG,uGAWxC;AAaM,6DAPiB,OAAO,EAAE,KAAK,GAAG,8JAaxC;AAeM,yDATiB,OAAO,EAAE,KAAK,GAAG,8MAexC;AAiBM,2DAXiB,OAAO,EAAE,KAAK,GAAG,oOAoBxC;AAiBM,uDAXiB,OAAO,EAAE,KAAK,GAAG,oRAmBxC;AAOM,qCAHI,GAAG,kDAeb;AAgBM,+DATI,OAAO,mBAAmB,EAAE,IAAI;IAK9B,cAAc;IAEF,GAAG;;aAkEb,GAAG;;;yEAxDgB,GAAG,WAAW,OAAO,EAAE,KAAK,GAAG,KA2FhE;AAYM,6JALI,OAAO,mBAAmB,EAAE,IAAI;;oCAY1C;;;;;;;;;MAhToE,OAAO,6BAA6B,EAAE,OAAO,CAAC,CAAC,CAAC;yCAI7F,OAAO,EAAE,KAAK,GAAG,IAC5B,OAAO,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;6CAIrB,OAAO,EAAE,KAAK,GAAG,IAC5B,OAAO,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC"}

package/src/callback.js

@@ -1,6 +1,7 @@
 // @ts-check
 import { E } from '@endo/far';
 import { isObject, isPassableSymbol } from '@endo/marshal';
+import { getInterfaceMethodKeys } from '@endo/patterns';
 
 const { Fail, quote: q } = assert;
 
@@ -13,22 +14,20 @@ const ownKeys =
   );
 
 /**
- * @template T
- * @typedef {(...args: Parameters<ReturnType<prepareAttenuator>>) => Farable<T>} MakeAttenuator
+ * @template {import('@endo/exo/src/exo-makers.js').Methods} T
+ * @typedef {(...args: Parameters<ReturnType<prepareAttenuator>>) => import('@endo/exo/src/exo-makers.js').Farable<T>} MakeAttenuator
  */
 
 /**
  * @template {(...args: unknown[]) => any} I
- * @typedef {import('./types').Callback<I>} Callback
+ * @typedef {import('./types.js').Callback<I>} Callback
  */
 
 /**
  * @template {(...args: unknown[]) => any} I
- * @typedef {import('./types').SyncCallback<I>} SyncCallback
+ * @typedef {import('./types.js').SyncCallback<I>} SyncCallback
  */
 
-/** @template T @typedef {import('@endo/eventual-send').RemotableBrand<{}, T> & T} Farable */
-
 /**
  * @param {unknown} key
  * @returns {key is PropertyKey} FIXME: should be just `PropertyKey` but TS
@@ -193,10 +192,12 @@ harden(isCallback);
  * Prepare an attenuator class whose methods can be redirected via callbacks.
  *
  * @template {PropertyKey} M
- * @param {import('@agoric/zone').Zone} zone The zone in which to allocate attenuators.
+ * @param {import('@agoric/base-zone').Zone} zone The zone in which to allocate attenuators.
  * @param {M[]} methodNames Methods to forward.
  * @param {object} opts
- * @param {InterfaceGuard} [opts.interfaceGuard] An interface guard for the
+ * @param {import('@endo/patterns').InterfaceGuard<{
+ *  [K in M]: import('@endo/patterns').MethodGuard
+ * }>} [opts.interfaceGuard] An interface guard for the
  * new attenuator.
  * @param {string} [opts.tag] A tag for the new attenuator exoClass.
  */
@@ -265,7 +266,7 @@ export const prepareAttenuator = (
     /**
      * @param {object} opts
      * @param {any} [opts.target]
-     * @param {boolean} [opts.isSync=false]
+     * @param {boolean} [opts.isSync]
      * @param {Overrides} [opts.overrides]
      */
     ({
@@ -305,14 +306,14 @@ harden(prepareAttenuator);
 /**
  * Prepare an attenuator whose methodNames are derived from the interfaceGuard.
  *
- * @param {import('@agoric/zone').Zone} zone
- * @param {InterfaceGuard} interfaceGuard
+ * @template {import('@endo/patterns').InterfaceGuard} G
+ * @param {import('@agoric/base-zone').Zone} zone
+ * @param {G} interfaceGuard
  * @param {object} [opts]
  * @param {string} [opts.tag]
  */
 export const prepareGuardedAttenuator = (zone, interfaceGuard, opts = {}) => {
-  const { methodGuards } = interfaceGuard;
-  const methodNames = ownKeys(methodGuards);
+  const methodNames = getInterfaceMethodKeys(interfaceGuard);
   const makeAttenuator = prepareAttenuator(zone, methodNames, {
     ...opts,
     interfaceGuard,

package/src/config.d.ts

@@ -1,24 +1,31 @@
 export namespace BridgeId {
-    const BANK: string;
-    const CORE: string;
-    const DIBC: string;
-    const STORAGE: string;
-    const PROVISION: string;
-    const PROVISION_SMART_WALLET: string;
-    const WALLET: string;
+    let BANK: string;
+    let CORE: string;
+    let DIBC: string;
+    let STORAGE: string;
+    let PROVISION: string;
+    let PROVISION_SMART_WALLET: string;
+    let VLOCALCHAIN: string;
+    let WALLET: string;
+}
+export namespace CosmosInitKeyToBridgeId {
+    import vbankPort = BridgeId.BANK;
+    export { vbankPort };
+    import vibcPort = BridgeId.DIBC;
+    export { vibcPort };
 }
 export namespace WalletName {
-    const depositFacet: string;
+    let depositFacet: string;
 }
 export namespace VBankAccount {
     namespace reserve {
-        const module: string;
-        const address: string;
+        let module: string;
+        let address: string;
     }
     namespace provision {
-        const module_1: string;
+        let module_1: string;
         export { module_1 as module };
-        const address_1: string;
+        let address_1: string;
         export { address_1 as address };
     }
 }

package/src/config.js

@@ -21,10 +21,16 @@ export const BridgeId = {
   STORAGE: 'storage',
   PROVISION: 'provision',
   PROVISION_SMART_WALLET: 'provisionWallet',
+  VLOCALCHAIN: 'vlocalchain',
   WALLET: 'wallet',
 };
 harden(BridgeId);
 
+export const CosmosInitKeyToBridgeId = {
+  vbankPort: BridgeId.BANK,
+  vibcPort: BridgeId.DIBC,
+};
+
 export const WalletName = {
   depositFacet: 'depositFacet',
 };

package/src/index.d.ts

@@ -3,4 +3,6 @@ export * from "./debug.js";
 export * from "./utils.js";
 export * from "./method-tools.js";
 export * from "./typeGuards.js";
+export { objectMap } from "@endo/common/object-map.js";
+export { fromUniqueEntries } from "@endo/common/from-unique-entries.js";
 //# sourceMappingURL=index.d.ts.map

package/src/index.js

@@ -7,3 +7,6 @@ export * from './debug.js';
 export * from './utils.js';
 export * from './method-tools.js';
 export * from './typeGuards.js';
+
+export { objectMap } from '@endo/common/object-map.js';
+export { fromUniqueEntries } from '@endo/common/from-unique-entries.js';

package/src/install-ses-debug.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install-ses-debug.d.ts.map

package/src/install-ses-debug.d.ts.map

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

package/src/install-ses-debug.js

@@ -0,0 +1,6 @@
+// This is like `@endo/init` but sacrificing safety to optimize
+// for debugging and testing. The difference is only the lockdown options.
+// The setting below are *unsafe* and should not be used in contact with
+// genuinely malicious code.
+
+import '@endo/init/debug.js';

package/src/lib-chainStorage.d.ts

@@ -12,20 +12,7 @@
  */
 export function makeChainStorageRoot(handleStorageMessage: (message: StorageMessage) => any, rootPath: string, rootOptions?: {
     sequence?: boolean | undefined;
-} | undefined): {
-    getPath(): string;
-    /**
-     * @deprecated use getPath
-     * @type {() => Promise<VStorageKey>}
-     */
-    getStoreKey(): Promise<VStorageKey>;
-    /** @type {(name: string, childNodeOptions?: {sequence?: boolean}) => StorageNode} */
-    makeChildNode(name: string, childNodeOptions?: {
-        sequence?: boolean | undefined;
-    } | undefined): StorageNode;
-    /** @type {(value: string) => Promise<void>} */
-    setValue(value: string): Promise<void>;
-} & import("@endo/eventual-send").RemotableBrand<{}, {
+} | undefined): import("@endo/exo/src/exo-makers.js").Guarded<{
     getPath(): string;
     /**
      * @deprecated use getPath
@@ -51,25 +38,11 @@ export function makeChainStorageRoot(handleStorageMessage: (message: StorageMess
 export function makeStorageNodeChild(storageNodeRef: import('@endo/far').ERef<StorageNode | null>, childName: string): Promise<StorageNode>;
 export function isStreamCell(cell: any): cell is StreamCell<unknown>;
 export function assertCapData(data: unknown): asserts data is import("@endo/marshal").CapData<string>;
-export function unmarshalFromVstorage(data: Map<string, string>, key: string, fromCapData: ReturnType<typeof import('@endo/marshal').makeMarshal>['fromCapData'], index?: number | undefined): any;
 /** @type {(name: string) => void} */
 export const assertPathSegment: (name: string) => void;
-export function prepareChainStorageNode(zone: import('@agoric/zone').Zone): (args_0: import("./types.js").Callback<(message: StorageMessage) => any>, args_1: string, args_2?: {
+export function prepareChainStorageNode(zone: import('@agoric/base-zone').Zone): (messenger: import("./types.js").Callback<(message: StorageMessage) => any>, path: string, args_2?: {
     sequence?: boolean | undefined;
-} | undefined) => {
-    getPath(): string;
-    /**
-     * @deprecated use getPath
-     * @type {() => Promise<VStorageKey>}
-     */
-    getStoreKey(): Promise<VStorageKey>;
-    /** @type {(name: string, childNodeOptions?: {sequence?: boolean}) => StorageNode} */
-    makeChildNode(name: string, childNodeOptions?: {
-        sequence?: boolean | undefined;
-    } | undefined): StorageNode;
-    /** @type {(value: string) => Promise<void>} */
-    setValue(value: string): Promise<void>;
-} & import("@endo/eventual-send").RemotableBrand<{}, {
+} | undefined) => import("@endo/exo/src/exo-makers.js").Guarded<{
     getPath(): string;
     /**
      * @deprecated use getPath
@@ -174,6 +147,6 @@ export type StorageMessage = {
     args: [path: string];
 } | {
     method: StorageUpdateEntriesMessageMethod;
-    args: StorageUpdateEntriesMessageArgs;
+    args: StorageEntry[];
 };
 //# sourceMappingURL=lib-chainStorage.d.ts.map

package/src/lib-chainStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib-chainStorage.d.ts","sourceRoot":"","sources":["lib-chainStorage.js"],"names":[],"mappings":"AAmPA;;;;;;;;;;;GAWG;AACH,qEATqB,cAAc,KAAK,GAAG,YAGhC,MAAM;;;;IA1DX;;;OAGG;mBADa,QAAQ,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM;;oBAA8C,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,QAAQ,IAAI,CAAC;;;IAtB3C;;;OAGG;mBADa,QAAQ,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM;;oBAA8C,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,QAAQ,IAAI,CAAC;GAoDhD;AAUD;;;;;;;;GAQG;AACH,qDAJW,OAAO,WAAW,EAAE,IAAI,CAAC,WAAW,QAAE,aACtC,MAAM,GACJ,QAAQ,WAAW,CAAC,CAMhC;AAlOM,mCAHI,GAAG,+BAQ8B;AASrC,oCAHI,OAAO,2DASjB;AAWM,4CALI,IAAI,MAAM,EAAE,MAAM,CAAC,OACnB,MAAM,eACN,WAAW,cAAc,eAAe,EAAE,WAAW,CAAC,CAAC,aAAa,CAAC,mCAwB/E;AAgBD,qCAAqC;AACrC,uCADkB,MAAM,KAAK,IAAI,CAI/B;AAwBK,8CAFI,OAAO,cAAc,EAAE,IAAI,oDAqBiB,cAAc,KAAK,GAAG;;;;IAcvE;;;OAGG;mBADa,QAAQ,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM;;oBAA8C,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,QAAQ,IAAI,CAAC;;;IAtB3C;;;OAGG;mBADa,QAAQ,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM;;oBAA8C,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,QAAQ,IAAI,CAAC;GA0BhD;AA0DM,oDAJI,OAAO,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,cACrC,OAAO,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,WAC1B,OAAO,KAAK,QAAQ,IAAI,CAAC,CAQ7C;yBAvSa,WAAW,cAAc,eAAe,EAAE,WAAW,CAAC;2BACtD,KAAK,UAAU,EAAE,aAAa,CAAC;;;;;eAM/B,MAAM;iBACN,MAAM;qBACN,MAAM;;;;;;;iBAON,MAAM;YACN,CAAC,EAAE;;;;;;;;;;;;;;;qBAaI,MAAM,KAAK,QAAQ,IAAI,CAAC;;;;aAC/B,MAAM,MAAM;;;;iBACZ,MAAM,QAAQ,WAAW,CAAC;6BAChB,MAAM,YAAY;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,WAAW;;;;;;aA8EhE,MAAM,QAAQ,MAAM,CAAC;;;;iBACrB,WAAW,CAAC,aAAa,CAAC;;;;qBAC1B,MAAM,YAAY;;;;;4CAmBlB,KAAK,GAAG,aAAa,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAE,MAAM;;;;gDACzE,KAAK,GAAG,kBAAkB,GAAG,QAAQ;;;;mCACtC,6BAA6B,GAAG,iCAAiC;;;;0CAChE,CAAC,IAAI,EAAE,MAAM,CAAC;;;;2BACd,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;;;;8CACrC,mDAAc;;;;6BACf;IACZ,MAAU,EAAE,6BAA6B,CAAC;IAC1C,IAAQ,iBAA8B;CAClC,GAAG;IACP,MAAU,EAAE,iCAAiC,CAAC;IAC9C,IAAQ,kCAAkC;CACvC"}
+{"version":3,"file":"lib-chainStorage.d.ts","sourceRoot":"","sources":["lib-chainStorage.js"],"names":[],"mappings":"AAqNA;;;;;;;;;;;GAWG;AACH,qEATqB,cAAc,KAAK,GAAG,YAGhC,MAAM;;;;IA1DX;;;OAGG;mBADa,QAAQ,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM;;oBAA8C,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,QAAQ,IAAI,CAAC;GAoDhD;AAUD;;;;;;;;GAQG;AACH,qDAJW,OAAO,WAAW,EAAE,IAAI,CAAC,WAAW,QAAE,aACtC,MAAM,GACJ,QAAQ,WAAW,CAAC,CAMhC;AAnMM,mCAHI,GAAG,+BAQ8B;AASrC,oCAHI,OAAO,2DASjB;AAiBD,qCAAqC;AACrC,uCADkB,MAAM,KAAK,IAAI,CAI/B;AAwBK,8CAFI,OAAO,mBAAmB,EAAE,IAAI,uDAqBe,cAAc,KAAK,GAAG;;;;IAc1E;;;OAGG;mBADa,QAAQ,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM;;oBAA8C,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,QAAQ,IAAI,CAAC;GA0BhD;AA0DM,oDAJI,OAAO,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,cACrC,OAAO,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,WAC1B,OAAO,KAAK,QAAQ,IAAI,CAAC,CAQ7C;yBAxQa,WAAW,cAAc,eAAe,EAAE,WAAW,CAAC;2BACtD,KAAK,UAAU,EAAE,aAAa,CAAC;;;;;eAM/B,MAAM;iBACN,MAAM;qBACN,MAAM;;;;;;;iBAON,MAAM;YACN,CAAC,EAAE;;;;;;;;;;;;;;;qBAaI,MAAM,KAAK,QAAQ,IAAI,CAAC;;;;aAC/B,MAAM,MAAM;;;;iBACZ,MAAM,QAAQ,WAAW,CAAC;6BAChB,MAAM,YAAY;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,WAAW;;;;;;aA8ChE,MAAM,QAAQ,MAAM,CAAC;;;;iBACrB,WAAW,CAAC,aAAa,CAAC;;;;qBAC1B,MAAM,YAAY;;;;;4CAoBlB,KAAK,GAAG,aAAa,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAE,MAAM;;;;gDACzE,KAAK,GAAG,kBAAkB,GAAG,QAAQ;;;;mCACtC,6BAA6B,GAAG,iCAAiC;;;;0CAChE,CAAC,IAAI,EAAE,MAAM,CAAC;;;;2BACd,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;;;;8CACrC,mDAAc;;;;6BACf;IACZ,MAAU,EAAE,6BAA6B,CAAC;IAC1C,IAAQ,iBAA8B;CAClC,GAAG;IACP,MAAU,EAAE,iCAAiC,CAAC;IAC9C,IAAQ,iBAAkC;CACvC"}

package/src/lib-chainStorage.js

@@ -1,7 +1,8 @@
 // @ts-check
 
 import { E } from '@endo/far';
-import { M, heapZone } from '@agoric/zone';
+import { M } from '@endo/patterns';
+import { makeHeapZone } from '@agoric/base-zone/heap.js';
 import * as cb from './callback.js';
 
 const { Fail } = assert;
@@ -83,38 +84,6 @@ export const assertCapData = data => {
 };
 harden(assertCapData);
 
-/**
- * Read and unmarshal a value from a map representation of vstorage data
- *
- * @param {Map<string, string>} data
- * @param {string} key
- * @param {ReturnType<typeof import('@endo/marshal').makeMarshal>['fromCapData']} fromCapData
- * @param {number} [index=-1] index of the desired value in a deserialized stream cell
- */
-export const unmarshalFromVstorage = (data, key, fromCapData, index = -1) => {
-  const serialized = data.get(key) || Fail`no data for ${key}`;
-  assert.typeof(serialized, 'string');
-
-  const streamCell = JSON.parse(serialized);
-  if (!isStreamCell(streamCell)) {
-    throw Fail`not a StreamCell: ${streamCell}`;
-  }
-
-  const { values } = streamCell;
-  values.length > 0 || Fail`no StreamCell values: ${streamCell}`;
-
-  const marshalled = values.at(index);
-  assert.typeof(marshalled, 'string');
-
-  /** @type {import("@endo/marshal").CapData<string>} */
-  const capData = harden(JSON.parse(marshalled));
-  assertCapData(capData);
-
-  const unmarshalled = fromCapData(capData);
-  return unmarshalled;
-};
-harden(unmarshalFromVstorage);
-
 /**
  * @typedef {object} StoredFacet
  * @property {() => Promise<string>} getPath the chain storage path at which the node was constructed
@@ -126,6 +95,7 @@ harden(unmarshalFromVstorage);
 // Must be nonempty and disallow (unescaped) `.`, and for simplicity
 // (and future possibility of e.g. escaping) we currently limit to
 // ASCII alphanumeric plus underscore and dash.
+// Should remain consistent with golang/cosmos/x/vstorage/types/path_keys.go
 const pathSegmentPattern = /^[a-zA-Z0-9_-]{1,100}$/;
 
 /** @type {(name: string) => void} */
@@ -154,13 +124,13 @@ harden(assertPathSegment);
  */
 
 /**
- * @param {import('@agoric/zone').Zone} zone
+ * @param {import('@agoric/base-zone').Zone} zone
  */
 export const prepareChainStorageNode = zone => {
   /**
    * Create a storage node for a given backing storage interface and path.
    *
-   * @param {import('./callback').Callback<(message: StorageMessage) => any>} messenger a callback
+   * @param {import('./callback.js').Callback<(message: StorageMessage) => any>} messenger a callback
    * for sending a storageMessage object to the storage implementation
    * (cf. golang/cosmos/x/vstorage/vstorage.go)
    * @param {string} path
@@ -175,7 +145,7 @@ export const prepareChainStorageNode = zone => {
     'ChainStorageNode',
     ChainStorageNodeI,
     /**
-     * @param {import('./callback').Callback<(message: StorageMessage) => any>} messenger
+     * @param {import('./callback.js').Callback<(message: StorageMessage) => any>} messenger
      * @param {string} path
      * @param {object} [options]
      * @param {boolean} [options.sequence]
@@ -239,7 +209,7 @@ export const prepareChainStorageNode = zone => {
   return makeChainStorageNode;
 };
 
-const makeHeapChainStorageNode = prepareChainStorageNode(heapZone);
+const makeHeapChainStorageNode = prepareChainStorageNode(makeHeapZone());
 
 /**
  * Create a heap-based root storage node for a given backing function and root path.

package/src/lib-nodejs/engine-gc.d.ts

@@ -0,0 +1,3 @@
+export default engineGC;
+declare const engineGC: () => void;
+//# sourceMappingURL=engine-gc.d.ts.map

package/src/lib-nodejs/engine-gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-gc.d.ts","sourceRoot":"","sources":["engine-gc.js"],"names":[],"mappings":";AAoBA,mCAAwB"}

package/src/lib-nodejs/engine-gc.js

@@ -0,0 +1,22 @@
+import v8 from 'v8';
+import vm from 'vm';
+
+/* global globalThis */
+let bestGC = globalThis.gc;
+if (typeof bestGC !== 'function') {
+  // Node.js v8 wizardry.
+  v8.setFlagsFromString('--expose_gc');
+  bestGC = vm.runInNewContext('gc');
+  assert(bestGC);
+  // We leave --expose_gc turned on, otherwise AVA's shared workers
+  // may race and disable it before we manage to extract the
+  // binding. This won't cause 'gc' to be visible to new Compartments
+  // because SES strips out everything it doesn't recognize.
+
+  // // Hide the gc global from new contexts/workers.
+  // v8.setFlagsFromString('--no-expose_gc');
+}
+
+// Export a const.
+const engineGC = bestGC;
+export default engineGC;

package/src/lib-nodejs/gc-and-finalize.d.ts

@@ -0,0 +1,2 @@
+export function makeGcAndFinalize(gcPower: any): () => Promise<void>;
+//# sourceMappingURL=gc-and-finalize.d.ts.map

package/src/lib-nodejs/gc-and-finalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc-and-finalize.d.ts","sourceRoot":"","sources":["gc-and-finalize.js"],"names":[],"mappings":"AAkEA,qEAwBC"}