Migrate to the wallet manager

This release is breaking for every @usebutr/* package. It does four things:

• An adapter method exists only when it works. capabilities is gone; check the method instead.
• One sendTx with options replaces sendTx and sendTxToChain, and every method takes an options object.
• createWalletManager owns discovery, hydration and persistence. The React provider only binds it.
• Signers are a tagged union. getSigner() resolves { kind, … }, so no casts are needed.

The reasoning is in ADR 0004.

Provider and discovery

// Before
const discovery = autoDiscovery();
<WalletManagerProvider
  discovery={discovery}
  connectors={[{ id: wc.id, name: wc.name, chainPlatform: wc.chainPlatform }]}
  createConnector={(id) => extra.get(id) ?? null}
  storageKeyPrefix="my-app"
  onConnect={track}
>
  {children}
</WalletManagerProvider>;

// After
import type { WalletManagerConfig } from "@usebutr/core";
import { fromAdapters } from "@usebutr/core";

const config: WalletManagerConfig = {
  onConnect: track,
  sources: [autoDiscovery(), fromAdapters(createWalletConnectAdapters({ … }))],
  storageKeyPrefix: "my-app",
};

<WalletManagerProvider config={config}>{children}</WalletManagerProvider>;

setAccount(id, account) selects an account already exposed by the wallet. It preserves every account's chain and ignores unknown accounts. To change networks, call the adapter's switchChain; the adapter reports the resulting accounts through its events.

Hooks

Adapters

Capabilities are gone: check for the method.

// Before
if (wallet.connector.capabilities.signMessage) {
  await wallet.connector.signMessage(bytes, account);
}

// After
if (wallet.connector.signMessage) {
  await wallet.connector.signMessage(bytes, { account });
}

An account the wallet does not expose now rejects instead of silently signing with the first account. chain.name is now always the chain's name, never the wallet's.

Signers

// Before
const provider = (await wallet.connector.getSigner()) as EIP1193Provider;

// After
const signer = await wallet.connector.getSigner();
if (signer.kind === "eip1193") {
  createWalletClient({ transport: custom(signer.provider) });
}

SignerForPlatform and SignerOf are replaced by WalletSigner and WalletSignerOf<"eip1193">.

Errors

ConnectionError is now a class extending Error, with the same kind and message plus a standard cause. useConnect().connectAsync() and useWalletManager().connect() reject with it directly; useConnect().connect() never rejects and puts it in error. mapConnectionError(raw) is toConnectionError(raw). The new kind WalletNotFound covers an id no source announced.

Custom persistence

WalletPersistence shrinks from eleven methods to two. The manager derives the whole persisted state after every change, so an implementation never merges or diffs.

const storage: WalletPersistence = {
  load: async () => JSON.parse((await kv.get("wallets")) ?? "null") ?? EMPTY,
  save: async (state) => {
    await kv.set("wallets", JSON.stringify(state));
  },
};

new WalletStorage({ keyPrefix, persistent, session }) is now createWalletStorage({ keyPrefix, persistent, session }). The storage keys are unchanged, so existing sessions and readWalletSnapshot keep working.

Testing

createFakeAdapter({ chainPlatform }) builds a realistic adapter for that platform, with the methods that platform has. The capabilities option is replaced by overrides (replace members) and omit (leave optional members off). getSigner() resolves the new signer option, any WalletSigner, and rejects without one; the package registers no signer kind of its own. createFakeConnectedWallet takes the adapter options instead of an adapter, and createFakePersistence(seed) takes a Partial<PersistedWalletState> (isUserDisconnected, not userDisconnected) and records every save in saves. See Testing.