xrpldashboard

xrpldashboard

提供内置真实性审计系统的 XRPL 公共分析服务。 在线访问：xrpldashboard.com。

项目简介

以下三点让这个仓库区别于“又一个区块链仪表板”：

1. 每个关键数字都有对应的声明记录。 CLAIMS.yaml 列出了 /rlusd、/whales、/coverage 和 /analytics 中公开展示的数值声明，并为每项关联了来源函数和时效性约定。推送前会运行 scripts/claims_check.sh。
2. 四层审计会在读者发现之前捕捉过时数据。 请参阅 docs/TRUTH_AUDIT_DESIGN.md。使用最近九起真实事故进行了回溯测试：九起全部捕捉到。 首次实时捕捉到的事故是 RLUSD 部分日期数据错误，几小时内就浮出水面，而不是像之前那样过了 53 天才被发现。
3. 每日签名快照。 使用 Ed25519 签名并通过 Merkle 链连接。/signed-snapshots 和 .well-known/snapshots/<date>.json 让任何人都能在不信任本网站的情况下，验证某个日期的数据。

快捷链接：/methodology · /signed-snapshots · docs/TRUTH_AUDIT_DESIGN.md

Agent 层（MCP）

在线公共 MCP 端点：https://mcp.xrpldashboard.com/mcp — streamable-HTTP，协议版本 2025-06-18，无需身份验证。提供 15 个只读工具，涵盖 XRPL 和 XRPL 链上的 RLUSD 供应量；每个响应都封装在证明注释信封中，包含 source、as_of、freshness_contract，以及指向 /claims 的 claims_ref。公共测试版持续至 2026-09。

60 秒即可连接 — 为 Claude Desktop 或任何 MCP 客户端复制粘贴以下配置：

{
  "mcpServers": {
    "xrpldashboard": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.xrpldashboard.com/mcp?ref=readme"
      ]
    }
  }
}

也可以在 Claude Desktop 中依次打开“设置”→“连接器”，将其添加为自定义连接器，URL 填写 https://mcp.xrpldashboard.com/mcp，身份验证选择 None。完整的接入指南（包含三个示例提示词、如实说明的限制和 429 响应格式）：/connect。

• 会话速率限制： 每个会话每小时最多调用工具 600 次，实时强制执行（超限时返回 HTTP 429 和 Retry-After）。请参阅 mcp_session_rate_limit.py。
• 发现清单： /.well-known/agents.json · /llms.txt · /openapi.json。
• 可验证的护城河： 使用 get_signed_snapshot + verify_snapshot_signature — 在 /.well-known/snapshots/pubkey.pem 固定 Ed25519 公钥，无需信任我们即可验证某日的快照。
• 底层基础设施： 我们自有的 rippled 全历史节点（位于印第安纳州的 Ubuntu 服务器 → Cloudflare Tunnel），源代码见 mcp_server.py 和 mcp_tools_*.py。

设计文档：docs/AGENT_TIER_DESIGN.md。

页面

37 个公开页面，分类如下：

• 资金流动： /whales、/pools、/tokens、/token/<id>、/mpts、/mpt/<id>、/rlusd、/lending
• 机构与监管： /institutional、/regulation、/rwa、/credentials、/amendments、/sidechain
• 覆盖范围与审计： /coverage、/methodology、/signed-snapshots、/verify、/walker-health、/health
• 读者工具： /check、/wallet/<id>、/network、/learn、/price-data、/help/already-sent-money
• 信任与其他： /about、/security、/privacy、/terms、/subprocessors、/contact

架构

• Web： Flask 3.1 + Jinja2 + Flask-Babel（i18n）+ Flask-Limiter，部署在 Render 上，由 Cloudflare 提供前置服务。
• 数据： Neon Postgres（Web 和 walkers 共用单个数据库）。
• 数据采集： 通过 launchd 运行 29 个后台服务——23 个数据采集 walker 和 canary，另有 4 个备份任务和 2 个快照签名任务。每个 walker 都会写入 walker_health；/walker-health 会显示停滞情况。
• XRPL 客户端： xrpl-py 4.5.0，采用本地优先的级联策略，连接公共 rippled 节点；静默故障转移尝试会记录到 walker_node_fallback，以便审计可靠性，而不是寄希望于它。
• 签名： 通过 cryptography 使用 Ed25519（参见 signed_snapshot.py）。

真值审计系统（为什么这个仓库可能可复用）

大多数公共仪表板都信任自己的写入结果。这个仪表板不会。四层机制协同工作：

• 第 1 层——walker 健康状态。 walker_health 行 + /walker-health 页面。用于发现“写入器停止工作，导致数字不再变化”的情况。
• 第 2 层——合理性规则。 持续运行的检查，例如“53 天内，24h 净变化不应为零”。用于发现“数据库中的数字在变化，但查询有误”的情况。
• 第 3 层——外部交叉核验。 第三方数据对比（例如，使用独立的 Ethereum RPC 核验 RLUSD 供应量，使用 CoinGecko 核验 XRP 价格），以揭示同一项测量结果存在的分歧。
• 第 4 层——声明清单。 CLAIMS.yaml + scripts/claims_check.sh。每个重要数字都列明了其来源函数和时效性约定；检查器发现偏差时会以非零状态码退出。

完整设计和 9 项全通过的回溯测试见 docs/TRUTH_AUDIT_DESIGN.md。

如果你正在构建公共数据项目并想采用这种模式，这份设计文档就是为方便借鉴而编写的。

本地运行

五分钟内可以运行： 基于一份架构副本启动 Flask Web 应用。足以浏览页面并查看 UI。

五分钟内无法运行： 完整站点，因为实时仪表板需要 walker 集群从 XRPL 采集数据并写入 Neon Postgres。搭建 walkers 属于实际的运维工作，而不是运行 docker compose up 就能完成。

快速入门（仅 Web 应用）：

python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env      # then fill in DATABASE_URL, FLASK_SECRET_KEY, etc.
python app.py             # http://localhost:5001

如需完整的数据采集设置，请参阅 docs/TRUTH_AUDIT_DESIGN.md 和 launchd/ plists（这些是作者本地的安装配置——派生项目需要调整路径）。

独立性

xrpldashboard 并非由 Ripple、XRPL Foundation 或任何交易所运营。没有付费推广。在标签或指标页面上没有联盟链接。

资金

开发由自筹资金支持；在符合使命的情况下，也会接受社区资助项目的支持（为 XRPL 提供公共产品数据基础设施）。

贡献

欢迎提交问题和 PR。如果你修改了展示重要数字的页面，请在 CLAIMS.yaml 中添加或更新相应条目；scripts/claims_check.sh 会提醒你。

许可证

MIT。参见 LICENSE。

免责声明

xrpldashboard 报告链上数据和公开监管信息。本网站或本仓库中的任何内容均不构成财务、法律或投资建议。