Overview

The wallet adapter is the TypeScript layer that signs and installs a generated policy on a real Stellar smart account, then verifies the on-chain rule matches the synthesized spec.

It ships two adapter implementations and three orchestration helpers.

Adapters

Both implement the same WalletAdapter interface, which conforms to SEP-43:

interface WalletAdapter {
  isAvailable(): Promise<boolean>;
  getAddress(): Promise<string>;
  signTransaction(envelopeXdr: string, params: SignTransactionParams): Promise<SignTransactionResult>;
  signAuthEntry(authEntryXdr: string, params: SignAuthEntryParams): Promise<SignAuthEntryResult>;
}

SignTransactionParams.submit is restricted to false — submission is owned by installPolicy, never the wallet, so the simulate → sign → submit sequence stays auditable.

Orchestration helpers

• installPolicy — sign the install envelope, submit it, poll until landed, extract the assigned context_rule_id.
• verifyInstall — spawn the oz-policy-mcp subprocess and call verify_install. Returns drift items if the on-chain rule does not match the expected spec.
• makeOzSmartAccountAuthEncoder — produces the encoder callback that installPolicy uses to construct the OZ AuthPayload and bind context-rule ids into the signature.

Pinned versions

Errors

All adapter and orchestration errors implement a discriminated code: string field plus a detail: string. The codes are stable and documented per function.