@fiatsend/core 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,4719 @@
+import { PublicClient, WalletClient } from 'viem';
+import { Address, RegisterMobileParams, TransactionResult, RegisterMobileWithSignatureParams, MobileNumberNFT, KYCLevel, OfframpParams, OfframpResult, GatewayConfig, SendPaymentParams, SendToPhoneParams, CreatePaymentRequestParams, Hash, PaymentRequest, Withdrawal, PoolInfo, UserPoolPosition, VaultInfo, UserVaultPosition, CreatePayoutParams, CreateBatchPayoutParams, Payout, CreateP2POrderParams, P2POrder } from '@fiatsend/types';
+
+/**
+ * Chain configurations and deployed contract addresses.
+ *
+ * Contract addresses are placeholder `0x0000...` until deployment.
+ * Override via `FiatsendClientConfig.contractAddresses` for testnet/mainnet.
+ *
+ * @module @fiatsend/core/config
+ */
+
+/** Addresses of all deployed Fiatsend contracts on a given chain */
+interface ContractAddresses {
+    mobileNumberNFT: Address;
+    gateway: Address;
+    paymentRouter: Address;
+    withdrawals: Address;
+    liquidityPool: Address;
+    vaultController: Address;
+    ghsFiat: Address;
+    /** PayoutEscrow — core B2B payout claim contract */
+    payoutEscrow: Address;
+    /** P2PExchange — peer-to-peer exchange with payment references */
+    p2pExchange: Address;
+}
+/** Full chain configuration including RPC and contract addresses */
+interface ChainConfig {
+    chainId: number;
+    name: string;
+    rpcUrl: string;
+    contracts: ContractAddresses;
+}
+/**
+ * Pre-configured chain definitions.
+ *
+ * Contract addresses will be populated after deployment.
+ * Override any chain config with `FiatsendClientConfig.contractAddresses`.
+ */
+declare const CHAINS: Record<string, ChainConfig>;
+/**
+ * Looks up a ChainConfig by chain name or numeric chain ID.
+ *
+ * @param chainIdOrName - Chain name (e.g., "bsc") or numeric chain ID (e.g., 56)
+ * @returns ChainConfig if found
+ * @throws Error if the chain is not configured
+ */
+declare function getChainConfig(chainIdOrName: string | number): ChainConfig;
+
+/**
+ * IdentityResource — interactions with the MobileNumberNFT contract.
+ *
+ * Handles NFT registration (direct and gasless), KYC level queries,
+ * and phone-number-to-owner resolution.
+ *
+ * @module @fiatsend/core/resources/identity
+ */
+
+/**
+ * Resource for MobileNumberNFT contract interactions.
+ *
+ * Obtained via `client.identity` on a `FiatsendClient` instance.
+ */
+declare class IdentityResource {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly contractAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+        contractAddress: Address;
+    });
+    private get readContract();
+    private requireWallet;
+    /**
+     * Mints a soulbound MobileNumber NFT for the connected wallet.
+     *
+     * @param params - Encrypted phone bytes and ISO country code
+     * @returns Transaction result with hash and wait() function
+     */
+    register(params: RegisterMobileParams): Promise<TransactionResult>;
+    /**
+     * Gasless NFT mint: the authorized minter submits the transaction on behalf
+     * of the user. The user must have previously signed the EIP-712 typed data.
+     *
+     * @param params - User address, encrypted phone, country code, deadline, and signature
+     * @returns Transaction result with hash and wait() function
+     */
+    registerWithSignature(params: RegisterMobileWithSignatureParams): Promise<TransactionResult>;
+    /**
+     * Returns the MobileNumber NFT data for an address, or null if not registered.
+     *
+     * @param address - Wallet address to query
+     */
+    getNFT(address: Address): Promise<MobileNumberNFT | null>;
+    /**
+     * Returns the KYC level for an address (0 if no NFT).
+     *
+     * @param address - Wallet address to query
+     */
+    getKYCLevel(address: Address): Promise<KYCLevel>;
+    /**
+     * Resolves an encrypted phone hash to the owner address.
+     *
+     * @param encryptedPhone - Encrypted phone bytes (0x-prefixed)
+     * @returns Owner address or null if not registered
+     */
+    getOwnerByPhone(encryptedPhone: `0x${string}`): Promise<Address | null>;
+    /**
+     * Returns the token ID for an address (null if not registered).
+     *
+     * @param address - Wallet address
+     */
+    getTokenId(address: Address): Promise<bigint | null>;
+    /**
+     * Returns the user's nonce for EIP-712 replay protection.
+     *
+     * @param address - Wallet address
+     */
+    getNonce(address: Address): Promise<bigint>;
+}
+
+/**
+ * GatewayResource — interactions with the FiatsendGateway contract.
+ *
+ * Handles offramp (stablecoin → fiat), onramp, token management,
+ * KYC status, and gateway configuration reads.
+ *
+ * @module @fiatsend/core/resources/gateway
+ */
+
+/**
+ * Resource for FiatsendGateway contract interactions.
+ *
+ * Obtained via `client.gateway` on a `FiatsendClient` instance.
+ */
+declare class GatewayResource {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly contractAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+        contractAddress: Address;
+    });
+    private get readContract();
+    private requireWallet;
+    /**
+     * Initiates an offramp: converts a supported stablecoin to a mobile money payout.
+     *
+     * The user must:
+     * 1. Have a MobileNumber NFT
+     * 2. Pass KYC (if amount >= threshold)
+     * 3. Have approved the gateway to spend `params.amount` of `params.token`
+     *
+     * @param params - Token, amount, and destination phone number
+     * @returns Offramp result including the withdrawal ID and fees
+     */
+    offramp(params: OfframpParams): Promise<OfframpResult>;
+    /**
+     * Returns the conversion rate for a supported token.
+     *
+     * @param token - Token address
+     * @returns Scaled conversion rate as stored in the contract
+     */
+    getConversionRate(token: Address): Promise<bigint>;
+    /**
+     * Checks whether a token is supported by the gateway.
+     *
+     * @param token - Token address
+     */
+    isTokenSupported(token: Address): Promise<boolean>;
+    /**
+     * Checks whether a user has passed KYC verification.
+     *
+     * @param user - User address
+     */
+    isKYCPassed(user: Address): Promise<boolean>;
+    /**
+     * Returns the gateway's full configuration snapshot.
+     */
+    getConfig(): Promise<GatewayConfig>;
+    /**
+     * Returns the daily volume used by a user today.
+     *
+     * @param user - User address
+     */
+    getDailyVolume(user: Address): Promise<bigint>;
+    /**
+     * Returns the remaining daily allowance for a user.
+     *
+     * @param user - User address
+     */
+    getDailyRemaining(user: Address): Promise<bigint>;
+    /**
+     * Mints GHSFIAT for a user. Requires the caller to be an authorized onramper.
+     *
+     * @param user - Recipient address
+     * @param amount - Amount to mint
+     * @returns Transaction result
+     */
+    onramp(user: Address, amount: bigint): Promise<TransactionResult>;
+}
+
+/**
+ * PaymentsResource — interactions with the PaymentRouter contract.
+ *
+ * Handles direct P2P transfers (by address and by phone number)
+ * and the payment request lifecycle.
+ *
+ * @module @fiatsend/core/resources/payments
+ */
+
+/**
+ * Resource for PaymentRouter contract interactions.
+ *
+ * Obtained via `client.payments` on a `FiatsendClient` instance.
+ */
+declare class PaymentsResource {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly contractAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+        contractAddress: Address;
+    });
+    private get readContract();
+    private requireWallet;
+    /**
+     * Sends tokens directly to an address.
+     *
+     * The caller must have approved `params.amount` of `params.token` to the PaymentRouter.
+     *
+     * @param params - Token, recipient address, amount, and optional memo
+     * @returns Transaction result
+     */
+    send(params: SendPaymentParams): Promise<TransactionResult>;
+    /**
+     * Resolves an encrypted phone hash to an address via MobileNumberNFT and sends tokens.
+     *
+     * @param params - Token, encrypted phone, amount, and optional memo
+     * @returns Transaction result
+     */
+    sendToPhone(params: SendToPhoneParams): Promise<TransactionResult>;
+    /**
+     * Creates a payment request — asks another address to pay you.
+     *
+     * @param params - Token, payer address, amount, and optional memo
+     * @returns The created request ID and transaction hash
+     */
+    createRequest(params: CreatePaymentRequestParams): Promise<{
+        requestId: bigint;
+        hash: Hash;
+    }>;
+    /**
+     * Pays a pending payment request.
+     *
+     * Only the `to` address on the request can call this.
+     * The caller must approve `request.amount` of `request.token` to the PaymentRouter.
+     *
+     * @param requestId - The payment request ID to pay
+     * @returns Transaction result
+     */
+    payRequest(requestId: bigint): Promise<TransactionResult>;
+    /**
+     * Cancels a pending payment request.
+     *
+     * Only the request creator (`from` address) can cancel.
+     *
+     * @param requestId - The payment request ID to cancel
+     * @returns Transaction result
+     */
+    cancelRequest(requestId: bigint): Promise<TransactionResult>;
+    /**
+     * Fetches a payment request by ID.
+     *
+     * @param requestId - Payment request ID
+     * @returns PaymentRequest data
+     */
+    getRequest(requestId: bigint): Promise<PaymentRequest>;
+    /**
+     * Returns the total number of payment requests created.
+     */
+    getRequestCount(): Promise<bigint>;
+}
+
+/**
+ * WithdrawalsResource — read-only interactions with the Withdrawals contract.
+ *
+ * Tracks the lifecycle of withdrawal records: pending → processing → completed/failed.
+ * Write operations (processWithdrawal, completeWithdrawal, failWithdrawal) are admin-only
+ * and not exposed in the SDK.
+ *
+ * @module @fiatsend/core/resources/withdrawals
+ */
+
+/**
+ * Resource for Withdrawals contract read operations.
+ *
+ * Obtained via `client.withdrawals` on a `FiatsendClient` instance.
+ */
+declare class WithdrawalsResource {
+    private readonly publicClient;
+    private readonly contractAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        contractAddress: Address;
+    });
+    private get contract();
+    /**
+     * Returns a withdrawal record by ID.
+     *
+     * @param id - Withdrawal ID
+     */
+    getWithdrawal(id: bigint): Promise<Withdrawal>;
+    /**
+     * Returns all withdrawal records for a user, resolved from their IDs.
+     *
+     * @param user - User address
+     */
+    getUserWithdrawals(user: Address): Promise<Withdrawal[]>;
+    /**
+     * Returns the total number of withdrawals ever created.
+     */
+    getWithdrawalCount(): Promise<bigint>;
+}
+
+/**
+ * LiquidityResource — interactions with the LiquidityPool contract.
+ *
+ * LP providers deposit stablecoins and earn fee rewards from the gateway.
+ * The pool uses a per-share reward accumulator for gas-efficient distribution.
+ *
+ * @module @fiatsend/core/resources/liquidity
+ */
+
+/**
+ * Resource for LiquidityPool contract interactions.
+ *
+ * Obtained via `client.liquidity` on a `FiatsendClient` instance.
+ */
+declare class LiquidityResource {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly contractAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+        contractAddress: Address;
+    });
+    private get readContract();
+    private requireWallet;
+    /**
+     * Deposits stablecoins into the liquidity pool.
+     *
+     * The caller must approve `amount` of the pool's supported token to this contract.
+     *
+     * @param amount - Amount to deposit (must be >= pool minDeposit)
+     * @returns Transaction result
+     */
+    deposit(amount: bigint): Promise<TransactionResult>;
+    /**
+     * Withdraws stablecoins from the pool (after the lock period has elapsed).
+     *
+     * @param amount - Amount to withdraw
+     * @returns Transaction result
+     */
+    withdraw(amount: bigint): Promise<TransactionResult>;
+    /**
+     * Claims all pending fee rewards for the caller.
+     *
+     * @returns Transaction result
+     */
+    claimRewards(): Promise<TransactionResult>;
+    /**
+     * Returns pool-level statistics.
+     */
+    getPoolInfo(): Promise<PoolInfo>;
+    /**
+     * Returns a user's LP position including deposited balance and pending rewards.
+     *
+     * @param user - User address
+     */
+    getPosition(user: Address): Promise<UserPoolPosition>;
+    /**
+     * Returns pending rewards for a user.
+     *
+     * @param user - User address
+     */
+    getPendingRewards(user: Address): Promise<bigint>;
+}
+
+/**
+ * VaultsResource — interactions with the VaultController contract.
+ *
+ * Passive yield vault for stablecoin deposits.
+ * Yield accrues linearly: (balance × annualYieldRate × timeElapsed) / (365 days × 10000)
+ *
+ * @module @fiatsend/core/resources/vaults
+ */
+
+/**
+ * Resource for VaultController contract interactions.
+ *
+ * Obtained via `client.vaults` on a `FiatsendClient` instance.
+ */
+declare class VaultsResource {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly contractAddress;
+    private readonly supportedTokenAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+        contractAddress: Address;
+        supportedTokenAddress: Address;
+    });
+    private get readContract();
+    private requireWallet;
+    /**
+     * Deposits stablecoins into the vault.
+     *
+     * The caller must approve `amount` of the vault's supported token to this contract.
+     *
+     * @param amount - Amount to deposit (must be >= vault minDeposit)
+     * @returns Transaction result
+     */
+    deposit(amount: bigint): Promise<TransactionResult>;
+    /**
+     * Withdraws stablecoins from the vault. Accrued yield is claimed automatically.
+     *
+     * @param amount - Amount to withdraw
+     * @returns Transaction result
+     */
+    withdraw(amount: bigint): Promise<TransactionResult>;
+    /**
+     * Claims accrued yield without withdrawing principal.
+     *
+     * @returns Transaction result
+     */
+    claimYield(): Promise<TransactionResult>;
+    /**
+     * Returns vault-level configuration.
+     */
+    getVaultInfo(): Promise<VaultInfo>;
+    /**
+     * Returns a user's vault position.
+     *
+     * @param user - User address
+     */
+    getPosition(user: Address): Promise<UserVaultPosition>;
+    /**
+     * Returns the pending yield for a user.
+     *
+     * @param user - User address
+     */
+    getPendingYield(user: Address): Promise<bigint>;
+}
+
+/**
+ * PayoutsResource — interactions with the PayoutEscrow contract.
+ *
+ * The PayoutEscrow is the core B2B payout contract. Businesses deposit stablecoins
+ * via the Fiatsend API; funds are held in escrow until the recipient claims using
+ * their MobileNumberNFT identity. Recipients can claim to their wallet or
+ * immediately offramp to mobile money in a single transaction.
+ *
+ * @module @fiatsend/core/resources/payouts
+ */
+
+/**
+ * Resource for PayoutEscrow contract interactions.
+ *
+ * The main interface for the B2B payout claim flow:
+ * - Businesses create payouts (requires API authorization)
+ * - Recipients claim by proving their phone NFT matches
+ * - Recipients can optionally claim directly to mobile money in one tx
+ * - Businesses can refund expired unclaimed payouts
+ *
+ * Obtained via `client.payouts` on a `FiatsendClient` instance.
+ */
+declare class PayoutsResource {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly contractAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+        contractAddress: Address;
+    });
+    private get readContract();
+    private requireWallet;
+    private buildTxResult;
+    /**
+     * Creates a single payout in the escrow.
+     *
+     * The caller must be an authorized sender (set by the contract owner) and must
+     * have approved `amount` of `token` to the PayoutEscrow contract first.
+     *
+     * @param params - Payout parameters including token, amount, phone hash, and optional expiry
+     * @returns Transaction result
+     */
+    createPayout(params: CreatePayoutParams): Promise<TransactionResult>;
+    /**
+     * Creates multiple payouts in a single transaction (single token approval).
+     *
+     * The caller must be an authorized sender and must have approved the total sum
+     * of all amounts to the PayoutEscrow contract.
+     *
+     * @param params - Batch payout parameters
+     * @returns Transaction result
+     */
+    createBatchPayout(params: CreateBatchPayoutParams): Promise<TransactionResult>;
+    /**
+     * Claims a payout to the caller's wallet.
+     *
+     * The caller must hold a MobileNumberNFT whose phone hash matches the payout.
+     *
+     * @param payoutId - ID of the payout to claim
+     * @returns Transaction result
+     */
+    claim(payoutId: Hash): Promise<TransactionResult>;
+    /**
+     * Claims a payout and immediately routes funds through the gateway to mobile money.
+     *
+     * Requires the gateway to be set on the PayoutEscrow and the token to be supported.
+     * The caller must hold a MobileNumberNFT whose phone hash matches the payout.
+     *
+     * @param payoutId - ID of the payout to claim
+     * @param phoneNumber - Destination MoMo phone number (e.g., "+233241234567")
+     * @returns Transaction result
+     */
+    claimToMoMo(payoutId: Hash, phoneNumber: string): Promise<TransactionResult>;
+    /**
+     * Refunds an expired pending payout back to the original sender.
+     *
+     * Only the original sender or contract owner may call this. The payout must
+     * be past its expiry timestamp.
+     *
+     * @param payoutId - ID of the expired payout to refund
+     * @returns Transaction result
+     */
+    refund(payoutId: Hash): Promise<TransactionResult>;
+    /**
+     * Returns the full payout struct for a given ID.
+     *
+     * @param payoutId - ID of the payout to look up
+     * @returns Full Payout object with TypeScript-mapped status
+     */
+    getPayout(payoutId: Hash): Promise<Payout>;
+    /**
+     * Returns all payout IDs associated with a phone hash.
+     *
+     * @param phoneHash - keccak256 of the recipient's encrypted phone bytes
+     * @returns Array of payout IDs (as bytes32 hashes)
+     */
+    getPayoutsForPhone(phoneHash: Hash): Promise<Hash[]>;
+    /**
+     * Returns full payout objects that are still pending for a given phone hash.
+     *
+     * Convenience wrapper around `getPayoutsForPhone` + `getPayout` — fetches all
+     * payout IDs for the phone and filters to those with status 'pending'.
+     *
+     * @param phoneHash - keccak256 of the recipient's encrypted phone bytes
+     * @returns Array of pending Payout objects
+     */
+    getPendingPayouts(phoneHash: Hash): Promise<Payout[]>;
+    /**
+     * Returns all payouts claimable by a user based on their MobileNumberNFT phone hash.
+     *
+     * This is a convenience method: it reads the user's NFT phone hash on-chain (if
+     * the NFT contract is accessible via the escrow's `mobileNumberNFT` reference),
+     * then returns all pending payouts for that phone hash.
+     *
+     * Note: This requires the MobileNumberNFT to be queryable. If the NFT contract
+     * is not set, this will throw. Use `getPendingPayouts(phoneHash)` if you already
+     * know the phone hash.
+     *
+     * @param userAddress - Wallet address of the potential recipient
+     * @returns Array of pending Payout objects claimable by this user
+     */
+    getClaimablePayouts(userAddress: Address): Promise<Payout[]>;
+}
+
+/**
+ * P2PResource — interactions with the P2PExchange contract.
+ *
+ * Enables peer-to-peer token exchange with exact payment references for
+ * crypto-exchange platform auto-completion (Binance P2P, Paxful, Noones, etc.).
+ *
+ * Flow:
+ * 1. Maker calls `createOrder` — tokens are escrowed on-chain
+ * 2. Taker calls `takeOrder` — order is locked; taker pays off-chain via reference
+ * 3. Maker calls `confirmPayment` when off-chain payment arrives — tokens go to taker
+ * 4. Either party can call `disputeOrder` if there's disagreement
+ *
+ * @module @fiatsend/core/resources/p2p
+ */
+
+/**
+ * Resource for P2PExchange contract interactions.
+ *
+ * Obtained via `client.p2p` on a `FiatsendClient` instance.
+ */
+declare class P2PResource {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly contractAddress;
+    constructor(params: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+        contractAddress: Address;
+    });
+    private get readContract();
+    private requireWallet;
+    private buildTxResult;
+    /**
+     * Creates a new P2P order and escrows tokens from the maker.
+     *
+     * The caller must have approved `amount` of `token` to the P2PExchange contract.
+     *
+     * @param params - Order parameters
+     * @returns Transaction result
+     */
+    createOrder(params: CreateP2POrderParams): Promise<TransactionResult>;
+    /**
+     * Locks an open order. Taker commits to pay via the exchange using the payment reference.
+     *
+     * Once taken, the taker must complete the off-chain payment using the exact reference
+     * string from the order. The maker then calls `confirmPayment` to release funds.
+     *
+     * @param orderId - ID of the order to take
+     * @returns Transaction result
+     */
+    takeOrder(orderId: Hash): Promise<TransactionResult>;
+    /**
+     * Confirms payment received on the exchange and releases tokens to the taker.
+     *
+     * Only the maker can call this. After confirmation, the escrowed tokens are
+     * transferred to the taker's wallet.
+     *
+     * @param orderId - ID of the locked order to confirm
+     * @returns Transaction result
+     */
+    confirmPayment(orderId: Hash): Promise<TransactionResult>;
+    /**
+     * Cancels an open (not yet taken) order and returns tokens to the maker.
+     *
+     * Only the maker can cancel, and only while the order is still open.
+     *
+     * @param orderId - ID of the open order to cancel
+     * @returns Transaction result
+     */
+    cancelOrder(orderId: Hash): Promise<TransactionResult>;
+    /**
+     * Raises a dispute on a locked order.
+     *
+     * Either the maker or taker can dispute. Once disputed, the order is frozen
+     * until the designated dispute resolver calls `resolveDispute`.
+     *
+     * @param orderId - ID of the locked order to dispute
+     * @returns Transaction result
+     */
+    disputeOrder(orderId: Hash): Promise<TransactionResult>;
+    /**
+     * Returns the full order struct for a given ID.
+     *
+     * @param orderId - ID of the order to look up
+     * @returns Full P2POrder object with TypeScript-mapped status
+     */
+    getOrder(orderId: Hash): Promise<P2POrder>;
+    /**
+     * Returns all order IDs created by a user.
+     *
+     * @param user - Wallet address of the maker
+     * @returns Array of order IDs (as bytes32 hashes)
+     */
+    getUserOrders(user: Address): Promise<Hash[]>;
+    /**
+     * Returns open order IDs available for taking.
+     *
+     * @param limit - Maximum number of order IDs to return (0 = all)
+     * @returns Array of open order IDs
+     */
+    getOpenOrders(limit?: number): Promise<Hash[]>;
+    /**
+     * Returns full order objects for all currently open orders.
+     *
+     * Convenience wrapper around `getOpenOrders` + `getOrder` — fetches all
+     * open order IDs and resolves each to a full P2POrder.
+     *
+     * @param limit - Maximum number of orders to fetch (0 = all)
+     * @returns Array of full P2POrder objects
+     */
+    getOpenOrdersDetailed(limit?: number): Promise<P2POrder[]>;
+}
+
+/**
+ * FiatsendClient — the main entry point for the Fiatsend SDK.
+ *
+ * Instantiate with a chain name/ID and optional viem clients to get typed
+ * access to all Fiatsend contract resources.
+ *
+ * @example
+ * ```typescript
+ * import { FiatsendClient } from '@fiatsend/core';
+ * import { createPublicClient, createWalletClient, http } from 'viem';
+ * import { bsc } from 'viem/chains';
+ *
+ * const publicClient = createPublicClient({ chain: bsc, transport: http() });
+ *
+ * const fiatsend = new FiatsendClient({
+ *   chain: 'bsc',
+ *   publicClient,
+ * });
+ *
+ * // Business creates a payout
+ * await fiatsend.payouts.createPayout({
+ *   payoutId: '0x...',
+ *   token: USDC_ADDRESS,
+ *   amount: parseTokenAmount('500', 6),
+ *   phoneHash: encodePhoneNumber('+233241234567'),
+ * });
+ *
+ * // Recipient claims directly to mobile money
+ * await fiatsend.payouts.claimToMoMo(payoutId, '+233241234567');
+ * ```
+ *
+ * @module @fiatsend/core/client
+ */
+
+/** Configuration for creating a FiatsendClient */
+interface FiatsendClientConfig {
+    /**
+     * Chain to connect to. Accepts a chain name (e.g., "bsc", "polygon")
+     * or a numeric chain ID (e.g., 56).
+     */
+    chain: string | number;
+    /**
+     * Optional RPC URL override. If omitted, uses the default RPC from CHAINS config.
+     */
+    rpcUrl?: string;
+    /**
+     * An existing viem PublicClient for read operations.
+     * If omitted, one is created automatically using the configured RPC URL.
+     */
+    publicClient?: PublicClient;
+    /**
+     * An existing viem WalletClient for write (transaction) operations.
+     * Required for any state-changing method (register, offramp, createPayout, etc.).
+     */
+    walletClient?: WalletClient;
+    /**
+     * Override any or all contract addresses for the selected chain.
+     * Useful during testing or when deploying to a new network.
+     */
+    contractAddresses?: Partial<ContractAddresses>;
+}
+/**
+ * The main Fiatsend SDK client.
+ *
+ * All contract interactions are grouped into typed resource classes accessible
+ * as properties. Read-only operations require only `publicClient`.
+ * Write operations additionally require `walletClient`.
+ */
+declare class FiatsendClient {
+    /** Chain configuration used by this client */
+    readonly chainConfig: ChainConfig;
+    /** viem PublicClient used for all read operations */
+    readonly publicClient: PublicClient;
+    /** viem WalletClient (optional) used for write operations */
+    readonly walletClient: WalletClient | undefined;
+    /** Resolved contract addresses */
+    readonly addresses: ContractAddresses;
+    /** MobileNumberNFT interactions — register, resolve, KYC */
+    readonly identity: IdentityResource;
+    /** FiatsendGateway interactions — offramp, onramp, configuration */
+    readonly gateway: GatewayResource;
+    /** PaymentRouter interactions — send, sendToPhone, payment requests */
+    readonly payments: PaymentsResource;
+    /** Withdrawals contract — read-only withdrawal tracking */
+    readonly withdrawals: WithdrawalsResource;
+    /** LiquidityPool interactions — deposit, withdraw, claim rewards */
+    readonly liquidity: LiquidityResource;
+    /** VaultController interactions — deposit, withdraw, claim yield */
+    readonly vaults: VaultsResource;
+    /**
+     * PayoutEscrow interactions — core B2B payout claim flow.
+     *
+     * Businesses create payouts; recipients claim via their MobileNumberNFT identity.
+     * Supports single-tx `claimToMoMo` for immediate mobile money delivery.
+     */
+    readonly payouts: PayoutsResource;
+    /**
+     * P2PExchange interactions — peer-to-peer exchange with payment references.
+     *
+     * Makers escrow tokens on-chain; takers pay via exchange platforms (Binance P2P,
+     * Paxful, Noones) using the exact payment reference; makers confirm receipt.
+     */
+    readonly p2p: P2PResource;
+    constructor(config: FiatsendClientConfig);
+    /**
+     * Convenience: returns a copy of this client with a new walletClient attached.
+     *
+     * Useful when the wallet connects after the client is created.
+     *
+     * @param walletClient - The viem WalletClient to attach
+     */
+    withWallet(walletClient: WalletClient): FiatsendClient;
+}
+
+/**
+ * ABI for the MobileNumberNFT contract.
+ *
+ * Soulbound ERC-721 identity NFT tied to an encrypted phone number.
+ * One NFT per user. Non-transferable after mint. Supports KYC tiers (0–2).
+ */
+declare const MobileNumberNFTABI: readonly [{
+    readonly type: "error";
+    readonly name: "AlreadyRegistered";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PhoneAlreadyRegistered";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotAuthorized";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidKYCLevel";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TransferNotAllowed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SignatureExpired";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidSignature";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "MobileNumberRegistered";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "countryCode";
+        readonly type: "string";
+        readonly indexed: false;
+        readonly internalType: "string";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "KYCLevelUpdated";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "newLevel";
+        readonly type: "uint8";
+        readonly indexed: false;
+        readonly internalType: "uint8";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Approval";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "ApprovalForAll";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "operator";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+        readonly indexed: false;
+        readonly internalType: "bool";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "baseURI";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "registerMobile";
+    readonly inputs: readonly [{
+        readonly name: "encryptedPhone";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "countryCode";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "registerMobileWithSignature";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "encryptedPhone";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "countryCode";
+        readonly type: "string";
+        readonly internalType: "string";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "updateKYCLevel";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "newLevel";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setAuthorizedMinter";
+    readonly inputs: readonly [{
+        readonly name: "minter";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "authorized";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setBaseURI";
+    readonly inputs: readonly [{
+        readonly name: "baseURI";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getTokenId";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getTokenIdByPhone";
+    readonly inputs: readonly [{
+        readonly name: "encryptedPhone";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getKYCLevel";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getKYCLevelByAddress";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getCountryCode";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getEncryptedPhone";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "nonces";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "ownerOf";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "tokenURI";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "tokenByIndex";
+    readonly inputs: readonly [{
+        readonly name: "index";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "tokenOfOwnerByIndex";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "index";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "supportsInterface";
+    readonly inputs: readonly [{
+        readonly name: "interfaceId";
+        readonly type: "bytes4";
+        readonly internalType: "bytes4";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "name";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the FiatsendGateway contract.
+ *
+ * Core UUPS-upgradeable gateway for onramp/offramp operations.
+ * Handles token conversion, KYC gating, fee collection, and daily limits.
+ */
+declare const FiatsendGatewayABI: readonly [{
+    readonly type: "error";
+    readonly name: "TokenNotSupported";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NoMobileNFT";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "KYCRequired";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "BelowMinimum";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "DailyLimitExceeded";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidFeeRate";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotAuthorizedOnramp";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotAuthorizedContract";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "OfframpInitiated";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "fee";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "phoneNumber";
+        readonly type: "string";
+        readonly indexed: false;
+        readonly internalType: "string";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OnrampCompleted";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "ConversionRateUpdated";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "rate";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "TokenAdded";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "TokenRemoved";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "FeeCollected";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "feeAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "treasury";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Paused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Unpaused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Upgraded";
+    readonly inputs: readonly [{
+        readonly name: "implementation";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Initialized";
+    readonly inputs: readonly [{
+        readonly name: "version";
+        readonly type: "uint64";
+        readonly indexed: false;
+        readonly internalType: "uint64";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "function";
+    readonly name: "initialize";
+    readonly inputs: readonly [{
+        readonly name: "_ghsFiatToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_mobileNumberNFT";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_treasury";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_feeRate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "offrampFor";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "phoneNumber";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "offramp";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "phoneNumber";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "onramp";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setConversionRate";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "rate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "addSupportedToken";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "removeSupportedToken";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setKYC";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "status";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setProtocolFee";
+    readonly inputs: readonly [{
+        readonly name: "newFeeRate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setMinWithdrawAmount";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setDailyLimit";
+    readonly inputs: readonly [{
+        readonly name: "limit";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setWithdrawalsContract";
+    readonly inputs: readonly [{
+        readonly name: "_withdrawals";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setAuthorizedOnramper";
+    readonly inputs: readonly [{
+        readonly name: "onramper";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "authorized";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setAuthorizedContract";
+    readonly inputs: readonly [{
+        readonly name: "contractAddr";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "authorized";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setProtocolTreasury";
+    readonly inputs: readonly [{
+        readonly name: "treasury";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "emergencyWithdraw";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "pause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "unpause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "upgradeTo";
+    readonly inputs: readonly [{
+        readonly name: "newImplementation";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "upgradeToAndCall";
+    readonly inputs: readonly [{
+        readonly name: "newImplementation";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "isTokenSupported";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getConversionRate";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isKYCPassed";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getDailyVolume";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "isAuthorizedContract";
+    readonly inputs: readonly [{
+        readonly name: "contractAddr";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "protocolFeeRate";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "protocolTreasury";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "minWithdrawAmount";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "dailyLimit";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "paused";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_FEE_RATE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "KYC_THRESHOLD";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "ghsFiatToken";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "mobileNumberNFT";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "withdrawalsContract";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "proxiableUUID";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the PaymentRouter contract.
+ *
+ * Routes P2P payments and payment requests between users.
+ * Resolves phone-number-based payments via MobileNumberNFT.
+ */
+declare const PaymentRouterABI: readonly [{
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PhoneNotRegistered";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "RequestNotFound";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "RequestNotPending";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotRequestOwner";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotRequestRecipient";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SelfPayment";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "PaymentSent";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "memo";
+        readonly type: "string";
+        readonly indexed: false;
+        readonly internalType: "string";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PaymentRequestCreated";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PaymentRequestPaid";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "paidBy";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PaymentRequestCancelled";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_mobileNumberNFT";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_feeTreasury";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "send";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "memo";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "sendToPhone";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "encryptedPhone";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "memo";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "createPaymentRequest";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "from";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "memo";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "payRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "cancelRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setP2PFeeRate";
+    readonly inputs: readonly [{
+        readonly name: "rate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setFeeTreasury";
+    readonly inputs: readonly [{
+        readonly name: "treasury";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getPaymentRequest";
+    readonly inputs: readonly [{
+        readonly name: "requestId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct IPaymentRouter.PaymentRequest";
+        readonly components: readonly [{
+            readonly name: "id";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "from";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "to";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "token";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "memo";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "status";
+            readonly type: "uint8";
+            readonly internalType: "enum IPaymentRouter.RequestStatus";
+        }, {
+            readonly name: "createdAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "paymentRequestCounter";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "p2pFeeRate";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "feeTreasury";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "mobileNumberNFT";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the Withdrawals contract.
+ *
+ * Manages withdrawal lifecycle: pending → processing → completed/failed.
+ * Only the gateway can create withdrawals. Owner manages status transitions.
+ */
+declare const WithdrawalsABI: readonly [{
+    readonly type: "error";
+    readonly name: "OnlyGateway";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "WithdrawalNotFound";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidStatus";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "WithdrawalCreated";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "fee";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "phoneNumber";
+        readonly type: "string";
+        readonly indexed: false;
+        readonly internalType: "string";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "WithdrawalProcessing";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "WithdrawalCompleted";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "completedAt";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "WithdrawalFailed";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "refundAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "GatewayUpdated";
+    readonly inputs: readonly [{
+        readonly name: "gateway";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setGateway";
+    readonly inputs: readonly [{
+        readonly name: "_gateway";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "processWithdrawal";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "completeWithdrawal";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "failWithdrawal";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "createWithdrawal";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "fee";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "paymentMethod";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }, {
+        readonly name: "phoneNumber";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getWithdrawal";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct Withdrawals.Withdrawal";
+        readonly components: readonly [{
+            readonly name: "id";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "user";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "token";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "fee";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "status";
+            readonly type: "uint8";
+            readonly internalType: "uint8";
+        }, {
+            readonly name: "paymentMethod";
+            readonly type: "uint8";
+            readonly internalType: "uint8";
+        }, {
+            readonly name: "phoneNumber";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "createdAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "completedAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getUserWithdrawals";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+        readonly internalType: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "withdrawalCounter";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "gateway";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "STATUS_PENDING";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "STATUS_PROCESSING";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "STATUS_COMPLETED";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "STATUS_FAILED";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the LiquidityPool contract.
+ *
+ * LPs deposit a supported stablecoin and earn a proportional share of
+ * conversion fees distributed by the gateway.
+ */
+declare const LiquidityPoolABI: readonly [{
+    readonly type: "error";
+    readonly name: "BelowMinDeposit";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "LockPeriodActive";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientBalance";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OnlyGateway";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "Deposited";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Withdrawn";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "RewardsClaimed";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "RewardsDistributed";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_supportedToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_gateway";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_minDeposit";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "_lockPeriod";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "deposit";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "withdraw";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claimRewards";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "distributeRewards";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setGateway";
+    readonly inputs: readonly [{
+        readonly name: "_gateway";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setMinDeposit";
+    readonly inputs: readonly [{
+        readonly name: "_minDeposit";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setLockPeriod";
+    readonly inputs: readonly [{
+        readonly name: "_lockPeriod";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getRewards";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getDeposit";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getPoolInfo";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct ILiquidityPool.PoolInfo";
+        readonly components: readonly [{
+            readonly name: "totalDeposits";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "rewardPerToken";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "supportedToken";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "minDeposit";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "lockPeriod";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "supportedToken";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalDeposits";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "minDeposit";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lockPeriod";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "accRewardPerShare";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "gateway";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the VaultController contract.
+ *
+ * Passive yield vault for stablecoin deposits.
+ * Yield accrues linearly based on an annual rate (basis points).
+ */
+declare const VaultControllerABI: readonly [{
+    readonly type: "error";
+    readonly name: "BelowMinDeposit";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientBalance";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NoYieldAvailable";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidYieldRate";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "VaultDeposited";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "VaultWithdrawn";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "YieldClaimed";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "yieldAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "YieldRateUpdated";
+    readonly inputs: readonly [{
+        readonly name: "newRate";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_supportedToken";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_annualYieldRate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "_minDeposit";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "deposit";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "withdraw";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claimYield";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setAnnualYieldRate";
+    readonly inputs: readonly [{
+        readonly name: "rate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setMinDeposit";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getVault";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct IVault.VaultInfo";
+        readonly components: readonly [{
+            readonly name: "balance";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "depositedAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "lastYieldClaim";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "calculateYield";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "annualYieldRate";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "minDeposit";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalDeposited";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "supportedToken";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MAX_YIELD_RATE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the GHSFIAT token contract.
+ *
+ * ERC-20 stablecoin pegged to the Ghana Cedi (GHS).
+ * Role-based minting/burning. Pausable for emergency stops.
+ */
+declare const GHSFIATABI: readonly [{
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "Transfer";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Approval";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Paused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Unpaused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "RoleGranted";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "RoleRevoked";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "admin";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "mint";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "burn";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "burnFrom";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "pause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "unpause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferFrom";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "grantRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "revokeRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "callerConfirmation";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "name";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "symbol";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+        readonly internalType: "uint8";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "paused";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "MINTER_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "PAUSER_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "DEFAULT_ADMIN_ROLE";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "hasRole";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getRoleAdmin";
+    readonly inputs: readonly [{
+        readonly name: "role";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "supportsInterface";
+    readonly inputs: readonly [{
+        readonly name: "interfaceId";
+        readonly type: "bytes4";
+        readonly internalType: "bytes4";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the PayoutEscrow contract.
+ *
+ * Core B2B payout contract. Businesses deposit stablecoins via the Fiatsend API;
+ * funds are held here until the recipient claims using their MobileNumberNFT identity.
+ * Recipients can claim to their wallet or immediately offramp to mobile money in one tx.
+ */
+declare const PayoutEscrowABI: readonly [{
+    readonly type: "error";
+    readonly name: "PayoutAlreadyExists";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PayoutNotFound";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotAuthorizedSender";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotPending";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotExpiredYet";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotRefundEligible";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PhoneHashMismatch";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NoMobileNFT";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ArrayLengthMismatch";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidExpiry";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "GatewayNotSet";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "TokenNotSupportedByGateway";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "PayoutCreated";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "phoneHash";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PayoutClaimed";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "recipient";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PayoutRefunded";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "PayoutExpired";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "AuthorizedSenderSet";
+    readonly inputs: readonly [{
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "authorized";
+        readonly type: "bool";
+        readonly indexed: false;
+        readonly internalType: "bool";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "GatewaySet";
+    readonly inputs: readonly [{
+        readonly name: "gateway";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "DefaultExpiryDurationSet";
+    readonly inputs: readonly [{
+        readonly name: "duration";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Paused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Unpaused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_mobileNumberNFT";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_gateway";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_expiryDuration";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "createPayout";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "phoneHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "expiresAt";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "createBatchPayout";
+    readonly inputs: readonly [{
+        readonly name: "payoutIds";
+        readonly type: "bytes32[]";
+        readonly internalType: "bytes32[]";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amounts";
+        readonly type: "uint256[]";
+        readonly internalType: "uint256[]";
+    }, {
+        readonly name: "phoneHashes";
+        readonly type: "bytes32[]";
+        readonly internalType: "bytes32[]";
+    }, {
+        readonly name: "expiresAt";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claim";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claimToMoMo";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "phoneNumber";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "refund";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getPayout";
+    readonly inputs: readonly [{
+        readonly name: "payoutId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct IPayoutEscrow.Payout";
+        readonly components: readonly [{
+            readonly name: "id";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "sender";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "recipient";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "token";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "phoneHash";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "status";
+            readonly type: "uint8";
+            readonly internalType: "enum IPayoutEscrow.PayoutStatus";
+        }, {
+            readonly name: "expiresAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "createdAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "claimedAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getPayoutsForPhone";
+    readonly inputs: readonly [{
+        readonly name: "phoneHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32[]";
+        readonly internalType: "bytes32[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getPayoutsByStatus";
+    readonly inputs: readonly [{
+        readonly name: "phoneHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "status";
+        readonly type: "uint8";
+        readonly internalType: "enum IPayoutEscrow.PayoutStatus";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32[]";
+        readonly internalType: "bytes32[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "setAuthorizedSender";
+    readonly inputs: readonly [{
+        readonly name: "sender";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "authorized";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setDefaultExpiryDuration";
+    readonly inputs: readonly [{
+        readonly name: "duration";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "setGateway";
+    readonly inputs: readonly [{
+        readonly name: "_gateway";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "pause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "unpause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "mobileNumberNFT";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "gateway";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "defaultExpiryDuration";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "authorizedSenders";
+    readonly inputs: readonly [{
+        readonly name: "sender";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "paused";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}];
+
+/**
+ * ABI for the P2PExchange contract.
+ *
+ * Peer-to-peer token exchange with exact payment references for crypto-exchange
+ * auto-completion. A maker escrows tokens on-chain; a taker pays off-chain using
+ * the exact reference; the maker confirms receipt and tokens are released — or
+ * a dispute resolver adjudicates disagreements.
+ */
+declare const P2PExchangeABI: readonly [{
+    readonly type: "error";
+    readonly name: "OrderAlreadyExists";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OrderNotFound";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotMaker";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotParty";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NotDisputeResolver";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OrderNotOpen";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OrderNotLocked";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OrderNotDisputed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "AlreadyTaken";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SelfTake";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroExpiryDuration";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidWinner";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "event";
+    readonly name: "OrderCreated";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "maker";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "paymentReference";
+        readonly type: "string";
+        readonly indexed: false;
+        readonly internalType: "string";
+    }, {
+        readonly name: "exchangePlatform";
+        readonly type: "string";
+        readonly indexed: false;
+        readonly internalType: "string";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OrderTaken";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "taker";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OrderCompleted";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "taker";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OrderCancelled";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OrderDisputed";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "disputedBy";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "DisputeResolved";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "winner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "DisputeResolverSet";
+    readonly inputs: readonly [{
+        readonly name: "resolver";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "OwnershipTransferred";
+    readonly inputs: readonly [{
+        readonly name: "previousOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Paused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "Unpaused";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_disputeResolver";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "createOrder";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "paymentReference";
+        readonly type: "string";
+        readonly internalType: "string";
+    }, {
+        readonly name: "exchangePlatform";
+        readonly type: "string";
+        readonly internalType: "string";
+    }, {
+        readonly name: "expiryDuration";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "takeOrder";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "confirmPayment";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "cancelOrder";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "disputeOrder";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "resolveDispute";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "winner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "getOrder";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct IP2PExchange.P2POrder";
+        readonly components: readonly [{
+            readonly name: "id";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "maker";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "taker";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "token";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "paymentReference";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "exchangePlatform";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "status";
+            readonly type: "uint8";
+            readonly internalType: "enum IP2PExchange.OrderStatus";
+        }, {
+            readonly name: "createdAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "lockedAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "completedAt";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "expiryDuration";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getUserOrders";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32[]";
+        readonly internalType: "bytes32[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getOpenOrders";
+    readonly inputs: readonly [{
+        readonly name: "limit";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32[]";
+        readonly internalType: "bytes32[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "setDisputeResolver";
+    readonly inputs: readonly [{
+        readonly name: "resolver";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "pause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "unpause";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "transferOwnership";
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "disputeResolver";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "owner";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "paused";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}];
+
+export { CHAINS, type ChainConfig, type ContractAddresses, FiatsendClient, type FiatsendClientConfig, FiatsendGatewayABI, GHSFIATABI, GatewayResource, IdentityResource, LiquidityPoolABI, LiquidityResource, MobileNumberNFTABI, P2PExchangeABI, P2PResource, PaymentRouterABI, PaymentsResource, PayoutEscrowABI, PayoutsResource, VaultControllerABI, VaultsResource, WithdrawalsABI, WithdrawalsResource, getChainConfig };