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

package/src/vat-bank.js

@@ -32,6 +32,7 @@ const BridgeChannelI = M.interface('BridgeChannel', {
 
 /**
  * @typedef {import('./virtual-purse').VirtualPurseController} VirtualPurseController
+ *
  * @typedef {Awaited<ReturnType<ReturnType<typeof prepareVirtualPurse>>>} VirtualPurse
  */
 
@@ -44,10 +45,14 @@ const BalanceUpdaterI = M.interface('BalanceUpdater', {
   update: M.call(M.string()).optional(M.string()).returns(),
 });
 
-/** @typedef {Pick<import('./types.js').ScopedBridgeManager, 'fromBridge' | 'toBridge'>} BridgeChannel */
+/**
+ * @typedef {Pick<
+ *   import('./types.js').ScopedBridgeManager,
+ *   'fromBridge' | 'toBridge'
+ * >} BridgeChannel
+ */
 
 /**
- *
  * @param {import('@agoric/zone').Zone} zone
  * @returns {(brand: Brand, publisher: Publisher<Amount>) => BalanceUpdater}
  */
@@ -76,9 +81,7 @@ const prepareBalanceUpdater = zone =>
     },
   );
 
-/**
- * @param {import('@agoric/zone').Zone} zone
- */
+/** @param {import('@agoric/zone').Zone} zone */
 const prepareBankPurseController = zone => {
   /**
    * @param {BridgeChannel} bankBridge
@@ -170,16 +173,12 @@ const prepareRewardPurseController = zone =>
     },
   );
 
-/**
- * @param {import('@agoric/zone').Zone} zone
- */
+/** @param {import('@agoric/zone').Zone} zone */
 const prepareBankChannelHandler = zone =>
   zone.exoClass(
     'BankChannelHandler',
     BridgeHandlerI,
-    /**
-     * @param {MapStore<string, MapStore<string, BalanceUpdater>>} denomToAddressUpdater
-     */
+    /** @param {MapStore<string, MapStore<string, BalanceUpdater>>} denomToAddressUpdater */
     denomToAddressUpdater => ({ denomToAddressUpdater }),
     {
       async fromBridge(obj) {
@@ -221,7 +220,7 @@ const prepareBankChannelHandler = zone =>
  * Concatenate multiple iterables to form a new one.
  *
  * @template T
- * @param {Array<Iterable<T> | AsyncIterable<T>>} iterables
+ * @param {(Iterable<T> | AsyncIterable<T>)[]} iterables
  */
 async function* concatAsyncIterables(iterables) {
   for (const asyncIterable of iterables) {
@@ -273,12 +272,15 @@ const makeHistoricalTopic = (historyValues, futureSubscriber, skipValue) => {
   return makeSubscriberFromAsyncIterable(allHistory, skipValue);
 };
 
-/** @type {WeakMap<MapStore<Brand, AssetDescriptor>, Promise<PublicationRecord<AssetDescriptor>>>} */
-const fullAssetPubLists = new WeakMap();
-
 /**
- * @param {import('@agoric/zone').Zone} zone
+ * @type {WeakMap<
+ *   MapStore<Brand, AssetDescriptor>,
+ *   Promise<PublicationRecord<AssetDescriptor>>
+ * >}
  */
+const fullAssetPubLists = new WeakMap();
+
+/** @param {import('@agoric/zone').Zone} zone */
 const prepareAssetSubscription = zone => {
   const assetSubscriptionCache = zone.weakMapStore('assetSubscriptionCache');
 
@@ -358,9 +360,7 @@ const AssetIssuerKitShape = M.splitRecord(BaseIssuerKitShape, {
   mint: M.remotable('Mint'),
 });
 
-/**
- * @typedef {AssetIssuerKit & { denom: string, escrowPurse?: ERef<Purse> }} AssetRecord
- */
+/** @typedef {AssetIssuerKit & { denom: string; escrowPurse?: ERef<Purse> }} AssetRecord */
 
 /**
  * @typedef {object} AssetDescriptor
@@ -372,18 +372,18 @@ const AssetIssuerKitShape = M.splitRecord(BaseIssuerKitShape, {
  */
 
 /**
- * @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 = M.interface('Bank', {
@@ -410,7 +410,12 @@ const prepareBank = (
   // we decide to partition the provider and use `brandToVPurse` directly, we'd
   // need ephemera for each `makeBank` call.
   const addressDenomToPurse = zone.mapStore('addressDenomToPurse');
-  /** @type {import('@agoric/store/src/stores/store-utils.js').AtomicProvider<string, VirtualPurse>} */
+  /**
+   * @type {import('@agoric/store/src/stores/store-utils.js').AtomicProvider<
+   *     string,
+   *     VirtualPurse
+   *   >}
+   */
   const purseProvider = makeAtomicProvider(addressDenomToPurse);
 
   const makeBank = zone.exoClass(
@@ -574,12 +579,17 @@ const prepareBankManager = (
       const brandToAssetDescriptor = detachedZone.mapStore(
         'brandToAssetDescriptor',
       );
-      /** @type {MapStore<string, { bank: Bank, brandToVPurse: MapStore<Brand, VirtualPurse> }>} */
+      /**
+       * @type {MapStore<
+       *   string,
+       *   { bank: Bank; brandToVPurse: MapStore<Brand, VirtualPurse> }
+       * >}
+       */
       const addressToBank = detachedZone.mapStore('addressToBank');
 
       /**
        * CAVEAT: The history for the assetSubscriber needs to be loaded into the
-       * heap on first use in this incarnation.  Use provideAssetSubscription to
+       * heap on first use in this incarnation. Use provideAssetSubscription to
        * set that up.
        *
        * @type {PublishKit<AssetDescriptor>}
@@ -637,7 +647,7 @@ const prepareBankManager = (
        *
        * @param {string} moduleName
        * @returns {Promise<string | null>} address of named module account, or
-       * null if unimplemented (no bankChannel)
+       *   null if unimplemented (no bankChannel)
        */
       async getModuleAccountAddress(moduleName) {
         const { bankChannel } = this.state;
@@ -652,16 +662,17 @@ const prepareBankManager = (
       },
 
       /**
-       * 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)
        */
       async addAsset(denom, issuerName, proposedName, kit) {
         const {
@@ -722,7 +733,7 @@ const prepareBankManager = (
           ([issuer, displayInfo]) =>
             E(nameAdmin).update(
               denom,
-              /** @type { AssetInfo } */ (
+              /** @type {AssetInfo} */ (
                 harden({
                   brand,
                   issuer,
@@ -774,9 +785,7 @@ const prepareBankManager = (
   return makeBankManager;
 };
 
-/**
- * @param {MapStore<string, any>} baggage
- */
+/** @param {MapStore<string, any>} baggage */
 const prepareFromBaggage = baggage => {
   const rootZone = makeDurableZone(baggage);
 
@@ -797,9 +806,7 @@ const prepareFromBaggage = baggage => {
   const makeRewardPurseController = prepareRewardPurseController(rootZone);
   const makeBankChannelHandler = prepareBankChannelHandler(rootZone);
 
-  /**
-   * @type {import('@agoric/internal/src/callback.js').MakeAttenuator<BridgeChannel>}
-   */
+  /** @type {import('@agoric/internal/src/callback.js').MakeAttenuator<BridgeChannel>} */
   const makeBridgeChannelAttenuator = prepareGuardedAttenuator(
     rootZone.subZone('attenuators'),
     BridgeChannelI,
@@ -839,11 +846,11 @@ export function buildRootObject(_vatPowers, _args, baggage) {
 
   return Far('bankMaker', {
     /**
-     * @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.
      */
     async makeBankManager(
       bankBridgeManagerP = undefined,
@@ -856,9 +863,7 @@ export function buildRootObject(_vatPowers, _args, baggage) {
         'denomToAddressUpdater',
       );
 
-      /**
-       * @param {ERef<import('./types.js').ScopedBridgeManager>} [bankBridgeMgr]
-       */
+      /** @param {ERef<import('./types.js').ScopedBridgeManager>} [bankBridgeMgr] */
       async function getBankChannel(bankBridgeMgr) {
         // We do the logic here if the bridge manager is available.  Otherwise,
         // the bank is not "remote" (such as on sim-chain), so we just use

package/src/vat-mints.d.ts

@@ -4,9 +4,9 @@ export function buildRootObject(): {
     /** @param {string[]} issuerNames */
     getIssuers: (issuerNames: string[]) => Issuer<AssetKind>[];
     /**
-     * WARNING: a mint is ability to mint new digital assets,
-     * a very powerful authority that is usually closely held.
-     * But this mint is for demo / faucet purposes.
+     * WARNING: a mint is ability to mint new digital assets, a very powerful
+     * authority that is usually closely held. But this mint is for demo /
+     * faucet purposes.
      *
      * @param {string} name
      */
@@ -14,8 +14,8 @@ export function buildRootObject(): {
     /** @param {string[]} issuerNames */
     getMints: (issuerNames: string[]) => Mint<AssetKind>[];
     /**
-     * @param {*} issuerNameSingular For example, 'moola', or 'simolean'
-     * @param  {[AssetKind?, DisplayInfo?]} issuerArgs
+     * @param {any} issuerNameSingular For example, 'moola', or 'simolean'
+     * @param {[AssetKind?, DisplayInfo?]} issuerArgs
      */
     makeMintAndIssuer: (issuerNameSingular: any, issuerArgs_0?: AssetKind | undefined, issuerArgs_1?: DisplayInfo<AssetKind> | undefined) => Issuer<"set" | "nat" | "copySet" | "copyBag">;
     provideIssuerKit: (issuerName: any, ...issuerArgs: any[]) => {
@@ -39,9 +39,9 @@ export function buildRootObject(): {
     /** @param {string[]} issuerNames */
     getIssuers: (issuerNames: string[]) => Issuer<AssetKind>[];
     /**
-     * WARNING: a mint is ability to mint new digital assets,
-     * a very powerful authority that is usually closely held.
-     * But this mint is for demo / faucet purposes.
+     * WARNING: a mint is ability to mint new digital assets, a very powerful
+     * authority that is usually closely held. But this mint is for demo /
+     * faucet purposes.
      *
      * @param {string} name
      */
@@ -49,8 +49,8 @@ export function buildRootObject(): {
     /** @param {string[]} issuerNames */
     getMints: (issuerNames: string[]) => Mint<AssetKind>[];
     /**
-     * @param {*} issuerNameSingular For example, 'moola', or 'simolean'
-     * @param  {[AssetKind?, DisplayInfo?]} issuerArgs
+     * @param {any} issuerNameSingular For example, 'moola', or 'simolean'
+     * @param {[AssetKind?, DisplayInfo?]} issuerArgs
      */
     makeMintAndIssuer: (issuerNameSingular: any, issuerArgs_0?: AssetKind | undefined, issuerArgs_1?: DisplayInfo<AssetKind> | undefined) => Issuer<"set" | "nat" | "copySet" | "copyBag">;
     provideIssuerKit: (issuerName: any, ...issuerArgs: any[]) => {

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

@@ -1 +1 @@
-{"version":3,"file":"vat-mints.d.ts","sourceRoot":"","sources":["vat-mints.js"],"names":[],"mappings":"AAUA;;;IAUI,oCAAoC;8BAAxB,MAAM,EAAE;IAGpB;;;;;;OAMG;oBADQ,MAAM;IAMjB,oCAAoC;4BAAxB,MAAM,EAAE;IAEpB;;;OAGG;;;;;;;IA2BH;;;OAGG;qCAFQ,MAAM,SACN,MAAM;IAUjB;;;OAGG;uCAFQ,MAAM,EAAE,UACR,MAAM,EAAE;;;;IA5DnB,oCAAoC;8BAAxB,MAAM,EAAE;IAGpB;;;;;;OAMG;oBADQ,MAAM;IAMjB,oCAAoC;4BAAxB,MAAM,EAAE;IAEpB;;;OAGG;;;;;;;IA2BH;;;OAGG;qCAFQ,MAAM,SACN,MAAM;IAUjB;;;OAGG;uCAFQ,MAAM,EAAE,UACR,MAAM,EAAE;GAStB"}
+{"version":3,"file":"vat-mints.d.ts","sourceRoot":"","sources":["vat-mints.js"],"names":[],"mappings":"AAUA;;;IAUI,oCAAoC;8BAAxB,MAAM,EAAE;IAGpB;;;;;;OAMG;oBADQ,MAAM;IAMjB,oCAAoC;4BAAxB,MAAM,EAAE;IAEpB;;;OAGG;4CAFQ,GAAG;;;;;;IA6Bd;;;OAGG;qCAFQ,MAAM,SACN,MAAM;IAUjB;;;OAGG;uCAFQ,MAAM,EAAE,UACR,MAAM,EAAE;;;;IA5DnB,oCAAoC;8BAAxB,MAAM,EAAE;IAGpB;;;;;;OAMG;oBADQ,MAAM;IAMjB,oCAAoC;4BAAxB,MAAM,EAAE;IAEpB;;;OAGG;4CAFQ,GAAG;;;;;;IA6Bd;;;OAGG;qCAFQ,MAAM,SACN,MAAM;IAUjB;;;OAGG;uCAFQ,MAAM,EAAE,UACR,MAAM,EAAE;GAStB"}

package/src/vat-mints.js

@@ -9,7 +9,7 @@ import { notForProductionUse } from '@agoric/internal/src/magic-cookie-test-only
 // simoleanMint.
 
 export function buildRootObject() {
-  /** @type {MapStore<string, { mint: Mint, brand: Brand}>} */
+  /** @type {MapStore<string, { mint: Mint; brand: Brand }>} */
   const mintsAndBrands = makeScalarMapStore('issuerName');
 
   const api = Far('api', {
@@ -22,9 +22,9 @@ export function buildRootObject() {
     getIssuers: issuerNames => issuerNames.map(api.getIssuer),
 
     /**
-     * WARNING: a mint is ability to mint new digital assets,
-     * a very powerful authority that is usually closely held.
-     * But this mint is for demo / faucet purposes.
+     * WARNING: a mint is ability to mint new digital assets, a very powerful
+     * authority that is usually closely held. But this mint is for demo /
+     * faucet purposes.
      *
      * @param {string} name
      */
@@ -35,8 +35,8 @@ export function buildRootObject() {
     /** @param {string[]} issuerNames */
     getMints: issuerNames => issuerNames.map(api.getMint),
     /**
-     * @param {*} issuerNameSingular For example, 'moola', or 'simolean'
-     * @param  {[AssetKind?, DisplayInfo?]} issuerArgs
+     * @param {any} issuerNameSingular For example, 'moola', or 'simolean'
+     * @param {[AssetKind?, DisplayInfo?]} issuerArgs
      */
     makeMintAndIssuer: (issuerNameSingular, ...issuerArgs) => {
       notForProductionUse();

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

@@ -1 +1 @@
-{"version":3,"file":"vat-provisioning.d.ts","sourceRoot":"","sources":["vat-provisioning.js"],"names":[],"mappings":"AA8EA;;;;GAIG;AACH,4CAJW,OAAO,kBACP,OAAO;kBAqBL,KAAK,aAAa,CAAC,KACnB,YAAY,KACZ,QAAQ;gCASR,MAAM,WACN,MAAM,cACN,MAAM,EAAE;;;;;;;;kBAbR,KAAK,aAAa,CAAC,KACnB,YAAY,KACZ,QAAQ;gCASR,MAAM,WACN,MAAM,cACN,MAAM,EAAE;;;;;;;GAsDpB"}
+{"version":3,"file":"vat-provisioning.d.ts","sourceRoot":"","sources":["vat-provisioning.js"],"names":[],"mappings":"AAmFA;;;;GAIG;AACH,4CAJW,OAAO,kBACP,OAAO;kBAqBL,KAAK,aAAa,CAAC,KACnB,YAAY,KACZ,QAAQ;gCASR,MAAM,WACN,MAAM,cACN,MAAM,EAAE;;;;;;;;kBAbR,KAAK,aAAa,CAAC,KACnB,YAAY,KACZ,QAAQ;gCASR,MAAM,WACN,MAAM,cACN,MAAM,EAAE;;;;;;;GAsDpB"}

package/src/vat-provisioning.js

@@ -20,7 +20,11 @@ import {
 const prepareSpecializedNameAdmin = zone => {
   const mixinMyAddress = prepareMixinMyAddress(zone);
 
-  /** @type {import('@agoric/internal/src/callback.js').MakeAttenuator<import('./types.js').NamesByAddressAdmin>} */
+  /**
+   * @type {import('@agoric/internal/src/callback.js').MakeAttenuator<
+   *   import('./types.js').NamesByAddressAdmin
+   * >}
+   */
   const specialize = prepareGuardedAttenuator(zone, NameHubIKit.nameAdmin, {
     tag: 'NamesByAddressAdmin',
   });
@@ -34,7 +38,10 @@ const prepareSpecializedNameAdmin = zone => {
       /**
        * @param {string} address
        * @param {string[]} [reserved]
-       * @returns {Promise<{ nameHub: NameHub, nameAdmin: import('./types.js').MyAddressNameAdmin}>}
+       * @returns {Promise<{
+       *   nameHub: NameHub;
+       *   nameAdmin: import('./types.js').MyAddressNameAdmin;
+       * }>}
        */
       async provideChild(address, reserved) {
         const { nameAdmin } = this.state;
@@ -50,7 +57,7 @@ const prepareSpecializedNameAdmin = zone => {
         // XXX relies on callers not to provide other admins via update()
         // TODO: enforce?
 
-        /** @type { import('./types').MyAddressNameAdmin } */
+        /** @type {import('./types').MyAddressNameAdmin} */
         // eslint-disable-next-line @typescript-eslint/prefer-ts-expect-error
         // @ts-ignore cast
         const myAdmin = nameAdmin.lookupAdmin(address);
@@ -59,9 +66,7 @@ const prepareSpecializedNameAdmin = zone => {
     },
   );
 
-  /**
-   * @param {import('./types.js').NameAdmin} nameAdmin
-   */
+  /** @param {import('./types.js').NameAdmin} nameAdmin */
   const makeMyAddressNameAdmin = nameAdmin => {
     const overrideFacet = makeOverrideFacet(nameAdmin);
     return specialize({

package/src/virtual-purse.d.ts

@@ -44,20 +44,20 @@ export type Retain = (pmt: Payment, optAmountShape?: Pattern) => Promise<Amount>
 export type Redeem = (amt: Amount) => Promise<Payment>;
 /**
  * The object that determines the
- * remote behaviour of a virtual purse.
+ *   remote behaviour of a virtual purse.
  */
 export type VirtualPurseController = {
     /**
      * Tell the controller
-     * to send an amount from "us" to the "other side".  This should resolve on
-     * success and reject on failure.  IT IS IMPORTANT NEVER TO FAIL in normal
-     * operation.  That will irrecoverably lose assets.
+     * to send an amount from "us" to the "other side". This should resolve on
+     * success and reject on failure. IT IS IMPORTANT NEVER TO FAIL in normal
+     * operation. That will irrecoverably lose assets.
      */
     pushAmount: (amount: Amount) => Promise<void>;
     /**
      * Tell the controller
-     * to send an amount from the "other side" to "us".  This should resolve on
-     * success and reject on failure.  We can still recover assets from failure to
+     * to send an amount from the "other side" to "us". This should resolve on
+     * success and reject on failure. We can still recover assets from failure to
      * pull.
      */
     pullAmount: (amount: Amount) => Promise<void>;

package/src/virtual-purse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-purse.d.ts","sourceRoot":"","sources":["virtual-purse.js"],"names":[],"mappings":"AAsBO,qDAHI,OAAO,gBACP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6DjB;AA+LM,0CAFI,OAAO,cAAc,EAAE,IAAI,SAMzB,KAAK,sBAAsB,CAAC;YAElB,KAAK,MAAM,CAAC;WAAS,KAAK;;;MASlC,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,CAwB5C;uBAlOY,OAAO,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;2BAGrB,OAAO,mBAAmB,OAAO,KAAK,QAAQ,MAAM,CAAC;2BACrD,MAAM,KAAK,QAAQ,OAAO,CAAC;;;;;;;;;;;;yBAKxB,MAAM,KAAK,QAAQ,IAAI,CAAC;;;;;;;yBAIxB,MAAM,KAAK,QAAQ,IAAI,CAAC;;;;;yBAIzB,KAAK,KAAK,YAAY,MAAM,CAAC"}
+{"version":3,"file":"virtual-purse.d.ts","sourceRoot":"","sources":["virtual-purse.js"],"names":[],"mappings":"AAsBO,qDAHI,OAAO,gBACP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6DjB;AA2LM,0CADK,OAAO,cAAc,EAAE,IAAI,SAK1B,KAAK,sBAAsB,CAAC;YAG1B,KAAK,MAAM,CAAC;WACb,KAAK;;;MAWJ,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,CAyB5C;uBAnOY,OAAO,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;2BAGrB,OAAO,mBAAmB,OAAO,KAAK,QAAQ,MAAM,CAAC;2BACrD,MAAM,KAAK,QAAQ,OAAO,CAAC;;;;;;;;;;;;yBAKxB,MAAM,KAAK,QAAQ,IAAI,CAAC;;;;;;;yBAIxB,MAAM,KAAK,QAAQ,IAAI,CAAC;;;;;yBAIzB,KAAK,KAAK,YAAY,MAAM,CAAC"}

package/src/virtual-purse.js

@@ -91,30 +91,28 @@ export const makeVirtualPurseKitIKit = (
 
 /**
  * @typedef {object} VirtualPurseController The object that determines the
- * remote behaviour of a virtual purse.
+ *   remote behaviour of a virtual purse.
  * @property {(amount: Amount) => Promise<void>} pushAmount Tell the controller
- * to send an amount from "us" to the "other side".  This should resolve on
- * success and reject on failure.  IT IS IMPORTANT NEVER TO FAIL in normal
- * operation.  That will irrecoverably lose assets.
+ *   to send an amount from "us" to the "other side". This should resolve on
+ *   success and reject on failure. IT IS IMPORTANT NEVER TO FAIL in normal
+ *   operation. That will irrecoverably lose assets.
  * @property {(amount: Amount) => Promise<void>} pullAmount Tell the controller
- * to send an amount from the "other side" to "us".  This should resolve on
- * success and reject on failure.  We can still recover assets from failure to
- * pull.
+ *   to send an amount from the "other side" to "us". This should resolve on
+ *   success and reject on failure. We can still recover assets from failure to
+ *   pull.
  * @property {(brand: Brand) => LatestTopic<Amount>} getBalances Return the
- * current balance iterable for a given brand.
+ *   current balance iterable for a given brand.
  */
 
-/**
- * @param {import('@agoric/zone').Zone} zone
- */
+/** @param {import('@agoric/zone').Zone} zone */
 const prepareVirtualPurseKit = zone =>
   zone.exoClassKit(
     'VirtualPurseKit',
     makeVirtualPurseKitIKit().VirtualPurseIKit,
     /**
      * @param {ERef<VirtualPurseController>} vpc
-     * @param {{ issuer: ERef<Issuer>, brand: Brand, mint?: ERef<Mint> }} issuerKit
-     * @param {{ recoveryPurse: ERef<Purse>, escrowPurse?: ERef<Purse> }} purses
+     * @param {{ issuer: ERef<Issuer>; brand: Brand; mint?: ERef<Mint> }} issuerKit
+     * @param {{ recoveryPurse: ERef<Purse>; escrowPurse?: ERef<Purse> }} purses
      */
     (vpc, issuerKit, purses) => ({
       vpc,
@@ -127,9 +125,9 @@ const prepareVirtualPurseKit = zone =>
     {
       utils: {
         /**
-         * Claim a payment for recovery via our `recoveryPurse`.  No need for this on
-         * the `retain` operations (since we are just burning the payment or
-         * depositing it directly in the `escrowPurse`).
+         * Claim a payment for recovery via our `recoveryPurse`. No need for
+         * this on the `retain` operations (since we are just burning the
+         * payment or depositing it directly in the `escrowPurse`).
          *
          * @param {ERef<Payment>} payment
          * @param {Amount} [optAmountShape]
@@ -267,28 +265,31 @@ const prepareVirtualPurseKit = zone =>
     },
   );
 
-/**
- * @param {import('@agoric/zone').Zone} zone
- */
+/** @param {import('@agoric/zone').Zone} zone */
 export const prepareVirtualPurse = zone => {
   const makeVirtualPurseKit = prepareVirtualPurseKit(zone);
 
   /**
-   * @param {ERef<VirtualPurseController>} vpc the controller that represents the
-   * "other side" of this purse.
-   * @param {{ issuer: ERef<Issuer>, brand: Brand, mint?: ERef<Mint>,
-   * escrowPurse?: ERef<Purse> }} params
-   * the contents of the issuer kit for "us".
+   * @param {ERef<VirtualPurseController>} vpc the controller that represents
+   *   the "other side" of this purse.
+   * @param {{
+   *   issuer: ERef<Issuer>;
+   *   brand: Brand;
+   *   mint?: ERef<Mint>;
+   *   escrowPurse?: ERef<Purse>;
+   * }} params
+   *   the contents of the issuer kit for "us".
    *
-   * If the mint is not specified, then the virtual purse will escrow local assets
-   * instead of minting/burning them.  That is a better option in general, but
-   * escrow doesn't support the case where the "other side" is also minting
-   * assets... our escrow purse may not have enough assets in it to redeem the
-   * ones that are sent from the "other side".
-   * @returns {Promise<Awaited<EOnly<Purse>>>} This is not just a Purse because it plays
-   * fast-and-loose with the synchronous Purse interface.  So, the consumer of
-   * this result must only interact with the virtual purse via eventual-send (to
-   * conceal the methods that are returning promises instead of synchronously).
+   *   If the mint is not specified, then the virtual purse will escrow local
+   *   assets instead of minting/burning them. That is a better option in
+   *   general, but escrow doesn't support the case where the "other side" is
+   *   also minting assets... our escrow purse may not have enough assets in it
+   *   to redeem the ones that are sent from the "other side".
+   * @returns {Promise<Awaited<EOnly<Purse>>>} This is not just a Purse because
+   *   it plays fast-and-loose with the synchronous Purse interface. So, the
+   *   consumer of this result must only interact with the virtual purse via
+   *   eventual-send (to conceal the methods that are returning promises instead
+   *   of synchronously).
    */
   const makeVirtualPurse = async (
     vpc,

package/src/walletFlags.js

@@ -1,7 +1,6 @@
 // XXX domain of @agoric/cosmic-proto
 /**
- * non-exhaustive list of powerFlags
- * REMOTE_WALLET is currently a default.
+ * non-exhaustive list of powerFlags REMOTE_WALLET is currently a default.
  *
  * See also MsgProvision in golang/cosmos/proto/agoric/swingset/msgs.proto
  */

package/tools/authorityViz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authorityViz.d.ts","sourceRoot":"","sources":["authorityViz.js"],"names":[],"mappings":";wBA6Ba;IACZ,EAAM,EAAE,MAAM,CAAC;IACf,OAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAS,EAAE,MAAM,CAAC;IAClB,KAAS,CAAC,EAAE,MAAM,CAAC;CAChB;qBAiCU,IAAI,IAAG;IACpB,aAAiB,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,SAAa,CAAC,EAAE,OAAO,MAAM,EAAE,IAAI,CAAC,CAAA;IACpC,IAAQ,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,OAAW,CAAC,EAAE,OAAO,MAAM,EAAE,IAAI,CAAC,CAAA;IAClC,IAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAS,CAAC,EAAE,UAAU,CAAC;IACvB,WAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,YAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,QAAY,CAAC,EAAE,UAAU,CAAC;CACvB,GAAG,UAAU,CAAA;yBACJ;IAAC,OAAO,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAA;CAAC;qBACnE,OAAO,GAAG,OAAO;sBACjB,MAAM;mCA0IK,MAAM,UAAU,MAAM,KAAK,QAAQ,MAAM,CAAC"}
+{"version":3,"file":"authorityViz.d.ts","sourceRoot":"","sources":["authorityViz.js"],"names":[],"mappings":";wBA8Ba;IACZ,EAAM,EAAE,MAAM,CAAC;IACf,OAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAS,EAAE,MAAM,CAAC;IAClB,KAAS,CAAC,EAAE,MAAM,CAAC;CAChB;qBAkCW,IAAI,GACZ,CAAC;IACP,aAAqB,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,SAAiB,CAAC,EAAE,OAAO,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,IAAY,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAe,CAAC,EAAE,OAAO,MAAM,EAAE,IAAI,CAAC,CAAC;IACvC,IAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,MAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,KAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,WAAmB,CAAC,EAAE,UAAU,CAAC;IACjC,YAAoB,CAAC,EAAE,UAAU,CAAC;IAClC,QAAgB,CAAC,EAAE,UAAU,CAAC;CACvB,GAAG,UAAU,CAAC;yBAET;IACZ,OAAW,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAW,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;qBAES,OAAO,GAAG,OAAO;sBAEjB,MAAM;mCA0IM,MAAM,UAAU,MAAM,KAAK,QAAQ,MAAM,CAAC"}

package/tools/authorityViz.js

@@ -25,13 +25,14 @@ const styles = {
 
 /**
  * @param {Set<GraphNode>} nodes
- * @param {Map<string, Set<{ id: string, style?: string }>>} neighbors
- * @yields { string }
+ * @param {Map<string, Set<{ id: string; style?: string }>>} neighbors
+ * @yields {string}
+ *
  * @typedef {{
- *   id: string,
- *   cluster?: string,
- *   label: string,
- *   style?: string,
+ *   id: string;
+ *   cluster?: string;
+ *   label: string;
+ *   style?: string;
  * }} GraphNode
  */
 function* fmtGraph(nodes, neighbors) {
@@ -65,24 +66,32 @@ function* fmtGraph(nodes, neighbors) {
 
 /**
  * @param {Record<string, Permit>} manifest
- * @typedef { true | {
- *   vatParameters?: Record<string, Permit>,
- *   vatPowers?: Record<string, true>
- *   vats?: Record<string, Status>
- *   devices?: Record<string, true>
- *   home?: PowerSpace,
- *   issuer?: PowerSpace,
- *   brand?: PowerSpace,
- *   oracleBrand?: PowerSpace,
- *   installation?: PowerSpace,
- *   instance?: PowerSpace,
- * } & PowerSpace } Permit
- * @typedef {{produce?: Record<string, Status>, consume?: Record<string, Status>}} PowerSpace
- * @typedef { boolean | VatName } Status
- * @typedef { string } VatName
+ *
+ * @typedef {| true
+ *   | ({
+ *       vatParameters?: Record<string, Permit>;
+ *       vatPowers?: Record<string, true>;
+ *       vats?: Record<string, Status>;
+ *       devices?: Record<string, true>;
+ *       home?: PowerSpace;
+ *       issuer?: PowerSpace;
+ *       brand?: PowerSpace;
+ *       oracleBrand?: PowerSpace;
+ *       installation?: PowerSpace;
+ *       instance?: PowerSpace;
+ *     } & PowerSpace)} Permit
+ *
+ * @typedef {{
+ *   produce?: Record<string, Status>;
+ *   consume?: Record<string, Status>;
+ * }} PowerSpace
+ *
+ * @typedef {boolean | VatName} Status
+ *
+ * @typedef {string} VatName
  */
 const manifest2graph = manifest => {
-  /** @type { Set<GraphNode> } */
+  /** @type {Set<GraphNode>} */
   const nodes = new Set();
   const neighbors = new Map();
 
@@ -212,9 +221,9 @@ const loadConfig = async (specifier, { resolve, readFile }) => {
  * @param {typeof import('process').stdout} io.stdout
  * @param {typeof import('fs/promises')} io.fsp
  * @param {{
- *   resolve: Resolver,
- *   url: string,
- *   load: (specifier: string) => Promise<Record<string, any>>,
+ *   resolve: Resolver;
+ *   url: string;
+ *   load: (specifier: string) => Promise<Record<string, any>>;
  * }} io.meta
  *
  * @typedef {(specifier: string, parent: string) => Promise<string>} Resolver

package/tools/bank-utils.d.ts

@@ -1,4 +1,4 @@
-export function makeFakeBankKit(issuerKits: Array<Pick<IssuerKit, 'brand' | 'issuer'>>): {
+export function makeFakeBankKit(issuerKits: Pick<IssuerKit, 'brand' | 'issuer'>[]): {
     addAsset: (denom: string, issuerName: string, proposedName: string, kit: import('../src/vat-bank.js').AssetIssuerKit) => void;
     assetPublication: IterationObserver<import("../src/vat-bank.js").AssetDescriptor>;
     bank: import("../src/vat-bank.js").Bank;

package/tools/bank-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bank-utils.d.ts","sourceRoot":"","sources":["bank-utils.js"],"names":[],"mappings":"AASO,4CAFI,MAAM,KAAK,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;sBAmBxC,MAAM,cACN,MAAM,gBACN,MAAM,OACN,OAAO,oBAAoB,EAAE,cAAc;;;EAqBvD"}
+{"version":3,"file":"bank-utils.d.ts","sourceRoot":"","sources":["bank-utils.js"],"names":[],"mappings":"AAOO,4CADK,KAAK,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC,EAAE;sBA2BpC,MAAM,cACN,MAAM,gBACN,MAAM,OACN,OAAO,oBAAoB,EAAE,cAAc;;;EAqBvD"}