@agoric/vats 0.15.1 → 0.15.2-calypso-dev-84eb287.0

package/src/core/utils.d.ts

@@ -1,55 +1,13 @@
 /**
- * We reserve these keys in name hubs.
+ * Used in bootstrap to reserve names in the agoricNames namespace before any
+ * other proposals.
  *
- * @type {{ [P in keyof WellKnownName]: { [P2 in WellKnownName[P]]: string } }}
+ * @type {{
+ *   [P in keyof WellKnownName]: { [P2 in WellKnownName[P]]: string };
+ * }}
  */
-export const agoricNamesReserved: {
-    issuer: {
-        IST: string;
-        BLD: string;
-        Invitation: string;
-        AUSD: string;
-    };
-    installation: {
-        reserve: string;
-        centralSupply: string;
-        mintHolder: string;
-        walletFactory: string;
-        provisionPool: string;
-        auctioneer: string;
-        feeDistributor: string;
-        contractGovernor: string;
-        committee: string;
-        noActionElectorate: string;
-        binaryVoteCounter: string;
-        VaultFactory: string;
-        liquidate: string;
-        Pegasus: string;
-        psm: string;
-        econCommitteeCharter: string;
-        priceAggregator: string;
-    };
-    instance: {
-        reserve: string;
-        walletFactory: string;
-        provisionPool: string;
-        auctioneer: string;
-        feeDistributor: string;
-        VaultFactory: string;
-        Pegasus: string;
-        econCommitteeCharter: string;
-        economicCommittee: string;
-        VaultFactoryGovernor: string;
-        reserveGovernor: string;
-    };
-    oracleBrand: {
-        USD: string;
-    };
-    uiConfig: {
-        VaultFactory: string;
-    };
-};
-/** @type { FeeIssuerConfig } */
+export const agoricNamesReserved: { [P in keyof WellKnownName]: { [P2 in WellKnownName[P]]: string; }; };
+/** @type {FeeIssuerConfig} */
 export const feeIssuerConfig: FeeIssuerConfig;
 export function addRemote(addr: string, { vats: { comms, vattp } }: {
     vats: {
@@ -57,7 +15,7 @@ export function addRemote(addr: string, { vats: { comms, vattp } }: {
         comms: CommsVatRoot;
     };
 }): Promise<void>;
-export function callProperties(builders: ((...args: any[]) => Record<string, unknown>)[], ...args: unknown[]): Record<string, unknown>;
+export function callProperties(builders: ((...args: any) => Record<string, unknown>)[], ...args: unknown[]): Record<string, unknown>;
 export function extract(template: true | string | Record<string, any>, specimen: unknown, path?: string[] | undefined): any;
 export function extractPowers(permit: true | string | Record<string, any>, allPowers: unknown): any;
 export function runModuleBehaviors({ allPowers, behaviors, manifest, makeConfig, }: {
@@ -66,11 +24,11 @@ export function runModuleBehaviors({ allPowers, behaviors, manifest, makeConfig,
     manifest: Record<string, Record<string, unknown>>;
     makeConfig: (name: string, permit: Record<string, unknown>) => unknown;
 }): Promise<any[]>;
-export function makePromiseSpaceForNameHub(nameAdmin: ERef<import('../types').NameAdmin>, log?: {
+export function makePromiseSpaceForNameHub(nameAdmin: ERef<import("../types.js").NameAdmin>, log?: {
     (...data: any[]): void;
     (message?: any, ...optionalParams: any[]): void;
 } | undefined): PromiseSpaceOf<any, {}, {}>;
-export function makeWellKnownSpaces(parentAdmin: ERef<import('../types').NameAdmin>, log?: {
+export function makeWellKnownSpaces(parentAdmin: ERef<import("../types.js").NameAdmin>, log?: {
     (...data: any[]): void;
     (message?: any, ...optionalParams: any[]): void;
 } | undefined, kinds?: string[] | undefined): Promise<WellKnownSpaces>;
@@ -78,80 +36,77 @@ export function makeAgoricNamesAccess(log?: {
     (...data: any[]): void;
     (message?: any, ...optionalParams: any[]): void;
 } | undefined, reserved?: Record<string, Record<string, unknown>>): Promise<{
-    agoricNames: import('../types.js').NameHub;
-    agoricNamesAdmin: import('../types.js').NameAdmin;
+    agoricNames: import("../types.js").NameHub;
+    agoricNamesAdmin: import("../types.js").NameAdmin;
     spaces: WellKnownSpaces;
 }>;
 export function makeMyAddressNameAdminKit(address: string): {
-    nameHub: import("../types").NameHub;
-    myAddressNameAdmin: import("../types").MyAddressNameAdmin;
+    nameHub: import("../types.js").NameHub<any>;
+    myAddressNameAdmin: import("../types.js").MyAddressNameAdmin;
 };
-export function makeVatSpace(svc: ERef<ReturnType<Awaited<VatAdminVat>['createVatAdminService']>>, criticalVatKey: unknown, log?: ((...args: any) => void) | undefined, label?: string | undefined): {
+export function makeVatSpace(svc: ERef<ReturnType<Awaited<VatAdminVat>["createVatAdminService"]>>, criticalVatKey: unknown, log?: ((...args: any) => void) | undefined, label?: string | undefined): {
     space: {
         consume: {
             agoricNames: Promise<{
-                getNameHub: () => import("../types").NameHub;
-                getNameHubKit: () => import("../types").NameHubKit;
+                getNameHub: () => import("../types.js").NameHub<any>;
+                getNameHubKit: () => import("../types.js").NameHubKit;
                 publishNameHubs: (nameStorage: ERef<StorageNode>, vatBoard: ERef<BoardVat>, kinds: string[]) => Promise<void>;
-                provideInertBrand: (keyword: string, displayInfo: DisplayInfo<AssetKind>) => any;
-            } & import("@endo/eventual-send").RemotableBrand<{}, {
-                getNameHub: () => import("../types").NameHub;
-                getNameHubKit: () => import("../types").NameHubKit;
+                provideInertBrand: (keyword: string, displayInfo: DisplayInfo) => any;
+            } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+                getNameHub: () => import("../types.js").NameHub<any>;
+                getNameHubKit: () => import("../types.js").NameHubKit;
                 publishNameHubs: (nameStorage: ERef<StorageNode>, vatBoard: ERef<BoardVat>, kinds: string[]) => Promise<void>;
-                provideInertBrand: (keyword: string, displayInfo: DisplayInfo<AssetKind>) => any;
+                provideInertBrand: (keyword: string, displayInfo: DisplayInfo) => any;
             }>>;
             board: Promise<{
-                getBoard: () => {
-                    getId(value: any): string;
-                    getValue(id: string): any;
+                getBoard: () => import("@endo/exo").Guarded<{
+                    getId(value: import("@endo/pass-style").RemotableObject): string;
+                    getValue(id: BoardId): import("@endo/pass-style").RemotableObject;
                     lookup(...path: string[]): Promise<any>;
-                    has(val: any): boolean;
+                    has(val: import("@endo/pass-style").RemotableObject): boolean;
                     ids(): string[];
-                    getPublishingMarshaller(): {
+                    getPublishingMarshaller(): import("@endo/exo").Guarded<{
                         toCapData(val: any): import("@endo/marshal").CapData<string>;
                         fromCapData(data: any): any;
                         serialize(data: any): import("@endo/marshal").CapData<string>;
                         unserialize(data: any): any;
-                    };
-                    getReadonlyMarshaller(): {
+                    }>;
+                    getReadonlyMarshaller(): import("@endo/exo").Guarded<{
                         toCapData(val: any): import("@endo/marshal").CapData<string | null>;
                         fromCapData(data: any): any;
                         serialize(data: any): import("@endo/marshal").CapData<string | null>;
                         unserialize(data: any): any;
-                    };
-                };
-                makePublishingRecorderKit: <T>(storageNode: StorageNode, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => import("@agoric/zoe/src/contractSupport/recorder.js").RecorderKit<T>;
-                makeReadOnlyRecorderKit: <T>(storageNode: StorageNode, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => import("@agoric/zoe/src/contractSupport/recorder.js").RecorderKit<T>;
-            } & import("@endo/eventual-send").RemotableBrand<{}, {
-                getBoard: () => {
-                    getId(value: any): string;
-                    getValue(id: string): any;
+                    }>;
+                }>;
+                makePublishingRecorderKit: <T>(storageNode: StorageNode | Awaited<import("@endo/far").FarRef<StorageNode>>, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => RecorderKit<T>;
+                makeReadOnlyRecorderKit: <T>(storageNode: StorageNode | Awaited<import("@endo/far").FarRef<StorageNode>>, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => RecorderKit<T>;
+            } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+                getBoard: () => import("@endo/exo").Guarded<{
+                    getId(value: import("@endo/pass-style").RemotableObject): string;
+                    getValue(id: BoardId): import("@endo/pass-style").RemotableObject;
                     lookup(...path: string[]): Promise<any>;
-                    has(val: any): boolean;
+                    has(val: import("@endo/pass-style").RemotableObject): boolean;
                     ids(): string[];
-                    getPublishingMarshaller(): {
+                    getPublishingMarshaller(): import("@endo/exo").Guarded<{
                         toCapData(val: any): import("@endo/marshal").CapData<string>;
                         fromCapData(data: any): any;
                         serialize(data: any): import("@endo/marshal").CapData<string>;
                         unserialize(data: any): any;
-                    };
-                    getReadonlyMarshaller(): {
+                    }>;
+                    getReadonlyMarshaller(): import("@endo/exo").Guarded<{
                         toCapData(val: any): import("@endo/marshal").CapData<string | null>;
                         fromCapData(data: any): any;
                         serialize(data: any): import("@endo/marshal").CapData<string | null>;
                         unserialize(data: any): any;
-                    };
-                };
-                makePublishingRecorderKit: <T>(storageNode: StorageNode, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => import("@agoric/zoe/src/contractSupport/recorder.js").RecorderKit<T>;
-                makeReadOnlyRecorderKit: <T>(storageNode: StorageNode, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => import("@agoric/zoe/src/contractSupport/recorder.js").RecorderKit<T>;
+                    }>;
+                }>;
+                makePublishingRecorderKit: <T>(storageNode: StorageNode | Awaited<import("@endo/far").FarRef<StorageNode>>, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => RecorderKit<T>;
+                makeReadOnlyRecorderKit: <T>(storageNode: StorageNode | Awaited<import("@endo/far").FarRef<StorageNode>>, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => RecorderKit<T>;
             }>>;
         };
     };
-    durableStore: MapStore<K, V>;
+    durableStore: globalThis.MapStore<any, any>;
 };
-/**
- * as from createVatByName
- */
-export type CreateVatResults = import('@agoric/swingset-vat').CreateVatResults;
 export type VatStore = MapStore<string, CreateVatResults>;
+import type { CreateVatResults } from '@agoric/swingset-vat';
 //# sourceMappingURL=utils.d.ts.map

package/src/core/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["utils.js"],"names":[],"mappings":"AAaA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDG;AAEH,gCAAgC;AAChC,8BADY,eAAe,CAKzB;AAQK,gCAHI,MAAM,8BACN;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAA;CAAC,iBAK3D;AAQM,8DAJuB,OAAO,MAAM,EAAE,OAAO,CAAC,cACtC,OAAO,KACT,OAAO,MAAM,EAAE,OAAO,CAAC,CAG0B;AASvD,kCAJI,IAAI,GAAG,MAAM,GAAG,OAAO,MAAM,MAAI,YACjC,OAAO,oCAkCjB;AAOM,sCAHI,IAAI,GAAG,MAAM,GAAG,OAAO,MAAM,MAAI,aACjC,OAAO,OAYjB;AAUM;eALI,OAAO;eACP,OAAO,MAAM,EAAE,OAAO,CAAC;cACvB,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,CAAC,CAAC;uBAC/B,MAAM,UAAU,OAAO,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO;mBAwBrE;AAUM,sDAHI,KAAK,OAAO,UAAU,EAAE,SAAS,CAAC;;;4CAyB5C;AAOM,iDAJI,KAAK,OAAO,UAAU,EAAE,SAAS,CAAC;;;uEAsB5C;AAuBM;;;0BAfI,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,CAAC,CAAC;iBAUhC,OAAO,aAAa,EAAE,OAAO;sBACxB,OAAO,aAAa,EAAE,SAAS;YACzC,eAAe;GAuB3B;AAOM,mDAJI,MAAM;;;EAkBhB;AAWM,kCARI,KAAK,WAAW,QAAQ,WAAW,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,kBAC/D,OAAO,mBACG,GAAG,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDhC;;;;+BAlDY,OAAO,sBAAsB,EAAE,gBAAgB;uBAC/C,SAAS,MAAM,EAAE,gBAAgB,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["utils.js"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,kCAJU,GACJ,CAAwB,IAAnB,MAAM,aAAa,GAAG,GAAG,EAAsB,IAAhB,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,GAAE,GACjE,CA+DD;AAEH,8BAA8B;AAC9B,8BADW,eAAe,CAKxB;AAQK,gCAHI,MAAM,8BACN;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAA;CAAE,iBAK5D;AAQM,yCAJI,CAAC,CAAC,GAAG,IAAI,KAAA,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,WACrC,OAAO,EAAA,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG0B;AAWvD,kCALI,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAEnC,OAAO,oCAkCjB;AAQM,sCAJI,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,aAEnC,OAAO,OAYjB;AAUM,oFALJ;IAAsB,SAAS,EAAvB,OAAO;IACuB,SAAS,EAAvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACuB,QAAQ,EAAtD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC0B,UAAU,EAA3E,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO;CACpE,kBAuBA;AASM,sDAHI,IAAI,CAAC,OAAO,aAAa,EAAE,SAAS,CAAC;;;4CAyB/C;AAOM,iDAJI,IAAI,CAAC,OAAO,aAAa,EAAE,SAAS,CAAC;;;uEAsB/C;AAoBM;;;0BAXI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAKrC,OAAO,CAAC;IACpB,WAAe,EAAE,OAAO,aAAa,EAAE,OAAO,CAAC;IAC/C,gBAAoB,EAAE,OAAO,aAAa,EAAE,SAAS,CAAC;IACtD,MAAU,EAAE,eAAe,CAAC;CACzB,CAAC,CAsBJ;AAMM,mDAFI,MAAM;;;EAgBhB;AAYM,kCAPI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,kBAC/D,OAAO,mBACG,GAAG,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yFA5KtB,WAGX;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6NC;uBAzDa,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;sCAOb,sBAAsB"}

package/src/core/utils.js

@@ -1,20 +1,24 @@
-// @ts-check
-import { E, Far } from '@endo/far';
+import { Stable, Stake } from '@agoric/internal/src/tokens.js';
 import { WalletName } from '@agoric/internal';
+import { E, Far } from '@endo/far';
 import { makeAtomicProvider } from '@agoric/store/src/stores/store-utils.js';
 import { makeScalarBigMapStore, makeScalarMapStore } from '@agoric/vat-data';
 import { keyEQ } from '@agoric/store';
 import { makeNameHubKit } from '../nameHub.js';
-import { Stable, Stake } from '../tokens.js';
 import { makeLogHooks, makePromiseSpace } from './promise-space.js';
 
+import './types-ambient.js';
+
 const { entries, fromEntries, keys } = Object;
 const { Fail, quote: q } = assert;
 
 /**
- * We reserve these keys in name hubs.
+ * Used in bootstrap to reserve names in the agoricNames namespace before any
+ * other proposals.
  *
- * @type {{ [P in keyof WellKnownName]: { [P2 in WellKnownName[P]]: string } }}
+ * @type {{
+ *   [P in keyof WellKnownName]: { [P2 in WellKnownName[P]]: string };
+ * }}
  */
 export const agoricNamesReserved = harden({
   issuer: {
@@ -52,6 +56,9 @@ export const agoricNamesReserved = harden({
     psm: 'Parity Stability Module',
     econCommitteeCharter: 'Charter for Econ Governance questions',
     priceAggregator: 'simple price aggregator',
+    scaledPriceAuthority: 'scaled price authority',
+    stakeAtom: 'example ATOM staking contract',
+    stakeBld: 'example BLD staking contract',
   },
   instance: {
     economicCommittee: 'Economic Committee',
@@ -65,6 +72,8 @@ export const agoricNamesReserved = harden({
     econCommitteeCharter: 'Charter for Econ Governance questions',
     provisionPool: 'Account Provision Pool',
     walletFactory: 'Smart Wallet Factory',
+    stakeAtom: 'example ATOM staking contract',
+    stakeBld: 'example BLD staking contract',
   },
   oracleBrand: {
     USD: 'US Dollar',
@@ -74,7 +83,7 @@ export const agoricNamesReserved = harden({
   },
 });
 
-/** @type { FeeIssuerConfig } */
+/** @type {FeeIssuerConfig} */
 export const feeIssuerConfig = {
   name: Stable.symbol,
   assetKind: Stable.assetKind,
@@ -85,7 +94,7 @@ export const feeIssuerConfig = {
  * Wire up a remote between the comms vat and vattp.
  *
  * @param {string} addr
- * @param {{ vats: { vattp: VattpVat, comms: CommsVatRoot }}} powers
+ * @param {{ vats: { vattp: VattpVat; comms: CommsVatRoot } }} powers
  */
 export const addRemote = async (addr, { vats: { comms, vattp } }) => {
   const { transmitter, setReceiver } = await E(vattp).addRemote(addr);
@@ -94,17 +103,19 @@ export const addRemote = async (addr, { vats: { comms, vattp } }) => {
 harden(addRemote);
 
 /**
- * @param {Array<(...args) => Record<string, unknown>>} builders
- * @param  {...unknown} args
+ * @param {((...args) => Record<string, unknown>)[]} builders
+ * @param {...unknown} args
  * @returns {Record<string, unknown>}
  */
 export const callProperties = (builders, ...args) =>
   fromEntries(builders.map(fn => entries(fn(...args))).flat());
 
 /**
- * Attenuate `specimen` to only allow acccess to properties specified in `template`
+ * Attenuate `specimen` to only allow acccess to properties specified in
+ * `template`
  *
- * @param {true | string | Record<string, *>} template true or vat name string or recursive object
+ * @param {true | string | Record<string, any>} template true or vat name string
+ *   or recursive object
  * @param {unknown} specimen
  * @param {string[]} [path]
  */
@@ -143,7 +154,8 @@ export const extract = (template, specimen, path = []) => {
 harden(extract);
 
 /**
- * @param {true | string | Record<string, *>} permit the permit supplied by the manifest
+ * @param {true | string | Record<string, any>} permit the permit supplied by
+ *   the manifest
  * @param {unknown} allPowers the powers to attenuate
  */
 export const extractPowers = (permit, allPowers) => {
@@ -164,7 +176,7 @@ harden(extractPowers);
  * @param {unknown} opts.allPowers
  * @param {Record<string, unknown>} opts.behaviors
  * @param {Record<string, Record<string, unknown>>} opts.manifest
- * @param { (name: string, permit: Record<string, unknown>) => unknown} opts.makeConfig
+ * @param {(name: string, permit: Record<string, unknown>) => unknown} opts.makeConfig
  */
 export const runModuleBehaviors = ({
   allPowers,
@@ -173,20 +185,20 @@ export const runModuleBehaviors = ({
   makeConfig,
 }) => {
   return Promise.all(
-    entries(manifest).map(([name, permit]) =>
-      Promise.resolve().then(() => {
-        const behavior = behaviors[name];
-        assert(behavior, `${name} not in ${Object.keys(behaviors).join(',')}`);
-        assert.typeof(
-          behavior,
-          'function',
-          `behaviors[${name}] is not a function; got ${behavior}`,
+    entries(manifest).map(async ([name, permit]) => {
+      await null;
+      const behavior = behaviors[name];
+      if (typeof behavior !== 'function') {
+        const behaviorKeys = Reflect.ownKeys(behaviors).map(key =>
+          typeof key === 'string' ? JSON.stringify(key) : String(key),
         );
-        const powers = extractPowers(permit, allPowers);
-        const config = harden(makeConfig(name, permit));
-        return behavior.call(behaviors, powers, config);
-      }),
-    ),
+        const keysStr = `[${behaviorKeys.join(', ')}]`;
+        throw Fail`${q(name)} is not a function in ${keysStr}: ${behavior}`;
+      }
+      const powers = extractPowers(permit, allPowers);
+      const config = harden(makeConfig(name, permit));
+      return Reflect.apply(behavior, behaviors, [powers, config]);
+    }),
   );
 };
 harden(runModuleBehaviors);
@@ -194,8 +206,7 @@ harden(runModuleBehaviors);
 const noop = harden(() => {});
 
 /**
- *
- * @param {ERef<import('../types').NameAdmin>} nameAdmin
+ * @param {ERef<import('../types.js').NameAdmin>} nameAdmin
  * @param {typeof console.log} [log]
  */
 export const makePromiseSpaceForNameHub = (nameAdmin, log = noop) => {
@@ -223,7 +234,7 @@ export const makePromiseSpaceForNameHub = (nameAdmin, log = noop) => {
 };
 
 /**
- * @param {ERef<import('../types').NameAdmin>} parentAdmin
+ * @param {ERef<import('../types.js').NameAdmin>} parentAdmin
  * @param {typeof console.log} [log]
  * @param {string[]} [kinds]
  */
@@ -241,7 +252,7 @@ export const makeWellKnownSpaces = async (
     }),
   );
   const spaces = Object.fromEntries(spaceEntries);
-  const typedSpaces = /** @type { WellKnownSpaces } */ (
+  const typedSpaces = /** @type {WellKnownSpaces} */ (
     /** @type {any} */ (spaces)
   );
   return typedSpaces;
@@ -249,23 +260,20 @@ export const makeWellKnownSpaces = async (
 
 /**
  * Make the well-known agoricNames namespace so that we can
- * E(home.agoricNames).lookup('issuer', 'IST') and likewise
- * for brand, installation, instance, etc.
- *
- * @param {typeof console.log} [log]
- * @param {Record<string, Record<string, unknown>>} reserved a property
- *   for each of issuer, brand, etc. with a value whose keys are names
- *   to reserve.
- *
- * For static typing and integrating with the bootstrap permit system,
- * return { produce, consume } spaces rather than NameAdmins.
+ * E(home.agoricNames).lookup('issuer', 'IST') and likewise for brand,
+ * installation, instance, etc.
  *
  * @deprecated use vat-agoricNames, makeWellKnownSpaces
+ * @param {typeof console.log} [log]
+ * @param {Record<string, Record<string, unknown>>} reserved a property for each
+ *   of issuer, brand, etc. with a value whose keys are names to reserve.
  *
+ *   For static typing and integrating with the bootstrap permit system, return {
+ *   produce, consume } spaces rather than NameAdmins.
  * @returns {Promise<{
- *   agoricNames: import('../types.js').NameHub,
- *   agoricNamesAdmin: import('../types.js').NameAdmin,
- *   spaces: WellKnownSpaces,
+ *   agoricNames: import('../types.js').NameHub;
+ *   agoricNamesAdmin: import('../types.js').NameAdmin;
+ *   spaces: WellKnownSpaces;
  * }>}
  */
 export const makeAgoricNamesAccess = async (
@@ -280,7 +288,7 @@ export const makeAgoricNamesAccess = async (
     Object.keys(reserved),
   );
 
-  const typedSpaces = /** @type { WellKnownSpaces } */ (
+  const typedSpaces = /** @type {WellKnownSpaces} */ (
     /** @type {any} */ (spaces)
   );
   return {
@@ -291,15 +299,14 @@ export const makeAgoricNamesAccess = async (
 };
 
 /**
- * @param {string} address
- *
  * @deprecated use nameAdmin.provideChild() instead
+ * @param {string} address
  */
 export const makeMyAddressNameAdminKit = address => {
   // Create a name hub for this address.
   const { nameHub, nameAdmin: rawMyAddressNameAdmin } = makeNameHubKit();
 
-  /** @type {import('../types').MyAddressNameAdmin} */
+  /** @type {import('../types.js').MyAddressNameAdmin} */
   const myAddressNameAdmin = Far('myAddressNameAdmin', {
     ...rawMyAddressNameAdmin,
     getMyAddress: () => address,
@@ -311,14 +318,15 @@ export const makeMyAddressNameAdminKit = address => {
   return { nameHub, myAddressNameAdmin };
 };
 
+/** @typedef {MapStore<string, CreateVatResults>} VatStore */
+
 /**
  * @param {ERef<ReturnType<Awaited<VatAdminVat>['createVatAdminService']>>} svc
  * @param {unknown} criticalVatKey
  * @param {(...args: any) => void} [log]
  * @param {string} [label]
- *
- * @typedef {import('@agoric/swingset-vat').CreateVatResults} CreateVatResults as from createVatByName
- * @typedef {MapStore<string, CreateVatResults>} VatStore
+ * @import {CreateVatResults} from '@agoric/swingset-vat'
+ *   as from createVatByName
  */
 export const makeVatSpace = (
   svc,

package/src/crc.d.ts

@@ -18,13 +18,9 @@ export class CRC {
     crcShift: number;
     shiftedXorIn: number;
     table: Int32Array;
-    /**
-     * @param {Data} data
-     */
+    /** @param {Data} data */
     calculate(data: Data): number;
-    /**
-     * @param {Data} data
-     */
+    /** @param {Data} data */
     calculateNoTable(data: Data): number;
     genTable(): Int32Array;
 }

package/src/crc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crc.d.ts","sourceRoot":"","sources":["crc.js"],"names":[],"mappings":"AAuDA;IACE;;;;;;OAMG;IACH,mBANW,MAAM,QACN,MAAM,SACN,MAAM,UACN,MAAM,WACN,OAAO,EA8BjB;IA3BC,cAAkB;IAClB,aAAgB;IAChB,cAAkB;IAClB,uBAA0C;IAC1C,eAAoB;IACpB,iBAAsB;IACtB,gBAAoC;IACpC,aAAyC;IACzC,iBAAmD;IACnD,qBAA+C;IAG/C,kBAAkB;IAiBpB;;OAEG;IACH,gBAFW,IAAI,UAwBd;IAED;;OAEG;IACH,uBAFW,IAAI,UAmBd;IAED,uBAqBC;CACF;AAED,uBAAwD;AACxD,uBAAwD;AACxD,uBAAwD;AACxD,wBAA+D;AAC/D,wBAA+D;AAC/D,wBAAsE;AACtE,wBAA2E;AAC3E,yBAA4E;;;;;;;;;;;mBAjK/D,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW"}
+{"version":3,"file":"crc.d.ts","sourceRoot":"","sources":["crc.js"],"names":[],"mappings":"AAkDA;IACE;;;;;;OAMG;IACH,mBANW,MAAM,QACN,MAAM,SACN,MAAM,UACN,MAAM,WACN,OAAO,EA4BjB;IAzBC,cAAkB;IAClB,aAAgB;IAChB,cAAkB;IAClB,uBAA0C;IAC1C,eAAoB;IACpB,iBAAsB;IACtB,gBAAoC;IACpC,aAAyC;IACzC,iBAAmD;IACnD,qBAA+C;IAG/C,kBAAkB;IAepB,yBAAyB;IACzB,gBADY,IAAI,UAuBf;IAED,yBAAyB;IACzB,uBADY,IAAI,UAkBf;IAED,uBAqBC;CACF;AAED,uBAAwD;AACxD,uBAAwD;AACxD,uBAAwD;AACxD,wBAA+D;AAC/D,wBAA+D;AAC/D,wBAAsE;AACtE,wBAA2E;AAC3E,yBAA4E;;;;;;;;;;;mBAxJ9D,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW"}

package/src/crc.js

@@ -6,18 +6,13 @@
  * Forked from npm polycrc@1.1.0 for module system compatibility, then trimmed
  * down to a version that assumes TypedArrays are universal.
  */
-// @ts-check
 /* eslint-disable no-bitwise */
 
-/**
- * @typedef {string | number | Uint8Array | ArrayBuffer} Data
- */
+/** @typedef {string | number | Uint8Array | ArrayBuffer} Data */
 
 const encoder = new TextEncoder();
 
-/**
- * @param {Data} data
- */
+/** @param {Data} data */
 function convert(data) {
   if (typeof data === 'number') {
     const bytes = [];
@@ -77,9 +72,7 @@ export class CRC {
     this.table = table;
 
     if (this.width === 8 && !this.xorIn && !this.xorOut && !this.reflect) {
-      /**
-       * @param {Data} data
-       */
+      /** @param {Data} data */
       this.calculate = function calculate(data) {
         const buffer = convert(data);
         let crc = 0;
@@ -91,9 +84,7 @@ export class CRC {
     }
   }
 
-  /**
-   * @param {Data} data
-   */
+  /** @param {Data} data */
   calculate(data) {
     const buffer = convert(data);
     let crc;
@@ -118,9 +109,7 @@ export class CRC {
     return crc >>> 0;
   }
 
-  /**
-   * @param {Data} data
-   */
+  /** @param {Data} data */
   calculateNoTable(data) {
     const buffer = convert(data);
     let crc = this.xorIn;

package/src/ibc.d.ts

@@ -1,37 +1,32 @@
-/**
- * @typedef {import('./types.js').BridgeHandler} BridgeHandler
- */
-/**
- * @typedef {string} IBCPortID
- * @typedef {string} IBCChannelID
- * @typedef {string} IBCConnectionID
- */
-/**
- * @typedef {object} IBCPacket
- * @property {Bytes} [data]
- * @property {IBCChannelID} source_channel
- * @property {IBCPortID} source_port
- * @property {IBCChannelID} destination_channel
- * @property {IBCPortID} destination_port
- */
-/**
- * Create a handler for the IBC protocol, both from the network
- * and from the bridge.
- *
- * @param {typeof import('@endo/far').E} E
- * @param {(method: string, params: any) => Promise<any>} rawCallIBCDevice
- * @returns {ProtocolHandler & BridgeHandler} Protocol/Bridge handler
- */
-export function makeIBCProtocolHandler(E: typeof import('@endo/far').E, rawCallIBCDevice: (method: string, params: any) => Promise<any>): ProtocolHandler & BridgeHandler;
-export type BridgeHandler = import('./types.js').BridgeHandler;
-export type IBCPortID = string;
-export type IBCChannelID = string;
-export type IBCConnectionID = string;
-export type IBCPacket = {
-    data?: string | undefined;
-    source_channel: IBCChannelID;
-    source_port: IBCPortID;
-    destination_channel: IBCChannelID;
-    destination_port: IBCPortID;
+export function prepareIBCConnectionHandler(zone: Zone): any;
+export function prepareIBCProtocol(zone: Zone, powers: VowTools): (ibcdev: {
+    downcall: (method: string, args: object) => Promise<any>;
+}) => {
+    protocolHandler: ProtocolHandler;
+    bridgeHandler: BridgeHandler;
 };
+export function prepareCallbacks(zone: Zone): (dibcBridgeManager: ScopedBridgeManager<"dibc">) => import("@endo/exo").Guarded<{
+    /**
+     * @param {string} method
+     * @param {any} obj
+     */
+    downcall(method: string, obj: any): Promise<any>;
+}>;
+export type OnConnectP = VowKit<AttemptDescription>;
+export type Outbound = Omit<ConnectingInfo, "counterparty" | "channelID" | "counterpartyVersion"> & {
+    localAddr: Endpoint;
+    onConnectP: OnConnectP;
+    counterparty: {
+        port_id: string;
+    };
+};
+import type { Zone } from '@agoric/base-zone';
+import type { VowTools } from '@agoric/vow';
+import type { ProtocolHandler } from '@agoric/network';
+import type { BridgeHandler } from './types.js';
+import type { ScopedBridgeManager } from './types.js';
+import type { AttemptDescription } from '@agoric/network';
+import type { VowKit } from '@agoric/vow';
+import type { ConnectingInfo } from './types.js';
+import type { Endpoint } from '@agoric/network';
 //# sourceMappingURL=ibc.d.ts.map

package/src/ibc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ibc.d.ts","sourceRoot":"","sources":["ibc.js"],"names":[],"mappings":"AAuBA;;GAEG;AAEH;;;;GAIG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,0CAJW,cAAc,WAAW,EAAE,CAAC,6BACnB,MAAM,UAAU,GAAG,KAAK,QAAQ,GAAG,CAAC,GAC3C,eAAe,GAAG,aAAa,CAwhB3C;4BAhjBY,OAAO,YAAY,EAAE,aAAa;wBAIlC,MAAM;2BACN,MAAM;8BACN,MAAM;;;oBAML,YAAY;iBACZ,SAAS;yBACT,YAAY;sBACZ,SAAS"}
+{"version":3,"file":"ibc.d.ts","sourceRoot":"","sources":["ibc.js"],"names":[],"mappings":"AAmDO,kDAHI,IAAI,GACF,GAAG,CAmHf;AAMM,yCAHI,IAAI,UACJ,QAAQ;cASH,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC;;qBAOpC,eAAe;mBACjB,aAAa;EA+mBpC;AAIM,uCADK,IAAI;IAQV;;;OAGG;qBAFQ,MAAM,OACN,GAAG;GAYnB;yBAhyBa,OAAO,kBAAkB,CAAC;uBAG3B,IAAI,CAChB,cAAkB,EAClB,cAAkB,GAAG,WAAW,GAAG,qBAAqB,CACrD,GAAG;IACN,SAAa,EAAE,QAAQ,CAAC;IACxB,UAAc,EAAE,UAAU,CAAC;IAC3B,YAAgB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;0BAdmB,mBAAmB;8BAC0B,aAAa;qCAH+B,iBAAiB;mCACyE,YAAY;yCAAZ,YAAY;wCAZjL,iBAAiB;4BAcc,aAAa;oCAFyH,YAAY;8BADtG,iBAAiB"}