@multiplatform.one/web3 7.24.0 → 7.26.0

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

@@ -1,4 +1,4 @@
-export { WalletProvider, useWeb3Config, defaultChains, type WalletProviderProps, type Web3Config, } from "./providers";
+export { WalletProvider, useWeb3Config, defaultChains, useWalletBridge, type WalletBridgeContextValue, type WalletProviderProps, type Web3Config, } from "./providers";
 export { useWallet, type UseWalletResult, type WalletActions, type WalletState, useContractRead, useContractWrite, type ContractReadConfig, type ContractReadResult, type ContractWriteConfig, type ContractWriteResult, type TransactionStatus, useAccount, useBalance, useChainId, useChains, useConnect, useDisconnect, useEnsAvatar, useEnsName, useSignMessage, useSwitchChain, useBlockNumber, useReadContract, useWriteContract, useSimulateContract, useWaitForTransactionReceipt, } from "./hooks";
 export { WalletButton, WalletAvatar, WalletStatus, NetworkSwitcher, TransactionStatus as TransactionStatusComponent, ConnectKitButton, type WalletButtonProps, type WalletAvatarProps, type WalletStatusProps, type NetworkSwitcherProps, type TransactionStatusProps, } from "./components";
 export { LockContract, lockAbi, type LockContractProps } from "./examples";
@@ -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,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"}

package/types/providers/WalletProvider.d.ts

@@ -13,6 +13,7 @@ export interface WalletProviderProps extends PropsWithChildren {
     siwe?: SIWEConfig;
 }
 export declare function WalletProvider({ children, config: web3Config, queryClient, siwe, }: WalletProviderProps): import("react/jsx-runtime").JSX.Element;
+export { useWalletBridge, type WalletBridgeContextValue } from "./walletBridge";
 export { defaultChains } from "./walletConfig";
 export { useWeb3Config, type Web3Config } from "./walletConfig";
 //# sourceMappingURL=WalletProvider.d.ts.map

package/types/providers/WalletProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WalletProvider.d.ts","sourceRoot":"","sources":["../../src/providers/WalletProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAoC,KAAK,UAAU,EAAoB,MAAM,eAAe,CAAC;AAEpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAK/C,OAAO,EAAE,KAAK,UAAU,EAAoC,MAAM,gBAAgB,CAAC;AAEnF,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAWD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,WAAgC,EAChC,IAAI,GACL,EAAE,mBAAmB,2CAyErB;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"WalletProvider.d.ts","sourceRoot":"","sources":["../../src/providers/WalletProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAoC,KAAK,UAAU,EAAoB,MAAM,eAAe,CAAC;AAEpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAI/C,OAAO,EAAE,KAAK,UAAU,EAAoC,MAAM,gBAAgB,CAAC;AAEnF,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAWD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,WAAgC,EAChC,IAAI,GACL,EAAE,mBAAmB,2CAyErB;AAED,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/types/providers/WalletProvider.native.d.ts

@@ -7,7 +7,7 @@ type WebViewSource = NonNullable<WebViewProps["source"]>;
 export interface WalletProviderProps extends PropsWithChildren {
     config: Web3Config;
     queryClient?: QueryClient;
-    /** Override the WebView content (defaults to `config.webViewUrl`). */
+    /** Override the WebView content (defaults to `config.webViewUrl`); must be a hosted `{ uri }`. */
     webViewSource?: WebViewSource;
 }
 /** Native Solana surface, mirroring the operations web's wallet-adapter exposes. */
@@ -18,6 +18,7 @@ export interface SolanaWalletContextValue {
 }
 export declare function useSolanaWallet(): SolanaWalletContextValue;
 export declare function WalletProvider({ children, config: web3Config, queryClient, webViewSource, }: WalletProviderProps): import("react/jsx-runtime").JSX.Element;
+export { useWalletBridge, type WalletBridgeContextValue } from "./walletBridge";
 export { defaultChains } from "./walletConfig";
 export { useWeb3Config, type Web3Config } from "./walletConfig";
 //# sourceMappingURL=WalletProvider.native.d.ts.map

package/types/providers/WalletProvider.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WalletProvider.native.d.ts","sourceRoot":"","sources":["../../src/providers/WalletProvider.native.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG5F,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMtD,OAAO,EAAE,KAAK,UAAU,EAAoC,MAAM,gBAAgB,CAAC;AAEnF,KAAK,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AAMzD,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sEAAsE;IACtE,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,oFAAoF;AACpF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,wBAAgB,eAAe,IAAI,wBAAwB,CAI1D;AAID,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,WAAgC,EAChC,aAAa,GACd,EAAE,mBAAmB,2CA+IrB;AAUD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"WalletProvider.native.d.ts","sourceRoot":"","sources":["../../src/providers/WalletProvider.native.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAK5F,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAetD,OAAO,EAAE,KAAK,UAAU,EAAoC,MAAM,gBAAgB,CAAC;AAEnF,KAAK,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AAMzD,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kGAAkG;IAClG,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,oFAAoF;AACpF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,wBAAgB,eAAe,IAAI,wBAAwB,CAI1D;AAeD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,WAAgC,EAChC,aAAa,GACd,EAAE,mBAAmB,2CA8KrB;AAUD,OAAO,EAAE,eAAe,EAAE,KAAK,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/types/providers/index.d.ts

@@ -1,2 +1,2 @@
-export { WalletProvider, useWeb3Config, defaultChains, type WalletProviderProps, type Web3Config, } from "./WalletProvider";
+export { WalletProvider, useWeb3Config, defaultChains, useWalletBridge, type WalletBridgeContextValue, type WalletProviderProps, type Web3Config, } from "./WalletProvider";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC"}

package/types/providers/native/deepLink.d.ts

@@ -1,11 +1,36 @@
 /**
- * Wallet hand-off URL classification for the native WebView. The WebView loads
- * trusted local content (file://); when its ConnectKit flow tries to
- * open a wallet app it navigates to a wallet custom-scheme or universal link —
- * those must be handed to the OS via Linking.openURL, not loaded in the WebView.
+ * Wallet hand-off for the native WebView. The WebView shows the hosted wallet
+ * page; when its flow opens a wallet app it navigates to a wallet custom
+ * scheme or universal link, or opens one in a new window. Those go to the OS
+ * through Linking.openURL and are never loaded in the WebView.
  */
+/** Custom schemes that open a wallet app. docs/bridge-protocol.md lists the same. */
+export declare const WALLET_SCHEMES: readonly string[];
+/** Hosts (and subdomains) of wallet universal links. docs/bridge-protocol.md lists the same. */
+export declare const WALLET_UNIVERSAL_HOSTS: readonly string[];
 /** True when a WebView navigation should be opened in an external wallet app. */
 export declare function shouldOpenExternally(url: string): boolean;
+/** `load` in the WebView, hand to the OS (`external`), or drop (`block`). */
+export type NavigationDecision = "load" | "external" | "block";
+/**
+ * Decide a navigation in the wallet WebView (`onShouldStartLoadWithRequest`).
+ * The top frame never leaves the hosted page's origin: the bridge would
+ * otherwise hand its messages, tokens included, to whatever page loaded next.
+ * Other http(s) pages open in the system browser; frames are the page's own
+ * business.
+ */
+export declare function decideNavigation(url: string, pageOrigin: string, isTopFrame?: boolean): NavigationDecision;
+/**
+ * Decide a `window.open` / `target=_blank` navigation (`onOpenWindow`). A new
+ * window never opens inside the app: wallet links and web pages go to the OS.
+ */
+export declare function decideNewWindow(url: string): NavigationDecision;
 /** Parse the query params of an inbound app-link return (e.g. from a wallet redirect). */
 export declare function parseWalletReturn(url: string): Record<string, string> | null;
+/**
+ * True when `url` is `base` or below it: `myapp://wallet-return?x=1` and
+ * `myapp://wallet-return/done` are under `myapp://wallet-return`,
+ * `myapp://wallet-returned` is not.
+ */
+export declare function isUnderUrl(url: string, base: string): boolean;
 //# sourceMappingURL=deepLink.d.ts.map

package/types/providers/native/deepLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepLink.d.ts","sourceRoot":"","sources":["../../../src/providers/native/deepLink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAazD;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAW5E"}
+{"version":3,"file":"deepLink.d.ts","sourceRoot":"","sources":["../../../src/providers/native/deepLink.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,qFAAqF;AACrF,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAgB3C,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EASnD,CAAC;AAIF,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQzD;AAED,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,UAAO,GAChB,kBAAkB,CAWpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAQ/D;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAI7D"}

package/types/providers/native/inject.d.ts

@@ -1,11 +1,5 @@
 import type { Web3Config } from "../walletConfig";
-/**
- * Build the JS the native side runs inside the WebView (via `injectJavaScript`)
- * to deliver one inbound bridge message. The raw string is embedded with
- * JSON.stringify so quotes/newlines/backslashes survive intact. The trailing
- * `true;` is required by react-native-webview's injectJavaScript contract.
- */
-export declare function buildInjectScript(raw: string): string;
+export { buildInjectScript } from "../../bridge/nativeHost";
 /**
  * Build the JS injected *before* the WebView content loads
  * (`injectedJavaScriptBeforeContentLoaded`) to publish the host config as

package/types/providers/native/inject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../../src/providers/native/inject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAE1F"}
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../../src/providers/native/inject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAE1F"}

package/types/providers/walletBridge.d.ts

@@ -0,0 +1,17 @@
+import type { AuthBridge } from "../bridge/AuthBridge";
+import type { BridgeClient } from "../bridge/BridgeClient";
+import type { GpgBridge } from "../bridge/GpgBridge";
+import type { SolanaBridge } from "../bridge/SolanaBridge";
+import type { SuiBridge } from "../bridge/SuiBridge";
+/** Every bridge namespace of the native WalletProvider's hosted wallet page. */
+export interface WalletBridgeContextValue {
+    client: BridgeClient;
+    solana: SolanaBridge;
+    sui: SuiBridge;
+    gpg: GpgBridge;
+    auth: AuthBridge;
+}
+export declare const WalletBridgeContext: import("react").Context<WalletBridgeContextValue | null>;
+/** Native only: on web the wallet runs in the page itself and there is no bridge. */
+export declare function useWalletBridge(): WalletBridgeContextValue;
+//# sourceMappingURL=walletBridge.d.ts.map

package/types/providers/walletBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletBridge.d.ts","sourceRoot":"","sources":["../../src/providers/walletBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,gFAAgF;AAChF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,SAAS,CAAC;IACf,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,eAAO,MAAM,mBAAmB,0DAAuD,CAAC;AAExF,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,wBAAwB,CAI1D"}

package/types/providers/walletConfig.d.ts

@@ -1,4 +1,5 @@
 import type { Chain } from "viem";
+import type { AuthKeycloakConfig, AuthOnboardingConfig } from "../bridge/authTypes";
 /**
  * Shared config seam for both platform variants of WalletProvider. Keeping the
  * type + context here (rather than in either variant) means web and native share
@@ -32,8 +33,24 @@ export interface Web3Config {
     suiRpcUrl?: string;
     /** E2E only (native): route connect through the in-WebView mock wallet. */
     mockWallet?: boolean;
-    /** Native: URL serving the wallet WebView HTML (preferred over the inline string). */
+    /**
+     * Native: https URL serving `assets/webview.html`. Its host is the sign-in
+     * message's domain, so it must be in the realm's `siww.allowedDomains` /
+     * `wallet.allowedDomains` and in the client's web origins. Plain http is
+     * accepted only on loopback and 10.0.2.2, in development builds.
+     */
     webViewUrl?: string;
+    /**
+     * Native: the app link wallets send the user back to, e.g.
+     * `myapp://wallet-return`. Returns under it reach the page as
+     * `sys.deepLinkReturn`; no other app link does.
+     */
+    walletReturnUrl?: string;
+    /** Native: the Keycloak client `useWalletBridge().auth` signs in with when a call names none. */
+    auth?: {
+        keycloak?: AuthKeycloakConfig;
+        onboarding?: AuthOnboardingConfig;
+    };
 }
 /**
  * Resolve the active chain list for a Web3Config: apply the testnet filter,

package/types/providers/walletConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walletConfig.d.ts","sourceRoot":"","sources":["../../src/providers/walletConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAGlC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAOtD,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,uFAAuF;IACvF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAgB9E;AAED,eAAO,MAAM,iBAAiB,4CAAyC,CAAC;AAExE,wBAAgB,aAAa,IAAI,UAAU,CAM1C"}
+{"version":3,"file":"walletConfig.d.ts","sourceRoot":"","sources":["../../src/providers/walletConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAOtD,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,uFAAuF;IACvF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAAC,UAAU,CAAC,EAAE,oBAAoB,CAAA;KAAE,CAAC;CAC7E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAgB9E;AAED,eAAO,MAAM,iBAAiB,4CAAyC,CAAC;AAExE,wBAAgB,aAAa,IAAI,UAAU,CAM1C"}