@agoric/deploy-script-support 0.10.4-dev-df2faae.0 → 0.10.4-dev-bcab39d.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/deploy-script-support",
-  "version": "0.10.4-dev-df2faae.0+df2faae",
+  "version": "0.10.4-dev-bcab39d.0+bcab39d",
   "description": "Helpers and other support for writing deploy scripts",
   "type": "module",
   "main": "src/helpers.js",
@@ -34,13 +34,13 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/ertp": "0.16.3-dev-df2faae.0+df2faae",
-    "@agoric/import-manager": "0.3.12-dev-df2faae.0+df2faae",
-    "@agoric/internal": "0.3.3-dev-df2faae.0+df2faae",
-    "@agoric/notifier": "0.6.3-dev-df2faae.0+df2faae",
-    "@agoric/store": "0.9.3-dev-df2faae.0+df2faae",
-    "@agoric/time": "0.3.3-dev-df2faae.0+df2faae",
-    "@agoric/zoe": "0.26.3-dev-df2faae.0+df2faae",
+    "@agoric/ertp": "0.16.3-dev-bcab39d.0+bcab39d",
+    "@agoric/import-manager": "0.3.12-dev-bcab39d.0+bcab39d",
+    "@agoric/internal": "0.3.3-dev-bcab39d.0+bcab39d",
+    "@agoric/notifier": "0.6.3-dev-bcab39d.0+bcab39d",
+    "@agoric/store": "0.9.3-dev-bcab39d.0+bcab39d",
+    "@agoric/time": "0.3.3-dev-bcab39d.0+bcab39d",
+    "@agoric/zoe": "0.26.3-dev-bcab39d.0+bcab39d",
     "@endo/base64": "^1.0.8",
     "@endo/bundle-source": "^3.4.2",
     "@endo/errors": "^1.2.7",
@@ -51,7 +51,7 @@
     "@endo/zip": "^1.0.8"
   },
   "devDependencies": {
-    "@agoric/vats": "0.15.2-dev-df2faae.0+df2faae",
+    "@agoric/vats": "0.15.2-dev-bcab39d.0+bcab39d",
     "@endo/init": "^1.1.6",
     "ava": "^5.3.0",
     "import-meta-resolve": "^2.2.1"
@@ -74,5 +74,5 @@
   "typeCoverage": {
     "atLeast": 82.6
   },
-  "gitHead": "df2faae7e5aa4bba657962f3b33aaeb7a3953c91"
+  "gitHead": "bcab39d18519bc8edf27ba0c3b59da34812cc134"
 }

package/src/cachedBundleSpec.js

@@ -6,6 +6,9 @@ import { Fail } from '@endo/errors';
  */
 export const makeCacheAndGetBundleSpec =
   (cacheDir, { now, fs, pathResolve }) =>
+  /**
+   * @param {Promise<import('@endo/bundle-source').BundleSourceResult<'endoZipBase64'>>} bundleP
+   */
   async bundleP => {
     const bundle = await bundleP;
     const { endoZipBase64Sha512: hash } = bundle;

package/src/externalTypes.js

@@ -1,6 +1,10 @@
 // @ts-check
 export {};
 
+/**
+ * @import {NameHub} from '@agoric/vats';
+ */
+
 // TODO move this type somewhere better
 /**
  * @typedef {string | string[]} Petname A petname can either be a plain string
@@ -47,3 +51,42 @@ export {};
  * @param {...any} args
  * @returns {Promise<CoreEvalDescriptor>}
  */
+
+/**
+ * @typedef {{
+ *  bundleSource: typeof import('@endo/bundle-source').default,
+ *  cacheDir: string,
+ *  lookup: (...path: string[]) => unknown,
+ *  now: () => number,
+ *  pathResolve: (...path: string[]) => string,
+ *  publishBundle: PublishBundleRef,
+ *  scriptArgs?: string[],
+ * }} DeployScriptEndownments
+ */
+
+/**
+ * @typedef {{
+ *   scratch: ERef<import('@agoric/internal/src/scratch.js').ScratchPad>,
+ * }} CommonHome
+ */
+
+// TODO wallet as import('@agoric/wallet-backend/src/types').WalletAdmin once it's a module
+/**
+ * @typedef {CommonHome & {
+ * agoricNames: ERef<NameHub>,
+ * bank: ERef<import("@agoric/vats/src/vat-bank.js").Bank>,
+ * board: ERef<import("@agoric/vats").Board>,
+ * faucet: unknown,
+ * myAddressNameAdmin: ERef<import("@agoric/vats").NameAdmin>,
+ * namesByAddress: ERef<NameHub>,
+ * wallet: any,
+ * zoe: ERef<ZoeService>,
+ * }} AgSoloHome
+ */
+
+/**
+ * @callback DeployScriptFunction
+ * @param {Promise<CommonHome>} homeP
+ * @param {DeployScriptEndownments} endowments
+ * @returns {Promise<void>}
+ */

package/src/helpers.js

@@ -52,6 +52,10 @@ const makeLazyObject = sourceObject => {
   return /** @type {T} */ (lazyObject);
 };
 
+/**
+ * @param {Promise<import('./externalTypes.js').CommonHome | import('./externalTypes.js').AgSoloHome>} homePromise
+ * @param {import('./externalTypes.js').DeployScriptEndownments} endowments
+ */
 export const makeHelpers = async (homePromise, endowments) => {
   // Endowments provided via `agoric run` or `agoric deploy`.
   const {
@@ -84,6 +88,7 @@ export const makeHelpers = async (homePromise, endowments) => {
       return E(deps.walletAdmin).getIssuerManager();
     },
     get offerAndFind() {
+      assert('wallet' in deps.home, 'expected AgSolo home');
       return makeOfferAndFindInvitationAmount(
         deps.walletAdmin,
         deps.home.zoe,
@@ -91,6 +96,7 @@ export const makeHelpers = async (homePromise, endowments) => {
       );
     },
     get walletAdmin() {
+      assert('wallet' in deps.home, 'expected AgSolo home');
       return E(deps.home.wallet).getAdminFacet();
     },
     get zoeInvitationPurse() {
@@ -110,6 +116,7 @@ export const makeHelpers = async (homePromise, endowments) => {
       return deps.offerAndFind.findInvitationAmount;
     },
     get install() {
+      assert('wallet' in deps.home, 'expected AgSolo home');
       return makeInstall(
         bundleSource,
         deps.home.zoe,
@@ -127,6 +134,7 @@ export const makeHelpers = async (homePromise, endowments) => {
       return makeSaveIssuer(deps.walletAdmin, deps.issuerManager);
     },
     get startInstance() {
+      assert('wallet' in deps.home, 'expected AgSolo home');
       return makeStartInstance(
         deps.issuerManager,
         deps.instanceManager,

package/src/writeCoreEvalParts.js

@@ -11,7 +11,8 @@ import {
 } from './coreProposalBehavior.js';
 
 /**
- * @import {CoreEvalDescriptor} from './externalTypes.js';
+ * @import {BundleSource, BundleSourceResult} from '@endo/bundle-source';
+ * @import {AgSoloHome, CanonicalHome, CommonHome, CoreEvalBuilder, CoreEvalDescriptor, ManifestBundleRef} from './externalTypes.js';
  */
 
 /**
@@ -27,20 +28,20 @@ import {
  *   summary to `${filePrefix}-plan.json), plus whatever bundles bundles the code loads)
  * see CoreEval in {@link '/golang/cosmos/x/swingset/types/swingset.pb.go'}
  * @param {string} filePrefix name on disk
- * @param {import('./externalTypes.js').CoreEvalBuilder} builder
+ * @param {CoreEvalBuilder} builder
  * @returns {Promise<CoreEvalPlan>}
  */
 
 /**
  *
- * @param {*} homeP
+ * @param {Promise<CommonHome | AgSoloHome>} homeP
  * @param {{
- *   bundleSource: (path: string) => Promise<NodeModule>,
+ *   bundleSource: BundleSource,
  *   pathResolve: (path: string) => string,
  * }} endowments
  * @param {{
  *   getBundlerMaker: () => Promise<import('./getBundlerMaker.js').BundleMaker>,
- *   getBundleSpec: (...args: *) => Promise<import('./externalTypes.js').ManifestBundleRef>,
+ *   getBundleSpec: (bundle: Promise<BundleSourceResult<'endoZipBase64'>>, getBundle: () => import('./getBundlerMaker.js').Bundler, opts?: any) => Promise<ManifestBundleRef>,
  *   log?: typeof console.log,
  *   writeFile?: typeof fs.promises.writeFile
  * }} io
@@ -63,6 +64,7 @@ export const makeWriteCoreEval = (
   const getBundler = () => {
     if (!bundlerCache) {
       bundlerCache = E(getBundlerMaker()).makeBundler({
+        // @ts-expect-error lazily resolved for AgSoloHome
         zoe: E.get(homeP).zoe,
       });
     }
@@ -95,17 +97,16 @@ export const makeWriteCoreEval = (
     };
   };
 
-  let mutex =
-    /** @type {Promise<import('./externalTypes.js').ManifestBundleRef | undefined>} */ (
-      Promise.resolve()
-    );
+  let mutex = /** @type {Promise<ManifestBundleRef | undefined>} */ (
+    Promise.resolve()
+  );
   /** @type {WriteCoreEval} */
   const writeCoreEval = async (filePrefix, builder) => {
     /**
      *
      * @param {string} entrypoint
      * @param {string} [bundlePath]
-     * @returns {Promise<NodeModule>}
+     * @returns {Promise<BundleSourceResult<'endoZipBase64'>>}
      */
     const getBundle = async (entrypoint, bundlePath) => {
       if (!bundlePath) {
@@ -125,7 +126,7 @@ export const makeWriteCoreEval = (
      * @param {string} entrypoint
      * @param {string} [bundlePath]
      * @param {unknown} [opts]
-     * @returns {Promise<import('./externalTypes.js').ManifestBundleRef>}
+     * @returns {Promise<ManifestBundleRef>}
      */
     const install = async (entrypoint, bundlePath, opts) => {
       const bundle = getBundle(entrypoint, bundlePath);
@@ -146,7 +147,7 @@ export const makeWriteCoreEval = (
 
     // Await a reference then publish to the board.
     const cmds = [];
-    /** @param {Promise<import('./externalTypes.js').ManifestBundleRef>} refP */
+    /** @param {Promise<ManifestBundleRef>} refP */
     const publishRef = async refP => {
       const { fileName, ...ref } = await refP;
       if (fileName) {