# Chipi SDK

## Docs

- [Get Token Balance](https://docs.chipipay.com/sdk/api/endpoint/get-token-balance.md): Get the balance of a specific token for a wallet
- [Get Transaction List](https://docs.chipipay.com/sdk/api/endpoint/get-transaction-list.md): Get paginated transaction history for a wallet
- [Get USD Amount](https://docs.chipipay.com/sdk/api/endpoint/get-usd-amount.md): Convert an amount from MXN or other currency to USD
- [Get Wallet](https://docs.chipipay.com/sdk/api/endpoint/get-wallet.md): Retrieve a wallet by external user ID
- [Record Send Transaction](https://docs.chipipay.com/sdk/api/endpoint/record-send-transaction.md): Record a token transfer that was executed on-chain
- [Update Wallet Encryption](https://docs.chipipay.com/sdk/api/endpoint/update-wallet-encryption.md): Replace the stored encrypted private key after a passkey or PIN change
- [Introduction to Chipi Pay API](https://docs.chipipay.com/sdk/api/introduction.md): REST API for creating self-custodial wallets, executing gasless transactions, and purchasing services on Starknet.
- [API Quickstart](https://docs.chipipay.com/sdk/api/quickstart.md): Get started with the Chipi API - learn how to authenticate, make requests, and handle responses
- [Quickstart](https://docs.chipipay.com/sdk/api/wallets-quickstart.md): Quick setup guide for gasless transactions using only the Chipi API
- [callAnyContract](https://docs.chipipay.com/sdk/backend/methods/call-any-contract.md): Executes any StarkNet contract method. Handles all contract interactions not covered by specific methods, giving you full flexibility to interact with any smart contract.
- [createWallet](https://docs.chipipay.com/sdk/backend/methods/create-wallet.md): Creates a new wallet on StarkNet. Deploys the wallet contract and sponsors gas fees via the Chipi paymaster, resulting in a frictionless onboarding experience.
- [executeWalletUpgrade](https://docs.chipipay.com/sdk/backend/methods/execute-wallet-upgrade.md): Executes a wallet upgrade after the owner has signed the typed data from prepareWalletUpgrade.
- [getTokenBalance](https://docs.chipipay.com/sdk/backend/methods/get-token-balance.md): Fetches the on-chain token balance for a wallet on Starknet.
- [getTransaction](https://docs.chipipay.com/sdk/backend/methods/get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [getTransactionList](https://docs.chipipay.com/sdk/backend/methods/get-transaction-list.md): Fetches a paginated list of transactions with optional filtering.
- [getTransactionStatus](https://docs.chipipay.com/sdk/backend/methods/get-transaction-status.md): Fetches the on-chain status of a transaction from StarkNet. Useful for polling until confirmation.
- [getUsdAmount](https://docs.chipipay.com/sdk/backend/methods/get-usd-amount.md): Converts a currency amount to its USD equivalent using current exchange rates.
- [getWallet](https://docs.chipipay.com/sdk/backend/methods/get-wallet.md): Retrieves wallet information for an existing user by their external user ID. This method allows you to fetch wallet details for users who have already created wallets.
- [prepareWalletUpgrade](https://docs.chipipay.com/sdk/backend/methods/prepare-wallet-upgrade.md): Prepares a wallet upgrade (e.g., READY to CHIPI or CHIPI v29 to v33). Returns typed data that must be signed by the wallet owner.
- [Session Key Methods](https://docs.chipipay.com/sdk/backend/methods/sessions.md): API reference for session key management - create, register, execute, query, and revoke delegated access
- [Spending Policy Methods](https://docs.chipipay.com/sdk/backend/methods/spending-policies.md): API reference for spending policy management — set, query, and remove per-token spending caps on session keys
- [transfer](https://docs.chipipay.com/sdk/backend/methods/transfer.md): Transfers tokens from a user wallet to another address. Uses Avnus gasless to cover gas fees, making transactions frictionless for your users.
- [Backend SDK Quickstart](https://docs.chipipay.com/sdk/backend/quickstart.md): Quick setup guide for the Chipi Backend SDK - server-side wallet management and transactions
- [Session Keys Quickstart](https://docs.chipipay.com/sdk/backend/sessions-quickstart.md): Enable temporary, delegated transaction execution without requiring the owner's private key for each operation
- [Amount](https://docs.chipipay.com/sdk/core/amount.md): Immutable token amount class with safe BigInt arithmetic, parsing, and formatting.
- [Erc20](https://docs.chipipay.com/sdk/core/erc20.md): Typed ERC20 contract wrapper that returns Amount objects for balances and allowances.
- [Core SDK](https://docs.chipipay.com/sdk/core/introduction.md): Transaction primitives for the Chipi SDK ecosystem: Amount, TxBuilder, ERC20, TokenRegistry, and SignerAdapter.
- [SignerAdapter](https://docs.chipipay.com/sdk/core/signer-adapter.md): Unified signing interface with implementations for passkeys, direct keys, and external providers.
- [TokenRegistry](https://docs.chipipay.com/sdk/core/token-registry.md): Token metadata lookup by symbol or address, with built-in presets for StarkNet mainnet and Sepolia.
- [TxBuilder](https://docs.chipipay.com/sdk/core/tx-builder.md): Fluent builder for batching StarkNet multicalls into atomic transactions with fee estimation.
- [Expo with Clerk](https://docs.chipipay.com/sdk/expo/gasless-clerk-setup.md): Learn how to integrate Chipi Pay with your Expo application using Clerk Auth for authentication and biometric security.
- [Expo with Custom Auth](https://docs.chipipay.com/sdk/expo/gasless-custom-auth-setup.md): Integrate Chipi Pay with any OIDC-compliant auth provider (Auth0, Cognito, Okta, Keycloak) in your Expo application.
- [Expo with Firebase](https://docs.chipipay.com/sdk/expo/gasless-firebase-setup.md): Learn how to integrate Chipi Pay with your Expo application using Firebase Auth for authentication and secure wallet storage.
- [Quickstart](https://docs.chipipay.com/sdk/expo/gasless-quickstart.md): Quick setup guide for gasless transactions with Chipi SDK in Expo applications
- [useAddSessionKeyToContract](https://docs.chipipay.com/sdk/expo/hooks/use-add-session-key-to-contract.md): Register a session key on the CHIPI wallet smart contract. This one-time operation requires owner signature and enables the session key to execute transactions.
- [useApprove](https://docs.chipipay.com/sdk/expo/hooks/use-approve.md): Grants permission to a smart contract to spend tokens from the user wallet. Required before staking or other delegated actions.
- [useCallAnyContract](https://docs.chipipay.com/sdk/expo/hooks/use-call-any-contract.md): Executes any StarkNet contract method. Handles all contract interactions not covered by specific hooks.
- [useChipiSession](https://docs.chipipay.com/sdk/expo/hooks/use-chipi-session.md): Unified session key management for gasless UX - create, register, execute, and revoke sessions with a single hook.
- [useChipiWallet](https://docs.chipipay.com/sdk/expo/hooks/use-chipi-wallet.md): All-in-one hook for wallet management - combines wallet fetching, creation, and balance checking into a single unified API.
- [useCreateSessionKey](https://docs.chipipay.com/sdk/expo/hooks/use-create-session-key.md): Generate a session keypair locally for temporary, delegated transaction execution. Session keys enable gasless, frictionless UX without requiring the owner private key for each transaction.
- [useCreateWallet](https://docs.chipipay.com/sdk/expo/hooks/use-create-wallet.md): Creates a new Argent-compatible wallet on StarkNet. This hook deploys the wallet contract behind the scenes and uses Avnus gasless to sponsor gas fees, resulting in a frictionless onboarding experience.
- [useExecuteWithSession](https://docs.chipipay.com/sdk/expo/hooks/use-execute-with-session.md): Execute gasless transactions using a session key instead of the owner private key. Enables frictionless UX for gaming, DeFi automation, and more.
- [useGetSessionData](https://docs.chipipay.com/sdk/expo/hooks/use-get-session-data.md): Query session key status from the CHIPI wallet smart contract. Returns whether the session is active, remaining calls, and allowed entrypoints.
- [useGetTokenBalance](https://docs.chipipay.com/sdk/expo/hooks/use-get-token-balance.md): Fetches the on-chain token balance for a wallet address.
- [useGetTransaction](https://docs.chipipay.com/sdk/expo/hooks/use-get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [useGetTransactionList](https://docs.chipipay.com/sdk/expo/hooks/use-get-transaction-list.md): Fetches a paginated list of transactions with optional date and address filters.
- [useGetTransactionStatus](https://docs.chipipay.com/sdk/expo/hooks/use-get-transaction-status.md): Fetches and polls the on-chain status of a transaction.
- [useGetWallet](https://docs.chipipay.com/sdk/expo/hooks/use-get-wallet.md): Get an authenticated user Wallet
- [useMigrateWalletToPasskey](https://docs.chipipay.com/sdk/expo/hooks/use-migrate-wallet-to-passkey.md): Migrates an existing PIN-encrypted wallet to passkey (biometric) authentication.
- [useRecordSendTransaction](https://docs.chipipay.com/sdk/expo/hooks/use-record-transaction.md): Records a sent transaction in the Chipi system for tracking and analytics purposes.
- [useRevokeSessionKey](https://docs.chipipay.com/sdk/expo/hooks/use-revoke-session-key.md): Revoke a session key from the CHIPI wallet smart contract. After revocation, the session key can no longer execute transactions.
- [useSyncOnChainTransfers](https://docs.chipipay.com/sdk/expo/hooks/use-sync-on-chain-transfers.md): Sync on-chain token transfers into the database. Discovers external receives not made through the SDK.
- [useTransfer](https://docs.chipipay.com/sdk/expo/hooks/use-transfer.md): Transfers tokens from the user wallet to another address. Uses Avnus gasless to cover gas fees.
- [useUpdateWalletEncryption](https://docs.chipipay.com/sdk/expo/hooks/use-update-wallet-encryption.md): Updates a wallet's encrypted private key after the user changes their passkey or PIN.
- [useX402Payment](https://docs.chipipay.com/sdk/expo/hooks/use-x402-payment.md): React hook for the x402 payment protocol. Wraps fetch with automatic HTTP 402 payment handling using USDC on Starknet.
- [Expo SDK Introduction](https://docs.chipipay.com/sdk/expo/introduction.md): Learn about the Expo SDK capabilities and what you can build with it
- [Use Biometrics as a PIN](https://docs.chipipay.com/sdk/expo/use-biometrics.md): Learn how to implement biometric authentication as a PIN alternative in your Expo app
- [Use Passkeys with PIN Backup](https://docs.chipipay.com/sdk/expo/use-passkeys.md): Secure wallet authentication with Face ID / Touch ID on iOS and fingerprint on Android, with a mandatory PIN backup for recovery.
- [Custom Wallet Types](https://docs.chipipay.com/sdk/guides/custom-wallet-types.md): Use custom StarkNet account implementations with the Chipi SDK. Bring your own class hash for advanced account features.
- [Error Handling](https://docs.chipipay.com/sdk/guides/error-handling.md): Handle errors gracefully with Chipi's typed error hierarchy and utility functions
- [Multisig Governance](https://docs.chipipay.com/sdk/guides/multisig-governance.md): Propose, approve, and execute any on-chain action through an N-of-M SHHH multisig — from your own app.
- [On-Chain Verification](https://docs.chipipay.com/sdk/guides/on-chain-verification.md): Verify that token transfers actually happened on-chain by checking Transfer events. A transaction can succeed while the inner transfer fails silently.
- [Passkeys](https://docs.chipipay.com/sdk/guides/passkeys.md): Biometric authentication with automatic PIN backup for wallet security
- [PIN → Passkey Migration](https://docs.chipipay.com/sdk/guides/pin-to-passkey-migration.md): Migrate existing PIN-encrypted wallets to passkey (biometric) authentication for production-grade security.
- [Session Keys](https://docs.chipipay.com/sdk/guides/session-keys.md): Enable frictionless transactions without requiring user approval for every action
- [Spending Policies](https://docs.chipipay.com/sdk/guides/spending-policies.md): Set per-token spending caps on session keys — enforced on-chain by the CHIPI wallet contract
- [Wallet Upgrades](https://docs.chipipay.com/sdk/guides/wallet-upgrades.md): How to upgrade wallets between types and versions — READY to CHIPI, or CHIPI v29 to v33.
- [x402 Client — Paying for APIs](https://docs.chipipay.com/sdk/guides/x402-client.md): Use Chipi wallets to pay for x402-protected API endpoints
- [x402 Payment Protocol](https://docs.chipipay.com/sdk/guides/x402-introduction.md): Pay-per-request APIs using USDC on Starknet
- [x402 Server — Monetizing APIs](https://docs.chipipay.com/sdk/guides/x402-server.md): Accept x402 payments on your API endpoints with Chipi's paymaster
- [x402 + Session Keys](https://docs.chipipay.com/sdk/guides/x402-sessions.md): Automated x402 payments using SNIP-9 session keys
- [x402 Buyers — SHHH Wallets](https://docs.chipipay.com/sdk/guides/x402-shhh-buyers.md): Pay for x402-protected APIs from a SHHH V8.4 wallet. Uses X402ShhhClient, which handles the V8.4 envelope shape the existing X402Client can't produce.
- [Server SDK (createChipiServer)](https://docs.chipipay.com/sdk/nextjs/create-chipi-server.md): Create a server-side Chipi SDK singleton for use in Next.js Server Components and Route Handlers.
- [Next.js with Better Auth](https://docs.chipipay.com/sdk/nextjs/gasless-better-auth-setup.md): Learn how to integrate Chipi Pay with your Next.js application using Better Auth for authentication and secure wallet storage.
- [Next.js with Clerk](https://docs.chipipay.com/sdk/nextjs/gasless-clerk-setup.md): Learn how to integrate Chipi Pay with your Next.js application using Clerk for authentication and secure wallet storage.
- [Next.js with Custom Auth](https://docs.chipipay.com/sdk/nextjs/gasless-custom-auth-setup.md): Integrate Chipi Pay with any OIDC-compliant auth provider (Auth0, Cognito, Okta, Keycloak) in your Next.js application.
- [Next.js with Firebase](https://docs.chipipay.com/sdk/nextjs/gasless-firebase-setup.md): Learn how to integrate Chipi Pay with your Next.js application using Firebase Auth for authentication and secure wallet storage.
- [Quickstart](https://docs.chipipay.com/sdk/nextjs/gasless-quickstart.md): Quick setup guide for gasless transactions with Chipi SDK in Next.js applications
- [Next.js with Supabase](https://docs.chipipay.com/sdk/nextjs/gasless-supabase-setup.md): Learn how to integrate Chipi Pay with your Next.js application using Supabase for authentication and secure wallet storage.
- [useAddSessionKeyToContract](https://docs.chipipay.com/sdk/nextjs/hooks/use-add-session-key-to-contract.md): Register a session key on the CHIPI wallet smart contract. This one-time operation requires owner signature and enables the session key to execute transactions.
- [useApprove](https://docs.chipipay.com/sdk/nextjs/hooks/use-approve.md): Grants permission to a smart contract to spend tokens from the user wallet. Required before staking or other delegated actions.
- [useCallAnyContract](https://docs.chipipay.com/sdk/nextjs/hooks/use-call-any-contract.md): Executes any StarkNet contract method. Handles all contract interactions not covered by specific hooks.
- [useChipiSession](https://docs.chipipay.com/sdk/nextjs/hooks/use-chipi-session.md): Unified session key management for gasless UX - create, register, execute, and revoke sessions with a single hook.
- [useChipiWallet](https://docs.chipipay.com/sdk/nextjs/hooks/use-chipi-wallet.md): All-in-one hook for wallet management - combines wallet fetching, creation, and balance checking into a single unified API.
- [useCreateSessionKey](https://docs.chipipay.com/sdk/nextjs/hooks/use-create-session-key.md): Generate a session keypair locally for temporary, delegated transaction execution. Session keys enable gasless, frictionless UX without requiring the owner private key for each transaction.
- [useCreateWallet](https://docs.chipipay.com/sdk/nextjs/hooks/use-create-wallet.md): Creates a new Argent-compatible wallet on StarkNet. This hook deploys the wallet contract behind the scenes and uses Avnus gasless to sponsor gas fees, resulting in a frictionless onboarding experience.
- [useExecuteWithSession](https://docs.chipipay.com/sdk/nextjs/hooks/use-execute-with-session.md): Execute gasless transactions using a session key instead of the owner private key. Enables frictionless UX for gaming, DeFi automation, and more.
- [useGetSessionData](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-session-data.md): Query session key status from the CHIPI wallet smart contract. Returns whether the session is active, remaining calls, and allowed entrypoints.
- [useGetTokenBalance](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-token-balance.md): Fetches the on-chain token balance for a wallet address.
- [useGetTransaction](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [useGetTransactionList](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-transaction-list.md): Fetches a paginated list of transactions with optional date and address filters.
- [useGetTransactionStatus](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-transaction-status.md): Fetches and polls the on-chain status of a transaction.
- [useGetWallet](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-wallet.md): Get an authenticated user Wallet
- [useMigrateWalletToPasskey](https://docs.chipipay.com/sdk/nextjs/hooks/use-migrate-wallet-to-passkey.md): Migrates an existing PIN-encrypted wallet to passkey (biometric) authentication.
- [useRecordSendTransaction](https://docs.chipipay.com/sdk/nextjs/hooks/use-record-transaction.md): Records a send transaction in the Chipi system for tracking and webhook notifications.
- [useRevokeSessionKey](https://docs.chipipay.com/sdk/nextjs/hooks/use-revoke-session-key.md): Revoke a session key from the CHIPI wallet smart contract. After revocation, the session key can no longer execute transactions.
- [useSyncOnChainTransfers](https://docs.chipipay.com/sdk/nextjs/hooks/use-sync-on-chain-transfers.md): Sync on-chain token transfers into the database. Discovers external receives not made through the SDK.
- [useTransfer](https://docs.chipipay.com/sdk/nextjs/hooks/use-transfer.md): Transfers tokens from the user wallet to another address. Uses Avnus gasless to cover gas fees.
- [useUpdateWalletEncryption](https://docs.chipipay.com/sdk/nextjs/hooks/use-update-wallet-encryption.md): Updates a wallet's encrypted private key after the user changes their passkey or PIN.
- [useX402Payment](https://docs.chipipay.com/sdk/nextjs/hooks/use-x402-payment.md): React hook for the x402 payment protocol. Wraps fetch with automatic HTTP 402 payment handling using USDC on Starknet.
- [NextJS SDK Introduction](https://docs.chipipay.com/sdk/nextjs/introduction.md): Learn about the NextJS SDK capabilities and what you can build with it
- [Set up](https://docs.chipipay.com/sdk/nextjs/pay-with-crypto.md): Add a crypto payment button to your website in minutes
- [Set Up the Chipi MCP Server](https://docs.chipipay.com/sdk/nextjs/set-up-mcp-server.md): This guide walks you through setting up and using the Chipi MCP (Model Component Protocol) server. With it, you can seamlessly integrate Chipi’s UI components, utilities, and APIs into your project via standardized registries.
- [Use Passkeys as a PIN](https://docs.chipipay.com/sdk/nextjs/use-passkeys.md): Secure wallet authentication with biometric passkeys instead of PINs
- [callAnyContract](https://docs.chipipay.com/sdk/other-frontend/methods/call-any-contract.md): Executes any StarkNet contract method. Handles all contract interactions not covered by specific methods, giving you full flexibility to interact with any smart contract.
- [createWallet](https://docs.chipipay.com/sdk/other-frontend/methods/create-wallet.md): Creates a new Argent-compatible wallet on StarkNet. This method deploys the wallet contract behind the scenes and uses Avnus gasless to sponsor gas fees, resulting in a frictionless onboarding experience.
- [getTransaction](https://docs.chipipay.com/sdk/other-frontend/methods/get-transaction.md): Fetches a single transaction by its hash or internal ID. Works with Vue, Angular, Svelte, and vanilla JavaScript.
- [getTransactionStatus](https://docs.chipipay.com/sdk/other-frontend/methods/get-transaction-status.md): Fetches the on-chain status of a transaction from StarkNet. Works with Vue, Angular, Svelte, and vanilla JavaScript.
- [getWallet](https://docs.chipipay.com/sdk/other-frontend/methods/get-wallet.md): Retrieves wallet information for an existing user by their external user ID. This method allows you to fetch wallet details for users who have already created wallets.
- [Session Keys](https://docs.chipipay.com/sdk/other-frontend/methods/sessions.md): Enable temporary, delegated transaction execution using the ChipiBrowserSDK. Session keys allow gasless, frictionless UX without requiring the owner private key for each transaction.
- [transfer](https://docs.chipipay.com/sdk/other-frontend/methods/transfer.md): Transfers tokens from a user wallet to another address. Uses Avnus gasless to cover gas fees, making transactions frictionless for your users.
- [Not using React? Quickstart](https://docs.chipipay.com/sdk/other-frontend/quickstart.md): Quick setup guide for the Chipi Browser SDK - client-side wallet management for Vue, Angular, Svelte, and vanilla JavaScript
- [Signature Validation](https://docs.chipipay.com/sdk/other-frontend/signature-validation.md): Learn how to verify webhook signatures to ensure secure communication with Chipi Pay
- [API Reference](https://docs.chipipay.com/sdk/passkeys/api.md): Every function and React hook exported from @chipi-stack/chipi-passkey. Grouped by which wallet type they apply to.
- [Passkeys](https://docs.chipipay.com/sdk/passkeys/overview.md): Sign Starknet transactions with Touch ID, Face ID, or Windows Hello. The user's private key never leaves their device, and they never type a password.
- [Quickstart](https://docs.chipipay.com/sdk/passkeys/quickstart.md): Register a passkey, create a Chipi wallet protected by it, and sign a transaction. End-to-end React example you can paste into a Next.js page.
- [When Passkeys Fail](https://docs.chipipay.com/sdk/passkeys/when-passkeys-fail.md): Real failure modes — lost device, browser switch, broken biometrics — and what your app should show the user. Plus when to add a PIN backup.
- [create_wallet](https://docs.chipipay.com/sdk/python/methods/create-wallet.md): Creates a new wallet on Starknet. This method deploys the wallet contract and uses Chipi gasless paymaster to sponsor gas fees, resulting in a frictionless onboarding experience.
- [get_token_balance](https://docs.chipipay.com/sdk/python/methods/get-token-balance.md): Fetches the on-chain token balance for a wallet on Starknet.
- [get_transaction](https://docs.chipipay.com/sdk/python/methods/get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [get_transaction_status](https://docs.chipipay.com/sdk/python/methods/get-transaction-status.md): Fetches the on-chain status of a transaction from StarkNet.
- [get_wallet](https://docs.chipipay.com/sdk/python/methods/get-wallet.md): Retrieves wallet information for a user by their external user ID.
- [transfer](https://docs.chipipay.com/sdk/python/methods/transfer.md): Transfers tokens from a wallet to another address. Uses Chipi gasless paymaster to cover gas fees, making transactions frictionless for your users.
- [Python SDK Quickstart](https://docs.chipipay.com/sdk/python/quickstart.md): Quick setup guide for the Chipi Python SDK - server-side wallet management and gasless transactions for Python applications
- [React with Better Auth](https://docs.chipipay.com/sdk/react/gasless-better-auth-setup.md): Learn how to integrate Chipi Pay with your React application using Better Auth for authentication and secure wallet storage.
- [React with Clerk](https://docs.chipipay.com/sdk/react/gasless-clerk-setup.md): Learn how to integrate Chipi Pay with your React application using Clerk for authentication and secure wallet storage.
- [React with Custom Auth](https://docs.chipipay.com/sdk/react/gasless-custom-auth-setup.md): Integrate Chipi Pay with any OIDC-compliant auth provider (Auth0, Cognito, Okta, Keycloak) in your React application.
- [React with Firebase](https://docs.chipipay.com/sdk/react/gasless-firebase-setup.md): Learn how to integrate Chipi Pay with your React application using Firebase Auth for authentication and secure wallet storage.
- [Quickstart](https://docs.chipipay.com/sdk/react/gasless-quickstart.md): Quick setup guide for gasless transactions with Chipi SDK in React applications
- [React with Supabase](https://docs.chipipay.com/sdk/react/gasless-supabase-setup.md): Learn how to integrate Chipi Pay with your React application using Supabase for authentication and secure wallet storage.
- [useAddSessionKeyToContract](https://docs.chipipay.com/sdk/react/hooks/use-add-session-key-to-contract.md): Register a session key on the CHIPI wallet smart contract. This one-time operation requires owner signature and enables the session key to execute transactions.
- [useApprove](https://docs.chipipay.com/sdk/react/hooks/use-approve.md): Grants permission to a smart contract to spend tokens from the user wallet. Required before staking or other delegated actions.
- [useCallAnyContract](https://docs.chipipay.com/sdk/react/hooks/use-call-any-contract.md): Executes any StarkNet contract method. Handles all contract interactions not covered by specific hooks.
- [useChipiSession](https://docs.chipipay.com/sdk/react/hooks/use-chipi-session.md): Unified session key management for gasless UX - create, register, execute, and revoke sessions with a single hook.
- [useChipiWallet](https://docs.chipipay.com/sdk/react/hooks/use-chipi-wallet.md): All-in-one hook for wallet management - combines wallet fetching, creation, and balance checking into a single unified API.
- [useCreateSessionKey](https://docs.chipipay.com/sdk/react/hooks/use-create-session-key.md): Generate a session keypair locally for temporary, delegated transaction execution. Session keys enable gasless, frictionless UX without requiring the owner private key for each transaction.
- [useCreateWallet](https://docs.chipipay.com/sdk/react/hooks/use-create-wallet.md): Creates a new Argent-compatible wallet on StarkNet. This hook deploys the wallet contract behind the scenes and uses Avnus gasless to sponsor gas fees, resulting in a frictionless onboarding experience.
- [useExecuteWithSession](https://docs.chipipay.com/sdk/react/hooks/use-execute-with-session.md): Execute gasless transactions using a session key instead of the owner private key. Enables frictionless UX for gaming, DeFi automation, and more.
- [useGetSessionData](https://docs.chipipay.com/sdk/react/hooks/use-get-session-data.md): Query session key status from the CHIPI wallet smart contract. Returns whether the session is active, remaining calls, and allowed entrypoints.
- [useGetTokenBalance](https://docs.chipipay.com/sdk/react/hooks/use-get-token-balance.md): Fetches the on-chain token balance for a wallet address.
- [useGetTransaction](https://docs.chipipay.com/sdk/react/hooks/use-get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [useGetTransactionList](https://docs.chipipay.com/sdk/react/hooks/use-get-transaction-list.md): Fetches a paginated list of transactions with optional date and address filters.
- [useGetTransactionStatus](https://docs.chipipay.com/sdk/react/hooks/use-get-transaction-status.md): Fetches and polls the on-chain status of a transaction.
- [useGetWallet](https://docs.chipipay.com/sdk/react/hooks/use-get-wallet.md): Get an authenticated user Wallet
- [useMigrateWalletToPasskey](https://docs.chipipay.com/sdk/react/hooks/use-migrate-wallet-to-passkey.md): Migrates an existing PIN-encrypted wallet to passkey (biometric) authentication.
- [useRecordSendTransaction](https://docs.chipipay.com/sdk/react/hooks/use-record-transaction.md): Records a send transaction in the Chipi system for tracking and webhook notifications.
- [useRevokeSessionKey](https://docs.chipipay.com/sdk/react/hooks/use-revoke-session-key.md): Revoke a session key from the CHIPI wallet smart contract. After revocation, the session key can no longer execute transactions.
- [useSyncOnChainTransfers](https://docs.chipipay.com/sdk/react/hooks/use-sync-on-chain-transfers.md): Sync on-chain token transfers into the database. Discovers external receives not made through the SDK.
- [useTransfer](https://docs.chipipay.com/sdk/react/hooks/use-transfer.md): Transfers tokens from the user wallet to another address. Uses Avnus gasless to cover gas fees.
- [useUpdateWalletEncryption](https://docs.chipipay.com/sdk/react/hooks/use-update-wallet-encryption.md): Updates a wallet's encrypted private key after the user changes their passkey or PIN.
- [useX402Payment](https://docs.chipipay.com/sdk/react/hooks/use-x402-payment.md): React hook for the x402 payment protocol. Wraps fetch with automatic HTTP 402 payment handling using USDC on Starknet.
- [React SDK Introduction](https://docs.chipipay.com/sdk/react/introduction.md): Learn about the React SDK capabilities and what you can build with it
- [Use Passkeys as a PIN](https://docs.chipipay.com/sdk/react/use-passkeys.md): Secure wallet authentication with biometric passkeys instead of PINs
- [v14.5.0 — SHHH V8.4 is the new default](https://docs.chipipay.com/sdk/releases/v14-5-0.md): What changed when chipi-stack v14.5.0 flipped the createWallet default from CHIPI v29 to SHHH V8.4 STARK, who's affected, and the safe upgrade path for existing integrations.
- [v14.7.0 — External-rooted SHHH: passkey, MetaMask & Phantom](https://docs.chipipay.com/sdk/releases/v14-7-0.md): What v14.7.0 adds: createWallet deploys SHHH wallets whose first owner is an external key (passkey / MetaMask), and Phantom (Ed25519) can co-sign — no Chipi-held key in either case.
- [Chat & Streaming](https://docs.chipipay.com/services/ai-api/chat-and-streaming.md): General-purpose AI chat with 8 models. Synchronous or real-time streaming via SSE.
- [DeFi Intelligence](https://docs.chipipay.com/services/ai-api/defi-intelligence.md): AI portfolio advisor with real-time signals, plus on-chain swap execution on Starknet.
- [Models & Pricing](https://docs.chipipay.com/services/ai-api/models.md): 8 AI models across 3 providers. Pay per token with USDC credits.
- [AI API](https://docs.chipipay.com/services/ai-api/overview.md): 8 models from Anthropic, OpenAI, and Google behind one endpoint. Pay per token in USDC credits, with a sandbox for DEV keys that never calls the provider.
- [Prices & Data](https://docs.chipipay.com/services/ai-api/prices-and-data.md): Real-time token prices, technical signals, and DeFi yields. 90 tokens, 11 chains, 60 fiat currencies.
- [Quickstart](https://docs.chipipay.com/services/ai-api/quickstart.md): Get an AI response in 30 seconds. No SDK needed — just HTTP.
- [Billing & Credits](https://docs.chipipay.com/services/billing/overview.md): How Chipi credits work — what consumes them, how to top up, and where to monitor balance, holds, and the ledger.
- [Bill Payments — Node.js](https://docs.chipipay.com/services/bills/node.md): Browse the SKU catalog, charge your Chipi credits balance for a bill payment, and poll for settlement. Pure REST + customer JWT — no end-user wallet, no on-chain signing.
- [Bill Payments](https://docs.chipipay.com/services/bills/overview.md): Let your users pay 700+ Mexican services — phone recharges, gift cards, utility bills, toll roads — from your pre-funded Chipi credits. One REST endpoint, 170+ brands, USDC settlement, no end-user wallet required.
- [Bill Payments — Python](https://docs.chipipay.com/services/bills/python.md): Browse the SKU catalog, submit a bill payment against your Chipi credits, and poll for settlement using the chipi-stack Python SDK plus httpx. No end-user wallet, no on-chain signing.
- [Bill Payments — React](https://docs.chipipay.com/services/bills/react.md): Browse the SKU catalog, submit a bill payment against your Chipi credits, and poll for settlement using @chipi-stack/chipi-react hooks plus React Query. No end-user wallet, no on-chain signing.
- [Reading State — Node.js](https://docs.chipipay.com/services/gasless/balance.md): Read-only operations every Chipi integration uses: token balances, the SKU catalog, and fiat-to-USD conversions. Zero gas, zero cost.
- [Error Handling — Node.js](https://docs.chipipay.com/services/gasless/errors.md): Concrete examples of every failure path the SDK throws — constructor validation, transfer rejection, missing wallets — plus the typed error classes so you can branch on them with `instanceof`.
- [Upgrade Existing Wallets](https://docs.chipipay.com/services/gasless/migration.md): Add recovery and multi-device support to existing wallets you created before v14.5.0. The wallet's address never changes — same balance, same history, same external integrations.
- [Gasless Wallets — Node.js](https://docs.chipipay.com/services/gasless/node.md): Create a wallet and execute a gasless USDC transfer from a Node.js server using @chipi-stack/backend.
- [Gasless Wallets](https://docs.chipipay.com/services/gasless/overview.md): Give your users a Starknet wallet they sign with Touch ID / Face ID / Windows Hello. They never type a password, never see a seed phrase, and never pay gas.
- [Gasless Wallets — Python](https://docs.chipipay.com/services/gasless/python.md): Create a wallet and look it up with the chipi-stack Python SDK. Code lifted from the Chipi staging smoke test that runs in CI.
- [Recover Access](https://docs.chipipay.com/services/gasless/recovery.md): Help users who lost their device, switched browsers, or forgot their PIN. Two on-chain flows close the lost-key dead end plus a side door for rotating a forgotten PIN.
- [Use Your Exported Key](https://docs.chipipay.com/services/gasless/self-custody.md): Your wallet is self-custodial — you can export the owner private key and operate the account from your own code. This is the dangerous-but-sovereign path: how to sign for a SHHH account with the raw key, in TypeScript or Python.
- [Session Keys — Node.js](https://docs.chipipay.com/services/gasless/sessions.md): Generate a short-lived session key, register it on-chain, execute transactions with it, and revoke. Lets your server act on a user's wallet for a bounded time without holding the user's PIN.
- [Add a Second Device or Co-Signer](https://docs.chipipay.com/services/gasless/threshold.md): Let one wallet be controlled by more than one signer — a passkey on the phone plus a passkey on the laptop, or a user plus an agent. Same on-chain account, multiple ways to approve.
- [Transaction History — Node.js](https://docs.chipipay.com/services/gasless/transactions.md): Paginate a wallet's transaction history, filter by date, and stamp external transaction hashes into Chipi's records.
- [Cross-Chain (CCTP)](https://docs.chipipay.com/services/gift-cards/cross-chain.md): How gift cards bridge USDC from Starknet to Solana via Circle's CCTP V2.
- [Dashboard & Bulk Airdrop](https://docs.chipipay.com/services/gift-cards/dashboard.md): Create gift codes, send bulk emails, and manage campaigns from the dashboard — no code needed.
- [Endpoints](https://docs.chipipay.com/services/gift-cards/endpoints.md): All Gift Cards API endpoints — create, validate, redeem, bulk, status.
- [Gift Cards](https://docs.chipipay.com/services/gift-cards/overview.md): Send USDC to anyone via a redeemable code. Funded from your Chipi credits balance; recipient claims on Starknet or Solana — cross-chain bridging happens automatically.
- [Quickstart](https://docs.chipipay.com/services/gift-cards/quickstart.md): Send USDC to anyone via a redeemable code. No SDK needed — just HTTP.

## OpenAPI Specs

- [openapi](https://docs.chipipay.com/sdk/api/openapi.json)