@unlink-xyz/sdk 0.3.0-canary.573 → 0.3.0-canary.577

package/README.md

@@ -67,6 +67,67 @@ await tx.wait();
 The user client authenticates with short-lived authorization tokens issued by
 your backend. The admin API key never ships to browser bundles.
 
+## React
+
+`@unlink-xyz/sdk/react` wraps the browser client in one hook. `react` is an
+optional peer — install it in your app.
+
+```tsx
+import { account, createUnlinkClient } from "@unlink-xyz/sdk/browser";
+import { UnlinkProvider, useUnlink } from "@unlink-xyz/sdk/react";
+
+const { account: unlinkAccount } = await account.fromMetaMask({
+  provider: window.ethereum,
+  appId: "your-app-id",
+  chainId: 84532,
+});
+
+const client = createUnlinkClient({
+  environment: "base-sepolia-production",
+  account: unlinkAccount,
+});
+
+function App() {
+  return (
+    <UnlinkProvider client={client}>
+      <Wallet />
+    </UnlinkProvider>
+  );
+}
+
+function Wallet() {
+  const { status, balances, transfer } = useUnlink();
+  if (status !== "ready") return <p>Loading…</p>;
+  const send = async () => {
+    try {
+      await transfer({ recipientAddress, token, amount });
+    } catch (err) {
+      // Actions reject on failure — handle it (toast, retry, …).
+    }
+  };
+  return <button onClick={send}>Send</button>;
+}
+```
+
+`UnlinkProvider` takes a ready `client` (above) or a `config` object it builds
+the client from; both are read once on first render. The provider registers the
+user and loads balances on mount, so no explicit `ensureRegistered()` is needed.
+`useUnlink()` returns reactive `status`, `address`, `balances`, `transactions`,
+and `error`, plus `refresh` and the `deposit` / `depositWithApproval` /
+`transfer` / `withdraw` / `execute` actions — each waits for completion, then
+refreshes (pass `TransactionHandleWaitOptions` for an abort signal, status
+callback, or timeout). Reach `client` for anything not surfaced here (execution
+accounts, faucet, approval, polling, or a fire-and-forget handle).
+
+Notes:
+
+- **Actions reject on failure.** The snapshot `error` reflects the data load
+  (`refresh`), not actions — `try`/`catch` your `transfer`/`deposit`/… calls.
+- **Switching account/client.** `client`/`config` are read once; to follow a
+  wallet or account switch, remount the provider with a React `key`.
+- **React version.** Runtime peer is `react >=18 <20`; the published types
+  typecheck cleanly under both `@types/react@18` and `@types/react@19`.
+
 ## Backend Routes
 
 ```ts

package/dist/advanced/index.d.ts

@@ -3,8 +3,8 @@ import { Client } from 'openapi-fetch';
 import { p as paths, S as SignSigningRequestFn } from '../errors-Bh08EOB1.js';
 export { A as AccountKeys, b as ApiError, C as CapabilityError, d as CapabilityErrorCode, e as CapabilityErrorOptions, R as RegistrationPayload, a as RegistrationPayloadWire, m as Signature, n as SigningRequest, T as TimeoutError, U as UnlinkError, V as ValidationError, f as assertRegistrationPayloadWire, u as assertValidSignature, g as fromRegistrationPayloadWire, v as signSigningRequest, t as toRegistrationPayload, h as toRegistrationPayloadWire, w as verifyMessageHash } from '../errors-Bh08EOB1.js';
 export { a as ENVIRONMENTS, E as EnvironmentName, r as resolveEngineUrl } from '../environments-CfyD59YH.js';
-import { S as SignTypedDataFn, P as Permit2NonceManager, T as TransactionResult, a as TransferInstruction, b as Permit2TypedData, c as Permit2WitnessTypedData } from '../client-core-leKzUC4O.js';
-export { C as CreateExecutionAccountClientOptions, D as DepositBackParams, d as DepositBackPreSignParams, E as ENTRY_POINT_V07_ADDRESS, e as Eip1193ProviderOptions, f as EthersProviderLike, g as EthersProviderOptions, h as EthersSignerLike, i as EvmProvider, j as EvmTransactionRequest, k as ExecuteCall, l as ExecuteNextAction, m as ExecuteRecoveryError, n as ExecuteRecoveryMetadata, o as ExecuteRecoveryStage, p as ExecuteResult, q as ExecuteSubmitPayload, r as ExecutionAccount, s as ExecutionAccountClient, t as ExecutionAccountDiscovery, u as ExecutionAccountIndices, v as ExecutionAccountListResponse, w as ExecutionAccountNumberish, x as ExecutionAccountPathIndices, y as ExecutionAccountPolicy, z as ExecutionAccountReservation, A as ExecutionAccountStatus, B as ExecutionIntent, F as ExecutionIntentTypedData, G as ExecutionReservation, H as ExecutionSession, I as ExecutionSessionStatus, J as ExecutionStatus, K as GetCodeFn, L as PollExecuteStatusOptions, M as PreSignedPermit2DepositBack, N as PrepareDepositBack, O as SignedExecutionIntent, Q as SignerProviderOptions, R as TERMINAL_EXECUTE_STATUSES, U as TERMINAL_TRANSACTION_STATUSES, V as TransactionHandle, W as TransactionHandleWaitOptions, X as ViemAccountProviderOptions, Y as ViemLocalAccountLike, Z as ViemProviderOptions, _ as ViemPublicClientLike, $ as ViemWalletClientLike, a0 as buildExecutionIntentTypedData, a1 as computeSoladyERC4337InitCodeHash, a2 as computeSoladyExecutionAccountAddress, a3 as createExecutionAccountClient, a4 as encodeExecutionIntentUserOperationSignature, a5 as evm, a6 as executionAccountPath, a7 as fromWireExecutionIntent, a8 as getExecuteNextAction, a9 as getExecuteSession, aa as getExecutionAccount, ab as getExecutionAccountByAddress, ac as hashExecutionIntent, ad as listExecutionAccounts, ae as ownerAddressToOwnSalt, af as pollExecuteStatus, ag as prepareExecute, ah as reserveExecutionAccount, ai as resolveExecutionAccountPolicy, aj as submitExecute } from '../client-core-leKzUC4O.js';
+import { Q as SignTypedDataFn, X as Permit2NonceManager, a as TransactionResult, H as TransferInstruction, Y as Permit2TypedData, Z as Permit2WitnessTypedData } from '../client-core-CpPGn72-.js';
+export { _ as CreateExecutionAccountClientOptions, $ as DepositBackParams, a0 as DepositBackPreSignParams, a1 as ENTRY_POINT_V07_ADDRESS, h as Eip1193ProviderOptions, i as EthersProviderLike, j as EthersProviderOptions, k as EthersSignerLike, l as EvmProvider, m as EvmTransactionRequest, a2 as ExecuteCall, a3 as ExecuteNextAction, a4 as ExecuteRecoveryError, a5 as ExecuteRecoveryMetadata, a6 as ExecuteRecoveryStage, E as ExecuteResult, a7 as ExecuteSubmitPayload, n as ExecutionAccount, a8 as ExecutionAccountClient, a9 as ExecutionAccountDiscovery, aa as ExecutionAccountIndices, o as ExecutionAccountListResponse, ab as ExecutionAccountNumberish, ac as ExecutionAccountPathIndices, p as ExecutionAccountPolicy, q as ExecutionAccountReservation, ad as ExecutionAccountStatus, ae as ExecutionIntent, af as ExecutionIntentTypedData, ag as ExecutionReservation, s as ExecutionSession, t as ExecutionSessionStatus, ah as ExecutionStatus, ai as GetCodeFn, aj as PollExecuteStatusOptions, ak as PreSignedPermit2DepositBack, al as PrepareDepositBack, am as SignedExecutionIntent, z as SignerProviderOptions, an as TERMINAL_EXECUTE_STATUSES, ao as TERMINAL_TRANSACTION_STATUSES, B as TransactionHandle, T as TransactionHandleWaitOptions, V as ViemAccountProviderOptions, I as ViemLocalAccountLike, J as ViemProviderOptions, K as ViemPublicClientLike, M as ViemWalletClientLike, ap as buildExecutionIntentTypedData, aq as computeSoladyERC4337InitCodeHash, ar as computeSoladyExecutionAccountAddress, as as createExecutionAccountClient, at as encodeExecutionIntentUserOperationSignature, O as evm, au as executionAccountPath, av as fromWireExecutionIntent, aw as getExecuteNextAction, ax as getExecuteSession, ay as getExecutionAccount, az as getExecutionAccountByAddress, aA as hashExecutionIntent, aB as listExecutionAccounts, aC as ownerAddressToOwnSalt, aD as pollExecuteStatus, aE as prepareExecute, aF as reserveExecutionAccount, aG as resolveExecutionAccountPolicy, aH as submitExecute } from '../client-core-CpPGn72-.js';
 export { A as AuthorizationToken, a as Balance, B as BalancesData, E as EnvironmentInfo, I as IssueAuthorizationTokenParams, b as Transaction, T as TransactionListData, g as getEnvironment, c as getTransaction, d as getUserBalances, e as getUserTransactions, i as issueAuthorizationToken } from '../queries-BBgrTZ99.js';
 import 'viem';
 

package/dist/advanced/index.js

@@ -1,3 +1,7 @@
+import {
+  createHttpClient,
+  issueAuthorizationToken
+} from "../chunk-VWYQOXOL.js";
 import {
   ENTRY_POINT_V07_ADDRESS,
   ExecuteRecoveryError,
@@ -32,10 +36,6 @@ import {
   transfer,
   withdraw
 } from "../chunk-4F4TGNXO.js";
-import {
-  createHttpClient,
-  issueAuthorizationToken
-} from "../chunk-VWYQOXOL.js";
 import {
   ENVIRONMENTS,
   getEnvironment,

package/dist/browser/index.d.ts

@@ -1,6 +1,6 @@
 export { AuthorizationTokenProviderWithContext, AuthorizationTokenRequestContext, AuthorizationTokenSource, CreateUnlinkClientOptions, DEFAULT_AUTHORIZATION_TOKEN_URL, DEFAULT_REGISTER_URL, createUnlinkClient } from '../client/index.js';
 export { a as ENVIRONMENTS, E as EnvironmentName } from '../environments-CfyD59YH.js';
-export { al as AccountMetaMaskOptions, am as AccountMetaMaskResult, an as ApprovalParams, ao as CoreExecutePollOptions, ap as CoreTxPollOptions, aq as DepositParams, ar as DepositWithApprovalParams, aH as Eip1193Provider, e as Eip1193ProviderOptions, f as EthersProviderLike, g as EthersProviderOptions, h as EthersSignerLike, i as EvmProvider, j as EvmTransactionRequest, p as ExecuteResult, r as ExecutionAccount, v as ExecutionAccountListResponse, y as ExecutionAccountPolicy, z as ExecutionAccountReservation, as as ExecutionAccounts, H as ExecutionSession, I as ExecutionSessionStatus, at as Faucet, au as FaucetRequestPrivateTokensParams, av as FaucetRequestTestTokensParams, aw as GetBalancesParams, ax as GetExecutionAccountByAddressParams, ay as GetTransactionsParams, az as ListExecutionAccountsParams, aA as PollExecuteOptions, aB as PollOptions, aC as ReserveExecutionAccountParams, aD as SessionExecuteParams, Q as SignerProviderOptions, V as TransactionHandle, W as TransactionHandleWaitOptions, T as TransactionResult, a as TransferInstruction, aE as TransferParams, ak as UnlinkClient, X as ViemAccountProviderOptions, Y as ViemLocalAccountLike, Z as ViemProviderOptions, _ as ViemPublicClientLike, $ as ViemWalletClientLike, aF as WithdrawParams, aG as account, a5 as evm } from '../client-core-leKzUC4O.js';
+export { A as AccountMetaMaskOptions, d as AccountMetaMaskResult, e as ApprovalParams, C as CoreExecutePollOptions, f as CoreTxPollOptions, D as DepositParams, b as DepositWithApprovalParams, g as Eip1193Provider, h as Eip1193ProviderOptions, i as EthersProviderLike, j as EthersProviderOptions, k as EthersSignerLike, l as EvmProvider, m as EvmTransactionRequest, E as ExecuteResult, n as ExecutionAccount, o as ExecutionAccountListResponse, p as ExecutionAccountPolicy, q as ExecutionAccountReservation, r as ExecutionAccounts, s as ExecutionSession, t as ExecutionSessionStatus, F as Faucet, u as FaucetRequestPrivateTokensParams, v as FaucetRequestTestTokensParams, G as GetBalancesParams, w as GetExecutionAccountByAddressParams, x as GetTransactionsParams, L as ListExecutionAccountsParams, P as PollExecuteOptions, y as PollOptions, R as ReserveExecutionAccountParams, S as SessionExecuteParams, z as SignerProviderOptions, B as TransactionHandle, T as TransactionHandleWaitOptions, a as TransactionResult, H as TransferInstruction, c as TransferParams, U as UnlinkClient, V as ViemAccountProviderOptions, I as ViemLocalAccountLike, J as ViemProviderOptions, K as ViemPublicClientLike, M as ViemWalletClientLike, W as WithdrawParams, N as account, O as evm } from '../client-core-CpPGn72-.js';
 export { i as AccountEthereumSignatureOptions, j as AccountExportPayload, A as AccountKeys, k as AccountMnemonicOptions, l as AccountSeedOptions, b as ApiError, C as CapabilityError, d as CapabilityErrorCode, e as CapabilityErrorOptions, R as RegistrationPayload, a as RegistrationPayloadWire, T as TimeoutError, U as UnlinkError, o as UnlinkLocalAccount, V as ValidationError } from '../errors-Bh08EOB1.js';
 import 'openapi-fetch';
 import 'viem';

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
 import { E as EnvironmentName } from '../environments-CfyD59YH.js';
 export { a as ENVIRONMENTS } from '../environments-CfyD59YH.js';
-import { i as EvmProvider, ak as UnlinkClient } from '../client-core-leKzUC4O.js';
-export { al as AccountMetaMaskOptions, am as AccountMetaMaskResult, an as ApprovalParams, ao as CoreExecutePollOptions, ap as CoreTxPollOptions, aq as DepositParams, ar as DepositWithApprovalParams, e as Eip1193ProviderOptions, f as EthersProviderLike, g as EthersProviderOptions, h as EthersSignerLike, j as EvmTransactionRequest, p as ExecuteResult, r as ExecutionAccount, v as ExecutionAccountListResponse, y as ExecutionAccountPolicy, z as ExecutionAccountReservation, as as ExecutionAccounts, H as ExecutionSession, I as ExecutionSessionStatus, at as Faucet, au as FaucetRequestPrivateTokensParams, av as FaucetRequestTestTokensParams, aw as GetBalancesParams, ax as GetExecutionAccountByAddressParams, ay as GetTransactionsParams, az as ListExecutionAccountsParams, aA as PollExecuteOptions, aB as PollOptions, aC as ReserveExecutionAccountParams, aD as SessionExecuteParams, Q as SignerProviderOptions, V as TransactionHandle, W as TransactionHandleWaitOptions, T as TransactionResult, a as TransferInstruction, aE as TransferParams, X as ViemAccountProviderOptions, Y as ViemLocalAccountLike, Z as ViemProviderOptions, _ as ViemPublicClientLike, $ as ViemWalletClientLike, aF as WithdrawParams, aG as account, a5 as evm } from '../client-core-leKzUC4O.js';
+import { l as EvmProvider, U as UnlinkClient } from '../client-core-CpPGn72-.js';
+export { A as AccountMetaMaskOptions, d as AccountMetaMaskResult, e as ApprovalParams, C as CoreExecutePollOptions, f as CoreTxPollOptions, D as DepositParams, b as DepositWithApprovalParams, h as Eip1193ProviderOptions, i as EthersProviderLike, j as EthersProviderOptions, k as EthersSignerLike, m as EvmTransactionRequest, E as ExecuteResult, n as ExecutionAccount, o as ExecutionAccountListResponse, p as ExecutionAccountPolicy, q as ExecutionAccountReservation, r as ExecutionAccounts, s as ExecutionSession, t as ExecutionSessionStatus, F as Faucet, u as FaucetRequestPrivateTokensParams, v as FaucetRequestTestTokensParams, G as GetBalancesParams, w as GetExecutionAccountByAddressParams, x as GetTransactionsParams, L as ListExecutionAccountsParams, P as PollExecuteOptions, y as PollOptions, R as ReserveExecutionAccountParams, S as SessionExecuteParams, z as SignerProviderOptions, B as TransactionHandle, T as TransactionHandleWaitOptions, a as TransactionResult, H as TransferInstruction, c as TransferParams, V as ViemAccountProviderOptions, I as ViemLocalAccountLike, J as ViemProviderOptions, K as ViemPublicClientLike, M as ViemWalletClientLike, W as WithdrawParams, N as account, O as evm } from '../client-core-CpPGn72-.js';
 import { o as UnlinkLocalAccount, R as RegistrationPayload } from '../errors-Bh08EOB1.js';
 export { i as AccountEthereumSignatureOptions, j as AccountExportPayload, A as AccountKeys, k as AccountMnemonicOptions, l as AccountSeedOptions, b as ApiError, C as CapabilityError, d as CapabilityErrorCode, e as CapabilityErrorOptions, a as RegistrationPayloadWire, T as TimeoutError, U as UnlinkError, V as ValidationError } from '../errors-Bh08EOB1.js';
 import 'openapi-fetch';

package/dist/{client-core-leKzUC4O.d.ts → client-core-CpPGn72-.d.ts}

@@ -936,4 +936,4 @@ interface UnlinkClient {
     faucet: Faucet;
 }
 
-export { type ViemWalletClientLike as $, type ExecutionAccountStatus as A, type ExecutionIntent as B, type CreateExecutionAccountClientOptions as C, type DepositBackParams as D, ENTRY_POINT_V07_ADDRESS as E, type ExecutionIntentTypedData as F, type ExecutionReservation as G, type ExecutionSession as H, type ExecutionSessionStatus$1 as I, type ExecutionStatus as J, type GetCodeFn as K, type PollExecuteStatusOptions as L, type PreSignedPermit2DepositBack as M, type PrepareDepositBack as N, type SignedExecutionIntent as O, Permit2NonceManager as P, type SignerProviderOptions as Q, TERMINAL_EXECUTE_STATUSES as R, type SignTypedDataFn as S, type TransactionResult as T, TERMINAL_TRANSACTION_STATUSES as U, type TransactionHandle as V, type TransactionHandleWaitOptions as W, type ViemAccountProviderOptions as X, type ViemLocalAccountLike as Y, type ViemProviderOptions as Z, type ViemPublicClientLike as _, type TransferInstruction as a, buildExecutionIntentTypedData as a0, computeSoladyERC4337InitCodeHash as a1, computeSoladyExecutionAccountAddress as a2, createExecutionAccountClient as a3, encodeExecutionIntentUserOperationSignature as a4, evm as a5, executionAccountPath as a6, fromWireExecutionIntent as a7, getExecuteNextAction as a8, getExecuteSession as a9, type PollExecuteOptions as aA, type PollOptions as aB, type ReserveExecutionAccountParams as aC, type SessionExecuteParams as aD, type TransferParams as aE, type WithdrawParams as aF, account as aG, type Eip1193Provider as aH, getExecutionAccount as aa, getExecutionAccountByAddress as ab, hashExecutionIntent as ac, listExecutionAccounts as ad, ownerAddressToOwnSalt as ae, pollExecuteStatus as af, prepareExecute as ag, reserveExecutionAccount as ah, resolveExecutionAccountPolicy as ai, submitExecute as aj, type UnlinkClient as ak, type AccountMetaMaskOptions as al, type AccountMetaMaskResult as am, type ApprovalParams as an, type CoreExecutePollOptions as ao, type CoreTxPollOptions as ap, type DepositParams as aq, type DepositWithApprovalParams as ar, type ExecutionAccounts as as, type Faucet as at, type FaucetRequestPrivateTokensParams as au, type FaucetRequestTestTokensParams as av, type GetBalancesParams as aw, type GetExecutionAccountByAddressParams as ax, type GetTransactionsParams as ay, type ListExecutionAccountsParams as az, type Permit2TypedData as b, type Permit2WitnessTypedData as c, type DepositBackPreSignParams as d, type Eip1193ProviderOptions as e, type EthersProviderLike as f, type EthersProviderOptions as g, type EthersSignerLike as h, type EvmProvider as i, type EvmTransactionRequest as j, type ExecuteCall as k, type ExecuteNextAction as l, ExecuteRecoveryError as m, type ExecuteRecoveryMetadata as n, type ExecuteRecoveryStage as o, type ExecuteResult as p, type ExecuteSubmitPayload as q, type ExecutionAccount as r, type ExecutionAccountClient as s, type ExecutionAccountDiscovery as t, type ExecutionAccountIndices as u, type ExecutionAccountListResponse as v, type ExecutionAccountNumberish as w, type ExecutionAccountPathIndices as x, type ExecutionAccountPolicy as y, type ExecutionAccountReservation as z };
+export { type DepositBackParams as $, type AccountMetaMaskOptions as A, type TransactionHandle as B, type CoreExecutePollOptions as C, type DepositParams as D, type ExecuteResult as E, type Faucet as F, type GetBalancesParams as G, type TransferInstruction as H, type ViemLocalAccountLike as I, type ViemProviderOptions as J, type ViemPublicClientLike as K, type ListExecutionAccountsParams as L, type ViemWalletClientLike as M, account as N, evm as O, type PollExecuteOptions as P, type SignTypedDataFn as Q, type ReserveExecutionAccountParams as R, type SessionExecuteParams as S, type TransactionHandleWaitOptions as T, type UnlinkClient as U, type ViemAccountProviderOptions as V, type WithdrawParams as W, Permit2NonceManager as X, type Permit2TypedData as Y, type Permit2WitnessTypedData as Z, type CreateExecutionAccountClientOptions as _, type TransactionResult as a, type DepositBackPreSignParams as a0, ENTRY_POINT_V07_ADDRESS as a1, type ExecuteCall as a2, type ExecuteNextAction as a3, ExecuteRecoveryError as a4, type ExecuteRecoveryMetadata as a5, type ExecuteRecoveryStage as a6, type ExecuteSubmitPayload as a7, type ExecutionAccountClient as a8, type ExecutionAccountDiscovery as a9, hashExecutionIntent as aA, listExecutionAccounts as aB, ownerAddressToOwnSalt as aC, pollExecuteStatus as aD, prepareExecute as aE, reserveExecutionAccount as aF, resolveExecutionAccountPolicy as aG, submitExecute as aH, type ExecutionAccountIndices as aa, type ExecutionAccountNumberish as ab, type ExecutionAccountPathIndices as ac, type ExecutionAccountStatus as ad, type ExecutionIntent as ae, type ExecutionIntentTypedData as af, type ExecutionReservation as ag, type ExecutionStatus as ah, type GetCodeFn as ai, type PollExecuteStatusOptions as aj, type PreSignedPermit2DepositBack as ak, type PrepareDepositBack as al, type SignedExecutionIntent as am, TERMINAL_EXECUTE_STATUSES as an, TERMINAL_TRANSACTION_STATUSES as ao, buildExecutionIntentTypedData as ap, computeSoladyERC4337InitCodeHash as aq, computeSoladyExecutionAccountAddress as ar, createExecutionAccountClient as as, encodeExecutionIntentUserOperationSignature as at, executionAccountPath as au, fromWireExecutionIntent as av, getExecuteNextAction as aw, getExecuteSession as ax, getExecutionAccount as ay, getExecutionAccountByAddress as az, type DepositWithApprovalParams as b, type TransferParams as c, type AccountMetaMaskResult as d, type ApprovalParams as e, type CoreTxPollOptions as f, type Eip1193Provider as g, type Eip1193ProviderOptions as h, type EthersProviderLike as i, type EthersProviderOptions as j, type EthersSignerLike as k, type EvmProvider as l, type EvmTransactionRequest as m, type ExecutionAccount as n, type ExecutionAccountListResponse as o, type ExecutionAccountPolicy as p, type ExecutionAccountReservation as q, type ExecutionAccounts as r, type ExecutionSession as s, type ExecutionSessionStatus$1 as t, type FaucetRequestPrivateTokensParams as u, type FaucetRequestTestTokensParams as v, type GetExecutionAccountByAddressParams as w, type GetTransactionsParams as x, type PollOptions as y, type SignerProviderOptions as z };

package/dist/react/index.d.ts

@@ -0,0 +1,74 @@
+import { ReactNode } from 'react';
+import { CreateUnlinkClientOptions } from '../client/index.js';
+export { AuthorizationTokenProviderWithContext, AuthorizationTokenRequestContext, AuthorizationTokenSource, DEFAULT_AUTHORIZATION_TOKEN_URL, DEFAULT_REGISTER_URL, createUnlinkClient } from '../client/index.js';
+import { U as UnlinkClient, D as DepositParams, T as TransactionHandleWaitOptions, a as TransactionResult, b as DepositWithApprovalParams, c as TransferParams, W as WithdrawParams, S as SessionExecuteParams, E as ExecuteResult } from '../client-core-CpPGn72-.js';
+export { A as AccountMetaMaskOptions, d as AccountMetaMaskResult, e as ApprovalParams, C as CoreExecutePollOptions, f as CoreTxPollOptions, g as Eip1193Provider, h as Eip1193ProviderOptions, i as EthersProviderLike, j as EthersProviderOptions, k as EthersSignerLike, l as EvmProvider, m as EvmTransactionRequest, n as ExecutionAccount, o as ExecutionAccountListResponse, p as ExecutionAccountPolicy, q as ExecutionAccountReservation, r as ExecutionAccounts, s as ExecutionSession, t as ExecutionSessionStatus, F as Faucet, u as FaucetRequestPrivateTokensParams, v as FaucetRequestTestTokensParams, G as GetBalancesParams, w as GetExecutionAccountByAddressParams, x as GetTransactionsParams, L as ListExecutionAccountsParams, P as PollExecuteOptions, y as PollOptions, R as ReserveExecutionAccountParams, z as SignerProviderOptions, B as TransactionHandle, H as TransferInstruction, V as ViemAccountProviderOptions, I as ViemLocalAccountLike, J as ViemProviderOptions, K as ViemPublicClientLike, M as ViemWalletClientLike, N as account, O as evm } from '../client-core-CpPGn72-.js';
+import { c as components } from '../errors-Bh08EOB1.js';
+export { i as AccountEthereumSignatureOptions, j as AccountExportPayload, A as AccountKeys, k as AccountMnemonicOptions, l as AccountSeedOptions, b as ApiError, C as CapabilityError, d as CapabilityErrorCode, e as CapabilityErrorOptions, R as RegistrationPayload, a as RegistrationPayloadWire, T as TimeoutError, U as UnlinkError, o as UnlinkLocalAccount, V as ValidationError } from '../errors-Bh08EOB1.js';
+export { a as ENVIRONMENTS, E as EnvironmentName } from '../environments-CfyD59YH.js';
+import 'openapi-fetch';
+import 'viem';
+
+type BalancesData = components["schemas"]["BalancesData"];
+type TransactionListData = components["schemas"]["TransactionListData"];
+/** Lifecycle of the controller's data load. Apps label these themselves. */
+type UnlinkStatus = "idle" | "loading" | "ready" | "error";
+/** Immutable reactive state. Stable reference between changes (safe for `useSyncExternalStore`). */
+interface UnlinkSnapshot {
+    readonly status: UnlinkStatus;
+    readonly address: string | null;
+    readonly balances: BalancesData | null;
+    readonly transactions: TransactionListData | null;
+    /** Most recent data-load error; cleared on the next `refresh`. */
+    readonly error: Error | null;
+}
+interface UnlinkController {
+    /** Raw client escape hatch (execution accounts, faucet, approval, polling). */
+    readonly client: UnlinkClient;
+    /** Current immutable snapshot. */
+    getSnapshot(): UnlinkSnapshot;
+    /** Subscribe to snapshot changes; returns an unsubscribe fn. */
+    subscribe(listener: () => void): () => void;
+    /** Ensure the user is registered (idempotent), then load address + balances + transactions. */
+    refresh(): Promise<void>;
+    deposit(params: DepositParams, waitOptions?: TransactionHandleWaitOptions): Promise<TransactionResult>;
+    depositWithApproval(params: DepositWithApprovalParams, waitOptions?: TransactionHandleWaitOptions): Promise<TransactionResult>;
+    transfer(params: TransferParams, waitOptions?: TransactionHandleWaitOptions): Promise<TransactionResult>;
+    withdraw(params: WithdrawParams, waitOptions?: TransactionHandleWaitOptions): Promise<TransactionResult>;
+    execute(params: SessionExecuteParams): Promise<ExecuteResult>;
+}
+
+interface UnlinkProviderProps {
+    /** A ready client. Mutually exclusive with `config`. */
+    client?: UnlinkClient;
+    /** Options to build a client. Mutually exclusive with `client`. */
+    config?: CreateUnlinkClientOptions;
+    children: ReactNode;
+}
+/**
+ * Provides a single `UnlinkController` to descendants. `client`/`config` are
+ * read once on first render; later prop changes are ignored (rebuild by
+ * remounting, e.g. via a `key`). The initial balances/transactions load fires
+ * from a mount effect.
+ */
+declare function UnlinkProvider(props: UnlinkProviderProps): ReactNode;
+
+/** Reactive state + actions returned by {@link useUnlink}. */
+interface UseUnlinkResult extends UnlinkSnapshot {
+    /** Raw client escape hatch for anything not surfaced here. */
+    client: UnlinkClient;
+    refresh: UnlinkController["refresh"];
+    deposit: UnlinkController["deposit"];
+    depositWithApproval: UnlinkController["depositWithApproval"];
+    transfer: UnlinkController["transfer"];
+    withdraw: UnlinkController["withdraw"];
+    execute: UnlinkController["execute"];
+}
+/**
+ * The one primitive: reactive Unlink state (`status`, `address`, `balances`,
+ * `transactions`, `error`) plus action methods that wait for completion then
+ * refresh. Must be called under an `<UnlinkProvider>`.
+ */
+declare function useUnlink(): UseUnlinkResult;
+
+export { CreateUnlinkClientOptions, DepositParams, DepositWithApprovalParams, ExecuteResult, SessionExecuteParams, TransactionHandleWaitOptions, TransactionResult, TransferParams, UnlinkClient, type UnlinkController, UnlinkProvider, type UnlinkProviderProps, type UnlinkSnapshot, type UnlinkStatus, type UseUnlinkResult, WithdrawParams, useUnlink };

package/dist/react/index.js

@@ -0,0 +1,169 @@
+import {
+  DEFAULT_AUTHORIZATION_TOKEN_URL,
+  DEFAULT_REGISTER_URL,
+  createUnlinkClient
+} from "../chunk-EGGG2NHC.js";
+import {
+  evm
+} from "../chunk-4F4TGNXO.js";
+import {
+  ENVIRONMENTS,
+  account
+} from "../chunk-RS7NZTSS.js";
+import {
+  ApiError,
+  CapabilityError,
+  TimeoutError,
+  UnlinkError,
+  ValidationError
+} from "../chunk-SCM5FQ6U.js";
+import "../chunk-JSBRDJBE.js";
+
+// src/react/context.ts
+import {
+  createContext,
+  createElement,
+  useContext,
+  useEffect,
+  useState
+} from "react";
+
+// src/internal/controller/create-controller.ts
+var IDLE = {
+  status: "idle",
+  address: null,
+  balances: null,
+  transactions: null,
+  error: null
+};
+function toError(value) {
+  return value instanceof Error ? value : new Error(String(value));
+}
+function createUnlinkController(client) {
+  let snapshot = IDLE;
+  const listeners = /* @__PURE__ */ new Set();
+  let refreshToken = 0;
+  const setState = (patch) => {
+    snapshot = { ...snapshot, ...patch };
+    for (const listener of listeners) listener();
+  };
+  const getSnapshot = () => snapshot;
+  const subscribe = (listener) => {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  };
+  const ensureReady = () => client.ensureRegistered();
+  const refresh = async () => {
+    const token = ++refreshToken;
+    setState({ status: "loading", error: null });
+    let patch;
+    try {
+      await ensureReady();
+      const [address, balances, transactions] = await Promise.all([
+        client.getAddress(),
+        client.getBalances(),
+        client.getTransactions()
+      ]);
+      patch = { status: "ready", address, balances, transactions };
+    } catch (err) {
+      patch = { status: "error", error: toError(err) };
+    }
+    if (token !== refreshToken) return;
+    setState(patch);
+  };
+  const runAndRefresh = async (action, waitOptions) => {
+    await ensureReady();
+    const result = await (await action()).wait(waitOptions);
+    await refresh();
+    return result;
+  };
+  return {
+    client,
+    getSnapshot,
+    subscribe,
+    refresh,
+    deposit: (params, waitOptions) => runAndRefresh(() => client.deposit(params), waitOptions),
+    depositWithApproval: (params, waitOptions) => runAndRefresh(() => client.depositWithApproval(params), waitOptions),
+    transfer: (params, waitOptions) => runAndRefresh(() => client.transfer(params), waitOptions),
+    withdraw: (params, waitOptions) => runAndRefresh(() => client.withdraw(params), waitOptions),
+    // No waitOptions here (unlike the four above): client.execute already
+    // resolves to a terminal ExecuteResult, not a TransactionHandle to .wait().
+    execute: async (params) => {
+      await ensureReady();
+      const result = await client.execute(params);
+      await refresh();
+      return result;
+    }
+  };
+}
+
+// src/react/context.ts
+var UnlinkControllerContext = createContext(null);
+function UnlinkProvider(props) {
+  const [controller] = useState(() => {
+    const client = props.client ?? (props.config ? createUnlinkClient(props.config) : null);
+    if (!client) {
+      throw new CapabilityError(
+        "UnlinkProvider requires either a `client` or a `config` prop",
+        { code: "missing_identity" }
+      );
+    }
+    return createUnlinkController(client);
+  });
+  useEffect(() => {
+    void controller.refresh();
+  }, [controller]);
+  return createElement(
+    UnlinkControllerContext.Provider,
+    { value: controller },
+    props.children
+  );
+}
+function useUnlinkController() {
+  const controller = useContext(UnlinkControllerContext);
+  if (!controller) {
+    throw new CapabilityError(
+      "useUnlink must be used within an <UnlinkProvider>",
+      { code: "missing_identity" }
+    );
+  }
+  return controller;
+}
+
+// src/react/use-unlink.ts
+import { useSyncExternalStore } from "react";
+function useUnlink() {
+  const controller = useUnlinkController();
+  const snapshot = useSyncExternalStore(
+    controller.subscribe,
+    controller.getSnapshot,
+    controller.getSnapshot
+  );
+  return {
+    ...snapshot,
+    client: controller.client,
+    refresh: controller.refresh,
+    deposit: controller.deposit,
+    depositWithApproval: controller.depositWithApproval,
+    transfer: controller.transfer,
+    withdraw: controller.withdraw,
+    execute: controller.execute
+  };
+}
+export {
+  ApiError,
+  CapabilityError,
+  DEFAULT_AUTHORIZATION_TOKEN_URL,
+  DEFAULT_REGISTER_URL,
+  ENVIRONMENTS,
+  TimeoutError,
+  UnlinkError,
+  UnlinkProvider,
+  ValidationError,
+  account,
+  createUnlinkClient,
+  evm,
+  useUnlink
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unlink-xyz/sdk",
-  "version": "0.3.0-canary.573",
+  "version": "0.3.0-canary.577",
   "type": "module",
   "exports": {
     "./browser": {
@@ -28,6 +28,11 @@
       "types": "./dist/crypto/index.d.ts",
       "import": "./dist/crypto/index.js",
       "default": "./dist/crypto/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
     }
   },
   "files": [
@@ -56,6 +61,14 @@
     "publint": "publint",
     "attw": "attw --pack ."
   },
+  "peerDependencies": {
+    "react": ">=18 <20"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@noble/curves": "^2.2.0",
     "@noble/hashes": "^2.2.0",
@@ -70,11 +83,17 @@
     "@arethetypeswrong/cli": "^0.18.0",
     "@metamask/eth-sig-util": "^8.2.0",
     "@size-limit/preset-small-lib": "^11.2.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
     "@vitest/coverage-v8": "^3.2.4",
     "@zk-kit/eddsa-poseidon": "^1.1.0",
     "ethers": "^6.15.0",
+    "jsdom": "^26.1.0",
     "openapi-typescript": "^7.13.0",
     "publint": "^0.3.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "size-limit": "^11.2.0",
     "tsup": "^8.0.0",
     "vitest": "^3.0.0"