@agoric/inter-protocol 0.16.2-dev-3294e0c.0.3294e0c → 0.16.2-dev-488dec7.0.488dec7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/inter-protocol",
-  "version": "0.16.2-dev-3294e0c.0.3294e0c",
+  "version": "0.16.2-dev-488dec7.0.488dec7",
   "description": "Core cryptoeconomy contracts",
   "type": "module",
   "main": "src/index.js",
@@ -16,7 +16,7 @@
     "lint-fix": "yarn lint:eslint --fix",
     "lint": "yarn run -T run-s --continue-on-error 'lint:*'",
     "lint:eslint": "node ../../scripts/eslint-repo.mjs .",
-    "lint:types": "yarn run -T tsc"
+    "lint:types": "yarn run -T tsgo --tsBuildInfoFile tsconfig.tsgo.tsbuildinfo"
   },
   "repository": {
     "type": "git",
@@ -29,17 +29,17 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/base-zone": "0.1.1-dev-3294e0c.0.3294e0c",
-    "@agoric/ertp": "0.16.3-dev-3294e0c.0.3294e0c",
-    "@agoric/governance": "0.10.4-dev-3294e0c.0.3294e0c",
-    "@agoric/internal": "0.3.3-dev-3294e0c.0.3294e0c",
-    "@agoric/notifier": "0.6.3-dev-3294e0c.0.3294e0c",
-    "@agoric/store": "0.9.3-dev-3294e0c.0.3294e0c",
-    "@agoric/time": "0.3.3-dev-3294e0c.0.3294e0c",
-    "@agoric/vat-data": "0.5.3-dev-3294e0c.0.3294e0c",
-    "@agoric/vats": "0.15.2-dev-3294e0c.0.3294e0c",
-    "@agoric/zoe": "0.26.3-dev-3294e0c.0.3294e0c",
-    "@agoric/zone": "0.2.3-dev-3294e0c.0.3294e0c",
+    "@agoric/base-zone": "0.1.1-dev-488dec7.0.488dec7",
+    "@agoric/ertp": "0.16.3-dev-488dec7.0.488dec7",
+    "@agoric/governance": "0.10.4-dev-488dec7.0.488dec7",
+    "@agoric/internal": "0.3.3-dev-488dec7.0.488dec7",
+    "@agoric/notifier": "0.6.3-dev-488dec7.0.488dec7",
+    "@agoric/store": "0.9.3-dev-488dec7.0.488dec7",
+    "@agoric/time": "0.3.3-dev-488dec7.0.488dec7",
+    "@agoric/vat-data": "0.5.3-dev-488dec7.0.488dec7",
+    "@agoric/vats": "0.15.2-dev-488dec7.0.488dec7",
+    "@agoric/zoe": "0.26.3-dev-488dec7.0.488dec7",
+    "@agoric/zone": "0.2.3-dev-488dec7.0.488dec7",
     "@endo/captp": "^4.4.8",
     "@endo/errors": "^1.2.13",
     "@endo/eventual-send": "^1.3.4",
@@ -50,9 +50,9 @@
     "jessie.js": "^0.3.4"
   },
   "devDependencies": {
-    "@agoric/smart-wallet": "0.5.4-dev-3294e0c.0.3294e0c",
-    "@agoric/swingset-liveslots": "0.10.3-dev-3294e0c.0.3294e0c",
-    "@agoric/swingset-vat": "0.32.3-dev-3294e0c.0.3294e0c",
+    "@agoric/smart-wallet": "0.5.4-dev-488dec7.0.488dec7",
+    "@agoric/swingset-liveslots": "0.10.3-dev-488dec7.0.488dec7",
+    "@agoric/swingset-vat": "0.32.3-dev-488dec7.0.488dec7",
     "@endo/bundle-source": "^4.1.2",
     "@endo/init": "^1.1.12",
     "@endo/promise-kit": "^1.1.13",
@@ -81,5 +81,5 @@
   "typeCoverage": {
     "atLeast": 95.3
   },
-  "gitHead": "3294e0c1e81f8d145c6b57624d080908b935f524"
+  "gitHead": "488dec73a49f5a4fd66eea6521638ce5ba11dd2f"
 }

package/source-spec-registry.js

@@ -25,10 +25,8 @@ export const interProtocolBundleSpecs = {
   },
   provisionPool: {
     bundleName: 'provisionPool',
-    packagePath: '@agoric/inter-protocol/src/provisionPool.js',
-    sourceSpec: resolveSourceSpec(
-      '@agoric/inter-protocol/src/provisionPool.js',
-    ),
+    packagePath: '@agoric/vats/src/provisionPool.js',
+    sourceSpec: resolveSourceSpec('@agoric/vats/src/provisionPool.js'),
   },
   priceAggregator: {
     bundleName: 'priceAggregator',

package/src/proposals/econ-behaviors.js

@@ -16,7 +16,7 @@ import { makeGovernedTerms as makeGovernedVFTerms } from '../vaultFactory/params
  * @import {AdminFacet, Instance} from '@agoric/zoe';
  * @import {MapStore, SetStore} from '@agoric/store';
  * @import {RelativeTime} from '@agoric/time';
- * @import {WellKnownSpaces} from '@agoric/vats/src/core/types.js';
+ * @import {WellKnownSpaces, ContractInstallationPromises, ContractInstancePromises} from '@agoric/vats/src/core/types.js';
  * @import {ChainBootstrapSpace} from '@agoric/vats/src/core/types.js';
  * @import {PromiseSpaceOf} from '@agoric/vats/src/core/types.js';
  * @import {CommitteeElectorateCreatorFacet} from '@agoric/governance/src/committee.js';
@@ -62,7 +62,32 @@ export const SECONDS_PER_WEEK = 7n * SECONDS_PER_DAY;
  */
 
 /**
- * @typedef {WellKnownSpaces & ChainBootstrapSpace & EconomyBootstrapSpace} EconomyBootstrapPowers
+ * Contracts that Inter Protocol adds to the well-known spaces. Defined here
+ * rather than in @agoric/vats so that the base layer doesn't depend on this
+ * package.
+ *
+ * @typedef {{
+ *   econCommitteeCharter: typeof import('../econCommitteeCharter.js').start;
+ *   feeDistributor: typeof import('../feeDistributor.js').start;
+ *   psm: typeof import('../psm/psm.js').start;
+ *   priceAggregator: typeof import('../price/fluxAggregatorContract.js').start;
+ *   reserve: typeof import('../reserve/assetReserve.js').start;
+ *   VaultFactory: VFStart;
+ * }} EconContractStarts
+ *
+ * @typedef {{
+ *   installation: {
+ *     consume: ContractInstallationPromises<EconContractStarts>;
+ *   };
+ *   instance: {
+ *     consume: ContractInstancePromises<EconContractStarts>;
+ *   };
+ * }} EconContractSpaces
+ *
+ * @typedef {WellKnownSpaces &
+ *   EconContractSpaces &
+ *   ChainBootstrapSpace &
+ *   EconomyBootstrapSpace} EconomyBootstrapPowers
  *
  *
  * @typedef {PromiseSpaceOf<{

package/src/proposals/startPSM.js

@@ -105,7 +105,6 @@ export const startPSM = async (
       feeMintAccess: feeMintAccessP,
       economicCommitteeCreatorFacet,
       econCharterKit,
-      provisionPoolStartResult,
       chainStorage,
       chainTimerService,
       psmKit,
@@ -285,10 +284,6 @@ export const startPSM = async (
       governorFacets.creatorFacet,
       instanceKey,
     ),
-    E(E.get(provisionPoolStartResult).creatorFacet).initPSM(
-      anchorBrand,
-      newpsmKit.psm,
-    ),
   ]);
 };
 harden(startPSM);

package/src/vaultFactory/vaultDirector.d.ts

@@ -43,24 +43,24 @@ declare function prepareVaultDirector(baggage: Baggage, zcf: VaultFactoryZCF, di
     creator: {
         getParamMgrRetriever: () => {
             /** @param {VaultFactoryParamPath} paramPath */
-            get: (paramPath?: VaultFactoryParamPath) => VaultDirectorParamManager | TypedParamManager<{
+            get: (paramPath?: VaultFactoryParamPath) => TypedParamManager<{
                 DebtLimit: "amount";
                 InterestRate: "ratio";
                 LiquidationPadding: "ratio";
                 LiquidationMargin: "ratio";
                 LiquidationPenalty: "ratio";
                 MintFee: "ratio";
-            }>;
+            }> | VaultDirectorParamManager;
         } & import("@endo/marshal").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
             /** @param {VaultFactoryParamPath} paramPath */
-            get: (paramPath?: VaultFactoryParamPath) => VaultDirectorParamManager | TypedParamManager<{
+            get: (paramPath?: VaultFactoryParamPath) => TypedParamManager<{
                 DebtLimit: "amount";
                 InterestRate: "ratio";
                 LiquidationPadding: "ratio";
                 LiquidationMargin: "ratio";
                 LiquidationPenalty: "ratio";
                 MintFee: "ratio";
-            }>;
+            }> | VaultDirectorParamManager;
         }>;
         /** @param {string} name */
         getInvitation(name: string): Promise<import("@agoric/zoe").Invitation>;

package/src/vaultFactory/vaultFactory.d.ts

@@ -20,23 +20,23 @@ export function start(zcf: VaultFactoryZCF, privateArgs: {
 }, baggage: Baggage): Promise<{
     creatorFacet: import("@endo/exo").Guarded<{
         getParamMgrRetriever: () => {
-            get: (paramPath?: import("./types.js").VaultFactoryParamPath) => import("./vaultDirector.js").VaultDirectorParamManager | import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
+            get: (paramPath?: import("./types.js").VaultFactoryParamPath) => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
                 DebtLimit: "amount";
                 InterestRate: "ratio";
                 LiquidationPadding: "ratio";
                 LiquidationMargin: "ratio";
                 LiquidationPenalty: "ratio";
                 MintFee: "ratio";
-            }>;
+            }> | import("./vaultDirector.js").VaultDirectorParamManager;
         } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
-            get: (paramPath?: import("./types.js").VaultFactoryParamPath) => import("./vaultDirector.js").VaultDirectorParamManager | import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
+            get: (paramPath?: import("./types.js").VaultFactoryParamPath) => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
                 DebtLimit: "amount";
                 InterestRate: "ratio";
                 LiquidationPadding: "ratio";
                 LiquidationMargin: "ratio";
                 LiquidationPenalty: "ratio";
                 MintFee: "ratio";
-            }>;
+            }> | import("./vaultDirector.js").VaultDirectorParamManager;
         }>;
         getInvitation(name: string): Promise<Invitation>;
         getLimitedCreatorFacet(): import("@endo/exo").Guarded<{

package/src/provisionPool.d.ts

@@ -1,87 +0,0 @@
-/**
- * @import {Remote} from '@agoric/internal';
- * @import {Amount, Brand, Payment, Purse} from '@agoric/ertp';
- * @import {ContractMeta, Invitation, StandardTerms, ZCF} from '@agoric/zoe';
- * @import {GovernanceTerms} from '@agoric/governance/src/types.js';
- * @import {ERef} from '@endo/far';
- * @import {Bank} from '@agoric/vats/src/vat-bank.js';
- * @import {MetricsNotification} from './provisionPoolKit.js';
- * @import {Baggage} from '@agoric/vat-data';
- * @import {StorageNode} from '@agoric/internal/src/lib-chainStorage.js';
- * @import {Marshaller} from '@agoric/internal/src/lib-chainStorage.js';
- */
-/** @type {ContractMeta<typeof start>} */
-export const meta: ContractMeta<typeof start>;
-export function start(zcf: ZCF<ProvisionTerms>, privateArgs: {
-    poolBank: ERef<Bank>;
-    initialPoserInvitation: Invitation;
-    storageNode: Remote<StorageNode>;
-    marshaller: Remote<Marshaller>;
-    metricsOverride?: MetricsNotification;
-    governedParamOverrides?: Record<string, Amount | undefined>;
-}, baggage: Baggage): Promise<{
-    creatorFacet: import("@endo/exo").Guarded<{
-        getParamMgrRetriever: () => {
-            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
-                PerAccountInitialAmount: "amount";
-            } & {
-                Electorate: "invitation";
-            }>;
-        } & import("@endo/pass-style").RemotableObject<`Alleged: ${string}`> & import("@endo/eventual-send").RemotableBrand<{}, {
-            get: () => import("@agoric/governance/src/contractGovernance/typedParamManager.js").TypedParamManager<{
-                PerAccountInitialAmount: "amount";
-            } & {
-                Electorate: "invitation";
-            }>;
-        }>;
-        getInvitation: (name: any) => Promise<Invitation>;
-        getLimitedCreatorFacet: () => {
-            addRevivableAddresses: (oldAddresses: string[]) => void;
-            getWalletReviver: () => ERef<any>;
-            setReferences: (erefs: import("./provisionPoolKit.js").ProvisionPoolKitReferences) => Promise<void>;
-            makeHandler: () => ERef<import("@agoric/vats").BridgeHandler>;
-            initPSM: (brand: Brand, instance: import("@agoric/zoe/src/zoeService/utils.js").Instance<typeof import("./psm/psm.js").start>) => void;
-        };
-        getGovernedApis: () => import("@agoric/governance").GovernedApis;
-        getGovernedApiNames: () => string[];
-        setOfferFilter: (strings: any) => Promise<void>;
-    }>;
-    publicFacet: import("@endo/exo").Guarded<{
-        getAmount: (name: string) => Amount;
-        getBrand: (name: string) => Brand;
-        getInstance: (name: string) => import("@agoric/zoe").Instance;
-        getInstallation: (name: string) => import("@agoric/zoe").Installation;
-        getInvitationAmount: (name: string) => import("@agoric/zoe").InvitationAmount;
-        getNat: (name: string) => bigint;
-        getRatio: (name: string) => import("@agoric/ertp").Ratio;
-        getString: (name: string) => string;
-        getTimestamp: (name: string) => import("@agoric/time").TimestampRecord;
-        getRelativeTime: (name: string) => import("@agoric/time").RelativeTimeRecord;
-        getUnknown: (name: string) => any;
-        getSubscription: () => import("@agoric/notifier").StoredSubscription<import("@agoric/governance").GovernanceSubscriptionState>;
-        getGovernedParams: () => ERef<import("@agoric/governance").ParamStateRecord>;
-        getMetrics(): Promise<any>;
-        getPublicTopics(): Promise<any>;
-    }>;
-}>;
-/**
- * TODO: ERef<GovernedCreatorFacet<ProvisionCreator>>
- */
-export type ProvisionTerms = StandardTerms & GovernanceTerms<{
-    PerAccountInitialAmount: "amount";
-}>;
-import type { ContractMeta } from '@agoric/zoe';
-import type { ZCF } from '@agoric/zoe';
-import type { Bank } from '@agoric/vats/src/vat-bank.js';
-import type { ERef } from '@endo/far';
-import type { Invitation } from '@agoric/zoe';
-import type { StorageNode } from '@agoric/internal/src/lib-chainStorage.js';
-import type { Remote } from '@agoric/internal';
-import type { Marshaller } from '@agoric/internal/src/lib-chainStorage.js';
-import type { MetricsNotification } from './provisionPoolKit.js';
-import type { Amount } from '@agoric/ertp';
-import type { Baggage } from '@agoric/vat-data';
-import type { Brand } from '@agoric/ertp';
-import type { StandardTerms } from '@agoric/zoe';
-import type { GovernanceTerms } from '@agoric/governance/src/types.js';
-//# sourceMappingURL=provisionPool.d.ts.map

package/src/provisionPool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provisionPool.d.ts","sourceRoot":"","sources":["provisionPool.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;GAWG;AAEH,yCAAyC;AACzC,mBADW,aAAa,OAAO,KAAK,CAAC,CAgBnC;AAoBK,2BAXI,IAAI,cAAc,CAAC,eACnB;IACN,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IACrB,sBAAsB,EAAE,UAAU,CAAC;IACnC,WAAW,EAAE,OAAO,WAAW,CAAC,CAAC;IACjC,UAAU,EAAE,OAAO,UAAU,CAAC,CAAC;IAC/B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7D,WACO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EjB;;;;6BA3FY,aAAa,GACzB,gBAAoB;IACd,uBAAuB,EAAE,QAAQ,CAAC;CACnC,CAAC;kCAjCwD,aAAa;yBAAb,aAAa;0BAGrD,8BAA8B;0BAD9B,WAAW;gCAF6B,aAAa;iCAM9C,0CAA0C;4BAR/C,kBAAkB;gCASd,0CAA0C;yCAHjC,uBAAuB;4BALb,cAAc;6BAMpC,kBAAkB;2BANI,cAAc;mCACC,aAAa;qCAC1C,iCAAiC"}

package/src/provisionPool.js

@@ -1,145 +0,0 @@
-import {
-  handleParamGovernance,
-  ParamTypes,
-  publicMixinAPI,
-} from '@agoric/governance';
-import { InvitationShape } from '@agoric/governance/src/typeGuards.js';
-import { wrapRemoteMarshaller } from '@agoric/internal/src/marshal/wrap-marshaller.js';
-import { M } from '@agoric/store';
-import { prepareExo } from '@agoric/vat-data';
-import { provideSingleton } from '@agoric/zoe/src/contractSupport/durability.js';
-import { prepareRecorderKitMakers } from '@agoric/zoe/src/contractSupport/recorder.js';
-import { TopicsRecordShape } from '@agoric/zoe/src/contractSupport/topics.js';
-import { makeDurableZone } from '@agoric/zone/durable.js';
-import {
-  prepareBridgeProvisionTool,
-  prepareProvisionPoolKit,
-} from './provisionPoolKit.js';
-
-/**
- * @import {Remote} from '@agoric/internal';
- * @import {Amount, Brand, Payment, Purse} from '@agoric/ertp';
- * @import {ContractMeta, Invitation, StandardTerms, ZCF} from '@agoric/zoe';
- * @import {GovernanceTerms} from '@agoric/governance/src/types.js';
- * @import {ERef} from '@endo/far';
- * @import {Bank} from '@agoric/vats/src/vat-bank.js';
- * @import {MetricsNotification} from './provisionPoolKit.js';
- * @import {Baggage} from '@agoric/vat-data';
- * @import {StorageNode} from '@agoric/internal/src/lib-chainStorage.js';
- * @import {Marshaller} from '@agoric/internal/src/lib-chainStorage.js';
- */
-
-/** @type {ContractMeta<typeof start>} */
-export const meta = {
-  // @ts-expect-error splitRecord loses the property keys
-  privateArgsShape: M.splitRecord(
-    {
-      poolBank: M.eref(M.remotable('bank')),
-      storageNode: M.eref(M.remotable('storageNode')),
-      marshaller: M.eref(M.remotable('marshaller')),
-    },
-    {
-      // only necessary on first invocation, not subsequent
-      initialPoserInvitation: InvitationShape,
-      metricsOverride: M.recordOf(M.string()),
-    },
-  ),
-  upgradability: 'canUpgrade',
-};
-harden(meta);
-
-/**
- * @typedef {StandardTerms &
- *   GovernanceTerms<{
- *     PerAccountInitialAmount: 'amount';
- *   }>} ProvisionTerms
- *   TODO: ERef<GovernedCreatorFacet<ProvisionCreator>>
- * @param {ZCF<ProvisionTerms>} zcf
- * @param {{
- *   poolBank: ERef<Bank>;
- *   initialPoserInvitation: Invitation;
- *   storageNode: Remote<StorageNode>;
- *   marshaller: Remote<Marshaller>;
- *   metricsOverride?: MetricsNotification;
- *   governedParamOverrides?: Record<string, Amount | undefined>;
- * }} privateArgs
- * @param {Baggage} baggage
- */
-export const start = async (zcf, privateArgs, baggage) => {
-  const { poolBank, metricsOverride } = privateArgs;
-
-  const { marshaller: remoteMarshaller } = privateArgs;
-  const cachingMarshaller = wrapRemoteMarshaller(remoteMarshaller);
-
-  const { makeRecorderKit } = prepareRecorderKitMakers(
-    baggage,
-    cachingMarshaller,
-  );
-
-  // Governance
-  const { publicMixin, makeDurableGovernorFacet, params } =
-    await handleParamGovernance(
-      zcf,
-      privateArgs.initialPoserInvitation,
-      {
-        PerAccountInitialAmount: ParamTypes.AMOUNT,
-      },
-      privateArgs.storageNode,
-      privateArgs.marshaller,
-      privateArgs.governedParamOverrides,
-    );
-
-  const zone = makeDurableZone(baggage);
-
-  const makeBridgeProvisionTool = prepareBridgeProvisionTool(zone);
-  const makeProvisionPoolKit = prepareProvisionPoolKit(zone, {
-    makeRecorderKit,
-    params,
-    poolBank,
-    zcf,
-    makeBridgeProvisionTool,
-  });
-
-  const poolBrand = /** @type {Brand<'nat'>} */ (
-    params.getPerAccountInitialAmount().brand
-  );
-  const provisionPoolKit = await provideSingleton(
-    baggage,
-    'provisionPoolKit',
-    () =>
-      makeProvisionPoolKit({
-        poolBrand,
-        storageNode: privateArgs.storageNode,
-      }),
-  );
-  provisionPoolKit.helper.start(poolBrand, { metrics: metricsOverride });
-
-  const publicFacet = prepareExo(
-    baggage,
-    'Provisioning Pool public',
-    M.interface('ProvisionPool', {
-      getMetrics: M.callWhen().returns(M.remotable('MetricsSubscriber')),
-      getPublicTopics: M.callWhen().returns(TopicsRecordShape),
-      ...publicMixinAPI,
-    }),
-    {
-      async getMetrics() {
-        await null;
-        return provisionPoolKit.public.getPublicTopics().metrics.subscriber;
-      },
-      async getPublicTopics() {
-        await null;
-        return provisionPoolKit.public.getPublicTopics();
-      },
-      ...publicMixin,
-    },
-  );
-
-  return harden({
-    creatorFacet: makeDurableGovernorFacet(baggage, provisionPoolKit.machine)
-      .governorFacet,
-    publicFacet,
-  });
-};
-
-harden(start);

package/src/provisionPoolKit.d.ts

@@ -1,81 +0,0 @@
-export function prepareBridgeProvisionTool(zone: Zone): (bankManager: ERef<import("@endo/exo").Guarded<{
-    getAssetSubscription(): import("@agoric/notifier").IterableEachTopic<AssetDescriptor>;
-    getRewardDistributorDepositFacet(denom: string, feeKit: AssetIssuerKit): ERef<import("@endo/far").EOnly<import("@agoric/ertp").DepositFacet>>;
-    getModuleAccountAddress(moduleName: string): Promise<string | null>;
-    addAsset(denom: string, issuerName: string, proposedName: string, kit: AssetIssuerKit & {
-        payment?: ERef<Payment<"nat">>;
-    }): Promise<void>;
-    getBankForAddress(address: string): Promise<Bank>;
-}>>, walletFactory: ERef<import("@endo/exo").Guarded<{
-    provideSmartWallet(address: string, bank: ERef<Bank>, namesByAddressAdmin: ERef<NameAdmin>): Promise<[wallet: import("@agoric/smart-wallet/src/smartWallet.js").SmartWallet, isNew: boolean]>;
-}>>, namesByAddressAdmin: ERef<NameAdmin>, forHandler: any) => import("@endo/exo").Guarded<{
-    /** @param {BridgeMessage} obj */
-    fromBridge(obj: BridgeMessage): Promise<void>;
-}>;
-export function prepareProvisionPoolKit(zone: Zone, { makeRecorderKit, params, poolBank, zcf, makeBridgeProvisionTool }: {
-    makeRecorderKit: MakeRecorderKit;
-    params: any;
-    poolBank: ERef<Bank>;
-    zcf: ZCF;
-    makeBridgeProvisionTool: ReturnType<typeof prepareBridgeProvisionTool>;
-}): ({ poolBrand, storageNode }: {
-    poolBrand: Brand<"nat">;
-    storageNode: ERemote<StorageNode>;
-}) => Promise<ProvisionPoolKit>;
-export type ProvisionPoolKit = {
-    machine: {
-        addRevivableAddresses: (oldAddresses: string[]) => void;
-        getWalletReviver: () => ERef<any>;
-        setReferences: (erefs: ProvisionPoolKitReferences) => Promise<void>;
-        makeHandler: () => ERef<BridgeHandler>;
-        initPSM: (brand: Brand, instance: Instance<typeof psmStart>) => void;
-    };
-    helper: any;
-    forHandler: any;
-    public: any;
-};
-export type PsmInstance = Instance<typeof psmStart>;
-export type ProvisionPoolKitReferences = {
-    bankManager: ERef<BankManager>;
-    namesByAddressAdmin: ERef<NameAdmin>;
-    walletFactory: ERef<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 { Zone } from '@agoric/zone';
-import type { AssetDescriptor } from '@agoric/vats/src/vat-bank.js';
-import type { ERef } from '@endo/far';
-import type { Payment } from '@agoric/ertp';
-import type { Bank } from '@agoric/vats/src/vat-bank.js';
-import type { NameAdmin } from '@agoric/vats';
-import type { BridgeMessage } from '@agoric/cosmic-swingset/src/types.js';
-import type { MakeRecorderKit } from '@agoric/zoe/src/contractSupport/recorder.js';
-import type { ZCF } from '@agoric/zoe';
-import type { Brand } from '@agoric/ertp';
-import type { StorageNode } from '@agoric/internal/src/lib-chainStorage.js';
-import type { ERemote } from '@agoric/internal';
-import type { BridgeHandler } from '@agoric/vats';
-import type { start as psmStart } from '@agoric/inter-protocol/src/psm/psm.js';
-import type { Instance } from '@agoric/zoe/src/zoeService/utils.js';
-import type { BankManager } from '@agoric/vats/src/vat-bank.js';
-import type { WalletFactoryStartResult } from '@agoric/vats/src/core/startWalletFactory.js';
-import type { Amount } from '@agoric/ertp';
-//# sourceMappingURL=provisionPoolKit.d.ts.map

package/src/provisionPoolKit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provisionPoolKit.d.ts","sourceRoot":"","sources":["provisionPoolKit.js"],"names":[],"mappings":"AAiGO,iDAFI,IAAI;;;;;eA2gBgY,CAAC;;;;;;IAtf1Y,iCAAiC;oBAArB,aAAa;GA6B5B;AAYI,8CATI,IAAI,uEACJ;IACN,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IACrB,GAAG,EAAE,GAAG,CAAC;IACT,uBAAuB,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;CACxE,gCA6bC;IAA2B,SAAS,EAA5B,MAAM,KAAK,CAAC;IACe,WAAW,EAAtC,QAAQ,WAAW,CAAC;CAC5B,KAAU,OAAO,CAAC,gBAAgB,CAAC,CAevC;+BAjjBY;IACR,OAAO,EAAE;QACP,qBAAqB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;QACxD,gBAAgB,EAAE,MAAM,KAAK,GAAG,CAAC,CAAC;QAClC,aAAa,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACpE,WAAW,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,eAAe,CAAC,KAAK,IAAI,CAAC;KACtE,CAAC;IACF,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,GAAG,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC;CACb;0BAIS,SAAS,eAAe,CAAC;;iBAKxB,KAAK,WAAW,CAAC;yBACjB,KAAK,SAAS,CAAC;mBACf,KAAK,wBAAwB,CAAC,cAAc,CAAC,CAAC;;;;;;;;;;wBAM9C,MAAM;;;;;yBACN,OAAO,KAAK,CAAC;;;;;0BAEb,OAAO,KAAK,CAAC;;0BA/CJ,cAAc;qCAKH,8BAA8B;0BAZzC,WAAW;6BAJc,cAAc;0BAK1B,8BAA8B;+BAItC,cAAc;mCAVV,sCAAsC;qCAcpC,6CAA6C;yBAVzD,aAAa;2BAHa,cAAc;iCAEhC,0CAA0C;6BADtC,kBAAkB;mCAcpB,cAAc;uCAPV,uCAAuC;8BADhD,qCAAqC;iCAF5B,8BAA8B;8CAKvB,6CAA6C;4BAVxC,cAAc"}

package/src/provisionPoolKit.js

@@ -1,618 +0,0 @@
-// @ts-check
-import { X, q, Fail } from '@endo/errors';
-import { E } from '@endo/far';
-
-import { AmountMath, BrandShape } from '@agoric/ertp';
-import { deeplyFulfilledObject, makeTracer } from '@agoric/internal';
-import { UnguardedHelperI } from '@agoric/internal/src/typeGuards.js';
-import {
-  observeIteration,
-  observeNotifier,
-  subscribeEach,
-} from '@agoric/notifier';
-import {
-  M,
-  makeScalarBigMapStore,
-  makeScalarBigSetStore,
-} from '@agoric/vat-data';
-import { makeAtomicProvider, makeScalarMapStore } from '@agoric/store';
-import { PowerFlags } from '@agoric/vats/src/walletFlags.js';
-import {
-  PublicTopicShape,
-  makeRecorderTopic,
-} from '@agoric/zoe/src/contractSupport/topics.js';
-import { InstanceHandleShape } from '@agoric/zoe/src/typeGuards.js';
-import { isUpgradeDisconnection } from '@agoric/internal/src/upgrade-api.js';
-
-/**
- * @import {EReturn} from '@endo/far';
- * @import {BridgeMessage} from '@agoric/cosmic-swingset/src/types.js';
- * @import {Amount, Brand, Payment, Purse} from '@agoric/ertp';
- * @import {ERemote, Remote} from '@agoric/internal';
- * @import {StorageNode} from '@agoric/internal/src/lib-chainStorage.js';
- * @import {ZCF} from '@agoric/zoe';
- * @import {ERef} from '@endo/far'
- * @import {Bank, BankManager} from '@agoric/vats/src/vat-bank.js'
- * @import {MapStore, SetStore} from '@agoric/store';
- * @import {Instance} from '@agoric/zoe/src/zoeService/utils.js';
- * @import {start as psmStart} from '@agoric/inter-protocol/src/psm/psm.js';
- * @import {NameAdmin} from '@agoric/vats';
- * @import {WalletFactoryStartResult} from '@agoric/vats/src/core/startWalletFactory.js';
- * @import {Zone} from '@agoric/zone';
- * @import {start as StartWalletFactory} from '@agoric/smart-wallet/src/walletFactory.js';
- * @import {MakeRecorderKit} from '@agoric/zoe/src/contractSupport/recorder.js';
- * @import {RecorderKit} from '@agoric/zoe/src/contractSupport/recorder.js';
- * @import {BridgeHandler} from '@agoric/vats';
- * @import {AssetDescriptor} from '@agoric/vats/src/vat-bank.js';
- */
-
-const trace = makeTracer('ProvPool');
-
-const FIRST_UPPER_KEYWORD = /^[A-Z][a-zA-Z0-9_$]*$/;
-// see https://github.com/Agoric/agoric-sdk/issues/8238
-const FIRST_LOWER_NEAR_KEYWORD = /^[a-z][a-zA-Z0-9_$]*$/;
-
-// XXX when inferred, error TS2742: cannot be named without a reference to '../../../node_modules/@endo/exo/src/get-interface.js'. This is likely not portable. A type annotation is necessary.
-/**
- * @typedef {{
- *   machine: {
- *     addRevivableAddresses: (oldAddresses: string[]) => void;
- *     getWalletReviver: () => ERef<any>;
- *     setReferences: (erefs: ProvisionPoolKitReferences) => Promise<void>;
- *     makeHandler: () => ERef<BridgeHandler>;
- *     initPSM: (brand: Brand, instance: Instance<typeof psmStart>) => void;
- *   };
- *   helper: any;
- *   forHandler: any;
- *   public: any;
- * }} ProvisionPoolKit
- */
-
-/**
- * @typedef {Instance<typeof psmStart>} PsmInstance
- */
-
-/**
- * @typedef {object} ProvisionPoolKitReferences
- * @property {ERef<BankManager>} bankManager
- * @property {ERef<NameAdmin>} namesByAddressAdmin
- * @property {ERef<WalletFactoryStartResult['creatorFacet']>} walletFactory
- */
-
-/**
- * @typedef {object} MetricsNotification Metrics naming scheme is that nouns are
- *   present values and past-participles are accumulative.
- * @property {bigint} walletsProvisioned count of new wallets provisioned
- * @property {Amount<'nat'>} totalMintedProvided running sum of Minted provided
- *   to new wallets
- * @property {Amount<'nat'>} totalMintedConverted running sum of Minted ever
- *   received by the contract from PSM
- */
-
-/**
- * Given attenuated access to the funding purse, handle requests to provision
- * smart wallets.
- *
- * @param {Zone} zone
- */
-export const prepareBridgeProvisionTool = zone =>
-  zone.exoClass(
-    'smartWalletProvisioningHandler',
-    M.interface('ProvisionBridgeHandlerMaker', {
-      fromBridge: M.callWhen(M.record()).returns(),
-    }),
-    /**
-     * @param {ERef<BankManager>} bankManager
-     * @param {ERef<EReturn<StartWalletFactory>['creatorFacet']>} walletFactory
-     * @param {ERef<NameAdmin>} namesByAddressAdmin
-     * @param {ProvisionPoolKit['forHandler']} forHandler
-     */
-    (bankManager, walletFactory, namesByAddressAdmin, forHandler) => ({
-      bankManager,
-      walletFactory,
-      namesByAddressAdmin,
-      forHandler,
-    }),
-    {
-      /** @param {BridgeMessage} obj */
-      async fromBridge(obj) {
-        if (obj.type !== 'PLEASE_PROVISION')
-          throw Fail`Unrecognized request ${obj.type}`;
-        trace('PLEASE_PROVISION', obj);
-        const { address, powerFlags } = obj;
-        // XXX expects powerFlags to be an array, but if it's a string then
-        // this allows a string that has 'SMART_WALLET' in it.
-        powerFlags.includes(PowerFlags.SMART_WALLET) ||
-          Fail`missing SMART_WALLET in powerFlags`;
-
-        const { bankManager, walletFactory, namesByAddressAdmin, forHandler } =
-          this.state;
-
-        const bank = E(bankManager).getBankForAddress(address);
-        // only proceed if we can provide funds
-        await forHandler.sendInitialPayment(bank);
-
-        const [_, created] = await E(walletFactory).provideSmartWallet(
-          address,
-          bank,
-          namesByAddressAdmin,
-        );
-        if (created) {
-          forHandler.onProvisioned();
-        }
-        trace(created ? 'provisioned' : 're-provisioned', address);
-      },
-    },
-  );
-
-/**
- * @param {Zone} zone
- * @param {{
- *   makeRecorderKit: MakeRecorderKit;
- *   params: any;
- *   poolBank: ERef<Bank>;
- *   zcf: ZCF;
- *   makeBridgeProvisionTool: ReturnType<typeof prepareBridgeProvisionTool>;
- * }} powers
- */
-export const prepareProvisionPoolKit = (
-  zone,
-  { makeRecorderKit, params, poolBank, zcf, makeBridgeProvisionTool },
-) => {
-  const zoe = zcf.getZoeService();
-  const ephemeralPurses = makeScalarMapStore('fundingPurseForBrand');
-  const purseProvider = makeAtomicProvider(ephemeralPurses);
-  const getFundingPurseForBrand = async poolBrand => {
-    await null;
-    try {
-      const purse = await purseProvider.provideAsync(poolBrand, brand =>
-        E(poolBank).getPurse(brand),
-      );
-      return purse;
-    } catch (err) {
-      trace(`🚨 could not get purse for brand ${poolBrand}`, err);
-      throw err;
-    }
-  };
-
-  const makeProvisionPoolKitInternal = zone.exoClassKit(
-    'ProvisionPoolKit',
-    {
-      machine: M.interface('ProvisionPoolKit machine', {
-        addRevivableAddresses: M.call(M.arrayOf(M.string())).returns(),
-        getWalletReviver: M.call().returns(
-          M.remotable('ProvisionPoolKit wallet reviver'),
-        ),
-        setReferences: M.callWhen({
-          bankManager: M.eref(M.remotable('bankManager')),
-          namesByAddressAdmin: M.eref(M.remotable('nameAdmin')),
-          walletFactory: M.eref(M.remotable('walletFactory')),
-        }).returns(),
-        makeHandler: M.call().returns(M.remotable('BridgeHandler')),
-        initPSM: M.call(BrandShape, InstanceHandleShape).returns(),
-      }),
-      walletReviver: M.interface('ProvisionPoolKit wallet reviver', {
-        reviveWallet: M.callWhen(M.string()).returns(
-          M.remotable('SmartWallet'),
-        ),
-        ackWallet: M.call(M.string()).returns(M.boolean()),
-      }),
-      helper: UnguardedHelperI,
-      forHandler: UnguardedHelperI,
-      public: M.interface('ProvisionPoolKit public', {
-        getPublicTopics: M.call().returns({ metrics: PublicTopicShape }),
-      }),
-    },
-    /**
-     * @param {object} opts
-     * @param {Purse<'nat'>} [opts.fundPurse]
-     * @param {Brand<'nat'>} opts.poolBrand
-     * @param {Remote<StorageNode>} opts.metricsNode
-     */
-    ({ fundPurse, poolBrand, metricsNode }) => {
-      /** @type {RecorderKit<MetricsNotification>} */
-      const metricsRecorderKit = makeRecorderKit(metricsNode);
-
-      /** @type {MapStore<ERef<Brand>, PsmInstance>} */
-      const brandToPSM = makeScalarBigMapStore('brandToPSM', { durable: true });
-      const revivableAddresses = makeScalarBigSetStore('revivableAddresses', {
-        durable: true,
-        keyShape: M.string(),
-      });
-
-      /**
-       * to be set by `setReferences`
-       *
-       * @type {Partial<ProvisionPoolKitReferences>}
-       */
-      const references = {
-        bankManager: undefined,
-        namesByAddressAdmin: undefined,
-        walletFactory: undefined,
-      };
-
-      return {
-        brandToPSM,
-        fundPurse,
-        metricsRecorderKit,
-        poolBrand,
-        walletsProvisioned: 0n,
-        totalMintedProvided: AmountMath.makeEmpty(poolBrand),
-        totalMintedConverted: AmountMath.makeEmpty(poolBrand),
-        revivableAddresses,
-        ...references,
-      };
-    },
-    {
-      // aka "limitedCreatorFacet"
-      machine: {
-        /** @param {string[]} oldAddresses */
-        addRevivableAddresses(oldAddresses) {
-          trace('revivableAddresses count', oldAddresses.length);
-          this.state.revivableAddresses.addAll(oldAddresses);
-        },
-        getWalletReviver() {
-          return this.facets.walletReviver;
-        },
-        /** @param {ProvisionPoolKitReferences} erefs */
-        async setReferences(erefs) {
-          const { bankManager, namesByAddressAdmin, walletFactory } = erefs;
-          const obj = harden({
-            bankManager,
-            namesByAddressAdmin,
-            walletFactory,
-          });
-          const refs = await deeplyFulfilledObject(obj);
-          Object.assign(this.state, refs);
-        },
-        /** @returns {BridgeHandler} */
-        makeHandler() {
-          const { bankManager, namesByAddressAdmin, walletFactory } =
-            this.state;
-          if (!bankManager || !namesByAddressAdmin || !walletFactory) {
-            throw Fail`must set references before handling requests`;
-          }
-
-          const { forHandler } = this.facets;
-
-          const provisionHandler = makeBridgeProvisionTool(
-            bankManager,
-            walletFactory,
-            namesByAddressAdmin,
-            forHandler,
-          );
-
-          return provisionHandler;
-        },
-        /**
-         * @param {Brand} brand
-         * @param {PsmInstance} instance
-         */
-        initPSM(brand, instance) {
-          const { brandToPSM } = this.state;
-          brandToPSM.init(brand, instance);
-        },
-      },
-      walletReviver: {
-        /** @param {string} address */
-        async reviveWallet(address) {
-          const {
-            revivableAddresses,
-            bankManager,
-            namesByAddressAdmin,
-            walletFactory,
-          } = this.state;
-          if (!bankManager || !namesByAddressAdmin || !walletFactory) {
-            throw Fail`must set references before handling requests`;
-          }
-          revivableAddresses.has(address) ||
-            Fail`non-revivable address ${address}`;
-          const bank = E(bankManager).getBankForAddress(address);
-          const [wallet, _created] = await E(walletFactory).provideSmartWallet(
-            address,
-            bank,
-            namesByAddressAdmin,
-          );
-          return wallet;
-        },
-        /**
-         * @param {string} address
-         * @returns {boolean} isRevive
-         */
-        ackWallet(address) {
-          const { revivableAddresses } = this.state;
-          if (!revivableAddresses.has(address)) {
-            return false;
-          }
-          revivableAddresses.delete(address);
-          return true;
-        },
-      },
-      helper: {
-        publishMetrics() {
-          const {
-            metricsRecorderKit,
-            walletsProvisioned,
-            totalMintedConverted,
-            totalMintedProvided,
-          } = this.state;
-          void metricsRecorderKit.recorder.write(
-            harden({
-              walletsProvisioned,
-              totalMintedProvided,
-              totalMintedConverted,
-            }),
-          );
-        },
-        onTrade(converted) {
-          const { state, facets } = this;
-          state.totalMintedConverted = AmountMath.add(
-            state.totalMintedConverted,
-            converted,
-          );
-          facets.helper.publishMetrics();
-        },
-        onSendFunds(provided) {
-          const { state, facets } = this;
-          state.totalMintedProvided = AmountMath.add(
-            state.totalMintedProvided,
-            provided,
-          );
-          facets.helper.publishMetrics();
-        },
-        /**
-         * @param {Amount} amount
-         * @param {ERef<Purse>} srcPurse
-         */
-        async onPoolDeposit(amount, srcPurse) {
-          const { helper } = this.facets;
-          const { brandToPSM, poolBrand } = this.state;
-
-          const { brand } = amount;
-          if (AmountMath.isEmpty(amount) || brand === poolBrand) {
-            return;
-          }
-
-          // `amount` doesn't match the current `poolBrand`, so we need to swap
-          // it.
-          if (!brandToPSM.has(brand)) {
-            console.error('funds arrived but no PSM instance', brand);
-            return;
-          }
-          const instance = brandToPSM.get(brand);
-          const payment = E(srcPurse).withdraw(amount);
-          await helper.swap(payment, amount, instance).catch(async reason => {
-            console.error(X`swap failed: ${reason}`);
-            const resolvedPayment = await payment;
-            return E(srcPurse).deposit(resolvedPayment);
-          });
-        },
-        /**
-         * @param {ERef<Purse>} exchangePurse
-         * @param {ERef<Brand>} brand
-         */
-        watchCurrentAmount(exchangePurse, brand) {
-          const { helper } = this.facets;
-          void observeNotifier(E(exchangePurse).getCurrentAmountNotifier(), {
-            updateState: async amount => {
-              trace('provisionPool balance update', amount);
-              await helper.onPoolDeposit(amount, exchangePurse);
-            },
-            fail: reason => {
-              if (isUpgradeDisconnection(reason)) {
-                void helper.watchCurrentAmount(exchangePurse, brand);
-              } else {
-                console.error(reason);
-              }
-            },
-          });
-        },
-        watchAssetSubscription() {
-          const { facets } = this;
-          const { helper } = facets;
-
-          /** @param {AssetDescriptor} desc */
-          const repairDesc = desc => {
-            if (desc.issuerName.match(FIRST_UPPER_KEYWORD)) {
-              trace(`Saving Issuer ${desc.issuerName}`);
-              return desc;
-            } else if (desc.issuerName.match(FIRST_LOWER_NEAR_KEYWORD)) {
-              const bad = desc.issuerName;
-              const goodName = bad.replace(bad[0], bad[0].toUpperCase());
-
-              trace(
-                `Saving Issuer ${desc.issuerName} with repaired keyword ${goodName}`,
-              );
-              return { ...desc, issuerName: goodName };
-            } else {
-              console.error(
-                `unable to save issuer with illegal keyword: ${desc.issuerName}`,
-              );
-              return undefined;
-            }
-          };
-
-          return observeIteration(
-            subscribeEach(E(poolBank).getAssetSubscription()),
-            {
-              updateState: async desc => {
-                await null;
-                const issuer = zcf.getTerms().issuers[desc.issuerName];
-                if (issuer === desc.issuer) {
-                  trace('provisionPool re-notified of known asset', desc.brand);
-                } else {
-                  const goodDesc = repairDesc(desc);
-                  if (goodDesc) {
-                    await zcf.saveIssuer(goodDesc.issuer, goodDesc.issuerName);
-                  } else {
-                    console.error(
-                      `unable to save issuer with illegal keyword: ${desc.issuerName}`,
-                    );
-                  }
-                }
-
-                /** @type {ERef<Purse>} */
-                const exchangePurse = E(poolBank).getPurse(desc.brand);
-                helper.watchCurrentAmount(exchangePurse, desc.brand);
-              },
-              fail: _reason => {
-                void helper.watchAssetSubscription();
-              },
-            },
-          );
-        },
-        /**
-         * @param {Brand<'nat'>} poolBrand
-         * @param {object} [options]
-         * @param {MetricsNotification} [options.metrics]
-         */
-        start(poolBrand, { metrics } = {}) {
-          const { facets, state } = this;
-          const { helper } = facets;
-          const lastPoolBrand = state.poolBrand;
-
-          // The PerAccountInitialAmount param must use the correct brand for
-          // this incarnation.
-          AmountMath.coerce(poolBrand, params.getPerAccountInitialAmount());
-
-          // Restore old metrics.
-          if (metrics) {
-            const {
-              walletsProvisioned,
-              totalMintedProvided,
-              totalMintedConverted,
-            } = metrics;
-            assert.typeof(walletsProvisioned, 'bigint');
-            AmountMath.coerce(lastPoolBrand, totalMintedProvided);
-            AmountMath.coerce(lastPoolBrand, totalMintedConverted);
-            Object.assign(state, {
-              walletsProvisioned,
-              totalMintedProvided,
-              totalMintedConverted,
-            });
-            helper.publishMetrics();
-          }
-
-          // Update as needed when `poolBrand` changes.
-          if (poolBrand !== lastPoolBrand) {
-            state.poolBrand = poolBrand;
-            state.fundPurse = undefined;
-            void getFundingPurseForBrand(poolBrand).then(purse =>
-              helper.updateFundPurse(purse, poolBrand),
-            );
-            state.totalMintedProvided = AmountMath.makeEmpty(poolBrand);
-            state.totalMintedConverted = AmountMath.makeEmpty(poolBrand);
-            helper.publishMetrics();
-          }
-
-          void helper.watchAssetSubscription();
-        },
-        /**
-         * @param {ERef<Payment>} payIn
-         * @param {Amount} amount
-         * @param {PsmInstance} instance
-         */
-        async swap(payIn, amount, instance) {
-          await null;
-          const { facets, state } = this;
-          const { helper } = facets;
-          const {
-            poolBrand,
-            fundPurse = await getFundingPurseForBrand(poolBrand),
-          } = state;
-          const psmPub = E(zoe).getPublicFacet(instance);
-          const proposal = harden({ give: { In: amount } });
-          const invitation = E(psmPub).makeWantMintedInvitation();
-          const seat = E(zoe).offer(invitation, proposal, { In: payIn });
-          const payout = await E(seat).getPayout('Out');
-          const rxd = await E(fundPurse).deposit(payout);
-          helper.onTrade(rxd);
-          return rxd;
-        },
-        /**
-         * @param {Purse<'nat'>} purse
-         * @param {Brand<'nat'>} brand
-         */
-        updateFundPurse(purse, brand) {
-          const { state } = this;
-          if (brand !== state.poolBrand || state.fundPurse) return;
-          state.fundPurse = purse;
-        },
-      },
-      forHandler: {
-        onProvisioned() {
-          const { facets, state } = this;
-          state.walletsProvisioned += 1n;
-          facets.helper.publishMetrics();
-        },
-        /** @param {ERef<Bank>} destBank */
-        async sendInitialPayment(destBank) {
-          await null;
-          const { facets, state } = this;
-          const { helper } = facets;
-          const {
-            poolBrand,
-            fundPurse = await getFundingPurseForBrand(poolBrand),
-          } = state;
-          const perAccountInitialAmount = /** @type {Amount<'nat'>} */ (
-            params.getPerAccountInitialAmount()
-          );
-          trace('sendInitialPayment withdrawing', perAccountInitialAmount);
-          const initialPmt = await E(fundPurse).withdraw(
-            perAccountInitialAmount,
-          );
-
-          const destPurse = E(destBank).getPurse(poolBrand);
-          return E(destPurse)
-            .deposit(initialPmt)
-            .then(amt => {
-              helper.onSendFunds(perAccountInitialAmount);
-              trace('provisionPool sent', amt);
-            })
-            .catch(reason => {
-              console.error(X`initial deposit failed: ${q(reason)}`);
-              void E(fundPurse).deposit(initialPmt);
-              throw reason;
-            });
-        },
-      },
-      public: {
-        getPublicTopics() {
-          return {
-            metrics: makeRecorderTopic(
-              'Provision Pool metrics',
-              this.state.metricsRecorderKit,
-            ),
-          };
-        },
-      },
-    },
-    {
-      finish: ({ facets }) => {
-        facets.helper.publishMetrics();
-      },
-    },
-  );
-
-  /**
-   * Prepare synchronous values before passing to real Exo maker
-   *
-   * @param {object} opts
-   * @param {Brand<'nat'>} opts.poolBrand
-   * @param {ERemote<StorageNode>} opts.storageNode
-   * @returns {Promise<ProvisionPoolKit>}
-   */
-  const makeProvisionPoolKit = async ({ poolBrand, storageNode }) => {
-    const fundPurse = await getFundingPurseForBrand(poolBrand);
-    /** @type {Remote<StorageNode>} */
-    const metricsNode = await E(storageNode).makeChildNode('metrics');
-
-    return makeProvisionPoolKitInternal({
-      fundPurse,
-      poolBrand,
-      metricsNode,
-    });
-  };
-
-  return makeProvisionPoolKit;
-};