@agoric/inter-protocol 0.16.1 → 0.16.2-calypso-dev-84eb287.0

package/src/provisionPoolKit.d.ts

@@ -0,0 +1,367 @@
+export function makeBridgeProvisionTool(sendInitialPayment: (depositBank: ERef<Bank>) => Promise<void>, onProvisioned: () => void): ({ bankManager, namesByAddressAdmin, walletFactory, }: ProvisionPoolKitReferences) => {
+    fromBridge: (obj: any) => Promise<void>;
+} & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+    fromBridge: (obj: any) => Promise<void>;
+}>;
+export function prepareProvisionPoolKit(baggage: import("@agoric/vat-data").Baggage, { makeRecorderKit, params, poolBank, zcf }: {
+    makeRecorderKit: import("@agoric/zoe/src/contractSupport/recorder.js").MakeRecorderKit;
+    params: any;
+    poolBank: import("@endo/far").ERef<Bank>;
+    zcf: ZCF;
+}): ({ poolBrand, storageNode }: {
+    poolBrand: Brand<"nat">;
+    storageNode: ERef<StorageNode>;
+}) => Promise<import("@endo/exo").GuardedKit<{
+    machine: {
+        /** @param {string[]} oldAddresses */
+        addRevivableAddresses(oldAddresses: string[]): void;
+        getWalletReviver(): import("@endo/exo").Guarded<{
+            /** @param {string} address */
+            reviveWallet(address: string): Promise<{
+                handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+                getDepositFacet(): import("@endo/exo").Guarded<{
+                    receive(payment: Payment): Promise<Amount>;
+                }>;
+                getOffersFacet(): import("@endo/exo").Guarded<{
+                    executeOffer(offerSpec: OfferSpec): Promise<void>;
+                    tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+                }>;
+                getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                getPublicTopics(): {
+                    current: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                        storagePath: Promise<string>;
+                    };
+                    updates: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                        storagePath: Promise<string>;
+                    };
+                };
+                repairWalletForIncarnation2(key: object): void;
+            } & import("../../../node_modules/@endo/exo/src/get-interface").GetInterfaceGuard<{
+                handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+                getDepositFacet(): import("@endo/exo").Guarded<{
+                    receive(payment: Payment): Promise<Amount>;
+                }>;
+                getOffersFacet(): import("@endo/exo").Guarded<{
+                    executeOffer(offerSpec: OfferSpec): Promise<void>;
+                    tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+                }>;
+                getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                getPublicTopics(): {
+                    current: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                        storagePath: Promise<string>;
+                    };
+                    updates: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                        storagePath: Promise<string>;
+                    };
+                };
+                repairWalletForIncarnation2(key: object): void;
+            }> & import("@endo/eventual-send").RemotableBrand<{}, {
+                handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+                getDepositFacet(): import("@endo/exo").Guarded<{
+                    receive(payment: Payment): Promise<Amount>;
+                }>;
+                getOffersFacet(): import("@endo/exo").Guarded<{
+                    executeOffer(offerSpec: OfferSpec): Promise<void>;
+                    tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+                }>;
+                getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                getPublicTopics(): {
+                    current: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                        storagePath: Promise<string>;
+                    };
+                    updates: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                        storagePath: Promise<string>;
+                    };
+                };
+                repairWalletForIncarnation2(key: object): void;
+            } & import("../../../node_modules/@endo/exo/src/get-interface").GetInterfaceGuard<{
+                handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+                getDepositFacet(): import("@endo/exo").Guarded<{
+                    receive(payment: Payment): Promise<Amount>;
+                }>;
+                getOffersFacet(): import("@endo/exo").Guarded<{
+                    executeOffer(offerSpec: OfferSpec): Promise<void>;
+                    tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+                }>;
+                getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                getPublicTopics(): {
+                    current: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                        storagePath: Promise<string>;
+                    };
+                    updates: {
+                        description: string;
+                        subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                        storagePath: Promise<string>;
+                    };
+                };
+                repairWalletForIncarnation2(key: object): void;
+            }>> & import("@endo/marshal").RemotableObject>;
+            /**
+             * @param {string} address
+             * @returns {boolean} isRevive
+             */
+            ackWallet(address: string): boolean;
+        }>;
+        /** @param {ProvisionPoolKitReferences} erefs */
+        setReferences(erefs: ProvisionPoolKitReferences): Promise<void>;
+        makeHandler(): {
+            fromBridge: (obj: any) => Promise<void>;
+        } & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+            fromBridge: (obj: any) => Promise<void>;
+        }>;
+        /**
+         * @param {Brand} brand
+         * @param {PsmInstance} instance
+         */
+        initPSM(brand: Brand, instance: PsmInstance): void;
+    };
+    walletReviver: {
+        /** @param {string} address */
+        reviveWallet(address: string): Promise<{
+            handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+            getDepositFacet(): import("@endo/exo").Guarded<{
+                receive(payment: Payment): Promise<Amount>;
+            }>;
+            getOffersFacet(): import("@endo/exo").Guarded<{
+                executeOffer(offerSpec: OfferSpec): Promise<void>;
+                tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+            }>;
+            getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+            getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+            getPublicTopics(): {
+                current: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                    storagePath: Promise<string>;
+                };
+                updates: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                    storagePath: Promise<string>;
+                };
+            };
+            repairWalletForIncarnation2(key: object): void;
+        } & import("../../../node_modules/@endo/exo/src/get-interface").GetInterfaceGuard<{
+            handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+            getDepositFacet(): import("@endo/exo").Guarded<{
+                receive(payment: Payment): Promise<Amount>;
+            }>;
+            getOffersFacet(): import("@endo/exo").Guarded<{
+                executeOffer(offerSpec: OfferSpec): Promise<void>;
+                tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+            }>;
+            getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+            getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+            getPublicTopics(): {
+                current: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                    storagePath: Promise<string>;
+                };
+                updates: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                    storagePath: Promise<string>;
+                };
+            };
+            repairWalletForIncarnation2(key: object): void;
+        }> & import("@endo/eventual-send").RemotableBrand<{}, {
+            handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+            getDepositFacet(): import("@endo/exo").Guarded<{
+                receive(payment: Payment): Promise<Amount>;
+            }>;
+            getOffersFacet(): import("@endo/exo").Guarded<{
+                executeOffer(offerSpec: OfferSpec): Promise<void>;
+                tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+            }>;
+            getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+            getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+            getPublicTopics(): {
+                current: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                    storagePath: Promise<string>;
+                };
+                updates: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                    storagePath: Promise<string>;
+                };
+            };
+            repairWalletForIncarnation2(key: object): void;
+        } & import("../../../node_modules/@endo/exo/src/get-interface").GetInterfaceGuard<{
+            handleBridgeAction(actionCapData: import("@endo/marshal").CapData<string | null>, canSpend?: boolean | undefined): Promise<void>;
+            getDepositFacet(): import("@endo/exo").Guarded<{
+                receive(payment: Payment): Promise<Amount>;
+            }>;
+            getOffersFacet(): import("@endo/exo").Guarded<{
+                executeOffer(offerSpec: OfferSpec): Promise<void>;
+                tryExitOffer(offerId: import("@agoric/smart-wallet/src/offers").OfferId): Promise<void>;
+            }>;
+            getCurrentSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+            getUpdatesSubscriber(): globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+            getPublicTopics(): {
+                current: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").CurrentWalletRecord>;
+                    storagePath: Promise<string>;
+                };
+                updates: {
+                    description: string;
+                    subscriber: globalThis.Subscriber<import("@agoric/smart-wallet/src/smartWallet").UpdateRecord>;
+                    storagePath: Promise<string>;
+                };
+            };
+            repairWalletForIncarnation2(key: object): void;
+        }>> & import("@endo/marshal").RemotableObject>;
+        /**
+         * @param {string} address
+         * @returns {boolean} isRevive
+         */
+        ackWallet(address: string): boolean;
+    };
+    helper: {
+        publishMetrics(): void;
+        onTrade(converted: any): void;
+        onSendFunds(provided: any): void;
+        onProvisioned(): void;
+        /** @param {ERef<Bank>} destBank */
+        sendInitialPayment(destBank: ERef<Bank>): Promise<void>;
+        /**
+         * @param {ERef<Purse>} exchangePurse
+         * @param {ERef<Brand>} brand
+         */
+        watchCurrentAmount(exchangePurse: ERef<Purse>, brand: ERef<Brand>): void;
+        watchAssetSubscription(): Promise<undefined>;
+        /**
+         * @param {object} [options]
+         * @param {MetricsNotification} [options.metrics]
+         */
+        start({ metrics }?: {
+            metrics?: MetricsNotification | undefined;
+        } | undefined): void;
+        /**
+         * @param {ERef<Payment>} payIn
+         * @param {Amount} amount
+         * @param {PsmInstance} instance
+         */
+        swap(payIn: ERef<Payment>, amount: Amount, instance: PsmInstance): Promise<import("@agoric/ertp/src/types.js").NatAmount>;
+    };
+    public: {
+        getPublicTopics(): {
+            metrics: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<MetricsNotification>;
+        };
+    };
+}>>;
+export type PsmInstance = import("@agoric/zoe/src/zoeService/utils.js").Instance<(zcf: ZCF<GovernanceTerms<{
+    GiveMintedFee: "ratio";
+    WantMintedFee: "ratio";
+    MintLimit: "amount";
+}> & {
+    anchorBrand: Brand<"nat">;
+    anchorPerMinted: Ratio;
+}>, privateArgs: {
+    feeMintAccess: FeeMintAccess;
+    initialPoserInvitation: Invitation;
+    storageNode: StorageNode;
+    marshaller: Marshaller;
+}, baggage: import("@agoric/vat-data").Baggage) => Promise<{
+    creatorFacet: import("@endo/exo").Guarded<{
+        getParamMgrRetriever: () => {
+            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager").TypedParamManager<{
+                GiveMintedFee: "ratio";
+                MintLimit: "amount";
+                WantMintedFee: "ratio";
+            } & {
+                Electorate: "invitation";
+            }>;
+        } & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
+            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager").TypedParamManager<{
+                GiveMintedFee: "ratio";
+                MintLimit: "amount";
+                WantMintedFee: "ratio";
+            } & {
+                Electorate: "invitation";
+            }>;
+        }>;
+        getInvitation: (name: any) => Promise<Invitation<unknown, undefined>>;
+        getLimitedCreatorFacet: () => import("@endo/exo").Guarded<{
+            getRewardAllocation(): Allocation;
+            makeCollectFeesInvitation(): Promise<Invitation<string, undefined>>;
+            makeRestoreMetricsInvitation(): Promise<Invitation<void, Omit<import("@agoric/inter-protocol/src/psm/psm.js").MetricsNotification, "anchorPoolBalance">>>;
+        }>;
+        getGovernedApis: () => globalThis.GovernedApis;
+        getGovernedApiNames: () => string[];
+        setOfferFilter: (strings: any) => Promise<void>;
+    }>;
+    publicFacet: import("@endo/exo").Guarded<{
+        getAmount: (name: string) => Amount;
+        getBrand: (name: string) => Brand;
+        getInstance: (name: string) => Instance;
+        getInstallation: (name: string) => Installation;
+        getInvitationAmount: (name: string) => InvitationAmount;
+        getNat: (name: string) => bigint;
+        getRatio: (name: string) => Ratio;
+        getString: (name: string) => string;
+        getTimestamp: (name: string) => import("@agoric/time").TimestampRecord;
+        getRelativeTime: (name: string) => import("@agoric/time").RelativeTimeRecord;
+        getUnknown: (name: string) => any;
+        getSubscription: () => globalThis.StoredSubscription<globalThis.GovernanceSubscriptionState>;
+        getGovernedParams: () => ERef<globalThis.ParamStateRecord>;
+        getMetrics(): globalThis.Subscriber<import("@agoric/inter-protocol/src/psm/psm.js").MetricsNotification>;
+        getPoolBalance(): import("@agoric/ertp/src/types.js").NatAmount;
+        getPublicTopics(): {
+            metrics: import("@agoric/zoe/src/contractSupport/topics.js").PublicTopic<import("@agoric/inter-protocol/src/psm/psm.js").MetricsNotification>;
+        };
+        makeWantMintedInvitation(): Promise<Invitation<void, undefined>>;
+        makeGiveMintedInvitation(): Promise<Invitation<void, undefined>>;
+    }>;
+}>>;
+export type ProvisionPoolKitReferences = {
+    bankManager: ERef<BankManager>;
+    namesByAddressAdmin: ERef<import("@agoric/vats").NameAdmin>;
+    walletFactory: ERef<import("@agoric/vats/src/core/startWalletFactory.js").WalletFactoryStartResult["creatorFacet"]>;
+};
+/**
+ * Metrics naming scheme is that nouns are
+ *   present values and past-participles are accumulative.
+ */
+export type MetricsNotification = {
+    /**
+     * count of new wallets provisioned
+     */
+    walletsProvisioned: bigint;
+    /**
+     * running sum of Minted provided
+     * to new wallets
+     */
+    totalMintedProvided: Amount<"nat">;
+    /**
+     * running sum of Minted ever
+     * received by the contract from PSM
+     */
+    totalMintedConverted: Amount<"nat">;
+};
+import type { Bank } from '@agoric/vats/src/vat-bank.js';
+import type { ERef } from '@endo/far';
+import type { Amount } from '@agoric/ertp/src/types.js';
+import type { BankManager } from '@agoric/vats/src/vat-bank.js';
+//# sourceMappingURL=provisionPoolKit.d.ts.map

package/src/provisionPoolKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisionPoolKit.d.ts","sourceRoot":"","sources":["provisionPoolKit.js"],"names":[],"mappings":"AAuEO,4DAHI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,iBAC1C,MAAM,IAAI,0DAGP,0BAA0B;;;;GA+BvC;AAWM,iDARI,OAAO,kBAAkB,EAAE,OAAO,8CAClC;IACV,eAAmB,EAAE,OAAO,6CAA6C,EAAE,eAAe,CAAC;IAC3F,MAAU,EAAE,GAAG,CAAC;IAChB,QAAY,EAAE,OAAO,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,GAAO,EAAE,GAAG,CAAC;CACV,gCA0YC;IAA2B,SAAS,EAA5B,KAAK,CAAC,KAAK,CAAC;IACY,WAAW,EAAnC,KAAK,WAAW,CAAC;CAC3B;;QA7TK,qCAAqC;4CAAzB,MAAM,EAAE;;YA+CpB,8BAA8B;kCAAlB,MAAM;yDA4R0yoB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAvQ30oB;;;eAGG;+BAFQ,MAAM,GACJ,OAAO;;QA9DpB,gDAAgD;6BAApC,0BAA0B;;;;;;QA6BtC;;;WAGG;uBAFQ,KAAK,YACL,WAAW;;;QAQtB,8BAA8B;8BAAlB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqBlB;;;WAGG;2BAFQ,MAAM,GACJ,OAAO;;;;;;;QAgDpB,mCAAmC;qCAAvB,KAAK,IAAI,CAAC;QA0BtB;;;WAGG;0CAFQ,KAAK,KAAK,CAAC,SACX,KAAK,KAAK,CAAC;;QA2FtB;;;WAGG;;;;QAiCH;;;;WAIG;oBAHQ,KAAK,OAAO,CAAC,UACb,MAAM,YACN,WAAW;;;;;;;IAsD7B;0BAjeY,OAAO,qCAAqC,EAAE,QAAQ,CAClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA6WkB,cAAc;kDACV,cACX;;;;;;;;;;;;EA/W8C,CACtD;;iBAKU,KAAK,WAAW,CAAC;yBACjB,KAAK,OAAO,cAAc,EAAE,SAAS,CAAC;mBACtC,KACb,OAAW,6CAA6C,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAC/F;;;;;;;;;;wBAMU,MAAM;;;;;yBACN,OAAO,KAAK,CAAC;;;;;0BAEb,OAAO,KAAK,CAAC;;0BAxBS,8BAA8B;0BAF3C,WAAW;4BACT,2BAA2B;iCAChB,8BAA8B"}