Build

Hooks

Headless typed hooks: wallet state, creation, connection, balance, transfers, signing, signers, recovery, spending policy.

View raw

Everything the components do is available headless. All hooks require a PasskeyWalletProvider above them.

usePasskeyWallet

const {
  kit,          // the smart-account-kit instance
  status,       // "initializing" | "disconnected" | "connected" ...
  isConnected,
  address,      // C... contract address
  capabilities, // WebAuthn support detection
  config,       // resolved config incl. explorerBaseUrl
  connect, createWallet, disconnect, fund,
} = usePasskeyWallet();

Flows

Hook	Returns
`useCreateWallet()`	`createWallet` with per-phase progress: `passkey`, `deploying`, `funding`
`useConnectWallet()`	`connect` with status
`useTransfer()`	`transfer({ to, amount })` building, signing, and submitting an XLM payment
`useSignTransaction()`	sign any `AssembledTransaction` with the passkey
`useRecovery()`	enroll and execute recovery

State

Hook	Returns
`useWalletBalance()`	`formatted`, `raw` stroops, `symbol`, `status`, `refetch`, `isRefreshing`
`useWalletAddress()`	`address`, `copy()` with `copied` feedback, `explorerUrl`
`useSigners()`	the signer list, live
`useAddSigner()` / `useRemoveSigner()`	signer mutations
`useSpendingPolicy()`	read and set the on-chain limit

Utilities

import { buildTransferTransaction, toSembolError } from "@sembol/passkey-react";

// arbitrary token transfers (returns an AssembledTransaction for the modal)
const tx = await buildTransferTransaction(kit, {
  tokenContract: config.nativeTokenContract,
  to, amount,
});

// every thrown error normalizes to a typed SembolError
try { ... } catch (e) {
  toast(toSembolError(e).userMessage);
}