@agoric/builders 0.1.1-dev-d575daa.0 → 0.1.1-dev-e06691f.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/builders",
-  "version": "0.1.1-dev-d575daa.0+d575daa",
+  "version": "0.1.1-dev-e06691f.0+e06691f",
   "description": "Build scripts for proposals to an Agoric chain",
   "type": "module",
   "main": "./index.js",
@@ -23,14 +23,14 @@
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/ertp": "0.16.3-dev-d575daa.0+d575daa",
-    "@agoric/fast-usdc": "0.1.1-dev-d575daa.0+d575daa",
-    "@agoric/internal": "0.3.3-dev-d575daa.0+d575daa",
-    "@agoric/notifier": "0.6.3-dev-d575daa.0+d575daa",
-    "@agoric/smart-wallet": "0.5.4-dev-d575daa.0+d575daa",
-    "@agoric/vat-data": "0.5.3-dev-d575daa.0+d575daa",
-    "@agoric/vats": "0.15.2-dev-d575daa.0+d575daa",
-    "@agoric/zoe": "0.26.3-dev-d575daa.0+d575daa",
+    "@agoric/ertp": "0.16.3-dev-e06691f.0+e06691f",
+    "@agoric/fast-usdc": "0.1.1-dev-e06691f.0+e06691f",
+    "@agoric/internal": "0.3.3-dev-e06691f.0+e06691f",
+    "@agoric/notifier": "0.6.3-dev-e06691f.0+e06691f",
+    "@agoric/smart-wallet": "0.5.4-dev-e06691f.0+e06691f",
+    "@agoric/vat-data": "0.5.3-dev-e06691f.0+e06691f",
+    "@agoric/vats": "0.15.2-dev-e06691f.0+e06691f",
+    "@agoric/zoe": "0.26.3-dev-e06691f.0+e06691f",
     "@endo/bundle-source": "^3.5.0",
     "@endo/captp": "^4.4.3",
     "@endo/eventual-send": "^1.2.8",
@@ -43,14 +43,14 @@
     "import-meta-resolve": "^2.2.1"
   },
   "devDependencies": {
-    "@agoric/deploy-script-support": "0.10.4-dev-d575daa.0+d575daa",
-    "@agoric/governance": "0.10.4-dev-d575daa.0+d575daa",
-    "@agoric/inter-protocol": "0.16.2-dev-d575daa.0+d575daa",
-    "@agoric/orchestration": "0.1.1-dev-d575daa.0+d575daa",
-    "@agoric/store": "0.9.3-dev-d575daa.0+d575daa",
-    "@agoric/swing-store": "0.9.2-dev-d575daa.0+d575daa",
-    "@agoric/swingset-liveslots": "0.10.3-dev-d575daa.0+d575daa",
-    "@agoric/time": "0.3.3-dev-d575daa.0+d575daa",
+    "@agoric/deploy-script-support": "0.10.4-dev-e06691f.0+e06691f",
+    "@agoric/governance": "0.10.4-dev-e06691f.0+e06691f",
+    "@agoric/inter-protocol": "0.16.2-dev-e06691f.0+e06691f",
+    "@agoric/orchestration": "0.1.1-dev-e06691f.0+e06691f",
+    "@agoric/store": "0.9.3-dev-e06691f.0+e06691f",
+    "@agoric/swing-store": "0.9.2-dev-e06691f.0+e06691f",
+    "@agoric/swingset-liveslots": "0.10.3-dev-e06691f.0+e06691f",
+    "@agoric/time": "0.3.3-dev-e06691f.0+e06691f",
     "@endo/errors": "^1.2.8",
     "ava": "^5.3.0",
     "c8": "^10.1.2"
@@ -83,5 +83,5 @@
   "typeCoverage": {
     "atLeast": 90.93
   },
-  "gitHead": "d575daa7ec180a71e370c3c769eb5af7c611975d"
+  "gitHead": "e06691f3bb13d315a4b557b4711c33cabc94979c"
 }

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

@@ -0,0 +1,134 @@
+/**
+ * @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),
+  );
+};

package/scripts/vats/{upgrade-orch-core.js → upgrade-orchestration.js}

@@ -3,15 +3,18 @@ import { makeHelpers } from '@agoric/deploy-script-support';
 /** @type {import('@agoric/deploy-script-support/src/externalTypes.js').CoreEvalBuilder} */
 export const defaultProposalBuilder = async ({ publishRef, install }) =>
   harden({
-    sourceSpec: '@agoric/vats/src/proposals/upgrade-orch-core-proposal.js',
+    sourceSpec: '@agoric/vats/src/proposals/upgrade-vats-generic-proposal.js',
     getManifestCall: [
-      'getManifestForUpgradingOrchCore',
+      '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'),
+          ),
         },
       },
     ],