@multiplatform.one/web3 7.25.0 → 7.26.0

package/types/core/family.d.ts

@@ -0,0 +1,44 @@
+import type { ScreenDef } from "@multiplatform.one/connectkit";
+import type { ComponentType, ReactNode } from "react";
+import { type WalletMessageRegistry, type WalletMessageSpec } from "./message";
+import type { ConnectionDriver } from "./types";
+/** What a family package hands the core: `eth({chains})`, `sol({rpcUrl})`, `gpg()`. */
+export interface WalletFamilyDefinition {
+    /** Short family id, the one the Keycloak message names: `eth`, `sol`, `sui`, `btc`, `gpg`. */
+    readonly id: string;
+    readonly label: string;
+    /** Other names callers use for the family, such as the ecosystem name `evm` for `eth`. */
+    readonly aliases?: readonly string[];
+    readonly message: WalletMessageSpec;
+    /**
+     * Makes the family's connection driver. The store calls it once, the first
+     * time it needs the family, so a family nobody touches starts nothing.
+     */
+    readonly driver?: () => ConnectionDriver;
+    /** Signs without a wallet connection (GPG). Such a family has no driver. */
+    readonly connectionless?: boolean;
+    /** Modal screens the family contributes. */
+    readonly screens?: readonly ScreenDef[];
+    /** A provider the family needs mounted around the app. */
+    readonly Provider?: ComponentType<{
+        children?: ReactNode;
+    }>;
+}
+export interface WalletFamily extends WalletFamilyDefinition {
+    readonly aliases: readonly string[];
+    readonly connectionless: boolean;
+}
+/** Validates a family definition and freezes it. */
+export declare function defineWalletFamily(definition: WalletFamilyDefinition): WalletFamily;
+export interface FamilyRegistry {
+    /** In the order the app listed them, which is the connect list's order. */
+    readonly families: readonly WalletFamily[];
+    /** The family for an id or alias, or undefined. */
+    get(family: string): WalletFamily | undefined;
+    /** The family for an id or alias. Throws naming the registered families. */
+    require(family: string): WalletFamily;
+    readonly messages: WalletMessageRegistry;
+}
+/** The families one app registered. Refuses a family, id or alias registered twice. */
+export declare function createFamilyRegistry(families: readonly WalletFamily[]): FamilyRegistry;
+//# sourceMappingURL=family.d.ts.map

package/types/core/family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family.d.ts","sourceRoot":"","sources":["../../src/core/family.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,uFAAuF;AACvF,MAAM,WAAW,sBAAsB;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,gBAAgB,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,YAAa,SAAQ,sBAAsB;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,CA8BnF;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,mDAAmD;IACnD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9C,4EAA4E;IAC5E,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;CAC1C;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,CAsBtF"}

package/types/core/index.d.ts

@@ -0,0 +1,7 @@
+export { createFamilyRegistry, defineWalletFamily, type FamilyRegistry, type WalletFamily, type WalletFamilyDefinition, } from "./family";
+export { createMessageRegistry, formatWalletMessage, type MessageFamily, type WalletMessageRegistry, type WalletMessageSpec, } from "./message";
+export { createConnectionStore, defaultConnectionStorageKey, type ConnectionStore, type ConnectionStoreOptions, type FamilyConnector, } from "./store";
+export { ConnectionProvider, useConnection, useConnectionStore, type ConnectionProviderProps, } from "./react";
+export type { ConnectionDriver, ConnectionState, ConnectionStatus, ConnectionStorage, DriverAccount, DriverConnectOptions, DriverState, SavedConnection, WalletConnector, } from "./types";
+export { UnsupportedClientMethodError, type ChainClient, type ClientCapability, type ClientFamily, } from "../clients/types";
+//# sourceMappingURL=index.d.ts.map

package/types/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,sBAAsB,GAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,4BAA4B,EAC5B,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC"}

package/types/core/message.d.ts

@@ -0,0 +1,44 @@
+import type { WalletMessageOptions } from "../message/buildWalletMessage";
+/**
+ * How one family's sign-in message differs from the shared envelope. A family
+ * package defines its spec; the envelope (domain line, statement, URI, Version,
+ * Chain ID, Nonce, Issued At) is the same bytes the Keycloak verifiers parse.
+ */
+export interface WalletMessageSpec {
+    /** First-line text after the domain, which the verifiers content-sniff. */
+    readonly header: string;
+    /** Default statement. Null means none. */
+    readonly statement: string | null;
+    /** The `Chain ID:` value when the caller gives none. Null omits the line. */
+    readonly chainId: string | null;
+    /** Whether the message names the signer's address. GPG's identity is its key. Default true. */
+    readonly address?: boolean;
+    /**
+     * Honour a numeric `chainId` option. Only EVM chain ids are numbers; elsewhere
+     * a number is a connector's synthetic id and is ignored.
+     */
+    readonly numericChainId?: boolean;
+    /** EIP-4361 keeps an empty line where an omitted statement would be. */
+    readonly keepStatementLine?: boolean;
+    /** Canonical address form, such as EIP-55 for EVM. */
+    readonly normalizeAddress?: (address: string) => string;
+}
+export interface MessageFamily {
+    readonly id: string;
+    readonly aliases?: readonly string[];
+    readonly message: WalletMessageSpec;
+}
+export interface WalletMessageRegistry {
+    /** Registered family ids, in registration order. */
+    readonly families: readonly string[];
+    /** The family id for an id or alias, or undefined. */
+    resolve(family: string): string | undefined;
+    spec(family: string): WalletMessageSpec | undefined;
+    /** Builds the sign-in message. Throws for a family nobody registered. */
+    build(family: string, opts: WalletMessageOptions): string;
+}
+/** Builds one sign-in message from a family spec. `family` only names the family in errors. */
+export declare function formatWalletMessage(spec: WalletMessageSpec, opts: WalletMessageOptions, family?: string): string;
+/** The message half of the family registry: family id or alias to spec. */
+export declare function createMessageRegistry(families: Iterable<MessageFamily>): WalletMessageRegistry;
+//# sourceMappingURL=message.d.ts.map

package/types/core/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/core/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAG1E;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,sDAAsD;IACtD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,sDAAsD;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACpD,yEAAyE;IACzE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAAC;CAC3D;AAaD,+FAA+F;AAC/F,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,oBAAoB,EAC1B,MAAM,SAAW,GAChB,MAAM,CAiCR;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,qBAAqB,CAsB9F"}

package/types/core/names.d.ts

@@ -0,0 +1,7 @@
+export declare function assertName(kind: string, name: unknown): asserts name is string;
+/** Maps every id and alias to its entry's id, refusing a name two entries claim. */
+export declare function nameTable(entries: Iterable<{
+    readonly id: string;
+    readonly aliases?: readonly string[];
+}>): Map<string, string>;
+//# sourceMappingURL=names.d.ts.map

package/types/core/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/core/names.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAI9E;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CACvB,OAAO,EAAE,QAAQ,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,GAC/E,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBrB"}

package/types/core/react.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+import type { ConnectionStore } from "./store";
+import type { ConnectionState } from "./types";
+export interface ConnectionProviderProps {
+    store: ConnectionStore;
+    children?: ReactNode;
+}
+/** Makes one connection store the app's. Web3Provider mounts this once it owns a store. */
+export declare function ConnectionProvider({ store, children }: ConnectionProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<ConnectionStore | null>>;
+/** The store under the nearest ConnectionProvider, for connect, disconnect and reconnect. */
+export declare function useConnectionStore(): ConnectionStore;
+/** The active connection: status, family, connector, address, chainId and client. */
+export declare function useConnection(): ConnectionState;
+//# sourceMappingURL=react.d.ts.map

package/types/core/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/core/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,uBAAuB,mGAE9E;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,IAAI,eAAe,CAIpD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,IAAI,eAAe,CAG/C"}

package/types/core/store.d.ts

@@ -0,0 +1,64 @@
+import { type FamilyRegistry, type WalletFamily } from "./family";
+import type { ConnectionState, ConnectionStorage, DriverConnectOptions, WalletConnector } from "./types";
+export declare const defaultConnectionStorageKey = "mpo.web3.connection";
+export interface ConnectionStoreOptions {
+    families: readonly WalletFamily[] | FamilyRegistry;
+    /**
+     * Where the last connection is remembered. Defaults to localStorage when the
+     * platform has one; null keeps nothing, so nothing is restored.
+     */
+    storage?: ConnectionStorage | null;
+    storageKey?: string;
+    /**
+     * How long, in milliseconds, a driver's disconnect may take before the store
+     * stops waiting for it. Defaults to 10 seconds. Infinity waits for as long
+     * as the driver takes; a negative value waits for nothing.
+     */
+    closeTimeout?: number;
+}
+export interface FamilyConnector {
+    readonly family: string;
+    readonly connector: WalletConnector;
+}
+/**
+ * Holds the one active wallet connection across every registered family.
+ * Only the active family's driver is listened to, so a second driver that
+ * reports an account (wagmi restoring on its own, say) changes nothing.
+ */
+export interface ConnectionStore {
+    getState(): ConnectionState;
+    subscribe(listener: () => void): () => void;
+    readonly registry: FamilyRegistry;
+    /**
+     * Every connectable family's connectors, merged in family order. The same
+     * array comes back until the list changes.
+     */
+    connectors(): readonly FamilyConnector[];
+    /** Called when any family's connector list changes. */
+    subscribeConnectors(listener: () => void): () => void;
+    /**
+     * Connects one family's connector, first closing any other connection.
+     * Remembers {family, connectorId} on success.
+     */
+    connect(family: string, connectorId: string, options?: DriverConnectOptions): Promise<ConnectionState>;
+    /** Closes the active connection and forgets it. */
+    disconnect(): Promise<void>;
+    /**
+     * Restores the remembered connection through its own driver only. Concurrent
+     * calls share one attempt; no other driver is asked. A disconnect from the
+     * wallet side keeps the record, so a later reconnect() can restore it.
+     */
+    reconnect(): Promise<ConnectionState>;
+    /**
+     * Stops listening to every driver and to this store's listeners, and refuses
+     * later connects. It closes nothing: the connection and the attempt live at
+     * that moment stay open on their drivers for whatever takes over, such as a
+     * store remounted on the same drivers. A late result of an attempt cancelled
+     * before destroy() still closes its own connector unless another store holds
+     * it through the same driver object; a store on a fresh driver over the same
+     * wallet cannot be told apart from this one's leftover.
+     */
+    destroy(): void;
+}
+export declare function createConnectionStore(options: ConnectionStoreOptions): ConnectionStore;
+//# sourceMappingURL=store.d.ts.map

package/types/core/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/core/store.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,KAAK,EAEV,eAAe,EACf,iBAAiB,EAEjB,oBAAoB,EAGpB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,CAAC;IACnD;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,IAAI,eAAe,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC;;;OAGG;IACH,UAAU,IAAI,SAAS,eAAe,EAAE,CAAC;IACzC,uDAAuD;IACvD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACtD;;;OAGG;IACH,OAAO,CACL,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5B,mDAAmD;IACnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACtC;;;;;;;;OAQG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAwCD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAsbtF"}

package/types/core/types.d.ts

@@ -0,0 +1,88 @@
+import type { ChainClient } from "../clients/types";
+/** Where a connection is: none, being opened by the user, being restored silently, or open. */
+export type ConnectionStatus = "disconnected" | "connecting" | "reconnecting" | "connected";
+/** One wallet a driver can connect, as the connect list shows it. */
+export interface WalletConnector {
+    readonly id: string;
+    readonly name: string;
+    readonly icon?: string;
+    /** The wallet is present here now: an injected extension, an installed app. */
+    readonly installed?: boolean;
+}
+/** The account a driver connected. */
+export interface DriverAccount {
+    /** Chain-native address. */
+    readonly address: string;
+    /** EVM numeric chain id, or a CAIP-2 style id (`solana:mainnet`). */
+    readonly chainId?: number | string;
+}
+export interface DriverState {
+    readonly status: ConnectionStatus;
+    readonly connectorId: string | null;
+    readonly account: DriverAccount | null;
+}
+export interface DriverConnectOptions {
+    /** Called with a pairing URI when the connector hands off to another app or device. */
+    onDisplayUri?: (uri: string) => void;
+}
+/**
+ * The engine behind one wallet family's connections: wagmi for EVM, the light
+ * driver for adapter-based families. The connection store drives it and holds
+ * the one active connection; a driver never decides which family is active.
+ */
+export interface ConnectionDriver {
+    /** The connectors this driver can drive, in list order. */
+    connectors(): readonly WalletConnector[];
+    /**
+     * Called when the connector list changes: an EIP-6963 or Wallet Standard
+     * wallet announcing itself late. Without it the list is read once per call.
+     */
+    watchConnectors?(listener: () => void): () => void;
+    getState(): DriverState;
+    /** Called on every state change: account, chain, connector, or a disconnect from the wallet side. */
+    subscribe(listener: () => void): () => void;
+    /** Prompts the user. Rejects when they decline or the wallet fails. */
+    connect(connectorId: string, options?: DriverConnectOptions): Promise<DriverAccount>;
+    /**
+     * Closes every connection the driver holds, or with a connectorId only that
+     * connector's, doing nothing when it is not open.
+     */
+    disconnect(connectorId?: string): Promise<void>;
+    /**
+     * Restores a connector the user authorised before, without prompting.
+     * Resolves null only when the wallet says it is no longer authorised, which
+     * makes the store forget it. A connector that is not available yet (an
+     * EIP-6963 wallet still to announce itself) rejects instead, and the store
+     * keeps it for the next restore.
+     */
+    reconnect(connectorId: string): Promise<DriverAccount | null>;
+    /**
+     * The per-chain client for the current account, or null. The store asks
+     * again only when the connector, address or chain changes.
+     */
+    client?(state: DriverState): ChainClient | null | Promise<ChainClient | null>;
+}
+/** What `useConnection()` returns: the single active connection across every family. */
+export interface ConnectionState {
+    readonly status: ConnectionStatus;
+    readonly family: string | null;
+    readonly connector: WalletConnector | null;
+    readonly address: string | null;
+    readonly chainId: number | string | null;
+    readonly client: ChainClient | null;
+}
+/**
+ * Where the store remembers the last connection. localStorage, wagmi's storage
+ * and React Native AsyncStorage all fit.
+ */
+export interface ConnectionStorage {
+    getItem(key: string): string | null | undefined | Promise<string | null | undefined>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+/** The persisted record: which family and connector to restore, nothing else. */
+export interface SavedConnection {
+    readonly family: string;
+    readonly connectorId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/types/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/types/index.d.ts

@@ -7,4 +7,5 @@ export { mainnet, polygon, optimism, arbitrum, base, sepolia } from "wagmi/chain
 export * from "./bridge";
 export * from "./message";
 export * from "./clients";
+export * from "./core";
 //# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,eAAe,EACf,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEtB,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,IAAI,0BAA0B,EAC/C,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG3E,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGnF,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAI1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,eAAe,EACf,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEtB,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,IAAI,0BAA0B,EAC/C,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG3E,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGnF,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAI1B,cAAc,WAAW,CAAC;AAS1B,cAAc,QAAQ,CAAC"}