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

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),
-  );
-};