@agoric/inter-protocol 0.17.0-u17.1 → 0.17.0-u18.1

package/src/proposals/deploy-price-feeds.js

@@ -0,0 +1,316 @@
+import { makeTracer } from '@agoric/internal';
+import { makeStorageNodeChild } from '@agoric/internal/src/lib-chainStorage.js';
+import { E } from '@endo/far';
+
+import { unitAmount } from '@agoric/zoe/src/contractSupport/priceQuote.js';
+import {
+  oracleBrandFeedName,
+  reserveThenDeposit,
+  sanitizePathSegment,
+} from './utils.js';
+import { replaceScaledPriceAuthorities } from './replace-scaledPriceAuthorities.js';
+
+const STORAGE_PATH = 'priceFeed';
+
+/** @type {ChainlinkConfig} */
+export const DEFAULT_CONTRACT_TERMS = {
+  maxSubmissionCount: 1000,
+  minSubmissionCount: 2,
+  restartDelay: 1n, // the number of rounds an Oracle has to wait before they can initiate another round
+  timeout: 10, // in seconds according to chainTimerService
+  minSubmissionValue: 1,
+  maxSubmissionValue: 2 ** 256,
+};
+
+/** @import {EconomyBootstrapPowers} from './econ-behaviors.js'; */
+/** @import {ChainlinkConfig} from '@agoric/inter-protocol/src/price/fluxAggregatorKit.js'; */
+/** @import {FluxStartFn} from '@agoric/inter-protocol/src/price/fluxAggregatorContract.js'; */
+
+const trace = makeTracer('DeployPriceFeed', true);
+
+/**
+ * @typedef {{
+ *   oracleAddresses: string[];
+ *   inBrandNames: string[];
+ *   contractTerms?: Partial<ChainlinkConfig>;
+ * }} PriceFeedConfig
+ */
+
+/**
+ * @param {EconomyBootstrapPowers} powers
+ * @param {string} bundleID
+ */
+const installPriceAggregator = async (
+  {
+    consume: { zoe },
+    installation: {
+      produce: { priceAggregator },
+    },
+  },
+  bundleID,
+) => {
+  /** @type {Installation<FluxStartFn>} */
+  const installation = await E(zoe).installBundleID(bundleID);
+  priceAggregator.reset();
+  priceAggregator.resolve(installation);
+  trace('installed priceAggregator', bundleID.slice(0, 'b1-1234567'.length));
+  return installation;
+};
+
+/**
+ * Provide (find/create) inert brands (no mint or issuer) referred to by oracles
+ *
+ * @param {EconomyBootstrapPowers & NamedVatPowers} space
+ * @param {{ name: string; decimalPlaces: number }} opt
+ * @returns {Promise<Brand<'nat'>>}
+ */
+export const ensureOracleBrand = async (
+  {
+    namedVat: {
+      consume: { agoricNames },
+    },
+    oracleBrand: { produce: oracleBrandProduce },
+  },
+  { name, decimalPlaces },
+) => {
+  const brand = E(agoricNames).provideInertBrand(name, {
+    assetKind: 'nat',
+    decimalPlaces,
+  });
+
+  oracleBrandProduce[name].reset();
+  oracleBrandProduce[name].resolve(brand);
+  return brand;
+};
+
+/**
+ * @param {EconomyBootstrapPowers} powers
+ * @param {{
+ *   AGORIC_INSTANCE_NAME: string;
+ *   contractTerms: import('@agoric/inter-protocol/src/price/fluxAggregatorKit.js').ChainlinkConfig;
+ *   brandIn: Brand<'nat'>;
+ *   brandOut: Brand<'nat'>;
+ * }} config
+ * @param {Installation<FluxStartFn>} installation
+ */
+const startPriceAggregatorInstance = async (
+  {
+    consume: {
+      board,
+      chainStorage,
+      chainTimerService,
+      econCharterKit,
+      highPrioritySendersManager,
+      namesByAddressAdmin,
+      startGovernedUpgradable,
+    },
+    instance: { produce: produceInstance },
+  },
+  { AGORIC_INSTANCE_NAME, contractTerms, brandIn, brandOut },
+  installation,
+) => {
+  trace('startPriceAggregatorInstance', AGORIC_INSTANCE_NAME);
+  const label = sanitizePathSegment(AGORIC_INSTANCE_NAME);
+
+  const feedsStorage = await makeStorageNodeChild(chainStorage, STORAGE_PATH);
+  const storageNode = await E(feedsStorage).makeChildNode(label);
+  const marshaller = await E(board).getReadonlyMarshaller();
+
+  const terms = harden({
+    ...contractTerms,
+    description: AGORIC_INSTANCE_NAME,
+    brandIn,
+    brandOut,
+    // XXX powerful TimerService, see #6003
+    timer: await chainTimerService,
+    unitAmountIn: await unitAmount(brandIn),
+  });
+  const privateArgs = {
+    highPrioritySendersManager: await highPrioritySendersManager,
+    marshaller,
+    namesByAddressAdmin,
+    storageNode,
+  };
+  const governedKit = await E(startGovernedUpgradable)({
+    governedParams: {},
+    privateArgs,
+    terms,
+    label,
+    // @ts-expect-error GovernableStartFn vs. fluxAggregatorContract.js start
+    installation,
+  });
+  produceInstance[AGORIC_INSTANCE_NAME].reset();
+  produceInstance[AGORIC_INSTANCE_NAME].resolve(governedKit.instance);
+  trace(
+    'new instance',
+    label,
+    { terms, privateArgs, installation },
+    governedKit,
+  );
+
+  await E(E.get(econCharterKit).creatorFacet).addInstance(
+    governedKit.instance,
+    governedKit.governorCreatorFacet,
+    AGORIC_INSTANCE_NAME,
+  );
+  trace('added', label, 'instance to econCharter');
+
+  /** @type {import('@agoric/zoe/src/zoeService/utils.js').StartedInstanceKit<FluxStartFn>} */
+  // @ts-expect-error
+  const { instance, publicFacet, creatorFacet } = governedKit;
+
+  return harden({ instance, publicFacet, creatorFacet });
+};
+
+/**
+ * Send invitations to oracle operators for a price feed.
+ *
+ * @param {EconomyBootstrapPowers} powers
+ * @param {{ oracleAddresses: string[]; AGORIC_INSTANCE_NAME: string }} config
+ * @param {any} creatorFacet
+ */
+const distributeInvitations = async (
+  { consume: { namesByAddressAdmin } },
+  { oracleAddresses, AGORIC_INSTANCE_NAME },
+  creatorFacet,
+) => {
+  /** @param {string} addr */
+  const addOracle = async addr => {
+    const invitation = await E(creatorFacet).makeOracleInvitation(addr);
+    const debugName = `${AGORIC_INSTANCE_NAME} member ${addr}`;
+    await reserveThenDeposit(debugName, namesByAddressAdmin, addr, [
+      invitation,
+    ]).catch(err => console.error(`failed deposit to ${debugName}`, err));
+  };
+
+  trace('distributing invitations', oracleAddresses);
+  // This doesn't resolve until oracle operators create their smart wallets.
+  // Don't block completion on it.
+  void Promise.all(oracleAddresses.map(addOracle));
+  trace('createPriceFeed complete');
+};
+
+/**
+ * @param {EconomyBootstrapPowers & NamedVatPowers} powers
+ * @param {{
+ *   options: PriceFeedConfig & {
+ *     priceAggregatorRef: { bundleID: string };
+ *     scaledPARef: { bundleID: string };
+ *     inBrandsDecimals?: number;
+ *     contractTerms?: ChainlinkConfig;
+ *     outBrandName?: string;
+ *     outBrandDecimals?: number;
+ *   };
+ * }} config
+ */
+export const deployPriceFeeds = async (powers, config) => {
+  const {
+    inBrandNames,
+    oracleAddresses,
+    contractTerms,
+    priceAggregatorRef,
+    scaledPARef,
+    inBrandsDecimals = 6,
+    outBrandName = 'USD',
+    outBrandDecimals = 6,
+  } = config.options;
+  await null;
+
+  const installation = await installPriceAggregator(
+    powers,
+    priceAggregatorRef.bundleID,
+  );
+
+  const { priceAuthorityAdmin, priceAuthority } = powers.consume;
+
+  trace({ oracleAddresses });
+  trace({ inBrandNames });
+  for (const inBrandName of inBrandNames) {
+    const AGORIC_INSTANCE_NAME = oracleBrandFeedName(inBrandName, outBrandName);
+    const brandIn = await ensureOracleBrand(powers, {
+      name: inBrandName,
+      decimalPlaces: inBrandsDecimals,
+    });
+    const brandOut = await ensureOracleBrand(powers, {
+      name: outBrandName,
+      decimalPlaces: outBrandDecimals,
+    });
+    const kit = await startPriceAggregatorInstance(
+      powers,
+      {
+        AGORIC_INSTANCE_NAME,
+        brandIn,
+        brandOut,
+        contractTerms: { ...DEFAULT_CONTRACT_TERMS, ...contractTerms },
+      },
+      installation,
+    );
+
+    const forceReplace = true;
+    await E(priceAuthorityAdmin).registerPriceAuthority(
+      E(kit.publicFacet).getPriceAuthority(),
+      brandIn,
+      brandOut,
+      forceReplace,
+    );
+
+    await distributeInvitations(
+      powers,
+      { oracleAddresses, AGORIC_INSTANCE_NAME },
+      kit.creatorFacet,
+    );
+  }
+
+  // @ts-expect-error replaceScaledPriceAuthorities uses a subset of the powers.
+  await replaceScaledPriceAuthorities(powers, {
+    options: { scaledPARef },
+  });
+
+  trace('resolving priceAuthority8400');
+  // cf. #8400 QuotePayments storage leak
+  powers.produce.priceAuthority8400.resolve(priceAuthority);
+};
+
+const t = 'priceFeed';
+
+/**
+ * Thread price feed upgrade options through from builder to core-eval.
+ *
+ * @param {object} utils
+ * @param {any} utils.restoreRef
+ * @param {PriceFeedConfig & { priceAggregatorRef: any }} priceFeedOptions
+ */
+export const getManifestForPriceFeeds = async (
+  { restoreRef: _restoreRef },
+  priceFeedOptions,
+) => ({
+  manifest: {
+    [deployPriceFeeds.name]: {
+      namedVat: t,
+      consume: {
+        agoricNamesAdmin: t,
+        agoricNames: t,
+        board: t,
+        chainStorage: t,
+        chainTimerService: t,
+        contractKits: t,
+        econCharterKit: t,
+        highPrioritySendersManager: t,
+        instancePrivateArgs: t,
+        namesByAddressAdmin: t,
+        priceAuthority: t,
+        priceAuthorityAdmin: t,
+        startGovernedUpgradable: t,
+        startUpgradable: t,
+        zoe: t,
+      },
+      installation: { produce: { priceAggregator: t } },
+      instance: {
+        produce: t,
+      },
+      oracleBrand: { produce: t },
+      produce: { priceAuthority8400: t },
+    },
+  },
+  options: { ...priceFeedOptions },
+});

package/src/proposals/econ-behaviors.d.ts

@@ -43,15 +43,15 @@ export function setupVaultFactoryArguments(consume: EconomyBootstrapPowers["cons
         governedParams: {
             Electorate: {
                 type: "invitation";
-                value: import("@agoric/ertp/src/types.js").SetAmount<import("@endo/patterns").Key>;
+                value: import("@agoric/ertp").SetAmount<import("@endo/patterns").Key>;
             };
             MinInitialDebt: {
                 type: "amount";
-                value: import("@agoric/ertp/src/types.js").NatAmount;
+                value: import("@agoric/ertp").NatAmount;
             };
             ShortfallInvitation: {
                 type: "invitation";
-                value: import("@agoric/ertp/src/types.js").SetAmount<import("@endo/patterns").Key>;
+                value: import("@agoric/ertp").SetAmount<import("@endo/patterns").Key>;
             };
             ReferencedUI: {
                 type: "string";
@@ -71,11 +71,11 @@ export function setupVaultFactoryArguments(consume: EconomyBootstrapPowers["cons
     vaultFactoryPrivateArgs: {
         auctioneerInstance: import("@agoric/internal/src/tagged.js").TagContainer<any> & import("@endo/pass-style").RemotableObject & Handle<"Instance">;
         feeMintAccess: FeeMintAccess;
-        initialPoserInvitation: import("@endo/pass-style").RemotableObject & import("@agoric/ertp/src/types.js").PaymentMethods<"set"> & {
+        initialPoserInvitation: import("@endo/pass-style").RemotableObject & import("@agoric/ertp").PaymentMethods<"set"> & {
             [OfferReturn]?: unknown;
             [OfferArgs]?: undefined;
         };
-        initialShortfallInvitation: import("@endo/pass-style").RemotableObject & import("@agoric/ertp/src/types.js").PaymentMethods<"set"> & {
+        initialShortfallInvitation: import("@endo/pass-style").RemotableObject & import("@agoric/ertp").PaymentMethods<"set"> & {
             [OfferReturn]?: import("@endo/exo").Guarded<{
                 increaseLiquidationShortfall(shortfall: Amount<"nat">): void;
                 reduceLiquidationShortfall(reduction: Amount<"nat">): void;
@@ -164,8 +164,8 @@ export type VaultFactoryPublicFacet = Awaited<ReturnType<(zcf: VaultFactoryZCF,
                         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;
+                        getCollateralAmount(): import("@agoric/ertp").NatAmount;
+                        getCurrentDebt(): import("@agoric/ertp").NatAmount;
                         getNormalizedDebt(): import("../vaultFactory/storeUtils.js").NormalizedDebt;
                     }>;
                     vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
@@ -196,8 +196,8 @@ export type VaultFactoryPublicFacet = Awaited<ReturnType<(zcf: VaultFactoryZCF,
                             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;
+                            getCollateralAmount(): import("@agoric/ertp").NatAmount;
+                            getCurrentDebt(): import("@agoric/ertp").NatAmount;
                             getNormalizedDebt(): import("../vaultFactory/storeUtils.js").NormalizedDebt;
                         }>;
                         vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
@@ -261,8 +261,8 @@ export type VaultFactoryPublicFacet = Awaited<ReturnType<(zcf: VaultFactoryZCF,
                     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;
+                    getCollateralAmount(): import("@agoric/ertp").NatAmount;
+                    getCurrentDebt(): import("@agoric/ertp").NatAmount;
                     getNormalizedDebt(): import("../vaultFactory/storeUtils.js").NormalizedDebt;
                 }>;
                 vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
@@ -285,7 +285,7 @@ export type VaultFactoryPublicFacet = Awaited<ReturnType<(zcf: VaultFactoryZCF,
         getGovernedParams({ collateralBrand }: {
             collateralBrand: Brand;
         }): globalThis.ERef<globalThis.ParamStateRecord>;
-        getInvitationAmount(name: string): import("@agoric/ertp/src/types.js").SetAmount<InvitationDetails>;
+        getInvitationAmount(name: string): import("@agoric/ertp").SetAmount<InvitationDetails>;
     }>;
 }>>>["publicFacet"];
 export type PSMKit = {
@@ -306,14 +306,14 @@ export type AuctioneerKit = GovernanceFacetKit<(zcf: ZCF<GovernanceTerms<typeof
     marshaller: Marshaller;
 }, baggage: import("@agoric/vat-data").Baggage) => Promise<{
     publicFacet: globalThis.GovernedPublicFacet<{
-        getElectorate: () => import("@agoric/governance/src/types.js").ParamValueForType<"invitation">;
-        getStartFrequency: () => import("@agoric/governance/src/types.js").ParamValueForType<"relativeTime">;
-        getClockStep: () => import("@agoric/governance/src/types.js").ParamValueForType<"relativeTime">;
-        getStartingRate: () => import("@agoric/governance/src/types.js").ParamValueForType<"nat">;
-        getLowestRate: () => import("@agoric/governance/src/types.js").ParamValueForType<"nat">;
-        getDiscountStep: () => import("@agoric/governance/src/types.js").ParamValueForType<"nat">;
-        getAuctionStartDelay: () => import("@agoric/governance/src/types.js").ParamValueForType<"relativeTime">;
-        getPriceLockPeriod: () => import("@agoric/governance/src/types.js").ParamValueForType<"relativeTime">;
+        getElectorate: () => import("@agoric/ertp").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;
@@ -406,8 +406,8 @@ export type EconomyBootstrapSpace = PromiseSpaceOf<{
                             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;
+                            getCollateralAmount(): import("@agoric/ertp").NatAmount;
+                            getCurrentDebt(): import("@agoric/ertp").NatAmount;
                             getNormalizedDebt(): import("../vaultFactory/storeUtils.js").NormalizedDebt;
                         }>;
                         vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
@@ -438,8 +438,8 @@ export type EconomyBootstrapSpace = PromiseSpaceOf<{
                                 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;
+                                getCollateralAmount(): import("@agoric/ertp").NatAmount;
+                                getCurrentDebt(): import("@agoric/ertp").NatAmount;
                                 getNormalizedDebt(): import("../vaultFactory/storeUtils.js").NormalizedDebt;
                             }>;
                             vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
@@ -503,8 +503,8 @@ export type EconomyBootstrapSpace = PromiseSpaceOf<{
                         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;
+                        getCollateralAmount(): import("@agoric/ertp").NatAmount;
+                        getCurrentDebt(): import("@agoric/ertp").NatAmount;
                         getNormalizedDebt(): import("../vaultFactory/storeUtils.js").NormalizedDebt;
                     }>;
                     vaultUpdater: import("@agoric/zoe/src/contractSupport/recorder.js").Recorder<VaultNotification>;
@@ -527,7 +527,7 @@ export type EconomyBootstrapSpace = PromiseSpaceOf<{
             getGovernedParams({ collateralBrand }: {
                 collateralBrand: Brand;
             }): globalThis.ERef<globalThis.ParamStateRecord>;
-            getInvitationAmount(name: string): import("@agoric/ertp/src/types.js").SetAmount<InvitationDetails>;
+            getInvitationAmount(name: string): import("@agoric/ertp").SetAmount<InvitationDetails>;
         }>;
     }>>;
     auctioneerKit: AuctioneerKit;

package/src/proposals/econ-behaviors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"econ-behaviors.d.ts","sourceRoot":"","sources":["econ-behaviors.js"],"names":[],"mappings":"AAgBA,qCAAsC;AACtC,sCAA0C;AAC1C,qCAAsD;AACtD,sCAAqD;AAwE9C,mcADK,sBAAsB;;;;;;;;;;;;;;;;;;;;;;KA+FjC;AAUM,oDAPI,sBAAsB,CAAC,SAAS,CAAC,kDAEzC;IAAgC,cAAc;IACtB,OAAO;;;CAE/B,8BAAQ,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EvB;AAUM,wSAPI,sBAAsB,UAE9B;IAAgC,cAAc;IACtB,OAAO;;;CAE/B,mBAAQ,MAAM,iBA6FhB;AAWM,wGALI,sBAAsB;;;;8BAuBhC;AAQM,mcAFI,sBAAsB,iBA0GhC;AAQM,+cAJI,sBAAsB,uBAE9B;IAAqB,aAAa,GAA1B,GAAG;CAAwB,iBA0HrC;sCAxmBa,OAAO,CAAC,UAAU;;;;;;;yCA2D2C,2BACpE;;mBAGW,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA/DL,CAAC,CAAC,aAAa,CAAC;;WAI3C,MAAM;SACN,QAAQ;iBACR,QAAQ;qBACR,OAAO,CACpB,UAAc,CACd,OAAa,CACb,UAAkB,CAAC,8BAAuB,CAAC,OAAO,CAAC,CAAC,CAC7C,CAAC,cAAc,CAAC,CAAC,wBAAwB,CAAC,CAC5C,CACF;6BACU,oBAAoB,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC;mBAC7D,UAAU;;4BAGV,kBAAkB,CAAC;yBA6fzB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0Fm9N,yBAAgB;;;;;EAvlBh7N,CAAC;qCAG7D,eAAe,GAAG,mBAAmB,GAAG,qBAAqB;oCAG7D,cAAc,CAAC;IAC3B,oBAAwB,EAAE,oBAAoB,CAAC;IAC/C,6BAAiC,EAAE,OAAO,qCAAqC,EAAE,+BAA+B,CAAC;IACjH,iBAAqB,EAAE,mBACvB,cAAoB,sBAAsB,EAAE,KAAK,CAC5C,CAAC;IACN,qBAAyB,EAAE,QAAQ,CACnC,MAAY,EACZ,OAAa,sBAAsB,EAAE,oBAAoB,CACpD,CAAC;IACN,MAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,qBAAyB,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,cAAkB,EAAE,sBAAsB,CAAC;IAC3C,UAAc,EAAE,kBAAkB,CAClC,2CAA0C,CAAC,OAAO,CAAC,CAC9C,CAAC;IACN,eAAmB,EAAE,kBAAkB;;;;;;;6CAmBmC,2BACpE;;uBAGW,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAvBG,CAAC;IACjD,aAAiB,EAAE,aAAa,CAAC;IACjC,gBAAoB,EAAE,aAAa,GAAG,SAAS,CAAC;IAChD,cAAkB,EAAE,QAAQ,CAAC;CAC1B,CAAC;qCAIQ,mBACZ,2CAAwC,CAAC,OAAO,CAAC,CAC9C;mCAGS,mBACZ,oDAAiD,CAAC,OAAO,CAAC,CACvD;uBAtEmB,gCAAgC;wCAKjB,qCAAqC"}
+{"version":3,"file":"econ-behaviors.d.ts","sourceRoot":"","sources":["econ-behaviors.js"],"names":[],"mappings":"AAgBA,qCAAsC;AACtC,sCAA0C;AAC1C,qCAAsD;AACtD,sCAAqD;AAwE9C,mcADK,sBAAsB;;;;;;;;;;;;;;;;;;;;;;KA+FjC;AAUM,oDAPI,sBAAsB,CAAC,SAAS,CAAC,kDAEzC;IAAgC,cAAc;IACtB,OAAO;;;CAE/B,8BAAQ,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EvB;AAUM,wSAPI,sBAAsB,UAE9B;IAAgC,cAAc;IACtB,OAAO;;;CAE/B,mBAAQ,MAAM,iBA6FhB;AAWM,wGALI,sBAAsB;;;;8BAuBhC;AAQM,mcAFI,sBAAsB,iBA0GhC;AAQM,+cAJI,sBAAsB,uBAE9B;IAAqB,aAAa,GAA1B,GAAG;CAAwB,iBA0HrC;sCAxmBa,OAAO,CAAC,UAAU;;;;;;;yCA2D2C,2BACpE;;mBAGW,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA/DL,CAAC,CAAC,aAAa,CAAC;;WAI3C,MAAM;SACN,QAAQ;iBACR,QAAQ;qBACR,OAAO,CAChB,UAAU,CACR,OAAO,CACL,UAAU,CAAC,8BAAuB,CAAC,OAAO,CAAC,CAAC,CAC7C,CAAC,cAAc,CAAC,CAAC,wBAAwB,CAAC,CAC5C,CACF;6BACU,oBAAoB,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC;mBAC7D,UAAU;;4BAGV,kBAAkB,CAAC;yBA6fzB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA0Fm9N,yBAAgB;;;;;EAvlBh7N,CAAC;qCAG7D,eAAe,GAAG,mBAAmB,GAAG,qBAAqB;oCAG7D,cAAc,CAAC;IACvB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,6BAA6B,EAAE,OAAO,qCAAqC,EAAE,+BAA+B,CAAC;IAC7G,iBAAiB,EAAE,mBACvB,cAAoB,sBAAsB,EAAE,KAAK,CAC5C,CAAC;IACF,qBAAqB,EAAE,QAAQ,CACnC,MAAY,EACZ,OAAa,sBAAsB,EAAE,oBAAoB,CACpD,CAAC;IACF,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChC,qBAAqB,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,EAAE,kBAAkB,CAClC,2CAA0C,CAAC,OAAO,CAAC,CAC9C,CAAC;IACF,eAAe,EAAE,kBAAkB;;;;;;;6CAmBmC,2BACpE;;uBAGW,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAvBG,CAAC;IAC7C,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,aAAa,GAAG,SAAS,CAAC;IAC5C,cAAc,EAAE,QAAQ,CAAC;CAC1B,CAAC;qCAIQ,mBACZ,2CAAwC,CAAC,OAAO,CAAC,CAC9C;mCAGS,mBACZ,oDAAiD,CAAC,OAAO,CAAC,CACvD;uBAtEmB,gCAAgC;wCAKjB,qCAAqC"}

package/src/proposals/price-feed-proposal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"price-feed-proposal.d.ts","sourceRoot":"","sources":["price-feed-proposal.js"],"names":[],"mappings":";AA6CO,+HAJI,mBAAmB,GAAG,cAAc,8JACpC;IAAE,OAAO,EAAE;QAAE,gBAAgB,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAAE,GACjD,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAsCjD;AAiBM,iSAdI,mBAAmB,qJACnB;IACV,OAAW,EAAE;QACb,gBAAsB,EAAE;YACxB,oBAA4B,EAAE,MAAM,CAAC;YACrC,eAAuB,EAAE,MAAM,EAAE,CAAC;YAClC,aAAqB,EAAE,OAAO,uDAAuD,EAAE,eAAe,CAAC;YACvG,aAAqB,EAAE,MAAM,CAAC;YAC9B,cAAsB,EAAE,MAAM,CAAC;YAC/B,kBAA0B,EAAE,YAAY,CAAC;SAClC,CAAC;KACH,CAAC;CACH,iBAgKH;AAWM,wDAHJ;IAAmD,UAAU,UAA/C,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC;CAC1C,oBAAQ,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA1OP,MAAM;+BACF,MAAM;4BACT,MAAM;gCACF,MAAM;;;GAwR7B;AAQK,wGALI,OAAO,qBAAqB,EAAE,sBAAsB;;;;8BA8D9D;+BA/VY;IACZ,OAAW,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7C,QAAY,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;IAC9C,aAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAsB,EAAE,MAAM,CAAC;CAC5B;oCAtBG,YAAY"}
+{"version":3,"file":"price-feed-proposal.d.ts","sourceRoot":"","sources":["price-feed-proposal.js"],"names":[],"mappings":";AA6CO,+HAJI,mBAAmB,GAAG,cAAc,8JACpC;IAAE,OAAO,EAAE;QAAE,gBAAgB,EAAE,gBAAgB,CAAA;KAAE,CAAA;CAAE,GACjD,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAsCjD;AAiBM,iSAdI,mBAAmB,qJACnB;IACN,OAAO,EAAE;QACP,gBAAgB,EAAE;YAChB,oBAAoB,EAAE,MAAM,CAAC;YAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;YAC1B,aAAa,EAAE,OAAO,uDAAuD,EAAE,eAAe,CAAC;YAC/F,aAAa,EAAE,MAAM,CAAC;YACtB,cAAc,EAAE,MAAM,CAAC;YACvB,kBAAkB,EAAE,YAAY,CAAC;SAClC,CAAC;KACH,CAAC;CACH,iBAiKH;AAWM,wDAHJ;IAAmD,UAAU,UAA/C,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC;CAC1C,oBAAQ,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA3OP,MAAM;+BACF,MAAM;4BACT,MAAM;gCACF,MAAM;;;GAyR7B;AAQK,wGALI,OAAO,qBAAqB,EAAE,sBAAsB;;;;8BA8D9D;+BAhWY;IACR,OAAO,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;oCAtBG,YAAY"}

package/src/proposals/price-feed-proposal.js

@@ -227,7 +227,8 @@ export const createPriceFeed = async (
 
   // being after the above awaits means that when this resolves, the consumer
   // gets notified that the authority is in the registry and its instance is in
-  // agoricNames.
+  // agoricNames. reset() in case we're replacing an existing feed.
+  produceInstance[AGORIC_INSTANCE_NAME].reset();
   produceInstance[AGORIC_INSTANCE_NAME].resolve(faKit.instance);
 
   E(E.get(econCharterKit).creatorFacet).addInstance(

package/src/proposals/replace-scaledPriceAuthorities.d.ts

@@ -0,0 +1,30 @@
+export function replaceScaledPriceAuthority(powers: BootstrapPowers, { options }: {
+    options: object;
+}): Promise<void>;
+export function replaceScaledPriceAuthorities(powers: ChainBootstrapSpace & BootstrapPowers, { options }: {
+    options: {
+        scaledPARef: {
+            bundleID: string;
+        };
+    };
+}): Promise<void>;
+export function getManifestForReplaceScaledPriceAuthorities(_ign: any, upgradeSPAOptions: any): Promise<{
+    manifest: {
+        [x: string]: {
+            consume: {
+                agoricNames: string;
+                priceAuthority: string;
+                startUpgradable: string;
+                zoe: string;
+                agoricNamesAdmin: string;
+                contractKits: string;
+                priceAuthorityAdmin: string;
+            };
+            instance: {
+                produce: string;
+            };
+        };
+    };
+    options: any;
+}>;
+//# sourceMappingURL=replace-scaledPriceAuthorities.d.ts.map

package/src/proposals/replace-scaledPriceAuthorities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-scaledPriceAuthorities.d.ts","sourceRoot":"","sources":["replace-scaledPriceAuthorities.js"],"names":[],"mappings":"AAaO,oDAJI,eAAe,eAEvB;IAAuB,OAAO,EAAtB,MAAM;CAChB,iBAeA;AAUM,sDAHI,mBAAmB,GAAG,eAAe,eACrC;IAAE,OAAO,EAAE;QAAE,WAAW,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,iBA2D5D;AAGM;;;;;;;;;;;;;;;;;;GA0BL"}

package/src/proposals/replace-scaledPriceAuthorities.js

@@ -0,0 +1,124 @@
+import { makeTracer } from '@agoric/internal';
+import { E } from '@endo/far';
+
+import { startScaledPriceAuthority } from './addAssetToVault.js';
+import { scaledPriceFeedName } from './utils.js';
+
+const trace = makeTracer('replaceScaledPA', true);
+
+/**
+ * @param {BootstrapPowers} powers
+ * @param {object} config
+ * @param {object} config.options
+ */
+export const replaceScaledPriceAuthority = async (powers, { options }) => {
+  const {
+    instance: { produce: produceInstance },
+  } = powers;
+  const { issuerName } = options.interchainAssetOptions;
+
+  const spaKit = await startScaledPriceAuthority(powers, { options });
+
+  const label = scaledPriceFeedName(issuerName);
+  produceInstance[label].reset();
+
+  // publish into agoricNames. This must stay after registerPriceAuthority,
+  // which is called by startScaledPriceAuthority()
+  produceInstance[label].resolve(spaKit.instance);
+};
+
+/**
+ * Look up the existing assets known to auctions, and replace the corresponding
+ * scaledPriceAuthorities. The existing contracts will be left behind to be
+ * cleaned up later.
+ *
+ * @param {ChainBootstrapSpace & BootstrapPowers} powers
+ * @param {{ options: { scaledPARef: { bundleID: string } } }} options
+ */
+export const replaceScaledPriceAuthorities = async (powers, { options }) => {
+  trace('start');
+  const {
+    consume: {
+      agoricNamesAdmin,
+      agoricNames,
+      contractKits: contractKitsP,
+      zoe,
+    },
+  } = powers;
+
+  const { scaledPARef } = options;
+
+  const installationsAdmin = E(agoricNamesAdmin).lookupAdmin('installation');
+  const [spaInstallation, contractKits] = await Promise.all([
+    E(E(installationsAdmin).readonly()).lookup('scaledPriceAuthority'),
+    contractKitsP,
+  ]);
+
+  const bundleID = scaledPARef.bundleID;
+  if (scaledPARef && bundleID) {
+    await E.when(
+      E(zoe).installBundleID(bundleID),
+      installation =>
+        E(installationsAdmin).update('scaledPriceAuthority', installation),
+      err =>
+        console.error(
+          `🚨 failed to update scaledPriceAuthority installation`,
+          err,
+        ),
+    );
+    trace('installed scaledPriceAuthority bundle', bundleID);
+  }
+
+  // Ask Zoe for the installation for each kit's instance, and return all the
+  // kits where that matches the given installation.
+  async function maybeSPAKit(kit) {
+    const installation = await E(zoe).getInstallationForInstance(kit.instance);
+    return spaInstallation === installation ? [kit] : [];
+  }
+  const scaledPAKits = (
+    await Promise.all([...contractKits.values()].map(maybeSPAKit))
+  ).flat();
+
+  const namedBrands = await E(E(agoricNames).lookup('brand')).entries();
+
+  for (const kitEntry of scaledPAKits) {
+    const { instance } = kitEntry;
+    const terms = await E(powers.consume.zoe).getTerms(instance);
+    const { brand } = terms.scaleIn.denominator;
+    const entry = namedBrands.find(([_k, v]) => v === brand);
+    assert(entry, 'unable to find issuerName for ', brand);
+    const issuerName = entry[0];
+    await replaceScaledPriceAuthority(powers, {
+      options: { interchainAssetOptions: { issuerName } },
+    });
+  }
+};
+
+const t = 'replaceScaledPriceAuthority';
+export const getManifestForReplaceScaledPriceAuthorities = async (
+  _ign,
+  upgradeSPAOptions,
+) => ({
+  manifest: {
+    [replaceScaledPriceAuthorities.name]: {
+      consume: {
+        // //// Widely known  ////
+        agoricNames: t,
+        priceAuthority: t,
+        startUpgradable: t,
+        zoe: t,
+
+        // //// closely held, powerful ////
+        agoricNamesAdmin: t,
+        contractKits: t,
+        priceAuthorityAdmin: t,
+      },
+      instance: {
+        // This is a right to add/replace any instance. That we update only the
+        // relevant ones must be verified by inspection.
+        produce: t,
+      },
+    },
+  },
+  options: { ...upgradeSPAOptions },
+});