@agoric/builders 0.2.0-u19.3 → 0.2.0-u20.0

package/CHANGELOG.md

@@ -3,35 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [0.2.0-u19.3](https://github.com/Agoric/agoric-sdk/compare/@agoric/builders@0.2.0-u19.2...@agoric/builders@0.2.0-u19.3) (2025-03-13)
-
-**Note:** Version bump only for package @agoric/builders
-
-
-
-
-
-## [0.2.0-u19.2](https://github.com/Agoric/agoric-sdk/compare/@agoric/builders@0.2.0-u19.1...@agoric/builders@0.2.0-u19.2) (2025-03-06)
-
-**Note:** Version bump only for package @agoric/builders
-
-
-
-
-
-## [0.2.0-u19.1](https://github.com/Agoric/agoric-sdk/compare/@agoric/builders@0.2.0-u19.0...@agoric/builders@0.2.0-u19.1) (2025-03-03)
-
-**Note:** Version bump only for package @agoric/builders
-
-
-
-
-
-## 0.2.0-u19.0 (2025-02-24)
+## 0.2.0-u20.0 (2025-04-16)
 
 
 ### ⚠ BREAKING CHANGES
 
+* **chainHub:** register and retrieve non-cosmos chains
 * remove orch.makeLocalAccount
 * make Network and IBC vats durable (#8721)
 
@@ -40,9 +17,11 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 *  smartWallet verstion 2 with watchedPromises ([5ed5107](https://github.com/Agoric/agoric-sdk/commit/5ed51078d39e643d91b572d9c50fad4a276d7ded))
 * `ForwardOpts` accepts `intermediateRecipient` ([eb975f1](https://github.com/Agoric/agoric-sdk/commit/eb975f1df1587bc9307b27c20b7b236cc7fe386e))
 * `ForwardOptsShape` ([50b1717](https://github.com/Agoric/agoric-sdk/commit/50b1717c1e40ed67a5e69810961ad8d0144c5f9e))
+* `update-fee-config` proposal ([5d8775c](https://github.com/Agoric/agoric-sdk/commit/5d8775c409896369a931e6d78ae1d7958ad9d901))
 * a proposal to upgrade scaledPriceAuthorities ([e5ed0ff](https://github.com/Agoric/agoric-sdk/commit/e5ed0ff6abcb83f52b32d49125e21e6e41923ed0))
 * add `bech32Prefix?: string` to `CosmosChainInfo` ([cb9e1ee](https://github.com/Agoric/agoric-sdk/commit/cb9e1eeab9295b44ec009b82d73c457299e8d6f4))
 * add priceFeed for StkAtom ([6a861df](https://github.com/Agoric/agoric-sdk/commit/6a861dfa14f42b4547a24ba31175a3b1a74c97c1))
+* Add terminate-governed-instance.js proposal ([c2cb517](https://github.com/Agoric/agoric-sdk/commit/c2cb51779039ef2a5921efcc35b3b365a7b6159f)), closes [#10725](https://github.com/Agoric/agoric-sdk/issues/10725) [#10861](https://github.com/Agoric/agoric-sdk/issues/10861)
 * add transfer method to CosmosOrchestrationAccount ([b1fdde1](https://github.com/Agoric/agoric-sdk/commit/b1fdde18b33237d1a2ea6f02938d998f55ce4d01))
 * add upgrade zcf only proposal ([73e0bb8](https://github.com/Agoric/agoric-sdk/commit/73e0bb830e7612e74c8fb510b909db154d2b2219))
 * added replace electorate proposal in chain upgrade ([4e88d9f](https://github.com/Agoric/agoric-sdk/commit/4e88d9f0412fe2b90efda30df0afbb61887bf35f))
@@ -55,8 +34,12 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 * **builders:** fast-usdc oracleSet option for MAINNET, ... ([3bf01a2](https://github.com/Agoric/agoric-sdk/commit/3bf01a279e5b2c72d6667704a07056501012260e))
 * **builders:** fast-usdc policy update builder ([8ded3d8](https://github.com/Agoric/agoric-sdk/commit/8ded3d8be612a6944b80f3f63ab6fb727c76d179))
 * **builders:** non-ambient `strictPriceFeedProposalBuilder` in `priceFeedSupport.js` ([95174a2](https://github.com/Agoric/agoric-sdk/commit/95174a23671ed16f7497ef6b0edaa63a54f1343d))
+* **builders:** to reconfigure Fast USDC ([833e674](https://github.com/Agoric/agoric-sdk/commit/833e67499acfe20e2d73c9322b8c3b28df52b1d6))
+* Caip10RecordShape ([8a104f2](https://github.com/Agoric/agoric-sdk/commit/8a104f27cae9c6c1bd44c86d7bd2736fea333234))
 * chain-capabilities.js constants ([52ff70a](https://github.com/Agoric/agoric-sdk/commit/52ff70a187df1fadc89ccc506228bc6d0ca48da6))
+* **chainHub:** register and retrieve non-cosmos chains ([bd11be2](https://github.com/Agoric/agoric-sdk/commit/bd11be25656ad0dd9ea4ad18c85f74a11ef2e520))
 * coreEval to update priceFeeds, auction, and vaultManager ([fd91f78](https://github.com/Agoric/agoric-sdk/commit/fd91f781ad721033d67485d1732272af0c689ae7))
+* **cosmos:** upgrade IBC vat for next release ([c994490](https://github.com/Agoric/agoric-sdk/commit/c99449081560480e7e2dd6fc069b12dbcc630370))
 * examples/auto-stake-it.contract.js ([b87ecba](https://github.com/Agoric/agoric-sdk/commit/b87ecba0ea41f1397dbd513d8e4c541f1299fd3f)), closes [#9042](https://github.com/Agoric/agoric-sdk/issues/9042)
 * export `DenomDetailShape` ([2dfddb3](https://github.com/Agoric/agoric-sdk/commit/2dfddb3fb2018d769b1acc1b32f4ff3b4c7f67b7))
 * export `OrchestrationPowersShape` ([34b61ea](https://github.com/Agoric/agoric-sdk/commit/34b61eae918a5f02ba6e06ac7e15b24750494821))
@@ -83,6 +66,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 * stakeBld contract ([a7e30a4](https://github.com/Agoric/agoric-sdk/commit/a7e30a4e43c00b2916d2d57c70063650e726321f))
 * start a new auction in a3p-integration ([969235b](https://github.com/Agoric/agoric-sdk/commit/969235b18abbd15187e343d5f616f12177d224c4))
 * update price feed proposal support for custom config ([8804ed2](https://github.com/Agoric/agoric-sdk/commit/8804ed28e259bf4ee9dd8872ccdd9ec42897e279))
+* update settler reference proposal ([23e52dc](https://github.com/Agoric/agoric-sdk/commit/23e52dc7a074c3366a24bbd34a4df7a419fd992f))
 * upgrade auction and vaults to use the new governor ([5aeac6d](https://github.com/Agoric/agoric-sdk/commit/5aeac6d2bd3a95357c9a725e01391b3d967530ff))
 * upgrade v7-board and test it ([#10516](https://github.com/Agoric/agoric-sdk/issues/10516)) ([d8a109e](https://github.com/Agoric/agoric-sdk/commit/d8a109edcc78c977ef856131b52dd449e6a9d724)), closes [#10394](https://github.com/Agoric/agoric-sdk/issues/10394)
 * **vat-transfer:** first cut at working proposal ([2864bd5](https://github.com/Agoric/agoric-sdk/commit/2864bd5c12300c3595df9676bcfde894dbe59b29))
@@ -100,5 +84,11 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 * **orchestration:** makeAccount never resolves when icqEnabled: false ([a74b6a2](https://github.com/Agoric/agoric-sdk/commit/a74b6a27d5108c5e014d546b86c695e3fc8bf2e5))
 * repair storage of zcfBundleCap and add a3p test ([72c7574](https://github.com/Agoric/agoric-sdk/commit/72c75740aff920ffb53231441d0f00a8747400f1))
 * support issuerName separate from keyword in add-collateral-core ([f0b1559](https://github.com/Agoric/agoric-sdk/commit/f0b1559374fe67d10e92f20c85d90a6f07e03cf0))
+* **types:** discriminate `ChainInfo` union on `namespace` ([0f9f3fc](https://github.com/Agoric/agoric-sdk/commit/0f9f3fcbdd9da33b2eca1c02a2f7189c5405e8ff))
 * validate scriptArgs endowment ([6864614](https://github.com/Agoric/agoric-sdk/commit/68646147d3e95c68b4a90c9e37d888ef00e9d35d))
 * write-chain-info after u17 ([fc1f3ce](https://github.com/Agoric/agoric-sdk/commit/fc1f3ce1fe03bb2018edd4eb55d6561312d5fbe8))
+
+
+### Reverts
+
+* Revert "chore: remove 'encoding' from ChainAddress" ([be9dee2](https://github.com/Agoric/agoric-sdk/commit/be9dee245a04714568a45ae8b328f54b20b43d8a))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/builders",
-  "version": "0.2.0-u19.3",
+  "version": "0.2.0-u20.0",
   "description": "Build scripts for proposals to an Agoric chain",
   "type": "module",
   "main": "./index.js",
@@ -23,35 +23,34 @@
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/ertp": "^0.16.3-u19.2",
-    "@agoric/fast-usdc": "^0.2.0-u19.2",
-    "@agoric/internal": "^0.4.0-u19.2",
-    "@agoric/notifier": "^0.7.0-u19.2",
-    "@agoric/smart-wallet": "^0.5.4-u19.2",
-    "@agoric/vat-data": "^0.5.3-u19.2",
-    "@agoric/vats": "^0.16.0-u19.2",
-    "@agoric/zoe": "^0.27.0-u19.2",
-    "@endo/bundle-source": "^3.5.1",
-    "@endo/captp": "^4.4.4",
-    "@endo/eventual-send": "^1.3.0",
-    "@endo/far": "^1.1.10",
-    "@endo/init": "^1.1.8",
-    "@endo/marshal": "^1.6.3",
-    "@endo/patterns": "^1.4.8",
-    "@endo/promise-kit": "^1.1.9",
-    "@endo/stream": "^1.2.9",
+    "@agoric/ertp": "^0.16.3-u20.0",
+    "@agoric/internal": "^0.4.0-u20.0",
+    "@agoric/notifier": "^0.7.0-u20.0",
+    "@agoric/smart-wallet": "^0.5.4-u20.0",
+    "@agoric/vat-data": "^0.5.3-u20.0",
+    "@agoric/vats": "^0.16.0-u20.0",
+    "@agoric/zoe": "^0.27.0-u20.0",
+    "@endo/bundle-source": "^4.0.0",
+    "@endo/captp": "^4.4.5",
+    "@endo/eventual-send": "^1.3.1",
+    "@endo/far": "^1.1.11",
+    "@endo/init": "^1.1.9",
+    "@endo/marshal": "^1.6.4",
+    "@endo/patterns": "^1.5.0",
+    "@endo/promise-kit": "^1.1.10",
+    "@endo/stream": "^1.2.10",
     "import-meta-resolve": "^4.1.0"
   },
   "devDependencies": {
-    "@agoric/deploy-script-support": "^0.10.4-u19.2",
-    "@agoric/governance": "^0.10.4-u19.2",
-    "@agoric/inter-protocol": "^0.17.0-u19.2",
-    "@agoric/orchestration": "^0.2.0-u19.2",
-    "@agoric/store": "^0.9.3-u19.0",
-    "@agoric/swing-store": "^0.10.0-u19.2",
-    "@agoric/swingset-liveslots": "^0.10.3-u19.2",
-    "@agoric/time": "^0.3.3-u19.0",
-    "@endo/errors": "^1.2.9",
+    "@agoric/deploy-script-support": "^0.10.4-u20.0",
+    "@agoric/governance": "^0.10.4-u20.0",
+    "@agoric/inter-protocol": "^0.17.0-u20.0",
+    "@agoric/orchestration": "^0.2.0-u20.0",
+    "@agoric/store": "^0.9.3-u20.0",
+    "@agoric/swing-store": "^0.10.0-u20.0",
+    "@agoric/swingset-liveslots": "^0.10.3-u20.0",
+    "@agoric/time": "^0.3.3-u20.0",
+    "@endo/errors": "^1.2.10",
     "ava": "^5.3.0",
     "c8": "^10.1.2"
   },
@@ -81,7 +80,7 @@
     "workerThreads": false
   },
   "typeCoverage": {
-    "atLeast": 91.57
+    "atLeast": 91.55
   },
-  "gitHead": "f0ae74b84cb6de3724bfdcd18b4bea7e8199dee1"
+  "gitHead": "8e4207fa19dabf76c1f91f8779b5b5b93570ecea"
 }

package/scripts/testing/append-chain-info.js

@@ -1,10 +1,10 @@
 /// <reference types="ses" />
 import { makeHelpers } from '@agoric/deploy-script-support';
 
-/** @type {Record<string, import('@agoric/orchestration/src/chain-info.js').ChainInfo>} */
+/** @type {Record<string, import('@agoric/orchestration').ChainInfo>} */
 const chainInfo = {
   hot: {
-    allegedName: 'Hot New Chain',
+    bech32Prefix: 'cosmos',
     chainId: 'hot-1',
     connections: {
       'cosmoshub-4': {
@@ -26,6 +26,8 @@ const chainInfo = {
         },
       },
     },
+    namespace: 'cosmos',
+    reference: 'hot-1',
   },
 };
 

package/scripts/testing/tweak-chain-info.js

@@ -1,13 +1,16 @@
 /// <reference types="ses" />
 import { makeHelpers } from '@agoric/deploy-script-support';
 
-/** @type {Record<string, import('@agoric/orchestration/src/chain-info.js').ChainInfo>} */
+/** @type {Record<string, import('@agoric/orchestration').ChainInfo>} */
 const chainInfo = {
   agoric: {
+    bech32Prefix: 'agoric',
     chainId: 'agoric-4',
+    namespace: 'cosmos',
+    reference: 'agoric-4',
   },
   hot: {
-    allegedName: 'Hot New Chain',
+    bech32Prefix: 'hot',
     chainId: 'hot-1',
     connections: {
       'cosmoshub-4': {
@@ -29,6 +32,8 @@ const chainInfo = {
         },
       },
     },
+    namespace: 'cosmos',
+    reference: 'hot-1',
   },
 };
 

package/scripts/vats/upgrade-mintHolder.js

@@ -54,15 +54,16 @@ const configurations = {
   },
   EMERYNET: {
     labelList: [
-      'USDC_axl',
-      'USDT_grv',
+      'ATOM',
+      'USDT',
       'DAI_axl',
       'DAI_grv',
+      'USDC_axl',
+      'stOSMO',
       'stATOM',
-      'USDC_grv',
-      'ATOM',
-      'USDT_axl',
-      'USDC',
+      'stkATOM',
+      'stOSMO2',
+      'ToyUSD',
       'BLD',
     ],
   },

package/scripts/vats/upgrade-orchestration.js

@@ -1,27 +1,21 @@
 import { makeHelpers } from '@agoric/deploy-script-support';
+import { upgradeVatsProposalBuilder } from './upgrade-vats.js';
 
 /** @type {import('@agoric/deploy-script-support/src/externalTypes.js').CoreEvalBuilder} */
-export const defaultProposalBuilder = async ({ publishRef, install }) =>
-  harden({
-    sourceSpec: '@agoric/vats/src/proposals/upgrade-vats-generic-proposal.js',
-    getManifestCall: [
-      'getManifestForUpgradingVats',
-      {
-        bundleRefs: {
-          ibc: publishRef(install('@agoric/vats/src/vat-ibc.js')),
-          network: publishRef(install('@agoric/vats/src/vat-network.js')),
-          localchain: publishRef(install('@agoric/vats/src/vat-localchain.js')),
-          transfer: publishRef(install('@agoric/vats/src/vat-transfer.js')),
-          orchestration: publishRef(
-            install('@agoric/orchestration/src/vat-orchestration.js'),
-          ),
-        },
-      },
-    ],
-  });
+export const defaultProposalBuilder = async powers => {
+  const bundleRecord = {
+    ibc: '@agoric/vats/src/vat-ibc.js',
+    network: '@agoric/vats/src/vat-network.js',
+    localchain: '@agoric/vats/src/vat-localchain.js',
+    transfer: '@agoric/vats/src/vat-transfer.js',
+    orchestration: '@agoric/orchestration/src/vat-orchestration.js',
+  };
+
+  return upgradeVatsProposalBuilder(powers, bundleRecord);
+};
 
 /** @type {import('@agoric/deploy-script-support/src/externalTypes.js').DeployScriptFunction} */
 export default async (homeP, endowments) => {
   const { writeCoreProposal } = await makeHelpers(homeP, endowments);
-  await writeCoreProposal('upgrade-network', defaultProposalBuilder);
+  await writeCoreProposal('upgrade-orchestration', defaultProposalBuilder);
 };

package/scripts/vats/upgrade-vats.js

@@ -0,0 +1,23 @@
+/** @type {import('@agoric/deploy-script-support/src/externalTypes.js').CoreEvalBuilder} */
+export const upgradeVatsProposalBuilder = async (
+  { publishRef, install },
+  bundleRecord,
+) => {
+  if (!bundleRecord) {
+    throw Error('Missing bundleRecord');
+  }
+  return harden({
+    sourceSpec: '@agoric/vats/src/proposals/upgrade-vats-generic-proposal.js',
+    getManifestCall: [
+      'getManifestForUpgradingVats',
+      {
+        bundleRefs: Object.fromEntries(
+          Object.entries(bundleRecord).map(
+            ([name, entrypoint]) =>
+              /** @type {const} */ ([name, publishRef(install(entrypoint))]),
+          ),
+        ),
+      },
+    ],
+  });
+};

package/scripts/fast-usdc/add-operators.build.js

@@ -1,83 +0,0 @@
-// @ts-check
-import { makeHelpers } from '@agoric/deploy-script-support';
-import { getManifestForAddOperators } from '@agoric/fast-usdc/src/add-operators.core.js';
-import { toExternalConfig } from '@agoric/fast-usdc/src/utils/config-marshal.js';
-import { configurations } from '@agoric/fast-usdc/src/utils/deploy-config.js';
-import { Far } from '@endo/far';
-import { parseArgs } from 'node:util';
-
-/**
- * @import {CoreEvalBuilder, DeployScriptFunction} from '@agoric/deploy-script-support/src/externalTypes.js';
- * @import {ParseArgsConfig} from 'node:util';
- * @import {FastUSDCConfig, FeedPolicy} from '@agoric/fast-usdc/src/types.js';
- * @import {FastUSDCOpts} from './start-fast-usdc.build.js';
- */
-
-const { keys } = Object;
-
-/** @type {ParseArgsConfig['options']} */
-const options = {
-  net: { type: 'string' },
-  oracle: { type: 'string', multiple: true },
-};
-const oraclesUsage = 'use --oracle name:address ...';
-
-const crossVatContext = /** @type {const} */ ({
-  /** @type {Brand<'nat'>} */
-  USDC: Far('USDC Brand'),
-});
-
-/** @type {CoreEvalBuilder} */
-export const defaultProposalBuilder = async (
-  powers,
-  /** @type {FastUSDCConfig} */ config,
-) => {
-  return harden({
-    sourceSpec: '@agoric/fast-usdc/src/add-operators.core.js',
-    /** @type {[string, Parameters<typeof getManifestForAddOperators>[1]]} */
-    getManifestCall: [
-      getManifestForAddOperators.name,
-      {
-        options: toExternalConfig(config, crossVatContext),
-      },
-    ],
-  });
-};
-
-/** @type {DeployScriptFunction} */
-export default async (homeP, endowments) => {
-  const { writeCoreEval } = await makeHelpers(homeP, endowments);
-  const { scriptArgs } = endowments;
-
-  /** @type {{ values: FastUSDCOpts }} */
-  // @ts-expect-error ensured by options
-  const {
-    values: { oracle: oracleArgs, net },
-  } = parseArgs({ args: scriptArgs, options });
-
-  const parseOracleArgs = () => {
-    if (net) {
-      if (!(net in configurations)) {
-        throw Error(`${net} not in ${keys(configurations)}`);
-      }
-      return configurations[net].oracles;
-    }
-    if (!oracleArgs) throw Error(oraclesUsage);
-    return Object.fromEntries(
-      oracleArgs.map(arg => {
-        const result = arg.match(/(?<name>[^:]+):(?<address>.+)/);
-        if (!(result && result.groups)) throw Error(oraclesUsage);
-        const { name, address } = result.groups;
-        return [name, address];
-      }),
-    );
-  };
-
-  const config = harden({
-    oracles: parseOracleArgs(),
-  });
-
-  await writeCoreEval('add-operators', utils =>
-    defaultProposalBuilder(utils, config),
-  );
-};

package/scripts/fast-usdc/fast-usdc-fees.build.js

@@ -1,75 +0,0 @@
-import { makeHelpers } from '@agoric/deploy-script-support';
-import { AmountMath } from '@agoric/ertp';
-import { getManifestForDistributeFees } from '@agoric/fast-usdc/src/distribute-fees.core.js';
-import { toExternalConfig } from '@agoric/fast-usdc/src/utils/config-marshal.js';
-import {
-  multiplyBy,
-  parseRatio,
-} from '@agoric/zoe/src/contractSupport/ratio.js';
-import { Far } from '@endo/far';
-import { parseArgs } from 'node:util';
-
-/**
- * @import {CoreEvalBuilder, DeployScriptFunction} from '@agoric/deploy-script-support/src/externalTypes.js'
- * @import {FeeDistributionTerms} from '@agoric/fast-usdc/src/distribute-fees.core.js'
- */
-
-const usage =
-  'Use: [--fixedFees <number> | --feePortion <percent>] --destinationAddress <address> ...';
-
-const xVatCtx = /** @type {const} */ ({
-  /** @type {Brand<'nat'>} */
-  USDC: Far('USDC Brand'),
-});
-const { USDC } = xVatCtx;
-const USDC_DECIMALS = 6n;
-const unit = AmountMath.make(USDC, 10n ** USDC_DECIMALS);
-
-/**
- * @param {unknown} _utils
- * @param {FeeDistributionTerms} feeTerms
- * @satisfies {CoreEvalBuilder}
- */
-export const feeProposalBuilder = async (_utils, feeTerms) => {
-  return harden({
-    sourceSpec: '@agoric/fast-usdc/src/distribute-fees.core.js',
-    /** @type {[string, Parameters<typeof getManifestForDistributeFees>[1]]} */
-    getManifestCall: [
-      getManifestForDistributeFees.name,
-      { options: toExternalConfig(harden({ feeTerms }), xVatCtx) },
-    ],
-  });
-};
-
-/** @type {DeployScriptFunction} */
-export default async (homeP, endowments) => {
-  const { writeCoreEval } = await makeHelpers(homeP, endowments);
-  /** @type {{ values: Record<string, string | undefined> }} */
-  const {
-    values: { destinationAddress, ...opt },
-  } = parseArgs({
-    args: endowments.scriptArgs,
-    options: {
-      destinationAddress: { type: 'string' },
-      fixedFees: { type: 'string' },
-      feePortion: { type: 'string' },
-    },
-  });
-  if (!destinationAddress) assert.fail(usage);
-  if (opt.fixedFees && opt.feePortion) assert.fail(usage);
-
-  /** @type {FeeDistributionTerms} */
-  const feeTerms = {
-    destinationAddress,
-    ...((opt.fixedFees && {
-      fixedFees: multiplyBy(unit, parseRatio(opt.fixedFees, USDC)),
-    }) ||
-      (opt.feePortion && {
-        feePortion: parseRatio(opt.feePortion, USDC),
-      }) ||
-      assert.fail(usage)),
-  };
-  await writeCoreEval('eval-fast-usdc-fees', utils =>
-    feeProposalBuilder(utils, feeTerms),
-  );
-};

package/scripts/fast-usdc/fast-usdc-update.build.js

@@ -1,65 +0,0 @@
-import { parseArgs } from 'node:util';
-import { getManifestForUpdateFastUsdcPolicy } from '@agoric/fast-usdc/src/fast-usdc-policy.core.js';
-import { toExternalConfig } from '@agoric/fast-usdc/src/utils/config-marshal.js';
-import { FeedPolicyShape } from '@agoric/fast-usdc/src/type-guards.js';
-import { makeHelpers } from '@agoric/deploy-script-support';
-
-/**
- * @import {CoreEvalBuilder, DeployScriptFunction} from '@agoric/deploy-script-support/src/externalTypes.js'
- * @import {ParseArgsConfig} from 'node:util'
- * @import {FastUSDCConfig} from '@agoric/fast-usdc';
- */
-
-/** @type {ParseArgsConfig['options']} */
-const options = {
-  feedPolicy: { type: 'string' },
-};
-const feedPolicyUsage = 'use --feedPolicy <policy> ...';
-
-/**
- * @typedef {{
- *   feedPolicy?: string;
- * }} FastUSDCUpdateOpts
- */
-
-/**
- * @param {Parameters<CoreEvalBuilder>[0]} powers
- * @param {FastUSDCConfig} config
- * @satisfies {CoreEvalBuilder}
- */
-export const updateProposalBuilder = async (
-  powers,
-  /** @type {Pick<FastUSDCConfig, 'feedPolicy'>} */ config,
-) => {
-  return harden({
-    sourceSpec: '@agoric/fast-usdc/src/fast-usdc-policy.core.js',
-    /** @type {[string, Parameters<typeof getManifestForUpdateFastUsdcPolicy>[1]]} */
-    getManifestCall: [
-      getManifestForUpdateFastUsdcPolicy.name,
-      {
-        options: toExternalConfig(
-          config,
-          {},
-          harden({ feedPolicy: FeedPolicyShape }),
-        ),
-      },
-    ],
-  });
-};
-
-/** @type {DeployScriptFunction} */
-export default async (homeP, endowments) => {
-  const { writeCoreEval } = await makeHelpers(homeP, endowments);
-  const {
-    values: { feedPolicy },
-  } = parseArgs({ args: endowments.scriptArgs, options });
-
-  const parseFeedPolicy = () => {
-    if (typeof feedPolicy !== 'string') throw Error(feedPolicyUsage);
-    return JSON.parse(feedPolicy);
-  };
-  const config = harden({ feedPolicy: parseFeedPolicy() });
-  await writeCoreEval('eval-fast-usdc-policy-update', utils =>
-    updateProposalBuilder(utils, config),
-  );
-};

package/scripts/fast-usdc/start-fast-usdc.build.js

@@ -1,207 +0,0 @@
-// @ts-check
-import { makeHelpers } from '@agoric/deploy-script-support';
-import { AmountMath } from '@agoric/ertp';
-import { getManifestForFastUSDC } from '@agoric/fast-usdc/src/start-fast-usdc.core.js';
-import { FastUSDCConfigShape } from '@agoric/fast-usdc/src/type-guards.js';
-import { toExternalConfig } from '@agoric/fast-usdc/src/utils/config-marshal.js';
-import { configurations } from '@agoric/fast-usdc/src/utils/deploy-config.js';
-import {
-  multiplyBy,
-  parseRatio,
-} from '@agoric/zoe/src/contractSupport/ratio.js';
-import { Far } from '@endo/far';
-import { parseArgs } from 'node:util';
-
-/**
- * @import {CoreEvalBuilder, DeployScriptFunction} from '@agoric/deploy-script-support/src/externalTypes.js'
- * @import {ParseArgsConfig} from 'node:util'
- * @import {FastUSDCConfig, FeedPolicy} from '@agoric/fast-usdc';
- */
-
-const { keys } = Object;
-
-/** @type {ParseArgsConfig['options']} */
-const options = {
-  flatFee: { type: 'string', default: '0.01' },
-  variableRate: { type: 'string', default: '0.01' },
-  contractRate: { type: 'string', default: '0.2' },
-  net: { type: 'string' },
-  oracle: { type: 'string', multiple: true },
-  feedPolicy: { type: 'string' },
-  usdcDenom: {
-    type: 'string',
-    default:
-      'ibc/FE98AAD68F02F03565E9FA39A5E627946699B2B07115889ED812D8BA639576A9',
-  },
-  chainInfo: { type: 'string' },
-  assetInfo: { type: 'string' },
-  noNoble: { type: 'boolean', default: false },
-};
-const oraclesUsage = 'use --oracle name:address ...';
-
-const feedPolicyUsage = 'use --feedPolicy <policy> ...';
-
-const chainInfoUsage = 'use --chainInfo {chainName:CosmosChainInfo, ...}';
-const assetInfoUsage =
-  'use --assetInfo { denom:DenomInfo & {brandKey?: string} ... }';
-
-/**
- * @typedef {{
- *   flatFee: string;
- *   variableRate: string;
- *   contractRate: string;
- *   net?: string;
- *   oracle?: string[];
- *   usdcDenom: string;
- *   feedPolicy?: string;
- *   chainInfo?: string;
- *   assetInfo?: string;
- *   noNoble: boolean;
- * }} FastUSDCOpts
- */
-
-const crossVatContext = /** @type {const} */ ({
-  /** @type {Brand<'nat'>} */
-  USDC: Far('USDC Brand'),
-});
-const { USDC } = crossVatContext;
-const USDC_DECIMALS = 6;
-const unit = AmountMath.make(USDC, 10n ** BigInt(USDC_DECIMALS));
-
-/**
- * @param {Parameters<CoreEvalBuilder>[0]} powers
- * @param {FastUSDCConfig} config
- * @satisfies {CoreEvalBuilder}
- */
-export const defaultProposalBuilder = async (
-  { publishRef, install },
-  config,
-) => {
-  return harden({
-    sourceSpec: '@agoric/fast-usdc/src/start-fast-usdc.core.js',
-    /** @type {[string, Parameters<typeof getManifestForFastUSDC>[1]]} */
-    getManifestCall: [
-      getManifestForFastUSDC.name,
-      {
-        options: toExternalConfig(config, crossVatContext, FastUSDCConfigShape),
-        installKeys: {
-          fastUsdc: publishRef(
-            install('@agoric/fast-usdc/src/fast-usdc.contract.js'),
-          ),
-        },
-      },
-    ],
-  });
-};
-
-/** @type {DeployScriptFunction} */
-export default async (homeP, endowments) => {
-  const { writeCoreEval } = await makeHelpers(homeP, endowments);
-  const { scriptArgs } = endowments;
-
-  /** @type {{ values: FastUSDCOpts }} */
-  // @ts-expect-error ensured by options
-  const {
-    values: {
-      oracle: oracleArgs,
-      net,
-      usdcDenom,
-      feedPolicy,
-      chainInfo,
-      assetInfo,
-      noNoble,
-      ...fees
-    },
-  } = parseArgs({ args: scriptArgs, options });
-
-  /** @returns {FeedPolicy} */
-  const parseFeedPolicy = () => {
-    if (net) {
-      if (!(net in configurations)) {
-        throw Error(`${net} not in ${keys(configurations)}`);
-      }
-      return configurations[net].feedPolicy;
-    }
-    if (!feedPolicy) throw Error(feedPolicyUsage);
-    const parsed = JSON.parse(feedPolicy);
-    if (!parsed.chainPolicies) {
-      return {
-        ...configurations.MAINNET.feedPolicy,
-        ...parsed,
-      };
-    } else {
-      // consider having callers use `toExternalConfig` to pass in bigints and
-      // use `fromExternalConfig` here to parse
-      throw Error('TODO: support unmarshalling feedPolicy');
-    }
-  };
-
-  const parseOracleArgs = () => {
-    if (net) {
-      if (!(net in configurations)) {
-        throw Error(`${net} not in ${keys(configurations)}`);
-      }
-      return configurations[net].oracles;
-    }
-    if (!oracleArgs) throw Error(oraclesUsage);
-    return Object.fromEntries(
-      oracleArgs.map(arg => {
-        const result = arg.match(/(?<name>[^:]+):(?<address>.+)/);
-        if (!(result && result.groups)) throw Error(oraclesUsage);
-        const { name, address } = result.groups;
-        return [name, address];
-      }),
-    );
-  };
-
-  /** @param {string} numeral */
-  const toAmount = numeral => multiplyBy(unit, parseRatio(numeral, USDC));
-  /** @param {string} numeral */
-  const toRatio = numeral => parseRatio(numeral, USDC);
-  const parseFeeConfigArgs = () => {
-    const { flatFee, variableRate, contractRate } = fees;
-    return {
-      flat: toAmount(flatFee),
-      variableRate: toRatio(variableRate),
-      contractRate: toRatio(contractRate),
-    };
-  };
-
-  const parseChainInfo = () => {
-    if (net) {
-      if (!(net in configurations)) {
-        throw Error(`${net} not in ${keys(configurations)}`);
-      }
-      return configurations[net].chainInfo;
-    }
-    if (!chainInfo) throw Error(chainInfoUsage);
-    return JSON.parse(chainInfo);
-  };
-  const parseAssetInfo = () => {
-    if (net) {
-      if (!(net in configurations)) {
-        throw Error(`${net} not in ${keys(configurations)}`);
-      }
-      return configurations[net].assetInfo;
-    }
-    if (!assetInfo) throw Error(assetInfoUsage);
-    return JSON.parse(assetInfo);
-  };
-
-  /** @type {FastUSDCConfig} */
-  const config = harden({
-    oracles: parseOracleArgs(),
-    terms: {
-      usdcDenom,
-    },
-    feeConfig: parseFeeConfigArgs(),
-    feedPolicy: parseFeedPolicy(),
-    chainInfo: parseChainInfo(),
-    assetInfo: parseAssetInfo(),
-    noNoble,
-  });
-
-  await writeCoreEval('start-fast-usdc', utils =>
-    defaultProposalBuilder(utils, config),
-  );
-};

package/scripts/vats/terminate-governor-instance.js

@@ -1,134 +0,0 @@
-/**
- * @file Terminate price-feed governor instances such as mainnet v110.
- * Functions as both an off-chain builder and an on-chain core-eval.
- */
-
-/// <reference types="@agoric/vats/src/core/types-ambient"/>
-
-import { E } from '@endo/far';
-
-const SELF = '@agoric/builders/scripts/vats/terminate-governor-instance.js';
-const USAGE = `Usage: agoric run /path/to/terminate-governor-instance.js \\
-  <$governorInstanceHandleBoardID:$instanceKitLabel>...`;
-
-const repr = val =>
-  typeof val === 'string' || (typeof val === 'object' && val !== null)
-    ? JSON.stringify(val)
-    : String(val);
-const defaultMakeError = (strings, ...subs) =>
-  Error(
-    strings.map((s, i) => `${i === 0 ? '' : repr(subs[i - 1])}${s}`).join(''),
-  );
-const makeUsageError = (strings, ...subs) => {
-  const err = defaultMakeError(strings, ...subs);
-  console.error(err.message);
-  console.error(USAGE);
-  return err;
-};
-
-const rtarget = /^(?<boardID>board[0-9]+):(?<instanceKitLabel>.+)$/;
-/**
- * @param {string[]} args
- * @param {(strings: TemplateStringsArray | string[], ...subs: unknown[]) => Error} [makeError]
- * @returns {Array<{boardID: string, instanceKitLabel: string}>}
- */
-const parseTargets = (args = [], makeError = defaultMakeError) => {
-  if (!Array.isArray(args)) throw makeError`invalid targets: ${args}`;
-  /** @type {Array<{boardID: string, instanceKitLabel: string}>} */
-  const targets = [];
-  const badTargets = [];
-  for (const arg of args) {
-    const m = typeof arg === 'string' && arg.match(rtarget);
-    if (!m) {
-      badTargets.push(arg);
-    } else {
-      // @ts-expect-error cast
-      targets.push(m.groups);
-    }
-  }
-  if (badTargets.length !== 0) {
-    throw makeError`malformed target(s): ${badTargets}`;
-  } else if (targets.length === 0) {
-    throw makeError`no target(s)`;
-  }
-  return targets;
-};
-
-/**
- * @param {BootstrapPowers} powers
- * @param {{ options: { targetSpecifiers: string[] } }} config
- */
-export const terminateGovernors = async (
-  { consume: { board, governedContractKits } },
-  { options: { targetSpecifiers } },
-) => {
-  const { Fail, quote: q } = assert;
-  const targets = parseTargets(targetSpecifiers, Fail);
-  const doneP = Promise.allSettled(
-    targets.map(async ({ boardID, instanceKitLabel }) => {
-      const logLabel = [boardID, instanceKitLabel];
-      const contractInstanceHandle = await E(board).getValue(boardID);
-      const instanceKit = await E(governedContractKits).get(
-        // @ts-expect-error TS2345 Property '[tag]' is missing
-        contractInstanceHandle,
-      );
-      console.log(
-        `${q(logLabel)} alleged governor contract instance kit`,
-        instanceKit,
-      );
-      const { label, governorAdminFacet, adminFacet } = instanceKit;
-      label === instanceKitLabel ||
-        Fail`${q(logLabel)} unexpected instanceKit label, got ${label} but wanted ${q(instanceKitLabel)}`;
-      (adminFacet && adminFacet !== governorAdminFacet) ||
-        Fail`${q(logLabel)} instanceKit adminFacet should have been present and different from governorAdminFacet but was ${adminFacet}`;
-      const reason = harden(Error(`core-eval terminating ${label} governor`));
-      await E(governorAdminFacet).terminateContract(reason);
-      console.log(`${q(logLabel)} terminated governor`);
-    }),
-  );
-  const results = await doneP;
-  const problems = targets.flatMap(({ boardID, instanceKitLabel }, i) => {
-    if (results[i].status === 'fulfilled') return [];
-    return [[boardID, instanceKitLabel, results[i].reason]];
-  });
-  if (problems.length !== 0) {
-    console.error('governor termination(s) failed', problems);
-    Fail`governor termination(s) failed: ${problems}`;
-  }
-};
-harden(terminateGovernors);
-
-export const getManifest = (_powers, targetSpecifiers) => {
-  parseTargets(targetSpecifiers);
-  return {
-    manifest: {
-      [terminateGovernors.name]: {
-        consume: { board: true, governedContractKits: true },
-      },
-    },
-    // Provide `terminateGovernors` a second argument like
-    // `{ options: { targetSpecifiers } }`.
-    options: { targetSpecifiers },
-  };
-};
-
-/** @type {import('@agoric/deploy-script-support/src/externalTypes.js').CoreEvalBuilder} */
-export const defaultProposalBuilder = async (_utils, targetSpecifiers) => {
-  parseTargets(targetSpecifiers);
-  return harden({
-    sourceSpec: SELF,
-    getManifestCall: ['getManifest', targetSpecifiers],
-  });
-};
-
-/** @type {import('@agoric/deploy-script-support/src/externalTypes.js').DeployScriptFunction} */
-export default async (homeP, endowments) => {
-  const { scriptArgs } = endowments;
-  parseTargets(scriptArgs, makeUsageError);
-  const dspModule = await import('@agoric/deploy-script-support');
-  const { makeHelpers } = dspModule;
-  const { writeCoreEval } = await makeHelpers(homeP, endowments);
-  await writeCoreEval(terminateGovernors.name, utils =>
-    defaultProposalBuilder(utils, scriptArgs),
-  );
-};