Hooks Reference

const { open, close, isOpen } = useKevoModal()

const { open, close, isOpen } = useKevoDashboard()

const {
  client,           // KevoClient instance
  session,          // KevoSession | null
  isAuthenticated,  // boolean
  isLoading,        // boolean (true during initial restore)
  userProfile,      // KevoResolvedUserProfile
  rawUserProfile,   // KevoUserProfile | null
  enabledChains,    // SupportedChain[] (e.g. ['evm', 'solana'])
  projectConfig,    // KevoProjectConfig | null
  logout,           // () => Promise<void>
  sendEmailOtp,     // (email: string) => Promise<void>
  verifyEmailOtp,   // (email: string, code: string) => Promise<void>
  loginWithGoogle,  // () => void — opens Google OAuth popup
  loginWithX,       // () => void — opens X (Twitter) OAuth popup
  loginWithApple,   // () => void — opens Apple OAuth popup
  getDelegation,    // () => Promise<KevoDelegation | null>
  grantDelegation,  // (opts?: GrantDelegationOptions) => Promise<KevoDelegation>
  revokeDelegation, // () => Promise<void>
} = useKevo()

const {
  profile,           // KevoResolvedUserProfile
  rawProfile,        // KevoUserProfile | null
  refresh,           // () => Promise<KevoUserProfile | null>
  requestEmailLink,  // (email: string) => Promise<void>
  confirmEmailLink,  // (email: string, code: string) => Promise<void>
} = useUserProfile()

return (
  <div>
    <img src={profile.avatarUrl} alt="" />
    <span>{profile.name}</span>       {/* wallet address, shortened */}
    {profile.username && <small>{profile.username}</small>}
  </div>
)

const { evmWallet, solanaWallet, enabledChains, isLoading } = useWallets()

// evmWallet:     KevoWallet | null     — { address: '0x...', id, createdAt }
// solanaWallet:  KevoSolanaWallet | null — { address: 'Base58...', id, createdAt }

const { activeChainId, setChain, chains, rpcUrl } = useChain()

// Switch to Base
setChain(8453)

// Render a chain selector
Object.keys(chains).map(id => (
  <button key={id} onClick={() => setChain(Number(id))}>
    Chain {id}
  </button>
))

const { signMessage, isLoading, error } = useSignMessage()

// Single-chain project — just works:
const sig = await signMessage('Hello from Kevo!')

// Multi-chain project — specify chain:
const sig = await signMessage('Hello', { chain: 'solana' })

const { signSolanaMessage, isLoading, error } = useSignSolanaMessage()

// Accepts string or Uint8Array
const sigHex = await signSolanaMessage('Hello Solana!')
const sigHex = await signSolanaMessage(new Uint8Array([1, 2, 3]))

const { signTypedData, isLoading, error } = useSignTypedData()

const sig = await signTypedData({
  domain: { name: 'MyApp', version: '1', chainId: 1 },
  types: { MyType: [{ name: 'value', type: 'uint256' }] },
  primaryType: 'MyType',
  message: { value: 42 },
})

const { signTransaction, sendTransaction, isLoading, error } = useSignTransaction()

// Sign only (returns raw signed tx hex):
const rawTx = await signTransaction({ to: '0x...', value: 0n, chainId: 1 })

// Sign + auto-fill + broadcast (returns tx hash):
const txHash = await sendTransaction({
  to: '0xRecipient',
  value: 1_000_000_000_000_000n,
  chainId: 1,
})

// With calldata for smart contract calls:
const txHash = await sendTransaction({
  to: '0xContractAddress',
  data: '0xa9059cbb000000...', // calldata
  chainId: 1,
})

// Override specific fields (nonce, gas, fees):
const txHash = await sendTransaction({
  to: '0xRecipient',
  value: 0n,
  chainId: 1,
  nonce: 42,
  gasLimit: 500_000n,
  maxFeePerGas: '0x3B9ACA00',
})

// Optional rpcUrl override (falls back to evmRpcUrl from config):
const txHash = await sendTransaction(tx, 'https://custom-rpc.com')

const { signSolanaTransaction, sendSolanaTransaction, isLoading, error } = useSignSolanaTransaction()

// Sign only (returns Ed25519 signature hex):
const sigHex = await signSolanaTransaction(messageBytes)

// Sign + assemble + broadcast (returns base58 tx signature):
const txSig = await sendSolanaTransaction(messageBytes)

// Optional rpcUrl override:
const txSig = await sendSolanaTransaction(messageBytes, 'https://api.devnet.solana.com')

const { estimateGas, isLoading, error } = useEstimateGas()

const gas: bigint = await estimateGas({
  to: '0xRecipient',
  value: '0x16345785D8A0000',
  chainId: 1,
})

const { balance, isLoading, error, refetch } = useBalance()

// balance: bigint | null (wei), null if not yet fetched
// Example: display in ETH
const ethDisplay = balance !== null
  ? (Number(balance) / 1e18).toFixed(6) + ' ETH'
  : 'Loading…'

// Optional: custom RPC and poll interval
const { balance } = useBalance('https://custom-rpc.com', 30_000)

// Disable auto-polling
const { balance, refetch } = useBalance(undefined, 0)

const { balance, isLoading, error, refetch } = useTokenBalance(
  '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' // USDC
)
// balance: bigint | null (smallest unit)
// For USDC (6 decimals): Number(balance) / 1e6

const { balance, isLoading, error, refetch } = useSolanaBalance()
// balance: bigint | null (lamports)
// Display in SOL: (Number(balance) / 1e9).toFixed(6) + ' SOL'

const { requestExport, confirmExport, isLoading } = useExportKey()
// or for Solana:
const { requestExport, confirmExport, isLoading } = useSolanaExportKey()

// Step 1: returns masked email (e.g. "a***@example.com")
const maskedEmail = await requestExport()

// Step 2: verify OTP — key shown in iframe
await confirmExport('123456')