anchor-sdk 0.1.41-internal.5 → 0.1.42-beta.0

package/dist/AnchorApiClientV2.d.ts

@@ -128,6 +128,7 @@ export declare class AnchorApiClientV2 {
     getBadgeSeriesDetail(seriesId: string, params?: {
         status?: string;
         businessType?: string;
+        tokenIds?: string[];
     }): Promise<WebResultBadgeSeriesDetailResponse>;
     /**
      * 获取徽章详情
@@ -150,7 +151,11 @@ export declare class AnchorApiClientV2 {
      * @param data 徽章检查请求
      * @returns 徽章检查响应
      */
-    checkUserClaimableBadges(data: object): Promise<WebResultBadgeCheckResponse>;
+    checkUserClaimableBadges(data: {
+        walletType?: "ALL" | "EVM" | "SOLANA";
+        groups?: string[];
+        [key: string]: any;
+    }): Promise<WebResultBadgeCheckResponse>;
     /**
      * 获取徽章领取签名
      * @route POST /v2/badges/signatures

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 合约交互
@@ -116,4 +124,50 @@ export declare class AnchorPayClient {
      * @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

@@ -490,5 +490,419 @@ class AnchorPayClient {
         });
         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/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";
+}];