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

package/src/vaultFactory/vaultManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vaultManager.d.ts","sourceRoot":"","sources":["vaultManager.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"vaultManager.d.ts","sourceRoot":"","sources":["vaultManager.js"],"names":[],"mappings":"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"}

package/src/vaultFactory/vaultManager.js

@@ -2,18 +2,20 @@
 /**
  * @file Vault Manager object manages vault-based debts for a collateral type.
  *
- * The responsibilities include:
- * - opening a new vault backed by the collateral
- * - publishing metrics on the vault economy for that collateral
- * - charging interest on all active vaults
- * - liquidating active vaults that have exceeded the debt ratio
+ *   The responsibilities include:
  *
- * Once a vault is settled (liquidated or closed) it can still be used, traded,
- * etc. but is no longer the concern of the manager. It can't be liquidated,
- * have interest charged, or be counted in the metrics.
+ *   - opening a new vault backed by the collateral
+ *   - publishing metrics on the vault economy for that collateral
+ *   - charging interest on all active vaults
+ *   - liquidating active vaults that have exceeded the debt ratio
  *
- * Undercollateralized vaults can have their assets sent to the auctioneer to be
- * liquidated. If the auction is unsuccessful, the liquidation may be reverted.
+ *   Once a vault is settled (liquidated or closed) it can still be used, traded,
+ *   etc. but is no longer the concern of the manager. It can't be liquidated,
+ *   have interest charged, or be counted in the metrics.
+ *
+ *   Undercollateralized vaults can have their assets sent to the auctioneer to be
+ *   liquidated. If the auction is unsuccessful, the liquidation may be
+ *   reverted.
  */
 import '@agoric/zoe/exported.js';
 
@@ -73,93 +75,102 @@ const trace = makeTracer('VM');
 // Metrics naming scheme: nouns are present values; past-participles are accumulative.
 /**
  * @typedef {object} MetricsNotification
- *
- * @property {Ratio | null} lockedQuote      priceQuote that will be used for liquidation.
- *                                   Non-null from priceLock time until liquidation has taken place.
- * @property {number}         numActiveVaults          present count of vaults
- * @property {number}         numLiquidatingVaults  present count of liquidating vaults
- * @property {Amount<'nat'>}  totalCollateral    present sum of collateral across all vaults
- * @property {Amount<'nat'>}  totalDebt          present sum of debt across all vaults
- * @property {Amount<'nat'>}  retainedCollateral collateral held as a result of not returning excess refunds
- *                                                to owners of vaults liquidated with shortfalls
- * @property {Amount<'nat'>}  liquidatingCollateral  present sum of collateral in vaults sent for liquidation
- * @property {Amount<'nat'>}  liquidatingDebt        present sum of debt in vaults sent for liquidation
- *
- * @property {Amount<'nat'>}  totalCollateralSold       running sum of collateral sold in liquidation
- * @property {Amount<'nat'>}  totalOverageReceived      running sum of overages, central received greater than debt
- * @property {Amount<'nat'>}  totalProceedsReceived     running sum of minted received from liquidation
- * @property {Amount<'nat'>}  totalShortfallReceived    running sum of shortfalls, minted received less than debt
- * @property {number}         numLiquidationsCompleted  running count of liquidated vaults
- * @property {number}         numLiquidationsAborted    running count of vault liquidations that were reverted.
+ * @property {Ratio | null} lockedQuote priceQuote that will be used for
+ *   liquidation. Non-null from priceLock time until liquidation has taken
+ *   place.
+ * @property {number} numActiveVaults present count of vaults
+ * @property {number} numLiquidatingVaults present count of liquidating vaults
+ * @property {Amount<'nat'>} totalCollateral present sum of collateral across
+ *   all vaults
+ * @property {Amount<'nat'>} totalDebt present sum of debt across all vaults
+ * @property {Amount<'nat'>} retainedCollateral collateral held as a result of
+ *   not returning excess refunds to owners of vaults liquidated with
+ *   shortfalls
+ * @property {Amount<'nat'>} liquidatingCollateral present sum of collateral in
+ *   vaults sent for liquidation
+ * @property {Amount<'nat'>} liquidatingDebt present sum of debt in vaults sent
+ *   for liquidation
+ * @property {Amount<'nat'>} totalCollateralSold running sum of collateral sold
+ *   in liquidation
+ * @property {Amount<'nat'>} totalOverageReceived running sum of overages,
+ *   central received greater than debt
+ * @property {Amount<'nat'>} totalProceedsReceived running sum of minted
+ *   received from liquidation
+ * @property {Amount<'nat'>} totalShortfallReceived running sum of shortfalls,
+ *   minted received less than debt
+ * @property {number} numLiquidationsCompleted running count of liquidated
+ *   vaults
+ * @property {number} numLiquidationsAborted running count of vault liquidations
+ *   that were reverted.
  */
 
 /**
  * @typedef {{
- *  compoundedStabilityFee: Ratio,
- *  stabilityFee: Ratio,
- *  latestStabilityFeeUpdate: Timestamp,
+ *   compoundedStabilityFee: Ratio;
+ *   stabilityFee: Ratio;
+ *   latestStabilityFeeUpdate: Timestamp;
  * }} AssetState
  *
  * @typedef {{
- *  getChargingPeriod: () => RelativeTime,
- *  getRecordingPeriod: () => RelativeTime,
- *  getDebtLimit: () => Amount<'nat'>,
- *  getStabilityFee: () => Ratio,
- *  getLiquidationPadding: () => Ratio,
- *  getLiquidationMargin: () => Ratio,
- *  getLiquidationPenalty: () => Ratio,
- *  getMintFee: () => Ratio,
- *  getMinInitialDebt: () => Amount<'nat'>,
+ *   getChargingPeriod: () => RelativeTime;
+ *   getRecordingPeriod: () => RelativeTime;
+ *   getDebtLimit: () => Amount<'nat'>;
+ *   getStabilityFee: () => Ratio;
+ *   getLiquidationPadding: () => Ratio;
+ *   getLiquidationMargin: () => Ratio;
+ *   getLiquidationPenalty: () => Ratio;
+ *   getMintFee: () => Ratio;
+ *   getMinInitialDebt: () => Amount<'nat'>;
  * }} GovernedParamGetters
  */
 
 /**
  * @typedef {Readonly<{
- *   debtMint: ZCFMint<'nat'>,
- *   collateralBrand: Brand<'nat'>,
- *   collateralUnit: Amount<'nat'>,
- *   descriptionScope: string,
- *   startTimeStamp: Timestamp,
- *   storageNode: StorageNode,
+ *   debtMint: ZCFMint<'nat'>;
+ *   collateralBrand: Brand<'nat'>;
+ *   collateralUnit: Amount<'nat'>;
+ *   descriptionScope: string;
+ *   startTimeStamp: Timestamp;
+ *   storageNode: StorageNode;
  * }>} HeldParams
  */
 
 /**
  * @typedef {{
- *   assetTopicKit: import('@agoric/zoe/src/contractSupport/recorder.js').RecorderKit<AssetState>,
- *   debtBrand: Brand<'nat'>,
- *   liquidatingVaults: SetStore<Vault>,
- *   metricsTopicKit: import('@agoric/zoe/src/contractSupport/recorder.js').RecorderKit<MetricsNotification>,
- *   poolIncrementSeat: ZCFSeat,
- *   retainedCollateralSeat: ZCFSeat,
- *   unsettledVaults: MapStore<string, Vault>,
+ *   assetTopicKit: import('@agoric/zoe/src/contractSupport/recorder.js').RecorderKit<AssetState>;
+ *   debtBrand: Brand<'nat'>;
+ *   liquidatingVaults: SetStore<Vault>;
+ *   metricsTopicKit: import('@agoric/zoe/src/contractSupport/recorder.js').RecorderKit<MetricsNotification>;
+ *   poolIncrementSeat: ZCFSeat;
+ *   retainedCollateralSeat: ZCFSeat;
+ *   unsettledVaults: MapStore<string, Vault>;
  * }} ImmutableState
  */
 
 /**
  * @typedef {{
- *   compoundedStabilityFee: Ratio,
- *   latestStabilityFeeUpdate: Timestamp,
- *   numLiquidationsCompleted: number,
- *   numLiquidationsAborted: number,
- *   totalCollateral: Amount<'nat'>,
- *   totalCollateralSold: Amount<'nat'>,
- *   totalDebt: Amount<'nat'>,
- *   liquidatingCollateral: Amount<'nat'>,
- *   liquidatingDebt: Amount<'nat'>,
- *   totalOverageReceived: Amount<'nat'>,
- *   totalProceedsReceived: Amount<'nat'>,
- *   totalShortfallReceived: Amount<'nat'>,
- *   vaultCounter: number,
- *   lockedQuote: PriceQuote | undefined,
+ *   compoundedStabilityFee: Ratio;
+ *   latestStabilityFeeUpdate: Timestamp;
+ *   numLiquidationsCompleted: number;
+ *   numLiquidationsAborted: number;
+ *   totalCollateral: Amount<'nat'>;
+ *   totalCollateralSold: Amount<'nat'>;
+ *   totalDebt: Amount<'nat'>;
+ *   liquidatingCollateral: Amount<'nat'>;
+ *   liquidatingDebt: Amount<'nat'>;
+ *   totalOverageReceived: Amount<'nat'>;
+ *   totalProceedsReceived: Amount<'nat'>;
+ *   totalShortfallReceived: Amount<'nat'>;
+ *   vaultCounter: number;
+ *   lockedQuote: PriceQuote | undefined;
  * }} MutableState
  */
 
 /**
  * @type {(brand: Brand) => {
- * prioritizedVaults: ReturnType<typeof makePrioritizedVaults>,
- * storedQuotesNotifier: import('@agoric/notifier').StoredNotifier<PriceQuote>,
- * storedCollateralQuote: PriceQuote,
+ *   prioritizedVaults: ReturnType<typeof makePrioritizedVaults>;
+ *   storedQuotesNotifier: import('@agoric/notifier').StoredNotifier<PriceQuote>;
+ *   storedCollateralQuote: PriceQuote;
  * }}
  */
 // any b/c will be filled after start()
@@ -168,11 +179,11 @@ const collateralEphemera = makeEphemeraProvider(() => /** @type {any} */ ({}));
 /**
  * @param {import('@agoric/ertp').Baggage} baggage
  * @param {{
- *   zcf: import('./vaultFactory.js').VaultFactoryZCF,
- *   marshaller: ERef<Marshaller>,
- *   makeRecorderKit: import('@agoric/zoe/src/contractSupport/recorder.js').MakeRecorderKit,
- *   makeERecorderKit: import('@agoric/zoe/src/contractSupport/recorder.js').MakeERecorderKit,
- *   factoryPowers: import('./vaultDirector.js').FactoryPowersFacet,
+ *   zcf: import('./vaultFactory.js').VaultFactoryZCF;
+ *   marshaller: ERef<Marshaller>;
+ *   makeRecorderKit: import('@agoric/zoe/src/contractSupport/recorder.js').MakeRecorderKit;
+ *   makeERecorderKit: import('@agoric/zoe/src/contractSupport/recorder.js').MakeERecorderKit;
+ *   factoryPowers: import('./vaultDirector.js').FactoryPowersFacet;
  * }} powers
  */
 export const prepareVaultManagerKit = (
@@ -203,8 +214,9 @@ export const prepareVaultManagerKit = (
       poolIncrementSeat: zcf.makeEmptySeatKit().zcfSeat,
 
       /**
-       * Vaults that have been sent for liquidation. When we get proceeds (or lack
-       * thereof) back from the liquidator, we will allocate them among the vaults.
+       * Vaults that have been sent for liquidation. When we get proceeds (or
+       * lack thereof) back from the liquidator, we will allocate them among the
+       * vaults.
        *
        * @type {SetStore<Vault>}
        */
@@ -339,9 +351,7 @@ export const prepareVaultManagerKit = (
 
       // Some of these could go in closures but are kept on a facet anticipating future durability options.
       helper: {
-        /**
-         * Start non-durable processes (or restart if needed after vat restart)
-         */
+        /** Start non-durable processes (or restart if needed after vat restart) */
         start() {
           const { state, facets } = this;
           trace(state.collateralBrand, 'helper.start()', state.vaultCounter);
@@ -409,9 +419,7 @@ export const prepareVaultManagerKit = (
           });
           trace('helper.start() done');
         },
-        /**
-         * @param {Timestamp} updateTime
-         */
+        /** @param {Timestamp} updateTime */
         async chargeAllVaults(updateTime) {
           const { state, facets } = this;
           const { collateralBrand, debtMint, poolIncrementSeat } = state;
@@ -515,7 +523,6 @@ export const prepareVaultManagerKit = (
           state.liquidatingDebt = AmountMath.add(state.liquidatingDebt, debt);
         },
         /**
-         *
          * @param {Amount<'nat'>} debt
          * @param {Amount<'nat'>} collateral
          * @param {Amount<'nat'>} overage
@@ -598,14 +605,18 @@ export const prepareVaultManagerKit = (
         },
 
         /**
-         * This is designed to tolerate an incomplete plan, in case calculateDistributionPlan encounters
-         * an error during its calculation. We don't have a way to induce such errors in CI so we've
-         * done so manually in dev and verified this function recovers as expected.
+         * This is designed to tolerate an incomplete plan, in case
+         * calculateDistributionPlan encounters an error during its calculation.
+         * We don't have a way to induce such errors in CI so we've done so
+         * manually in dev and verified this function recovers as expected.
          *
          * @param {AmountKeywordRecord} proceeds
          * @param {Amount<'nat'>} totalDebt
          * @param {Pick<PriceQuote, 'quoteAmount'>} oraclePriceAtStart
-         * @param {MapStore<Vault, { collateralAmount: Amount<'nat'>, debtAmount:  Amount<'nat'>}>} vaultData
+         * @param {MapStore<
+         *   Vault,
+         *   { collateralAmount: Amount<'nat'>; debtAmount: Amount<'nat'> }
+         * >} vaultData
          * @param {Amount<'nat'>} totalCollateral
          */
         planProceedsDistribution(
@@ -661,13 +672,14 @@ export const prepareVaultManagerKit = (
         },
 
         /**
-         * This is designed to tolerate an incomplete plan, in case calculateDistributionPlan encounters
-         * an error during its calculation. We don't have a way to induce such errors in CI so we've
-         * done so manually in dev and verified this function recovers as expected.
+         * This is designed to tolerate an incomplete plan, in case
+         * calculateDistributionPlan encounters an error during its calculation.
+         * We don't have a way to induce such errors in CI so we've done so
+         * manually in dev and verified this function recovers as expected.
          *
          * @param {object} obj
          * @param {import('./proceeds.js').DistributionPlan} obj.plan
-         * @param {Array<Vault>} obj.vaultsInPlan
+         * @param {Vault[]} obj.vaultsInPlan
          * @param {ZCFSeat} obj.liqSeat
          * @param {Amount<'nat'>} obj.totalCollateral
          * @param {Amount<'nat'>} obj.totalDebt
@@ -840,9 +852,7 @@ export const prepareVaultManagerKit = (
           const { descriptionScope } = this.state;
           return `${descriptionScope}: ${base}`;
         },
-        /**
-         * coefficient on existing debt to calculate new debt
-         */
+        /** coefficient on existing debt to calculate new debt */
         getCompoundedStabilityFee() {
           return this.state.compoundedStabilityFee;
         },
@@ -852,7 +862,8 @@ export const prepareVaultManagerKit = (
          * @param {NormalizedDebt} oldDebtNormalized
          * @param {Amount<'nat'>} oldCollateral
          * @param {VaultId} vaultId
-         * @param {import('./vault.js').VaultPhase} vaultPhase at the end of whatever change updated balances
+         * @param {import('./vault.js').VaultPhase} vaultPhase at the end of
+         *   whatever change updated balances
          * @param {Vault} vault
          * @returns {void}
          */
@@ -937,9 +948,7 @@ export const prepareVaultManagerKit = (
           return factoryPowers.getGovernedParams(collateralBrand);
         },
 
-        /**
-         * @param {ZCFSeat} seat
-         */
+        /** @param {ZCFSeat} seat */
         async makeVaultKit(seat) {
           const {
             state,
@@ -1045,9 +1054,7 @@ export const prepareVaultManagerKit = (
           facets.helper.writeMetrics();
           return storedCollateralQuote;
         },
-        /**
-         * @param {ERef<AuctioneerPublicFacet>} auctionPF
-         */
+        /** @param {ERef<AuctioneerPublicFacet>} auctionPF */
         async liquidateVaults(auctionPF) {
           const { state, facets } = this;
           const { self, helper } = facets;
@@ -1181,7 +1188,12 @@ export const prepareVaultManagerKit = (
     },
   );
 
-  /** @param {Omit<Parameters<typeof makeVaultManagerKitInternal>[0], 'metricsStorageNode'>} externalParams */
+  /**
+   * @param {Omit<
+   *   Parameters<typeof makeVaultManagerKitInternal>[0],
+   *   'metricsStorageNode'
+   * >} externalParams
+   */
   const makeVaultManagerKit = async externalParams => {
     const metricsStorageNode = await E(
       externalParams.storageNode,
@@ -1194,15 +1206,13 @@ export const prepareVaultManagerKit = (
   return makeVaultManagerKit;
 };
 
+/** @typedef {Awaited<ReturnType<ReturnType<typeof prepareVaultManagerKit>>>} VaultManagerKit */
 /**
- * @typedef {Awaited<ReturnType<ReturnType<typeof prepareVaultManagerKit>>>} VaultManagerKit
- */
-/**
- * @typedef {VaultManagerKit['self']} VaultManager
- * Each VaultManager manages a single collateral type.
+ * @typedef {VaultManagerKit['self']} VaultManager Each VaultManager manages a
+ *   single collateral type.
  *
- * It manages some number of outstanding debt positions, each called a Vault,
- * for which the collateral is provided in exchange for borrowed Minted.
+ *   It manages some number of outstanding debt positions, each called a Vault,
+ *   for which the collateral is provided in exchange for borrowed Minted.
  */
 /** @typedef {VaultManagerKit['collateral']} CollateralManager */