@agoric/vats 0.15.2-dev-0b1501a.0 → 0.15.2-dev-e3b41dc.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./src/types.js";
+export * from "./src/types-index.js";
 export * from "./src/nameHub.js";
 export * from "./src/bridge.js";
 export { makePromiseSpace } from "./src/core/promise-space.js";

package/index.js

@@ -2,7 +2,7 @@
 import './src/core/types-ambient.js';
 
 // eslint-disable-next-line import/export -- no named exports
-export * from './src/types.js';
+export * from './src/types-index.js';
 export * from './src/nameHub.js';
 export * from './src/bridge.js';
 export { makePromiseSpace } from './src/core/promise-space.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agoric/vats",
-  "version": "0.15.2-dev-0b1501a.0+0b1501a",
+  "version": "0.15.2-dev-e3b41dc.0+e3b41dc",
   "description": "Agoric's Vat library",
   "type": "module",
   "main": "./index.js",
@@ -22,19 +22,19 @@
   "author": "Agoric",
   "license": "Apache-2.0",
   "dependencies": {
-    "@agoric/cosmic-proto": "0.4.1-dev-0b1501a.0+0b1501a",
-    "@agoric/ertp": "0.16.3-dev-0b1501a.0+0b1501a",
-    "@agoric/governance": "0.10.4-dev-0b1501a.0+0b1501a",
-    "@agoric/internal": "0.3.3-dev-0b1501a.0+0b1501a",
-    "@agoric/network": "0.1.1-dev-0b1501a.0+0b1501a",
-    "@agoric/notifier": "0.6.3-dev-0b1501a.0+0b1501a",
-    "@agoric/store": "0.9.3-dev-0b1501a.0+0b1501a",
-    "@agoric/swingset-vat": "0.32.3-dev-0b1501a.0+0b1501a",
-    "@agoric/time": "0.3.3-dev-0b1501a.0+0b1501a",
-    "@agoric/vat-data": "0.5.3-dev-0b1501a.0+0b1501a",
-    "@agoric/vow": "0.1.1-dev-0b1501a.0+0b1501a",
-    "@agoric/zoe": "0.26.3-dev-0b1501a.0+0b1501a",
-    "@agoric/zone": "0.2.3-dev-0b1501a.0+0b1501a",
+    "@agoric/cosmic-proto": "0.4.1-dev-e3b41dc.0+e3b41dc",
+    "@agoric/ertp": "0.16.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/governance": "0.10.4-dev-e3b41dc.0+e3b41dc",
+    "@agoric/internal": "0.3.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/network": "0.1.1-dev-e3b41dc.0+e3b41dc",
+    "@agoric/notifier": "0.6.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/store": "0.9.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/swingset-vat": "0.32.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/time": "0.3.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/vat-data": "0.5.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/vow": "0.1.1-dev-e3b41dc.0+e3b41dc",
+    "@agoric/zoe": "0.26.3-dev-e3b41dc.0+e3b41dc",
+    "@agoric/zone": "0.2.3-dev-e3b41dc.0+e3b41dc",
     "@endo/errors": "^1.2.5",
     "@endo/far": "^1.1.5",
     "@endo/import-bundle": "^1.2.2",
@@ -47,7 +47,7 @@
     "jessie.js": "^0.3.4"
   },
   "devDependencies": {
-    "@agoric/swingset-liveslots": "0.10.3-dev-0b1501a.0+0b1501a",
+    "@agoric/swingset-liveslots": "0.10.3-dev-e3b41dc.0+e3b41dc",
     "@endo/bundle-source": "^3.4.0",
     "@endo/init": "^1.1.4",
     "ava": "^5.3.0",
@@ -79,5 +79,5 @@
   "typeCoverage": {
     "atLeast": 91.51
   },
-  "gitHead": "0b1501ace92d3f53ba37e1c83f508f61c14fcd7d"
+  "gitHead": "e3b41dc204ce335217bf18ed4889aba18734d8f6"
 }

package/src/ibc.js

@@ -222,7 +222,7 @@ export const prepareIBCProtocol = (zone, powers) => {
       /** @type {MapStore<string, Outbound[]>} */
       const srcPortToOutbounds = detached.mapStore('srcPortToOutbounds');
 
-      /** @type {MapStore<string, MapStore<number, VowKit<Bytes>>>} */
+      /** @type {MapStore<string, MapStore<bigint, VowKit<Bytes>>>} */
       const channelKeyToSeqAck = detached.mapStore('channelKeyToSeqAck');
 
       /** @type {MapStore<string, SetStore<VowResolver>>} */
@@ -669,7 +669,7 @@ export const prepareIBCProtocol = (zone, powers) => {
         /**
          * @param {IBCChannelID} channelID
          * @param {IBCPortID} portID
-         * @param {number} sequence
+         * @param {bigint} sequence
          */
         findAckKit(channelID, portID, sequence) {
           const { channelKeyToSeqAck } = this.state;

package/src/types-index.d.ts

@@ -0,0 +1,2 @@
+// eslint-disable-next-line import/export -- no named exports
+export * from './types.js';

package/src/types-index.js

@@ -0,0 +1,2 @@
+// Empty JS file to correspond with types.d.ts
+export {};

package/src/types.d.ts

@@ -1,14 +1,8 @@
-import type { FungibleTokenPacketData } from '@agoric/cosmic-proto/ibc/applications/transfer/v2/packet.js';
 import type { BridgeIdValue, Remote } from '@agoric/internal';
 import type { Bytes } from '@agoric/network';
 import type { Guarded } from '@endo/exo';
-import type { LocalChainAccount } from './localchain.js';
-import type { TargetApp } from './bridge-target.js';
-
-export type Board = ReturnType<
-  ReturnType<typeof import('./lib-board.js').prepareBoardKit>
->['board'];
-
+import type { PacketSDKType } from '@agoric/cosmic-proto/ibc/core/channel/v1/channel.js';
+export type Board = ReturnType<ReturnType<typeof import('./lib-board.js').prepareBoardKit>>['board'];
 /**
  * read-only access to a node in a name hierarchy
  *
@@ -17,279 +11,237 @@ export type Board = ReturnType<
  * trips for the contents of even the simplest nameHub.
  */
 export type NameHub<Value = any> = {
-  has: (key: string) => boolean;
-  /**
-   * Look up a path of keys starting from the current NameHub. Wait on any
-   * reserved promises.
-   */
-  lookup: (...path: string[]) => Promise<any>;
-  /** get all the entries available in the current NameHub */
-  entries: (includeReserved?: boolean) => [string, Value][];
-  /** get all names available in the current NameHub */
-  keys: () => string[];
-  /** get all values available in the current NameHub */
-  values: () => Value[];
+    has: (key: string) => boolean;
+    /**
+     * Look up a path of keys starting from the current NameHub. Wait on any
+     * reserved promises.
+     */
+    lookup: (...path: string[]) => Promise<any>;
+    /** get all the entries available in the current NameHub */
+    entries: (includeReserved?: boolean) => [string, Value][];
+    /** get all names available in the current NameHub */
+    keys: () => string[];
+    /** get all values available in the current NameHub */
+    values: () => Value[];
 };
-
 /** write access to a node in a name hierarchy */
 export type NameAdmin = {
-  provideChild: (key: string, reserved?: string[]) => Promise<NameHubKit>;
-  /**
-   * Mark a key as reserved; will return a promise that is fulfilled when the
-   * key is updated (or rejected when deleted). If the key was already set it
-   * does nothing.
-   */
-  reserve: (key: string) => Promise<void>;
-  /**
-   * Update if not already updated. Return existing value, or newValue if not
-   * existing.
-   */
-  default: <T>(key: string, newValue: T, newAdmin?: NameAdmin) => T;
-  /** Update only if already initialized. Reject if not. */
-  set: (key: string, newValue: any, newAdmin?: NameAdmin) => void;
-  /**
-   * Fulfill an outstanding reserved promise (if any) to the newValue and set
-   * the key to the newValue. If newAdmin is provided, set that to return via
-   * lookupAdmin.
-   */
-  update: (key: string, newValue: any, newAdmin?: NameAdmin) => void;
-  /**
-   * Look up the `newAdmin` from the path of keys starting from the current
-   * NameAdmin. Wait on any reserved promises.
-   */
-  lookupAdmin: (...path: string[]) => Promise<NameAdmin>;
-  /** Delete a value and reject an outstanding reserved promise (if any). */
-  delete: (key: string) => void;
-  /** get the NameHub corresponding to the current NameAdmin */
-  readonly: () => NameHub;
-  /**
-   * Set a function to be called whenever an update or deletion is made, with all the entries as of that point.
-   *
-   * Note: can be called at most once.
-   */
-  onUpdate: (fn: undefined | NameHubUpdateHandler) => void;
+    provideChild: (key: string, reserved?: string[]) => Promise<NameHubKit>;
+    /**
+     * Mark a key as reserved; will return a promise that is fulfilled when the
+     * key is updated (or rejected when deleted). If the key was already set it
+     * does nothing.
+     */
+    reserve: (key: string) => Promise<void>;
+    /**
+     * Update if not already updated. Return existing value, or newValue if not
+     * existing.
+     */
+    default: <T>(key: string, newValue: T, newAdmin?: NameAdmin) => T;
+    /** Update only if already initialized. Reject if not. */
+    set: (key: string, newValue: any, newAdmin?: NameAdmin) => void;
+    /**
+     * Fulfill an outstanding reserved promise (if any) to the newValue and set
+     * the key to the newValue. If newAdmin is provided, set that to return via
+     * lookupAdmin.
+     */
+    update: (key: string, newValue: any, newAdmin?: NameAdmin) => void;
+    /**
+     * Look up the `newAdmin` from the path of keys starting from the current
+     * NameAdmin. Wait on any reserved promises.
+     */
+    lookupAdmin: (...path: string[]) => Promise<NameAdmin>;
+    /** Delete a value and reject an outstanding reserved promise (if any). */
+    delete: (key: string) => void;
+    /** get the NameHub corresponding to the current NameAdmin */
+    readonly: () => NameHub;
+    /**
+     * Set a function to be called whenever an update or deletion is made, with all the entries as of that point.
+     *
+     * Note: can be called at most once.
+     */
+    onUpdate: (fn: undefined | NameHubUpdateHandler) => void;
 };
-
 export type NameHubUpdateHandler = {
-  /** Called when an update or deletion is made, with all entries as of that point. */
-  write: (entries: [string, any][]) => void;
+    /** Called when an update or deletion is made, with all entries as of that point. */
+    write: (entries: [string, any][]) => void;
 };
-
 /** a node in a name hierarchy */
 export type NameHubKit = {
-  /** read access */
-  nameHub: NameHub;
-  /** write access */
-  nameAdmin: NameAdmin;
+    /** read access */
+    nameHub: NameHub;
+    /** write access */
+    nameAdmin: NameAdmin;
 };
-
 export type MyAddressNameAdmin = NameAdmin & {
-  getMyAddress(): string;
+    getMyAddress(): string;
 };
 export type NamesByAddressAdmin = NameAdmin & {
-  provideChild(
-    addr: string,
-    reserved?: string[],
-  ): Promise<{
-    nameHub: NameHub;
-    nameAdmin: MyAddressNameAdmin;
-  }>;
-  lookupAdmin(addr: string): Promise<MyAddressNameAdmin>;
+    provideChild(addr: string, reserved?: string[]): Promise<{
+        nameHub: NameHub;
+        nameAdmin: MyAddressNameAdmin;
+    }>;
+    lookupAdmin(addr: string): Promise<MyAddressNameAdmin>;
 };
-
 /** An object that can receive messages from the bridge device */
 export type BridgeHandler = {
-  /** Handle an inbound message */
-  fromBridge: (obj: any) => Promise<unknown>;
+    /** Handle an inbound message */
+    fromBridge: (obj: any) => Promise<unknown>;
 };
-
 export type ScopedBridgeManagerMethods<BridgeId extends BridgeIdValue> = {
-  /**
-   * Optional bridge ID getter. Not part of the production bridge vat but
-   * available in fake bridges as a means for test reflection and for the type
-   * system to hang the bridgeId
-   */
-  getBridgeId?: () => BridgeId;
-  /** Downcall from the VM into Golang */
-  toBridge: (obj: any) => Promise<any>;
-  /** Upcall from Golang into the VM */
-  fromBridge: (obj: any) => Promise<unknown>;
-  initHandler: (handler: Remote<BridgeHandler>) => void;
-  setHandler: (handler: Remote<BridgeHandler>) => void;
+    /**
+     * Optional bridge ID getter. Not part of the production bridge vat but
+     * available in fake bridges as a means for test reflection and for the type
+     * system to hang the bridgeId
+     */
+    getBridgeId?: () => BridgeId;
+    /** Downcall from the VM into Golang */
+    toBridge: (obj: any) => Promise<any>;
+    /** Upcall from Golang into the VM */
+    fromBridge: (obj: any) => Promise<unknown>;
+    initHandler: (handler: Remote<BridgeHandler>) => void;
+    setHandler: (handler: Remote<BridgeHandler>) => void;
 };
-
 /** An object which handles messages for a specific bridge */
-export type ScopedBridgeManager<BridgeId extends BridgeIdValue> = Guarded<
-  ScopedBridgeManagerMethods<BridgeId>
->;
-
+export type ScopedBridgeManager<BridgeId extends BridgeIdValue> = Guarded<ScopedBridgeManagerMethods<BridgeId>>;
 /** The object to manage this bridge */
 export type BridgeManager = {
-  register: <BridgeId extends BridgeIdValue>(
-    bridgeId: BridgeId,
-    handler?: Remote<BridgeHandler>,
-  ) => ScopedBridgeManager<BridgeId>;
+    register: <BridgeId extends BridgeIdValue>(bridgeId: BridgeId, handler?: Remote<BridgeHandler>) => ScopedBridgeManager<BridgeId>;
 };
-
 export type IBCPortID = string;
 export type IBCChannelID = `channel-${number}`;
 export type IBCConnectionID = `connection-${number}`;
 export type IBCChannelOrdering = 'ORDERED' | 'UNORDERED';
-
 export type IBCPacket = {
-  data: Bytes;
-  source_channel: IBCChannelID;
-  source_port: IBCPortID;
-  destination_channel: IBCChannelID;
-  destination_port: IBCPortID;
-  sequence?: PacketSDKType['sequence'];
-  timeout_height?: PacketSDKType['timeout_height'];
-  timeout_timestamp?: PacketSDKType['timeout_timestamp'];
+    data: Bytes;
+    source_channel: IBCChannelID;
+    source_port: IBCPortID;
+    destination_channel: IBCChannelID;
+    destination_port: IBCPortID;
+    sequence?: PacketSDKType['sequence'];
+    timeout_height?: PacketSDKType['timeout_height'];
+    timeout_timestamp?: PacketSDKType['timeout_timestamp'];
 };
-
 export type IBCCounterParty = {
-  port_id: IBCPortID;
-  channel_id: IBCChannelID;
+    port_id: IBCPortID;
+    channel_id: IBCChannelID;
 };
-
 export type ConnectingInfo = {
-  order: IBCChannelOrdering;
-  connectionHops: IBCConnectionID[];
-  portID: IBCPortID;
-  channelID: IBCChannelID;
-  counterparty: IBCCounterParty;
-  counterpartyVersion: string;
-  version: string;
-  asyncVersions?: boolean;
+    order: IBCChannelOrdering;
+    connectionHops: IBCConnectionID[];
+    portID: IBCPortID;
+    channelID: IBCChannelID;
+    counterparty: IBCCounterParty;
+    counterpartyVersion: string;
+    version: string;
+    asyncVersions?: boolean;
 };
-
 /** see [ibc_module.go](../../../golang/cosmos/x/vibc/types/ibc_module.go) */
-export type IBCBridgeEvent =
-  | 'channelOpenInit'
-  | 'channelOpenTry'
-  | 'channelOpenAck'
-  | 'channelOpenConfirm'
-  | 'receivePacket'
-  | 'acknowledgementPacket'
-  | 'timeoutPacket'
-  | 'channelCloseInit'
-  | 'channelCloseConfirm'
-  | 'sendPacket';
-
+export type IBCBridgeEvent = 'channelOpenInit' | 'channelOpenTry' | 'channelOpenAck' | 'channelOpenConfirm' | 'receivePacket' | 'acknowledgementPacket' | 'timeoutPacket' | 'channelCloseInit' | 'channelCloseConfirm' | 'sendPacket';
 type IBCPacketEvents = {
-  channelOpenInit: ConnectingInfo;
-  channelOpenTry: ConnectingInfo;
-  channelOpenAck: ConnectingInfo;
-  channelOpenConfirm: ConnectingInfo;
-  receivePacket: {
-    packet: IBCPacket;
-  };
-  acknowledgementPacket: {
-    acknowledgement: Bytes;
-    packet: IBCPacket;
-    relayer: string; // chain address
-  };
-  timeoutPacket: {
-    packet: IBCPacket;
-  };
-  channelCloseInit: { channelID: IBCChannelID; portID: IBCPortID };
-  channelCloseConfirm: { channelID: IBCChannelID; portID: IBCPortID };
-  sendPacket: { relativeTimeoutNs: bigint; packet: IBCPacket };
+    channelOpenInit: ConnectingInfo;
+    channelOpenTry: ConnectingInfo;
+    channelOpenAck: ConnectingInfo;
+    channelOpenConfirm: ConnectingInfo;
+    receivePacket: {
+        packet: IBCPacket;
+    };
+    acknowledgementPacket: {
+        acknowledgement: Bytes;
+        packet: IBCPacket;
+        relayer: string;
+    };
+    timeoutPacket: {
+        packet: IBCPacket;
+    };
+    channelCloseInit: {
+        channelID: IBCChannelID;
+        portID: IBCPortID;
+    };
+    channelCloseConfirm: {
+        channelID: IBCChannelID;
+        portID: IBCPortID;
+    };
+    sendPacket: {
+        relativeTimeoutNs: bigint;
+        packet: IBCPacket;
+    };
 };
-
 export type IBCEvent<E extends IBCBridgeEvent> = {
-  type: 'IBC_EVENT';
-  blockHeight: number;
-  blockTime: number;
-  event: E;
+    type: 'IBC_EVENT';
+    blockHeight: number;
+    blockTime: number;
+    event: E;
 } & {
-  [K in keyof IBCPacketEvents[E]]: IBCPacketEvents[E][K];
+    [K in keyof IBCPacketEvents[E]]: IBCPacketEvents[E][K];
 };
-
 /** see [receiver.go](../../../golang/cosmos/x/vibc/types/receiver.go) */
-export type IBCDowncallMethod =
-  | 'sendPacket'
-  | 'tryOpenExecuted'
-  | 'receiveExecuted'
-  | 'startChannelOpenInit'
-  | 'startChannelCloseInit'
-  | 'bindPort'
-  | 'timeoutExecuted'
-  | 'initOpenExecuted';
-
+export type IBCDowncallMethod = 'sendPacket' | 'tryOpenExecuted' | 'receiveExecuted' | 'startChannelOpenInit' | 'startChannelCloseInit' | 'bindPort' | 'timeoutExecuted' | 'initOpenExecuted';
 type IBCMethodEvents = {
-  sendPacket: SendPacketDownCall;
-  tryOpenExecuted: ChannelOpenAckDowncall;
-  receiveExecuted: {}; // TODO update
-  startChannelOpenInit: ChannelOpenInitDowncall;
-  startChannelCloseInit: {}; // TODO update
-  bindPort: { packet: { source_port: IBCPortID } };
-  timeoutExecuted: {}; // TODO update
-  // XXX why isn't this in receiver.go?
-  initOpenExecuted: ChannelOpenAckDowncall;
+    sendPacket: SendPacketDownCall;
+    tryOpenExecuted: ChannelOpenAckDowncall;
+    receiveExecuted: {};
+    startChannelOpenInit: ChannelOpenInitDowncall;
+    startChannelCloseInit: {};
+    bindPort: {
+        packet: {
+            source_port: IBCPortID;
+        };
+    };
+    timeoutExecuted: {};
+    initOpenExecuted: ChannelOpenAckDowncall;
 };
-
 export type IBCMethod<M extends IBCDowncallMethod> = {
-  type: 'IBC_METHOD';
-  method: M;
+    type: 'IBC_METHOD';
+    method: M;
 } & {
-  [K in keyof IBCMethodEvents[M]]: IBCMethodEvents[M][K];
+    [K in keyof IBCMethodEvents[M]]: IBCMethodEvents[M][K];
 };
-
 export type IBCDowncall<M extends IBCDowncallMethod> = {
-  [K in keyof IBCMethodEvents[M]]: IBCMethodEvents[M][K];
+    [K in keyof IBCMethodEvents[M]]: IBCMethodEvents[M][K];
 };
-
-export type IBCDowncallPacket<M extends IBCDowncallMethod> =
-  IBCMethodEvents[M] extends { packet: infer P } ? P : never;
-
+export type IBCDowncallPacket<M extends IBCDowncallMethod> = IBCMethodEvents[M] extends {
+    packet: infer P;
+} ? P : never;
 type ChannelOpenDowncallBase = {
-  hops: IBCConnectionID[];
-  order: IBCChannelOrdering;
-  version: string;
+    hops: IBCConnectionID[];
+    order: IBCChannelOrdering;
+    version: string;
 };
-
 type ChannelOpenInitDowncall = ChannelOpenDowncallBase & {
-  packet: Pick<IBCPacket, 'destination_port' | 'source_port'>;
+    packet: Pick<IBCPacket, 'destination_port' | 'source_port'>;
 };
-
 type ChannelOpenAckDowncall = ChannelOpenDowncallBase & {
-  packet: Pick<
-    IBCPacket,
-    | 'destination_port'
-    | 'source_port'
-    | 'destination_channel'
-    | 'source_channel'
-  >;
+    packet: Pick<IBCPacket, 'destination_port' | 'source_port' | 'destination_channel' | 'source_channel'>;
 };
-
 type SendPacketDownCall = {
-  packet: IBCPacket;
-  relativeTimeoutNs: bigint;
+    packet: IBCPacket;
+    relativeTimeoutNs: bigint;
 };
-
 /**
  * This event is emitted when a FungibleTokenPacket is sent or received
  * by a target (e.g. a {@link LocalChainAccount}) that has a registered
  * {@link TargetApp}. It is passed through the `receiveUpcall` handler.
  */
 export type VTransferIBCEvent = {
-  type: 'VTRANSFER_IBC_EVENT';
-  blockHeight: number;
-  blockTime: number;
-  /**
-   * Indicates the type of IBC packet event:
-   * - 'acknowledgementPacket': passive tap that communicates the result of an acknowledged packet
-   * - 'writeAcknowledgement': active tap where the receiver can return a write acknowledgement
-   */
-  event: 'acknowledgementPacket' | 'writeAcknowledgement';
-  acknowledgement: Bytes;
-  /**
-   * Use `JSON.parse(atob(packet.data))` to get a
-   * {@link FungibleTokenPacketData} object.
-   */
-  packet: IBCPacket;
-  relayer: string;
-  /** e.g. the chain address of the LocalChainAccount */
-  target: string;
+    type: 'VTRANSFER_IBC_EVENT';
+    blockHeight: number;
+    blockTime: number;
+    /**
+     * Indicates the type of IBC packet event:
+     * - 'acknowledgementPacket': passive tap that communicates the result of an acknowledged packet
+     * - 'writeAcknowledgement': active tap where the receiver can return a write acknowledgement
+     */
+    event: 'acknowledgementPacket' | 'writeAcknowledgement';
+    acknowledgement: Bytes;
+    /**
+     * Use `JSON.parse(atob(packet.data))` to get a
+     * {@link FungibleTokenPacketData} object.
+     */
+    packet: IBCPacket;
+    relayer: string;
+    /** e.g. the chain address of the LocalChainAccount */
+    target: string;
 };
+export {};
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}

package/src/types.ts

@@ -0,0 +1,297 @@
+/* eslint-disable no-use-before-define */
+import type { FungibleTokenPacketData } from '@agoric/cosmic-proto/ibc/applications/transfer/v2/packet.js';
+import type { BridgeIdValue, Remote } from '@agoric/internal';
+import type { Bytes } from '@agoric/network';
+import type { Guarded } from '@endo/exo';
+import type { PacketSDKType } from '@agoric/cosmic-proto/ibc/core/channel/v1/channel.js';
+import type { LocalChainAccount } from './localchain.js';
+import type { TargetApp } from './bridge-target.js';
+
+export type Board = ReturnType<
+  ReturnType<typeof import('./lib-board.js').prepareBoardKit>
+>['board'];
+
+/**
+ * read-only access to a node in a name hierarchy
+ *
+ * NOTE: We need to return arrays, not iterables, because even if marshal could
+ * allow passing a remote iterable, there would be an inordinate number of round
+ * trips for the contents of even the simplest nameHub.
+ */
+export type NameHub<Value = any> = {
+  has: (key: string) => boolean;
+  /**
+   * Look up a path of keys starting from the current NameHub. Wait on any
+   * reserved promises.
+   */
+  lookup: (...path: string[]) => Promise<any>;
+  /** get all the entries available in the current NameHub */
+  entries: (includeReserved?: boolean) => [string, Value][];
+  /** get all names available in the current NameHub */
+  keys: () => string[];
+  /** get all values available in the current NameHub */
+  values: () => Value[];
+};
+
+/** write access to a node in a name hierarchy */
+export type NameAdmin = {
+  provideChild: (key: string, reserved?: string[]) => Promise<NameHubKit>;
+  /**
+   * Mark a key as reserved; will return a promise that is fulfilled when the
+   * key is updated (or rejected when deleted). If the key was already set it
+   * does nothing.
+   */
+  reserve: (key: string) => Promise<void>;
+  /**
+   * Update if not already updated. Return existing value, or newValue if not
+   * existing.
+   */
+  default: <T>(key: string, newValue: T, newAdmin?: NameAdmin) => T;
+  /** Update only if already initialized. Reject if not. */
+  set: (key: string, newValue: any, newAdmin?: NameAdmin) => void;
+  /**
+   * Fulfill an outstanding reserved promise (if any) to the newValue and set
+   * the key to the newValue. If newAdmin is provided, set that to return via
+   * lookupAdmin.
+   */
+  update: (key: string, newValue: any, newAdmin?: NameAdmin) => void;
+  /**
+   * Look up the `newAdmin` from the path of keys starting from the current
+   * NameAdmin. Wait on any reserved promises.
+   */
+  lookupAdmin: (...path: string[]) => Promise<NameAdmin>;
+  /** Delete a value and reject an outstanding reserved promise (if any). */
+  delete: (key: string) => void;
+  /** get the NameHub corresponding to the current NameAdmin */
+  readonly: () => NameHub;
+  /**
+   * Set a function to be called whenever an update or deletion is made, with all the entries as of that point.
+   *
+   * Note: can be called at most once.
+   */
+  onUpdate: (fn: undefined | NameHubUpdateHandler) => void;
+};
+
+export type NameHubUpdateHandler = {
+  /** Called when an update or deletion is made, with all entries as of that point. */
+  write: (entries: [string, any][]) => void;
+};
+
+/** a node in a name hierarchy */
+export type NameHubKit = {
+  /** read access */
+  nameHub: NameHub;
+  /** write access */
+  nameAdmin: NameAdmin;
+};
+
+export type MyAddressNameAdmin = NameAdmin & {
+  getMyAddress(): string;
+};
+export type NamesByAddressAdmin = NameAdmin & {
+  provideChild(
+    addr: string,
+    reserved?: string[],
+  ): Promise<{
+    nameHub: NameHub;
+    nameAdmin: MyAddressNameAdmin;
+  }>;
+  lookupAdmin(addr: string): Promise<MyAddressNameAdmin>;
+};
+
+/** An object that can receive messages from the bridge device */
+export type BridgeHandler = {
+  /** Handle an inbound message */
+  fromBridge: (obj: any) => Promise<unknown>;
+};
+
+export type ScopedBridgeManagerMethods<BridgeId extends BridgeIdValue> = {
+  /**
+   * Optional bridge ID getter. Not part of the production bridge vat but
+   * available in fake bridges as a means for test reflection and for the type
+   * system to hang the bridgeId
+   */
+  getBridgeId?: () => BridgeId;
+  /** Downcall from the VM into Golang */
+  toBridge: (obj: any) => Promise<any>;
+  /** Upcall from Golang into the VM */
+  fromBridge: (obj: any) => Promise<unknown>;
+  initHandler: (handler: Remote<BridgeHandler>) => void;
+  setHandler: (handler: Remote<BridgeHandler>) => void;
+};
+
+/** An object which handles messages for a specific bridge */
+export type ScopedBridgeManager<BridgeId extends BridgeIdValue> = Guarded<
+  ScopedBridgeManagerMethods<BridgeId>
+>;
+
+/** The object to manage this bridge */
+export type BridgeManager = {
+  register: <BridgeId extends BridgeIdValue>(
+    bridgeId: BridgeId,
+    handler?: Remote<BridgeHandler>,
+  ) => ScopedBridgeManager<BridgeId>;
+};
+
+export type IBCPortID = string;
+export type IBCChannelID = `channel-${number}`;
+export type IBCConnectionID = `connection-${number}`;
+export type IBCChannelOrdering = 'ORDERED' | 'UNORDERED';
+
+export type IBCPacket = {
+  data: Bytes;
+  source_channel: IBCChannelID;
+  source_port: IBCPortID;
+  destination_channel: IBCChannelID;
+  destination_port: IBCPortID;
+  sequence?: PacketSDKType['sequence'];
+  timeout_height?: PacketSDKType['timeout_height'];
+  timeout_timestamp?: PacketSDKType['timeout_timestamp'];
+};
+
+export type IBCCounterParty = {
+  port_id: IBCPortID;
+  channel_id: IBCChannelID;
+};
+
+export type ConnectingInfo = {
+  order: IBCChannelOrdering;
+  connectionHops: IBCConnectionID[];
+  portID: IBCPortID;
+  channelID: IBCChannelID;
+  counterparty: IBCCounterParty;
+  counterpartyVersion: string;
+  version: string;
+  asyncVersions?: boolean;
+};
+
+/** see [ibc_module.go](../../../golang/cosmos/x/vibc/types/ibc_module.go) */
+export type IBCBridgeEvent =
+  | 'channelOpenInit'
+  | 'channelOpenTry'
+  | 'channelOpenAck'
+  | 'channelOpenConfirm'
+  | 'receivePacket'
+  | 'acknowledgementPacket'
+  | 'timeoutPacket'
+  | 'channelCloseInit'
+  | 'channelCloseConfirm'
+  | 'sendPacket';
+
+type IBCPacketEvents = {
+  channelOpenInit: ConnectingInfo;
+  channelOpenTry: ConnectingInfo;
+  channelOpenAck: ConnectingInfo;
+  channelOpenConfirm: ConnectingInfo;
+  receivePacket: {
+    packet: IBCPacket;
+  };
+  acknowledgementPacket: {
+    acknowledgement: Bytes;
+    packet: IBCPacket;
+    relayer: string; // chain address
+  };
+  timeoutPacket: {
+    packet: IBCPacket;
+  };
+  channelCloseInit: { channelID: IBCChannelID; portID: IBCPortID };
+  channelCloseConfirm: { channelID: IBCChannelID; portID: IBCPortID };
+  sendPacket: { relativeTimeoutNs: bigint; packet: IBCPacket };
+};
+
+export type IBCEvent<E extends IBCBridgeEvent> = {
+  type: 'IBC_EVENT';
+  blockHeight: number;
+  blockTime: number;
+  event: E;
+} & {
+  [K in keyof IBCPacketEvents[E]]: IBCPacketEvents[E][K];
+};
+
+/** see [receiver.go](../../../golang/cosmos/x/vibc/types/receiver.go) */
+export type IBCDowncallMethod =
+  | 'sendPacket'
+  | 'tryOpenExecuted'
+  | 'receiveExecuted'
+  | 'startChannelOpenInit'
+  | 'startChannelCloseInit'
+  | 'bindPort'
+  | 'timeoutExecuted'
+  | 'initOpenExecuted';
+
+type IBCMethodEvents = {
+  sendPacket: SendPacketDownCall;
+  tryOpenExecuted: ChannelOpenAckDowncall;
+  receiveExecuted: {}; // TODO update
+  startChannelOpenInit: ChannelOpenInitDowncall;
+  startChannelCloseInit: {}; // TODO update
+  bindPort: { packet: { source_port: IBCPortID } };
+  timeoutExecuted: {}; // TODO update
+  // XXX why isn't this in receiver.go?
+  initOpenExecuted: ChannelOpenAckDowncall;
+};
+
+export type IBCMethod<M extends IBCDowncallMethod> = {
+  type: 'IBC_METHOD';
+  method: M;
+} & {
+  [K in keyof IBCMethodEvents[M]]: IBCMethodEvents[M][K];
+};
+
+export type IBCDowncall<M extends IBCDowncallMethod> = {
+  [K in keyof IBCMethodEvents[M]]: IBCMethodEvents[M][K];
+};
+
+export type IBCDowncallPacket<M extends IBCDowncallMethod> =
+  IBCMethodEvents[M] extends { packet: infer P } ? P : never;
+
+type ChannelOpenDowncallBase = {
+  hops: IBCConnectionID[];
+  order: IBCChannelOrdering;
+  version: string;
+};
+
+type ChannelOpenInitDowncall = ChannelOpenDowncallBase & {
+  packet: Pick<IBCPacket, 'destination_port' | 'source_port'>;
+};
+
+type ChannelOpenAckDowncall = ChannelOpenDowncallBase & {
+  packet: Pick<
+    IBCPacket,
+    | 'destination_port'
+    | 'source_port'
+    | 'destination_channel'
+    | 'source_channel'
+  >;
+};
+
+type SendPacketDownCall = {
+  packet: IBCPacket;
+  relativeTimeoutNs: bigint;
+};
+
+/**
+ * This event is emitted when a FungibleTokenPacket is sent or received
+ * by a target (e.g. a {@link LocalChainAccount}) that has a registered
+ * {@link TargetApp}. It is passed through the `receiveUpcall` handler.
+ */
+export type VTransferIBCEvent = {
+  type: 'VTRANSFER_IBC_EVENT';
+  blockHeight: number;
+  blockTime: number;
+  /**
+   * Indicates the type of IBC packet event:
+   * - 'acknowledgementPacket': passive tap that communicates the result of an acknowledged packet
+   * - 'writeAcknowledgement': active tap where the receiver can return a write acknowledgement
+   */
+  event: 'acknowledgementPacket' | 'writeAcknowledgement';
+  acknowledgement: Bytes;
+  /**
+   * Use `JSON.parse(atob(packet.data))` to get a
+   * {@link FungibleTokenPacketData} object.
+   */
+  packet: IBCPacket;
+  relayer: string;
+  /** e.g. the chain address of the LocalChainAccount */
+  target: string;
+};