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

package/dist/AnchorPayClient.d.ts

@@ -76,4 +76,44 @@ 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>;
 }

package/dist/AnchorPayClient.js

@@ -271,5 +271,224 @@ 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;
+    }
 }
 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anchor-sdk",
-  "version": "0.1.41-internal.4",
+  "version": "0.1.41-internal.5",
   "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",