@agoric/vats 0.15.1 → 0.15.2-calypso-dev-84eb287.0

package/README.md

@@ -0,0 +1,3 @@
+# Vats
+
+Builders for Vats on the Agoric chain that aren't contracts.

package/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./src/types.js";
+export * from "./src/nameHub.js";
+export * from "./src/bridge.js";
+export { makePromiseSpace } from "./src/core/promise-space.js";
+export { makeAgoricNamesAccess } from "./src/core/utils.js";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":""}

package/index.js

@@ -0,0 +1,9 @@
+// Ambient types
+import './src/core/types-ambient.js';
+
+// eslint-disable-next-line import/export -- no named exports
+export * from './src/types.js';
+export * from './src/nameHub.js';
+export * from './src/bridge.js';
+export { makePromiseSpace } from './src/core/promise-space.js';
+export { makeAgoricNamesAccess } from './src/core/utils.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/vats",
-  "version": "0.15.1",
+  "version": "0.15.2-calypso-dev-84eb287.0+84eb287",
   "description": "Agoric's Vat library",
   "type": "module",
   "main": "./index.js",
@@ -8,80 +8,75 @@
   "scripts": {
     "build": "yarn build:bundles",
     "build:bundles": "node scripts/build-bundles.js",
-    "build:docs": "yarn build:boot-viz && yarn build:boot-viz-gov && yarn build:boot-viz-sim && yarn build:boot-viz-sim-gov",
-    "build:boot-viz": "node src/authorityViz.js >docs/boot.dot && dot -Tsvg docs/boot.dot >docs/boot.dot.svg",
-    "build:boot-viz-gov": "node src/authorityViz.js --gov>docs/boot-gov.dot && dot -Tsvg docs/boot-gov.dot >docs/boot-gov.dot.svg",
-    "build:boot-viz-sim": "node src/authorityViz.js --sim-chain >docs/boot-sim.dot && dot -Tsvg docs/boot-sim.dot >docs/boot-sim.dot.svg",
-    "build:boot-viz-sim-gov": "node src/authorityViz.js --sim-chain --gov >docs/boot-sim-gov.dot && dot -Tsvg docs/boot-sim-gov.dot >docs/boot-sim-gov.dot.svg",
-    "build:restart-vats-proposal": "agoric run scripts/restart-vats.js",
-    "prepack": "tsc --build jsconfig.build.json",
+    "prepack": "tsc --build tsconfig.build.json",
     "postpack": "git clean -f '*.d.ts*'",
     "test": "ava",
     "test:c8": "c8 $C8_OPTIONS ava",
-    "test:xs": "SWINGSET_WORKER_TYPE=xs-worker ava 'test/bootstrapTests/**/test-*.js' 'test/upgrading/**/test-*.js'",
+    "test:xs": "exit 0",
     "lint-fix": "yarn lint:eslint --fix",
     "lint": "run-s --continue-on-error lint:*",
-    "lint:types": "tsc -p jsconfig.json",
+    "lint:types": "tsc",
     "lint:eslint": "eslint ."
   },
   "keywords": [],
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/assert": "^0.6.0",
-    "@agoric/ertp": "^0.16.2",
-    "@agoric/governance": "^0.10.3",
-    "@agoric/inter-protocol": "^0.16.1",
-    "@agoric/internal": "^0.3.2",
-    "@agoric/notifier": "^0.6.2",
-    "@agoric/sharing-service": "^0.2.11",
-    "@agoric/store": "^0.9.2",
-    "@agoric/swingset-vat": "^0.32.2",
-    "@agoric/time": "^0.3.2",
-    "@agoric/vat-data": "^0.5.2",
-    "@agoric/zoe": "^0.26.2",
-    "@agoric/zone": "^0.2.2",
-    "@endo/far": "^0.2.18",
-    "@endo/import-bundle": "^0.3.4",
-    "@endo/init": "^0.5.56",
-    "@endo/marshal": "^0.8.5",
-    "@endo/nat": "^4.1.27",
-    "@endo/promise-kit": "^0.2.56",
-    "jessie.js": "^0.3.2"
+    "@agoric/assert": "0.6.1-calypso-dev-84eb287.0+84eb287",
+    "@agoric/cosmic-proto": "0.4.1-calypso-dev-84eb287.0+84eb287",
+    "@agoric/ertp": "0.16.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/governance": "0.10.4-calypso-dev-84eb287.0+84eb287",
+    "@agoric/internal": "0.3.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/network": "0.1.1-calypso-dev-84eb287.0+84eb287",
+    "@agoric/notifier": "0.6.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/store": "0.9.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/swingset-vat": "0.32.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/time": "0.3.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/vat-data": "0.5.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/vow": "0.1.1-calypso-dev-84eb287.0+84eb287",
+    "@agoric/zoe": "0.26.3-calypso-dev-84eb287.0+84eb287",
+    "@agoric/zone": "0.2.3-calypso-dev-84eb287.0+84eb287",
+    "@endo/far": "^1.1.2",
+    "@endo/import-bundle": "^1.1.2",
+    "@endo/marshal": "^1.5.0",
+    "@endo/nat": "^5.0.7",
+    "@endo/patterns": "^1.4.0",
+    "@endo/promise-kit": "^1.1.2",
+    "import-meta-resolve": "^2.2.1",
+    "jessie.js": "^0.3.4"
   },
   "devDependencies": {
-    "@agoric/cosmic-swingset": "^0.41.3",
-    "@agoric/deploy-script-support": "^0.10.3",
-    "@agoric/smart-wallet": "^0.5.3",
-    "@agoric/swing-store": "^0.9.1",
-    "@agoric/swingset-liveslots": "^0.10.2",
-    "@endo/bundle-source": "^2.5.1",
-    "@endo/captp": "^3.1.1",
-    "@endo/stream": "^0.3.25",
-    "ava": "^5.2.0",
-    "c8": "^7.13.0",
-    "import-meta-resolve": "^2.2.1"
+    "@agoric/swingset-liveslots": "0.10.3-calypso-dev-84eb287.0+84eb287",
+    "@endo/bundle-source": "^3.2.3",
+    "@endo/init": "^1.1.2",
+    "ava": "^5.3.0",
+    "c8": "^9.1.0"
   },
   "files": [
     "CHANGELOG.md",
     "src/",
-    "*.json",
-    "globals.d.ts",
-    "exported.js"
+    "scripts/",
+    "tools/",
+    "index.*"
   ],
   "publishConfig": {
     "access": "public"
   },
   "engines": {
-    "node": ">=14.15.0"
+    "node": "^18.12 || ^20.9"
   },
   "ava": {
     "files": [
-      "test/**/test-*.js"
+      "test/**/*.test.*"
+    ],
+    "require": [
+      "@endo/init/debug.js"
     ],
-    "concurrency": 2,
     "timeout": "20m",
     "workerThreads": false
   },
-  "gitHead": "ba3b776444425bbcb275ce918794d9259f8e15da"
+  "typeCoverage": {
+    "atLeast": 91.21
+  },
+  "gitHead": "84eb287915c8255d68e845a9b6e10c790f0d54cb"
 }

package/scripts/build-bundles.js

@@ -0,0 +1,19 @@
+#! /usr/bin/env node
+import '@endo/init';
+import { createBundles } from '@agoric/internal/src/node/createBundles.js';
+import url from 'url';
+
+const dirname = url.fileURLToPath(new URL('.', import.meta.url));
+
+// TODO end inter-package filesystem references https://github.com/Agoric/agoric-sdk/issues/8178
+
+const sourceToBundle = [
+  ['@agoric/vats/src/centralSupply.js', '../bundles/bundle-centralSupply.js'],
+  ['@agoric/vats/src/mintHolder.js', '../bundles/bundle-mintHolder.js'],
+  [
+    '@agoric/inter-protocol/src/provisionPool.js',
+    '../bundles/bundle-provisionPool.js',
+  ],
+];
+
+await createBundles(sourceToBundle, dirname);

package/src/bridge-target.d.ts

@@ -0,0 +1,193 @@
+/**
+ * @typedef {object} TargetApp an object representing the app that receives
+ *   upcalls from the low-level TargetHost on the other side of a bridge
+ * @property {(obj: MostlyPureData) => Promise<MostlyPureData>} receiveUpcall
+ *   receive data from the TargetHost, and return a data result
+ */
+export const TargetAppI: import("@endo/patterns").InterfaceGuard<{
+    receiveUpcall: import("@endo/patterns").MethodGuard;
+}>;
+/**
+ * @typedef {object} TargetHost an object representing the host that receives
+ *   downcalls from the high-level TargetApp over a bridge
+ * @property {(obj: MostlyPureData) => Promise<MostlyPureData>} sendDowncall
+ *   send data to the TargetHost, which returns a data result
+ */
+export const TargetHostI: import("@endo/patterns").InterfaceGuard<{
+    sendDowncall: import("@endo/patterns").MethodGuard;
+}>;
+/**
+ * @typedef {object} AppTransformer an object for replacing a TargetApp,
+ *   generally with a wrapper that intercepts its inputs and/or results to
+ *   ensure conformance with a protocol and/or interface (e.g., an active tap
+ *   can encode results of the wrapped TargetApp into an acknowledgement
+ *   message)
+ * @property {(
+ *   app: ERef<TargetApp>,
+ *   targetHost: ERef<TargetHost>,
+ *   ...args: unknown[]
+ * ) => ERef<TargetApp>} wrapApp
+ */
+export const AppTransformerI: import("@endo/patterns").InterfaceGuard<{
+    wrapApp: import("@endo/patterns").MethodGuard;
+}>;
+/**
+ * @typedef {object} TargetRegistration is an ExoClass of its own, and each
+ *   instance is an attenuation of a BridgeTargetKit `targetRegistry` facet that
+ *   has access to internal state thereof but has been scoped down to a single
+ *   target.
+ * @property {() => Promise<void>} revoke performs unregistration (and sends the
+ *   corresponding "BRIDGE_TARGET_UNREGISTER" message to the targetHost).
+ * @property {(targetApp: ERef<TargetApp>) => Promise<void>} updateTargetApp
+ *   replaces the app associated with the target (but with no corresponding
+ *   message).
+ */
+export const TargetRegistrationI: import("@endo/patterns").InterfaceGuard<{
+    updateTargetApp: import("@endo/patterns").MethodGuard;
+    revoke: import("@endo/patterns").MethodGuard;
+}>;
+export function prepareTargetRegistration(zone: import("@agoric/base-zone").Zone): (target: string, registry: TargetRegistry, args: unknown[] | null) => import("@endo/exo").Guarded<{
+    /**
+     * Atomically point the registration at a different app.
+     *
+     * @param {TargetApp} app new app to handle messages for the target
+     */
+    updateTargetApp(app: TargetApp): Promise<void>;
+    /** Atomically delete the registration. */
+    revoke(): Promise<void>;
+}>;
+export function prepareBridgeTargetKit(zone: import("@agoric/base-zone").Zone, makeTargetRegistration: ReturnType<typeof prepareTargetRegistration>): (manager: import("./types").ScopedBridgeManager<import("@agoric/internal").BridgeIdValue>, inboundEventType: string, appTransformer?: AppTransformer | undefined) => import("@endo/exo").GuardedKit<{
+    bridgeHandler: {
+        fromBridge(obj: any): Promise<any>;
+    };
+    targetHost: {
+        sendDowncall(obj: any): Promise<any>;
+    };
+    targetRegistry: {
+        /**
+         * Register an app to handle messages for a target.
+         *
+         * @param {string} target
+         * @param {TargetApp} app
+         * @param {unknown[]} [args]
+         * @returns {Promise<TargetRegistration>} power to set or delete the
+         *   registration
+         */
+        register(target: string, app: TargetApp, args?: unknown[] | undefined): Promise<TargetRegistration>;
+        /**
+         * Update the app that handles messages for a target.
+         *
+         * @param {string} target
+         * @param {TargetApp} app
+         * @param {unknown[]} [args]
+         * @returns {Promise<void>}
+         */
+        reregister(target: string, app: TargetApp, args?: unknown[] | undefined): Promise<void>;
+        /**
+         * Unregister the target, bypassing the attenuated `TargetRegistration`
+         * API.
+         *
+         * @param {string} target
+         * @returns {Promise<void>}
+         */
+        unregister(target: string): Promise<void>;
+    };
+}>;
+export function prepareBridgeTargetModule(zone: import("@agoric/base-zone").Zone): {
+    makeBridgeTargetKit: (manager: import("./types").ScopedBridgeManager<import("@agoric/internal").BridgeIdValue>, inboundEventType: string, appTransformer?: AppTransformer | undefined) => import("@endo/exo").GuardedKit<{
+        bridgeHandler: {
+            fromBridge(obj: any): Promise<any>;
+        };
+        targetHost: {
+            sendDowncall(obj: any): Promise<any>;
+        };
+        targetRegistry: {
+            /**
+             * Register an app to handle messages for a target.
+             *
+             * @param {string} target
+             * @param {TargetApp} app
+             * @param {unknown[]} [args]
+             * @returns {Promise<TargetRegistration>} power to set or delete the
+             *   registration
+             */
+            register(target: string, app: TargetApp, args?: unknown[] | undefined): Promise<TargetRegistration>;
+            /**
+             * Update the app that handles messages for a target.
+             *
+             * @param {string} target
+             * @param {TargetApp} app
+             * @param {unknown[]} [args]
+             * @returns {Promise<void>}
+             */
+            reregister(target: string, app: TargetApp, args?: unknown[] | undefined): Promise<void>;
+            /**
+             * Unregister the target, bypassing the attenuated `TargetRegistration`
+             * API.
+             *
+             * @param {string} target
+             * @returns {Promise<void>}
+             */
+            unregister(target: string): Promise<void>;
+        };
+    }>;
+};
+/**
+ * ideally should be PureData, but that type is
+ *   too restrictive to work out-of-the-box.
+ */
+export type MostlyPureData = any;
+/**
+ * an object representing the app that receives
+ *   upcalls from the low-level TargetHost on the other side of a bridge
+ */
+export type TargetApp = {
+    /**
+     *   receive data from the TargetHost, and return a data result
+     */
+    receiveUpcall: (obj: MostlyPureData) => Promise<MostlyPureData>;
+};
+/**
+ * an object representing the host that receives
+ *   downcalls from the high-level TargetApp over a bridge
+ */
+export type TargetHost = {
+    /**
+     *   send data to the TargetHost, which returns a data result
+     */
+    sendDowncall: (obj: MostlyPureData) => Promise<MostlyPureData>;
+};
+/**
+ * an object for replacing a TargetApp,
+ *   generally with a wrapper that intercepts its inputs and/or results to
+ *   ensure conformance with a protocol and/or interface (e.g., an active tap
+ *   can encode results of the wrapped TargetApp into an acknowledgement
+ *   message)
+ */
+export type AppTransformer = {
+    wrapApp: (app: ERef<TargetApp>, targetHost: ERef<TargetHost>, ...args: unknown[]) => ERef<TargetApp>;
+};
+/**
+ * is an ExoClass of its own, and each
+ *   instance is an attenuation of a BridgeTargetKit `targetRegistry` facet that
+ *   has access to internal state thereof but has been scoped down to a single
+ *   target.
+ */
+export type TargetRegistration = {
+    /**
+     * performs unregistration (and sends the
+     * corresponding "BRIDGE_TARGET_UNREGISTER" message to the targetHost).
+     */
+    revoke: () => Promise<void>;
+    /**
+     *   replaces the app associated with the target (but with no corresponding
+     *   message).
+     */
+    updateTargetApp: (targetApp: ERef<TargetApp>) => Promise<void>;
+};
+export type TargetRegistry = {
+    register: (target: string, targetApp: ERef<TargetApp>, args?: unknown[]) => Promise<TargetRegistration>;
+    reregister: (target: string, targetApp: ERef<TargetApp>, args?: unknown[]) => Promise<void>;
+    unregister: (target: string) => Promise<void>;
+};
+//# sourceMappingURL=bridge-target.d.ts.map

package/src/bridge-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-target.d.ts","sourceRoot":"","sources":["bridge-target.js"],"names":[],"mappings":"AAYA;;;;;GAKG;AAEH;;GAEG;AAEH;;;;;GAKG;AAEH;;GAEG;AAEH;;;;;;;;;;;GAWG;AAEH;;GAOG;AAEH;;;;;;;;;;GAUG;AAEH;;;GAGG;AA4BI,gDADK,OAAO,mBAAmB,EAAE,IAAI;IAiBtC;;;;OAIG;yBADQ,SAAS;IAapB,0CAA0C;;GAW7C;AAyBI,6CAHI,OAAO,mBAAmB,EAAE,IAAI,0BAChC,UAAU,CAAC,OAAO,yBAAyB,CAAC;;;;;;;;QA6C/C;;;;;;;;WAQG;yBALQ,MAAM,OACN,SAAS,iCAEP,OAAO,CAAC,kBAAkB,CAAC;QAoCxC;;;;;;;WAOG;2BAJQ,MAAM,OACN,SAAS,iCAEP,OAAO,CAAC,IAAI,CAAC;QAyB1B;;;;;;WAMG;2BAFQ,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC;;GAc/B;AAII,gDADK,OAAO,mBAAmB,EAAE,IAAI;;;;;;;;;YA/FpC;;;;;;;;eAQG;6BALQ,MAAM,OACN,SAAS,iCAEP,OAAO,CAAC,kBAAkB,CAAC;YAoCxC;;;;;;;eAOG;+BAJQ,MAAM,OACN,SAAS,iCAEP,OAAO,CAAC,IAAI,CAAC;YAyB1B;;;;;;eAMG;+BAFQ,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC;;;EA0BjC;;;;;6BApTY,GAAG;;;;;;;;;mBASF,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC;;;;;;;;;;kBAWhD,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC;;;;;;;;;;aAchD,CACb,GAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EACxB,UAAc,EAAE,IAAI,CAAC,UAAU,CAAC,EAChC,GAAO,IAAI,EAAE,OAAO,EAAE,KACf,IAAI,CAAC,SAAS,CAAC;;;;;;;;;;;;;YAiBT,MAAM,OAAO,CAAC,IAAI,CAAC;;;;;qBAEnB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;;;cAY7C,CACb,MAAU,EAAE,MAAM,EAClB,SAAa,EAAE,IAAI,CAAC,SAAS,CAAC,EAC9B,IAAQ,CAAC,EAAE,OAAO,EAAE,KACb,OAAO,CAAC,kBAAkB,CAAC;gBACrB,CACb,MAAU,EAAE,MAAM,EAClB,SAAa,EAAE,IAAI,CAAC,SAAS,CAAC,EAC9B,IAAQ,CAAC,EAAE,OAAO,EAAE,KACb,OAAO,CAAC,IAAI,CAAC;gBACP,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC"}