@capxul/sdk-testing

Published, consumer-facing test support for @capxul/sdk. The package currently provides a narrow hermetic Safe-deployment surface; it is not a mirror of the SDK's internal test adapters or a general Capxul test harness.

Public surface

The root entry point exports exactly four symbols:

• InMemorySafeDeploymentAdapter
• InMemorySafeDeploymentLayer
• MismatchedAddressSafeDeploymentAdapter
• MismatchedAddressSafeDeploymentMode (type)

The in-memory adapter derives a deterministic Safe address and records deployment state without network access. The mismatched adapter deliberately returns inconsistent signer or Safe addresses so consumers can exercise invariant guards.

import { InMemorySafeDeploymentAdapter, InMemorySafeDeploymentLayer } from "@capxul/sdk-testing";

const adapter = new InMemorySafeDeploymentAdapter();
const layer = InMemorySafeDeploymentLayer();

Use the adapter directly when inspecting calls and deployment state. Use the Layer when providing SafeDeploymentPortTag to an Effect program.

Verify

vp run --filter @capxul/sdk-testing check-types
vp run --filter @capxul/sdk-testing test
vp run --filter @capxul/sdk-testing build

The package test currently proves barrel resolution only. Shared behavioral conformance with the SDK-internal Safe-deployment adapter is missing and tracked by #917; do not cite the barrel test as proof of behavioral equivalence.

See CONTEXT.md for boundaries, proof limits, dependencies, and the documentation update contract. Release history remains in CHANGELOG.md.