@agoric/vats 0.15.2-dev-ecf2d8e.0 → 0.15.2-other-dev-70beeb7.0

package/src/types.d.ts

@@ -1,9 +1,5 @@
-/* eslint-disable no-use-before-define */
-
-export type Board = ReturnType<
-  ReturnType<typeof import('./lib-board.js').prepareBoardKit>
->['board'];
-
+export type EOnly<T> = import('@endo/far').EOnly<T>;
+export type Board = ReturnType<ReturnType<typeof import('./lib-board.js').prepareBoardKit>>['board'];
 /**
  * read-only access to a node in a name hierarchy
  *
@@ -12,98 +8,121 @@ export type Board = ReturnType<
  * trips for the contents of even the simplest nameHub.
  */
 export type NameHub = {
-  has: (key: string) => boolean;
-  /**
-   * Look up a path of keys starting from the current NameHub. Wait on any
-   * reserved promises.
-   */
-  lookup: (...path: string[]) => Promise<any>;
-  /** get all the entries available in the current NameHub */
-  entries: (includeReserved?: boolean) => [string, unknown][];
-  /** get all names available in the current NameHub */
-  keys: () => string[];
-  /** get all values available in the current NameHub */
-  values: () => unknown[];
+    has: (key: string) => boolean;
+    /**
+     * Look up a
+     * path of keys starting from the current NameHub.  Wait on any reserved
+     * promises.
+     */
+    lookup: (...path: Array<string>) => Promise<any>;
+    /**
+     * get all the entries
+     * available in the current NameHub
+     */
+    entries: (includeReserved?: boolean) => [string, unknown][];
+    /**
+     * get all names available in the
+     * current NameHub
+     */
+    keys: () => string[];
+    /**
+     * get all values available in the
+     * current NameHub
+     */
+    values: () => unknown[];
 };
-
-/** write access to a node in a name hierarchy */
+/**
+ * write access to a node in a name hierarchy
+ */
 export type NameAdmin = {
-  provideChild: (key: string, reserved?: string[]) => Promise<NameHubKit>;
-  /**
-   * Mark a key as reserved; will return a promise that is fulfilled when the
-   * key is updated (or rejected when deleted). If the key was already set it
-   * does nothing.
-   */
-  reserve: (key: string) => Promise<void>;
-  /**
-   * Update if not already updated. Return existing value, or newValue if not
-   * existing.
-   */
-  default: <T>(key: string, newValue: T, newAdmin?: NameAdmin) => T;
-  /** Update only if already initialized. Reject if not. */
-  set: (key: string, newValue: unknown, newAdmin?: NameAdmin) => void;
-  /**
-   * Fulfill an outstanding reserved promise (if any) to the newValue and set
-   * the key to the newValue. If newAdmin is provided, set that to return via
-   * lookupAdmin.
-   */
-  update: (key: string, newValue: unknown, newAdmin?: NameAdmin) => void;
-  /**
-   * Look up the `newAdmin` from the path of keys starting from the current
-   * NameAdmin. Wait on any reserved promises.
-   */
-  lookupAdmin: (...path: string[]) => Promise<NameAdmin>;
-  /** Delete a value and reject an outstanding reserved promise (if any). */
-  delete: (key: string) => void;
-  /** get the NameHub corresponding to the current NameAdmin */
-  readonly: () => NameHub;
-  onUpdate: (fn: undefined | NameHubUpdateHandler) => void;
+    provideChild: (key: string, reserved?: string[]) => Promise<NameHubKit>;
+    /**
+     * Mark a key as reserved; will
+     * return a promise that is fulfilled when the key is updated (or rejected when
+     * deleted). If the key was already set it does nothing.
+     */
+    reserve: (key: string) => Promise<void>;
+    /**
+     * Update if not already updated.  Return
+     * existing value, or newValue if not existing.
+     */
+    default: <T>(key: string, newValue: T, newAdmin?: NameAdmin) => T;
+    /**
+     * Update only if already initialized. Reject if not.
+     */
+    set: (key: string, newValue: unknown, newAdmin?: NameAdmin) => void;
+    /**
+     * Fulfill an outstanding reserved promise (if any) to the newValue and
+     * set the key to the newValue.  If newAdmin is provided, set that to return via
+     * lookupAdmin.
+     */
+    update: (key: string, newValue: unknown, newAdmin?: NameAdmin) => void;
+    /**
+     * Look up the
+     * `newAdmin` from the path of keys starting from the current NameAdmin.  Wait
+     * on any reserved promises.
+     */
+    lookupAdmin: (...path: Array<string>) => Promise<NameAdmin>;
+    /**
+     * Delete a value and reject an
+     * outstanding reserved promise (if any).
+     */
+    delete: (key: string) => void;
+    /**
+     * get the NameHub corresponding to the
+     * current NameAdmin
+     */
+    readonly: () => NameHub;
+    onUpdate: (fn: undefined | (NameHubUpdateHandler)) => void;
 };
-
 export type NameHubUpdateHandler = {
-  write: (entries: [string, unknown][]) => void;
+    write: (entries: [string, unknown][]) => void;
 };
-
-/** a node in a name hierarchy */
+/**
+ * a node in a name hierarchy
+ */
 export type NameHubKit = {
-  /** read access */
-  nameHub: NameHub;
-  /** write access */
-  nameAdmin: NameAdmin;
+    /**
+     * read access
+     */
+    nameHub: NameHub;
+    /**
+     * write access
+     */
+    nameAdmin: NameAdmin;
 };
-
 export type MyAddressNameAdmin = NameAdmin & {
-  getMyAddress(): string;
+    getMyAddress(): string;
 };
 export type NamesByAddressAdmin = NameAdmin & {
-  provideChild(
-    addr: string,
-    reserved?: string[],
-  ): Promise<{
-    nameHub: NameHub;
-    nameAdmin: MyAddressNameAdmin;
-  }>;
-  lookupAdmin(addr: string): Promise<MyAddressNameAdmin>;
+    provideChild(addr: string, reserved?: string[]): Promise<{
+        nameHub: NameHub;
+        nameAdmin: MyAddressNameAdmin;
+    }>;
+    lookupAdmin(addr: string): Promise<MyAddressNameAdmin>;
 };
-
-/** An object that can receive messages from the bridge device */
+/**
+ * An object that can receive messages from the bridge device
+ */
 export type BridgeHandler = {
-  /** Handle an inbound message */
-  fromBridge: (obj: any) => Promise<void>;
+    /**
+     * Handle an inbound message
+     */
+    fromBridge: (obj: any) => Promise<void>;
 };
-
-/** An object which handles messages for a specific bridge */
+/**
+ * An object which handles messages for a specific bridge
+ */
 export type ScopedBridgeManager = {
-  toBridge: (obj: any) => Promise<any>;
-  fromBridge: (obj: any) => Promise<void>;
-  initHandler: (handler: ERef<BridgeHandler>) => void;
-  setHandler: (handler: ERef<BridgeHandler>) => void;
+    toBridge: (obj: any) => Promise<any>;
+    fromBridge: (obj: any) => Promise<void>;
+    initHandler: (handler: ERef<BridgeHandler>) => void;
+    setHandler: (handler: ERef<BridgeHandler>) => void;
 };
-
-/** The object to manage this bridge */
+/**
+ * The object to manage this bridge
+ */
 export type BridgeManager = {
-  register: (
-    bridgeId: string,
-    handler?: ERef<BridgeHandler | undefined>,
-  ) => ScopedBridgeManager;
+    register: (bridgeId: string, handler?: ERef<BridgeHandler | undefined>) => ScopedBridgeManager;
 };
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.js"],"names":[],"mappings":"uBAMa,OAAO,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;oBAI5B,WAAW,WAAW,cAAc,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC;;;;;;;;;eAUzE,MAAM,KAAK,OAAO;;;;;;sBACd,MAAM,MAAM,CAAC,KAAK,QAAQ,GAAG,CAAC;;;;;gCAGrB,OAAO,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;;;;;UAElD,MAAM,MAAM,EAAE;;;;;YAEd,MAAM,OAAO,EAAE;;;;;;wBAOT,MAAM,aAAa,MAAM,EAAE,KAAK,QAAQ,UAAU,CAAC;;;;;;mBACnD,MAAM,KAAK,QAAQ,IAAI,CAAC;;;;;sBAGpB,MAAM,0BAA0B,SAAS;;;;eAIvD,MAAM,YAAY,OAAO,aAAa,SAAS,KAAK,IAAI;;;;;;kBAGxD,MAAM,YAAY,OAAO,aAAa,SAAS,KAAK,IAAI;;;;;;2BAI1C,MAAM,MAAM,CAAC,KAAK,QAAQ,SAAS,CAAC;;;;;kBAGxC,MAAM,KAAK,IAAI;;;;;cAErB,MAAM,OAAO;mBAER,SAAS,GAAG,CAAC,oBAAoB,CAAC,KAAK,IAAI;;;qBAE9B,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,IAAI;;;;;;;;;aAK9C,OAAO;;;;eACP,SAAS;;iCAIV,SAAS,GAAG;IAAE,YAAY,IAAI,MAAM,CAAA;CAAE;;uBAI3B,MAAM,aAAa,MAAM,EAAE,GAAG,QAAQ;QAC7D,OAAa,EAAE,OAAO,CAAC;QACvB,SAAe,EAAE,kBAAkB,CAAC;KAC/B,CAAC;sBACgB,MAAM,GAAG,QAAQ,kBAAkB,CAAC;;;;;;;;;sBAMvC,GAAG,KAAK,QAAQ,IAAI,CAAC;;;;;;oBAKrB,GAAG,KAAK,QAAQ,GAAG,CAAC;sBACpB,GAAG,KAAK,QAAQ,IAAI,CAAC;2BACjB,KAAK,aAAa,CAAC,KAAK,IAAI;0BAC5B,KAAK,aAAa,CAAC,KAAK,IAAI;;;;;;yBAK3B,MAAM,YAAY,KAAK,aAAa,GAAG,SAAS,CAAC,KAAK,mBAAmB"}

package/src/types.js

@@ -1,2 +1,98 @@
-// Empty JS file to correspond with types.d.ts
+// @ts-check
+
 export {};
+
+/**
+ * @template T
+ * @typedef {import('@endo/far').EOnly<T>} EOnly
+ */
+
+/**
+ * @typedef {ReturnType<ReturnType<typeof import('./lib-board.js').prepareBoardKit>>['board']} Board
+ */
+
+/**
+ * @typedef {object} NameHub read-only access to a node in a name hierarchy
+ *
+ * NOTE: We need to return arrays, not iterables, because even if marshal could
+ * allow passing a remote iterable, there would be an inordinate number of round
+ * trips for the contents of even the simplest nameHub.
+ *
+ * @property {(key: string) => boolean} has
+ * @property {(...path: Array<string>) => Promise<any>} lookup Look up a
+ * path of keys starting from the current NameHub.  Wait on any reserved
+ * promises.
+ * @property {(includeReserved?: boolean) => [string, unknown][]} entries get all the entries
+ * available in the current NameHub
+ * @property {() => string[]} keys get all names available in the
+ * current NameHub
+ * @property {() => unknown[]} values get all values available in the
+ * current NameHub
+ */
+
+/**
+ * @typedef {object} NameAdmin write access to a node in a name hierarchy
+ *
+ * @property {(key: string, reserved?: string[]) => Promise<NameHubKit>} provideChild
+ * @property {(key: string) => Promise<void>} reserve Mark a key as reserved; will
+ * return a promise that is fulfilled when the key is updated (or rejected when
+ * deleted). If the key was already set it does nothing.
+ * @property {<T>( key: string, newValue: T, newAdmin?: NameAdmin) =>
+ *   T } default Update if not already updated.  Return
+ *   existing value, or newValue if not existing.
+ * @property {(
+ *   key: string, newValue: unknown, newAdmin?: NameAdmin) => void
+ * } set Update only if already initialized. Reject if not.
+ * @property {(
+ *   key: string, newValue: unknown, newAdmin?: NameAdmin) => void
+ * } update Fulfill an outstanding reserved promise (if any) to the newValue and
+ * set the key to the newValue.  If newAdmin is provided, set that to return via
+ * lookupAdmin.
+ * @property {(...path: Array<string>) => Promise<NameAdmin>} lookupAdmin Look up the
+ * `newAdmin` from the path of keys starting from the current NameAdmin.  Wait
+ * on any reserved promises.
+ * @property {(key: string) => void} delete Delete a value and reject an
+ * outstanding reserved promise (if any).
+ * @property {() => NameHub} readonly get the NameHub corresponding to the
+ * current NameAdmin
+ * @property {(fn: undefined | (NameHubUpdateHandler)) => void} onUpdate
+ *
+ * @typedef {{ write: (entries: [string, unknown][]) => void }} NameHubUpdateHandler
+ */
+
+/**
+ * @typedef {object} NameHubKit a node in a name hierarchy
+ * @property {NameHub} nameHub read access
+ * @property {NameAdmin} nameAdmin write access
+ */
+
+/**
+ * @typedef {NameAdmin & { getMyAddress(): string }} MyAddressNameAdmin
+ */
+/**
+ * @typedef {NameAdmin & {
+ *   provideChild(addr: string, reserved?: string[]): Promise<{
+ *     nameHub: NameHub,
+ *     nameAdmin: MyAddressNameAdmin,
+ *   }>,
+ *   lookupAdmin(addr: string): Promise<MyAddressNameAdmin>,
+ * }} NamesByAddressAdmin
+ */
+
+/**
+ * @typedef {object} BridgeHandler An object that can receive messages from the bridge device
+ * @property {(obj: any) => Promise<void>} fromBridge Handle an inbound message
+ */
+
+/**
+ * @typedef {object} ScopedBridgeManager An object which handles messages for a specific bridge
+ * @property {(obj: any) => Promise<any>} toBridge
+ * @property {(obj: any) => Promise<void>} fromBridge
+ * @property {(handler: ERef<BridgeHandler>) => void} initHandler
+ * @property {(handler: ERef<BridgeHandler>) => void} setHandler
+ */
+
+/**
+ * @typedef {object} BridgeManager The object to manage this bridge
+ * @property {(bridgeId: string, handler?: ERef<BridgeHandler | undefined>) => ScopedBridgeManager} register
+ */

package/src/vat-agoricNames.d.ts

@@ -1,4 +1,4 @@
-export function buildRootObject(_vatPowers: unknown, _vatParameters: unknown, baggage: any): {
+export function buildRootObject(_vatPowers: unknown, _vatParameters: unknown, baggage: MapStore<string, unknown>): {
     getNameHub: () => import("./types.js").NameHub;
     getNameHubKit: () => import("./types.js").NameHubKit;
     publishNameHubs: (nameStorage: ERef<StorageNode>, vatBoard: ERef<BoardVat>, kinds: string[]) => Promise<void>;

package/src/vat-agoricNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vat-agoricNames.d.ts","sourceRoot":"","sources":["vat-agoricNames.js"],"names":[],"mappings":"AA2CO,4CAJI,OAAO,kBACP,OAAO;;;mCAaL,KAAK,WAAW,CAAC,YACjB,KAAK,QAAQ,CAAC,SACd,MAAM,EAAE;IAoBjB;;;;;OAKG;iCAFQ,MAAM,eACN,WAAW;;;;mCA1Bb,KAAK,WAAW,CAAC,YACjB,KAAK,QAAQ,CAAC,SACd,MAAM,EAAE;IAoBjB;;;;;OAKG;iCAFQ,MAAM,eACN,WAAW;GAOzB"}
+{"version":3,"file":"vat-agoricNames.d.ts","sourceRoot":"","sources":["vat-agoricNames.js"],"names":[],"mappings":"AA2CO,4CAJI,OAAO,kBACP,OAAO;;;mCAaL,KAAK,WAAW,CAAC,YACjB,KAAK,QAAQ,CAAC,SACd,MAAM,EAAE;IAqBjB;;;;;OAKG;iCAFQ,MAAM,eACN,WAAW;;;;mCA3Bb,KAAK,WAAW,CAAC,YACjB,KAAK,QAAQ,CAAC,SACd,MAAM,EAAE;IAqBjB;;;;;OAKG;iCAFQ,MAAM,eACN,WAAW;GAOzB"}

package/src/vat-agoricNames.js

@@ -62,8 +62,9 @@ export const buildRootObject = (_vatPowers, _vatParameters, baggage) => {
         const kindAdmin = await E(agoricNamesAdmin).lookupAdmin(kind);
 
         const kindNode = await E(nameStorage).makeChildNode(kind);
-        const recorderKit =
-          await E(vatBoard).makePublishingRecorderKit(kindNode);
+        const recorderKit = await E(vatBoard).makePublishingRecorderKit(
+          kindNode,
+        );
         kindAdmin.onUpdate(recorderKit.recorder);
       }),
     );

package/src/vat-bank.d.ts

@@ -1,10 +1,10 @@
 export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
     /**
-     * @param {ERef<import('./types.js').ScopedBridgeManager | undefined>} [bankBridgeManagerP]
-     *   a bridge manager for the "remote" bank (such as on cosmos-sdk). If not
-     *   supplied (such as on sim-chain), we just use local purses.
-     * @param {ERef<{ update: import('./types.js').NameAdmin['update'] }>} [nameAdminP]
-     *   update facet of a NameAdmin; see addAsset() for detail.
+     * @param {ERef<import('./types.js').ScopedBridgeManager | undefined>} [bankBridgeManagerP] a bridge
+     * manager for the "remote" bank (such as on cosmos-sdk).  If not supplied
+     * (such as on sim-chain), we just use local purses.
+     * @param {ERef<{ update: import('./types.js').NameAdmin['update'] }>} [nameAdminP] update facet of
+     *   a NameAdmin; see addAsset() for detail.
      */
     makeBankManager(bankBridgeManagerP?: ERef<import('./types.js').ScopedBridgeManager | undefined>, nameAdminP?: ERef<{
         update: import('./types.js').NameAdmin['update'];
@@ -18,29 +18,28 @@ export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
         /**
          * @param {string} denom
          * @param {AssetIssuerKit} feeKit
-         * @returns {ERef<import('@endo/far').EOnly<DepositFacet>>}
+         * @returns {import('@endo/far').EOnly<DepositFacet>}
          */
-        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): ERef<import('@endo/far').EOnly<DepositFacet>>;
+        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): import('@endo/far').EOnly<DepositFacet>;
         /**
          * Get the address of named module account.
          *
          * @param {string} moduleName
          * @returns {Promise<string | null>} address of named module account, or
-         *   null if unimplemented (no bankChannel)
+         * null if unimplemented (no bankChannel)
          */
         getModuleAccountAddress(moduleName: string): Promise<string | null>;
         /**
-         * Add an asset to the bank, and publish it to the subscriptions. If
-         * nameAdmin is defined, update with denom to AssetInfo entry.
+         * Add an asset to the bank, and publish it to the subscriptions.
+         * If nameAdmin is defined, update with denom to AssetInfo entry.
          *
-         * Note that AssetInfo has the settled identity of the issuer, not just a
-         * promise for it.
+         * Note that AssetInfo has the settled identity of the issuer,
+         * not just a promise for it.
          *
          * @param {string} denom lower-level denomination string
          * @param {string} issuerName
          * @param {string} proposedName
-         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer
-         *   kit (mint, brand, issuer)
+         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer kit (mint, brand, issuer)
          */
         addAsset(denom: string, issuerName: string, proposedName: string, kit: AssetIssuerKit<AssetKind> & {
             payment?: ERef<Payment<AssetKind>> | undefined;
@@ -62,29 +61,28 @@ export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
         /**
          * @param {string} denom
          * @param {AssetIssuerKit} feeKit
-         * @returns {ERef<import('@endo/far').EOnly<DepositFacet>>}
+         * @returns {import('@endo/far').EOnly<DepositFacet>}
          */
-        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): ERef<import('@endo/far').EOnly<DepositFacet>>;
+        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): import('@endo/far').EOnly<DepositFacet>;
         /**
          * Get the address of named module account.
          *
          * @param {string} moduleName
          * @returns {Promise<string | null>} address of named module account, or
-         *   null if unimplemented (no bankChannel)
+         * null if unimplemented (no bankChannel)
          */
         getModuleAccountAddress(moduleName: string): Promise<string | null>;
         /**
-         * Add an asset to the bank, and publish it to the subscriptions. If
-         * nameAdmin is defined, update with denom to AssetInfo entry.
+         * Add an asset to the bank, and publish it to the subscriptions.
+         * If nameAdmin is defined, update with denom to AssetInfo entry.
          *
-         * Note that AssetInfo has the settled identity of the issuer, not just a
-         * promise for it.
+         * Note that AssetInfo has the settled identity of the issuer,
+         * not just a promise for it.
          *
          * @param {string} denom lower-level denomination string
          * @param {string} issuerName
          * @param {string} proposedName
-         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer
-         *   kit (mint, brand, issuer)
+         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer kit (mint, brand, issuer)
          */
         addAsset(denom: string, issuerName: string, proposedName: string, kit: AssetIssuerKit<AssetKind> & {
             payment?: ERef<Payment<AssetKind>> | undefined;
@@ -99,11 +97,11 @@ export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
     }>>;
 } & import("@endo/eventual-send").RemotableBrand<{}, {
     /**
-     * @param {ERef<import('./types.js').ScopedBridgeManager | undefined>} [bankBridgeManagerP]
-     *   a bridge manager for the "remote" bank (such as on cosmos-sdk). If not
-     *   supplied (such as on sim-chain), we just use local purses.
-     * @param {ERef<{ update: import('./types.js').NameAdmin['update'] }>} [nameAdminP]
-     *   update facet of a NameAdmin; see addAsset() for detail.
+     * @param {ERef<import('./types.js').ScopedBridgeManager | undefined>} [bankBridgeManagerP] a bridge
+     * manager for the "remote" bank (such as on cosmos-sdk).  If not supplied
+     * (such as on sim-chain), we just use local purses.
+     * @param {ERef<{ update: import('./types.js').NameAdmin['update'] }>} [nameAdminP] update facet of
+     *   a NameAdmin; see addAsset() for detail.
      */
     makeBankManager(bankBridgeManagerP?: ERef<import('./types.js').ScopedBridgeManager | undefined>, nameAdminP?: ERef<{
         update: import('./types.js').NameAdmin['update'];
@@ -117,29 +115,28 @@ export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
         /**
          * @param {string} denom
          * @param {AssetIssuerKit} feeKit
-         * @returns {ERef<import('@endo/far').EOnly<DepositFacet>>}
+         * @returns {import('@endo/far').EOnly<DepositFacet>}
          */
-        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): ERef<import('@endo/far').EOnly<DepositFacet>>;
+        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): import('@endo/far').EOnly<DepositFacet>;
         /**
          * Get the address of named module account.
          *
          * @param {string} moduleName
          * @returns {Promise<string | null>} address of named module account, or
-         *   null if unimplemented (no bankChannel)
+         * null if unimplemented (no bankChannel)
          */
         getModuleAccountAddress(moduleName: string): Promise<string | null>;
         /**
-         * Add an asset to the bank, and publish it to the subscriptions. If
-         * nameAdmin is defined, update with denom to AssetInfo entry.
+         * Add an asset to the bank, and publish it to the subscriptions.
+         * If nameAdmin is defined, update with denom to AssetInfo entry.
          *
-         * Note that AssetInfo has the settled identity of the issuer, not just a
-         * promise for it.
+         * Note that AssetInfo has the settled identity of the issuer,
+         * not just a promise for it.
          *
          * @param {string} denom lower-level denomination string
          * @param {string} issuerName
          * @param {string} proposedName
-         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer
-         *   kit (mint, brand, issuer)
+         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer kit (mint, brand, issuer)
          */
         addAsset(denom: string, issuerName: string, proposedName: string, kit: AssetIssuerKit<AssetKind> & {
             payment?: ERef<Payment<AssetKind>> | undefined;
@@ -161,29 +158,28 @@ export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
         /**
          * @param {string} denom
          * @param {AssetIssuerKit} feeKit
-         * @returns {ERef<import('@endo/far').EOnly<DepositFacet>>}
+         * @returns {import('@endo/far').EOnly<DepositFacet>}
          */
-        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): ERef<import('@endo/far').EOnly<DepositFacet>>;
+        getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): import('@endo/far').EOnly<DepositFacet>;
         /**
          * Get the address of named module account.
          *
          * @param {string} moduleName
          * @returns {Promise<string | null>} address of named module account, or
-         *   null if unimplemented (no bankChannel)
+         * null if unimplemented (no bankChannel)
          */
         getModuleAccountAddress(moduleName: string): Promise<string | null>;
         /**
-         * Add an asset to the bank, and publish it to the subscriptions. If
-         * nameAdmin is defined, update with denom to AssetInfo entry.
+         * Add an asset to the bank, and publish it to the subscriptions.
+         * If nameAdmin is defined, update with denom to AssetInfo entry.
          *
-         * Note that AssetInfo has the settled identity of the issuer, not just a
-         * promise for it.
+         * Note that AssetInfo has the settled identity of the issuer,
+         * not just a promise for it.
          *
          * @param {string} denom lower-level denomination string
          * @param {string} issuerName
          * @param {string} proposedName
-         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer
-         *   kit (mint, brand, issuer)
+         * @param {AssetIssuerKit & { payment?: ERef<Payment> }} kit ERTP issuer kit (mint, brand, issuer)
          */
         addAsset(denom: string, issuerName: string, proposedName: string, kit: AssetIssuerKit<AssetKind> & {
             payment?: ERef<Payment<AssetKind>> | undefined;
@@ -197,7 +193,9 @@ export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
         getBankForAddress(address: string): Promise<Bank>;
     }>>;
 }>;
-/** @typedef {AssetIssuerKit & { denom: string; escrowPurse?: ERef<Purse> }} AssetRecord */
+/**
+ * @typedef {AssetIssuerKit & { denom: string, escrowPurse?: ERef<Purse> }} AssetRecord
+ */
 /**
  * @typedef {object} AssetDescriptor
  * @property {Brand} brand
@@ -207,22 +205,19 @@ export function buildRootObject(_vatPowers: any, _args: any, baggage: any): {
  * @property {string} proposedName
  */
 /**
- * @typedef {AssetDescriptor & {
- *   issuer: Issuer<'nat'>; // settled identity
- *   displayInfo: DisplayInfo;
+ * @typedef { AssetDescriptor & {
+ *   issuer: Issuer<'nat'>, // settled identity
+ *   displayInfo: DisplayInfo,
  * }} AssetInfo
  */
 /**
  * @typedef {object} Bank
- * @property {() => IterableEachTopic<AssetDescriptor>} getAssetSubscription
- *   Returns assets as they are added to the bank
- * @property {(brand: Brand) => Promise<VirtualPurse>} getPurse Find any
- *   existing vpurse (keyed by address and brand) or create a new one.
+ * @property {() => IterableEachTopic<AssetDescriptor>} getAssetSubscription Returns
+ * assets as they are added to the bank
+ * @property {(brand: Brand) => Promise<VirtualPurse>} getPurse Find any existing vpurse
+ * (keyed by address and brand) or create a new one.
  */
-export const BankI: import("@endo/patterns").InterfaceGuard<{
-    getAssetSubscription: import("@endo/patterns").MethodGuard;
-    getPurse: import("@endo/patterns").MethodGuard;
-}>;
+export const BankI: import("@endo/patterns").InterfaceGuard;
 export type VirtualPurseController = import('./virtual-purse').VirtualPurseController;
 export type VirtualPurse = Awaited<ReturnType<ReturnType<typeof prepareVirtualPurse>>>;
 export type BalanceUpdater = {
@@ -251,14 +246,15 @@ export type AssetInfo = AssetDescriptor & {
 };
 export type Bank = {
     /**
-     *   Returns assets as they are added to the bank
+     * Returns
+     * assets as they are added to the bank
      */
     getAssetSubscription: () => IterableEachTopic<AssetDescriptor>;
     /**
-     * Find any
-     * existing vpurse (keyed by address and brand) or create a new one.
+     * Find any existing vpurse
+     * (keyed by address and brand) or create a new one.
      */
     getPurse: (brand: Brand) => Promise<VirtualPurse>;
 };
-import { prepareVirtualPurse } from './virtual-purse.js';
+import { prepareVirtualPurse } from "./virtual-purse.js";
 //# sourceMappingURL=vat-bank.d.ts.map

package/src/vat-bank.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vat-bank.d.ts","sourceRoot":"","sources":["vat-bank.js"],"names":[],"mappings":"AAy0BA;IASI;;;;;;OAMG;yCALQ,KAAK,OAAO,YAAY,EAAE,mBAAmB,GAAG,SAAS,CAAC;gBAG3C,OAAO,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC;;QAhPhE;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,KAAK,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAkB1D;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;;WAYG;wBALQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA4EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;QA7I1B;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,KAAK,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAkB1D;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;;WAYG;wBALQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA4EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;;IA+F5B;;;;;;OAMG;yCALQ,KAAK,OAAO,YAAY,EAAE,mBAAmB,GAAG,SAAS,CAAC;gBAG3C,OAAO,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC;;QAhPhE;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,KAAK,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAkB1D;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;;WAYG;wBALQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA4EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;QA7I1B;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,KAAK,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAkB1D;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;;WAYG;wBALQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA4EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;GA6I/B;AAnhBD,2FAA2F;AAE3F;;;;;;;GAOG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;;GAGG;qCAtWU,OAAO,iBAAiB,EAAE,sBAAsB;2BAEhD,QAAQ,WAAW,WAAW,0BAA0B,CAAC,CAAC,CAAC;;oBAKlD,MAAM,UAAU,MAAM,KAAK,IAAI;;4BAQxC,KACZ,OAAW,YAAY,EAAE,mBAAmB,EAC5C,YAAgB,GAAG,UAAU,CAC1B;;;YA0SU,KAAK,OAAO,CAAC,CAAC,CAAC;WACf,MAAM,CAAC,CAAC;;0BAYR,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;CAAE;;WAI7D,KAAK;YACL,KAAK,MAAM,CAAC;gBACZ,MAAM;WACN,MAAM;kBACN,MAAM;;wBAIP,eAAe,GAAG;IAC9B,MAAU,EAAE,OAAO,KAAK,CAAC,CAAC;IAC1B,WAAe,EAAE,WAAW,CAAC;CAC1B;;;;;0BAKU,MAAM,kBAAkB,eAAe,CAAC;;;;;sBAEhC,KAAK,KAAK,QAAQ,YAAY,CAAC;;oCA/W9C,oBAAoB"}
+{"version":3,"file":"vat-bank.d.ts","sourceRoot":"","sources":["vat-bank.js"],"names":[],"mappings":"AA+zBA;IASI;;;;;;OAMG;yCALQ,KAAK,OAAO,YAAY,EAAE,mBAAmB,GAAG,SAAS,CAAC;gBAG3C,OAAO,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC;;QAnPhE;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC;QAkBpD;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;WAWG;wBAJQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA2EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;QA5I1B;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC;QAkBpD;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;WAWG;wBAJQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA2EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;;IAmG5B;;;;;;OAMG;yCALQ,KAAK,OAAO,YAAY,EAAE,mBAAmB,GAAG,SAAS,CAAC;gBAG3C,OAAO,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC;;QAnPhE;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC;QAkBpD;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;WAWG;wBAJQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA2EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;QA5I1B;;;;WAIG;gCADU,kBAAkB,eAAe,CAAC;QAS/C;;;;WAIG;gDAHQ,MAAM,UACN,cAAc,GACZ,OAAO,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC;QAkBpD;;;;;;WAMG;4CAHQ,MAAM,GACJ,QAAQ,MAAM,GAAG,IAAI,CAAC;QAenC;;;;;;;;;;;WAWG;wBAJQ,MAAM,cACN,MAAM,gBACN,MAAM;;;QA2EjB;;;;;WAKG;mCAFQ,MAAM,GACJ,QAAQ,IAAI,CAAC;;GAmJ/B;AAhhBD;;GAEG;AAEH;;;;;;;GAOG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG;AAEH,4DAGG;qCAtWU,OAAO,iBAAiB,EAAE,sBAAsB;2BAChD,QAAQ,WAAW,WAAW,0BAA0B,CAAC,CAAC,CAAC;;oBAKlD,MAAM,UAAU,MAAM,KAAK,IAAI;;4BAOvC,KAAK,OAAO,YAAY,EAAE,mBAAmB,EAAE,YAAY,GAAG,UAAU,CAAC;;;YA6SzE,KAAK,OAAO,CAAC,CAAC,CAAC;WACf,MAAM,CAAC,CAAC;;0BAaT,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;CAAE;;WAK5D,KAAK;YACL,KAAK,MAAM,CAAC;gBACZ,MAAM;WACN,MAAM;kBACN,MAAM;;wBAIN,eAAe,GAAG;IAC/B,MAAU,EAAE,OAAO,KAAK,CAAC,CAAC;IAC1B,WAAe,EAAE,WAAW,CAAC;CAC1B;;;;;;0BAKU,MAAM,kBAAkB,eAAe,CAAC;;;;;sBAEhC,KAAK,KAAK,QAAQ,YAAY,CAAC"}