Wallets

// The test fork as reset on 2026-09-29.
const pins = { 1: { blockNumber: 26_090_310n, blockHash: "0x1345c747eec5ea470112194686e42ab7b21b1397bbf23aace1962105c5b06864" } };

interface EvmWallet {
  readonly family: "evm";
  getAddress(): Promise<string>;
  getChainId(): Promise<number>;
  switchChain(chainId: number): Promise<void>; // throw WalletError("wrong-chain") if it cannot
  signTypedData(typedData: Eip712TypedData): Promise<string>; // eth_signTypedData_v4, domain/types/message VERBATIM
  signMessage(message: string): Promise<string>; // personal_sign
  sendTransaction(tx: { chainId: number; to: string; data: string; value: bigint }): Promise<string>;
  waitForReceipt(hash: string, options: { chainId: number; timeoutMs?: number; signal?: AbortSignal }): Promise<EvmReceipt>;
  call(request: { chainId: number; to: string; data: string }): Promise<string>; // eth_call
  getBlockTimestamp(chainId: number): Promise<bigint>; // the source chain's clock, for refunds
}

interface SolanaWallet {
  readonly family: "solana";
  getAddress(): Promise<string>; // base58
  signTransaction(transaction: Uint8Array): Promise<Uint8Array>; // wire bytes in, wire bytes out
  signMessage?(message: Uint8Array): Promise<Uint8Array>;
  sendTransaction?(signed: Uint8Array): Promise<string>;
  signAndSendTransaction?(transaction: Uint8Array): Promise<string>;
  confirmTransaction?(signature: string, options: { lastValidBlockHeight?: number; signal?: AbortSignal }): Promise<"confirmed" | "failed" | "expired">;
  getGenesisHash?(): Promise<string>;
}