@agoric/vats 0.15.2-dev-ecf2d8e.0 → 0.15.2-other-dev-70beeb7.0

package/src/crc.js

@@ -9,11 +9,15 @@
 // @ts-check
 /* eslint-disable no-bitwise */
 
-/** @typedef {string | number | Uint8Array | ArrayBuffer} Data */
+/**
+ * @typedef {string | number | Uint8Array | ArrayBuffer} Data
+ */
 
 const encoder = new TextEncoder();
 
-/** @param {Data} data */
+/**
+ * @param {Data} data
+ */
 function convert(data) {
   if (typeof data === 'number') {
     const bytes = [];
@@ -73,7 +77,9 @@ export class CRC {
     this.table = table;
 
     if (this.width === 8 && !this.xorIn && !this.xorOut && !this.reflect) {
-      /** @param {Data} data */
+      /**
+       * @param {Data} data
+       */
       this.calculate = function calculate(data) {
         const buffer = convert(data);
         let crc = 0;
@@ -85,7 +91,9 @@ export class CRC {
     }
   }
 
-  /** @param {Data} data */
+  /**
+   * @param {Data} data
+   */
   calculate(data) {
     const buffer = convert(data);
     let crc;
@@ -110,7 +118,9 @@ export class CRC {
     return crc >>> 0;
   }
 
-  /** @param {Data} data */
+  /**
+   * @param {Data} data
+   */
   calculateNoTable(data) {
     const buffer = convert(data);
     let crc = this.xorIn;

package/src/ibc.d.ts

@@ -1,9 +1,9 @@
-/** @typedef {import('./types.js').BridgeHandler} BridgeHandler */
+/**
+ * @typedef {import('./types.js').BridgeHandler} BridgeHandler
+ */
 /**
  * @typedef {string} IBCPortID
- *
  * @typedef {string} IBCChannelID
- *
  * @typedef {string} IBCConnectionID
  */
 /**
@@ -15,8 +15,8 @@
  * @property {IBCPortID} destination_port
  */
 /**
- * Create a handler for the IBC protocol, both from the network and from the
- * bridge.
+ * Create a handler for the IBC protocol, both from the network
+ * and from the bridge.
  *
  * @param {typeof import('@endo/far').E} E
  * @param {(method: string, params: any) => Promise<any>} rawCallIBCDevice

package/src/ibc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ibc.d.ts","sourceRoot":"","sources":["ibc.js"],"names":[],"mappings":"AAoBA,kEAAkE;AAElE;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,0CAJW,cAAc,WAAW,EAAE,CAAC,6BACnB,MAAM,UAAU,GAAG,KAAK,QAAQ,GAAG,CAAC,GAC3C,eAAe,GAAG,aAAa,CAugB3C;4BAhiBa,OAAO,YAAY,EAAE,aAAa;wBAGnC,MAAM;2BAEN,MAAM;8BAEN,MAAM;;;oBAML,YAAY;iBACZ,SAAS;yBACT,YAAY;sBACZ,SAAS"}
+{"version":3,"file":"ibc.d.ts","sourceRoot":"","sources":["ibc.js"],"names":[],"mappings":"AAuBA;;GAEG;AAEH;;;;GAIG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,0CAJW,cAAc,WAAW,EAAE,CAAC,6BACnB,MAAM,UAAU,GAAG,KAAK,QAAQ,GAAG,CAAC,GAC3C,eAAe,GAAG,aAAa,CAwhB3C;4BAhjBY,OAAO,YAAY,EAAE,aAAa;wBAIlC,MAAM;2BACN,MAAM;8BACN,MAAM;;;oBAML,YAAY;iBACZ,SAAS;yBACT,YAAY;sBACZ,SAAS"}

package/src/ibc.js

@@ -1,15 +1,18 @@
 // @ts-check
 
+import {
+  dataToBase64,
+  base64ToBytes,
+} from '@agoric/swingset-vat/src/vats/network/index.js';
 import { makeScalarMapStore, makeLegacyMap } from '@agoric/store';
 import { makePromiseKit } from '@endo/promise-kit';
 import { assert, details as X, Fail } from '@agoric/assert';
 import { Far } from '@endo/far';
 
-import { makeWithQueue } from '@agoric/internal/src/queue.js';
-import { dataToBase64, base64ToBytes } from '@agoric/network';
-
 import '@agoric/store/exported.js';
-import '@agoric/network/exported.js';
+import '@agoric/swingset-vat/src/vats/network/types.js';
+
+import { makeWithQueue } from '@agoric/internal/src/queue.js';
 
 // CAVEAT: IBC acks cannot be empty, as the Cosmos IAVL tree cannot represent
 // empty acknowledgements as distinct from unacknowledged packets.
@@ -18,13 +21,13 @@ const DEFAULT_ACKNOWLEDGEMENT = '\x00';
 // Default timeout after 10 minutes.
 const DEFAULT_PACKET_TIMEOUT_NS = 10n * 60n * 1_000_000_000n;
 
-/** @typedef {import('./types.js').BridgeHandler} BridgeHandler */
+/**
+ * @typedef {import('./types.js').BridgeHandler} BridgeHandler
+ */
 
 /**
  * @typedef {string} IBCPortID
- *
  * @typedef {string} IBCChannelID
- *
  * @typedef {string} IBCConnectionID
  */
 
@@ -38,8 +41,8 @@ const DEFAULT_PACKET_TIMEOUT_NS = 10n * 60n * 1_000_000_000n;
  */
 
 /**
- * Create a handler for the IBC protocol, both from the network and from the
- * bridge.
+ * Create a handler for the IBC protocol, both from the network
+ * and from the bridge.
  *
  * @param {typeof import('@endo/far').E} E
  * @param {(method: string, params: any) => Promise<any>} rawCallIBCDevice
@@ -53,7 +56,9 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
     console.info('IBC downcall', method, params);
     return rawCallIBCDevice(method, params);
   };
-  /** @type {MapStore<string, Promise<Connection>>} */
+  /**
+   * @type {MapStore<string, Promise<Connection>>}
+   */
   const channelKeyToConnP = makeScalarMapStore('CHANNEL:PORT');
 
   /**
@@ -62,7 +67,7 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
    * @property {string} channel_id
    *
    * @typedef {object} ConnectingInfo
-   * @property {'ORDERED' | 'UNORDERED'} order
+   * @property {'ORDERED'|'UNORDERED'} order
    * @property {string[]} connectionHops
    * @property {string} portID
    * @property {string} channelID
@@ -70,25 +75,31 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
    * @property {string} version
    *
    * @typedef {PromiseRecord<AttemptDescription>} OnConnectP
-   *
    * @typedef {Omit<ConnectingInfo, 'counterparty' | 'channelID'> & {
-   *   localAddr: Endpoint;
-   *   onConnectP: OnConnectP;
-   *   counterparty: { port_id: string };
+   *   localAddr: Endpoint, onConnectP: OnConnectP
+   *   counterparty: { port_id: string },
    * }} Outbound
    */
 
-  /** @type {LegacyMap<string, Outbound[]>} */
+  /**
+   * @type {LegacyMap<string, Array<Outbound>>}
+   */
   // Legacy because it holds a mutable Javascript Array
   const srcPortToOutbounds = makeLegacyMap('SRC-PORT');
 
-  /** @type {MapStore<string, ConnectingInfo>} */
+  /**
+   * @type {MapStore<string, ConnectingInfo>}
+   */
   const channelKeyToInfo = makeScalarMapStore('CHANNEL:PORT');
 
-  /** @type {MapStore<string, Promise<InboundAttempt>>} */
+  /**
+   * @type {MapStore<string, Promise<InboundAttempt>>}
+   */
   const channelKeyToAttemptP = makeScalarMapStore('CHANNEL:PORT');
 
-  /** @type {LegacyMap<string, LegacyMap<number, PromiseRecord<Bytes>>>} */
+  /**
+   * @type {LegacyMap<string, LegacyMap<number, PromiseRecord<Bytes>>>}
+   */
   // Legacy because it holds a LegacyMap
   const channelKeyToSeqAck = makeLegacyMap('CHANNEL:PORT');
 
@@ -113,7 +124,9 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
     // Extract the actual sequence number from the return.
     const { sequence } = fullPacket;
 
-    /** @type {PromiseRecord<Bytes>} */
+    /**
+     * @type {PromiseRecord<Bytes>}
+     */
     const ackDeferred = makePromiseKit();
 
     // Register the ack resolver/rejector with this sequence number.
@@ -126,7 +139,7 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
    * @param {string} portID
    * @param {string} rChannelID
    * @param {string} rPortID
-   * @param {'ORDERED' | 'UNORDERED'} order
+   * @param {'ORDERED'|'UNORDERED'} order
    * @returns {ConnectionHandler}
    */
   function makeIBCConnectionHandler(
@@ -200,7 +213,9 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
     });
   }
 
-  /** @param {string} localAddr */
+  /**
+   * @param {string} localAddr
+   */
   const localAddrToPortID = localAddr => {
     const m = localAddr.match(/^\/ibc-port\/([-a-zA-Z0-9._+#[\]<>]+)$/);
     if (!m) {
@@ -211,23 +226,29 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
     return m[1];
   };
 
-  /** @type {ProtocolImpl} */
+  /**
+   * @type {ProtocolImpl}
+   */
   let protocolImpl;
 
   /**
    * @typedef {object} OutboundCircuitRecord
    * @property {IBCConnectionID} dst
-   * @property {'ORDERED' | 'UNORDERED'} order
+   * @property {'ORDERED'|'UNORDERED'} order
    * @property {string} version
    * @property {IBCPacket} packet
    * @property {PromiseRecord<ConnectionHandler>} deferredHandler
    */
 
-  /** @type {LegacyMap<Port, Set<PromiseRecord<ConnectionHandler>>>} */
+  /**
+   * @type {LegacyMap<Port, Set<PromiseRecord<ConnectionHandler>>>}
+   */
   // Legacy because it holds a raw JavaScript Set
   const portToPendingConns = makeLegacyMap('Port');
 
-  /** @type {ProtocolHandler} */
+  /**
+   * @type {ProtocolHandler}
+   */
   const protocol = Far('IBCProtocolHandler', {
     async onCreate(impl, _protocolHandler) {
       console.debug('IBC onCreate');
@@ -338,7 +359,6 @@ export function makeIBCProtocolHandler(E, rawCallIBCDevice) {
     ...protocol,
     async fromBridge(obj) {
       console.info('IBC fromBridge', obj);
-      await null;
       switch (obj.event) {
         case 'channelOpenTry': {
           // They're (more or less politely) asking if we are listening, so make an attempt.

package/src/lib-board.d.ts

@@ -1,6 +1,6 @@
 export const DEFAULT_CRC_DIGITS: 2;
 export const DEFAULT_PREFIX: "board0";
-export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undefined, args_1?: {
+export function prepareBoardKit(baggage: MapStore<string, unknown>): (args_0?: number | bigint | undefined, args_1?: {
     prefix?: string | undefined;
     crcDigits?: number | undefined;
 } | undefined) => {
@@ -8,13 +8,13 @@ export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undef
         /**
          * Provide an ID for a value, generating one if not already present.
          *
-         * Each board ID includes a CRC so that the last part is
-         * well-distributed, which mitigates typo risks.
+         * Each board ID includes a CRC so that the last part is well-distributed,
+         * which mitigates typo risks.
          *
-         * Scaling Consideration: since we cannot know when consumers are no
-         * longer interested in an ID, a board holds a strong reference to
-         * `value` for its entire lifetime. For a well-known board, this is
-         * essentially forever.
+         * Scaling Consideration: since we cannot know when consumers
+         * are no longer interested in an ID, a board holds a strong reference
+         * to `value` for its entire lifetime. For a well-known board, this
+         * is essentially forever.
          *
          * @param {Key} value
          * @throws if `value` is not a Key in the @agoric/store sense
@@ -26,22 +26,22 @@ export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undef
          */
         getValue(id: BoardId): any;
         /**
-         * Convenience method for recursively traversing boards and board-like
-         * remotables to get data associated with a sequence of ids
-         * corresponding to each successive board. For example, `lookup("foo",
-         * "bar")` gets the value associated with id "foo" and returns the
-         * result of invoking `lookup("bar")` upon it to get the value it
-         * associates with id "bar".
+         * Convenience method for recursively traversing boards and
+         * board-like remotables to get data associated with a sequence of ids
+         * corresponding to each successive board.
+         * For example, `lookup("foo", "bar")` gets the value associated with
+         * id "foo" and returns the result of invoking `lookup("bar")` upon it
+         * to get the value it associates with id "bar".
          *
-         * @param {...string} path
+         * @param  {...string} path
          */
         lookup(...path: string[]): Promise<any>;
         /** @param {Key} val */
         has(val: Key): boolean;
         ids(): string[];
         /**
-         * Get a marshaller that implements the convertValToSlot hook using
-         * getId(), "publishing" previously un-mapped objects.
+         * Get a marshaller that implements the convertValToSlot hook using getId(),
+         * "publishing" previously un-mapped objects.
          */
         getPublishingMarshaller(): {
             toCapData(val: any): import("@endo/marshal").CapData<string>;
@@ -50,12 +50,12 @@ export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undef
             unserialize(data: any): any;
         };
         /**
-         * Get a marshaller that implements the convertValToSlot hook using
-         * getId(), only for objects that the board has().
+         * Get a marshaller that implements the convertValToSlot hook using getId(),
+         * only for objects that the board has().
          *
          * For other objects, we don't throw, but we emit a null slot.
-         * Un-serializing a null slot always produces a fresh object rather than
-         * preserving object identity.
+         * Un-serializing a null slot always produces a fresh object
+         * rather than preserving object identity.
          */
         getReadonlyMarshaller(): {
             toCapData(val: any): import("@endo/marshal").CapData<string | null>;
@@ -81,13 +81,13 @@ export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undef
         /**
          * Provide an ID for a value, generating one if not already present.
          *
-         * Each board ID includes a CRC so that the last part is
-         * well-distributed, which mitigates typo risks.
+         * Each board ID includes a CRC so that the last part is well-distributed,
+         * which mitigates typo risks.
          *
-         * Scaling Consideration: since we cannot know when consumers are no
-         * longer interested in an ID, a board holds a strong reference to
-         * `value` for its entire lifetime. For a well-known board, this is
-         * essentially forever.
+         * Scaling Consideration: since we cannot know when consumers
+         * are no longer interested in an ID, a board holds a strong reference
+         * to `value` for its entire lifetime. For a well-known board, this
+         * is essentially forever.
          *
          * @param {Key} value
          * @throws if `value` is not a Key in the @agoric/store sense
@@ -99,22 +99,22 @@ export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undef
          */
         getValue(id: BoardId): any;
         /**
-         * Convenience method for recursively traversing boards and board-like
-         * remotables to get data associated with a sequence of ids
-         * corresponding to each successive board. For example, `lookup("foo",
-         * "bar")` gets the value associated with id "foo" and returns the
-         * result of invoking `lookup("bar")` upon it to get the value it
-         * associates with id "bar".
+         * Convenience method for recursively traversing boards and
+         * board-like remotables to get data associated with a sequence of ids
+         * corresponding to each successive board.
+         * For example, `lookup("foo", "bar")` gets the value associated with
+         * id "foo" and returns the result of invoking `lookup("bar")` upon it
+         * to get the value it associates with id "bar".
          *
-         * @param {...string} path
+         * @param  {...string} path
          */
         lookup(...path: string[]): Promise<any>;
         /** @param {Key} val */
         has(val: Key): boolean;
         ids(): string[];
         /**
-         * Get a marshaller that implements the convertValToSlot hook using
-         * getId(), "publishing" previously un-mapped objects.
+         * Get a marshaller that implements the convertValToSlot hook using getId(),
+         * "publishing" previously un-mapped objects.
          */
         getPublishingMarshaller(): {
             toCapData(val: any): import("@endo/marshal").CapData<string>;
@@ -123,12 +123,12 @@ export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undef
             unserialize(data: any): any;
         };
         /**
-         * Get a marshaller that implements the convertValToSlot hook using
-         * getId(), only for objects that the board has().
+         * Get a marshaller that implements the convertValToSlot hook using getId(),
+         * only for objects that the board has().
          *
          * For other objects, we don't throw, but we emit a null slot.
-         * Un-serializing a null slot always produces a fresh object rather than
-         * preserving object identity.
+         * Un-serializing a null slot always produces a fresh object
+         * rather than preserving object identity.
          */
         getReadonlyMarshaller(): {
             toCapData(val: any): import("@endo/marshal").CapData<string | null>;
@@ -152,27 +152,29 @@ export function prepareBoardKit(baggage: any): (args_0?: number | bigint | undef
 }>;
 export function prepareRecorderFactory(zone: import('@agoric/zone').Zone): (label: string, marshaller: Marshaller) => <T>(storageNode: StorageNode, valueShape?: import("@agoric/zoe/src/contractSupport/recorder.js").TypedMatcher<T> | undefined) => import("@agoric/zoe/src/contractSupport/recorder.js").RecorderKit<T>;
 /**
- * For a value with a known id in the board, we can use that board id as a slot
- * to preserve identity when marshaling.
+ * For a value with a known id in the board, we can use
+ * that board id as a slot to preserve identity when marshaling.
  *
  * The contents of the string depend on the `prefix` and `crcDigits` options:
- * `${prefix}${crc}${seq}`
+ *    \`${prefix}${crc}${seq}\`
  *
  * For example, 'board0371' for prefix: 'board0', seq: 1, 2 digits crc.
  */
 export type BoardId = string;
 /**
- * // TODO: use
- *   Key from
+ * // TODO: use Key from
  */
 export type BoardState = ReturnType<typeof initDurableBoardState>;
 export type Key = import('@endo/marshal').Passable;
 /**
- * @typedef {ReturnType<typeof initDurableBoardState>} BoardState // TODO: use
- *   Key from @agoric/store when available
  * @see {prepareExoClassKit}
- * @see {@link ../../SwingSet/docs/virtual-objects.md|SwingSet Virtual Objects} Hoisting this function makes defining the state type concise.
+ * @see {@link ../../SwingSet/docs/virtual-objects.md|SwingSet Virtual Objects}
  *
+ * Hoisting this function makes defining the state type concise.
+ * @typedef {ReturnType<typeof initDurableBoardState>} BoardState
+ *
+ *
+ * // TODO: use Key from @agoric/store when available
  * @typedef {import('@endo/marshal').Passable} Key
  */
 /**
@@ -181,8 +183,7 @@ export type Key = import('@endo/marshal').Passable;
  * @param {bigint | number} [initSequence]
  * @param {object} [options]
  * @param {string} [options.prefix] prefix for all ids generated
- * @param {number} [options.crcDigits] count of digits to use in CRC at end of
- *   the id
+ * @param {number} [options.crcDigits] count of digits to use in CRC at end of the id
  */
 declare function initDurableBoardState(initSequence?: number | bigint | undefined, { prefix, crcDigits }?: {
     prefix?: string | undefined;

package/src/lib-board.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib-board.d.ts","sourceRoot":"","sources":["lib-board.js"],"names":[],"mappings":"AAkBA,mCAAoC;AACpC,sCAAuC;AAoOhC;;;;;QAQC;;;;;;;;;;;;;WAaG;qBAFQ,GAAG;QAMd;;;WAGG;qBAFQ,OAAO;QAMlB;;;;;;;;;WASG;wBADW,MAAM;QAgBpB,uBAAuB;iBAAX,GAAG;;QASf;;;WAGG;;;;;;;QAIH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;QAvEH;;;;;;;;;;;;;WAaG;qBAFQ,GAAG;QAMd;;;WAGG;qBAFQ,OAAO;QAMlB;;;;;;;;;WASG;wBADW,MAAM;QAgBpB,uBAAuB;iBAAX,GAAG;;QASf;;;WAGG;;;;;;;QAIH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;GAuCV;AAGM,6CADK,OAAO,cAAc,EAAE,IAAI,WAS1B,MAAM,cACN,UAAU,2MAYtB;;;;;;;;;;sBA5UY,MAAM;;;;;yBAmBN,WAAW,4BAA4B,CAAC;kBAKxC,OAAO,eAAe,EAAE,QAAQ;AAN7C;;;;;;;GAOG;AAGH;;;;;;;;GAQG;AACH;;;;;;;;;EA0BC"}
+{"version":3,"file":"lib-board.d.ts","sourceRoot":"","sources":["lib-board.js"],"names":[],"mappings":"AAmBA,mCAAoC;AACpC,sCAAuC;AAwOhC;;;;;QAQC;;;;;;;;;;;;;WAaG;qBAFQ,GAAG;QAMd;;;WAGG;qBAFQ,OAAO;QAMlB;;;;;;;;;WASG;wBADY,MAAM;QAgBrB,uBAAuB;iBAAX,GAAG;;QASf;;;WAGG;;;;;;;QAIH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;QAvEH;;;;;;;;;;;;;WAaG;qBAFQ,GAAG;QAMd;;;WAGG;qBAFQ,OAAO;QAMlB;;;;;;;;;WASG;wBADY,MAAM;QAgBrB,uBAAuB;iBAAX,GAAG;;QASf;;;WAGG;;;;;;;QAIH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;GAuCV;AAKM,6CAFI,OAAO,cAAc,EAAE,IAAI,WAUzB,MAAM,cACN,UAAU,2MAYtB;;;;;;;;;;sBAlVY,MAAM;;;;yBAuBN,WAAW,4BAA4B,CAAC;kBAIxC,OAAO,eAAe,EAAE,QAAQ;AAT7C;;;;;;;;;;GAUG;AAGH;;;;;;;GAOG;AACH;;;;;;;;;EA0BC"}

package/src/lib-board.js

@@ -1,6 +1,7 @@
 // @ts-check
 /**
  * @file lib-board: share objects by way of plain-data ids
+ *
  * @see prepareBoardKit()
  */
 
@@ -47,11 +48,11 @@ const BoardKitIKit = {
 //#endregion
 
 /**
- * For a value with a known id in the board, we can use that board id as a slot
- * to preserve identity when marshaling.
+ * For a value with a known id in the board, we can use
+ * that board id as a slot to preserve identity when marshaling.
  *
  * The contents of the string depend on the `prefix` and `crcDigits` options:
- * `${prefix}${crc}${seq}`
+ *    \`${prefix}${crc}${seq}\`
  *
  * For example, 'board0371' for prefix: 'board0', seq: 1, 2 digits crc.
  *
@@ -74,11 +75,14 @@ const calcCrc = (data, crcDigits) => {
 };
 
 /**
- * @typedef {ReturnType<typeof initDurableBoardState>} BoardState // TODO: use
- *   Key from @agoric/store when available
  * @see {prepareExoClassKit}
- * @see {@link ../../SwingSet/docs/virtual-objects.md|SwingSet Virtual Objects} Hoisting this function makes defining the state type concise.
+ * @see {@link ../../SwingSet/docs/virtual-objects.md|SwingSet Virtual Objects}
+ *
+ * Hoisting this function makes defining the state type concise.
+ * @typedef {ReturnType<typeof initDurableBoardState>} BoardState
  *
+ *
+ * // TODO: use Key from @agoric/store when available
  * @typedef {import('@endo/marshal').Passable} Key
  */
 
@@ -89,8 +93,7 @@ const calcCrc = (data, crcDigits) => {
  * @param {bigint | number} [initSequence]
  * @param {object} [options]
  * @param {string} [options.prefix] prefix for all ids generated
- * @param {number} [options.crcDigits] count of digits to use in CRC at end of
- *   the id
+ * @param {number} [options.crcDigits] count of digits to use in CRC at end of the id
  */
 const initDurableBoardState = (
   initSequence = 0,
@@ -177,7 +180,9 @@ const getValue = (id, { prefix, crcDigits, idToVal }) => {
   throw Fail`board does not have id: ${id}`;
 };
 
-/** @param {BoardState} state */
+/**
+ * @param {BoardState} state
+ */
 const makeSlotToVal = state => {
   const ifaceAllegedPrefix = 'Alleged: ';
   const ifaceInaccessiblePrefix = 'SEVERED: ';
@@ -238,9 +243,9 @@ const makePublishingMarshaller = state => {
 //#endregion
 
 /**
- * A board is a two-way mapping between objects (such as issuers, brands,
- * installation handles) and plain-data string IDs. A well-known board allows
- * sharing objects by way of their ids.
+ * A board is a two-way mapping between objects (such as issuers,
+ * brands, installation handles) and plain-data string IDs.
+ * A well-known board allows sharing objects by way of their ids.
  *
  * @param {import('@agoric/vat-data').Baggage} baggage for upgrade successors
  * @see {@link packages/SwingSet/docs/vat-upgrade.md|Vat Upgrade}
@@ -256,13 +261,13 @@ export const prepareBoardKit = baggage => {
         /**
          * Provide an ID for a value, generating one if not already present.
          *
-         * Each board ID includes a CRC so that the last part is
-         * well-distributed, which mitigates typo risks.
+         * Each board ID includes a CRC so that the last part is well-distributed,
+         * which mitigates typo risks.
          *
-         * Scaling Consideration: since we cannot know when consumers are no
-         * longer interested in an ID, a board holds a strong reference to
-         * `value` for its entire lifetime. For a well-known board, this is
-         * essentially forever.
+         * Scaling Consideration: since we cannot know when consumers
+         * are no longer interested in an ID, a board holds a strong reference
+         * to `value` for its entire lifetime. For a well-known board, this
+         * is essentially forever.
          *
          * @param {Key} value
          * @throws if `value` is not a Key in the @agoric/store sense
@@ -278,14 +283,14 @@ export const prepareBoardKit = baggage => {
           return getValue(id, this.state);
         },
         /**
-         * Convenience method for recursively traversing boards and board-like
-         * remotables to get data associated with a sequence of ids
-         * corresponding to each successive board. For example, `lookup("foo",
-         * "bar")` gets the value associated with id "foo" and returns the
-         * result of invoking `lookup("bar")` upon it to get the value it
-         * associates with id "bar".
+         * Convenience method for recursively traversing boards and
+         * board-like remotables to get data associated with a sequence of ids
+         * corresponding to each successive board.
+         * For example, `lookup("foo", "bar")` gets the value associated with
+         * id "foo" and returns the result of invoking `lookup("bar")` upon it
+         * to get the value it associates with id "bar".
          *
-         * @param {...string} path
+         * @param  {...string} path
          */
         async lookup(...path) {
           const {
@@ -311,19 +316,19 @@ export const prepareBoardKit = baggage => {
           return harden([...state.idToVal.keys()]);
         },
         /**
-         * Get a marshaller that implements the convertValToSlot hook using
-         * getId(), "publishing" previously un-mapped objects.
+         * Get a marshaller that implements the convertValToSlot hook using getId(),
+         * "publishing" previously un-mapped objects.
          */
         getPublishingMarshaller() {
           return this.facets.publishingMarshaller;
         },
         /**
-         * Get a marshaller that implements the convertValToSlot hook using
-         * getId(), only for objects that the board has().
+         * Get a marshaller that implements the convertValToSlot hook using getId(),
+         * only for objects that the board has().
          *
          * For other objects, we don't throw, but we emit a null slot.
-         * Un-serializing a null slot always produces a fresh object rather than
-         * preserving object identity.
+         * Un-serializing a null slot always produces a fresh object
+         * rather than preserving object identity.
          */
         getReadonlyMarshaller() {
           return this.facets.readonlyMarshaller;
@@ -365,7 +370,9 @@ export const prepareBoardKit = baggage => {
   );
 };
 
-/** @param {import('@agoric/zone').Zone} zone */
+/**
+ * @param {import('@agoric/zone').Zone} zone
+ */
 export const prepareRecorderFactory = zone => {
   const baggage = zone.mapStore(`Recorder Baggage`);
   const makeDurablePublishKit = prepareDurablePublishKit(

package/src/mintHolder.d.ts

@@ -1,6 +1,4 @@
-/** @type {ContractMeta} */
-export const meta: ContractMeta;
-export function start<K extends AssetKind>(zcf: ZCF<IssuerInfo<K>>, _privateArgs: undefined, instanceBaggage: any): {
+export function prepare<K extends AssetKind>(zcf: ZCF<IssuerInfo<K>>, _privateArgs: undefined, instanceBaggage: MapStore<string, unknown>): {
     publicFacet: Issuer<AssetKind>;
     creatorFacet: Mint<AssetKind>;
 };

package/src/mintHolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mintHolder.d.ts","sourceRoot":"","sources":["mintHolder.js"],"names":[],"mappings":"AAkCA,2BAA2B;AAC3B,mBADW,YAAY,CAGrB;AAYK,kFAHI,SAAS;;;EAUnB;sBA/Ca,OAAO,kBAAkB,EAAE,OAAO;;;;8CAInC;IACZ,OAAW,EAAE,MAAM,CAAC;IACpB,SAAa,EAAE,CAAC,CAAC;IACjB,WAAe,EAAE,WAAW,CAAC;CAC1B"}
+{"version":3,"file":"mintHolder.d.ts","sourceRoot":"","sources":["mintHolder.js"],"names":[],"mappings":"AA4CO,oFAHI,SAAS;;;EAUnB;sBA1Ca,OAAO,kBAAkB,EAAE,OAAO;;;;8CAInC;IACZ,OAAW,EAAE,MAAM,CAAC;IACpB,SAAa,EAAE,CAAC,CAAC;IACjB,WAAe,EAAE,WAAW,CAAC;CAC1B"}