# Chipi SDK

- [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 — 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 — 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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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`.
- [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 — 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 — 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.
- [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.
- [Refunds & failed purchases](https://docs.chipipay.com/services/bills/refunds.md): When a bill payment, recharge, or gift card can't be fulfilled after the user paid, return their money — safely, idempotently, and in the right place depending on how you collected it.
- [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.
- [Quickstart](https://docs.chipipay.com/services/ai-api/quickstart.md): Get an AI response in 30 seconds. No SDK needed — just HTTP.
- [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.
- [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.
- [Models & Pricing](https://docs.chipipay.com/services/ai-api/models.md): 8 AI models across 3 providers. Pay per token with USDC credits.
- [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.
- [Endpoints](https://docs.chipipay.com/services/gift-cards/endpoints.md): All Gift Cards API endpoints — create, validate, redeem, bulk, status.
- [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.
- [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.
- [NextJS SDK Introduction](https://docs.chipipay.com/sdk/nextjs/introduction.md): Learn about the NextJS SDK capabilities and what you can build with it
- [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 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 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.
- [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 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.
- [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.
- [Use Passkeys as a PIN](https://docs.chipipay.com/sdk/nextjs/use-passkeys.md): Secure wallet authentication with biometric passkeys instead of PINs
- [Agent with a session key and a passkey](https://docs.chipipay.com/sdk/guides/agent-sessions.md): Let a server-side agent spend from a user's self-custodial wallet within on-chain caps: one passkey prompt to hire it, one to stop it.
- [Set up](https://docs.chipipay.com/sdk/nextjs/pay-with-crypto.md): Add a crypto payment button to your website in minutes
- [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.
- [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.
- [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.
- [useGetWallet](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-wallet.md): Get an authenticated user Wallet
- [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.
- [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.
- [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.
- [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.
- [useGetTokenBalance](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-token-balance.md): Fetches the on-chain token balance for a wallet address.
- [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.
- [useGetTransaction](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [useGetTransactionStatus](https://docs.chipipay.com/sdk/nextjs/hooks/use-get-transaction-status.md): Fetches and polls the on-chain status of a transaction.
- [useMigrateWalletToPasskey](https://docs.chipipay.com/sdk/nextjs/hooks/use-migrate-wallet-to-passkey.md): Migrates an existing PIN-encrypted wallet to passkey (biometric) authentication.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Private Balances (shield / unshield)](https://docs.chipipay.com/sdk/guides/private-balances.md): Add confidential balances to your app: users shield USDC into the STRK20 privacy pool so only they can see what they keep. Self-custodial, gasless for the end user.
- [useShield / useUnshield / usePrivateBalance](https://docs.chipipay.com/sdk/react/privacy-hooks.md): Privacy hooks over the mainnet-proven STRK20 engine in @chipi-stack/core.
- [Expo SDK Introduction](https://docs.chipipay.com/sdk/expo/introduction.md): Learn about the Expo SDK capabilities and what you can build with it
- [Quickstart](https://docs.chipipay.com/sdk/expo/gasless-quickstart.md): Quick setup guide for gasless transactions with Chipi SDK in Expo applications
- [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 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.
- [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.
- [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 PIN backup for recovery.
- [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.
- [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.
- [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.
- [useGetWallet](https://docs.chipipay.com/sdk/expo/hooks/use-get-wallet.md): Get an authenticated user Wallet
- [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.
- [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.
- [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.
- [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.
- [useGetTokenBalance](https://docs.chipipay.com/sdk/expo/hooks/use-get-token-balance.md): Fetches the on-chain token balance for a wallet address.
- [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.
- [useGetTransaction](https://docs.chipipay.com/sdk/expo/hooks/use-get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [useGetTransactionStatus](https://docs.chipipay.com/sdk/expo/hooks/use-get-transaction-status.md): Fetches and polls the on-chain status of a transaction.
- [useMigrateWalletToPasskey](https://docs.chipipay.com/sdk/expo/hooks/use-migrate-wallet-to-passkey.md): Migrates an existing PIN-encrypted wallet to passkey (biometric) authentication.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [React SDK Introduction](https://docs.chipipay.com/sdk/react/introduction.md): Learn about the React SDK capabilities and what you can build with it
- [Quickstart](https://docs.chipipay.com/sdk/react/gasless-quickstart.md): Quick setup guide for gasless transactions with Chipi SDK in React applications
- [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 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.
- [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 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.
- [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.
- [Use Passkeys as a PIN](https://docs.chipipay.com/sdk/react/use-passkeys.md): Secure wallet authentication with biometric passkeys instead of PINs
- [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.
- [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.
- [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.
- [useGetWallet](https://docs.chipipay.com/sdk/react/hooks/use-get-wallet.md): Get an authenticated user Wallet
- [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.
- [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.
- [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.
- [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.
- [useGetTokenBalance](https://docs.chipipay.com/sdk/react/hooks/use-get-token-balance.md): Fetches the on-chain token balance for a wallet address.
- [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.
- [useGetTransaction](https://docs.chipipay.com/sdk/react/hooks/use-get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [useGetTransactionStatus](https://docs.chipipay.com/sdk/react/hooks/use-get-transaction-status.md): Fetches and polls the on-chain status of a transaction.
- [useMigrateWalletToPasskey](https://docs.chipipay.com/sdk/react/hooks/use-migrate-wallet-to-passkey.md): Migrates an existing PIN-encrypted wallet to passkey (biometric) authentication.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [useShield / useUnshield / usePrivateBalance](https://docs.chipipay.com/sdk/react/privacy-hooks.md): Privacy hooks over the mainnet-proven STRK20 engine in @chipi-stack/core.
- [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
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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
- [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_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.
- [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.
- [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
- [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
- [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.
- [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.
- [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.
- [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.
- [waitForTransaction](https://docs.chipipay.com/sdk/backend/methods/wait-for-transaction.md): Polls a Starknet transaction to a terminal state and reports success, revert reason and raw events. A revert is a result, not an exception.
- [getTokenBalance](https://docs.chipipay.com/sdk/backend/methods/get-token-balance.md): Fetches the on-chain token balance for a wallet on Starknet.
- [getTransactionList](https://docs.chipipay.com/sdk/backend/methods/get-transaction-list.md): Fetches a paginated list of transactions with optional filtering.
- [getTransaction](https://docs.chipipay.com/sdk/backend/methods/get-transaction.md): Fetches a single transaction by its hash or internal ID.
- [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.
- [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.
- [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.
- [Core SDK](https://docs.chipipay.com/sdk/core/introduction.md): Transaction primitives for the Chipi SDK ecosystem: Amount, TxBuilder, ERC20, TokenRegistry, and SignerAdapter.
- [Amount](https://docs.chipipay.com/sdk/core/amount.md): Immutable token amount class with safe BigInt arithmetic, parsing, and formatting.
- [TxBuilder](https://docs.chipipay.com/sdk/core/tx-builder.md): Fluent builder for batching StarkNet multicalls into atomic transactions with fee estimation.
- [Erc20](https://docs.chipipay.com/sdk/core/erc20.md): Typed ERC20 contract wrapper that returns Amount objects for balances and allowances.
- [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.
- [SignerAdapter](https://docs.chipipay.com/sdk/core/signer-adapter.md): Unified signing interface with implementations for passkeys, direct keys, and external providers.
- [Privacy (STRK20 shield/unshield)](https://docs.chipipay.com/sdk/core/privacy.md): The confidential-balance engine inside @chipi-stack/core: companion accounts, gas-tank funding, proving, and gateway submission.
- [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.
- [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.
- [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 an optional PIN backup helps.
- [Connector](https://docs.chipipay.com/sdk/connector/overview.md): Let any Starknet dApp offer a Chipi wallet (passkey, gasless) next to Bramble, Ready and Braavos. No extension, no WalletConnect, no whitelisting.
- [Security model](https://docs.chipipay.com/sdk/connector/security.md): Who approves what in Connect with Chipi, what the SDK enforces in code, the wallet's error codes, and what a wallet host must do with message origins.
- [API reference](https://docs.chipipay.com/sdk/connector/api.md): ChipiConnector options, window registration, passive calls, errors, the Wallet Standard wallet and compatibility.
- [x402 Payment Protocol](https://docs.chipipay.com/sdk/guides/x402-introduction.md): Pay-per-request APIs using USDC on Starknet
- [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 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.
- [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
- [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
- [Session Keys](https://docs.chipipay.com/sdk/guides/session-keys.md): Enable frictionless transactions without requiring user approval for every action
- [Agent with a session key and a passkey](https://docs.chipipay.com/sdk/guides/agent-sessions.md): Let a server-side agent spend from a user's self-custodial wallet within on-chain caps: one passkey prompt to hire it, one to stop it.
- [Sign in with Starknet](https://docs.chipipay.com/sdk/guides/sign-in-with-starknet.md): Let users sign in with the wallet they already have (Bramble, Braavos, Ready): a SNIP-12 message, a one-time nonce, and a check by the account itself. No email, no password.
- [Trusted wallets](https://docs.chipipay.com/sdk/guides/trusted-wallets.md): Make Bramble, Braavos, Ready or another Chipi wallet a co-owner or a recovery guardian of a Chipi wallet. Its key never leaves that wallet.
- [Passkeys](https://docs.chipipay.com/sdk/guides/passkeys.md): Passkey-only wallets for self-custodial apps, with an optional PIN backup
- [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.
- [Error Handling](https://docs.chipipay.com/sdk/guides/error-handling.md): Handle errors gracefully with Chipi's typed error hierarchy and utility functions
- [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.
- [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.
- [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.
- [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.
- [Private Balances (shield / unshield)](https://docs.chipipay.com/sdk/guides/private-balances.md): Add confidential balances to your app: users shield USDC into the STRK20 privacy pool so only they can see what they keep. Self-custodial, gasless for the end user.
- [v14.17.0: SHHH V8.5, and Bramble as co-owner or guardian](https://docs.chipipay.com/sdk/releases/v14-17-0.md): What v14.17.0 adds: new SHHH wallets deploy V8.5, which enforces the threshold for single signers; Bramble, Braavos, Ready and other Chipi wallets can co-own or guard a Chipi wallet (STARK_SNIP12); and Connect with Chipi 0.5.0 sits quietly next to Bramble.
- [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.
- [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.
- [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
- [Get Wallet](https://docs.chipipay.com/sdk/api/endpoint/get-wallet.md): Retrieve a wallet by external user ID
- [Get Token Balance](https://docs.chipipay.com/sdk/api/endpoint/get-token-balance.md): Get the balance of a specific token for a wallet
- [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
- [Record Send Transaction](https://docs.chipipay.com/sdk/api/endpoint/record-send-transaction.md): Record a token transfer that was executed on-chain
- [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

## OpenAPI Specs

- [openapi](/sdk/api/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.