ATXSwap

核心功能

ATXSwap是一套基于Node.js的BSC链DeFi工具集，通过atxswap-sdk实现ATX/USDT交易对的完整生命周期管理。核心功能包括：

钱包管理：单实例单钱包架构，支持密码加密创建、MetaMask兼容keystore导出（V3格式），密钥存储于~/.config/atxswap/keystore，主密码通过系统密钥链（macOS Keychain/Secret Service）加密托管。明确禁止私钥导入与明文导出。

交易执行：对接PancakeSwap V3，支持ATX/USDT双向兑换，内置滑点保护（默认bps可配置），所有交易前必须通过query.js quote获取模拟报价并等待用户确认。

流动性操作：完整的V3 LP管理——添加流动性支持全范围/自定义价格区间（USDT/ATX计价或原始tick）/百分比波动范围三种模式；移除流动性可按比例执行；费用收集与空仓位NFT销毁。query.js positions提供人类可读的价格区间（USDT per ATX）、当前价格是否在区间内、待领取费用等关键信息。

查询工具：实时价格、钱包余额、LP仓位详情（含本金计算与未领取费用）、任意ERC20代币信息。

转账功能：支持BNB、ATX、USDT及任意ERC20代币转账。

显著优点

• 安全架构严谨：私钥永不暴露，仅导出加密keystore；密码托管于系统级安全存储；14条硬性安全规则覆盖备份、删除、传输全流程
• 人类友好设计：LP仓位以USDT/ATX价格区间呈现，隐藏复杂tick计算；所有写操作强制预览-确认流程
• 容错机制：BSC_RPC_URL支持多节点故障转移，内置6个公共RPC回退
• 确定性执行：脚本化操作适合自动化代理，JSON结构化输出便于集成

潜在局限

• 单钱包限制：每实例仅允许一个钱包，无法多账户并行管理
• 生态封闭性：专精于ATX/USDT交易对，其他交易对支持有限
• 依赖外部RPC：BSC网络拥堵时可能遭遇延迟或失败
• 无MEV保护：未内置防抢跑机制，大额交易存在滑点风险
• 密码不可恢复：遗忘密码需通过系统密钥链本地处理，无中心化恢复途径

适合人群

• 需要自动化ATX持仓管理的DeFi用户
• 运行交易代理/策略机器人的开发者
• 熟悉命令行且重视密钥自托管的安全意识用户
• PancakeSwap V3流动性提供者，尤其是需要程序化调整仓位的主动做市者

常规风险

资金风险：所有BSC写操作为真实资产交易，需严格遵循预览-确认流程；自定义价格区间可能因ATX价格波动导致临时性无常损失或完全出Range。

密钥风险：keystore备份文件需用户自行妥善保管，泄露可能导致资金损失；force delete wallet删除操作不可逆。

技术风险：依赖atxswap-sdk与Node.js/npm环境，依赖冲突或RPC失效可能导致操作中断；SDK更新可能引入行为变更。

操作风险：代理需准确解析用户意图（如区分"添加0.1 USDT流动性"与"添加价值0.1 USDT的ATX"），错误参数可能导致非预期交易。

合规提示：ATX为特定项目代币，需关注相关司法辖区的证券法与税务申报义务。

核心用法

ATXSwap Skill 是一套专为 BSC（币安智能链）设计的去中心化交易工具集，主要服务于 ATX 代币的链上操作需求。该技能通过 Node.js 脚本封装了完整的 DeFi 工作流程，涵盖六大核心模块：

钱包管理 (wallet.js)：支持创建单实例钱包（不支持私钥导入），自动生成 MetaMask 兼容的加密 keystore 备份。钱包密码采用系统级安全存储（Keychain/Secret Service），私钥永不以明文形式暴露。

市场查询 (query.js)：提供实时价格查询、余额检查、兑换报价模拟、LP 仓位详情分析等功能。特别针对 V3 流动性仓位，计算并展示以 USDT/ATX 为单位的价格区间、当前是否在区间内、以及待领取的手续费收益。

代币兑换 (swap.js)：支持 ATX/USDT 对的买入和卖出操作，可自定义滑点容忍度和发起地址。

流动性操作 (liquidity.js)：提供添加流动性（全区间或自定义价格区间）、移除流动性、收取手续费、销毁空 NFT 等完整 V3 LP 功能。支持以 USDT 计价的价格区间设置，或基于当前价格的百分比范围配置。

资产转账 (transfer.js)：支持 BNB、ATX、USDT 及任意 ERC20 代币的安全转账。

安全执行流程：所有写操作（swap、transfer、liquidity）强制遵循"预览→确认→执行"三步流程，必须在获得用户明确确认后方可提交链上交易。

显著优点

1. 金融级安全设计：采用多层防护机制——私钥本地加密存储、密码系统级托管、操作前强制预览、写操作双重确认、keystore 备份流转控制。符合 DeFi 领域最高安全标准。

2. 完善的 V3 LP 支持：针对 Uniswap V3/PancakeSwap V3 的集中流动性模型，提供直观的 USDT/ATX 价格区间表达，自动计算仓位本金价值和待领取手续费，大幅降低 LP 管理复杂度。

3. 用户友好的交互设计：将复杂的 V3 tick 计算隐藏在后台，用户只需理解"价格区间"和"当前是否在区间内"两个核心概念即可完成专业级流动性操作。

4. 来源可信度高：由 agentswapx GitHub 组织维护，依赖官方 atxswap-sdk npm 包，无已知供应链风险。

5. 灵活的 RPC 配置：支持多节点 fallback 机制，内置 6 个 BSC 公共 RPC 端点，同时允许用户自定义私有节点。

潜在缺点与局限性

1. 单钱包限制：每个技能实例仅支持创建一个钱包，不支持多钱包管理，也不支持现有私钥导入，对已有资产的用户不够友好。

2. 代币对局限性：核心功能聚焦于 ATX/USDT 交易对，对其他代币对的支持依赖通用 ERC20 接口，体验和优化程度可能不及原生支持的对。

3. Node.js 环境依赖：要求 Node.js 18+ 和 npm，对非技术用户存在一定门槛，且 npm install 失败时需要人工介入排查。

4. L1 级动态代码风险：文档中提及的远程安装脚本（curl | bash 模式）存在单层动态代码加载风险，虽目标为可信域名，但仍建议用户审查后再执行。

5. 无硬件钱包支持：当前仅支持软件 keystore 管理，未集成 Ledger、Trezor 等硬件钱包方案。

适合的目标群体

• ATX 代币持有者：需要便捷、安全地进行 ATX 交易、LP 收益管理的用户
• DeFi 进阶用户：熟悉 V3 集中流动性模型，希望获得比网页端更自动化操作体验的交易者
• Agent 运营者：需要为 AI Agent 配置安全、可审计的链上交易能力的开发者或机构
• 安全意识较强的用户：重视私钥安全、偏好本地加密存储而非浏览器扩展钱包的用户

使用风险提醒

1. 资产安全风险：所有写操作涉及真实 BSC 链上资产，操作不可逆，请确保充分理解滑点、无常损失等 DeFi 风险后再执行大额操作。

2. 私钥管理风险：虽然 skill 设计了多重保护，但用户仍需妥善保管加密 keystore 备份和密码。密码丢失将导致资产无法找回，skill 方也无法协助恢复。

3. RPC 节点风险：使用公共 RPC 可能存在延迟、限速或数据不一致问题，建议高价值操作时使用私有节点或官方推荐节点。

4. 依赖更新风险：npm 依赖若未及时更新可能引入漏洞，建议关注 atxswap-sdk 的安全公告。

5. 智能合约风险：ATX 代币合约及 PancakeSwap V3 合约本身可能存在未发现的漏洞，极端情况下可能导致资产损失。