@team-oozoo/oozoo-pay 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,1260 @@
+interface PaymentRouter {
+    id: string;
+    chainId: string;
+    address: string;
+}
+interface PaymentSetting {
+    id: string;
+    chainId: string;
+    chainIcon?: string;
+    tokenAddress: string;
+    tokenName: string;
+    tokenSymbol: string;
+    tokenDecimals: number;
+    tokenIcon?: string;
+    receiver: string;
+    isActive: boolean;
+}
+interface PaymentConfig {
+    /** Reown project ID (managed by PG) */
+    projectId: string;
+    /** Project mode: TEST or LIVE */
+    mode: 'TEST' | 'LIVE';
+    paymentRouters: PaymentRouter[];
+    paymentSettings: PaymentSetting[];
+}
+interface PaymentData {
+    id: string;
+    erc20: string;
+    sender: string;
+    receiver: string;
+    amount: string;
+    feeRate: string;
+    expirationTimestamp: string;
+}
+interface GetBalanceResult {
+    raw: bigint;
+    formatted: string;
+}
+interface PaymentInstruction {
+    chainType: string;
+    chainId: string;
+    paymentData: PaymentData;
+    signature: string;
+}
+/** Supported currency units for price */
+type PriceUnit = 'usd';
+/** Base invoice parameters */
+interface BaseInvoiceParams {
+    /** Price amount */
+    price: number;
+    /** Unit of the price */
+    unit: PriceUnit;
+    /** Blockchain chain ID */
+    chainId: string;
+    /** Token contract address */
+    tokenAddress: string;
+}
+/** Parameters passed to pay() onCreateInvoice callback */
+interface PayInvoiceParams extends BaseInvoiceParams {
+    /** Payer's wallet address */
+    sender: string;
+}
+/** Parameters passed to transfer() onCreateInvoice callback */
+interface TransferInvoiceParams extends BaseInvoiceParams {
+    /** Recipient's wallet address */
+    receiver: string;
+}
+/** Options for pay() method */
+interface PayOptions {
+    /** Payment price */
+    price: number;
+    /** Unit of the price (default: 'usd') */
+    unit?: PriceUnit;
+    /**
+     * Invoice creation callback.
+     * Called when the user clicks Pay. The merchant server should create an HMAC invoice
+     * and return the invoiceId.
+     */
+    onCreateInvoice: (params: PayInvoiceParams) => Promise<string>;
+    /** Redirect URL on payment success */
+    successUrl: string;
+    /** Redirect URL on payment failure/cancel */
+    failUrl: string;
+}
+/** Options for transfer() method */
+interface TransferOptions {
+    /** Transfer price */
+    price: number;
+    /** Unit of the price (default: 'usd') */
+    unit?: PriceUnit;
+    /**
+     * Invoice creation callback.
+     * Called when the user clicks Transfer. The merchant server should create an HMAC invoice
+     * and return the invoiceId.
+     */
+    onCreateInvoice: (params: TransferInvoiceParams) => Promise<string>;
+    /** Redirect URL on transfer success */
+    successUrl: string;
+    /** Redirect URL on transfer failure/cancel */
+    failUrl: string;
+}
+/** @deprecated Use PayOptions instead */
+type RequestPaymentOptions = PayOptions;
+/** @deprecated Use TransferOptions instead */
+type RequestWithdrawalOptions = TransferOptions;
+/** @deprecated Use PayInvoiceParams or TransferInvoiceParams instead */
+type CreateInvoiceParams = PayInvoiceParams | TransferInvoiceParams;
+interface PostMessageReady {
+    type: 'OOZOO_READY';
+}
+interface PostMessageCreateInvoice {
+    type: 'OOZOO_CREATE_INVOICE';
+    requestId: string;
+    params: {
+        price: number;
+        unit: PriceUnit;
+        chainId: string;
+        tokenAddress: string;
+        sender?: string;
+        receiver?: string;
+    };
+}
+interface PostMessageCreateInvoiceResult {
+    type: 'OOZOO_CREATE_INVOICE_RESULT';
+    requestId: string;
+    invoiceId?: string;
+    error?: string;
+}
+interface PostMessageSuccess {
+    type: 'OOZOO_SUCCESS';
+    invoiceId: string;
+}
+interface PostMessageCancel {
+    type: 'OOZOO_CANCEL';
+}
+interface PostMessageError {
+    type: 'OOZOO_ERROR';
+    code: string;
+    message: string;
+}
+interface PostMessageResize {
+    type: 'OOZOO_RESIZE';
+    height: number;
+}
+interface PostMessageSnackbar {
+    type: 'OOZOO_SNACKBAR';
+    message: string;
+    variant: 'success' | 'error' | 'info';
+    action?: {
+        label: string;
+        id: string;
+    };
+}
+interface PostMessageSnackbarAction {
+    type: 'OOZOO_SNACKBAR_ACTION';
+    id: string;
+}
+type OozooPostMessage = PostMessageReady | PostMessageCreateInvoice | PostMessageCreateInvoiceResult | PostMessageSuccess | PostMessageCancel | PostMessageError | PostMessageResize | PostMessageSnackbar | PostMessageSnackbarAction;
+
+declare class OozooPayClient {
+    private readonly clientKey;
+    private readonly checkoutUrl;
+    constructor(clientKey: string);
+    /**
+     * Open checkout window to collect payment from user.
+     */
+    pay(options: PayOptions): Promise<void>;
+    /**
+     * Open checkout window to send payout to user.
+     */
+    transfer(options: TransferOptions): Promise<void>;
+    private openFlow;
+    private validateOptions;
+    private handleSuccess;
+    private handleError;
+    private handleCancel;
+    /** @deprecated Use pay() instead */
+    requestPayment(options: PayOptions): Promise<void>;
+    /** @deprecated Use transfer() instead */
+    requestWithdrawal(options: TransferOptions): Promise<void>;
+}
+/**
+ * Initialize OozooPay SDK.
+ */
+declare function loadOozooPay(clientKey: string): Promise<OozooPayClient>;
+
+declare class OozooPayError extends Error {
+    constructor(message: string);
+}
+declare class ApiError extends OozooPayError {
+    readonly statusCode: number;
+    readonly code: string;
+    constructor(statusCode: number, code: string, message: string);
+}
+declare class ConfigError extends OozooPayError {
+    constructor(message: string);
+}
+
+interface EncodedTransaction {
+    chainId: number;
+    to: string;
+    data: string;
+    value: string;
+}
+/**
+ * Encode a payment router transaction from payment data and signature.
+ * Returns ready-to-send transaction data (to, data, value).
+ *
+ * Zero-dependency: uses manual ABI encoding instead of viem.
+ */
+declare function encodePaymentTransaction(routerAddress: string, chainId: string, paymentData: PaymentData, signature: string): EncodedTransaction;
+
+/**
+ * Raw EIP-1193 provider functions for environments without viem PublicClient.
+ * Use these with Privy embedded wallets or other EIP-1193 providers.
+ */
+type EIP1193Provider = {
+    request: (args: {
+        method: string;
+        params: any[];
+    }) => Promise<any>;
+};
+
+declare const PaymentRouterAbi: readonly [{
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "owner_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "signer_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "feeRecipient_";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "ETH";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "FEE_RATE_UNIT_DIVISOR";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "PAYMENT_DATA_TYPE_HASH";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "changeFeeRecipient";
+    readonly inputs: readonly [{
+        readonly name: "newFeeRecipient";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "changeSigner";
+    readonly inputs: readonly [{
+        readonly name: "newSigner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "eip712Domain";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "fields";
+        readonly type: "bytes1";
+        readonly internalType: "bytes1";
+    }, {
+        readonly name: "name";
+        readonly type: "string";
+        readonly internalType: "string";
+    }, {
+        readonly name: "version";
+        readonly type: "string";
+        readonly internalType: "string";
+    }, {
+        readonly name: "chainId";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "verifyingContract";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "salt";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "extensions";
+        readonly type: "uint256[]";
+        readonly internalType: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "feeRecipient";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "hashPaymentData";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "erc20";
+        readonly type: "address";
+        readonly internalType: "contract IERC20";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "receiver";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "feeRate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "expirationTimestamp";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "pure";
+}, {
+    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: "pay";
+    readonly inputs: readonly [{
+        readonly name: "paramsList";
+        readonly type: "tuple[]";
+        readonly internalType: "struct IPaymentRouter.PaymentParams[]";
+        readonly components: readonly [{
+            readonly name: "id";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "erc20";
+            readonly type: "address";
+            readonly internalType: "contract IERC20";
+        }, {
+            readonly name: "receiver";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "feeRate";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "expirationTimestamp";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "signature";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "payERC20";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "erc20";
+        readonly type: "address";
+        readonly internalType: "contract IERC20";
+    }, {
+        readonly name: "receiver";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "feeRate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "expirationTimestamp";
+        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: "payETH";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "receiver";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "feeRate";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "expirationTimestamp";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "recover";
+    readonly inputs: readonly [{
+        readonly name: "structHash";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "renounceOwnership";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "signer";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    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: "event";
+    readonly name: "EIP712DomainChanged";
+    readonly inputs: readonly [];
+    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: "Payment";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "uint256";
+        readonly indexed: true;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "erc20";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "contract IERC20";
+    }, {
+        readonly name: "sender";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "receiver";
+        readonly type: "address";
+        readonly indexed: true;
+        readonly internalType: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "feeRecipient";
+        readonly type: "address";
+        readonly indexed: false;
+        readonly internalType: "address";
+    }, {
+        readonly name: "feeRate";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "fee";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "amountAfterFee";
+        readonly type: "uint256";
+        readonly indexed: false;
+        readonly internalType: "uint256";
+    }];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignature";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignatureLength";
+    readonly inputs: readonly [{
+        readonly name: "length";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignatureS";
+    readonly inputs: readonly [{
+        readonly name: "s";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ETHTransferFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "Expired";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientETH";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidAddress";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidFeeRate";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidId";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidShortString";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidSignature";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OwnableInvalidOwner";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "OwnableUnauthorizedAccount";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ReentrancyGuardReentrantCall";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SafeERC20FailedOperation";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "StringTooLong";
+    readonly inputs: readonly [{
+        readonly name: "str";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+}];
+
+/**
+ * The ABI of (ethereum) `mainnet` USDT (copied from etherscan).
+ * @note Only use it with the old & non-standard (ethereum) `mainnet` USDT contract `0xdAC17F958D2ee523a2206206994597C13D831ec7`.
+ * @see https://etherscan.io/address/0xdAC17F958D2ee523a2206206994597C13D831ec7#code
+ */
+declare const mainnetUSDTAbi: readonly [{
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "name";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_upgradedAddress";
+        readonly type: "address";
+    }];
+    readonly name: "deprecate";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_spender";
+        readonly type: "address";
+    }, {
+        readonly name: "_value";
+        readonly type: "uint256";
+    }];
+    readonly name: "approve";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "deprecated";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_evilUser";
+        readonly type: "address";
+    }];
+    readonly name: "addBlackList";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "totalSupply";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_from";
+        readonly type: "address";
+    }, {
+        readonly name: "_to";
+        readonly type: "address";
+    }, {
+        readonly name: "_value";
+        readonly type: "uint256";
+    }];
+    readonly name: "transferFrom";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "upgradedAddress";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly name: "balances";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "decimals";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "maximumFee";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "_totalSupply";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [];
+    readonly name: "unpause";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "_maker";
+        readonly type: "address";
+    }];
+    readonly name: "getBlackListStatus";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }, {
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly name: "allowed";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "paused";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "who";
+        readonly type: "address";
+    }];
+    readonly name: "balanceOf";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [];
+    readonly name: "pause";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "getOwner";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "owner";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "symbol";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_to";
+        readonly type: "address";
+    }, {
+        readonly name: "_value";
+        readonly type: "uint256";
+    }];
+    readonly name: "transfer";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "newBasisPoints";
+        readonly type: "uint256";
+    }, {
+        readonly name: "newMaxFee";
+        readonly type: "uint256";
+    }];
+    readonly name: "setParams";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "issue";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "redeem";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "_owner";
+        readonly type: "address";
+    }, {
+        readonly name: "_spender";
+        readonly type: "address";
+    }];
+    readonly name: "allowance";
+    readonly outputs: readonly [{
+        readonly name: "remaining";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "basisPointsRate";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly name: "isBlackListed";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_clearedUser";
+        readonly type: "address";
+    }];
+    readonly name: "removeBlackList";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: true;
+    readonly inputs: readonly [];
+    readonly name: "MAX_UINT";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "newOwner";
+        readonly type: "address";
+    }];
+    readonly name: "transferOwnership";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly constant: false;
+    readonly inputs: readonly [{
+        readonly name: "_blackListedUser";
+        readonly type: "address";
+    }];
+    readonly name: "destroyBlackFunds";
+    readonly outputs: readonly [];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly name: "_initialSupply";
+        readonly type: "uint256";
+    }, {
+        readonly name: "_name";
+        readonly type: "string";
+    }, {
+        readonly name: "_symbol";
+        readonly type: "string";
+    }, {
+        readonly name: "_decimals";
+        readonly type: "uint256";
+    }];
+    readonly payable: false;
+    readonly stateMutability: "nonpayable";
+    readonly type: "constructor";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "Issue";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "Redeem";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly name: "newAddress";
+        readonly type: "address";
+    }];
+    readonly name: "Deprecate";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly name: "feeBasisPoints";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly name: "maxFee";
+        readonly type: "uint256";
+    }];
+    readonly name: "Params";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly name: "_blackListedUser";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "_balance";
+        readonly type: "uint256";
+    }];
+    readonly name: "DestroyedBlackFunds";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly name: "_user";
+        readonly type: "address";
+    }];
+    readonly name: "AddedBlackList";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: false;
+        readonly name: "_user";
+        readonly type: "address";
+    }];
+    readonly name: "RemovedBlackList";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Approval";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly name: "value";
+        readonly type: "uint256";
+    }];
+    readonly name: "Transfer";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [];
+    readonly name: "Pause";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [];
+    readonly name: "Unpause";
+    readonly type: "event";
+}];
+
+/** ERC7528 ETH address */
+declare const ETH = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+/**
+ * USDT addresses
+ * @see Tether deployed USDT (only mainnets) https://tether.to/en/supported-protocols
+ */
+declare const USDT_ADDRESSES: Record<number, string>;
+/**
+ * USDC addresses
+ * @see https://developers.circle.com/stablecoins/usdc-contract-addresses
+ */
+declare const USDC_ADDRESSES: Record<number, string>;
+/**
+ * PaymentRouter deployed by prod-deployer `0xB6bB80d3737Bd98A07d424e7fdde95EAE40DbaB8`
+ * salt: `bytes32(keccak256("PaymentRouterCheckpointOne"))`
+ */
+declare const PAYMENT_ROUTER = "0xe50342E06Ab270dfecc69C3B1EE6Da7E2e2D02f0";
+
+/** Chain IDs supported by OozooPay */
+declare const MAINNET_CHAIN_IDS: readonly [1, 42161, 8453, 56, 137, 8217];
+declare const TESTNET_CHAIN_IDS: readonly [31337, 11155111, 421614, 84532, 97, 80002, 1001];
+/** Ethereum mainnet chain ID */
+declare const ETHEREUM_MAINNET_ID = 1;
+
+/** Check if token address is the native coin (ETH) sentinel address */
+declare function isNativeCoin(tokenAddress: string): boolean;
+/**
+ * Check if the token is Ethereum mainnet USDT (non-standard ERC20).
+ * Mainnet USDT requires special handling: revoke to 0 before re-approving.
+ */
+declare function isMainnetUSDT(chainId: number, tokenAddress: string): boolean;
+
+/**
+ * Chain-agnostic provider functions.
+ * Currently only EVM is supported.
+ */
+
+type ChainType = 'evm' | 'svm';
+/**
+ * Get native coin balance (ETH, etc.).
+ */
+declare function getNativeBalance(chainType: ChainType, provider: EIP1193Provider, address: string): Promise<bigint>;
+/**
+ * Get token balance (ERC-20, etc.).
+ */
+declare function getTokenBalance(chainType: ChainType, provider: EIP1193Provider, tokenAddress: string, walletAddress: string): Promise<bigint>;
+/**
+ * Estimate gas/fee cost in native token units.
+ */
+declare function estimateGasCost(chainType: ChainType, provider: EIP1193Provider, gasUnits?: bigint): Promise<bigint>;
+
+export { ApiError, type ChainType, ConfigError, type CreateInvoiceParams, type EIP1193Provider, ETH, ETHEREUM_MAINNET_ID, type EncodedTransaction, type GetBalanceResult, MAINNET_CHAIN_IDS, OozooPayClient, OozooPayError, type OozooPostMessage, PAYMENT_ROUTER, type PayInvoiceParams, type PayOptions, type PaymentConfig, type PaymentData, type PaymentInstruction, type PaymentRouter, PaymentRouterAbi, type PaymentSetting, type PostMessageCancel, type PostMessageCreateInvoice, type PostMessageCreateInvoiceResult, type PostMessageReady, type PostMessageResize, type PostMessageSnackbar, type PostMessageSnackbarAction, type PostMessageSuccess, type PriceUnit, type RequestPaymentOptions, type RequestWithdrawalOptions, TESTNET_CHAIN_IDS, type TransferInvoiceParams, type TransferOptions, USDC_ADDRESSES, USDT_ADDRESSES, encodePaymentTransaction, estimateGasCost, getNativeBalance, getTokenBalance, isMainnetUSDT, isNativeCoin, loadOozooPay, mainnetUSDTAbi };