@agoric/inter-protocol 0.16.2-upgrade-16-dev-d492653.0 → 0.16.2-upgrade-16-dev-0549112.0

package/src/vaultFactory/vaultManager.d.ts

@@ -5,7 +5,7 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
     makeRecorderKit: import("@agoric/zoe/src/contractSupport/recorder.js").MakeRecorderKit;
     makeERecorderKit: import("@agoric/zoe/src/contractSupport/recorder.js").MakeERecorderKit;
     factoryPowers: import("./vaultDirector.js").FactoryPowersFacet;
-}): (externalParams: Omit<Readonly<{
+}): (externalParams: Omit<Parameters<(params: Readonly<{
     debtMint: ZCFMint<"nat">;
     collateralBrand: Brand<"nat">;
     collateralUnit: Amount<"nat">;
@@ -14,7 +14,7 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
     storageNode: StorageNode;
 }> & {
     metricsStorageNode: StorageNode;
-}, "metricsStorageNode">) => Promise<import("@endo/exo").GuardedKit<{
+}) => import("@endo/exo").GuardedKit<{
     collateral: {
         makeVaultInvitation(): Promise<Invitation<{
             publicSubscribers: {
@@ -86,77 +86,7 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
          * >} vaultData
          * @param {Amount<'nat'>} totalCollateral
          */
-        planProceedsDistribution(proceeds: AmountKeywordRecord, totalDebt: Amount<"nat">, oraclePriceAtStart: Pick<PriceQuote, "quoteAmount">, vaultData: globalThis.MapStore<import("@endo/exo").Guarded<{
-            getVaultSeat(): ZCFSeat;
-            initVaultKit(seat: ZCFSeat, storageNode: StorageNode): Promise<{
-                publicSubscribers: {
-                    vault: {
-                        description: string;
-                        subscriber: globalThis.Subscriber<VaultNotification>;
-                        storagePath: Promise<string>;
-                    };
-                };
-                invitationMakers: import("@endo/exo").Guarded<{
-                    AdjustBalances(): Promise<Invitation<string, undefined>>;
-                    CloseVault(): Promise<Invitation<string, undefined>>;
-                    TransferVault(): Promise<Invitation<any, undefined>>;
-                }>;
-                vault: import("@endo/exo").Guarded<{
-                    getPublicTopics(): {
-                        vault: {
-                            description: string;
-                            subscriber: globalThis.Subscriber<VaultNotification>;
-                            storagePath: Promise<string>;
-                        };
-                    };
-                    makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                    makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                    makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                    getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                    getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                    getNormalizedDebt(): NormalizedDebt;
-                }>;
-                vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-            }>;
-            liquidating(): void;
-            liquidated(): void;
-            abortLiquidation(): string;
-            makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-            makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-            makeTransferInvitation(): Promise<Invitation<{
-                publicSubscribers: {
-                    vault: {
-                        description: string;
-                        subscriber: globalThis.Subscriber<VaultNotification>;
-                        storagePath: Promise<string>;
-                    };
-                };
-                invitationMakers: import("@endo/exo").Guarded<{
-                    AdjustBalances(): Promise<Invitation<string, undefined>>;
-                    CloseVault(): Promise<Invitation<string, undefined>>;
-                    TransferVault(): Promise<Invitation<any, undefined>>;
-                }>;
-                vault: import("@endo/exo").Guarded<{
-                    getPublicTopics(): {
-                        vault: {
-                            description: string;
-                            subscriber: globalThis.Subscriber<VaultNotification>;
-                            storagePath: Promise<string>;
-                        };
-                    };
-                    makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                    makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                    makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                    getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                    getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                    getNormalizedDebt(): NormalizedDebt;
-                }>;
-                vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-            }, undefined>>;
-            getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-            getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-            getNormalizedDebt(): NormalizedDebt;
-        }>, {
+        planProceedsDistribution(proceeds: AmountKeywordRecord, totalDebt: Amount<"nat">, oraclePriceAtStart: Pick<PriceQuote, "quoteAmount">, vaultData: MapStore<Vault, {
             collateralAmount: Amount<"nat">;
             debtAmount: Amount<"nat">;
         }>, totalCollateral: Amount<"nat">): {
@@ -198,39 +128,10 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
                 abortLiquidation(): string;
                 makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
                 makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                makeTransferInvitation(): Promise<Invitation<{
-                    publicSubscribers: {
-                        vault: {
-                            description: string;
-                            subscriber: globalThis.Subscriber<VaultNotification>;
-                            storagePath: Promise<string>;
-                        };
-                    };
-                    invitationMakers: import("@endo/exo").Guarded<{
-                        AdjustBalances(): Promise<Invitation<string, undefined>>;
-                        CloseVault(): Promise<Invitation<string, undefined>>;
-                        TransferVault(): Promise<Invitation<any, undefined>>;
-                    }>;
-                    vault: import("@endo/exo").Guarded<{
-                        getPublicTopics(): {
-                            vault: {
-                                description: string;
-                                subscriber: globalThis.Subscriber<VaultNotification>;
-                                storagePath: Promise<string>;
-                            };
-                        };
-                        makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                        makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                        makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                        getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                        getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                        getNormalizedDebt(): NormalizedDebt;
-                    }>;
-                    vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-                }, undefined>>;
-                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                getNormalizedDebt(): NormalizedDebt;
+                makeTransferInvitation(): Promise<Invitation<VaultKit>>;
+                getCollateralAmount(): Amount<"nat">;
+                getCurrentDebt(): Amount<"nat">;
+                getNormalizedDebt(): import("./storeUtils.js").NormalizedDebt;
             }>[];
         };
         /**
@@ -249,77 +150,7 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
          */
         distributeProceeds({ plan, vaultsInPlan, liqSeat, totalCollateral, totalDebt, }: {
             plan: import("./proceeds.js").DistributionPlan;
-            vaultsInPlan: import("@endo/exo").Guarded<{
-                getVaultSeat(): ZCFSeat;
-                initVaultKit(seat: ZCFSeat, storageNode: StorageNode): Promise<{
-                    publicSubscribers: {
-                        vault: {
-                            description: string;
-                            subscriber: globalThis.Subscriber<VaultNotification>;
-                            storagePath: Promise<string>;
-                        };
-                    };
-                    invitationMakers: import("@endo/exo").Guarded<{
-                        AdjustBalances(): Promise<Invitation<string, undefined>>;
-                        CloseVault(): Promise<Invitation<string, undefined>>;
-                        TransferVault(): Promise<Invitation<any, undefined>>;
-                    }>;
-                    vault: import("@endo/exo").Guarded<{
-                        getPublicTopics(): {
-                            vault: {
-                                description: string;
-                                subscriber: globalThis.Subscriber<VaultNotification>;
-                                storagePath: Promise<string>;
-                            };
-                        };
-                        makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                        makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                        makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                        getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                        getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                        getNormalizedDebt(): NormalizedDebt;
-                    }>;
-                    vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-                }>;
-                liquidating(): void;
-                liquidated(): void;
-                abortLiquidation(): string;
-                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                makeTransferInvitation(): Promise<Invitation<{
-                    publicSubscribers: {
-                        vault: {
-                            description: string;
-                            subscriber: globalThis.Subscriber<VaultNotification>;
-                            storagePath: Promise<string>;
-                        };
-                    };
-                    invitationMakers: import("@endo/exo").Guarded<{
-                        AdjustBalances(): Promise<Invitation<string, undefined>>;
-                        CloseVault(): Promise<Invitation<string, undefined>>;
-                        TransferVault(): Promise<Invitation<any, undefined>>;
-                    }>;
-                    vault: import("@endo/exo").Guarded<{
-                        getPublicTopics(): {
-                            vault: {
-                                description: string;
-                                subscriber: globalThis.Subscriber<VaultNotification>;
-                                storagePath: Promise<string>;
-                            };
-                        };
-                        makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                        makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                        makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                        getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                        getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                        getNormalizedDebt(): NormalizedDebt;
-                    }>;
-                    vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-                }, undefined>>;
-                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                getNormalizedDebt(): NormalizedDebt;
-            }>[];
+            vaultsInPlan: Vault[];
             liqSeat: ZCFSeat;
             totalCollateral: Amount<"nat">;
             totalDebt: Amount<"nat">;
@@ -363,9 +194,44 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
          * @param {Vault} vault
          * @returns {void}
          */
-        handleBalanceChange(oldDebtNormalized: NormalizedDebt, oldCollateral: Amount<"nat">, vaultId: VaultId, vaultPhase: import("./vault.js").VaultPhase, vault: import("@endo/exo").Guarded<{
-            getVaultSeat(): ZCFSeat;
-            initVaultKit(seat: ZCFSeat, storageNode: StorageNode): Promise<{
+        handleBalanceChange(oldDebtNormalized: NormalizedDebt, oldCollateral: Amount<"nat">, vaultId: VaultId, vaultPhase: import("./vault.js").VaultPhase, vault: Vault): void;
+    };
+    self: {
+        getGovernedParams(): GovernedParamGetters;
+        /** @param {ZCFSeat} seat */
+        makeVaultKit(seat: ZCFSeat): Promise<{
+            publicSubscribers: {
+                vault: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<VaultNotification>;
+                    storagePath: Promise<string>;
+                };
+            };
+            invitationMakers: import("@endo/exo").Guarded<{
+                AdjustBalances(): Promise<Invitation<string, undefined>>;
+                CloseVault(): Promise<Invitation<string, undefined>>;
+                TransferVault(): Promise<Invitation<any, undefined>>;
+            }>;
+            vault: import("@endo/exo").Guarded<{
+                getPublicTopics(): {
+                    vault: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<VaultNotification>;
+                        storagePath: Promise<string>;
+                    };
+                };
+                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
+                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
+                makeTransferInvitation(): Promise<Invitation<any, undefined>>;
+                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
+                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
+                getNormalizedDebt(): NormalizedDebt;
+            }>;
+            vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
+        }>;
+        getCollateralQuote(): PriceQuote;
+        getPublicFacet(): import("@endo/exo").Guarded<{
+            makeVaultInvitation(): Promise<Invitation<{
                 publicSubscribers: {
                     vault: {
                         description: string;
@@ -394,46 +260,199 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
                     getNormalizedDebt(): NormalizedDebt;
                 }>;
                 vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
+            }, undefined>>;
+            getQuotes(): import("@agoric/notifier").StoredNotifier<PriceQuote>;
+            getCompoundedInterest(): Ratio;
+            getPublicTopics(): {
+                asset: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<AssetState>;
+                metrics: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<MetricsNotification>;
+            };
+        }>;
+        lockOraclePrices(): PriceQuote;
+        /** @param {ERef<AuctioneerPublicFacet>} auctionPF */
+        liquidateVaults(auctionPF: ERef<AuctioneerPublicFacet>): Promise<void>;
+    };
+}>>[0], "metricsStorageNode">) => Promise<import("@endo/exo").GuardedKit<{
+    collateral: {
+        makeVaultInvitation(): Promise<Invitation<{
+            publicSubscribers: {
+                vault: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<VaultNotification>;
+                    storagePath: Promise<string>;
+                };
+            };
+            invitationMakers: import("@endo/exo").Guarded<{
+                AdjustBalances(): Promise<Invitation<string, undefined>>;
+                CloseVault(): Promise<Invitation<string, undefined>>;
+                TransferVault(): Promise<Invitation<any, undefined>>;
             }>;
-            liquidating(): void;
-            liquidated(): void;
-            abortLiquidation(): string;
-            makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-            makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-            makeTransferInvitation(): Promise<Invitation<{
-                publicSubscribers: {
+            vault: import("@endo/exo").Guarded<{
+                getPublicTopics(): {
                     vault: {
                         description: string;
                         subscriber: globalThis.Subscriber<VaultNotification>;
                         storagePath: Promise<string>;
                     };
                 };
-                invitationMakers: import("@endo/exo").Guarded<{
-                    AdjustBalances(): Promise<Invitation<string, undefined>>;
-                    CloseVault(): Promise<Invitation<string, undefined>>;
-                    TransferVault(): Promise<Invitation<any, undefined>>;
-                }>;
-                vault: import("@endo/exo").Guarded<{
-                    getPublicTopics(): {
+                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
+                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
+                makeTransferInvitation(): Promise<Invitation<any, undefined>>;
+                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
+                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
+                getNormalizedDebt(): NormalizedDebt;
+            }>;
+            vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
+        }, undefined>>;
+        getQuotes(): import("@agoric/notifier").StoredNotifier<PriceQuote>;
+        getCompoundedInterest(): Ratio;
+        getPublicTopics(): {
+            asset: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<AssetState>;
+            metrics: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<MetricsNotification>;
+        };
+    };
+    helper: {
+        /** Start non-durable processes (or restart if needed after vat restart) */
+        start(): void;
+        observeQuoteNotifier(): void;
+        /** @param {Timestamp} updateTime */
+        chargeAllVaults(updateTime: Timestamp): Promise<void>;
+        assetNotify(): Promise<void>;
+        burnToCoverDebt(debt: any, proceeds: any, seat: any): void;
+        sendToReserve(penalty: any, seat: any, seatKeyword?: string): void;
+        markLiquidating(debt: any, collateral: any): void;
+        /**
+         * @param {Amount<'nat'>} debt
+         * @param {Amount<'nat'>} collateral
+         * @param {Amount<'nat'>} overage
+         * @param {Amount<'nat'>} shortfall
+         */
+        markDoneLiquidating(debt: Amount<"nat">, collateral: Amount<"nat">, overage: Amount<"nat">, shortfall: Amount<"nat">): void;
+        writeMetrics(): Promise<void>;
+        /**
+         * 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 {Amount<'nat'>} totalCollateral
+         */
+        planProceedsDistribution(proceeds: AmountKeywordRecord, totalDebt: Amount<"nat">, oraclePriceAtStart: Pick<PriceQuote, "quoteAmount">, vaultData: MapStore<Vault, {
+            collateralAmount: Amount<"nat">;
+            debtAmount: Amount<"nat">;
+        }>, totalCollateral: Amount<"nat">): {
+            plan: import("./proceeds.js").DistributionPlan;
+            vaultsInPlan: import("@endo/exo").Guarded<{
+                getVaultSeat(): ZCFSeat;
+                initVaultKit(seat: ZCFSeat, storageNode: StorageNode): Promise<{
+                    publicSubscribers: {
                         vault: {
                             description: string;
                             subscriber: globalThis.Subscriber<VaultNotification>;
                             storagePath: Promise<string>;
                         };
                     };
-                    makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                    makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                    makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                    getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                    getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                    getNormalizedDebt(): NormalizedDebt;
+                    invitationMakers: import("@endo/exo").Guarded<{
+                        AdjustBalances(): Promise<Invitation<string, undefined>>;
+                        CloseVault(): Promise<Invitation<string, undefined>>;
+                        TransferVault(): Promise<Invitation<any, undefined>>;
+                    }>;
+                    vault: import("@endo/exo").Guarded<{
+                        getPublicTopics(): {
+                            vault: {
+                                description: string;
+                                subscriber: globalThis.Subscriber<VaultNotification>;
+                                storagePath: Promise<string>;
+                            };
+                        };
+                        makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
+                        makeCloseInvitation(): Promise<Invitation<string, undefined>>;
+                        makeTransferInvitation(): Promise<Invitation<any, undefined>>;
+                        getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
+                        getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
+                        getNormalizedDebt(): NormalizedDebt;
+                    }>;
+                    vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
                 }>;
-                vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-            }, undefined>>;
-            getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-            getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-            getNormalizedDebt(): NormalizedDebt;
-        }>): void;
+                liquidating(): void;
+                liquidated(): void;
+                abortLiquidation(): string;
+                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
+                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
+                makeTransferInvitation(): Promise<Invitation<VaultKit>>;
+                getCollateralAmount(): Amount<"nat">;
+                getCurrentDebt(): Amount<"nat">;
+                getNormalizedDebt(): import("./storeUtils.js").NormalizedDebt;
+            }>[];
+        };
+        /**
+         * 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 {Vault[]} obj.vaultsInPlan
+         * @param {ZCFSeat} obj.liqSeat
+         * @param {Amount<'nat'>} obj.totalCollateral
+         * @param {Amount<'nat'>} obj.totalDebt
+         * @returns {void}
+         */
+        distributeProceeds({ plan, vaultsInPlan, liqSeat, totalCollateral, totalDebt, }: {
+            plan: import("./proceeds.js").DistributionPlan;
+            vaultsInPlan: Vault[];
+            liqSeat: ZCFSeat;
+            totalCollateral: Amount<"nat">;
+            totalDebt: Amount<"nat">;
+        }): void;
+    };
+    manager: {
+        getGovernedParams(): GovernedParamGetters;
+        /**
+         * Look up the most recent price authority price to determine the max
+         * debt this manager config will allow for the collateral.
+         *
+         * @param {Amount<'nat'>} collateralAmount
+         */
+        maxDebtFor(collateralAmount: Amount<"nat">): import("@agoric/ertp/src/types.js").NatAmount;
+        /** @type {MintAndTransfer} */
+        mintAndTransfer(mintReceiver: ZCFSeat, toMint: Amount<"nat">, fee: Amount<"nat">, transfers: TransferPart[]): void;
+        /**
+         * @param {Amount<'nat'>} toBurn
+         * @param {ZCFSeat} seat
+         */
+        burn(toBurn: Amount<"nat">, seat: ZCFSeat): void;
+        getAssetSubscriber(): globalThis.Subscriber<AssetState>;
+        getCollateralBrand(): globalThis.Brand<"nat">;
+        getDebtBrand(): globalThis.Brand<"nat">;
+        /**
+         * Prepend with an identifier of this vault manager
+         *
+         * @param {string} base
+         */
+        scopeDescription(base: string): string;
+        /** coefficient on existing debt to calculate new debt */
+        getCompoundedInterest(): Ratio;
+        /**
+         * Called by a vault when its balances change.
+         *
+         * @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 {Vault} vault
+         * @returns {void}
+         */
+        handleBalanceChange(oldDebtNormalized: NormalizedDebt, oldCollateral: Amount<"nat">, vaultId: VaultId, vaultPhase: import("./vault.js").VaultPhase, vault: Vault): void;
     };
     self: {
         getGovernedParams(): GovernedParamGetters;
@@ -509,31 +528,7 @@ export function prepareVaultManagerKit(baggage: import("@agoric/swingset-liveslo
         }>;
         lockOraclePrices(): PriceQuote;
         /** @param {ERef<AuctioneerPublicFacet>} auctionPF */
-        liquidateVaults(auctionPF: globalThis.ERef<globalThis.GovernedPublicFacet<{
-            getElectorate: () => import("@agoric/ertp/src/types.js").SetAmount<import("@endo/patterns").Key>;
-            getStartFrequency: () => RelativeTime;
-            getClockStep: () => RelativeTime;
-            getStartingRate: () => bigint;
-            getLowestRate: () => bigint;
-            getDiscountStep: () => bigint;
-            getAuctionStartDelay: () => RelativeTime;
-            getPriceLockPeriod: () => RelativeTime;
-            makeBidInvitation(collateralBrand: Brand<"nat">): Promise<Invitation<string, import("../auction/auctionBook.js").OfferSpec>>;
-            getSchedules(): {
-                liveAuctionSchedule: import("../auction/scheduler.js").Schedule | null;
-                nextAuctionSchedule: import("../auction/scheduler.js").Schedule | null;
-            };
-            getScheduleUpdates(): globalThis.Subscriber<import("../auction/scheduler.js").ScheduleNotification>;
-            getBookDataUpdates(brand: any): globalThis.Subscriber<import("../auction/auctionBook.js").BookDataNotification>;
-            getPublicTopics(brand: any): {
-                bookData: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("../auction/auctionBook.js").BookDataNotification>;
-            } | {
-                schedule: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("../auction/scheduler.js").ScheduleNotification>;
-            };
-            makeDepositInvitation: () => Promise<Invitation<string, {
-                goal: import("@agoric/ertp/src/types.js").NatAmount;
-            }>>;
-        }>>): Promise<void>;
+        liquidateVaults(auctionPF: ERef<AuctioneerPublicFacet>): Promise<void>;
     };
 }>>;
 export function provideAndStartVaultManagerKits(baggage: import("@agoric/vat-data").Baggage): {
@@ -630,162 +625,22 @@ export type GovernedParamGetters = {
     getMintFee: () => Ratio;
     getMinInitialDebt: () => Amount<"nat">;
 };
-export type HeldParams = {
-    readonly debtMint: ZCFMint<"nat">;
-    readonly collateralBrand: Brand<"nat">;
-    readonly collateralUnit: Amount<"nat">;
-    readonly descriptionScope: string;
-    readonly startTimeStamp: Timestamp;
-    readonly storageNode: StorageNode;
-};
+export type HeldParams = Readonly<{
+    debtMint: ZCFMint<"nat">;
+    collateralBrand: Brand<"nat">;
+    collateralUnit: Amount<"nat">;
+    descriptionScope: string;
+    startTimeStamp: Timestamp;
+    storageNode: StorageNode;
+}>;
 export type ImmutableState = {
     assetTopicKit: import("@agoric/zoe/src/contractSupport/recorder.js").RecorderKit<AssetState>;
     debtBrand: Brand<"nat">;
-    liquidatingVaults: globalThis.SetStore<import("@endo/exo").Guarded<{
-        getVaultSeat(): ZCFSeat;
-        initVaultKit(seat: ZCFSeat, storageNode: StorageNode): Promise<{
-            publicSubscribers: {
-                vault: {
-                    description: string;
-                    subscriber: globalThis.Subscriber<VaultNotification>;
-                    storagePath: Promise<string>;
-                };
-            };
-            invitationMakers: import("@endo/exo").Guarded<{
-                AdjustBalances(): Promise<Invitation<string, undefined>>;
-                CloseVault(): Promise<Invitation<string, undefined>>;
-                TransferVault(): Promise<Invitation<any, undefined>>;
-            }>;
-            vault: import("@endo/exo").Guarded<{
-                getPublicTopics(): {
-                    vault: {
-                        description: string;
-                        subscriber: globalThis.Subscriber<VaultNotification>;
-                        storagePath: Promise<string>;
-                    };
-                };
-                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                getNormalizedDebt(): NormalizedDebt;
-            }>;
-            vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-        }>;
-        liquidating(): void;
-        liquidated(): void;
-        abortLiquidation(): string;
-        makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-        makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-        makeTransferInvitation(): Promise<Invitation<{
-            publicSubscribers: {
-                vault: {
-                    description: string;
-                    subscriber: globalThis.Subscriber<VaultNotification>;
-                    storagePath: Promise<string>;
-                };
-            };
-            invitationMakers: import("@endo/exo").Guarded<{
-                AdjustBalances(): Promise<Invitation<string, undefined>>;
-                CloseVault(): Promise<Invitation<string, undefined>>;
-                TransferVault(): Promise<Invitation<any, undefined>>;
-            }>;
-            vault: import("@endo/exo").Guarded<{
-                getPublicTopics(): {
-                    vault: {
-                        description: string;
-                        subscriber: globalThis.Subscriber<VaultNotification>;
-                        storagePath: Promise<string>;
-                    };
-                };
-                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                getNormalizedDebt(): NormalizedDebt;
-            }>;
-            vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-        }, undefined>>;
-        getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-        getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-        getNormalizedDebt(): NormalizedDebt;
-    }>>;
+    liquidatingVaults: SetStore<Vault>;
     metricsTopicKit: import("@agoric/zoe/src/contractSupport/recorder.js").RecorderKit<MetricsNotification>;
     poolIncrementSeat: ZCFSeat;
     retainedCollateralSeat: ZCFSeat;
-    unsettledVaults: globalThis.MapStore<string, import("@endo/exo").Guarded<{
-        getVaultSeat(): ZCFSeat;
-        initVaultKit(seat: ZCFSeat, storageNode: StorageNode): Promise<{
-            publicSubscribers: {
-                vault: {
-                    description: string;
-                    subscriber: globalThis.Subscriber<VaultNotification>;
-                    storagePath: Promise<string>;
-                };
-            };
-            invitationMakers: import("@endo/exo").Guarded<{
-                AdjustBalances(): Promise<Invitation<string, undefined>>;
-                CloseVault(): Promise<Invitation<string, undefined>>;
-                TransferVault(): Promise<Invitation<any, undefined>>;
-            }>;
-            vault: import("@endo/exo").Guarded<{
-                getPublicTopics(): {
-                    vault: {
-                        description: string;
-                        subscriber: globalThis.Subscriber<VaultNotification>;
-                        storagePath: Promise<string>;
-                    };
-                };
-                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                getNormalizedDebt(): NormalizedDebt;
-            }>;
-            vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-        }>;
-        liquidating(): void;
-        liquidated(): void;
-        abortLiquidation(): string;
-        makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-        makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-        makeTransferInvitation(): Promise<Invitation<{
-            publicSubscribers: {
-                vault: {
-                    description: string;
-                    subscriber: globalThis.Subscriber<VaultNotification>;
-                    storagePath: Promise<string>;
-                };
-            };
-            invitationMakers: import("@endo/exo").Guarded<{
-                AdjustBalances(): Promise<Invitation<string, undefined>>;
-                CloseVault(): Promise<Invitation<string, undefined>>;
-                TransferVault(): Promise<Invitation<any, undefined>>;
-            }>;
-            vault: import("@endo/exo").Guarded<{
-                getPublicTopics(): {
-                    vault: {
-                        description: string;
-                        subscriber: globalThis.Subscriber<VaultNotification>;
-                        storagePath: Promise<string>;
-                    };
-                };
-                makeAdjustBalancesInvitation(): Promise<Invitation<string, undefined>>;
-                makeCloseInvitation(): Promise<Invitation<string, undefined>>;
-                makeTransferInvitation(): Promise<Invitation<any, undefined>>;
-                getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-                getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-                getNormalizedDebt(): NormalizedDebt;
-            }>;
-            vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
-        }, undefined>>;
-        getCollateralAmount(): import("@agoric/ertp/src/types.js").NatAmount;
-        getCurrentDebt(): import("@agoric/ertp/src/types.js").NatAmount;
-        getNormalizedDebt(): NormalizedDebt;
-    }>>;
+    unsettledVaults: MapStore<string, Vault>;
 };
 export type MutableState = {
     compoundedInterest: Ratio;