test support: ibc bridge mocks for @agoric/orchestration

[0xpatrickdev]

What is the Problem Being Solved?

In unit testing flows for @agoric/orchestration, the EchoConectionKit is used to mock network / ibc:

agoric-sdk/packages/orchestration/test/supports.ts

Line 107 in bc3bc6b

const { portAllocator } = fakeNetworkEchoStuff(rootZone.subZone('network'));

agoric-sdk/packages/orchestration/test/network-fakes.ts

Lines 98 to 108 in ad29545

	const makeNetworkProtocol = prepareNetworkProtocol(zone, vowTools);
	const makeEchoConnectionHandler = prepareEchoConnectionKit(zone);
	const makeProtocolHandler = prepareProtocolHandler(
	zone,
	makeEchoConnectionHandler,
	vowTools,
	);
	const protocol = makeNetworkProtocol(makeProtocolHandler());
	const makePortAllocator = preparePortAllocator(zone, vowTools);
	const portAllocator = makePortAllocator({ protocol });

This limits our ability to fully test contracts - we need to be able to simulate responses from a remote IBC Connection to see how a contract handles them.

In boot tests, we mocked some Bridge.DIBC events using responses for sim chains:

agoric-sdk/packages/boot/tools/supports.ts

Lines 358 to 406 in 42b2e7e

	case BridgeId.DIBC:
	switch (obj.type) {
	case 'IBC_METHOD':
	switch (obj.method) {
	case 'startChannelOpenInit':
	inbound(BridgeId.DIBC, icaMocks.channelOpenAck(obj));
	return undefined;
	case 'sendPacket':
	switch (obj.packet.data) {
	case protoMsgMocks.delegate.msg: {
	return makeAckEvent(obj, protoMsgMocks.delegate.ack);
	}
	case protoMsgMocks.delegateWithOpts.msg: {
	return makeAckEvent(
	obj,
	protoMsgMocks.delegateWithOpts.ack,
	);
	}
	case protoMsgMocks.queryBalance.msg: {
	return makeAckEvent(obj, protoMsgMocks.queryBalance.ack);
	}
	case protoMsgMocks.queryUnknownPath.msg: {
	return makeAckEvent(
	obj,
	protoMsgMocks.queryUnknownPath.ack,
	);
	}
	case protoMsgMocks.queryBalanceMulti.msg: {
	return makeAckEvent(
	obj,
	protoMsgMocks.queryBalanceMulti.ack,
	);
	}
	case protoMsgMocks.queryBalanceUnknownDenom.msg: {
	return makeAckEvent(
	obj,
	protoMsgMocks.queryBalanceUnknownDenom.ack,
	);
	}
	default: {
	return makeAckEvent(obj, protoMsgMocks.error.ack);
	}
	}
	default:
	return undefined;
	}
	default:
	return undefined;
	}

Description of the Design

Provide a similar entry point for IBC mocks in @agoric/orchestration unit testing.

Security Considerations

Scaling Considerations

Test Plan

Upgrade Considerations

[LuqiPan]

This limits our ability to fully test contracts - we need to be able to simulate responses from a remote IBC Connection to see how a contract handles them.

What kinds of IBC messages do we need to simulate responses for?

In boot tests, we mocked some Bridge.DIBC events using responses for sim chains:

Could we reuse the code from boot test to simulate responses?