@agoric/vats 0.15.2-dev-857e650.0 → 0.15.2-dev-284e2db.0

package/src/lib-board.js

@@ -1,7 +1,6 @@
 // @ts-check
 /**
  * @file lib-board: share objects by way of plain-data ids
- *
  * @see prepareBoardKit()
  */
 
@@ -48,11 +47,11 @@ const BoardKitIKit = {
 //#endregion
 
 /**
- * For a value with a known id in the board, we can use
- * that board id as a slot to preserve identity when marshaling.
+ * For a value with a known id in the board, we can use that board id as a slot
+ * to preserve identity when marshaling.
  *
  * The contents of the string depend on the `prefix` and `crcDigits` options:
- *    \`${prefix}${crc}${seq}\`
+ * `${prefix}${crc}${seq}`
  *
  * For example, 'board0371' for prefix: 'board0', seq: 1, 2 digits crc.
  *
@@ -75,14 +74,11 @@ const calcCrc = (data, crcDigits) => {
 };
 
 /**
+ * @typedef {ReturnType<typeof initDurableBoardState>} BoardState // TODO: use
+ *   Key from @agoric/store when available
  * @see {prepareExoClassKit}
- * @see {@link ../../SwingSet/docs/virtual-objects.md|SwingSet Virtual Objects}
- *
- * Hoisting this function makes defining the state type concise.
- * @typedef {ReturnType<typeof initDurableBoardState>} BoardState
+ * @see {@link ../../SwingSet/docs/virtual-objects.md|SwingSet Virtual Objects} Hoisting this function makes defining the state type concise.
  *
- *
- * // TODO: use Key from @agoric/store when available
  * @typedef {import('@endo/marshal').Passable} Key
  */
 
@@ -93,7 +89,8 @@ const calcCrc = (data, crcDigits) => {
  * @param {bigint | number} [initSequence]
  * @param {object} [options]
  * @param {string} [options.prefix] prefix for all ids generated
- * @param {number} [options.crcDigits] count of digits to use in CRC at end of the id
+ * @param {number} [options.crcDigits] count of digits to use in CRC at end of
+ *   the id
  */
 const initDurableBoardState = (
   initSequence = 0,
@@ -180,9 +177,7 @@ const getValue = (id, { prefix, crcDigits, idToVal }) => {
   throw Fail`board does not have id: ${id}`;
 };
 
-/**
- * @param {BoardState} state
- */
+/** @param {BoardState} state */
 const makeSlotToVal = state => {
   const ifaceAllegedPrefix = 'Alleged: ';
   const ifaceInaccessiblePrefix = 'SEVERED: ';
@@ -243,9 +238,9 @@ const makePublishingMarshaller = state => {
 //#endregion
 
 /**
- * A board is a two-way mapping between objects (such as issuers,
- * brands, installation handles) and plain-data string IDs.
- * A well-known board allows sharing objects by way of their ids.
+ * A board is a two-way mapping between objects (such as issuers, brands,
+ * installation handles) and plain-data string IDs. A well-known board allows
+ * sharing objects by way of their ids.
  *
  * @param {import('@agoric/vat-data').Baggage} baggage for upgrade successors
  * @see {@link packages/SwingSet/docs/vat-upgrade.md|Vat Upgrade}
@@ -261,13 +256,13 @@ export const prepareBoardKit = baggage => {
         /**
          * Provide an ID for a value, generating one if not already present.
          *
-         * Each board ID includes a CRC so that the last part is well-distributed,
-         * which mitigates typo risks.
+         * Each board ID includes a CRC so that the last part is
+         * well-distributed, which mitigates typo risks.
          *
-         * Scaling Consideration: since we cannot know when consumers
-         * are no longer interested in an ID, a board holds a strong reference
-         * to `value` for its entire lifetime. For a well-known board, this
-         * is essentially forever.
+         * Scaling Consideration: since we cannot know when consumers are no
+         * longer interested in an ID, a board holds a strong reference to
+         * `value` for its entire lifetime. For a well-known board, this is
+         * essentially forever.
          *
          * @param {Key} value
          * @throws if `value` is not a Key in the @agoric/store sense
@@ -283,14 +278,14 @@ export const prepareBoardKit = baggage => {
           return getValue(id, this.state);
         },
         /**
-         * Convenience method for recursively traversing boards and
-         * board-like remotables to get data associated with a sequence of ids
-         * corresponding to each successive board.
-         * For example, `lookup("foo", "bar")` gets the value associated with
-         * id "foo" and returns the result of invoking `lookup("bar")` upon it
-         * to get the value it associates with id "bar".
+         * Convenience method for recursively traversing boards and board-like
+         * remotables to get data associated with a sequence of ids
+         * corresponding to each successive board. For example, `lookup("foo",
+         * "bar")` gets the value associated with id "foo" and returns the
+         * result of invoking `lookup("bar")` upon it to get the value it
+         * associates with id "bar".
          *
-         * @param  {...string} path
+         * @param {...string} path
          */
         async lookup(...path) {
           const {
@@ -316,19 +311,19 @@ export const prepareBoardKit = baggage => {
           return harden([...state.idToVal.keys()]);
         },
         /**
-         * Get a marshaller that implements the convertValToSlot hook using getId(),
-         * "publishing" previously un-mapped objects.
+         * Get a marshaller that implements the convertValToSlot hook using
+         * getId(), "publishing" previously un-mapped objects.
          */
         getPublishingMarshaller() {
           return this.facets.publishingMarshaller;
         },
         /**
-         * Get a marshaller that implements the convertValToSlot hook using getId(),
-         * only for objects that the board has().
+         * Get a marshaller that implements the convertValToSlot hook using
+         * getId(), only for objects that the board has().
          *
          * For other objects, we don't throw, but we emit a null slot.
-         * Un-serializing a null slot always produces a fresh object
-         * rather than preserving object identity.
+         * Un-serializing a null slot always produces a fresh object rather than
+         * preserving object identity.
          */
         getReadonlyMarshaller() {
           return this.facets.readonlyMarshaller;
@@ -370,9 +365,7 @@ export const prepareBoardKit = baggage => {
   );
 };
 
-/**
- * @param {import('@agoric/zone').Zone} zone
- */
+/** @param {import('@agoric/zone').Zone} zone */
 export const prepareRecorderFactory = zone => {
   const baggage = zone.mapStore(`Recorder Baggage`);
   const makeDurablePublishKit = prepareDurablePublishKit(

package/src/mintHolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mintHolder.d.ts","sourceRoot":"","sources":["mintHolder.js"],"names":[],"mappings":"AA4CO,oFAHI,SAAS;;;EAUnB;sBA1Ca,OAAO,kBAAkB,EAAE,OAAO;;;;8CAInC;IACZ,OAAW,EAAE,MAAM,CAAC;IACpB,SAAa,EAAE,CAAC,CAAC;IACjB,WAAe,EAAE,WAAW,CAAC;CAC1B"}
+{"version":3,"file":"mintHolder.d.ts","sourceRoot":"","sources":["mintHolder.js"],"names":[],"mappings":"AA2CO,oFAHI,SAAS;;;EAUnB;sBAzCa,OAAO,kBAAkB,EAAE,OAAO;;;;8CAInC;IACZ,OAAW,EAAE,MAAM,CAAC;IACpB,SAAa,EAAE,CAAC,CAAC;IACjB,WAAe,EAAE,WAAW,CAAC;CAC1B"}

package/src/mintHolder.js

@@ -12,9 +12,9 @@ import {
 /**
  * @template {AssetKind} K
  * @typedef {{
- *   keyword: string,
- *   assetKind: K,
- *   displayInfo: DisplayInfo,
+ *   keyword: string;
+ *   assetKind: K;
+ *   displayInfo: DisplayInfo;
  * }} IssuerInfo<K>
  */
 
@@ -33,9 +33,8 @@ function provideIssuerKit(zcf, baggage) {
 }
 
 /**
- * This contract holds one mint; it basically wraps
- * makeIssuerKit in its own contract, and hence in
- * its own vat.
+ * This contract holds one mint; it basically wraps makeIssuerKit in its own
+ * contract, and hence in its own vat.
  *
  * @template {AssetKind} K
  * @param {ZCF<IssuerInfo<K>>} zcf

package/src/nameHub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nameHub.d.ts","sourceRoot":"","sources":["nameHub.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAgDO,4CADK,OAAO,cAAc,EAAE,IAAI,eAwB1B,OAAO,YAAY,EAAE,SAAS,WAC9B,MAAM,iGAalB;AA4CM,wCAFI,OAAO,cAAc,EAAE,IAAI,SAcnB,OAAO,SAAS,EAAE,UAAU,CAoN9C;AApNY,kCAAM,OAAO,SAAS,EAAE,UAAU,CAAA"}
+{"version":3,"file":"nameHub.d.ts","sourceRoot":"","sources":["nameHub.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAgDO,4CADK,OAAO,cAAc,EAAE,IAAI,eA4B1B,OAAO,YAAY,EAAE,SAAS,WAC9B,MAAM,iGAalB;AA4CM,wCAFI,OAAO,cAAc,EAAE,IAAI,SAcnB,OAAO,SAAS,EAAE,UAAU,CA0N9C;AA1NY,kCAAM,OAAO,SAAS,EAAE,UAAU,CAAA"}

package/src/nameHub.js

@@ -51,7 +51,11 @@ export const prepareMixinMyAddress = zone => {
     ...NameHubIKit.nameAdmin.methodGuards,
     getMyAddress: M.call().returns(M.string()),
   });
-  /** @type {import('@agoric/internal/src/callback.js').MakeAttenuator<import('./types.js').MyAddressNameAdmin>} */
+  /**
+   * @type {import('@agoric/internal/src/callback.js').MakeAttenuator<
+   *   import('./types.js').MyAddressNameAdmin
+   * >}
+   */
   const mixin = prepareGuardedAttenuator(zone, MixinI, {
     tag: 'MyAddressNameAdmin',
   });
@@ -122,8 +126,8 @@ const updated = (updateCallback, hub, _newValue = undefined) => {
 };
 
 /**
- * Make two facets of a node in a name hierarchy: the nameHub
- * is read access and the nameAdmin is write access.
+ * Make two facets of a node in a name hierarchy: the nameHub is read access and
+ * the nameAdmin is write access.
  *
  * @param {import('@agoric/zone').Zone} zone
  */
@@ -139,7 +143,7 @@ export const prepareNameHubKit = zone => {
   /** @param {{}} me */
   const my = me => provideWeak(ephemera, me, init1);
 
-  /** @type {() => import('./types').NameHubKit } */
+  /** @type {() => import('./types').NameHubKit} */
   const makeNameHubKit = zone.exoClassKit(
     'NameHubKit',
     NameHubIKit,
@@ -283,7 +287,13 @@ export const prepareNameHubKit = zone => {
           const { keyToPK, keyToAdminPK } = my(this.facets.nameHub);
           const { keyToValue, keyToAdmin, updateCallback } = this.state;
 
-          /** @type {[Map<string, PromiseKit<unknown>>, MapStore<string, unknown>, unknown][]} */
+          /**
+           * @type {[
+           *   Map<string, PromiseKit<unknown>>,
+           *   MapStore<string, unknown>,
+           *   unknown,
+           * ][]}
+           */
           const valueMapEntries = [
             [keyToAdminPK, keyToAdmin, adminValue],
             [keyToPK, keyToValue, newValue],
@@ -354,8 +364,8 @@ export const prepareNameHubKit = zone => {
 };
 
 /**
- * Make two facets of a node in a name hierarchy: the nameHub
- * is read access and the nameAdmin is write access.
+ * Make two facets of a node in a name hierarchy: the nameHub is read access and
+ * the nameAdmin is write access.
  *
  * @returns {import('./types.js').NameHubKit}
  */

package/src/proposals/network-proposal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-proposal.d.ts","sourceRoot":"","sources":["network-proposal.js"],"names":[],"mappings":"AAgBO,+CAHI,QAAQ,GAAG,OAAO,kGA2D5B;AAgBM,wJAbK,eAAe,GAAG;IAC7B,OAAW,EAAE;QAAE,eAAe,EAAE,UAAU,GAAG,CAAC,CAAA;KAAE,CAAA;IAChD,OAAW,EAAE;QAAE,UAAU,EAAE,SAAS,GAAG,CAAC,CAAA;KAAE,CAAA;CACvC;;oBAGoB,YAAY;gBAAU,YAAY;;kBA2DzD;AAEM;;;;;;;;;;;;;;;;;;;;;;EAmBL;iCA9EoB,SAAS,KAAK,UAAU,YACxB,KAAK,KAAK,MAAM;sBAEzB;IAAE,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC;IAAC,GAAG,EAAE,KAAK,MAAM,CAAC,CAAC;IAAC,YAAY,EAAE,KAAK,eAAe,GAAG,SAAS,CAAC,CAAA;CAAC"}
+{"version":3,"file":"network-proposal.d.ts","sourceRoot":"","sources":["network-proposal.js"],"names":[],"mappings":"AAgBO,+CAHI,QAAQ,GAAG,OAAO,kGA2D5B;AAmBM,wJAhBI,eAAe,GAAG;IAC5B,OAAW,EAAE;QAAE,eAAe,EAAE,UAAU,GAAG,CAAC,CAAA;KAAE,CAAC;IACjD,OAAW,EAAE;QAAE,UAAU,EAAE,SAAS,GAAG,CAAC,CAAA;KAAE,CAAC;CACxC;;oBAEqB,YAAY;gBAAU,YAAY;;kBA+D1D;AAEM;;;;;;;;;;;;;;;;;;;;;;EAmBL;iCAjFmB,SAAS,KAAK,UAAU,YAAY,KAAK,KAAK,MAAM;sBAE5D;IACZ,OAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IAC9B,GAAO,EAAE,KAAK,MAAM,CAAC,CAAC;IACtB,YAAgB,EAAE,KAAK,eAAe,GAAG,SAAS,CAAC,CAAC;CACjD"}

package/src/proposals/network-proposal.js

@@ -73,18 +73,21 @@ export const registerNetworkProtocols = async (vats, dibcBridgeManager) => {
 };
 
 /**
- * @param { BootstrapPowers & {
- *   consume: { loadCriticalVat: VatLoader<any> }
- *   produce: { networkVat: Producer<any> }
+ * @param {BootstrapPowers & {
+ *   consume: { loadCriticalVat: VatLoader<any> };
+ *   produce: { networkVat: Producer<any> };
  * }} powers
- *
  * @param {object} options
- * @param {{networkRef: VatSourceRef, ibcRef: VatSourceRef}} options.options
- * // TODO: why doesn't overloading VatLoader work???
- * @typedef { ((name: 'network') => NetworkVat) &
- *            ((name: 'ibc') => IBCVat) } VatLoader2
+ * @param {{ networkRef: VatSourceRef; ibcRef: VatSourceRef }} options.options
+ *   // TODO: why doesn't overloading VatLoader work???
+ *
+ * @typedef {((name: 'network') => NetworkVat) & ((name: 'ibc') => IBCVat)} VatLoader2
  *
- * @typedef {{ network: ERef<NetworkVat>, ibc: ERef<IBCVat>, provisioning: ERef<ProvisioningVat | undefined>}} NetVats
+ * @typedef {{
+ *   network: ERef<NetworkVat>;
+ *   ibc: ERef<IBCVat>;
+ *   provisioning: ERef<ProvisioningVat | undefined>;
+ * }} NetVats
  */
 export const setupNetworkProtocols = async (
   {
@@ -99,7 +102,7 @@ export const setupNetworkProtocols = async (
   options,
 ) => {
   const { networkRef, ibcRef } = options.options;
-  /** @type { NetVats } */
+  /** @type {NetVats} */
   const vats = {
     network: E(loadCriticalVat)('network', networkRef),
     ibc: E(loadCriticalVat)('ibc', ibcRef),

package/src/proposals/restart-vats-proposal.d.ts

@@ -1,6 +1,6 @@
 export function restartVats({ consume }: BootstrapPowers & import('@agoric/inter-protocol/src/proposals/econ-behaviors.js').EconomyBootstrapSpace, { options }: {
     options: {
-        skip: Array<string>;
+        skip: string[];
     };
 }): Promise<void>;
 export function getManifestForRestart(_powers: any, options: any): {

package/src/proposals/restart-vats-proposal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restart-vats-proposal.d.ts","sourceRoot":"","sources":["restart-vats-proposal.js"],"names":[],"mappings":"AA8BO,yCAJI,eAAe,GAAG,OAAO,wDAAwD,EAAE,qBAAqB;IAEzE,OAAO,EAAtC;QAAE,IAAI,EAAE,MAAM,MAAM,CAAC,CAAA;KAAC;kBA2GhC;AAGM;;;;;;;;;;;;;;;;;;EAkBL"}
+{"version":3,"file":"restart-vats-proposal.d.ts","sourceRoot":"","sources":["restart-vats-proposal.js"],"names":[],"mappings":"AA+BO,yCALI,eAAe,GACzB,OAAW,wDAAwD,EAAE,qBAAqB;IAErD,OAAO,EAAlC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;kBA0G5B;AAGM;;;;;;;;;;;;;;;;;;EAkBL"}

package/src/proposals/restart-vats-proposal.js

@@ -24,9 +24,10 @@ const vatUpgradeStatus = {
 };
 
 /**
- * @param {BootstrapPowers & import('@agoric/inter-protocol/src/proposals/econ-behaviors.js').EconomyBootstrapSpace} space
+ * @param {BootstrapPowers &
+ *   import('@agoric/inter-protocol/src/proposals/econ-behaviors.js').EconomyBootstrapSpace} space
  * @param {object} config
- * @param {{ skip: Array<string>}} config.options
+ * @param {{ skip: string[] }} config.options
  */
 export const restartVats = async ({ consume }, { options }) => {
   console.log(HR);
@@ -52,7 +53,6 @@ export const restartVats = async ({ consume }, { options }) => {
 
   const failures = [];
   /**
-   *
    * @param {string} debugName
    * @param {Instance} instance
    * @param {ERef<AdminFacet>} adminFacet

package/src/provisionPool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provisionPool.d.ts","sourceRoot":"","sources":["provisionPool.js"],"names":[],"mappings":"AAgBA,gEAWE;AAmBK,6BAVI,IAAI,cAAc,CAAC;cAEf,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,eAAe,EAAE,IAAI,CAAC;4BACxC,UAAU;iBACrB,WAAW;gBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqE1B;;;;6BAhFY,aAAa,GAAG,gBAAgB;IAC5C,uBAA4B,EAAE,QAAQ,CAAC;CAClC,CAAC"}
+{"version":3,"file":"provisionPool.d.ts","sourceRoot":"","sources":["provisionPool.js"],"names":[],"mappings":"AAgBA,gEAWE;AAkBK,6BAVI,IAAI,cAAc,CAAC;cAEf,OAAO,WAAW,EAAE,IAAI,CAAC,OAAO,eAAe,EAAE,IAAI,CAAC;4BACxC,UAAU;iBACrB,WAAW;gBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqE1B;;;;6BA/EY,aAAa,GACzB,gBAAoB;IACpB,uBAA6B,EAAE,QAAQ,CAAC;CACnC,CAAC"}

package/src/provisionPool.js

@@ -28,19 +28,18 @@ export const privateArgsShape = M.splitRecord(
 );
 
 /**
- * @typedef {StandardTerms & GovernanceTerms<{
- *    PerAccountInitialAmount: 'amount',
+ * @typedef {StandardTerms &
+ *   GovernanceTerms<{
+ *     PerAccountInitialAmount: 'amount';
  *   }>} ProvisionTerms
- *
- * TODO: ERef<GovernedCreatorFacet<ProvisionCreator>>
- *
+ *   TODO: ERef<GovernedCreatorFacet<ProvisionCreator>>
  * @param {ZCF<ProvisionTerms>} zcf
  * @param {{
- *   poolBank: import('@endo/far').ERef<import('./vat-bank.js').Bank>,
- *   initialPoserInvitation: Invitation,
- *   storageNode: StorageNode,
- *   marshaller: Marshaller,
- *   metricsOverride?: import('./provisionPoolKit').MetricsNotification,
+ *   poolBank: import('@endo/far').ERef<import('./vat-bank.js').Bank>;
+ *   initialPoserInvitation: Invitation;
+ *   storageNode: StorageNode;
+ *   marshaller: Marshaller;
+ *   metricsOverride?: import('./provisionPoolKit').MetricsNotification;
  * }} privateArgs
  * @param {import('@agoric/vat-data').Baggage} baggage
  */

package/src/provisionPoolKit.d.ts

@@ -13,9 +13,7 @@ export function prepareProvisionPoolKit(baggage: MapStore<string, unknown>, { ma
     storageNode: ERef<StorageNode>;
 }) => Promise<{
     machine: {
-        /**
-         * @param {string[]} oldAddresses
-         */
+        /** @param {string[]} oldAddresses */
         addRevivableAddresses(oldAddresses: string[]): void;
         getWalletReviver(): {
             /** @param {string} address */
@@ -49,9 +47,7 @@ export function prepareProvisionPoolKit(baggage: MapStore<string, unknown>, { ma
              */
             ackWallet(address: string): boolean;
         };
-        /**
-         * @param {ProvisionPoolKitReferences} erefs
-         */
+        /** @param {ProvisionPoolKitReferences} erefs */
         setReferences(erefs: ProvisionPoolKitReferences): Promise<void>;
         makeHandler(): {
             fromBridge: (obj: any) => Promise<void>;
@@ -101,10 +97,7 @@ export function prepareProvisionPoolKit(baggage: MapStore<string, unknown>, { ma
         onTrade(converted: any): void;
         onSendFunds(provided: any): void;
         onProvisioned(): void;
-        /**
-         *
-         * @param {ERef<Bank>} destBank
-         */
+        /** @param {ERef<Bank>} destBank */
         sendInitialPayment(destBank: ERef<Bank>): Promise<void>;
         /**
          * @param {object} [options]
@@ -127,9 +120,7 @@ export function prepareProvisionPoolKit(baggage: MapStore<string, unknown>, { ma
     };
 } & import("@endo/eventual-send").RemotableBrand<{}, {
     machine: {
-        /**
-         * @param {string[]} oldAddresses
-         */
+        /** @param {string[]} oldAddresses */
         addRevivableAddresses(oldAddresses: string[]): void;
         getWalletReviver(): {
             /** @param {string} address */
@@ -163,9 +154,7 @@ export function prepareProvisionPoolKit(baggage: MapStore<string, unknown>, { ma
              */
             ackWallet(address: string): boolean;
         };
-        /**
-         * @param {ProvisionPoolKitReferences} erefs
-         */
+        /** @param {ProvisionPoolKitReferences} erefs */
         setReferences(erefs: ProvisionPoolKitReferences): Promise<void>;
         makeHandler(): {
             fromBridge: (obj: any) => Promise<void>;
@@ -215,10 +204,7 @@ export function prepareProvisionPoolKit(baggage: MapStore<string, unknown>, { ma
         onTrade(converted: any): void;
         onSendFunds(provided: any): void;
         onProvisioned(): void;
-        /**
-         *
-         * @param {ERef<Bank>} destBank
-         */
+        /** @param {ERef<Bank>} destBank */
         sendInitialPayment(destBank: ERef<Bank>): Promise<void>;
         /**
          * @param {object} [options]
@@ -366,8 +352,8 @@ export type ProvisionPoolKitReferences = {
     walletFactory: ERef<import('@agoric/vats/src/core/startWalletFactory').WalletFactoryStartResult['creatorFacet']>;
 };
 /**
- * Metrics naming scheme is that nouns are present values and past-participles
- * are accumulative.
+ * Metrics naming scheme is that nouns are
+ *   present values and past-participles are accumulative.
  */
 export type MetricsNotification = {
     /**
@@ -375,18 +361,19 @@ export type MetricsNotification = {
      */
     walletsProvisioned: bigint;
     /**
-     * running sum of Minted provided to new wallets
+     * running sum of Minted provided
+     * to new wallets
      */
     totalMintedProvided: Amount<'nat'>;
     /**
-     * running sum of Minted
-     * ever received by the contract from PSM
+     * running sum of Minted ever
+     * received by the contract from PSM
      */
     totalMintedConverted: Amount<'nat'>;
 };
 /**
- * Given attenuated access to the funding purse,
- * handle requests to provision smart wallets.
+ * Given attenuated access to the funding purse, handle requests to provision
+ * smart wallets.
  */
 export type Bank = import('./vat-bank.js').Bank;
 //# sourceMappingURL=provisionPoolKit.d.ts.map

package/src/provisionPoolKit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provisionPoolKit.d.ts","sourceRoot":"","sources":["provisionPoolKit.js"],"names":[],"mappings":"AAqDO,0EAJkB,KAAK,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,iBAC1C,MAAM,IAAI,0DAKR,0BAA0B;;;;GAgCtC;AAWM,wHAPI;IACV,eAAmB,EAAE,OAAO,6CAA6C,EAAE,eAAe,CAAC;IAC3F,MAAU,MAAI;IACd,QAAY,EAAE,OAAO,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,GAAO,EAAE,GAAG,CAAC;CACV;IA8VqB,SAAS,EAArB,KAAK;IACmB,WAAW,EAAnC,KAAK,WAAW,CAAC;;;QAhRtB;;WAEG;4CADQ,MAAM,EAAE;;YAkDnB,8BAA8B;kCAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;YAqBlB;;;eAGG;+BAFQ,MAAM,GACJ,OAAO;;QAhEpB;;WAEG;6BADQ,0BAA0B;;;;;;QA8BrC;;;WAGG;uBAFQ,KAAK,YACL,WAAW;;;QAQtB,8BAA8B;8BAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;QAqBlB;;;WAGG;2BAFQ,MAAM,GACJ,OAAO;;;;;;;QAgDpB;;;WAGG;qCADQ,KAAK,IAAI,CAAC;QA2BrB;;;WAGG;;;;QA2EH;;;;WAIG;oBAHQ,KAAK,OAAO,CAAC,UACb,MAAM,YACN,WAAW;;;;;;;;;QAxOtB;;WAEG;4CADQ,MAAM,EAAE;;YAkDnB,8BAA8B;kCAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;YAqBlB;;;eAGG;+BAFQ,MAAM,GACJ,OAAO;;QAhEpB;;WAEG;6BADQ,0BAA0B;;;;;;QA8BrC;;;WAGG;uBAFQ,KAAK,YACL,WAAW;;;QAQtB,8BAA8B;8BAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;QAqBlB;;;WAGG;2BAFQ,MAAM,GACJ,OAAO;;;;;;;QAgDpB;;;WAGG;qCADQ,KAAK,IAAI,CAAC;QA2BrB;;;WAGG;;;;QA2EH;;;;WAIG;oBAHQ,KAAK,OAAO,CAAC,UACb,MAAM,YACN,WAAW;;;;;;;IAwD7B;0BAtba,OAAO,kCAAkC,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAyD;;iBAI5G,KAAK,WAAW,CAAC;yBACjB,KAAK,OAAO,cAAc,EAAE,SAAS,CAAC;mBACtC,KAAK,OAAO,0CAA0C,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAC;;;;;;;;;;wBAQjG,MAAM;;;;yBACN,OAAO,KAAK,CAAC;;;;;0BACb,OAAO,KAAK,CAAC;;;;;;mBAUd,OAAO,eAAe,EAAE,IAAI"}
+{"version":3,"file":"provisionPoolKit.d.ts","sourceRoot":"","sources":["provisionPoolKit.js"],"names":[],"mappings":"AA2DO,0EALkB,KAAK,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,iBAC1C,MAAM,IAAI,0DAKP,0BAA0B;;;;GA+BvC;AAWM,wHAPI;IACV,eAAmB,EAAE,OAAO,6CAA6C,EAAE,eAAe,CAAC;IAC3F,MAAU,EAAE,GAAG,CAAC;IAChB,QAAY,EAAE,OAAO,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,GAAO,EAAE,GAAG,CAAC;CACV;IAuVqB,SAAS,EAArB,KAAK;IACmB,WAAW,EAAnC,KAAK,WAAW,CAAC;;;QAzQtB,qCAAqC;4CAAzB,MAAM,EAAE;;YA+CpB,8BAA8B;kCAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;YAqBlB;;;eAGG;+BAFQ,MAAM,GACJ,OAAO;;QA9DpB,gDAAgD;6BAApC,0BAA0B;;;;;;QA6BtC;;;WAGG;uBAFQ,KAAK,YACL,WAAW;;;QAQtB,8BAA8B;8BAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;QAqBlB;;;WAGG;2BAFQ,MAAM,GACJ,OAAO;;;;;;;QAgDpB,mCAAmC;qCAAvB,KAAK,IAAI,CAAC;QA0BtB;;;WAGG;;;;QA2EH;;;;WAIG;oBAHQ,KAAK,OAAO,CAAC,UACb,MAAM,YACN,WAAW;;;;;;;;;QAjOtB,qCAAqC;4CAAzB,MAAM,EAAE;;YA+CpB,8BAA8B;kCAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;YAqBlB;;;eAGG;+BAFQ,MAAM,GACJ,OAAO;;QA9DpB,gDAAgD;6BAApC,0BAA0B;;;;;;QA6BtC;;;WAGG;uBAFQ,KAAK,YACL,WAAW;;;QAQtB,8BAA8B;8BAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;QAqBlB;;;WAGG;2BAFQ,MAAM,GACJ,OAAO;;;;;;;QAgDpB,mCAAmC;qCAAvB,KAAK,IAAI,CAAC;QA0BtB;;;WAGG;;;;QA2EH;;;;WAIG;oBAHQ,KAAK,OAAO,CAAC,UACb,MAAM,YACN,WAAW;;;;;;;IAwD7B;0BAlbY,OAAO,kCAAkC,EAAE,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAE5D;;iBAKU,KAAK,WAAW,CAAC;yBACjB,KAAK,OAAO,cAAc,EAAE,SAAS,CAAC;mBACtC,KACb,OAAW,0CAA0C,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAC5F;;;;;;;;;;wBAMU,MAAM;;;;;yBACN,OAAO,KAAK,CAAC;;;;;0BAEb,OAAO,KAAK,CAAC;;;;;;mBAWd,OAAO,eAAe,EAAE,IAAI"}

package/src/provisionPoolKit.js

@@ -23,38 +23,42 @@ import { PowerFlags } from './walletFlags.js';
 
 const { details: X, quote: q, Fail } = assert;
 
-/** @typedef {import('@agoric/zoe/src/zoeService/utils').Instance<import('@agoric/inter-protocol/src/psm/psm.js').prepare>} PsmInstance */
+/**
+ * @typedef {import('@agoric/zoe/src/zoeService/utils').Instance<
+ *   import('@agoric/inter-protocol/src/psm/psm.js').prepare
+ * >} PsmInstance
+ */
 
 /**
  * @typedef {object} ProvisionPoolKitReferences
  * @property {ERef<BankManager>} bankManager
  * @property {ERef<import('@agoric/vats').NameAdmin>} namesByAddressAdmin
- * @property {ERef<import('@agoric/vats/src/core/startWalletFactory').WalletFactoryStartResult['creatorFacet']>} walletFactory
+ * @property {ERef<
+ *   import('@agoric/vats/src/core/startWalletFactory').WalletFactoryStartResult['creatorFacet']
+ * >} walletFactory
  */
 
 /**
- * @typedef {object} MetricsNotification
- * Metrics naming scheme is that nouns are present values and past-participles
- * are accumulative.
- *
- * @property {bigint} walletsProvisioned  count of new wallets provisioned
- * @property {Amount<'nat'>} totalMintedProvided  running sum of Minted provided to new wallets
- * @property {Amount<'nat'>} totalMintedConverted  running sum of Minted
- * ever received by the contract from PSM
+ * @typedef {object} MetricsNotification Metrics naming scheme is that nouns are
+ *   present values and past-participles are accumulative.
+ * @property {bigint} walletsProvisioned count of new wallets provisioned
+ * @property {Amount<'nat'>} totalMintedProvided running sum of Minted provided
+ *   to new wallets
+ * @property {Amount<'nat'>} totalMintedConverted running sum of Minted ever
+ *   received by the contract from PSM
  */
 
 /**
- * Given attenuated access to the funding purse,
- * handle requests to provision smart wallets.
+ * Given attenuated access to the funding purse, handle requests to provision
+ * smart wallets.
  *
  * @param {(depositBank: ERef<Bank>) => Promise<void>} sendInitialPayment
  * @param {() => void} onProvisioned
+ *
  * @typedef {import('./vat-bank.js').Bank} Bank
  */
 export const makeBridgeProvisionTool = (sendInitialPayment, onProvisioned) => {
-  /**
-   * @param {ProvisionPoolKitReferences} refs
-   */
+  /** @param {ProvisionPoolKitReferences} refs */
   const makeBridgeHandler = ({
     bankManager,
     namesByAddressAdmin,
@@ -90,10 +94,10 @@ export const makeBridgeProvisionTool = (sendInitialPayment, onProvisioned) => {
 /**
  * @param {import('@agoric/vat-data').Baggage} baggage
  * @param {{
- *   makeRecorderKit: import('@agoric/zoe/src/contractSupport/recorder.js').MakeRecorderKit,
- *   params: *,
- *   poolBank: import('@endo/far').ERef<Bank>,
- *   zcf: ZCF,
+ *   makeRecorderKit: import('@agoric/zoe/src/contractSupport/recorder.js').MakeRecorderKit;
+ *   params: any;
+ *   poolBank: import('@endo/far').ERef<Bank>;
+ *   zcf: ZCF;
  * }} powers
  */
 export const prepareProvisionPoolKit = (
@@ -173,9 +177,7 @@ export const prepareProvisionPoolKit = (
     {
       // aka "limitedCreatorFacet"
       machine: {
-        /**
-         * @param {string[]} oldAddresses
-         */
+        /** @param {string[]} oldAddresses */
         addRevivableAddresses(oldAddresses) {
           console.log('revivableAddresses count', oldAddresses.length);
           this.state.revivableAddresses.addAll(oldAddresses);
@@ -183,9 +185,7 @@ export const prepareProvisionPoolKit = (
         getWalletReviver() {
           return this.facets.walletReviver;
         },
-        /**
-         * @param {ProvisionPoolKitReferences} erefs
-         */
+        /** @param {ProvisionPoolKitReferences} erefs */
         async setReferences(erefs) {
           const { bankManager, namesByAddressAdmin, walletFactory } = erefs;
           const obj = harden({
@@ -295,10 +295,7 @@ export const prepareProvisionPoolKit = (
           state.walletsProvisioned += 1n;
           facets.helper.publishMetrics();
         },
-        /**
-         *
-         * @param {ERef<Bank>} destBank
-         */
+        /** @param {ERef<Bank>} destBank */
         async sendInitialPayment(destBank) {
           const {
             facets: { helper },

package/src/repl.js

@@ -74,7 +74,7 @@ function dump0(value, spaces, inProgress, depth) {
 
     let sep = '';
     let closer;
-    /** @type {Array<string | symbol>} */
+    /** @type {(string | symbol)[]} */
     const names = Object.getOwnPropertyNames(value);
     const nonNumber = new Set(names);
     if (Array.isArray(value)) {