@agoric/orchestration 0.1.1-dev-acbb5da.0 → 0.1.1-dev-5fb1074.0

package/src/facade.js

@@ -2,15 +2,14 @@
 import { assertAllDefined, deepMapObject } from '@agoric/internal';
 
 /**
- * @import {AsyncFlowTools, GuestInterface, HostArgs, HostOf} from '@agoric/async-flow';
+ * @import {AsyncFlowTools, GuestInterface, HostArgs} from '@agoric/async-flow';
  * @import {Zone} from '@agoric/zone';
  * @import {Vow, VowTools} from '@agoric/vow';
  * @import {TimerService} from '@agoric/time';
- * @import {RecorderKit, MakeRecorderKit} from '@agoric/zoe/src/contractSupport/recorder.js'.
  * @import {HostOrchestrator} from './exos/orchestrator.js';
  * @import {Remote} from '@agoric/internal';
  * @import {CosmosInterchainService} from './exos/exo-interfaces.js';
- * @import {Chain, ChainInfo, CosmosChainInfo, IBCConnectionInfo, OrchestrationAccount, OrchestrationFlow, Orchestrator} from './types.js';
+ * @import {OrchestrationFlow, Orchestrator} from './types.js';
  */
 
 /**
@@ -31,9 +30,7 @@ import { assertAllDefined, deepMapObject } from '@agoric/internal';
  *   zone: Zone;
  *   timerService: Remote<TimerService>;
  *   zcf: ZCF;
- *   storageNode: Remote<StorageNode>;
  *   orchestrationService: Remote<CosmosInterchainService>;
- *   makeRecorderKit: MakeRecorderKit;
  *   makeOrchestrator: () => HostOrchestrator;
  *   vowTools: VowTools;
  *   asyncFlowTools: AsyncFlowTools;
@@ -43,9 +40,7 @@ export const makeOrchestrationFacade = ({
   zone,
   timerService,
   zcf,
-  storageNode,
   orchestrationService,
-  makeRecorderKit,
   makeOrchestrator,
   vowTools,
   asyncFlowTools,
@@ -54,9 +49,7 @@ export const makeOrchestrationFacade = ({
     zone,
     timerService,
     zcf,
-    storageNode,
     orchestrationService,
-    makeRecorderKit,
     makeOrchestrator,
     vowTools,
     asyncFlowTools,

package/src/fixtures/query-flows.contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-flows.contract.d.ts","sourceRoot":"","sources":["query-flows.contract.js"],"names":[],"mappings":"AAkEA;gBAjDiB,UAAU;;;;;;;;;;;;;;;;;;GAiDsB;2BAGnC,OAAO,KAAK;yCA3DY,2BAA2B"}
+{"version":3,"file":"query-flows.contract.d.ts","sourceRoot":"","sources":["query-flows.contract.js"],"names":[],"mappings":"AAkEA;gBAjDiB,UAAU;;;;;;;;;;;;;;;;;;GAiDoD;2BAGjE,OAAO,KAAK;yCA3DY,2BAA2B"}

package/src/fixtures/query-flows.contract.js

@@ -64,7 +64,7 @@ const contract = async (zcf, _privateArgs, zone, { orchestrateAll }) => {
   return { publicFacet };
 };
 
-export const start = withOrchestration(contract);
+export const start = withOrchestration(contract, { publishAccountInfo: true });
 harden(start);
 
 /** @typedef {typeof start} QueryFlowsSF */

package/src/utils/start-helper.d.ts

@@ -69,14 +69,22 @@ export function provideOrchestration(zcf: ZCF, baggage: Baggage, remotePowers: O
 };
 export function withOrchestration<CT extends Record<string, unknown>, PA extends OrchestrationPowers & {
     marshaller: Marshaller;
-}, R>(contractFn: (zcf: ZCF<CT>, privateArgs: PA, zone: Zone, tools: OrchestrationTools) => Promise<R>): (zcf: ZCF<CT>, privateArgs: PA, baggage: Baggage) => Promise<R>;
+}, R>(contractFn: (zcf: ZCF<CT>, privateArgs: PA, zone: Zone, tools: OrchestrationTools) => Promise<R>, opts?: WithOrchestrationOpts): (zcf: ZCF<CT>, privateArgs: PA, baggage: Baggage) => Promise<R>;
 export type OrchestrationPowers = {
     localchain: Remote<LocalChain>;
     orchestrationService: Remote<CosmosInterchainService>;
-    storageNode: Remote<StorageNode>;
+    storageNode?: Remote<StorageNode>;
     timerService: Remote<TimerService>;
     agoricNames: Remote<NameHub>;
 };
+export type WithOrchestrationOpts = {
+    /**
+     * - Controls whether account
+     * information (address, channel identifiers for ICAs) should be automatically
+     * published to vstorage
+     */
+    publishAccountInfo?: boolean | undefined;
+};
 export type OrchestrationTools = Omit<ReturnType<typeof provideOrchestration>, "zone">;
 import type { Baggage } from '@agoric/vat-data';
 import type { Zone } from '@agoric/zone';

package/src/utils/start-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-helper.d.ts","sourceRoot":"","sources":["start-helper.js"],"names":[],"mappings":"AA8CO,0CANI,GAAG,WACH,OAAO,gBACP,mBAAmB,cACnB,UAAU;+BAiGR,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;sBA/BS,CAAC;;;;;;;;;;;;;;;;;;;;;sBA0G09Y,CAAC;;;;;;;;;;;;;;;;;;;;EAzCr/Y;AA8BM,kCAdgC,EAAE,SAA3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAE,EAGhC,EAAE,SAFM,mBAAmB,GAAG;IAC/B,UAAU,EAAE,UAAU,CAAC;CACvB,EACQ,CAAC,cACH,CACN,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EACZ,WAAW,EAAE,EAAE,EACf,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,kBAAkB,KACtB,OAAO,CAAC,CAAC,CAAC,GACL,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAYzE;kCA5LU;IACR,UAAU,EAAE,OAAO,UAAU,CAAC,CAAC;IAC/B,oBAAoB,EAAE,OAAO,uBAAuB,CAAC,CAAC;IACtD,WAAW,EAAE,OAAO,WAAW,CAAC,CAAC;IACjC,YAAY,EAAE,OAAO,YAAY,CAAC,CAAC;IACnC,WAAW,EAAE,OAAO,OAAO,CAAC,CAAC;CAC9B;iCAkJU,IAAI,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,EAAE,MAAM,CAAC;6BAhKzC,kBAAkB;0BAGrB,cAAc;gCALR,gCAAgC;4BAIpC,aAAa;6CAEI,2BAA2B;kCAL1B,cAAc;6BAE/B,cAAc"}
+{"version":3,"file":"start-helper.d.ts","sourceRoot":"","sources":["start-helper.js"],"names":[],"mappings":"AAqDO,0CANI,GAAG,WACH,OAAO,gBACP,mBAAmB,cACnB,UAAU;+BAiGR,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;sBA1CD,CAAC;;;;;;;;;;;;;;;;;;;;;sBAuHykY,CAAC;;;;;;;;;;;;;;;;;;;;EA5C1lY;AA+BM,kCAfgC,EAAE,SAA3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAE,EAGhC,EAAE,SAFM,mBAAmB,GAAG;IAC/B,UAAU,EAAE,UAAU,CAAC;CACvB,EACQ,CAAC,cACH,CACN,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EACZ,WAAW,EAAE,EAAE,EACf,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,kBAAkB,KACtB,OAAO,CAAC,CAAC,CAAC,SACP,qBAAqB,GACnB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAczE;kCArMU;IACR,UAAU,EAAE,OAAO,UAAU,CAAC,CAAC;IAC/B,oBAAoB,EAAE,OAAO,uBAAuB,CAAC,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC,CAAC;IAClC,YAAY,EAAE,OAAO,YAAY,CAAC,CAAC;IACnC,WAAW,EAAE,OAAO,OAAO,CAAC,CAAC;CAC9B;;;;;;;;;iCAwJU,IAAI,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,EAAE,MAAM,CAAC;6BAtKzC,kBAAkB;0BAGrB,cAAc;gCALR,gCAAgC;4BAIpC,aAAa;6CAEI,2BAA2B;kCALtC,cAAc;6BAEnB,cAAc"}

package/src/utils/start-helper.js

@@ -14,7 +14,7 @@ import { makeZcfTools } from './zcf-tools.js';
 
 /**
  * @import {LocalChain} from '@agoric/vats/src/localchain.js';
- * @import {TimerService, TimerBrand} from '@agoric/time';
+ * @import {TimerService} from '@agoric/time';
  * @import {Baggage} from '@agoric/vat-data';
  * @import {NameHub} from '@agoric/vats';
  * @import {Remote} from '@agoric/vow';
@@ -26,12 +26,19 @@ import { makeZcfTools } from './zcf-tools.js';
  * @typedef {{
  *   localchain: Remote<LocalChain>;
  *   orchestrationService: Remote<CosmosInterchainService>;
- *   storageNode: Remote<StorageNode>;
+ *   storageNode?: Remote<StorageNode>;
  *   timerService: Remote<TimerService>;
  *   agoricNames: Remote<NameHub>;
  * }} OrchestrationPowers
  */
 
+/**
+ * @typedef {object} WithOrchestrationOpts
+ * @property {boolean} [publishAccountInfo] - Controls whether account
+ *   information (address, channel identifiers for ICAs) should be automatically
+ *   published to vstorage
+ */
+
 /**
  * Helper that a contract start function can use to set up the objects needed
  * for orchestration.
@@ -144,7 +151,6 @@ export const provideOrchestration = (
     makeOrchestrationFacade({
       zone,
       zcf,
-      makeRecorderKit,
       makeOrchestrator,
       asyncFlowTools,
       vowTools,
@@ -199,16 +205,19 @@ harden(provideOrchestration);
  *   zone: Zone,
  *   tools: OrchestrationTools,
  * ) => Promise<R>} contractFn
+ * @param {WithOrchestrationOpts} [opts]
  * @returns {(zcf: ZCF<CT>, privateArgs: PA, baggage: Baggage) => Promise<R>} a
  *   Zoe start function
  */
 export const withOrchestration =
-  contractFn => async (zcf, privateArgs, baggage) => {
+  (contractFn, opts) => async (zcf, privateArgs, baggage) => {
+    const { marshaller, ...allOrchPowers } = privateArgs;
+    const { storageNode: _, ...requiredOrchPowers } = allOrchPowers;
     const { zone, ...tools } = provideOrchestration(
       zcf,
       baggage,
-      privateArgs,
-      privateArgs.marshaller,
+      opts?.publishAccountInfo ? allOrchPowers : requiredOrchPowers,
+      marshaller,
     );
     return contractFn(zcf, privateArgs, zone, tools);
   };

package/tools/ibc-mocks.d.ts

@@ -0,0 +1,116 @@
+/** @file Tools to support making IBC mocks */
+import { type JsonSafe } from '@agoric/cosmic-proto';
+import { TxBody } from '@agoric/cosmic-proto/cosmos/tx/v1beta1/tx.js';
+import { Any } from '@agoric/cosmic-proto/google/protobuf/any.js';
+import type { PacketSDKType } from '@agoric/cosmic-proto/ibc/core/channel/v1/channel.js';
+import { RequestQuery, ResponseQuery } from '@agoric/cosmic-proto/tendermint/abci/types.js';
+import type { IBCChannelID, IBCEvent, VTransferIBCEvent } from '@agoric/vats';
+import type { ChainAddress } from '../src/orchestration-api.js';
+interface EncoderCommon<T> {
+    encode: (message: T) => {
+        finish: () => Uint8Array;
+    };
+    fromPartial: (partial: Partial<T>) => T;
+    typeUrl: string;
+}
+/**
+ * Build a response "packet bytes string" we'd expect to see from a Msg
+ * Response
+ *
+ * XXX support multiple responses in a single message
+ *
+ * @param Encoder
+ * @param message
+ */
+export declare function buildMsgResponseString<T>(Encoder: EncoderCommon<T>, message: Partial<T>): string;
+/**
+ * Build an example error packet for a failed Tx Msg
+ * @param msg
+ */
+export declare function buildMsgErrorString(msg?: string): string;
+/**
+ * Build a response "packet bytes string" we'd expect to see from a Query
+ * request
+ *
+ * XXX accept multiple queries at once
+ *
+ * @param Encoder
+ * @param query
+ * @param opts
+ */
+export declare function buildQueryResponseString<T>(Encoder: EncoderCommon<T>, query: Partial<T>, opts?: Omit<ResponseQuery, 'key'>): string;
+/**
+ * Build a tx packet string for the mocked dibc bridge handler
+ * @param msgs
+ * @returns {string}
+ */
+export declare function buildTxPacketString(msgs: {
+    value: Uint8Array;
+    typeUrl: string;
+}[]): string;
+/**
+ * Parse an outgoing ica tx packet. Useful for testing when inspecting
+ * outgoing dibc bridge messages.
+ *
+ * @param b64 base64 encoded string
+ */
+export declare const parseOutgoingTxPacket: (b64: string) => TxBody;
+/**
+ * Build a query packet string for the mocked dibc bridge handler
+ * @param msgs
+ * @param opts
+ * @returns {string}
+ */
+export declare function buildQueryPacketString(msgs: Any[], opts?: Partial<Omit<RequestQuery, 'path' | 'data'>>): string;
+type BuildVTransferEventParams = {
+    event?: VTransferIBCEvent['event'];
+    sender?: ChainAddress['value'];
+    receiver?: ChainAddress['value'];
+    target?: ChainAddress['value'];
+    amount?: bigint;
+    denom?: string;
+    destinationChannel?: IBCChannelID;
+    sourceChannel?: IBCChannelID;
+    sequence?: PacketSDKType['sequence'] | JsonSafe<PacketSDKType['sequence']>;
+};
+/**
+ * `buildVTransferEvent` can be used with `transferBridge` to simulate incoming
+ * and outgoing IBC fungible tokens transfers to a LocalChain account.
+ *
+ * It defaults to simulating incoming transfers. To simulate an outgoing one,
+ * ensure `sender=agoric1fakeLCAAddress` and  this after LocalChainBridge
+ * receives the outgoing MsgTransfer,
+ *
+ * @example
+ * ```js
+ * const { mocks: { transferBridge } = await commonSetup(t);
+ * await E(transferBridge).fromBridge(
+ *  buildVTransferEvent({
+ *    receiver: 'agoric1fakeLCAAddress',
+ *    amount: 10n,
+ *    denom: 'uatom',
+ *  }),
+ * );
+ * ```
+ *
+ * XXX integrate vlocalchain and vtransfer ScopedBridgeManagers
+ * in test supports.
+ *
+ * @param {{BuildVTransferEventParams}} args
+ */
+export declare const buildVTransferEvent: ({ event, sender, receiver, target, amount, denom, destinationChannel, sourceChannel, sequence, }?: BuildVTransferEventParams) => VTransferIBCEvent;
+export declare function createMockAckMap(mockMap: Record<string, {
+    msg: string;
+    ack: string;
+}>): {};
+/**
+ * Simulate an IBC channelCloseConfirm event. This can be used to simulate an
+ * ICA channel closing for an unexpected reason from a remote chain, _or
+ * anything besides the Connection holder calling `.close()`_. If `close()` is
+ * called, we'd instead expect to see a Downcall for channelCloseInit.
+ *
+ * @param {Pick<IBCEvent<'channelCloseConfirm'>, 'portID' | 'channelID'>} event
+ */
+export declare const buildChannelCloseConfirmEvent: ({ channelID, portID, }?: Partial<IBCEvent<"channelCloseConfirm">>) => Partial<IBCEvent<"channelCloseConfirm">>;
+export {};
+//# sourceMappingURL=ibc-mocks.d.ts.map

package/tools/ibc-mocks.d.ts.map

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

package/tools/ibc-mocks.ts

@@ -0,0 +1,262 @@
+/** @file Tools to support making IBC mocks */
+import { type JsonSafe, toRequestQueryJson } from '@agoric/cosmic-proto';
+import { TxBody } from '@agoric/cosmic-proto/cosmos/tx/v1beta1/tx.js';
+import { Any } from '@agoric/cosmic-proto/google/protobuf/any.js';
+import { FungibleTokenPacketData } from '@agoric/cosmic-proto/ibc/applications/transfer/v2/packet.js';
+import type { PacketSDKType } from '@agoric/cosmic-proto/ibc/core/channel/v1/channel.js';
+import { CosmosResponse } from '@agoric/cosmic-proto/icq/v1/packet.js';
+import {
+  RequestQuery,
+  ResponseQuery,
+} from '@agoric/cosmic-proto/tendermint/abci/types.js';
+import {
+  IBC_EVENT,
+  VTRANSFER_IBC_EVENT,
+} from '@agoric/internal/src/action-types.js';
+import type {
+  IBCChannelID,
+  IBCEvent,
+  IBCPacket,
+  VTransferIBCEvent,
+} from '@agoric/vats';
+import { LOCALCHAIN_DEFAULT_ADDRESS } from '@agoric/vats/tools/fake-bridge.js';
+import { atob, btoa, decodeBase64, encodeBase64 } from '@endo/base64';
+import type { ChainAddress } from '../src/orchestration-api.js';
+import { makeQueryPacket, makeTxPacket } from '../src/utils/packet.js';
+
+interface EncoderCommon<T> {
+  encode: (message: T) => {
+    finish: () => Uint8Array;
+  };
+  fromPartial: (partial: Partial<T>) => T;
+  typeUrl: string;
+}
+
+const toPacket = (obj: Record<string, any>): string =>
+  btoa(JSON.stringify(obj));
+
+/**
+ * Build a response "packet bytes string" we'd expect to see from a Msg
+ * Response
+ *
+ * XXX support multiple responses in a single message
+ *
+ * @param Encoder
+ * @param message
+ */
+export function buildMsgResponseString<T>(
+  Encoder: EncoderCommon<T>,
+  message: Partial<T>,
+): string {
+  const encodedMsg = Encoder.encode(Encoder.fromPartial(message)).finish();
+
+  // cosmos-sdk double Any encodes
+  const encodedAny = Any.encode(
+    Any.fromPartial({
+      value: Any.encode(
+        Any.fromPartial({
+          typeUrl: Encoder.typeUrl,
+          value: encodedMsg,
+        }),
+      ).finish(),
+    }),
+  ).finish();
+
+  return toPacket({
+    result: encodeBase64(encodedAny),
+  });
+}
+
+/**
+ * Build an example error packet for a failed Tx Msg
+ * @param msg
+ */
+export function buildMsgErrorString(
+  msg = 'ABCI code: 5: error handling packet: see events for details',
+): string {
+  return toPacket({
+    error: msg,
+  });
+}
+
+/**
+ * Build a response "packet bytes string" we'd expect to see from a Query
+ * request
+ *
+ * XXX accept multiple queries at once
+ *
+ * @param Encoder
+ * @param query
+ * @param opts
+ */
+export function buildQueryResponseString<T>(
+  Encoder: EncoderCommon<T>,
+  query: Partial<T>,
+  opts: Omit<ResponseQuery, 'key'> = {
+    value: new Uint8Array(),
+    height: 0n,
+    index: 0n,
+    code: 0,
+    log: '',
+    info: '',
+    codespace: '',
+  },
+): string {
+  const encodedResp = CosmosResponse.encode(
+    CosmosResponse.fromPartial({
+      responses: [
+        {
+          key: Encoder.encode(Encoder.fromPartial(query)).finish(),
+          ...opts,
+        },
+      ],
+    }),
+  ).finish();
+
+  return toPacket({
+    result: toPacket({ data: encodeBase64(encodedResp) }),
+  });
+}
+
+/**
+ * Build a tx packet string for the mocked dibc bridge handler
+ * @param msgs
+ * @returns {string}
+ */
+export function buildTxPacketString(
+  msgs: { value: Uint8Array; typeUrl: string }[],
+): string {
+  return btoa(makeTxPacket(msgs.map(Any.toJSON)));
+}
+
+/**
+ * Parse an outgoing ica tx packet. Useful for testing when inspecting
+ * outgoing dibc bridge messages.
+ *
+ * @param b64 base64 encoded string
+ */
+export const parseOutgoingTxPacket = (b64: string) => {
+  return TxBody.decode(decodeBase64(JSON.parse(atob(b64)).data));
+};
+
+/**
+ * Build a query packet string for the mocked dibc bridge handler
+ * @param msgs
+ * @param opts
+ * @returns {string}
+ */
+export function buildQueryPacketString(
+  msgs: Any[],
+  opts: Partial<Omit<RequestQuery, 'path' | 'data'>> = {},
+): string {
+  return btoa(makeQueryPacket(msgs.map(msg => toRequestQueryJson(msg, opts))));
+}
+
+type BuildVTransferEventParams = {
+  event?: VTransferIBCEvent['event'];
+  /* defaults to cosmos1AccAddress. set to `agoric1fakeLCAAddress` to simulate an outgoing transfer event */
+  sender?: ChainAddress['value'];
+  /*  defaults to agoric1fakeLCAAddress. set to a different value to simulate an outgoing transfer event */
+  receiver?: ChainAddress['value'];
+  target?: ChainAddress['value'];
+  amount?: bigint;
+  denom?: string;
+  destinationChannel?: IBCChannelID;
+  sourceChannel?: IBCChannelID;
+  /* support bigint and string, to facilitate bootstrap testing */
+  sequence?: PacketSDKType['sequence'] | JsonSafe<PacketSDKType['sequence']>;
+};
+
+/**
+ * `buildVTransferEvent` can be used with `transferBridge` to simulate incoming
+ * and outgoing IBC fungible tokens transfers to a LocalChain account.
+ *
+ * It defaults to simulating incoming transfers. To simulate an outgoing one,
+ * ensure `sender=agoric1fakeLCAAddress` and  this after LocalChainBridge
+ * receives the outgoing MsgTransfer,
+ *
+ * @example
+ * ```js
+ * const { mocks: { transferBridge } = await commonSetup(t);
+ * await E(transferBridge).fromBridge(
+ *  buildVTransferEvent({
+ *    receiver: 'agoric1fakeLCAAddress',
+ *    amount: 10n,
+ *    denom: 'uatom',
+ *  }),
+ * );
+ * ```
+ *
+ * XXX integrate vlocalchain and vtransfer ScopedBridgeManagers
+ * in test supports.
+ *
+ * @param {{BuildVTransferEventParams}} args
+ */
+export const buildVTransferEvent = ({
+  event = 'acknowledgementPacket' as const,
+  sender = 'cosmos1AccAddress',
+  receiver = LOCALCHAIN_DEFAULT_ADDRESS,
+  target = LOCALCHAIN_DEFAULT_ADDRESS,
+  amount = 10n,
+  denom = 'uatom',
+  destinationChannel = 'channel-0' as IBCChannelID,
+  sourceChannel = 'channel-405' as IBCChannelID,
+  sequence = 0n,
+}: BuildVTransferEventParams = {}): VTransferIBCEvent => ({
+  type: VTRANSFER_IBC_EVENT,
+  blockHeight: 0,
+  blockTime: 0,
+  event,
+  acknowledgement: btoa(JSON.stringify({ result: 'AQ==' })),
+  relayer: 'agoric123',
+  target,
+  packet: {
+    data: btoa(
+      JSON.stringify(
+        FungibleTokenPacketData.fromPartial({
+          amount: String(amount),
+          denom,
+          sender,
+          receiver,
+        }),
+      ),
+    ),
+    destination_channel: destinationChannel,
+    source_channel: sourceChannel,
+    destination_port: 'transfer',
+    source_port: 'transfer',
+    sequence,
+  } as IBCPacket,
+});
+
+export function createMockAckMap(
+  mockMap: Record<string, { msg: string; ack: string }>,
+) {
+  const res = Object.values(mockMap).reduce((acc, { msg, ack }) => {
+    acc[msg] = ack;
+    return acc;
+  }, {});
+  return res;
+}
+
+/**
+ * Simulate an IBC channelCloseConfirm event. This can be used to simulate an
+ * ICA channel closing for an unexpected reason from a remote chain, _or
+ * anything besides the Connection holder calling `.close()`_. If `close()` is
+ * called, we'd instead expect to see a Downcall for channelCloseInit.
+ *
+ * @param {Pick<IBCEvent<'channelCloseConfirm'>, 'portID' | 'channelID'>} event
+ */
+export const buildChannelCloseConfirmEvent = ({
+  channelID = 'channel-0',
+  portID = 'icacontroller-1',
+}: Partial<IBCEvent<'channelCloseConfirm'>> = {}): Partial<
+  IBCEvent<'channelCloseConfirm'>
+> => ({
+  blockHeight: 0,
+  blockTime: 0,
+  channelID,
+  event: 'channelCloseConfirm',
+  portID,
+  type: IBC_EVENT,
+});

package/tools/make-test-address.d.ts

@@ -0,0 +1,2 @@
+export function makeTestAddress(index?: number, prefix?: string, byteLength?: number): string;
+//# sourceMappingURL=make-test-address.d.ts.map

package/tools/make-test-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-test-address.d.ts","sourceRoot":"","sources":["make-test-address.js"],"names":[],"mappings":"AASO,wCALI,MAAM,WACN,MAAM,eACN,MAAM,GACJ,MAAM,CAalB"}

package/tools/make-test-address.js

@@ -0,0 +1,21 @@
+// eslint-disable-next-line import/no-extraneous-dependencies
+import { bech32 } from 'bech32';
+
+/**
+ * @param {number} index
+ * @param {string} prefix
+ * @param {number} byteLength
+ * @returns {string} a mock bech32 address for tests
+ */
+export const makeTestAddress = (
+  index = 0,
+  prefix = 'agoric',
+  byteLength = 20,
+) => {
+  // create a simple 20-byte array (common address length)
+  const bytes = new Uint8Array(byteLength).fill(0);
+  // if index provided, put it in the first byte
+  if (index !== 0) bytes[0] = Number(index);
+  const words = bech32.toWords(bytes);
+  return bech32.encode(prefix, words);
+};

package/tools/protobuf-decoder.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Decodes a protobuf message from the given buffer.
+ *
+ * @param {Buffer} buffer
+ */
+export function decodeProtobuf(buffer: Buffer): {
+    value: {};
+    bytesRead: number;
+};
+/**
+ * Decodes a protobuf message from the given base64-encoded data.
+ *
+ * @param {string} base64String
+ */
+export function decodeProtobufBase64(base64String: string): {
+    value: {};
+    bytesRead: number;
+};
+//# sourceMappingURL=protobuf-decoder.d.ts.map

package/tools/protobuf-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf-decoder.d.ts","sourceRoot":"","sources":["protobuf-decoder.js"],"names":[],"mappings":"AA8HA;;;;GAIG;AACH,uCAFW,MAAM;;;EAchB;AACD;;;;GAIG;AACH,mDAFW,MAAM;;;EAKhB"}