@agoric/inter-protocol 0.16.2-dev-857e650.0 → 0.16.2-dev-fb922d3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/inter-protocol",
-  "version": "0.16.2-dev-857e650.0+857e650",
+  "version": "0.16.2-dev-fb922d3.0+fb922d3",
   "description": "Core cryptoeconomy contracts",
   "type": "module",
   "main": "src/index.js",
@@ -32,15 +32,15 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/assert": "0.6.1-dev-857e650.0+857e650",
-    "@agoric/ertp": "0.16.3-dev-857e650.0+857e650",
-    "@agoric/governance": "0.10.4-dev-857e650.0+857e650",
-    "@agoric/internal": "0.3.3-dev-857e650.0+857e650",
-    "@agoric/notifier": "0.6.3-dev-857e650.0+857e650",
-    "@agoric/store": "0.9.3-dev-857e650.0+857e650",
-    "@agoric/time": "0.3.3-dev-857e650.0+857e650",
-    "@agoric/vat-data": "0.5.3-dev-857e650.0+857e650",
-    "@agoric/zoe": "0.26.3-dev-857e650.0+857e650",
+    "@agoric/assert": "0.6.1-dev-fb922d3.0+fb922d3",
+    "@agoric/ertp": "0.16.3-dev-fb922d3.0+fb922d3",
+    "@agoric/governance": "0.10.4-dev-fb922d3.0+fb922d3",
+    "@agoric/internal": "0.3.3-dev-fb922d3.0+fb922d3",
+    "@agoric/notifier": "0.6.3-dev-fb922d3.0+fb922d3",
+    "@agoric/store": "0.9.3-dev-fb922d3.0+fb922d3",
+    "@agoric/time": "0.3.3-dev-fb922d3.0+fb922d3",
+    "@agoric/vat-data": "0.5.3-dev-fb922d3.0+fb922d3",
+    "@agoric/zoe": "0.26.3-dev-fb922d3.0+fb922d3",
     "@endo/captp": "^3.1.2",
     "@endo/eventual-send": "^0.17.3",
     "@endo/far": "^0.2.19",
@@ -49,12 +49,12 @@
     "jessie.js": "^0.3.2"
   },
   "devDependencies": {
-    "@agoric/deploy-script-support": "0.10.4-dev-857e650.0+857e650",
-    "@agoric/smart-wallet": "0.5.4-dev-857e650.0+857e650",
-    "@agoric/swingset-liveslots": "0.10.3-dev-857e650.0+857e650",
-    "@agoric/swingset-vat": "0.32.3-dev-857e650.0+857e650",
-    "@agoric/vats": "0.15.2-dev-857e650.0+857e650",
-    "@agoric/zone": "0.2.3-dev-857e650.0+857e650",
+    "@agoric/deploy-script-support": "0.10.4-dev-fb922d3.0+fb922d3",
+    "@agoric/smart-wallet": "0.5.4-dev-fb922d3.0+fb922d3",
+    "@agoric/swingset-liveslots": "0.10.3-dev-fb922d3.0+fb922d3",
+    "@agoric/swingset-vat": "0.32.3-dev-fb922d3.0+fb922d3",
+    "@agoric/vats": "0.15.2-dev-fb922d3.0+fb922d3",
+    "@agoric/zone": "0.2.3-dev-fb922d3.0+fb922d3",
     "@endo/bundle-source": "^2.5.2",
     "@endo/init": "^0.5.57",
     "@endo/promise-kit": "^0.2.57",
@@ -81,5 +81,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "857e6508f673ffb20e5efc409a3397616e31093d"
+  "gitHead": "fb922d3aeddd390919a015a76d5f4e035e6f0240"
 }

package/scripts/deploy-contracts.js

@@ -43,14 +43,24 @@ export default async (homeP, endowments) => {
   });
 
   console.log('getting installCache...');
-  /** @type {CopyMap<string, {installation: Installation, boardId: string, path?: string}>} */
+  /**
+   * @type {CopyMap<
+   *   string,
+   *   { installation: Installation; boardId: string; path?: string }
+   * >}
+   */
   const initial = await provideWhen(scratch, 'installCache', () =>
     makeCopyMap([]),
   );
   console.log('initially:', initial.payload.keys.length, 'entries');
 
   // ISSUE: getCopyMapEntries of CopyMap<K, V> loses K, V.
-  /** @type {Map<string, {installation: Installation, boardId: string, path?: string}>} */
+  /**
+   * @type {Map<
+   *   string,
+   *   { installation: Installation; boardId: string; path?: string }
+   * >}
+   */
   const working = new Map(getCopyMapEntries(initial));
 
   let added = 0;

package/scripts/init-core.js

@@ -1,7 +1,8 @@
 /* global process */
 /**
- * @file can be run with `agoric deploy` after a chain is running (depends on chain state)
- * Only works with "local" chain and not sim-chain b/c it needs governance votes (n/a on sim-chain).
+ * @file can be run with `agoric deploy` after a chain is running (depends on
+ *   chain state) Only works with "local" chain and not sim-chain b/c it needs
+ *   governance votes (n/a on sim-chain).
  */
 import { makeHelpers } from '@agoric/deploy-script-support';
 import { objectMap } from '@agoric/internal';
@@ -53,9 +54,8 @@ const installKeyGroups = {
  * @param {(i: I) => R} opts.publishRef
  * @param {(m: string, b: string, opts?: any) => I} opts.install
  * @param {<T>(f: T) => T} [opts.wrapInstall]
- *
  * @param {object} [options]
- * @param {{ committeeName?: string, committeeSize?: number}} [options.econCommitteeOptions]
+ * @param {{ committeeName?: string; committeeSize?: number }} [options.econCommitteeOptions]
  */
 export const committeeProposalBuilder = async (
   { publishRef, install: install0, wrapInstall },
@@ -85,7 +85,6 @@ export const committeeProposalBuilder = async (
 /**
  * @template I
  * @template R
- *
  * @param {object} opts
  * @param {(i: I) => R} opts.publishRef
  * @param {(m: string, b: string, opts?: any) => I} opts.install
@@ -127,7 +126,7 @@ export const defaultProposalBuilder = async (
   options = {},
   { env = process.env } = {},
 ) => {
-  /** @param {string|undefined} s */
+  /** @param {string | undefined} s */
   const optBigInt = s => s && BigInt(s);
   const {
     vaultFactoryControllerAddress = env.VAULT_FACTORY_CONTROLLER_ADDR,

package/scripts/manual-price-feed.js

@@ -8,24 +8,29 @@ import process from 'process';
  * After extracting the oracleAdmins to entries in home.scratch, you can use one
  * from the REPL like:
  *
- * lookup('agoricNames', 'oracleBrand', 'ATOM').then(brand => atom = brand)
- * -> [Object Alleged: ATOM brand]{}
- * lookup('agoricNames', 'oracleBrand', 'USD').then(brand => usd = brand)
- * -> [Object Alleged: USD brand]{}
- * pa = home.priceAuthority
- *  -> [Object Alleged: PriceAuthority]{}
- * qn = E(pa).makeQuoteNotifier({ value: 1n * 10n ** 6n, brand: atom }, usd)
- * -> [Object Alleged: QuoteNotifier]{}
- * oa = E(home.scratch).get("offerResult unknown#1652669688625")
- * -> [Object Alleged: OracleAdmin]{}
- * E(oa).pushResult('19.37')
- * E(qn).getUpdateSince()
+ *     lookup('agoricNames', 'oracleBrand', 'ATOM').then(brand => atom = brand)
+ *     -> [Object Alleged: ATOM brand]{}
+ *     lookup('agoricNames', 'oracleBrand', 'USD').then(brand => usd = brand)
+ *     -> [Object Alleged: USD brand]{}
+ *     pa = home.priceAuthority
+ *      -> [Object Alleged: PriceAuthority]{}
+ *     qn = E(pa).makeQuoteNotifier({ value: 1n * 10n ** 6n, brand: atom }, usd)
+ *     -> [Object Alleged: QuoteNotifier]{}
+ *     oa = E(home.scratch).get("offerResult unknown#1652669688625")
+ *     -> [Object Alleged: OracleAdmin]{}
+ *     E(oa).pushResult('19.37')
+ *     E(qn).getUpdateSince()
  *
- * @typedef {{ board: import('@agoric/vats').Board, chainTimerService, scratch, zoe }} Home
+ * @typedef {{
+ *   board: import('@agoric/vats').Board;
+ *   chainTimerService;
+ *   scratch;
+ *   zoe;
+ * }} Home
  * @param {Promise<Home>} homePromise
  * @param {object} root0
- * @param {(...path: string[]) => Promise<any>} root0.lookup
- * A promise for the references available from REPL home
+ * @param {(...path: string[]) => Promise<any>} root0.lookup A promise for the
+ *   references available from REPL home
  */
 export default async function priceAuthorityFromNotifier(
   homePromise,

package/src/auction/auctionBook.d.ts

@@ -4,10 +4,10 @@ export function prepareAuctionBook(baggage: MapStore<string, unknown>, zcf: ZCF,
      * @param {Amount<'nat'>} assetAmount
      * @param {ZCFSeat} sourceSeat
      * @param {Amount<'nat'>} [proceedsGoal] an amount that the depositor
-     *    would like to raise. The auction is requested to not sell more
-     *    collateral than required to raise that much. The auctioneer might
-     *    sell more if there is more than one supplier of collateral, and
-     *    they request inconsistent limits.
+     *   would like to raise. The auction is requested to not sell more
+     *   collateral than required to raise that much. The auctioneer might
+     *   sell more if there is more than one supplier of collateral, and
+     *   they request inconsistent limits.
      */
     addAssets(assetAmount: Amount<'nat'>, sourceSeat: ZCFSeat, proceedsGoal?: Amount<"nat"> | undefined): void;
     /** @type {(reduction: Ratio) => void} */
@@ -49,30 +49,33 @@ export type BookDataNotification = {
      */
     startPrice: Ratio | null;
     /**
-     * the price at the current auction tier
+     * the price at the current auction
+     * tier
      */
     currentPriceLevel: Ratio | null;
     /**
-     * The proceeds the sellers were targeting to raise
+     * The proceeds the sellers
+     * were targeting to raise
      */
     startProceedsGoal: Amount<'nat'> | null;
     /**
-     * The remainder of
-     * the proceeds the sellers were targeting to raise
+     * The remainder of the
+     * proceeds the sellers were targeting to raise
      */
     remainingProceedsGoal: Amount<'nat'> | null;
     /**
-     * The proceeds raised so far in the auction
+     * The proceeds raised so
+     * far in the auction
      */
     proceedsRaised: Amount<'nat'> | undefined;
     /**
-     * How much collateral was
-     * available for sale at the start. (If more is deposited later, it'll be
-     * added in.)
+     * How much collateral was available
+     * for sale at the start. (If more is deposited later, it'll be added in.)
      */
     startCollateral: Amount<'nat'>;
     /**
-     * The amount of collateral remaining
+     * The amount of collateral
+     * remaining
      */
     collateralAvailable: Amount<'nat'> | null;
 };

package/src/auction/auctionBook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auctionBook.d.ts","sourceRoot":"","sources":["auctionBook.js"],"names":[],"mappings":"AAqEO,6CAHI,MAAM,KAAK,CAAC,mBACZ,MAAM,KAAK,CAAC,oCAiBtB;AAwBM,4EAHI,GAAG,mBACH,OAAO,6CAA6C,EAAE,eAAe;IAsWxE;;;;;;;;OAQG;2BAPQ,OAAO,KAAK,CAAC,cACb,OAAO;IA6ElB,yCAAyC;+BAAlB,KAAK,GAAK,IAAI;;;;;IAmGrC;;;;OAIG;wBAHQ,SAAS,QACT,OAAO,aACP,OAAO;;;;;;;;;;;EAkHzB;wBAhsBY;IACZ,MAAU,EAAE,OAAO,KAAK,CAAC,CAAA;CACtB,GAAG;IACN,YAAgB,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,CAAC;IACP,UAAc,EAAE,KAAK,CAAC;CACnB,GAAG;IACN,eAAoB,EAAE,KAAK,CAAC;CACzB,CAAC;sBAuBS,OAAO,kBAAkB,EAAE,OAAO;;;;;gBAKlC,KAAK,GAAW,IAAI;;;;uBACpB,KAAK,GAAW,IAAI;;;;uBACpB,OAAO,KAAK,CAAC,GAAG,IAAI;;;;;2BACpB,OAAO,KAAK,CAAC,GAAG,IAAI;;;;oBAEpB,OAAO,KAAK,CAAC,GAAG,SAAS;;;;;;qBACzB,OAAO,KAAK,CAAC;;;;yBAGb,OAAO,KAAK,CAAC,GAAG,IAAI;;0BAspBpB,WAAW,WAAW,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"auctionBook.d.ts","sourceRoot":"","sources":["auctionBook.js"],"names":[],"mappings":"AAyEO,6CAHI,MAAM,KAAK,CAAC,mBACZ,MAAM,KAAK,CAAC,oCAiBtB;AA0BM,4EAHI,GAAG,mBACH,OAAO,6CAA6C,EAAE,eAAe;IAwWxE;;;;;;;;OAQG;2BAPQ,OAAO,KAAK,CAAC,cACb,OAAO;IA6ElB,yCAAyC;+BAAlB,KAAK,GAAK,IAAI;;;;;IAmGrC;;;;OAIG;wBAHQ,SAAS,QACT,OAAO,aACP,OAAO;;;;;;;;;;;EAsHzB;wBA3sBY;IACZ,MAAU,EAAE,OAAO,KAAK,CAAC,CAAC;CACvB,GAAG;IACN,YAAgB,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,CACE;IACR,UAAoB,EAAE,KAAK,CAAC;CACnB,GACD;IACR,eAAyB,EAAE,KAAK,CAAC;CACxB,CACJ;sBAuBQ,OAAO,kBAAkB,EAAE,OAAO;;;;;gBAIlC,KAAK,GAAG,IAAI;;;;;uBACZ,KAAK,GAAG,IAAI;;;;;uBAEZ,OAAO,KAAK,CAAC,GAAG,IAAI;;;;;2BAEpB,OAAO,KAAK,CAAC,GAAG,IAAI;;;;;oBAEpB,OAAO,KAAK,CAAC,GAAG,SAAS;;;;;qBAEzB,OAAO,KAAK,CAAC;;;;;yBAEb,OAAO,KAAK,CAAC,GAAG,IAAI;;0BA6pBpB,WAAW,WAAW,yBAAyB,CAAC,CAAC"}

package/src/auction/auctionBook.js

@@ -34,34 +34,38 @@ const DEFAULT_DECIMALS = 9;
 
 /**
  * @file The book represents the collateral-specific state of an ongoing
- * auction. It holds the book, the capturedPrice, and the collateralSeat that has
- * the allocation of assets for sale.
+ *   auction. It holds the book, the capturedPrice, and the collateralSeat that
+ *   has the allocation of assets for sale.
+ *
+ *   The book contains orders for the collateral. It holds two kinds of orders:
  *
- * The book contains orders for the collateral. It holds two kinds of
- * orders:
  *   - Prices express the bidding offer in terms of a Bid amount
- *   - ScaledBids express the offer in terms of a discount (or markup) from the
- *     most recent oracle price.
+ *   - ScaledBids express the offer in terms of a discount (or markup) from the most
+ *       recent oracle price.
  *
- * Offers can be added in three ways. 1) When the auction is not active, prices
- * are automatically added to the appropriate collection. When the auction is
- * active, 2) if a new offer is at or above the current price, it will be
- * settled immediately; 2) If the offer is below the current price, it will be
- * added in the appropriate place and settled when the price reaches that level.
+ *   Offers can be added in three ways. 1) When the auction is not active, prices
+ *   are automatically added to the appropriate collection. When the auction is
+ *   active, 2) if a new offer is at or above the current price, it will be
+ *   settled immediately; 2) If the offer is below the current price, it will be
+ *   added in the appropriate place and settled when the price reaches that
+ *   level.
  */
 
 const trace = makeTracer('AucBook', true);
 
 /**
  * @typedef {{
- *   maxBuy: Amount<'nat'>
+ *   maxBuy: Amount<'nat'>;
  * } & {
- *   exitAfterBuy?: boolean,
- * } & ({
- *   offerPrice: Ratio,
- * } | {
- *    offerBidScaling: Ratio,
- * })} OfferSpec
+ *   exitAfterBuy?: boolean;
+ * } & (
+ *     | {
+ *         offerPrice: Ratio;
+ *       }
+ *     | {
+ *         offerBidScaling: Ratio;
+ *       }
+ *   )} OfferSpec
  */
 /**
  * @param {Brand<'nat'>} bidBrand
@@ -88,17 +92,19 @@ export const makeOfferSpecShape = (bidBrand, collateralBrand) => {
 
 /**
  * @typedef {object} BookDataNotification
- *
- * @property {Ratio         | null}      startPrice identifies the priceAuthority and price
- * @property {Ratio         | null}      currentPriceLevel the price at the current auction tier
- * @property {Amount<'nat'> | null}      startProceedsGoal The proceeds the sellers were targeting to raise
- * @property {Amount<'nat'> | null}      remainingProceedsGoal The remainder of
- *     the proceeds the sellers were targeting to raise
- * @property {Amount<'nat'> | undefined} proceedsRaised The proceeds raised so far in the auction
- * @property {Amount<'nat'>}             startCollateral How much collateral was
- *    available for sale at the start. (If more is deposited later, it'll be
- *    added in.)
- * @property {Amount<'nat'> | null}      collateralAvailable The amount of collateral remaining
+ * @property {Ratio | null} startPrice identifies the priceAuthority and price
+ * @property {Ratio | null} currentPriceLevel the price at the current auction
+ *   tier
+ * @property {Amount<'nat'> | null} startProceedsGoal The proceeds the sellers
+ *   were targeting to raise
+ * @property {Amount<'nat'> | null} remainingProceedsGoal The remainder of the
+ *   proceeds the sellers were targeting to raise
+ * @property {Amount<'nat'> | undefined} proceedsRaised The proceeds raised so
+ *   far in the auction
+ * @property {Amount<'nat'>} startCollateral How much collateral was available
+ *   for sale at the start. (If more is deposited later, it'll be added in.)
+ * @property {Amount<'nat'> | null} collateralAvailable The amount of collateral
+ *   remaining
  */
 
 /**
@@ -231,8 +237,8 @@ export const prepareAuctionBook = (baggage, zcf, makeRecorderKit) => {
     {
       helper: {
         /**
-         * remove the key from the appropriate book, indicated by whether the price
-         * is defined.
+         * remove the key from the appropriate book, indicated by whether the
+         * price is defined.
          *
          * @param {string} key
          * @param {Ratio | undefined} price
@@ -247,8 +253,8 @@ export const prepareAuctionBook = (baggage, zcf, makeRecorderKit) => {
         },
 
         /**
-         * Update the entry in the appropriate book, indicated by whether the price
-         * is defined.
+         * Update the entry in the appropriate book, indicated by whether the
+         * price is defined.
          *
          * @param {string} key
          * @param {Amount} collateralSold
@@ -264,7 +270,8 @@ export const prepareAuctionBook = (baggage, zcf, makeRecorderKit) => {
         },
 
         /**
-         * Settle with seat. The caller is responsible for updating the book, if any.
+         * Settle with seat. The caller is responsible for updating the book, if
+         * any.
          *
          * @param {ZCFSeat} seat
          * @param {Amount<'nat'>} collateralWanted
@@ -341,15 +348,16 @@ export const prepareAuctionBook = (baggage, zcf, makeRecorderKit) => {
         },
 
         /**
-         *  Accept an offer expressed as a price. If the auction is active, attempt to
-         *  buy collateral. If any of the offer remains add it to the book.
+         * Accept an offer expressed as a price. If the auction is active,
+         * attempt to buy collateral. If any of the offer remains add it to the
+         * book.
          *
-         *  @param {ZCFSeat} seat
-         *  @param {Ratio} price
-         *  @param {Amount<'nat'>} maxBuy
-         *  @param {object} opts
-         *  @param {boolean} opts.trySettle
-         *  @param {boolean} [opts.exitAfterBuy]
+         * @param {ZCFSeat} seat
+         * @param {Ratio} price
+         * @param {Amount<'nat'>} maxBuy
+         * @param {object} opts
+         * @param {boolean} opts.trySettle
+         * @param {boolean} [opts.exitAfterBuy]
          */
         acceptPriceOffer(
           seat,
@@ -388,16 +396,16 @@ export const prepareAuctionBook = (baggage, zcf, makeRecorderKit) => {
         },
 
         /**
-         *  Accept an offer expressed as a discount (or markup). If the auction is
-         *  active, attempt to buy collateral. If any of the offer remains add it to
-         *  the book.
+         * Accept an offer expressed as a discount (or markup). If the auction
+         * is active, attempt to buy collateral. If any of the offer remains add
+         * it to the book.
          *
-         *  @param {ZCFSeat} seat
-         *  @param {Ratio} bidScaling
-         *  @param {Amount<'nat'>} maxBuy
-         *  @param {object} opts
-         *  @param {boolean} opts.trySettle
-         *  @param {boolean} [opts.exitAfterBuy]
+         * @param {ZCFSeat} seat
+         * @param {Ratio} bidScaling
+         * @param {Amount<'nat'>} maxBuy
+         * @param {object} opts
+         * @param {boolean} opts.trySettle
+         * @param {boolean} [opts.exitAfterBuy]
          */
         acceptScaledBidOffer(
           seat,
@@ -466,10 +474,10 @@ export const prepareAuctionBook = (baggage, zcf, makeRecorderKit) => {
          * @param {Amount<'nat'>} assetAmount
          * @param {ZCFSeat} sourceSeat
          * @param {Amount<'nat'>} [proceedsGoal] an amount that the depositor
-         *    would like to raise. The auction is requested to not sell more
-         *    collateral than required to raise that much. The auctioneer might
-         *    sell more if there is more than one supplier of collateral, and
-         *    they request inconsistent limits.
+         *   would like to raise. The auction is requested to not sell more
+         *   collateral than required to raise that much. The auctioneer might
+         *   sell more if there is more than one supplier of collateral, and
+         *   they request inconsistent limits.
          */
         addAssets(assetAmount, sourceSeat, proceedsGoal) {
           const { state, facets } = this;
@@ -754,7 +762,11 @@ export const prepareAuctionBook = (baggage, zcf, makeRecorderKit) => {
     },
   );
 
-  /** @type {(...args: Parameters<typeof makeAuctionBookKit>) => ReturnType<typeof makeAuctionBookKit>['self']} */
+  /**
+   * @type {(
+   *   ...args: Parameters<typeof makeAuctionBookKit>
+   * ) => ReturnType<typeof makeAuctionBookKit>['self']}
+   */
   const makeAuctionBook = (...args) => makeAuctionBookKit(...args).self;
   return makeAuctionBook;
 };

package/src/auction/auctioneer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auctioneer.d.ts","sourceRoot":"","sources":["auctioneer.js"],"names":[],"mappings":"AA2KO,yEAVI,OAAO,KAAK,CAAC,YACb,OAAO,KAAK,CAAC,YACb;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;CAAC,EAAE,kBAC7D,OAAO,kBACP,OAAO,qBACP,MAAM,eAEN,OAAO,SACP,KAAK,8EAgNf;AAeM;;;;;;;;;;kBAXY,OAAO,wBAAwB,EAAE,YAAY;wBACvC,uBAAuB;oBAC3B,cAAc;iBAExB;IACV,sBAA0B,EAAE,UAAU,CAAC;IACvC,WAAe,EAAE,WAAW,CAAC;IAC7B,UAAc,EAAE,UAAU,CAAA;CACvB;;;;;;;;;;QAmOE,4CAA4C;2CAAhC,MAAM,KAAK,CAAC;;;;;;;;;;;;;;;QA+DxB;;;WAGG;yBAFQ,MAAM,OACN,OAAO;QAwBlB,gEAAgE;uBAAlD,QAAQ,OAAO,gBAAgB,EAAE,YAAY,CAAC;;QA1B5D;;;WAGG;yBAFQ,MAAM,OACN,OAAO;QAwBlB,gEAAgE;uBAAlD,QAAQ,OAAO,gBAAgB,EAAE,YAAY,CAAC;;GAQjE;AAED,6DAA6D;AAC7D,yEAAyE;AACzE,2EAA2E;AAE3E,8DAAkE;sBA1qBpD,OAAO,kBAAkB,EAAE,OAAO;iCAsqBlC,WAAW,YAAY,CAAC;oCACxB,kBAAkB,CAAC,aAAa,CAAC;qCACjC,kBAAkB,CAAC,cAAc,CAAC;qCA5qBX,aAAa"}
+{"version":3,"file":"auctioneer.d.ts","sourceRoot":"","sources":["auctioneer.js"],"names":[],"mappings":"AA8KO,yEAXI,OAAO,KAAK,CAAC,YACb,OAAO,KAAK,CAAC,YACb;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,KAAK,CAAC,CAAA;CAAE,EAAE,kBAC/D,OAAO,kBACP,OAAO,qBAEP,MAAM,eAEN,OAAO,SACP,KAAK,8EAgNf;AAiBM;;;;;;;;;;kBAZc,OAAO,wBAAwB,EAAE,YAAY;wBACvC,uBAAuB;oBAC3B,cAAc;iBAG1B;IACV,sBAA0B,EAAE,UAAU,CAAC;IACvC,WAAe,EAAE,WAAW,CAAC;IAC7B,UAAc,EAAE,UAAU,CAAC;CACxB;;;;;;;;;;QA0OE,4CAA4C;2CAAhC,MAAM,KAAK,CAAC;;;;;;;;;;;;;;;QA+DxB;;;WAGG;yBAFQ,MAAM,OACN,OAAO;QAwBlB,gEAAgE;uBAAlD,QAAQ,OAAO,gBAAgB,EAAE,YAAY,CAAC;;QA1B5D;;;WAGG;yBAFQ,MAAM,OACN,OAAO;QAwBlB,gEAAgE;uBAAlD,QAAQ,OAAO,gBAAgB,EAAE,YAAY,CAAC;;GAQjE;AAED,6DAA6D;AAC7D,yEAAyE;AACzE,2EAA2E;AAE3E,8DAAkE;sBAtrBpD,OAAO,kBAAkB,EAAE,OAAO;iCAkrBlC,WAAW,YAAY,CAAC;oCACxB,kBAAkB,CAAC,aAAa,CAAC;qCACjC,kBAAkB,CAAC,cAAc,CAAC;qCAxrBX,aAAa"}

package/src/auction/auctioneer.js

@@ -43,11 +43,10 @@ const { add, multiply } = natSafeMath;
 const trace = makeTracer('Auction', true);
 
 /**
- * @file
- * In this file, 'Bid' is the name of the ERTP issuer used to purchase
- * collateral from various issuers. It's too confusing to also use Bid as a verb
- * or a description of amounts offered, so we've tried to find alternatives in
- * all those cases.
+ * @file In this file, 'Bid' is the name of the ERTP issuer used to purchase
+ *   collateral from various issuers. It's too confusing to also use Bid as a
+ *   verb or a description of amounts offered, so we've tried to find
+ *   alternatives in all those cases.
  */
 
 const MINIMUM_BID_GIVE = 1n;
@@ -67,17 +66,19 @@ const makeBPRatio = (rate, bidBrand, collateralBrand = bidBrand) =>
  * The auction sold some amount of collateral, and raised a certain amount of
  * Bid. The excess collateral was returned as `unsoldCollateral`. The Bid amount
  * collected from the auction participants is `proceeds`.
+ *
  * Return a set of transfers for atomicRearrange() that distribute
  * `unsoldCollateral` and `proceeds` proportionally to each seat's deposited
  * amount. Any uneven split should be allocated to the reserve.
  *
  * @param {Amount} unsoldCollateral
  * @param {Amount} proceeds
- * @param {{seat: ZCFSeat, amount: Amount<'nat'>, goal: Amount<'nat'>}[]} deposits
+ * @param {{ seat: ZCFSeat; amount: Amount<'nat'>; goal: Amount<'nat'> }[]} deposits
  * @param {ZCFSeat} collateralSeat
- * @param {ZCFSeat} bidHoldingSeat seat with the Bid allocation to be distributed
+ * @param {ZCFSeat} bidHoldingSeat seat with the Bid allocation to be
+ *   distributed
  * @param {string} collateralKeyword The Reserve will hold multiple collaterals,
- *      so they need distinct keywords
+ *   so they need distinct keywords
  * @param {ZCFSeat} reserveSeat
  * @param {Brand} brand
  */
@@ -132,6 +133,7 @@ const distributeProportionalShares = (
  * The auction sold some amount of collateral, and raised a certain amount of
  * Bid. The excess collateral was returned as `unsoldCollateral`. The Bid amount
  * collected from the auction participants is `proceeds`.
+ *
  * Return a set of transfers for atomicRearrange() that distribute
  * `unsoldCollateral` and `proceeds` proportionally to each seat's deposited
  * amount. Any uneven split should be allocated to the reserve.
@@ -140,32 +142,33 @@ const distributeProportionalShares = (
  * outside the contract below.
  *
  * Some or all of the depositors may have specified a goal amount.
- *  * A if none did, return collateral and Bid prorated to deposits.
- *  * B if proceeds < proceedsGoal everyone gets prorated amounts of both.
- *  * C if proceeds matches proceedsGoal, everyone gets the Bid they
- *    asked for, plus enough collateral to reach the same proportional payout.
- *    If any depositor's goal amount exceeded their share of the total,
- *    we'll fall back to the first approach.
- *  * D if proceeds > proceedsGoal && all depositors specified a limit,
- *    all depositors get their goal first, then we distribute the
- *    remainder (collateral and Bid) to get the same proportional payout.
- *  * E if proceeds > proceedsGoal && some depositors didn't specify a
- *    limit, depositors who did will get their goal first, then we distribute
- *    the remainder (collateral and Bid) to get the same proportional
- *    payout. If any depositor's goal amount exceeded their share of the
- *    total, we'll fall back as above.
- * Think of it this way: those who specified a limit want as much collateral
- * back as possible, consistent with raising a certain amount of Bid. Those
- * who didn't specify a limit are trying to sell collateral, and would prefer to
- * have as much as possible converted to Bid.
+ *
+ * - A if none did, return collateral and Bid prorated to deposits.
+ * - B if proceeds < proceedsGoal everyone gets prorated amounts of both.
+ * - C if proceeds matches proceedsGoal, everyone gets the Bid they asked for,
+ *   plus enough collateral to reach the same proportional payout. If any
+ *   depositor's goal amount exceeded their share of the total, we'll fall back
+ *   to the first approach.
+ * - D if proceeds > proceedsGoal && all depositors specified a limit, all
+ *   depositors get their goal first, then we distribute the remainder
+ *   (collateral and Bid) to get the same proportional payout.
+ * - E if proceeds > proceedsGoal && some depositors didn't specify a limit,
+ *   depositors who did will get their goal first, then we distribute the
+ *   remainder (collateral and Bid) to get the same proportional payout. If any
+ *   depositor's goal amount exceeded their share of the total, we'll fall back
+ *   as above. Think of it this way: those who specified a limit want as much
+ *   collateral back as possible, consistent with raising a certain amount of
+ *   Bid. Those who didn't specify a limit are trying to sell collateral, and
+ *   would prefer to have as much as possible converted to Bid.
  *
  * @param {Amount<'nat'>} unsoldCollateral
  * @param {Amount<'nat'>} proceeds
- * @param {{seat: ZCFSeat, amount: Amount<'nat'>, goal: Amount<'nat'>}[]} deposits
+ * @param {{ seat: ZCFSeat; amount: Amount<'nat'>; goal: Amount<'nat'> }[]} deposits
  * @param {ZCFSeat} collateralSeat
- * @param {ZCFSeat} bidHoldingSeat seat with the Bid allocation to be distributed
+ * @param {ZCFSeat} bidHoldingSeat seat with the Bid allocation to be
+ *   distributed
  * @param {string} collateralKeyword The Reserve will hold multiple collaterals,
- *      so they need distinct keywords
+ *   so they need distinct keywords
  * @param {ZCFSeat} reserveSeat
  * @param {Brand} brand
  */
@@ -378,15 +381,17 @@ export const distributeProportionalSharesWithLimits = (
 };
 
 /**
- * @param {ZCF<GovernanceTerms<typeof auctioneerParamTypes> & {
- *   timerService: import('@agoric/time/src/types').TimerService,
- *   reservePublicFacet: AssetReservePublicFacet,
- *   priceAuthority: PriceAuthority
- * }>} zcf
+ * @param {ZCF<
+ *   GovernanceTerms<typeof auctioneerParamTypes> & {
+ *     timerService: import('@agoric/time/src/types').TimerService;
+ *     reservePublicFacet: AssetReservePublicFacet;
+ *     priceAuthority: PriceAuthority;
+ *   }
+ * >} zcf
  * @param {{
- *   initialPoserInvitation: Invitation,
- *   storageNode: StorageNode,
- *   marshaller: Marshaller
+ *   initialPoserInvitation: Invitation;
+ *   storageNode: StorageNode;
+ *   marshaller: Marshaller;
  * }} privateArgs
  * @param {Baggage} baggage
  */
@@ -399,7 +404,12 @@ export const start = async (zcf, privateArgs, baggage) => {
 
   /** @type {MapStore<Brand, import('./auctionBook.js').AuctionBook>} */
   const books = provideDurableMapStore(baggage, 'auctionBooks');
-  /** @type {MapStore<Brand, Array<{ seat: ZCFSeat, amount: Amount<'nat'>, goal: Amount<'nat'>}>>} */
+  /**
+   * @type {MapStore<
+   *   Brand,
+   *   { seat: ZCFSeat; amount: Amount<'nat'>; goal: Amount<'nat'> }[]
+   * >}
+   */
   const deposits = provideDurableMapStore(baggage, 'deposits');
   /** @type {MapStore<Brand, Keyword>} */
   const brandToKeyword = provideDurableMapStore(baggage, 'brandToKeyword');
@@ -427,9 +437,11 @@ export const start = async (zcf, privateArgs, baggage) => {
   });
   const scheduleKit = makeERecorderKit(
     E(privateArgs.storageNode).makeChildNode('schedule'),
-    /** @type {import('@agoric/zoe/src/contractSupport/recorder.js').TypedMatcher<import('./scheduler.js').ScheduleNotification>} */ (
-      M.any()
-    ),
+    /**
+     * @type {import('@agoric/zoe/src/contractSupport/recorder.js').TypedMatcher<
+     *     import('./scheduler.js').ScheduleNotification
+     *   >}
+     */ (M.any()),
   );
 
   /**
@@ -578,7 +590,7 @@ export const start = async (zcf, privateArgs, baggage) => {
 
   /**
    * @param {ZCFSeat} zcfSeat
-   * @param {{ goal: Amount<'nat'>}} offerArgs
+   * @param {{ goal: Amount<'nat'> }} offerArgs
    */
   const depositOfferHandler = (zcfSeat, offerArgs) => {
     const goalMatcher = M.or(undefined, { goal: bidAmountShape });

package/src/auction/offerBook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offerBook.d.ts","sourceRoot":"","sources":["offerBook.js"],"names":[],"mappings":"AA+CO;IAiBD;;;;;OAKG;cAJQ,OAAO,cACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;IAsBlB,gCAAgC;4BAApB,KAAK;;;;;;IA1BjB;;;;;OAKG;cAJQ,OAAO,cACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;IAsBlB,gCAAgC;4BAApB,KAAK;;;;;GAqCpB;AAcI;IAiBD;;;;;OAKG;cAJQ,OAAO,SACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;;;;;;;IAJlB;;;;;OAKG;cAJQ,OAAO,SACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;;;;;;GA0DrB;sBA9MW,OAAO,kBAAkB,EAAE,OAAO;2BAYnC;IACZ,IAAM,EAAE,OAAO,CAAC;IAChB,MAAQ,EAAE,OAAO,KAAK,CAAC,CAAC;IACxB,MAAQ,EAAE,QAAQ,CAAC;IACnB,QAAU,EAAE,OAAO,KAAK,CAAC,CAAC;CACvB,GAAI;IAAC,YAAY,EAAE,OAAO,CAAA;CAAC,GAAG,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAC,CAAC"}
+{"version":3,"file":"offerBook.d.ts","sourceRoot":"","sources":["offerBook.js"],"names":[],"mappings":"AAkDO;IAgBD;;;;;OAKG;cAJQ,OAAO,cACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;IAsBlB,gCAAgC;4BAApB,KAAK;;;;;;IA1BjB;;;;;OAKG;cAJQ,OAAO,cACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;IAsBlB,gCAAgC;4BAApB,KAAK;;;;;GAqCpB;AAcI;IAgBD;;;;;OAKG;cAJQ,OAAO,SACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;;;;;;;IAJlB;;;;;OAKG;cAJQ,OAAO,SACP,KAAK,UACL,OAAO,KAAK,CAAC,gBACb,OAAO;;;;;;GA0DrB;sBA/MW,OAAO,kBAAkB,EAAE,OAAO;2BAYnC;IACZ,IAAQ,EAAE,OAAO,CAAC;IAClB,MAAU,EAAE,OAAO,KAAK,CAAC,CAAC;IAC1B,MAAU,EAAE,QAAQ,CAAC;IACrB,QAAY,EAAE,OAAO,KAAK,CAAC,CAAC;CACzB,GAAG;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,CAC1B;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACzC;IAAE,UAAU,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAC1C"}