anchor-sdk 0.1.41-internal.4 → 0.1.41-internal.6

package/dist/AnchorPayClient.d.ts

@@ -1,5 +1,13 @@
 import { Account, Address, Chain, Hex, PublicClient, TransactionReceipt, WalletClient } from "viem";
 import { PaymentOptions } from "./types";
+/**
+ * 批量转账参数
+ */
+export interface BatchTransferItem {
+    recipient: Address;
+    amount: bigint;
+    data?: Hex;
+}
 /**
  * AnchorPay 客户端
  * 用于与 AnchorPay 合约交互
@@ -76,4 +84,90 @@ export declare class AnchorPayClient {
         data: string;
         value: bigint;
     };
+    /**
+     * 查询账户在 AnchorPay 合约中的代币余额
+     * @param account 账户地址
+     * @param token 代币地址（使用 NATIVE_TOKEN_ADDRESS 表示原生代币）
+     * @returns 余额
+     */
+    balanceOf(account: Address, token: Address): Promise<bigint>;
+    /**
+     * 为指定地址存入 ETH 到 AnchorPay 合约
+     * @param recipient 接收者地址
+     * @param amount 金额（单位：wei）
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    depositETH(recipient: Address, amount: bigint, options?: PaymentOptions): Promise<TransactionReceipt | {
+        to: string;
+        data: string;
+        value: bigint;
+    }>;
+    /**
+     * 为指定地址存入 ERC20 代币到 AnchorPay 合约
+     * @param recipient 接收者地址
+     * @param tokenAddress ERC20 代币地址
+     * @param amount 金额
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    depositERC20(recipient: Address, tokenAddress: Address, amount: bigint, options?: PaymentOptions): Promise<TransactionReceipt | {
+        to: string;
+        data: string;
+        value: bigint;
+    }>;
+    /**
+     * 从 AnchorPay 合约提取代币
+     * @param tokenAddress 代币地址（使用 NATIVE_TOKEN_ADDRESS 表示原生代币）
+     * @param amount 金额
+     * @param options 交易选项
+     * @returns 交易收据
+     */
+    withdraw(tokenAddress: Address, amount: bigint, options?: PaymentOptions): Promise<TransactionReceipt>;
+    /**
+     * 批量存入 ETH（使用 Multicall3）
+     * @param deposits 批量存款参数数组，每项包含接收者地址和金额
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    batchDepositETH(deposits: BatchTransferItem[], options?: PaymentOptions): Promise<TransactionReceipt | {
+        to: string;
+        data: string;
+        value: bigint;
+    }>;
+    /**
+     * 批量存入 ERC20 代币（使用 Multicall3）
+     * @param tokenAddress ERC20 代币地址
+     * @param deposits 批量存款参数数组
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    batchDepositERC20(tokenAddress: Address, deposits: BatchTransferItem[], options?: PaymentOptions): Promise<TransactionReceipt | {
+        to: string;
+        data: string;
+        value: bigint;
+    }>;
+    /**
+     * 批量发送 ETH（使用 Multicall3）
+     * @param transfers 批量转账参数数组
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    batchSendETH(transfers: BatchTransferItem[], options?: PaymentOptions): Promise<TransactionReceipt | {
+        to: string;
+        data: string;
+        value: bigint;
+    }>;
+    /**
+     * 批量发送 ERC20 代币（使用 Multicall3）
+     * @param tokenAddress ERC20 代币地址
+     * @param transfers 批量转账参数数组
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    batchSendERC20(tokenAddress: Address, transfers: BatchTransferItem[], options?: PaymentOptions): Promise<TransactionReceipt | {
+        to: string;
+        data: string;
+        value: bigint;
+    }>;
 }

package/dist/AnchorPayClient.js

@@ -271,5 +271,638 @@ class AnchorPayClient {
             value: 0n, // ERC20 批准不需要发送 ETH
         };
     }
+    /**
+     * 查询账户在 AnchorPay 合约中的代币余额
+     * @param account 账户地址
+     * @param token 代币地址（使用 NATIVE_TOKEN_ADDRESS 表示原生代币）
+     * @returns 余额
+     */
+    async balanceOf(account, token) {
+        return (await this.publicClient.readContract({
+            address: this.contracts?.anchorPay || "",
+            abi: AnchorPay_json_1.default,
+            functionName: "balanceOf",
+            args: [account, token],
+        }));
+    }
+    /**
+     * 为指定地址存入 ETH 到 AnchorPay 合约
+     * @param recipient 接收者地址
+     * @param amount 金额（单位：wei）
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    async depositETH(recipient, amount, options) {
+        // 如果需要发送交易，但没有钱包客户端或账户
+        if (options?.sendTransaction !== false &&
+            (!this.walletClient || !this.account)) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        // 准备交易数据
+        const calldata = (0, viem_1.encodeFunctionData)({
+            abi: AnchorPay_json_1.default,
+            functionName: "depositFor",
+            args: [recipient, constants_1.NATIVE_TOKEN_ADDRESS, amount],
+        });
+        // 如果不需要发送交易，只返回交易数据（AA 模式）
+        if (options?.sendTransaction === false) {
+            return {
+                to: this.contracts?.anchorPay || "",
+                data: calldata,
+                value: amount,
+            };
+        }
+        // 估算 gas 和费用
+        const { maxFeePerGas, maxPriorityFeePerGas } = await this.publicClient.estimateFeesPerGas();
+        const gas = await this.publicClient.estimateGas({
+            to: this.contracts?.anchorPay || "",
+            data: calldata,
+            value: amount,
+            account: this.account,
+        });
+        // 发送交易（EOA 模式）
+        if (!this.walletClient || !this.account) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        const txHash = await this.walletClient.sendTransaction({
+            account: this.account,
+            to: this.contracts?.anchorPay || "",
+            data: calldata,
+            value: amount,
+            maxFeePerGas: options?.maxFeePerGas || maxFeePerGas,
+            maxPriorityFeePerGas: options?.maxPriorityFeePerGas || maxPriorityFeePerGas,
+            gas: options?.gas || gas,
+            chain: this.publicClient.chain,
+        });
+        // 等待交易确认并返回收据
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        return receipt;
+    }
+    /**
+     * 为指定地址存入 ERC20 代币到 AnchorPay 合约
+     * @param recipient 接收者地址
+     * @param tokenAddress ERC20 代币地址
+     * @param amount 金额
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    async depositERC20(recipient, tokenAddress, amount, options) {
+        // 如果需要发送交易，但没有钱包客户端或账户
+        if (options?.sendTransaction !== false &&
+            (!this.walletClient || !this.account)) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        // 如果需要自动批准，则先批准代币（默认开启自动批准）
+        if (options?.autoApprove !== false && this.walletClient && this.account) {
+            try {
+                console.log(`Checking ERC20 token approval status: ${tokenAddress}`);
+                // 检查授权
+                const allowance = (await this.publicClient.readContract({
+                    address: tokenAddress,
+                    abi: constants_1.ERC20_ABI,
+                    functionName: "allowance",
+                    args: [this.account.address, this.contracts?.anchorPay],
+                }));
+                console.log(`Current allowance: ${allowance}, Required amount: ${amount}, AnchorPay contract address: ${this.contracts?.anchorPay}`);
+                if (allowance < amount) {
+                    console.log(`Approving ${amount} tokens to AnchorPay contract...`);
+                    // 批准代币 - 使用最大可能值进行授权，避免多次授权
+                    const maxApproveAmount = 2n ** 256n - 1n;
+                    // 估算 gas 和费用
+                    const { maxFeePerGas: approveMaxFeePerGas, maxPriorityFeePerGas: approveMaxPriorityFeePerGas, } = await this.publicClient.estimateFeesPerGas();
+                    const approveCalldata = (0, viem_1.encodeFunctionData)({
+                        abi: constants_1.ERC20_ABI,
+                        functionName: "approve",
+                        args: [this.contracts?.anchorPay, maxApproveAmount],
+                    });
+                    const approveGas = await this.publicClient.estimateGas({
+                        to: tokenAddress,
+                        data: approveCalldata,
+                        value: 0n,
+                        account: this.account,
+                    });
+                    const approveTxHash = await this.walletClient.writeContract({
+                        account: this.account,
+                        address: tokenAddress,
+                        abi: constants_1.ERC20_ABI,
+                        functionName: "approve",
+                        args: [this.contracts?.anchorPay, maxApproveAmount],
+                        chain: this.publicClient.chain,
+                        maxFeePerGas: approveMaxFeePerGas,
+                        maxPriorityFeePerGas: approveMaxPriorityFeePerGas,
+                        gas: approveGas,
+                    });
+                    console.log(`Approval transaction sent, hash: ${approveTxHash}`);
+                    // 等待交易确认
+                    await this.publicClient.waitForTransactionReceipt({
+                        hash: approveTxHash,
+                    });
+                    console.log(`Approval transaction confirmed`);
+                }
+                else {
+                    console.log(`Sufficient allowance already exists, no need for additional approval`);
+                }
+            }
+            catch (error) {
+                console.error(`Approval failed:`, error);
+                throw new Error(`ERC20 approval failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // 准备交易数据
+        const calldata = (0, viem_1.encodeFunctionData)({
+            abi: AnchorPay_json_1.default,
+            functionName: "depositFor",
+            args: [recipient, tokenAddress, amount],
+        });
+        // 如果不需要发送交易，只返回交易数据（AA 模式）
+        if (options?.sendTransaction === false) {
+            return {
+                to: this.contracts?.anchorPay || "",
+                data: calldata,
+                value: 0n,
+            };
+        }
+        // 估算 gas 和费用
+        const { maxFeePerGas, maxPriorityFeePerGas } = await this.publicClient.estimateFeesPerGas();
+        const gas = await this.publicClient.estimateGas({
+            to: this.contracts?.anchorPay || "",
+            data: calldata,
+            value: 0n,
+            account: this.account,
+        });
+        // 发送交易（EOA 模式）
+        if (!this.walletClient || !this.account) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        const txHash = await this.walletClient.sendTransaction({
+            account: this.account,
+            to: this.contracts?.anchorPay || "",
+            data: calldata,
+            maxFeePerGas: options?.maxFeePerGas || maxFeePerGas,
+            maxPriorityFeePerGas: options?.maxPriorityFeePerGas || maxPriorityFeePerGas,
+            gas: options?.gas || gas,
+            chain: this.publicClient.chain,
+        });
+        // 等待交易确认并返回收据
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        return receipt;
+    }
+    /**
+     * 从 AnchorPay 合约提取代币
+     * @param tokenAddress 代币地址（使用 NATIVE_TOKEN_ADDRESS 表示原生代币）
+     * @param amount 金额
+     * @param options 交易选项
+     * @returns 交易收据
+     */
+    async withdraw(tokenAddress, amount, options) {
+        if (!this.walletClient || !this.account) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        // 估算 gas 和费用
+        const { maxFeePerGas, maxPriorityFeePerGas } = await this.publicClient.estimateFeesPerGas();
+        const calldata = (0, viem_1.encodeFunctionData)({
+            abi: AnchorPay_json_1.default,
+            functionName: "withdraw",
+            args: [tokenAddress, amount],
+        });
+        const gas = await this.publicClient.estimateGas({
+            to: this.contracts?.anchorPay || "",
+            data: calldata,
+            value: 0n,
+            account: this.account,
+        });
+        const txHash = await this.walletClient.sendTransaction({
+            account: this.account,
+            to: this.contracts?.anchorPay || "",
+            data: calldata,
+            maxFeePerGas: options?.maxFeePerGas || maxFeePerGas,
+            maxPriorityFeePerGas: options?.maxPriorityFeePerGas || maxPriorityFeePerGas,
+            gas: options?.gas || gas,
+            chain: this.publicClient.chain,
+        });
+        // 等待交易确认并返回收据
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        return receipt;
+    }
+    /**
+     * 批量存入 ETH（使用 Multicall3）
+     * @param deposits 批量存款参数数组，每项包含接收者地址和金额
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    async batchDepositETH(deposits, options) {
+        if (deposits.length === 0) {
+            throw new Error("No deposits provided");
+        }
+        // 如果需要发送交易，但没有钱包客户端或账户
+        if (options?.sendTransaction !== false &&
+            (!this.walletClient || !this.account)) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        // 准备批量调用数据
+        const calls = deposits.map((deposit) => {
+            const calldata = (0, viem_1.encodeFunctionData)({
+                abi: AnchorPay_json_1.default,
+                functionName: "depositFor",
+                args: [deposit.recipient, constants_1.NATIVE_TOKEN_ADDRESS, deposit.amount],
+            });
+            return {
+                target: this.contracts?.anchorPay || "",
+                allowFailure: false,
+                value: deposit.amount,
+                callData: calldata,
+            };
+        });
+        // 计算总金额
+        const totalValue = deposits.reduce((sum, deposit) => sum + deposit.amount, 0n);
+        // 编码 Multicall3 调用
+        const multicallData = (0, viem_1.encodeFunctionData)({
+            abi: constants_1.MULTICALL3_ABI,
+            functionName: "aggregate3Value",
+            args: [calls],
+        });
+        // 如果不需要发送交易，只返回交易数据（AA 模式）
+        if (options?.sendTransaction === false) {
+            return {
+                to: constants_1.MULTICALL3_ADDRESS,
+                data: multicallData,
+                value: totalValue,
+            };
+        }
+        // 估算 gas 和费用
+        const { maxFeePerGas, maxPriorityFeePerGas } = await this.publicClient.estimateFeesPerGas();
+        const gas = await this.publicClient.estimateGas({
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            value: totalValue,
+            account: this.account,
+        });
+        // 发送交易（EOA 模式）
+        if (!this.walletClient || !this.account) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        const txHash = await this.walletClient.sendTransaction({
+            account: this.account,
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            value: totalValue,
+            maxFeePerGas: options?.maxFeePerGas || maxFeePerGas,
+            maxPriorityFeePerGas: options?.maxPriorityFeePerGas || maxPriorityFeePerGas,
+            gas: options?.gas || gas,
+            chain: this.publicClient.chain,
+        });
+        // 等待交易确认并返回收据
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        return receipt;
+    }
+    /**
+     * 批量存入 ERC20 代币（使用 Multicall3）
+     * @param tokenAddress ERC20 代币地址
+     * @param deposits 批量存款参数数组
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    async batchDepositERC20(tokenAddress, deposits, options) {
+        if (deposits.length === 0) {
+            throw new Error("No deposits provided");
+        }
+        // 如果需要发送交易，但没有钱包客户端或账户
+        if (options?.sendTransaction !== false &&
+            (!this.walletClient || !this.account)) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        // 计算总金额（用于批准检查）
+        const totalAmount = deposits.reduce((sum, deposit) => sum + deposit.amount, 0n);
+        // 如果需要自动批准，则先批准代币（默认开启自动批准）
+        if (options?.autoApprove !== false && this.walletClient && this.account) {
+            try {
+                console.log(`Checking ERC20 token approval status: ${tokenAddress}`);
+                // 检查授权
+                const allowance = (await this.publicClient.readContract({
+                    address: tokenAddress,
+                    abi: constants_1.ERC20_ABI,
+                    functionName: "allowance",
+                    args: [this.account.address, this.contracts?.anchorPay],
+                }));
+                console.log(`Current allowance: ${allowance}, Required amount: ${totalAmount}, AnchorPay contract address: ${this.contracts?.anchorPay}`);
+                if (allowance < totalAmount) {
+                    console.log(`Approving ${totalAmount} tokens to AnchorPay contract...`);
+                    // 批准代币 - 使用最大可能值进行授权，避免多次授权
+                    const maxApproveAmount = 2n ** 256n - 1n;
+                    // 估算 gas 和费用
+                    const { maxFeePerGas: approveMaxFeePerGas, maxPriorityFeePerGas: approveMaxPriorityFeePerGas, } = await this.publicClient.estimateFeesPerGas();
+                    const approveCalldata = (0, viem_1.encodeFunctionData)({
+                        abi: constants_1.ERC20_ABI,
+                        functionName: "approve",
+                        args: [this.contracts?.anchorPay, maxApproveAmount],
+                    });
+                    const approveGas = await this.publicClient.estimateGas({
+                        to: tokenAddress,
+                        data: approveCalldata,
+                        value: 0n,
+                        account: this.account,
+                    });
+                    const approveTxHash = await this.walletClient.writeContract({
+                        account: this.account,
+                        address: tokenAddress,
+                        abi: constants_1.ERC20_ABI,
+                        functionName: "approve",
+                        args: [this.contracts?.anchorPay, maxApproveAmount],
+                        chain: this.publicClient.chain,
+                        maxFeePerGas: approveMaxFeePerGas,
+                        maxPriorityFeePerGas: approveMaxPriorityFeePerGas,
+                        gas: approveGas,
+                    });
+                    console.log(`Approval transaction sent, hash: ${approveTxHash}`);
+                    // 等待交易确认
+                    await this.publicClient.waitForTransactionReceipt({
+                        hash: approveTxHash,
+                    });
+                    console.log(`Approval transaction confirmed`);
+                }
+                else {
+                    console.log(`Sufficient allowance already exists, no need for additional approval`);
+                }
+            }
+            catch (error) {
+                console.error(`Approval failed:`, error);
+                throw new Error(`ERC20 approval failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // 准备批量调用数据
+        const calls = deposits.map((deposit) => {
+            const calldata = (0, viem_1.encodeFunctionData)({
+                abi: AnchorPay_json_1.default,
+                functionName: "depositFor",
+                args: [deposit.recipient, tokenAddress, deposit.amount],
+            });
+            return {
+                target: this.contracts?.anchorPay || "",
+                allowFailure: false,
+                value: 0n,
+                callData: calldata,
+            };
+        });
+        // 编码 Multicall3 调用
+        const multicallData = (0, viem_1.encodeFunctionData)({
+            abi: constants_1.MULTICALL3_ABI,
+            functionName: "aggregate3Value",
+            args: [calls],
+        });
+        // 如果不需要发送交易，只返回交易数据（AA 模式）
+        if (options?.sendTransaction === false) {
+            return {
+                to: constants_1.MULTICALL3_ADDRESS,
+                data: multicallData,
+                value: 0n,
+            };
+        }
+        // 估算 gas 和费用
+        const { maxFeePerGas, maxPriorityFeePerGas } = await this.publicClient.estimateFeesPerGas();
+        const gas = await this.publicClient.estimateGas({
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            value: 0n,
+            account: this.account,
+        });
+        // 发送交易（EOA 模式）
+        if (!this.walletClient || !this.account) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        const txHash = await this.walletClient.sendTransaction({
+            account: this.account,
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            maxFeePerGas: options?.maxFeePerGas || maxFeePerGas,
+            maxPriorityFeePerGas: options?.maxPriorityFeePerGas || maxPriorityFeePerGas,
+            gas: options?.gas || gas,
+            chain: this.publicClient.chain,
+        });
+        // 等待交易确认并返回收据
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        return receipt;
+    }
+    /**
+     * 批量发送 ETH（使用 Multicall3）
+     * @param transfers 批量转账参数数组
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    async batchSendETH(transfers, options) {
+        if (transfers.length === 0) {
+            throw new Error("No transfers provided");
+        }
+        // 如果需要发送交易，但没有钱包客户端或账户
+        if (options?.sendTransaction !== false &&
+            (!this.walletClient || !this.account)) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        // 准备批量调用数据
+        const calls = transfers.map((transfer) => {
+            const calldata = (0, viem_1.encodeFunctionData)({
+                abi: AnchorPay_json_1.default,
+                functionName: "send",
+                args: [
+                    transfer.recipient,
+                    constants_1.NATIVE_TOKEN_ADDRESS,
+                    transfer.amount,
+                    transfer.data || "0x",
+                ],
+            });
+            return {
+                target: this.contracts?.anchorPay || "",
+                allowFailure: false,
+                value: transfer.amount,
+                callData: calldata,
+            };
+        });
+        // 计算总金额
+        const totalValue = transfers.reduce((sum, transfer) => sum + transfer.amount, 0n);
+        // 编码 Multicall3 调用
+        const multicallData = (0, viem_1.encodeFunctionData)({
+            abi: constants_1.MULTICALL3_ABI,
+            functionName: "aggregate3Value",
+            args: [calls],
+        });
+        // 如果不需要发送交易，只返回交易数据（AA 模式）
+        if (options?.sendTransaction === false) {
+            return {
+                to: constants_1.MULTICALL3_ADDRESS,
+                data: multicallData,
+                value: totalValue,
+            };
+        }
+        // 估算 gas 和费用
+        const { maxFeePerGas, maxPriorityFeePerGas } = await this.publicClient.estimateFeesPerGas();
+        const gas = await this.publicClient.estimateGas({
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            value: totalValue,
+            account: this.account,
+        });
+        // 发送交易（EOA 模式）
+        if (!this.walletClient || !this.account) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        const txHash = await this.walletClient.sendTransaction({
+            account: this.account,
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            value: totalValue,
+            maxFeePerGas: options?.maxFeePerGas || maxFeePerGas,
+            maxPriorityFeePerGas: options?.maxPriorityFeePerGas || maxPriorityFeePerGas,
+            gas: options?.gas || gas,
+            chain: this.publicClient.chain,
+        });
+        // 等待交易确认并返回收据
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        return receipt;
+    }
+    /**
+     * 批量发送 ERC20 代币（使用 Multicall3）
+     * @param tokenAddress ERC20 代币地址
+     * @param transfers 批量转账参数数组
+     * @param options 交易选项
+     * @returns 交易收据或交易数据
+     */
+    async batchSendERC20(tokenAddress, transfers, options) {
+        if (transfers.length === 0) {
+            throw new Error("No transfers provided");
+        }
+        // 如果需要发送交易，但没有钱包客户端或账户
+        if (options?.sendTransaction !== false &&
+            (!this.walletClient || !this.account)) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        // 计算总金额（用于批准检查）
+        const totalAmount = transfers.reduce((sum, transfer) => sum + transfer.amount, 0n);
+        // 如果需要自动批准，则先批准代币（默认开启自动批准）
+        if (options?.autoApprove !== false && this.walletClient && this.account) {
+            try {
+                console.log(`Checking ERC20 token approval status: ${tokenAddress}`);
+                // 检查授权
+                const allowance = (await this.publicClient.readContract({
+                    address: tokenAddress,
+                    abi: constants_1.ERC20_ABI,
+                    functionName: "allowance",
+                    args: [this.account.address, this.contracts?.anchorPay],
+                }));
+                console.log(`Current allowance: ${allowance}, Required amount: ${totalAmount}, AnchorPay contract address: ${this.contracts?.anchorPay}`);
+                if (allowance < totalAmount) {
+                    console.log(`Approving ${totalAmount} tokens to AnchorPay contract...`);
+                    // 批准代币 - 使用最大可能值进行授权，避免多次授权
+                    const maxApproveAmount = 2n ** 256n - 1n;
+                    // 估算 gas 和费用
+                    const { maxFeePerGas: approveMaxFeePerGas, maxPriorityFeePerGas: approveMaxPriorityFeePerGas, } = await this.publicClient.estimateFeesPerGas();
+                    const approveCalldata = (0, viem_1.encodeFunctionData)({
+                        abi: constants_1.ERC20_ABI,
+                        functionName: "approve",
+                        args: [this.contracts?.anchorPay, maxApproveAmount],
+                    });
+                    const approveGas = await this.publicClient.estimateGas({
+                        to: tokenAddress,
+                        data: approveCalldata,
+                        value: 0n,
+                        account: this.account,
+                    });
+                    const approveTxHash = await this.walletClient.writeContract({
+                        account: this.account,
+                        address: tokenAddress,
+                        abi: constants_1.ERC20_ABI,
+                        functionName: "approve",
+                        args: [this.contracts?.anchorPay, maxApproveAmount],
+                        chain: this.publicClient.chain,
+                        maxFeePerGas: approveMaxFeePerGas,
+                        maxPriorityFeePerGas: approveMaxPriorityFeePerGas,
+                        gas: approveGas,
+                    });
+                    console.log(`Approval transaction sent, hash: ${approveTxHash}`);
+                    // 等待交易确认
+                    await this.publicClient.waitForTransactionReceipt({
+                        hash: approveTxHash,
+                    });
+                    console.log(`Approval transaction confirmed`);
+                }
+                else {
+                    console.log(`Sufficient allowance already exists, no need for additional approval`);
+                }
+            }
+            catch (error) {
+                console.error(`Approval failed:`, error);
+                throw new Error(`ERC20 approval failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // 准备批量调用数据
+        const calls = transfers.map((transfer) => {
+            const calldata = (0, viem_1.encodeFunctionData)({
+                abi: AnchorPay_json_1.default,
+                functionName: "send",
+                args: [
+                    transfer.recipient,
+                    tokenAddress,
+                    transfer.amount,
+                    transfer.data || "0x",
+                ],
+            });
+            return {
+                target: this.contracts?.anchorPay || "",
+                allowFailure: false,
+                value: 0n,
+                callData: calldata,
+            };
+        });
+        // 编码 Multicall3 调用
+        const multicallData = (0, viem_1.encodeFunctionData)({
+            abi: constants_1.MULTICALL3_ABI,
+            functionName: "aggregate3Value",
+            args: [calls],
+        });
+        // 如果不需要发送交易，只返回交易数据（AA 模式）
+        if (options?.sendTransaction === false) {
+            return {
+                to: constants_1.MULTICALL3_ADDRESS,
+                data: multicallData,
+                value: 0n,
+            };
+        }
+        // 估算 gas 和费用
+        const { maxFeePerGas, maxPriorityFeePerGas } = await this.publicClient.estimateFeesPerGas();
+        const gas = await this.publicClient.estimateGas({
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            value: 0n,
+            account: this.account,
+        });
+        // 发送交易（EOA 模式）
+        if (!this.walletClient || !this.account) {
+            throw new Error("Wallet client and account are required to send transactions");
+        }
+        const txHash = await this.walletClient.sendTransaction({
+            account: this.account,
+            to: constants_1.MULTICALL3_ADDRESS,
+            data: multicallData,
+            maxFeePerGas: options?.maxFeePerGas || maxFeePerGas,
+            maxPriorityFeePerGas: options?.maxPriorityFeePerGas || maxPriorityFeePerGas,
+            gas: options?.gas || gas,
+            chain: this.publicClient.chain,
+        });
+        // 等待交易确认并返回收据
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+            hash: txHash,
+        });
+        return receipt;
+    }
 }
 exports.AnchorPayClient = AnchorPayClient;

package/dist/abi/AnchorPay.json

@@ -24,6 +24,53 @@
         "outputs": [],
         "stateMutability": "nonpayable"
     },
+    {
+        "type": "function",
+        "name": "balanceOf",
+        "inputs": [
+            {
+                "name": "account",
+                "type": "address",
+                "internalType": "address"
+            },
+            {
+                "name": "token",
+                "type": "address",
+                "internalType": "address"
+            }
+        ],
+        "outputs": [
+            {
+                "name": "",
+                "type": "uint256",
+                "internalType": "uint256"
+            }
+        ],
+        "stateMutability": "view"
+    },
+    {
+        "type": "function",
+        "name": "depositFor",
+        "inputs": [
+            {
+                "name": "recipient",
+                "type": "address",
+                "internalType": "address"
+            },
+            {
+                "name": "token",
+                "type": "address",
+                "internalType": "address"
+            },
+            {
+                "name": "amount",
+                "type": "uint256",
+                "internalType": "uint256"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "payable"
+    },
     {
         "type": "function",
         "name": "getInterfaceImplementer",
@@ -203,6 +250,55 @@
         "outputs": [],
         "stateMutability": "payable"
     },
+    {
+        "type": "function",
+        "name": "withdraw",
+        "inputs": [
+            {
+                "name": "token",
+                "type": "address",
+                "internalType": "address"
+            },
+            {
+                "name": "amount",
+                "type": "uint256",
+                "internalType": "uint256"
+            }
+        ],
+        "outputs": [],
+        "stateMutability": "nonpayable"
+    },
+    {
+        "type": "event",
+        "name": "Deposited",
+        "inputs": [
+            {
+                "name": "from",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "recipient",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "token",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "amount",
+                "type": "uint256",
+                "indexed": false,
+                "internalType": "uint256"
+            }
+        ],
+        "anonymous": false
+    },
     {
         "type": "event",
         "name": "Initialized",
@@ -323,6 +419,31 @@
         ],
         "anonymous": false
     },
+    {
+        "type": "event",
+        "name": "Withdrawn",
+        "inputs": [
+            {
+                "name": "recipient",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "token",
+                "type": "address",
+                "indexed": true,
+                "internalType": "address"
+            },
+            {
+                "name": "amount",
+                "type": "uint256",
+                "indexed": false,
+                "internalType": "uint256"
+            }
+        ],
+        "anonymous": false
+    },
     {
         "type": "error",
         "name": "AddressEmptyCode",
@@ -360,6 +481,11 @@
         "name": "FailedCall",
         "inputs": []
     },
+    {
+        "type": "error",
+        "name": "InsufficientBalance",
+        "inputs": []
+    },
     {
         "type": "error",
         "name": "InsufficientPayment",

package/dist/constants.d.ts

@@ -47,3 +47,114 @@ export declare const INTERFACE_HASHES: {
     TOKEN_RECEIVED: string;
 };
 export declare const NATIVE_TOKEN_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+/**
+ * Multicall3 合约地址（跨链通用）
+ */
+export declare const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+/**
+ * Multicall3 合约 ABI
+ */
+export declare const MULTICALL3_ABI: readonly [{
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "target";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "callData";
+            readonly type: "bytes";
+        }];
+        readonly internalType: "struct Multicall3.Call[]";
+        readonly name: "calls";
+        readonly type: "tuple[]";
+    }];
+    readonly name: "aggregate";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "blockNumber";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "bytes[]";
+        readonly name: "returnData";
+        readonly type: "bytes[]";
+    }];
+    readonly stateMutability: "payable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "target";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bool";
+            readonly name: "allowFailure";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "callData";
+            readonly type: "bytes";
+        }];
+        readonly internalType: "struct Multicall3.Call3[]";
+        readonly name: "calls";
+        readonly type: "tuple[]";
+    }];
+    readonly name: "aggregate3";
+    readonly outputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "bool";
+            readonly name: "success";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "returnData";
+            readonly type: "bytes";
+        }];
+        readonly internalType: "struct Multicall3.Result[]";
+        readonly name: "returnData";
+        readonly type: "tuple[]";
+    }];
+    readonly stateMutability: "payable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "target";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bool";
+            readonly name: "allowFailure";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "value";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "callData";
+            readonly type: "bytes";
+        }];
+        readonly internalType: "struct Multicall3.Call3Value[]";
+        readonly name: "calls";
+        readonly type: "tuple[]";
+    }];
+    readonly name: "aggregate3Value";
+    readonly outputs: readonly [{
+        readonly components: readonly [{
+            readonly internalType: "bool";
+            readonly name: "success";
+            readonly type: "bool";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "returnData";
+            readonly type: "bytes";
+        }];
+        readonly internalType: "struct Multicall3.Result[]";
+        readonly name: "returnData";
+        readonly type: "tuple[]";
+    }];
+    readonly stateMutability: "payable";
+    readonly type: "function";
+}];

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NATIVE_TOKEN_ADDRESS = exports.INTERFACE_HASHES = exports.ENVIRONMENTS = exports.ERC20_ABI = exports.Environment = void 0;
+exports.MULTICALL3_ABI = exports.MULTICALL3_ADDRESS = exports.NATIVE_TOKEN_ADDRESS = exports.INTERFACE_HASHES = exports.ENVIRONMENTS = exports.ERC20_ABI = exports.Environment = void 0;
 const chains_1 = require("viem/chains");
 /**
  * 环境枚举
@@ -219,3 +219,149 @@ exports.INTERFACE_HASHES = {
     TOKEN_RECEIVED: "0x8b2cb2c7b7e2282e2e4b29a6a8c2b2db4218c6a5f8e8fcb3d5598f3e1e6c59d9",
 };
 exports.NATIVE_TOKEN_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+/**
+ * Multicall3 合约地址（跨链通用）
+ */
+exports.MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+/**
+ * Multicall3 合约 ABI
+ */
+exports.MULTICALL3_ABI = [
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: "address",
+                        name: "target",
+                        type: "address",
+                    },
+                    {
+                        internalType: "bytes",
+                        name: "callData",
+                        type: "bytes",
+                    },
+                ],
+                internalType: "struct Multicall3.Call[]",
+                name: "calls",
+                type: "tuple[]",
+            },
+        ],
+        name: "aggregate",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "blockNumber",
+                type: "uint256",
+            },
+            {
+                internalType: "bytes[]",
+                name: "returnData",
+                type: "bytes[]",
+            },
+        ],
+        stateMutability: "payable",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: "address",
+                        name: "target",
+                        type: "address",
+                    },
+                    {
+                        internalType: "bool",
+                        name: "allowFailure",
+                        type: "bool",
+                    },
+                    {
+                        internalType: "bytes",
+                        name: "callData",
+                        type: "bytes",
+                    },
+                ],
+                internalType: "struct Multicall3.Call3[]",
+                name: "calls",
+                type: "tuple[]",
+            },
+        ],
+        name: "aggregate3",
+        outputs: [
+            {
+                components: [
+                    {
+                        internalType: "bool",
+                        name: "success",
+                        type: "bool",
+                    },
+                    {
+                        internalType: "bytes",
+                        name: "returnData",
+                        type: "bytes",
+                    },
+                ],
+                internalType: "struct Multicall3.Result[]",
+                name: "returnData",
+                type: "tuple[]",
+            },
+        ],
+        stateMutability: "payable",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: "address",
+                        name: "target",
+                        type: "address",
+                    },
+                    {
+                        internalType: "bool",
+                        name: "allowFailure",
+                        type: "bool",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "value",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "bytes",
+                        name: "callData",
+                        type: "bytes",
+                    },
+                ],
+                internalType: "struct Multicall3.Call3Value[]",
+                name: "calls",
+                type: "tuple[]",
+            },
+        ],
+        name: "aggregate3Value",
+        outputs: [
+            {
+                components: [
+                    {
+                        internalType: "bool",
+                        name: "success",
+                        type: "bool",
+                    },
+                    {
+                        internalType: "bytes",
+                        name: "returnData",
+                        type: "bytes",
+                    },
+                ],
+                internalType: "struct Multicall3.Result[]",
+                name: "returnData",
+                type: "tuple[]",
+            },
+        ],
+        stateMutability: "payable",
+        type: "function",
+    },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anchor-sdk",
-  "version": "0.1.41-internal.4",
+  "version": "0.1.41-internal.6",
   "description": "TypeScript SDK for interacting with Anchor ecosystem - badge minting, payment processing, and ERC1155 token management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",