@agoric/builders 0.1.1-dev-5fd303a.0 → 0.1.1-dev-7390224.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/builders",
-  "version": "0.1.1-dev-5fd303a.0+5fd303a",
+  "version": "0.1.1-dev-7390224.0+7390224",
   "description": "Build scripts for proposals to an Agoric chain",
   "type": "module",
   "main": "./index.js",
@@ -23,32 +23,34 @@
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/ertp": "0.16.3-dev-5fd303a.0+5fd303a",
-    "@agoric/internal": "0.3.3-dev-5fd303a.0+5fd303a",
-    "@agoric/notifier": "0.6.3-dev-5fd303a.0+5fd303a",
-    "@agoric/smart-wallet": "0.5.4-dev-5fd303a.0+5fd303a",
-    "@agoric/vat-data": "0.5.3-dev-5fd303a.0+5fd303a",
-    "@agoric/vats": "0.15.2-dev-5fd303a.0+5fd303a",
-    "@agoric/zoe": "0.26.3-dev-5fd303a.0+5fd303a",
+    "@agoric/ertp": "0.16.3-dev-7390224.0+7390224",
+    "@agoric/fast-usdc": "0.1.0",
+    "@agoric/internal": "0.3.3-dev-7390224.0+7390224",
+    "@agoric/notifier": "0.6.3-dev-7390224.0+7390224",
+    "@agoric/smart-wallet": "0.5.4-dev-7390224.0+7390224",
+    "@agoric/vat-data": "0.5.3-dev-7390224.0+7390224",
+    "@agoric/vats": "0.15.2-dev-7390224.0+7390224",
+    "@agoric/zoe": "0.26.3-dev-7390224.0+7390224",
     "@endo/bundle-source": "^3.4.2",
     "@endo/captp": "^4.4.2",
     "@endo/eventual-send": "^1.2.7",
     "@endo/far": "^1.1.8",
     "@endo/init": "^1.1.6",
     "@endo/marshal": "^1.6.1",
+    "@endo/patterns": "^1.4.6",
     "@endo/promise-kit": "^1.1.7",
     "@endo/stream": "^1.2.7",
     "import-meta-resolve": "^2.2.1"
   },
   "devDependencies": {
-    "@agoric/deploy-script-support": "0.10.4-dev-5fd303a.0+5fd303a",
-    "@agoric/governance": "0.10.4-dev-5fd303a.0+5fd303a",
-    "@agoric/inter-protocol": "0.16.2-dev-5fd303a.0+5fd303a",
-    "@agoric/orchestration": "0.1.1-dev-5fd303a.0+5fd303a",
-    "@agoric/store": "0.9.3-dev-5fd303a.0+5fd303a",
-    "@agoric/swing-store": "0.9.2-dev-5fd303a.0+5fd303a",
-    "@agoric/swingset-liveslots": "0.10.3-dev-5fd303a.0+5fd303a",
-    "@agoric/time": "0.3.3-dev-5fd303a.0+5fd303a",
+    "@agoric/deploy-script-support": "0.10.4-dev-7390224.0+7390224",
+    "@agoric/governance": "0.10.4-dev-7390224.0+7390224",
+    "@agoric/inter-protocol": "0.16.2-dev-7390224.0+7390224",
+    "@agoric/orchestration": "0.1.1-dev-7390224.0+7390224",
+    "@agoric/store": "0.9.3-dev-7390224.0+7390224",
+    "@agoric/swing-store": "0.9.2-dev-7390224.0+7390224",
+    "@agoric/swingset-liveslots": "0.10.3-dev-7390224.0+7390224",
+    "@agoric/time": "0.3.3-dev-7390224.0+7390224",
     "@endo/errors": "^1.2.7",
     "ava": "^5.3.0",
     "c8": "^9.1.0"
@@ -81,5 +83,5 @@
   "typeCoverage": {
     "atLeast": 89.69
   },
-  "gitHead": "5fd303aa11d393f2f6ceefe0ad83ba8cf5178a44"
+  "gitHead": "739022455dbfb7e7d7d90e8ae7cef948cde3e97a"
 }

package/scripts/fast-usdc/init-fast-usdc.js

@@ -0,0 +1,126 @@
+// @ts-check
+import { makeHelpers } from '@agoric/deploy-script-support';
+import { AmountMath } from '@agoric/ertp';
+import {
+  FastUSDCConfigShape,
+  getManifestForFastUSDC,
+} from '@agoric/fast-usdc/src/fast-usdc.start.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 {ParseArgsConfig} from 'node:util'
+ * @import {FastUSDCConfig} from '@agoric/fast-usdc/src/fast-usdc.start.js'
+ */
+
+/** @type {ParseArgsConfig['options']} */
+const options = {
+  flatFee: { type: 'string', default: '0.01' },
+  variableRate: { type: 'string', default: '0.01' },
+  maxVariableFee: { type: 'string', default: '5' },
+  contractRate: { type: 'string', default: '0.2' },
+  oracle: { type: 'string', multiple: true },
+  usdcDenom: {
+    type: 'string',
+    default:
+      'ibc/FE98AAD68F02F03565E9FA39A5E627946699B2B07115889ED812D8BA639576A9',
+  },
+};
+const oraclesRequiredUsage = 'use --oracle name:address ...';
+/**
+ * @typedef {{
+ *   flatFee: string;
+ *   variableRate: string;
+ *   maxVariableFee: string;
+ *   contractRate: string;
+ *   oracle?: string[];
+ *   usdcDenom: string;
+ * }} 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));
+
+/** @type {CoreEvalBuilder} */
+export const defaultProposalBuilder = async (
+  { publishRef, install },
+  /** @type {FastUSDCConfig} */ config,
+) => {
+  return harden({
+    sourceSpec: '@agoric/fast-usdc/src/fast-usdc.start.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, usdcDenom, ...fees },
+  } = parseArgs({ args: scriptArgs, options });
+
+  const parseOracleArgs = () => {
+    if (!oracleArgs) throw Error(oraclesRequiredUsage);
+    return Object.fromEntries(
+      oracleArgs.map(arg => {
+        const result = arg.match(/(?<name>[^:]+):(?<address>.+)/);
+        if (!(result && result.groups)) throw Error(oraclesRequiredUsage);
+        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, maxVariableFee, contractRate } = fees;
+    return {
+      flat: toAmount(flatFee),
+      variableRate: toRatio(variableRate),
+      maxVariable: toAmount(maxVariableFee),
+      contractRate: toRatio(contractRate),
+    };
+  };
+
+  /** @type {FastUSDCConfig} */
+  const config = harden({
+    oracles: parseOracleArgs(),
+    terms: {
+      usdcDenom,
+    },
+    feeConfig: parseFeeConfigArgs(),
+  });
+
+  await writeCoreEval('start-fast-usdc', utils =>
+    defaultProposalBuilder(utils, config),
+  );
+};