xrpldashboard

xrpldashboard

組み込みの真実性監査システムを備えた、公開 XRPL 分析ダッシュボードです。 xrpldashboard.com で公開中です。

これは何か

このリポジトリが「よくあるブロックチェーンダッシュボード」と異なる点は、次の 3 つです。

1. 見出しに掲載されるすべての数値にクレームレコードがあります。 CLAIMS.yaml には、/rlusd、/whales、/coverage、/analytics 全体で公開される数値に関するクレームが列挙され、それぞれソース関数と鮮度契約にひも付けられています。プッシュ前に scripts/claims_check.sh が実行されます。
2. 4 層の監査により、読者が気付く前に古い数値を検出します。 docs/TRUTH_AUDIT_DESIGN.md をご覧ください。過去に実際に発生した 9 件のインシデントを遡って検証した結果、9 件すべてを検出しました。 最初の本番環境での検出となった RLUSD の部分日バグは、これまで見過ごされていた 53 日後ではなく、数時間以内に明らかになりました。
3. 毎日、署名付きスナップショットを作成します。 Ed25519 署名付きで、Merkle チェーンで連結されています。/signed-snapshots と .well-known/snapshots/<date>.json を使えば、サイトを信頼せずに、特定の日付時点の数値を誰でも検証できます。

クイックリンク：/methodology · /signed-snapshots · docs/TRUTH_AUDIT_DESIGN.md

エージェント層（MCP）

公開中の MCP エンドポイント：https://mcp.xrpldashboard.com/mcp — ストリーミング可能な HTTP、プロトコルバージョン 2025-06-18、認証不要。XRPL と XRPL 上の RLUSD 供給量に関する、読み取り専用の 15 種類のツールを提供します。すべてのレスポンスは、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 を指定して追加します。詳細なオンボーディングページ（プロンプトの例 3 件、正直な制限事項、429 の形式）：/connect。

• セッションレート制限： セッションあたり 1 時間に 600 回のツール呼び出しを、本番環境で適用しています（上限超過時は HTTP 429 と Retry-After を返します）。mcp_session_rate_limit.py をご覧ください。
• ディスカバリーマニフェスト： /.well-known/agents.json · /llms.txt · /openapi.json。
• 検証可能な優位性： get_signed_snapshot + verify_snapshot_signature — Ed25519 公開鍵を /.well-known/snapshots/pubkey.pem でピン留めすれば、こちらを信頼せずに特定日のスナップショットを検証できます。
• 基盤インフラ： 独自の 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 とウォーカーで共有する単一のデータベース）。
• 取り込み： launchd 配下で動作する 29 個のバックグラウンドサービス — 23 個の取り込みウォーカーとカナリアに加え、4 個のバックアップジョブと 2 個のスナップショット署名ジョブです。各ウォーカーは walker_health に書き込み、/walker-health で停止状態を確認できます。
• XRPL クライアント： xrpl-py 4.5.0 を使用し、ローカルノードを優先して公開 rippled ノードへ順次切り替えます。サイレントフェイルオーバーの試行は walker_node_fallback に記録され、信頼性を期待に頼らず監査できます。
• 署名： cryptography による Ed25519（signed_snapshot.py を参照）。

真偽監査システム（このリポジトリを再利用できる理由）

多くの公開ダッシュボードは、自らの書き込みを信頼しています。このダッシュボードはそうしません。4 つのレイヤーが連携して動作します。

• レイヤー 1 — ウォーカーの稼働状況。 walker_health の行と /walker-health ページ。「書き込みプロセスが停止したため数値の更新が止まった」という状態を検出します。
• レイヤー 2 — 妥当性ルール。 「24 時間の純変化量が 53 日間ゼロであってはならない」といった継続的なチェック。「データベースでは数値が変化しているが、クエリが間違っている」という状態を検出します。
• レイヤー 3 — 外部との照合。 第三者との比較（例：RLUSD の供給量を独立した Ethereum RPC と、XRP 価格を CoinGecko と比較）により、同じ測定値に対する不一致を明らかにします。
• レイヤー 4 — クレームマニフェスト。 CLAIMS.yaml + scripts/claims_check.sh。すべての主要な数値を、その取得元の関数と鮮度の要件とともに列挙します。チェッカーは差異があるとゼロ以外の終了コードを返します。

詳細な設計と 9 件中 9 件の事後テストについては、docs/TRUTH_AUDIT_DESIGN.md を参照してください。

公開データを扱うプロジェクトを構築していて、このパターンを利用したい場合は、設計ドキュメントをそのまま転用できるように作成しています。

ローカルでの実行

5 分で実行できるもの： スキーマのコピーに接続した Flask Web アプリです。ページを一通り確認して UI を見るには十分です。

5 分では実行できないもの： サイト全体です。ライブダッシュボードには、Neon Postgres に対して XRPL からデータを取り込むウォーカーフリートが必要です。ウォーカーの立ち上げは実際の運用作業であり、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/ の plist を参照してください（これらは作者のローカル環境へのインストール設定です。フォークする場合はパスの調整が必要です）。

独立性

xrpldashboard は Ripple、XRPL Foundation、またはいずれの取引所にも運営されていません。有料掲載はありません。ラベル付けや指標の表示面にアフィリエイトリンクはありません。

資金調達

開発資金は自己負担です。ミッション（XRPL 向けの公共財としてのデータインフラ）に合致する場合は、コミュニティ助成プログラムの支援を受けています。

コントリビューション

Issue と PR を歓迎します。主要な数値を表示するページを変更する場合は、対応する CLAIMS.yaml のエントリーを追加または更新してください。scripts/claims_check.sh が確認を促します。

ライセンス

MIT。LICENSE を参照してください。

免責事項

xrpldashboard は、オンチェーンデータと公開されている規制情報を報告します。本サイトおよびこのリポジトリに掲載されている内容は、金融、法律、または投資に関する助言ではありません。