# @usebutr/core (/api/core)



## Functions [#functions]

### `createWalletSource(subscribe): WalletSource` [#createwalletsourcesubscribe-walletsource]

```ts
import { createWalletSource } from "@usebutr/core";

const source = createWalletSource(discoverEvmAdapters);
// Pass as: <WalletManagerProvider discovery={source}>
```

Wraps a bare `(onAdapter: (adapter: WalletAdapter) => void) => () => void`
discoverer into a `WalletSource`. Use this when you want EVM-only or SVM-only
discovery without importing `@usebutr/wallets`:

```ts
import { createWalletSource } from "@usebutr/core";
import { discoverEvmAdapters } from "@usebutr/evm";
import { discoverSvmAdapters } from "@usebutr/svm";

const evmOnly = createWalletSource(discoverEvmAdapters);
const svmOnly = createWalletSource(discoverSvmAdapters);
```

`WalletSource` — the discovery seam — is `{ subscribe(onAdapter): () => void }`.

### `createWalletStore(config: WalletManagerConfig): WalletStore` [#createwalletstoreconfig-walletmanagerconfig-walletstore]

Creates the Zustand-backed wallet store. `@usebutr/react`'s provider wraps this;
call it directly only for non-React hosts.

### `mapConnectionError(raw: unknown): ConnectionError` [#mapconnectionerrorraw-unknown-connectionerror]

Normalises any thrown value into a tagged
[`ConnectionError`](/concepts/errors).

### `walletEqual(a: ConnectedWallet, b: ConnectedWallet): boolean` [#walletequala-connectedwallet-b-connectedwallet-boolean]

Identity comparison used by the async hooks (compares connector id + active
account address + chain id). Stable wallets don't re-trigger
`useSigner`/`useBalance`.

## Storage [#storage]

### `createBrowserStorageDriver(): StorageDriver` [#createbrowserstoragedriver-storagedriver]

`localStorage`-backed driver (the default).

### `createCookieStorageDriver(options: CookieDriverOptions): StorageDriver` [#createcookiestoragedriveroptions-cookiedriveroptions-storagedriver]

Cookie-backed driver. Options cover domain, path, `maxAgeSec`, `sameSite`,
`secure`.

### `createMemoryStorageDriver(): StorageDriver` [#creatememorystoragedriver-storagedriver]

In-memory driver — no persistence.

### `class WalletStorage` [#class-walletstorage]

The default `WalletPersistence` implementation. Construct with
`{ keyPrefix, persistent, session }` driver triple. See
[persistence](/concepts/persistence) and
[custom storage](/guides/custom-storage).

## Types [#types]

Store: `ConnectionStatus`, `WalletStore`, `WalletStoreState`.

Wallet model: `Account`, `Balance`, `ChainBase`, `ChainPlatform`,
`ConnectedWallet`, `Connector`, `ConnectorEvent`, `ConnectorMeta`, `Wallet`,
`WalletAdapter`, `WalletAvailability`, `WalletCapabilities`,
`WalletManagerConfig`, `HydrationOutcome`.

Errors: `ConnectionError`, `ConnectionErrorKind`.

Storage: `BrowserStorageDrivers`, `CookieDriverOptions`, `MaybePromise`,
`StorageDriver`, `StoredPoolEntry`, `StoredPoolRecord`,
`StoredSelectionRecord`, `WalletPersistence`.

Discovery seam: `WalletSource` — `{ subscribe(onAdapter): () => void }`.

## Key shapes [#key-shapes]

```ts
type WalletAdapter = Connector & Wallet;

type ConnectedWallet = {
  account: Account; // active account
  accounts: Array<Account>; // all exposed accounts (≥ 1)
  connector: WalletAdapter;
};

type Account = { chain: ChainBase; id: string; walletAddress: string };

type ChainBase = {
  id: string; // CAIP-2, e.g. "eip155:1"
  name: string;
  namespace: string; // "eip155" | "solana"
  reference: string; // "1" | "5eykt4Us…"
};

type Balance = {
  decimals: number;
  formatted: string;
  symbol: string;
  value: bigint;
};

type HydrationOutcome = {
  restoredIds: Array<string>;
  pendingIds: Array<string>;
  dropped: Array<{ connectorId: string; reason: unknown }>;
};
```

See [connectors and wallets](/concepts/connectors-and-wallets) for the
full `Connector` / `Wallet` / `WalletManagerConfig` definitions.

**Source:** `packages/core/src/index.ts`.