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

package/src/core/demoIssuers.js

@@ -25,7 +25,7 @@ export const DecimalPlaces = {
   simolean: 0,
 };
 
-/** @type {Record<string, { proposedName: string, balance: bigint}>} */
+/** @type {Record<string, { proposedName: string; balance: bigint }>} */
 const FaucetPurseDetail = {
   [Stake.symbol]: {
     proposedName: Stake.proposedName,
@@ -92,19 +92,21 @@ const defaultConfig = /** @type {const} */ ({
 
 /**
  * @typedef {readonly [bigint, bigint]} Rational
- *
- * @type { Record<string, {
- *   config?: {
- *     collateralValue: bigint,
- *     initialMargin: Rational,
- *     liquidationMargin: Rational,
- *     liquidationPenalty: Rational,
- *     stabilityFee: Rational,
- *     mintFee: Rational,
- *     liquidationPadding?: Rational,
- *   },
- *   trades: Array<{ central: number, collateral: bigint}>
- * }>}
+ * @type {Record<
+ *   string,
+ *   {
+ *     config?: {
+ *       collateralValue: bigint;
+ *       initialMargin: Rational;
+ *       liquidationMargin: Rational;
+ *       liquidationPenalty: Rational;
+ *       stabilityFee: Rational;
+ *       mintFee: Rational;
+ *       liquidationPadding?: Rational;
+ *     };
+ *     trades: { central: number; collateral: bigint }[];
+ *   }
+ * >}
  */
 export const AMMDemoState = {
   // TODO: getRUN makes BLD obsolete here
@@ -182,9 +184,9 @@ const run2places = f =>
 /**
  * @param {bigint} value
  * @param {{
- *   centralSupplyInstall: ERef<Installation>,
- *   feeMintAccess: ERef<FeeMintAccess>,
- *   zoe: ERef<ZoeService>,
+ *   centralSupplyInstall: ERef<Installation>;
+ *   feeMintAccess: ERef<FeeMintAccess>;
+ *   zoe: ERef<ZoeService>;
  * }} powers
  * @returns {Promise<Payment<'nat'>>}
  */
@@ -216,17 +218,15 @@ const provideCoin = async (name, mints) => {
 };
 
 /**
- * @param { BootstrapSpace &
- *   { consume: {loadVat: VatLoader<MintsVat>} }
- * } powers
+ * @param {BootstrapSpace & { consume: { loadVat: VatLoader<MintsVat> } }} powers
+ *   TODO: sync this type with end-user docs?
  *
- * TODO: sync this type with end-user docs?
  * @typedef {{
- *   issuer: ERef<Issuer>,
- *   issuerPetname: string,
- *   payment: Payment,
- *   brand: Brand,
- *   pursePetname: string,
+ *   issuer: ERef<Issuer>;
+ *   issuerPetname: string;
+ *   payment: Payment;
+ *   brand: Brand;
+ *   pursePetname: string;
  * }} UserPaymentRecord
  */
 export const connectFaucet = async ({
@@ -334,7 +334,7 @@ export const connectFaucet = async ({
       /**
        * reap the spoils of our on-chain provisioning.
        *
-       * @returns {Promise<Array<UserPaymentRecord>>}
+       * @returns {Promise<UserPaymentRecord[]>}
        */
       tapFaucet: async () => faucetPaymentInfo,
       getFeePurse() {
@@ -389,7 +389,7 @@ export const ammPoolRunDeposits = issuers => {
 /**
  * @param {Payment} bootstrapPayment
  * @param {Record<string, bigint>} balances
- * @param {{ issuer: ERef<Issuer>, brand: Brand }} central
+ * @param {{ issuer: ERef<Issuer>; brand: Brand }} central
  */
 export const splitAllCentralPayments = async (
   bootstrapPayment,
@@ -421,9 +421,9 @@ export const splitAllCentralPayments = async (
 
 /**
  * @param {string} issuerName
- * @param {typeof AMMDemoState['ATOM']} record
- * @param {Record<string, { issuer: ERef<Issuer>, brand: Brand }>} kits
- * @param {{ issuer: ERef<Issuer<'nat'>>, brand: Brand<'nat'> }} central
+ * @param {(typeof AMMDemoState)['ATOM']} record
+ * @param {Record<string, { issuer: ERef<Issuer>; brand: Brand }>} kits
+ * @param {{ issuer: ERef<Issuer<'nat'>>; brand: Brand<'nat'> }} central
  */
 export const poolRates = (issuerName, record, kits, central) => {
   /** @param {bigint} n */
@@ -462,7 +462,7 @@ export const poolRates = (issuerName, record, kits, central) => {
 };
 
 /**
- * @param { import('@agoric/inter-protocol/src/proposals/econ-behaviors.js').EconomyBootstrapPowers & {
- *   consume: { mints }
- * }} powers
+ * @param {import('@agoric/inter-protocol/src/proposals/econ-behaviors.js').EconomyBootstrapPowers & {
+ *     consume: { mints };
+ *   }} powers
  */

package/src/core/lib-boot.d.ts

@@ -78,16 +78,17 @@ export type BootstrapManifestPermit = string | true | {
     [key: string]: BootstrapManifestPermit | undefined;
 };
 /**
- * A manifest is an object in which each key is the name of a function to run
- * at bootstrap and the corresponding value is a "permit" describing an
- * attenuation of allPowers that should be provided as its first argument
- * (cf. packages/vats/src/core/boot.js).
+ * A manifest is an object in which each key is the name of a function to run at
+ * bootstrap and the corresponding value is a "permit" describing an attenuation
+ * of allPowers that should be provided as its first argument (cf.
+ * packages/vats/src/core/boot.js).
  *
  * A permit is either
- * - `true` or a string (both meaning no attenuation, with a string serving
- *   as a grouping label for convenience and diagram generation), or
- * - an object whose keys identify properties to preserve and whose values
- *   are themselves (recursive) permits.
+ *
+ * - `true` or a string (both meaning no attenuation, with a string serving as a
+ *   grouping label for convenience and diagram generation), or
+ * - an object whose keys identify properties to preserve and whose values are
+ *   themselves (recursive) permits.
  */
 export type BootstrapManifest = Record<string, BootstrapManifestPermit>;
 export type BootBehavior = (powers: any, config?: any) => Promise<void>;

package/src/core/lib-boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib-boot.d.ts","sourceRoot":"","sources":["lib-boot.js"],"names":[],"mappings":"AAqDO;OATC,MAAM;0BACQ,IAAI;kBAEf,OAAO,MAAM,EAAE,OAAO,CAAC,gBACvB,iBAAiB,aACjB,OAAO,MAAM,EAAE,YAAY,CAAC,WAC5B,WAAW;IA8GlB;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;IAuDrC;;;OAGG;;;IA9DH;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;IAuDrC;;;OAGG;;GAIN;;;;;;;;;;;;;;;;gCArMY,OAAO,MAAM,EAAE,uBAAuB,CAAC;0DAKZ,QAAQ,IAAI,CAAC;8BACxC,OAAO,MAAM,EAAE,OAAO,CAAC;0BACvB;IAAE,KAAK,EAAE,cAAc,YAAY,CAAC,CAAA;CAAE,GAAG,OAAO,MAAM,EAAE,OAAO,MAAM,EAAE,GAAG,CAAC,CAAC"}
+{"version":3,"file":"lib-boot.d.ts","sourceRoot":"","sources":["lib-boot.js"],"names":[],"mappings":"AA4DO;OATC,MAAM;0BACQ,IAAI;kBAEf,OAAO,MAAM,EAAE,OAAO,CAAC,gBACvB,iBAAiB,aACjB,OAAO,MAAM,EAAE,YAAY,CAAC,WAC5B,WAAW;IAkHlB;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;IAuDrC;;;OAGG;;;IA9DH;;;;;OAKG;sBAFQ,YAAY,WACZ,WAAW,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;IAuDrC;;;OAGG;;GAIN;;;;;;;;;;;;;;;;;gCA7MY,OAAO,MAAM,EAAE,uBAAuB,CAAC;oCAI9B,GAAG,WAAW,GAAG,KAAK,QAAQ,IAAI,CAAC;8BAE5C,OAAO,MAAM,EAAE,OAAO,CAAC;0BAEvB;IAAE,KAAK,EAAE,cAAc,YAAY,CAAC,CAAA;CAAE,GAAG,OACrD,MAAU,EACV,OAAW,MAAM,EAAE,GAAG,CAAC,CACpB"}

package/src/core/lib-boot.js

@@ -12,29 +12,36 @@ import { makePromiseSpace } from './promise-space.js';
 const { Fail, quote: q } = assert;
 
 /**
- * @typedef {true | string | { [key: string]: BootstrapManifestPermit | undefined }} BootstrapManifestPermit
+ * @typedef {| true
+ *   | string
+ *   | { [key: string]: BootstrapManifestPermit | undefined }} BootstrapManifestPermit
  */
 
 /**
- * A manifest is an object in which each key is the name of a function to run
- * at bootstrap and the corresponding value is a "permit" describing an
- * attenuation of allPowers that should be provided as its first argument
- * (cf. packages/vats/src/core/boot.js).
+ * A manifest is an object in which each key is the name of a function to run at
+ * bootstrap and the corresponding value is a "permit" describing an attenuation
+ * of allPowers that should be provided as its first argument (cf.
+ * packages/vats/src/core/boot.js).
  *
  * A permit is either
- * - `true` or a string (both meaning no attenuation, with a string serving
- *   as a grouping label for convenience and diagram generation), or
- * - an object whose keys identify properties to preserve and whose values
- *   are themselves (recursive) permits.
  *
- * @typedef {Record<string, BootstrapManifestPermit>} BootstrapManifest
+ * - `true` or a string (both meaning no attenuation, with a string serving as a
+ *   grouping label for convenience and diagram generation), or
+ * - an object whose keys identify properties to preserve and whose values are
+ *   themselves (recursive) permits.
  *
+ * @typedef {Record<string, BootstrapManifestPermit>} BootstrapManifest
  */
 
 /**
- * @typedef {(powers: *, config?: *) => Promise<void>} BootBehavior
+ * @typedef {(powers: any, config?: any) => Promise<void>} BootBehavior
+ *
  * @typedef {Record<string, unknown>} ModuleNamespace
- * @typedef {{ utils: typeof import('./utils.js') } & Record<string, Record<string, any>>} BootModules
+ *
+ * @typedef {{ utils: typeof import('./utils.js') } & Record<
+ *   string,
+ *   Record<string, any>
+ * >} BootModules
  */
 
 /** @type {<X>(a: X[], b: X[]) => X[]} */
@@ -42,8 +49,8 @@ const setDiff = (a, b) => a.filter(x => !b.includes(x));
 
 /**
  * @param {VatPowers & {
- *   D: DProxy,
- *   logger: (msg) => void,
+ *   D: DProxy;
+ *   logger: (msg) => void;
  * }} vatPowers
  * @param {Record<string, unknown>} vatParameters
  * @param {BootstrapManifest} bootManifest
@@ -147,7 +154,11 @@ export const makeBootstrap = (
         },
       ],
     };
-    /** @type {{coreEvalBridgeHandler: Promise<import('../types.js').BridgeHandler>}} */
+    /**
+     * @type {{
+     *   coreEvalBridgeHandler: Promise<import('../types.js').BridgeHandler>;
+     * }}
+     */
     // @ts-expect-error cast
     const { coreEvalBridgeHandler } = consume;
     await E(coreEvalBridgeHandler).fromBridge(coreEvalMessage);

package/src/core/promise-space.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promise-space.d.ts","sourceRoot":"","sources":["promise-space.js"],"names":[],"mappings":"AAqBO,kCAHK,OAAO,QAAQ,GAAG,GACjB,iBAAiB,CAS1B;AAUG,sCAJI,SAAS,MAAM,EAAE,QAAQ,CAAC;;;gBAExB,iBAAiB,CAkC7B;AAcM;;;;;;;;;;;WAJsC,SAAS,MAAM,EAAE,GAAG,CAAC;4CA2GjE;;oBAnLoB,MAAM,KAAK,IAAI;qBACd,MAAM,SAAS,KAAK,OAAO,CAAC,KAAK,IAAI;qBACrC,MAAM,aAAa,IAAI,MAAM,CAAC,KAAK,IAAI;mBACzC,MAAM,KAAK,IAAI"}
+{"version":3,"file":"promise-space.d.ts","sourceRoot":"","sources":["promise-space.js"],"names":[],"mappings":"AAqBO,kCAHI,OAAO,QAAQ,GAAG,GAChB,iBAAiB,CAS1B;AAUG,sCAJI,SAAS,MAAM,EAAE,QAAQ,CAAC;;;gBAExB,iBAAiB,CAkC7B;AAgBM;;;;;;;;;;;WALa,SAAS,MAAM,EAAE,GAAG,CAAC;4CA0GxC;;oBAnLoB,MAAM,KAAK,IAAI;qBACd,MAAM,SAAS,KAAK,OAAO,CAAC,KAAK,IAAI;qBACrC,MAAM,aAAa,IAAI,MAAM,CAAC,KAAK,IAAI;mBACzC,MAAM,KAAK,IAAI"}

package/src/core/promise-space.js

@@ -6,17 +6,17 @@ import { makePromiseKit } from '@endo/promise-kit';
 
 /**
  * @typedef {{
- *   onAddKey: (key: string) => void,
- *   onResolve: (key: string, value: ERef<unknown>) => void,
- *   onSettled: (key: string, remaining: Set<string>) => void,
- *   onReset: (key: string) => void,
+ *   onAddKey: (key: string) => void;
+ *   onResolve: (key: string, value: ERef<unknown>) => void;
+ *   onSettled: (key: string, remaining: Set<string>) => void;
+ *   onReset: (key: string) => void;
  * }} PromiseSpaceHooks
  */
 
 const noop = harden(() => {});
 
 /**
- * @param { typeof console.log } log
+ * @param {typeof console.log} log
  * @returns {PromiseSpaceHooks}
  */
 export const makeLogHooks = log =>
@@ -29,11 +29,11 @@ export const makeLogHooks = log =>
   });
 
 /**
- * Note: caller is responsible for synchronization
- * in case of onResolve() called with a promise.
+ * Note: caller is responsible for synchronization in case of onResolve() called
+ * with a promise.
  *
  * @param {MapStore<string, Passable>} store
- * @param { typeof console.log } [log]
+ * @param {typeof console.log} [log]
  * @returns {PromiseSpaceHooks}
  */
 export const makeStoreHooks = (store, log = noop) => {
@@ -77,9 +77,11 @@ export const makeStoreHooks = (store, log = noop) => {
  * Note: repeated resolve()s without an intervening reset() are noops.
  *
  * @template {Record<string, unknown>} [T=Record<string, unknown>]
- * @param {{ log?: typeof console.log } & (
- *  { hooks?: PromiseSpaceHooks } | { store: MapStore<string, any> }
- * ) | (typeof console.log)} [optsOrLog]
+ * @param {| ({ log?: typeof console.log } & (
+ *       | { hooks?: PromiseSpaceHooks }
+ *       | { store: MapStore<string, any> }
+ *     ))
+ *   | typeof console.log} [optsOrLog]
  * @returns {PromiseSpaceOf<T>}
  */
 export const makePromiseSpace = (optsOrLog = {}) => {
@@ -91,9 +93,7 @@ export const makePromiseSpace = (optsOrLog = {}) => {
       : opts.hooks || makeLogHooks(log);
   const { onAddKey, onSettled, onResolve, onReset } = hooks;
 
-  /**
-   * @typedef {{ pk: PromiseRecord<any>, isSettling: boolean }} PromiseState
-   */
+  /** @typedef {{ pk: PromiseRecord<any>; isSettling: boolean }} PromiseState */
   /** @type {Map<string, PromiseState>} */
   const nameToState = new Map();
   /** @type {Set<string>} */

package/src/core/startWalletFactory.d.ts

@@ -133,7 +133,10 @@ export type WalletFactoryStartResult = Awaited<ReturnType<typeof startFactoryIns
 import { Stable } from '@agoric/inter-protocol/src/tokens.js';
 /**
  * @param {ERef<ZoeService>} zoe
- * @param {Installation<import('@agoric/smart-wallet/src/walletFactory').prepare>} inst
+ * @param {Installation<
+ *   import('@agoric/smart-wallet/src/walletFactory').prepare
+ * >} inst
+ *
  * @typedef {Awaited<ReturnType<typeof startFactoryInstance>>} WalletFactoryStartResult
  */
 declare function startFactoryInstance(zoe: ERef<ZoeService>, inst: Installation<(zcf: ZCF<import("@agoric/smart-wallet/src/walletFactory").SmartWalletContractTerms>, privateArgs: {

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

@@ -1 +1 @@
-{"version":3,"file":"startWalletFactory.d.ts","sourceRoot":"","sources":["startWalletFactory.js"],"names":[],"mappings":"AAyEO;;;;;;;;;;;;;;;;;mCAd6B,OAAO,qCAAqC,EAAE,+BAA+B;oBAC5F;QACpB,YAAkB,EAAE,QAAQ,WAAW,oEAA6D,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QACjI,UAAgB,EAAE,UAAU,CAAC;KACxB;yBACoB,OAAO,aAAa,EAAE,mBAAmB;kCAChC,OAAO,aAAa,EAAE,mBAAmB;;;;;8BAqL3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCE;AAEK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWN;uCAxRY,QAAQ,WAAW,2BAA2B,CAAC,CAAC;uBAZtC,sCAAsC;AAS7D;;;;GAIG;AAEH,2CALW,KAAK,UAAU,CAAC,QAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAIX"}
+{"version":3,"file":"startWalletFactory.d.ts","sourceRoot":"","sources":["startWalletFactory.js"],"names":[],"mappings":"AAkFO;;;;;;;;;;;;;;;;;mCAlB+B,OAAO,qCAAqC,EAAE,+BAA+B;oBAC5F;QACtB,YAAoB,EAAE,QACtB,WACA,oEAAyE,SAAS,CAAC,CACxE,CACF,CAAC,cAAc,CAAC,CAAC;QAC1B,UAAkB,EAAE,UAAU,CAAC;KACxB;yBACoB,OAAO,aAAa,EAAE,mBAAmB;kCAChC,OAAO,aAAa,EAAE,mBAAmB;;;;;8BAqL7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCE;AAEK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWN;uCA9RY,QAAQ,WAAW,2BAA2B,CAAC,CAAC;uBAftC,sCAAsC;AAS7D;;;;;;;GAOG;AAEH,2CARW,KAAK,UAAU,CAAC,QAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKkE"}

package/src/core/startWalletFactory.js

@@ -17,7 +17,10 @@ const trace = makeTracer('StartWF');
 
 /**
  * @param {ERef<ZoeService>} zoe
- * @param {Installation<import('@agoric/smart-wallet/src/walletFactory').prepare>} inst
+ * @param {Installation<
+ *   import('@agoric/smart-wallet/src/walletFactory').prepare
+ * >} inst
+ *
  * @typedef {Awaited<ReturnType<typeof startFactoryInstance>>} WalletFactoryStartResult
  */
 // eslint-disable-next-line no-unused-vars
@@ -26,8 +29,8 @@ const startFactoryInstance = (zoe, inst) => E(zoe).startInstance(inst);
 const StableUnit = BigInt(10 ** Stable.displayInfo.decimalPlaces);
 
 /**
- * Publish an arbitrary wallet state so that clients
- * can tell that a wallet has been provisioned.
+ * Publish an arbitrary wallet state so that clients can tell that a wallet has
+ * been provisioned.
  *
  * @param {string[]} oldAddresses
  * @param {Marshaller} marshaller
@@ -53,22 +56,28 @@ const publishRevivableWalletState = async (
 };
 
 /**
- * Register for PLEASE_PROVISION bridge messages and handle
- * them by providing a smart wallet from the wallet factory.
+ * Register for PLEASE_PROVISION bridge messages and handle them by providing a
+ * smart wallet from the wallet factory.
  *
- * @param {BootstrapPowers & ChainStorageVatParams & PromiseSpaceOf<{
- *   economicCommitteeCreatorFacet: import('@agoric/governance/src/committee.js').CommitteeElectorateCreatorFacet
- *   econCharterKit: {
- *     creatorFacet: Awaited<ReturnType<import('@agoric/inter-protocol/src/econCommitteeCharter.js')['prepare']>>['creatorFacet'],
- *     adminFacet: AdminFacet,
- *   } ,
- *   walletBridgeManager: import('../types.js').ScopedBridgeManager;
- *   provisionWalletBridgeManager: import('../types.js').ScopedBridgeManager;
- * }>} powers
+ * @param {BootstrapPowers &
+ *   ChainStorageVatParams &
+ *   PromiseSpaceOf<{
+ *     economicCommitteeCreatorFacet: import('@agoric/governance/src/committee.js').CommitteeElectorateCreatorFacet;
+ *     econCharterKit: {
+ *       creatorFacet: Awaited<
+ *         ReturnType<
+ *           import('@agoric/inter-protocol/src/econCommitteeCharter.js')['prepare']
+ *         >
+ *       >['creatorFacet'];
+ *       adminFacet: AdminFacet;
+ *     };
+ *     walletBridgeManager: import('../types.js').ScopedBridgeManager;
+ *     provisionWalletBridgeManager: import('../types.js').ScopedBridgeManager;
+ *   }>} powers
  * @param {{
  *   options?: {
- *     perAccountInitialValue?: bigint,
- *   },
+ *     perAccountInitialValue?: bigint;
+ *   };
  * }} [config]
  */
 export const startWalletFactory = async (