@agoric/internal 0.3.3-u11.0 → 0.3.3-upgrade-16-dev-8879538.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/exported.js

@@ -0,0 +1,2 @@
+// Dummy file for .d.ts twin to declare ambients
+export {};

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@agoric/internal",
-  "version": "0.3.3-u11.0",
+  "version": "0.3.3-upgrade-16-dev-8879538.0+8879538",
   "description": "Externally unsupported utilities internal to agoric-sdk",
   "type": "module",
   "main": "src/index.js",
   "engines": {
-    "node": ">=14.15.0"
+    "node": "^18.12 || ^20.9"
   },
   "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,30 +17,46 @@
     "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-u11.0",
-    "@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-upgrade-16-dev-8879538.0+8879538",
+    "@agoric/base-zone": "0.1.1-upgrade-16-dev-8879538.0+8879538",
+    "@endo/common": "^1.2.2",
+    "@endo/far": "^1.1.2",
+    "@endo/init": "^1.1.2",
+    "@endo/marshal": "^1.5.0",
+    "@endo/pass-style": "^1.4.0",
+    "@endo/patterns": "^1.4.0",
+    "@endo/promise-kit": "^1.1.2",
+    "@endo/stream": "^1.2.2",
     "anylogger": "^0.21.0",
-    "jessie.js": "^0.3.2"
+    "jessie.js": "^0.3.4"
   },
   "devDependencies": {
-    "@endo/init": "^0.5.56",
-    "ava": "^5.2.0",
-    "tsd": "^0.28.1"
+    "@endo/init": "^1.1.2",
+    "ava": "^5.3.0",
+    "tsd": "^0.30.7"
+  },
+  "ava": {
+    "require": [
+      "@endo/init/debug.js"
+    ],
+    "files": [
+      "test/**/*.test.*"
+    ]
   },
   "author": "Agoric",
   "license": "Apache-2.0",
   "files": [
-    "src"
+    "src",
+    "exported.js"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "92b6cd72484079b0349d8ccfa4510aeb820e8d67"
+  "typeCoverage": {
+    "atLeast": 93.81
+  },
+  "gitHead": "8879538cd1d125a08346f02dd5701d0d70c90bb8"
 }

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,YAAY,sBAAqC;IAAC,UAAU,oBAAkC;CAAE,mBAClG,MAAM,aANM,OAAO,EAAE,UAAU,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CA8CjE;AAjDD,4CAA6C;8BAGhC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,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: SyncCallback<I>, ...args: Parameters<I>): ReturnType<I>;
+export function callE<I extends (...args: unknown[]) => any>(callback: 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): SyncCallback<I>;
+export function makeFunctionCallback<I extends (...args: unknown[]) => any, T extends ERef<(...args: [...B, ...Parameters<I>]) => ReturnType<I>> = ERef<I>, B extends unknown[] = []>(target: T, ...bound: B): 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): SyncCallback<I>;
+export function makeMethodCallback<I extends (...args: unknown[]) => any, P extends PropertyKey, T extends ERef<{ [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>; }> = ERef<{ [x_1 in P]: I; }>, B extends unknown[] = []>(target: T, methodName: P, ...bound: B): Callback<I>;
+export function isCallback(callback: any): callback is 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]?: Callback<any> | null | undefined; } | undefined;
+}) => import("@endo/exo").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").Methods> = (...args: Parameters<ReturnType<(<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_1 in M]?: Callback<any> | null | undefined; } | undefined;
+}) => import("@endo/exo").Guarded<{ [K_2 in M]: (this: any, ...args: unknown[]) => any; }>)>>) => import("@endo/exo").Farable<T>;
+import type { SyncCallback } from './types.js';
+import type { Callback } from './types.js';
+import type { ERef } from '@endo/far';
 //# 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":"AA+CO,yBAFiB,CAAC,mBAHD,OAAO,EAAE,KAAK,GAAG,sCAE9B,UAAU,CACG,CAAC,AADF,CAAC,GACX,UAAU,CAAC,CAAC,CAAC,CAQzB;AAWM,sBAFiC,CAAC,mBAHjB,OAAO,EAAE,KAAK,GAAG,kCAE9B,UAAU,CACmB,CAAC,AADlB,CAAC,GACX,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAQ3C;AAaM,yCAK0B,CAAC,mBAZV,OAAO,EAAE,KAAK,GAAG,EAG9B,CAAC,mBAFY,CAAC,GAGd,CAAC,AAHiB,EAAE,GAAG,UAAU,CAWX,CAAC,AAXY,CAAC,CAAC,KAAK,UAAU,CAW9B,CAAC,AAX+B,CAAC,MAGvD,CAAC,iCADD,CAAC,YACD,CAAC,mBASX;AAeM,qCAKsB,CAAC,mBAdN,OAAO,EAAE,KAAK,GAAG,EAK9B,CAAC,wBAHG,CAAC,GAIL,CAAC,AAJQ,EAAE,GAAG,UAAU,CAYN,CAAC,AAZO,CAAC,CAAC,KAAK,UAAU,CAYzB,CAAC,AAZ0B,CAAC,aAI9C,CAAC,iCADD,CAAC,YACD,CAAC,eASX;AAiBM,uCAQ0B,CAAC,mBAnBV,OAAO,EAAE,KAAK,GAAG,EAO9B,CAAC,sBADD,CAAC,+BAHa,CAAC,GAKf,CAAC,AALkB,EAAE,GAAG,UAAU,CAgBZ,CAAC,AAhBa,CAAC,CAAC,KAAK,UAAU,CAgB/B,CAAC,AAhBgC,CAAC,0BAKxD,CAAC,iCAFD,CAAC,cACD,CAAC,YACD,CAAC,mBAYX;AAiBM,mCAOsB,CAAC,mBAlBN,OAAO,EAAE,KAAK,GAAG,EAO9B,CAAC,sBADD,CAAC,oCAHa,CAAC,GAKf,CAAC,AALkB,EAAE,GAAG,UAAU,CAehB,CAAC,AAfiB,CAAC,CAAC,KAAK,UAAU,CAenC,CAAC,AAfoC,CAAC,iCAKxD,CAAC,iCAFD,CAAC,cACD,CAAC,YACD,CAAC,eAWX;AAOM,qCAHI,GAAG,6BAeb;AAgBM,kCARI,CAAC,4BADD,OAAO,mBAAmB,EAAE,IAAI,eAChC,CAAC,EAAE;IAID,cAAc;IAEF,GAAG;;aAkEb,GAAG;;;uDAxDgB,GAAG,WAAW,OAAO,EAAE,KAAK,GAAG,KA2FhE;AAYM,yCAJI,CAAC,mHADD,OAAO,mBAAmB,EAAE,IAAI,kBAChC,CAAC;;gBAUQ,cAAc,CAAC,GAAG,CAAC,CACtC;2BAtSgG,CAAC,wCAArF,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,UAAU,GAwKjC,CAAC,4BADD,OAAO,mBAAmB,EAAE,IAAI,eAChC,CAAC,EAAE;IAID,cAAc;IAEF,GAAG;;;;;uDAUM,GAAG,WAAW,OAAO,EAAE,cAxLM,CAAC,KAAK,OAAO,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;kCAdvD,YAAY;8BAAZ,YAAY;0BAD9B,WAAW"}

package/src/callback.js

@@ -1,6 +1,10 @@
 // @ts-check
 import { E } from '@endo/far';
 import { isObject, isPassableSymbol } from '@endo/marshal';
+import { getInterfaceMethodKeys } from '@endo/patterns';
+
+/** @import { ERef } from '@endo/far' */
+/** @import { Callback, SyncCallback } from './types.js' */
 
 const { Fail, quote: q } = assert;
 
@@ -13,22 +17,10 @@ const ownKeys =
   );
 
 /**
- * @template T
- * @typedef {(...args: Parameters<ReturnType<prepareAttenuator>>) => Farable<T>} MakeAttenuator
- */
-
-/**
- * @template {(...args: unknown[]) => any} I
- * @typedef {import('./types').Callback<I>} Callback
- */
-
-/**
- * @template {(...args: unknown[]) => any} I
- * @typedef {import('./types').SyncCallback<I>} SyncCallback
+ * @template {import('@endo/exo').Methods} T
+ * @typedef {(...args: Parameters<ReturnType<prepareAttenuator>>) => import('@endo/exo').Farable<T>} MakeAttenuator
  */
 
-/** @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
@@ -102,9 +94,9 @@ harden(makeSyncFunctionCallback);
  * Create a callback from a potentially far function.
  *
  * @template {(...args: unknown[]) => any} I
- * @template {import('@endo/far').ERef<
+ * @template {ERef<
  *   (...args: [...B, ...Parameters<I>]) => ReturnType<I>
- * >} [T=import('@endo/far').ERef<I>]
+ * >} [T=ERef<I>]
  * @template {unknown[]} [B=[]]
  * @param {T} target
  * @param {B} bound
@@ -150,9 +142,9 @@ harden(makeSyncMethodCallback);
  *
  * @template {(...args: unknown[]) => any} I
  * @template {PropertyKey} P
- * @template {import('@endo/far').ERef<{
+ * @template {ERef<{
  *   [x in P]: (...args: [...B, ...Parameters<I>]) => ReturnType<I>
- * }>} [T=import('@endo/far').ERef<{ [x in P]: I }>]
+ * }>} [T=ERef<{ [x in P]: I }>]
  * @template {unknown[]} [B=[]]
  * @param {T} target
  * @param {P} methodName
@@ -193,10 +185,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 +259,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 +299,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,25 +1,34 @@
 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: "bank";
+    let CORE: "core";
+    let DIBC: "dibc";
+    let STORAGE: "storage";
+    let PROVISION: "provision";
+    let PROVISION_SMART_WALLET: "provisionWallet";
+    let VLOCALCHAIN: "vlocalchain";
+    let VTRANSFER: "vtransfer";
+    let WALLET: "wallet";
+}
+export namespace CosmosInitKeyToBridgeId {
+    import vbankPort = BANK;
+    export { vbankPort };
+    import vibcPort = 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 };
     }
 }
+export type BridgeIdValue = (typeof BridgeId)[keyof typeof BridgeId];
 //# sourceMappingURL=config.d.ts.map

package/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["config.js"],"names":[],"mappings":""}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["config.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA4Bc,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC"}

package/src/config.js

@@ -14,16 +14,24 @@
 /**
  * Event source ids used by the bridge device.
  */
-export const BridgeId = {
+export const BridgeId = /** @type {const} */ ({
   BANK: 'bank',
   CORE: 'core',
   DIBC: 'dibc',
   STORAGE: 'storage',
   PROVISION: 'provision',
   PROVISION_SMART_WALLET: 'provisionWallet',
+  VLOCALCHAIN: 'vlocalchain',
+  VTRANSFER: 'vtransfer',
   WALLET: 'wallet',
-};
+});
 harden(BridgeId);
+/** @typedef {(typeof BridgeId)[keyof typeof BridgeId]} BridgeIdValue */
+
+export const CosmosInitKeyToBridgeId = {
+  vbankPort: BridgeId.BANK,
+  vibcPort: BridgeId.DIBC,
+};
 
 export const WalletName = {
   depositFacet: 'depositFacet',

package/src/debug.d.ts

@@ -1,2 +1,2 @@
-export function makeTracer(name: string, enable?: boolean | 'verbose'): (..._args: any[]) => void;
+export function makeTracer(name: string, enable?: boolean | "verbose"): (..._args: any[]) => void;
 //# sourceMappingURL=debug.d.ts.map

package/src/index.d.ts

@@ -3,4 +3,7 @@ export * from "./debug.js";
 export * from "./utils.js";
 export * from "./method-tools.js";
 export * from "./typeGuards.js";
+export * from "./types.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

@@ -1,9 +1,15 @@
 // @jessie-check
 
-/// <reference types="ses"/>
+/// <reference types="ses" />
 
 export * from './config.js';
 export * from './debug.js';
 export * from './utils.js';
 export * from './method-tools.js';
 export * from './typeGuards.js';
+
+// eslint-disable-next-line import/export -- just types
+export * from './types.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,7 +12,7 @@
  */
 export function makeChainStorageRoot(handleStorageMessage: (message: StorageMessage) => any, rootPath: string, rootOptions?: {
     sequence?: boolean | undefined;
-} | undefined): {
+} | undefined): import("@endo/exo").Guarded<{
     getPath(): string;
     /**
      * @deprecated use getPath
@@ -21,21 +21,8 @@ export function makeChainStorageRoot(handleStorageMessage: (message: StorageMess
     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<{}, {
-    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;
+        sequence?: boolean;
+    }): StorageNode;
     /** @type {(value: string) => Promise<void>} */
     setValue(value: string): Promise<void>;
 }>;
@@ -44,19 +31,18 @@ export function makeChainStorageRoot(handleStorageMessage: (message: StorageMess
  * falling back to an inert object with the correct interface (but incomplete
  * behavior) when that is unavailable.
  *
- * @param {import('@endo/far').ERef<StorageNode?>} storageNodeRef
+ * @param {ERef<StorageNode?>} storageNodeRef
  * @param {string} childName
  * @returns {Promise<StorageNode>}
  */
-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 makeStorageNodeChild(storageNodeRef: ERef<StorageNode | null>, childName: string): Promise<StorageNode>;
+export function isStreamCell(cell: any): cell is StreamCell;
 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) => {
+} | undefined) => import("@endo/exo").Guarded<{
     getPath(): string;
     /**
      * @deprecated use getPath
@@ -65,27 +51,19 @@ export function prepareChainStorageNode(zone: import('@agoric/zone').Zone): (arg
     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<{}, {
-    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;
+        sequence?: boolean;
+    }): StorageNode;
     /** @type {(value: string) => Promise<void>} */
     setValue(value: string): Promise<void>;
 }>;
-export function makeSerializeToStorage(storageNode: import('@endo/far').ERef<StorageNode>, marshaller: import('@endo/far').ERef<Marshaller>): (value: unknown) => Promise<void>;
-export type Marshaller = ReturnType<typeof import('@endo/marshal').makeMarshal>;
-export type Unserializer = Pick<Marshaller, 'fromCapData'>;
+export function makeSerializeToStorage(storageNode: ERef<StorageNode>, marshaller: ERef<{
+    toCapData: import("@endo/marshal").ToCapData<unknown>;
+    fromCapData: import("@endo/marshal").FromCapData<unknown>;
+    serialize: import("@endo/marshal").ToCapData<unknown>;
+    unserialize: import("@endo/marshal").FromCapData<unknown>;
+}>): (value: PassableCap) => Promise<void>;
+export type Marshaller = ReturnType<typeof import("@endo/marshal").makeMarshal>;
+export type Unserializer = Pick<Marshaller, "fromCapData">;
 /**
  * Defined by vstorageStoreKey in vstorage.go
  */
@@ -136,7 +114,7 @@ export type StoredFacet = {
     /**
      * DEPRECATED use getPath
      */
-    getStoreKey: StorageNode['getStoreKey'];
+    getStoreKey: StorageNode["getStoreKey"];
     /**
      * get the unserializer for the stored data
      */
@@ -145,11 +123,11 @@ export type StoredFacet = {
 /**
  * Must match the switch in vstorage.go using `vstorageMessage` type
  */
-export type StorageGetByPathMessageMethod = 'get' | 'getStoreKey' | 'has' | 'children' | 'entries' | 'values' | 'size';
+export type StorageGetByPathMessageMethod = "get" | "getStoreKey" | "has" | "children" | "entries" | "values" | "size";
 /**
  * Must match the switch in vstorage.go using `vstorageMessage` type
  */
-export type StorageUpdateEntriesMessageMethod = 'set' | 'setWithoutNotify' | 'append';
+export type StorageUpdateEntriesMessageMethod = "set" | "setWithoutNotify" | "append";
 /**
  * Must match the switch in vstorage.go using `vstorageMessage` type
  */
@@ -165,15 +143,17 @@ export type StorageEntry = [path: string, value?: string | null];
 /**
  * Must match the switch in vstorage.go using `vstorageMessage` type
  */
-export type StorageUpdateEntriesMessageArgs = [path: string, value?: string | null | undefined][];
+export type StorageUpdateEntriesMessageArgs = StorageEntry[];
 /**
  * Must match the switch in vstorage.go using `vstorageMessage` type
  */
 export type StorageMessage = {
     method: StorageGetByPathMessageMethod;
-    args: [path: string];
+    args: StorageGetByPathMessageArgs;
 } | {
     method: StorageUpdateEntriesMessageMethod;
     args: StorageUpdateEntriesMessageArgs;
 };
+import type { ERef } from '@endo/far';
+import type { PassableCap } from '@endo/marshal';
 //# 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":"AA0NA;;;;;;;;;;;GAWG;AACH,2DATW,CAAC,OAAO,EAAE,cAAc,KAAK,GAAG,YAGhC,MAAM;;;;IA1DX;;;OAGG;mBADa,OAAO,CAAC,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM,qBAAqB;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,GAAK,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,OAAO,CAAC,IAAI,CAAC;GAoDhD;AAUD;;;;;;;;GAQG;AACH,0FAHW,MAAM,GACJ,OAAO,CAAC,WAAW,CAAC,CAMhC;AAnMM,mCAHI,GAAG,GACD,IAAI,IAAI,UAAU,CAOa;AASrC,oCAHI,OAAO,GACL,OAAO,CAAC,IAAI,IAAI,OAAO,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,CAQnE;AAiBD,qCAAqC;AACrC,gCADW,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAI/B;AAwBK,8CAFI,OAAO,mBAAmB,EAAE,IAAI,uDAqBY,cAAc,KAAK,GAAG;;;;IAcvE;;;OAGG;mBADa,OAAO,CAAC,WAAW,CAAC;IASpC,qFAAqF;wBAAnE,MAAM,qBAAqB;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,GAAK,WAAW;IAWjF,+CAA+C;oBAA5B,MAAM,GAAK,OAAO,CAAC,IAAI,CAAC;GA0BhD;AA0DM;;;;;6BAF8B,OAAO,CAAC,IAAI,CAAC,CAQjD;yBAxQa,UAAU,CAAC,cAAc,eAAe,EAAE,WAAW,CAAC;2BACtD,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;;;;;eAM/B,MAAM;iBACN,MAAM;qBACN,MAAM;;;uBAQN,CAAC;;;;iBADD,MAAM;YACN,CAAC,EAAE;;;;;;;;;;;;;;;cAaH,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;;;;aAC/B,MAAM,MAAM;;;;iBACZ,MAAM,OAAO,CAAC,WAAW,CAAC;mBAC1B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,WAAW;;;;;;aA8ChE,MAAM,OAAO,CAAC,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,YAAY,EAAE;;;;6BACf;IACZ,MAAU,EAAE,6BAA6B,CAAC;IAC1C,IAAQ,EAAE,2BAA2B,CAAC;CAClC,GAAG;IACP,MAAU,EAAE,iCAAiC,CAAC;IAC9C,IAAQ,EAAE,+BAA+B,CAAC;CACvC;0BAvHmB,WAAW;iCACJ,eAAe"}