Testing

@usebutr/testing provides deterministic test doubles. Install it as a dev dependency:

npm install --save-dev @usebutr/testing

createFakeAdapter(options?): WalletAdapter

Every method resolves to a deterministic stub. Override individual methods after construction to inject failure modes.

import { createFakeAdapter } from "@usebutr/testing";

const adapter = createFakeAdapter({ id: "metamask" });
adapter.connect = () => Promise.reject(new Error("user rejected"));

FakeAdapterOptions

Stub returns include: getAccount() → first account or null; sendTx() → "0xfakehash"; signMessage(msg) → { signature: msg, signedMessage: msg }; getBalance() → { decimals: 18, formatted: "0", symbol: "ETH" | "SOL", value: 0n }; subscribe() → no-op unsubscribe.

Wire it through createConnector to test the store or React hooks:

const adapter = createFakeAdapter({ id: "fake" });
const config: WalletManagerConfig = {
  connectors: [{ id: "fake", name: "Fake", chainPlatform: "evm" }],
  createConnector: (id) => (id === "fake" ? adapter : null),
};

createFakePersistence(seed?): WalletPersistence

In-memory WalletPersistence mirroring WalletStorage's shape — no localStorage, no cookies. Reads/writes resolve synchronously (wrapped in Promise.resolve).

import { createFakePersistence } from "@usebutr/testing";

const persistence = createFakePersistence({
  activeConnectorId: "fake",
  pool: {
    fake: {
      account: seedAccount,
      accounts: [seedAccount],
      chainPlatform: "evm",
      connectorId: "fake",
    },
  },
  selection: { evm: "fake" },
  userDisconnected: true,
});

FakePersistenceSeed fields: pool, selection, activeConnectorId, userDisconnected. Pass it as the storage in WalletManagerConfig to test hydration and persistence without side effects. clearAll() resets everything.