XRPLink

XRPLink — 经过密码学验证的 XRP 支付收据

为任意 XRP 支付生成防篡改、可独立验证的收据。 XRPLink 通过 Flare 的 FDC 协议证明 XRP 交易，并提供附带密码学 Merkle 证明、可供分享的收据。适用于合规、审计和商户对账。

已上线：https://xrp-link.com

快速开始

# Visit the hosted app
open https://xrp-link.com

# Or run locally
git clone <repo-url>
cd xrplink
npm install
cp .env.example .env
# Edit .env with your private key and API key
npm run start:rest

项目状态

已在 Flare 主网上线。端到端流水线已通过验证：XRP 交易 → 验证器 API → FdcHub → DA Layer 证明 → 链上验证。

里程碑	状态
主网部署	✅ 已上线（PaymentVerifierMainnet，地址为 0xA10034...e14b）
端到端流水线验证	✅ 已完成 — XRP 交易已在主网上完成证明
用户身份验证（注册/登录）	✅ 已完成
收据页面	✅ 已完成 — 可通过 /receipt/:txHash 分享
仪表板	✅ 已完成 — API 密钥、使用统计、收据历史记录
REST API	✅ 已完成 — 验证、状态、webhook、健康检查
API 密钥身份验证 + 速率限制	✅ 已完成
订阅层级	✅ 已完成 — 免费/付费/专业版
MCP 服务	✅ 已完成 — 5 个工具、4 个提示词、5 个资源
Hardhat 测试套件	✅ 已完成 — 8 项测试通过
开源	✅ BUSL-1.1（源代码可用）

服务模式

命令	启动内容
npm start	MCP 服务（stdio）+ REST API
npm run start:mcp	仅 MCP 服务
npm run start:rest	仅 REST API

技术栈与依赖项

依赖项	版本	用途
hardhat	^3.9.1	Solidity 开发环境
ethers	5.8.0	EVM 交互
tsx	^4.23.0	TypeScript 脚本运行器
dotenv	^17.4.2	.env 配置
express	^5.2.1	HTTP API 服务端
@flarenetwork/flare-periphery-contracts	^0.1.52	FDC 协议接口
@modelcontextprotocol/sdk	^1.29.0	MCP 服务框架

API 端点

方法	路径	身份验证	说明
POST	/auth/signup	公开	创建账户 + 免费 API 密钥
POST	/auth/login	公开	登录并获取会话令牌
GET	/me	Bearer 令牌	当前用户信息和 API 密钥
GET	/health	公开	服务状态和网络信息
GET	/dashboard	公开	HTML 用户仪表板
GET	/receipt/:txHash	公开	查看收据（HTML）
POST	/api/v1/verify/xrp-payment	API 密钥	提交 XRP 交易以进行证明
GET	/api/v1/status/:id	API 密钥	按 UUID 查询证明状态
GET	/api/v1/status-by-tx/:txHash	API 密钥	按 txHash 查询证明状态
POST	/api/v1/webhooks	API 密钥	注册 webhook 回调
POST	/billing/subscribe	Bearer 令牌	升级订阅
GET	/billing/portal	Bearer 令牌	管理账单
GET	/mcp/resources	公开	列出 MCP 资源
GET	/mcp/prompts	公开	列出 MCP 提示词

MCP 工具

工具	说明
verify_xrp_payment	提交 txHash 以进行 FDC 证明
get_attestation_status	按 UUID 查询证明状态
lookup_attestation_by_tx	按 txHash 查找证明
get_attestation_by_round	按轮次 ID 列出证明
get_server_info	服务和网络信息

通过 stdio 连接：npm run start:mcp

网络配置

参数	Coston2（测试网）	Flare 主网
RPC	https://coston2-api.flare.network	https://flare-api.flare.network
Chain ID	114	14
FdcHub	0x48aC463d7975828989331F4De43341627b9c5f1D	0xc25c749DC27Efb1864Cb3DADa8845B7687eB2d44
FdcVerification	0x906507E0B64bcD494Db73bd0459d1C667e14B933	0x9394c7A36b3Da8de1b4F27cdD0a554dA4Fa7132d
DA Layer	https://ctn2-data-availability.flare.network	https://flr-data-availability.flare.network
验证器 API	https://fdc-verifiers-testnet.flare.network	https://fdc-verifiers-mainnet.flare.network
Source ID	testXRP	XRP
首个投票轮次	1658430000	1658430000
证明费用	1 test FLR	20 FLR

架构

┌───────────────────────┐
│     User dApp         │  (Flare EVM)
│  (PaymentVerifier.sol)│
└────────┬──────────────┘
         │ verifyXRPPayment(proof)
         ▼
┌───────────────────────┐
│  FdcVerification      │  (enshrined FDC protocol contract)
│  (via ContractRegistry)│
└────────┬──────────────┘
         │
    ┌────┴────┐
    │ DA Layer│──── Proof + response
    └────┬────┘
         │
    ┌────┴────┐
    │ Verifier│──── ABI-encoded request with MIC
    └────┬────┘
         │
    XRP Testnet / Mainnet

关键数据流：

1. XRP 账本上发生 XRP 交易
2. 验证器 API 获取交易详情，计算 MIC，并返回 ABI 编码的请求
3. 请求连同 FLR 费用一起提交至 Flare 上的 FdcHub
4. FDC 提供方独立验证 XRP 交易并达成共识（90 秒一轮）
5. 通过 Relay 合约将 Merkle 根存储在链上
6. DA Layer 提供证明响应和 Merkle 证明
7. 智能合约通过 FdcVerification，根据链上 Merkle 根验证证明

贡献

请参阅 CONTRIBUTING.md。欢迎所有贡献—— 包括错误修复、功能请求、文档改进和测试补充。

XRPLink 采用源代码可用许可（BUSL-1.1），面向 Flare 生态系统构建。 非商业用途、评估和个人用途均可免费使用。将 XRPLink 作为商业服务运行，需要获得许可方的授权。

许可证

BUSL-1.1 — 请参阅 LICENSE。四年后转为 MIT。