@chipi-stack/chipi-react 13.13.0 → 14.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Chipi Pay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,43 +1,61 @@
-# Chipi SDK
+# @chipi-stack/chipi-react
 
-Chipi SDK is the easiest way to integrate USDC staking and withdrawal functionality into your React/Next.js application. Add secure wallet management, token staking, and withdrawals to your application in minutes. All transactions are sponsored thanks to Avnu's paymaster.
+React hooks for Chipi Pay. Provides wallet creation, transfers, SKU purchases, and session management.
 
-## Prerequisites
-
-- React 18 or later
-- Node.js >=18.17.0 or later
-- A Chipi account. [Create your account for free](https://dashboard.chipipay.com)
-
-## Installation
-
-The fastest way to get started with Chipi SDK is by following our [Quickstart Guide](https://docs.chipipay.com/gasless/quickstart).
+## Install
 
 ```bash
-npm install @chipi-stack/chipi-react
-# or
-yarn add @chipi-stack/chipi-react
+npm install @chipi-stack/chipi-react @chipi-stack/backend @chipi-stack/types
 ```
 
-## Usage
-
-For detailed information, guides, and examples visit our [documentation](https://docs.chipipay.com).
-
-## Support
-
-You can get in touch with us in any of the following ways:
-
-- Join our [Telegram community](https://t.me/chipi_pay)
-- Visit our [YouTube channel](https://www.youtube.com/@chipipay) for tutorials
-- Email us at support@chipi.com
-
-## Contributing
-
-We're open to all community contributions! If you'd like to contribute in any way, please read our contribution guidelines and code of conduct.
+## Quick Start
+
+```tsx
+import { ChipiProvider, useChipiWallet, useTransfer } from "@chipi-stack/chipi-react";
+import type { ChainToken } from "@chipi-stack/types";
+
+function App() {
+  return (
+    <ChipiProvider config={{ apiPublicKey: "your-key" }}>
+      <Wallet />
+    </ChipiProvider>
+  );
+}
+
+function Wallet() {
+  const { wallet } = useChipiWallet({
+    externalUserId: "user-123",
+    getBearerToken: async () => "your-bearer-token",
+  });
+  const { transfer, isLoading } = useTransfer();
+
+  if (!wallet) return <p>Loading wallet...</p>;
+
+  return (
+    <button
+      onClick={() =>
+        transfer({
+          params: {
+            wallet,
+            token: "USDC" as ChainToken,
+            recipient: "0x...",
+            amount: 10,
+            encryptKey: "user-pin",
+          },
+          bearerToken: "your-bearer-token",
+        })
+      }
+    >
+      {isLoading ? "Sending..." : "Send 10 USDC"}
+    </button>
+  );
+}
+```
 
-## Security
+## Documentation
 
-@chipi-stack/chipi-react follows best practices for security, but 100% security cannot be assured.
+Full docs at [docs.chipipay.com](https://docs.chipipay.com)
 
-@chipi-stack/chipi-react is provided "as is" without any warranty. Use at your own risk.
+## License
 
-For more information and to report security issues, please refer to our [security documentation](https://docs.chipipay.com).
+MIT

package/dist/hooks.d.mts

@@ -1,4 +1,4 @@
-import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams } from '@chipi-stack/types';
+import { CreateWalletParams, CreateWalletResponse, GetWalletParams, GetWalletResponse, ChainToken, GetTokenBalanceResponse, WalletType, WalletData, SessionKeyData, SessionDataResponse, CreateSessionKeyParams, SessionConfig, Call, MigrateWalletToPasskeyParams, UpdateWalletEncryptionParams, UpdateWalletEncryptionResponse, TransferHookInput, ApproveHookInput, GetTransactionListQuery, PaginatedResponse, Transaction, TransactionStatusResponse, CreateSkuPurchaseParams, GetSkuListQuery, Sku, CallAnyContractParams, RecordSendTransactionParams, GetTokenBalanceParams, AddSessionKeyParams, RevokeSessionKeyParams, GetSessionDataParams, ExecuteWithSessionParams, PaymentRequirement, PaymentPayload } from '@chipi-stack/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
 
@@ -524,10 +524,14 @@ declare function useApprove(): {
 type TransactionListInput = {
     query: GetTransactionListQuery;
     getBearerToken?: () => Promise<string | null | undefined>;
-    queryOptions?: Omit<UseQueryOptions<PaginatedResponse<Transaction>, Error>, 'queryKey' | 'queryFn'>;
+    queryOptions?: Omit<UseQueryOptions<PaginatedResponse<Transaction>, Error>, "queryKey" | "queryFn">;
+};
+type FetchTransactionListInput = {
+    query: GetTransactionListQuery;
+    getBearerToken: () => Promise<string | null | undefined>;
 };
 declare function useGetTransactionList(input?: TransactionListInput): {
-    fetchTransactionList: (newInput: TransactionListInput) => Promise<PaginatedResponse<Transaction>>;
+    fetchTransactionList: (newInput: FetchTransactionListInput) => Promise<PaginatedResponse<Transaction>>;
     data: PaginatedResponse<Transaction>;
     error: Error;
     isError: true;
@@ -555,7 +559,7 @@ declare function useGetTransactionList(input?: TransactionListInput): {
     fetchStatus: _tanstack_react_query.FetchStatus;
     promise: Promise<PaginatedResponse<Transaction>>;
 } | {
-    fetchTransactionList: (newInput: TransactionListInput) => Promise<PaginatedResponse<Transaction>>;
+    fetchTransactionList: (newInput: FetchTransactionListInput) => Promise<PaginatedResponse<Transaction>>;
     data: PaginatedResponse<Transaction>;
     error: null;
     isError: false;
@@ -583,7 +587,7 @@ declare function useGetTransactionList(input?: TransactionListInput): {
     fetchStatus: _tanstack_react_query.FetchStatus;
     promise: Promise<PaginatedResponse<Transaction>>;
 } | {
-    fetchTransactionList: (newInput: TransactionListInput) => Promise<PaginatedResponse<Transaction>>;
+    fetchTransactionList: (newInput: FetchTransactionListInput) => Promise<PaginatedResponse<Transaction>>;
     data: undefined;
     error: Error;
     isError: true;
@@ -611,7 +615,7 @@ declare function useGetTransactionList(input?: TransactionListInput): {
     fetchStatus: _tanstack_react_query.FetchStatus;
     promise: Promise<PaginatedResponse<Transaction>>;
 } | {
-    fetchTransactionList: (newInput: TransactionListInput) => Promise<PaginatedResponse<Transaction>>;
+    fetchTransactionList: (newInput: FetchTransactionListInput) => Promise<PaginatedResponse<Transaction>>;
     data: undefined;
     error: null;
     isError: false;
@@ -639,7 +643,7 @@ declare function useGetTransactionList(input?: TransactionListInput): {
     fetchStatus: _tanstack_react_query.FetchStatus;
     promise: Promise<PaginatedResponse<Transaction>>;
 } | {
-    fetchTransactionList: (newInput: TransactionListInput) => Promise<PaginatedResponse<Transaction>>;
+    fetchTransactionList: (newInput: FetchTransactionListInput) => Promise<PaginatedResponse<Transaction>>;
     data: undefined;
     error: null;
     isError: false;
@@ -667,7 +671,7 @@ declare function useGetTransactionList(input?: TransactionListInput): {
     fetchStatus: _tanstack_react_query.FetchStatus;
     promise: Promise<PaginatedResponse<Transaction>>;
 } | {
-    fetchTransactionList: (newInput: TransactionListInput) => Promise<PaginatedResponse<Transaction>>;
+    fetchTransactionList: (newInput: FetchTransactionListInput) => Promise<PaginatedResponse<Transaction>>;
     data: PaginatedResponse<Transaction>;
     isError: false;
     error: null;
@@ -696,6 +700,366 @@ declare function useGetTransactionList(input?: TransactionListInput): {
     promise: Promise<PaginatedResponse<Transaction>>;
 };
 
+type GetTransactionInput = {
+    hashOrId?: string;
+    getBearerToken?: () => Promise<string | null | undefined>;
+    queryOptions?: Omit<UseQueryOptions<Transaction, Error>, "queryKey" | "queryFn">;
+};
+type FetchTransactionInput = {
+    hashOrId: string;
+    getBearerToken: () => Promise<string | null | undefined>;
+};
+declare function useGetTransaction(input?: GetTransactionInput): {
+    fetchTransaction: (newInput: FetchTransactionInput) => Promise<Transaction>;
+    data: Transaction;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Transaction, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Transaction>;
+} | {
+    fetchTransaction: (newInput: FetchTransactionInput) => Promise<Transaction>;
+    data: Transaction;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Transaction, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Transaction>;
+} | {
+    fetchTransaction: (newInput: FetchTransactionInput) => Promise<Transaction>;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Transaction, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Transaction>;
+} | {
+    fetchTransaction: (newInput: FetchTransactionInput) => Promise<Transaction>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Transaction, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Transaction>;
+} | {
+    fetchTransaction: (newInput: FetchTransactionInput) => Promise<Transaction>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Transaction, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Transaction>;
+} | {
+    fetchTransaction: (newInput: FetchTransactionInput) => Promise<Transaction>;
+    data: Transaction;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<Transaction, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<Transaction>;
+};
+
+type GetTransactionStatusInput = {
+    hash?: string;
+    getBearerToken?: () => Promise<string | null | undefined>;
+    /** Polling interval in ms. Defaults to 3000. Set to false to disable polling. */
+    refetchInterval?: number | false;
+    queryOptions?: Omit<UseQueryOptions<TransactionStatusResponse, Error>, "queryKey" | "queryFn" | "refetchInterval">;
+};
+type FetchTransactionStatusInput = {
+    hash: string;
+    getBearerToken: () => Promise<string | null | undefined>;
+};
+declare function useGetTransactionStatus(input?: GetTransactionStatusInput): {
+    fetchTransactionStatus: (newInput: FetchTransactionStatusInput) => Promise<TransactionStatusResponse>;
+    data: TransactionStatusResponse;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<TransactionStatusResponse, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<TransactionStatusResponse>;
+} | {
+    fetchTransactionStatus: (newInput: FetchTransactionStatusInput) => Promise<TransactionStatusResponse>;
+    data: TransactionStatusResponse;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<TransactionStatusResponse, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<TransactionStatusResponse>;
+} | {
+    fetchTransactionStatus: (newInput: FetchTransactionStatusInput) => Promise<TransactionStatusResponse>;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<TransactionStatusResponse, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<TransactionStatusResponse>;
+} | {
+    fetchTransactionStatus: (newInput: FetchTransactionStatusInput) => Promise<TransactionStatusResponse>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<TransactionStatusResponse, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<TransactionStatusResponse>;
+} | {
+    fetchTransactionStatus: (newInput: FetchTransactionStatusInput) => Promise<TransactionStatusResponse>;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<TransactionStatusResponse, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<TransactionStatusResponse>;
+} | {
+    fetchTransactionStatus: (newInput: FetchTransactionStatusInput) => Promise<TransactionStatusResponse>;
+    data: TransactionStatusResponse;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<TransactionStatusResponse, Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<TransactionStatusResponse>;
+};
+
 type PurchaseSkuInput = {
     params: CreateSkuPurchaseParams;
     bearerToken: string;
@@ -892,7 +1256,7 @@ declare function useGetSkuPurchase(input?: GetSkuPurchaseInput): {
 type SkuListInput = {
     query: GetSkuListQuery;
     getBearerToken?: () => Promise<string | null | undefined>;
-    queryOptions?: Omit<UseQueryOptions<PaginatedResponse<Sku>, Error>, 'queryKey' | 'queryFn'>;
+    queryOptions?: Omit<UseQueryOptions<PaginatedResponse<Sku>, Error>, "queryKey" | "queryFn">;
 };
 declare function useGetSkuList(input?: SkuListInput): {
     fetchSkuList: (newInput: SkuListInput) => Promise<PaginatedResponse<Sku>>;
@@ -1275,7 +1639,7 @@ declare function useRecordSendTransaction(): {
 type GetTokenBalanceInput = {
     params?: GetTokenBalanceParams;
     getBearerToken?: () => Promise<string | null | undefined>;
-    queryOptions?: Omit<UseQueryOptions<GetTokenBalanceResponse, Error>, 'queryKey' | 'queryFn'>;
+    queryOptions?: Omit<UseQueryOptions<GetTokenBalanceResponse, Error>, "queryKey" | "queryFn">;
 };
 declare function useGetTokenBalance(input?: GetTokenBalanceInput): {
     fetchTokenBalance: (newInput: GetTokenBalanceInput) => Promise<GetTokenBalanceResponse>;
@@ -1644,4 +2008,89 @@ declare function useExecuteWithSession(): {
     reset: () => void;
 };
 
-export { type ChipiWalletData, type SessionState, type SessionWallet, type UseChipiSessionConfig, type UseChipiSessionReturn, type UseChipiWalletConfig, type UseChipiWalletReturn, useAddSessionKeyToContract, useApprove, useCallAnyContract, useChipiSession, useChipiWallet, useCreateSessionKey, useCreateWallet, useExecuteWithSession, useGetSessionData, useGetSku, useGetSkuList, useGetSkuPurchase, useGetTokenBalance, useGetTransactionList, useGetWallet, useMigrateWalletToPasskey, usePurchaseSku, useRecordSendTransaction, useRevokeSessionKey, useTransfer, useUpdateWalletEncryption };
+/**
+ * Configuration for useX402Payment hook
+ */
+interface UseX402PaymentConfig {
+    /** Wallet data */
+    wallet: WalletData | null | undefined;
+    /** Encryption key for signing */
+    encryptKey: string;
+    /** Function to get the bearer token for API calls */
+    getBearerToken?: () => Promise<string | null | undefined>;
+    /** Static bearer token string (alternative to getBearerToken) */
+    bearerToken?: string;
+    /** Max amount per payment (USDC, human-readable e.g. "1.00") */
+    maxPaymentAmount?: string;
+    /** Alias for maxPaymentAmount */
+    maxAmount?: string;
+    /** Allowed recipient addresses (whitelist). Empty = allow all. */
+    allowedRecipients?: string[];
+    /** Active session for automatic payments (optional) */
+    session?: SessionKeyData | null;
+    /** Callback on successful payment */
+    onPaymentComplete?: (txHash: string, amount: string) => void | Promise<void>;
+}
+/**
+ * Last payment info returned by the hook
+ */
+interface LastPaymentInfo {
+    txHash: string | null;
+    amount: string | null;
+    timestamp: number;
+}
+/**
+ * Return type for useX402Payment hook
+ */
+interface UseX402PaymentReturn {
+    /** Fetch wrapper that auto-handles 402 payments */
+    x402Fetch: (url: string, init?: Record<string, any>) => Promise<Response>;
+    /** Alias for x402Fetch */
+    payFetch: (url: string, init?: Record<string, any>) => Promise<Response>;
+    /** Manual payment signing (for custom flows) */
+    signPayment: (requirement: PaymentRequirement) => Promise<PaymentPayload>;
+    /** Whether a payment is in progress */
+    isPaying: boolean;
+    /** Last payment transaction hash */
+    lastTxHash: string | null;
+    /** Last payment amount (human-readable USDC) */
+    lastAmount: string | null;
+    /** Last payment info (txHash + amount + timestamp) */
+    lastPayment: LastPaymentInfo | null;
+    /** Total USDC spent in this session (human-readable) */
+    totalSpent: string;
+    /** Error from last payment attempt */
+    error: Error | null;
+    /** Total payments made in this session */
+    paymentCount: number;
+}
+/**
+ * React hook for x402 payment protocol support.
+ *
+ * Wraps fetch calls with automatic HTTP 402 payment handling.
+ * When a server returns 402, the hook:
+ * 1. Parses the payment requirement
+ * 2. Validates against configured limits
+ * 3. Signs using the wallet (or session key for automatic payments)
+ * 4. Retries with the X-PAYMENT header
+ *
+ * @example
+ * ```tsx
+ * const { x402Fetch, isPaying, lastTxHash, paymentCount } = useX402Payment({
+ *   wallet,
+ *   encryptKey: pin,
+ *   getBearerToken: getToken,
+ *   maxPaymentAmount: "1.00",
+ *   onPaymentComplete: (txHash, amount) => {
+ *     console.log(`Paid ${amount} USDC, tx: ${txHash}`);
+ *   },
+ * });
+ *
+ * // Automatic 402 handling
+ * const response = await x402Fetch("https://api.example.com/premium");
+ * const data = await response.json();
+ * ```
+ */
+declare function useX402Payment(config: UseX402PaymentConfig): UseX402PaymentReturn;
+
+export { type ChipiWalletData, type SessionState, type SessionWallet, type UseChipiSessionConfig, type UseChipiSessionReturn, type UseChipiWalletConfig, type UseChipiWalletReturn, type UseX402PaymentConfig, type UseX402PaymentReturn, useAddSessionKeyToContract, useApprove, useCallAnyContract, useChipiSession, useChipiWallet, useCreateSessionKey, useCreateWallet, useExecuteWithSession, useGetSessionData, useGetSku, useGetSkuList, useGetSkuPurchase, useGetTokenBalance, useGetTransaction, useGetTransactionList, useGetTransactionStatus, useGetWallet, useMigrateWalletToPasskey, usePurchaseSku, useRecordSendTransaction, useRevokeSessionKey, useTransfer, useUpdateWalletEncryption, useX402Payment };