@agoric/builders 0.2.0-u21.0.1 → 0.2.0-u22.1

package/CHANGELOG.md

@@ -3,11 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## 0.2.0-u21.0 (2025-06-19)
+## [0.2.0-u22.1](https://github.com/Agoric/agoric-sdk/compare/@agoric/builders@0.2.0-u22.0...@agoric/builders@0.2.0-u22.1) (2025-09-09)
 
+**Note:** Version bump only for package @agoric/builders
+
+## 0.2.0-u22.0 (2025-09-08)
 
 ### ⚠ BREAKING CHANGES
 
+* rm redundant networkConfigs
 * **chainHub:** register and retrieve non-cosmos chains
 * remove orch.makeLocalAccount
 * make Network and IBC vats durable (#8721)
@@ -49,6 +53,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 * **fast-usdc:** write chain policies to vstorage ([#10532](https://github.com/Agoric/agoric-sdk/issues/10532)) ([9d6cff1](https://github.com/Agoric/agoric-sdk/commit/9d6cff17bb95ce5557758da242ca4646a87ac5b0))
 * fusdc assetInfo and chainInfo by netname ([afb4f34](https://github.com/Agoric/agoric-sdk/commit/afb4f34518124b3809d1df07ea706743fa47f2b1))
 * include issuerKeywordRecord in start-sendAnywhere.js ([0b97916](https://github.com/Agoric/agoric-sdk/commit/0b9791672f91890a9de13511d0a6e7290d30d4d5))
+* **inter-protocol:** Add core-eval builder for depositing reserve withdrawal invitations ([#11678](https://github.com/Agoric/agoric-sdk/issues/11678)) ([754cd9e](https://github.com/Agoric/agoric-sdk/commit/754cd9e5fe69ad4921eb057140c1384f173bb4be)), closes [#11460](https://github.com/Agoric/agoric-sdk/issues/11460) [TypeError#1](https://github.com/Agoric/TypeError/issues/1) [TypeError#1](https://github.com/Agoric/TypeError/issues/1) [TypeError#1](https://github.com/Agoric/TypeError/issues/1) [v39#70001](https://github.com/Agoric/v39/issues/70001) [v39#70001](https://github.com/Agoric/v39/issues/70001) [#1](https://github.com/Agoric/agoric-sdk/issues/1) [v39#70001](https://github.com/Agoric/v39/issues/70001) [#1](https://github.com/Agoric/agoric-sdk/issues/1)
 * make Network and IBC vats durable ([#8721](https://github.com/Agoric/agoric-sdk/issues/8721)) ([3d13c09](https://github.com/Agoric/agoric-sdk/commit/3d13c09363013e23726c2ac5fa299a8e5344fd8c))
 * new 'builders' package ([00c88ab](https://github.com/Agoric/agoric-sdk/commit/00c88ab1615ed55a3928ae52e332be05a173d1f6))
 * **orchestration:** add init-stakeOsmo.js to support .query tests ([b6df6c2](https://github.com/Agoric/agoric-sdk/commit/b6df6c230a902288f11f6217dbd1ca9701a9a8b6))
@@ -77,7 +82,6 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 * **vats:** upgrade the orchestration core ([c2d9530](https://github.com/Agoric/agoric-sdk/commit/c2d9530e2d891bd9412969a43a9c5728cc3c2721))
 * Zoe use watchPromise() to wait for contract finish ([#8453](https://github.com/Agoric/agoric-sdk/issues/8453)) ([6388a00](https://github.com/Agoric/agoric-sdk/commit/6388a002b53593f17a8d936d4e937efb7d065d97))
 
-
 ### Bug Fixes
 
 * **agd:** upgrade all orchestration vats to new liveslots ([59fa82c](https://github.com/Agoric/agoric-sdk/commit/59fa82c4740e1ddace28e1389e3c7c875bcdf93e))
@@ -91,7 +95,10 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 * 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))
+
+### Miscellaneous Chores
+
+* rm redundant networkConfigs ([8eebb66](https://github.com/Agoric/agoric-sdk/commit/8eebb665132f27f2f3de121f575052d5494e80f9))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/builders",
-  "version": "0.2.0-u21.0.1",
+  "version": "0.2.0-u22.1",
   "description": "Build scripts for proposals to an Agoric chain",
   "type": "module",
   "main": "./index.js",
@@ -11,7 +11,7 @@
     "build:restart-vats-proposal": "echo This command has been deprecated. Please run this instead: agoric run scripts/vats/restart-vats.js",
     "build:zcf-proposal": "echo This command has been deprecated. Please run this instead: agoric run scripts/vats/replace-zoe.js",
     "prepack": "yarn run -T tsc --build tsconfig.build.json",
-    "postpack": "git clean -f '*.d.ts*' '*.tsbuildinfo'",
+    "postpack": "git clean -f '*.d.*ts*' '*.tsbuildinfo'",
     "test": "ava",
     "test:xs": "exit 0",
     "lint-fix": "yarn lint:eslint --fix",
@@ -23,34 +23,36 @@
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/ertp": "0.16.3-u21.0.1",
-    "@agoric/internal": "0.4.0-u21.0.1",
-    "@agoric/notifier": "0.7.0-u21.0.1",
-    "@agoric/smart-wallet": "0.5.4-u21.0.1",
-    "@agoric/vat-data": "0.5.3-u21.0.1",
-    "@agoric/vats": "0.16.0-u21.0.1",
-    "@agoric/zoe": "0.27.0-u21.0.1",
-    "@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",
+    "@agoric/client-utils": "0.2.0-u22.1",
+    "@agoric/ertp": "0.17.0-u22.1",
+    "@agoric/internal": "0.4.0-u22.1",
+    "@agoric/notifier": "0.7.0-u22.1",
+    "@agoric/smart-wallet": "0.6.0-u22.1",
+    "@agoric/vat-data": "0.6.0-u22.1",
+    "@agoric/vats": "0.16.0-u22.1",
+    "@agoric/zoe": "0.27.0-u22.1",
+    "@endo/bundle-source": "^4.1.2",
+    "@endo/captp": "^4.4.8",
+    "@endo/eventual-send": "^1.3.4",
+    "@endo/far": "^1.1.14",
+    "@endo/init": "^1.1.12",
+    "@endo/marshal": "^1.8.0",
+    "@endo/nat": "^5.1.3",
+    "@endo/patterns": "^1.7.0",
+    "@endo/promise-kit": "^1.1.13",
+    "@endo/stream": "^1.2.13",
     "import-meta-resolve": "^4.1.0"
   },
   "devDependencies": {
-    "@agoric/deploy-script-support": "0.10.4-u21.0.1",
-    "@agoric/governance": "0.10.4-u21.0.1",
-    "@agoric/inter-protocol": "0.17.0-u21.0.1",
-    "@agoric/orchestration": "0.2.0-u21.0.1",
-    "@agoric/store": "0.9.3-u21.0.1",
-    "@agoric/swing-store": "0.10.0-u21.0.1",
-    "@agoric/swingset-liveslots": "0.10.3-u21.0.1",
-    "@agoric/time": "0.3.3-u21.0.1",
-    "@endo/errors": "^1.2.10",
+    "@agoric/deploy-script-support": "0.11.0-u22.1",
+    "@agoric/governance": "0.11.0-u22.1",
+    "@agoric/inter-protocol": "0.17.0-u22.1",
+    "@agoric/orchestration": "0.2.0-u22.1",
+    "@agoric/store": "0.10.0-u22.1",
+    "@agoric/swing-store": "0.10.0-u22.1",
+    "@agoric/swingset-liveslots": "0.11.0-u22.1",
+    "@agoric/time": "0.4.0-u22.1",
+    "@endo/errors": "^1.2.13",
     "ava": "^5.3.0",
     "c8": "^10.1.3"
   },
@@ -80,7 +82,7 @@
     "workerThreads": false
   },
   "typeCoverage": {
-    "atLeast": 90.62
+    "atLeast": 89.94
   },
-  "gitHead": "16519b2de1eb2afda2b4ec866f55eadd4bb18223"
+  "gitHead": "83a42d0f343b01448a918631dce159b5bdb69b7e"
 }

package/scripts/inter-protocol/withdraw-reserve.build.js

@@ -0,0 +1,68 @@
+/* eslint-env node */
+import { parseArgs } from 'node:util';
+import { isNat } from '@endo/nat';
+import { makeHelpers } from '@agoric/deploy-script-support';
+import { getManifestForInviteWithdrawer } from '@agoric/inter-protocol/src/proposals/withdraw-reserve-proposal.js';
+
+/**
+ * @template {{ type: string }} T
+ * @typedef { T['type'] extends 'string' ? string : T['type'] extends 'boolean' ? boolean : (string | boolean) } TypeFromParseArgsOptionDescriptor
+ */
+
+/**
+ * @template {Record<string, { type: string, multiple?: boolean }>} T
+ * @typedef {{
+ *   [K in keyof T]: (
+ *     T[K]['multiple'] extends true
+ *       ? TypeFromParseArgsOptionDescriptor<T[K]>[]
+ *     : T[K]['multiple'] extends (false | unknown)
+ *       ? TypeFromParseArgsOptionDescriptor<T[K]>
+ *     : (TypeFromParseArgsOptionDescriptor<T[K]>[] | TypeFromParseArgsOptionDescriptor<T[K]>)
+ *   )
+ * }} CliOptions
+ */
+
+const { Fail } = assert;
+
+const cliOptions = /** @type {const} */ ({
+  address: { type: 'string', multiple: false },
+  count: { type: 'string', multiple: false },
+});
+
+/** @type {import('@agoric/deploy-script-support/src/externalTypes.js').CoreEvalBuilder} */
+export const defaultProposalBuilder = async (
+  { publishRef: _publishRef, install: _install },
+  namedArgs = {},
+) => {
+  const { address, count } = namedArgs;
+
+  typeof address === 'string' || Fail`string address is required`;
+  if (count !== undefined) {
+    isNat(count) || Fail`count must be a safe natural number`;
+  }
+
+  return harden({
+    sourceSpec:
+      '@agoric/inter-protocol/src/proposals/withdraw-reserve-proposal.js',
+    getManifestCall: [getManifestForInviteWithdrawer.name, { address, count }],
+  });
+};
+
+/** @type {import('@agoric/deploy-script-support/src/externalTypes.js').DeployScriptFunction} */
+export default async (homeP, endowments) => {
+  const { scriptArgs: argv } = endowments;
+  /** @type {{ values: Partial<CliOptions<typeof cliOptions>> }} */
+  const { values: rawArgs } = parseArgs({ args: argv, options: cliOptions });
+  const { address, count: rawCount } = rawArgs;
+  const count = (() => {
+    if (rawCount === undefined) return undefined;
+    /[0-9]/.test(rawCount) || Fail`--count value must be numeric`;
+    return +rawCount;
+  })();
+  const namedArgs = { address, count };
+
+  const { writeCoreEval } = await makeHelpers(homeP, endowments);
+  await writeCoreEval('withdraw-reserve', utils =>
+    defaultProposalBuilder(utils, namedArgs),
+  );
+};

package/scripts/orchestration/axelar-gmp.build.js

@@ -55,8 +55,15 @@ export default async (homeP, endowments) => {
   if (!flags.net) throw Error('--net required');
   if (!flags.peer) throw Error('--peer required');
 
+  const validNets = ['bootstrap', 'devnet', 'emerynet', 'local'];
+  if (!validNets.includes(flags.net)) {
+    throw Error(`--net must be one of: ${validNets.join(', ')}`);
+  }
+
   const chainDetails = await getChainConfig({
-    net: flags.net,
+    net: /** @type {'bootstrap' | 'devnet' | 'emerynet' | 'local'} */ (
+      flags.net
+    ),
     peers: flags.peer,
     execFileSync,
   });

package/scripts/orchestration/get-chain-config.js

@@ -1,9 +1,9 @@
 import { IBCConnectionInfoShape } from '@agoric/orchestration/src/typeGuards.js';
 import { mustMatch } from '@endo/patterns';
 import { makeAgd } from '@agoric/orchestration/src/utils/agd-lib.js';
-import { networkConfigs } from '@agoric/orchestration/src/utils/gmp.js';
 import * as childProcess from 'node:child_process';
 import fetchedChainInfo from '@agoric/orchestration/src/fetched-chain-info.js';
+import { fetchNetworkConfig } from '@agoric/client-utils';
 
 /**
  * @import {IBCChannelID, IBCConnectionID} from '@agoric/vats';
@@ -24,11 +24,12 @@ const parsePeers = strs => {
   return peerParts;
 };
 
+// TODO: Can these be sourced from chain-registry?
 /**
  * Get the IBC chain configuration based on the provided network and peer inputs.
  *
  * @param {object} args - The arguments object.
- * @param {string} args.net - The network name (e.g., 'emerynet').
+ * @param {'bootstrap' | 'devnet' |'emerynet' | 'local' } args.net - Agoric network shorthand (e.g., 'emerynet').
  * @param {string[]} args.peers - The peers to connect .
  * @param {childProcess.execFileSync} [args.execFileSync] - Optional execFileSync function.
  * @returns {Promise<Record<string, CosmosChainInfo>>} A promise that resolves to the chain configuration details keyed by chain name.
@@ -55,8 +56,11 @@ export const getChainConfig = async ({
   const connections = {};
   const portId = 'transfer';
 
-  const { chainId, rpc } = networkConfigs[net];
-  const agd = makeAgd({ execFileSync }).withOpts({ rpcAddrs: [rpc] });
+  const { chainName: chainId, rpcAddrs } = await fetchNetworkConfig(net, {
+    fetch,
+  });
+  // XXX execFileSync bad POLA; these queries can be made with `fetch`
+  const agd = makeAgd({ execFileSync }).withOpts({ rpcAddrs });
 
   for (const [peerName, myConn, myChan, denom] of parsePeers(peers)) {
     console.debug(peerName, { denom });

package/scripts/orchestration/hook-localchain-msg-send.js

@@ -0,0 +1,30 @@
+import { makeHelpers } from '@agoric/deploy-script-support';
+
+/** @type {import('@agoric/deploy-script-support/src/externalTypes.js').CoreEvalBuilder} */
+export const defaultProposalBuilder = async ({ publishRef, install }) => {
+  const vatNameToEntrypoint = {
+    localchain: '@agoric/vats/src/vat-localchain.js',
+    transfer: '@agoric/vats/src/vat-transfer.js',
+  };
+
+  return harden({
+    sourceSpec: '@agoric/vats/src/proposals/localchain-hook-msg-send.js',
+    getManifestCall: [
+      'getManifestForMsgSendToTransfer',
+      {
+        bundleRefs: Object.fromEntries(
+          Object.entries(vatNameToEntrypoint).map(
+            ([name, entrypoint]) =>
+              /** @type {const} */ ([name, publishRef(install(entrypoint))]),
+          ),
+        ),
+      },
+    ],
+  });
+};
+
+/** @type {import('@agoric/deploy-script-support/src/externalTypes.js').DeployScriptFunction} */
+export default async (homeP, endowments) => {
+  const { writeCoreProposal } = await makeHelpers(homeP, endowments);
+  await writeCoreProposal('hook-localchain', defaultProposalBuilder);
+};