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 tx → verifier API → FdcHub → DA Layer proof → オンチェーン検証。

マイルストーン	ステータス
メインネットへのデプロイ	✅ 稼働中（PaymentVerifierMainnet：0xA10034...e14b）
エンドツーエンドのパイプライン検証	✅ 完了 — メインネットで XRP tx の証明を確認済み
ユーザー認証（登録／ログイン）	✅ 完了
レシートページ	✅ 完了 — /receipt/:txHash で共有可能
ダッシュボード	✅ 完了 — API キー、使用状況の統計、レシート履歴
REST API	✅ 完了 — 検証、ステータス、Webhook、ヘルスチェック
API キー認証＋レート制限	✅ 完了
サブスクリプションプラン	✅ 完了 — free／paid／pro
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 tx を証明
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	FDC 証明のために txHash を送信
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
チェーン ID	114	14
FdcHub	0x48aC463d7975828989331F4De43341627b9c5f1D	0xc25c749DC27Efb1864Cb3DADa8845B7687eB2d44
FdcVerification	0x906507E0B64bcD494Db73bd0459d1C667e14B933	0x9394c7A36b3Da8de1b4F27cdD0a554dA4Fa7132d
DA レイヤー	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
ソース 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 Ledger で XRP トランザクションが発生します
2. 検証 API がトランザクションの詳細を取得し、MIC を計算して、ABI エンコードされたリクエストを返します
3. リクエストは FLR 手数料とともに Flare 上の FdcHub に送信されます
4. FDC プロバイダーがそれぞれ独立して XRP トランザクションを検証し、コンセンサスに到達します（90 秒のラウンド）
5. Relay コントラクトを介して、Merkle ルートがオンチェーンに保存されます
6. DA レイヤーがアテステーションレスポンスと Merkle プルーフを提供します
7. スマートコントラクトが FdcVerification を介して、オンチェーンの Merkle ルートに対するプルーフを検証します

貢献

CONTRIBUTING.md をご覧ください。バグ修正、機能リクエスト、ドキュメントの改善、テストの追加など、あらゆる貢献を歓迎します。

XRPLink はソースコードを公開しており（BUSL-1.1）、Flare エコシステム向けに構築されています。 非商用利用、評価、個人利用は無料です。XRPLink を商用サービスとして運用するには、ライセンサーからライセンスを取得する必要があります。

ライセンス

BUSL-1.1 — 詳細は LICENSE をご覧ください。4 年後に MIT ライセンスに切り替わります。