核心用法
XPR Network Tax Reporting 是一套针对 XPR Network 链上活动的自动化加密税务申报解决方案，专为新西兰和美国纳税人设计。用户通过序列化工具调用完成完整税务报告：首先获取期初/期末余额快照，然后提取 Metal X DEX 交易历史、链上转账记录（自动分类为质押奖励、借贷利息、NFT 交易等），接着获取代币汇率数据，计算资本利得或收入，最终生成包含税级计算和免责声明的完整 Markdown 报告。
支持一键生成报告（tax_generate_report）或分步精细控制。所有工具均为只读查询，不涉及任何链上交易签名。
显著优点
1. 区域税务合规深度适配：针对新西兰（4-3月税务年度、无资本利得税、收入征税制）和美国（日历年、长短资本利得区分）的税制差异进行专门设计，内置 2024 年美国单身申报者联邦税级。
2. 智能交易分类：通过 sender/receiver 合约地址自动识别 15+ 种交易类型，包括质押奖励、长期质押收益、借贷存取及利息、DEX 出入金、NFT 买卖等，大幅减少手动对账工作。
3. 多源价格发现机制：优先使用 DEX 交易对推导价格（无 API 限制），其次前向填充，CoinGecko 作为补充（支持 API Key 解除 365 天限制），稳定币采用外汇汇率直接转换。
4. 可审计输出：生成 Markdown 报告的同时提供 CSV 导出（处置事件、收入事件），满足新西兰 IRD 7 年记录保存要求。
潜在缺点与局限性
- 数据完整性限制：仅包含已成交的 DEX 订单（不含挂单）、NFT 仅支持买卖（不含拍卖）、Metal Lending 清算未覆盖、托管支付跟踪但分类不完整。
- 历史价格依赖：价格准确性取决于 DEX 交易活跃度与 CoinGecko 数据可用性，低流动性代币可能存在定价偏差。
- 区域覆盖有限：当前仅正式支持 NZ/US，其他区域需手动传入 region 参数（默认 NZ）。
- 美国税务简化：未包含州税、NIIT（净投资所得税），仅使用单身申报者联邦税级。
适合人群
- 在新西兰或美国纳税的 XPR Network 活跃用户
- 参与 Metal X DEX 交易、XPR 长期质押、LOAN 质押、Metal Lending 的 DeFi 用户
- 需要自动化成本基础计算（FIFO/Average Cost）的加密货币投资者
- 寻求可审计税务记录以满足合规要求的个人纳税人
常规风险
- 非专业税务建议：报告包含明确免责声明，不构成税务或法律建议，复杂情况仍需咨询持牌税务顾问。
- 数据准确性依赖第三方 API：Saltant、Metal X、Hyperion、CoinGecko 的服务可用性与数据质量直接影响报告准确性。
- 遗漏交易风险：自动分类依赖合约地址匹配，新型协议或自定义合约可能未被识别。
- 汇率波动：跨境纳税人需注意 NZD/USD 汇率转换时点与税务申报要求的匹配。