ChainScore — アーキテクチャ

Ethereum・Bitcoin・XRP・TRON・Solana アドレスを対象にしたオンチェーン信用スコアリング & リスク評価サービス。 DeFi 活動・取引先信用度・ネットワーク多様性・OFAC 制裁照合など 13 項目以上の指標から、0〜1000 の信用スコアと 5 段階リスク評価を可視化します。

目次

1. システム概要
2. 技術スタック
3. 高レベル構成図
4. コンポーネント
5. リクエスト / ジョブの流れ
6. データモデル
7. スコアリング方式
8. 外部サービス
9. 多言語対応
10. セキュリティとプライバシー
11. 運用
12. デプロイパイプライン
13. 可観測性
14. コスト試算

システム概要

ChainScore は、ブロックチェーンアドレスを入力するだけで、そのオンチェーン履歴に基づく信用評価を即座に得られる公開 Web アプリです。

5 チェーン対応(アドレス形式から自動判定):

アドレス検出順は EVM → BTC → XRP → TRON → SOL。TRON 文字列は BTC レガシーと衝突し、Solana は最も寛容なので最後にチェック。EVM 以外は 大文字小文字を保ったまま保存・検索される。

主要な出力:

• 信用スコア: 0〜1000、チェーンごとに 13〜14 個のメトリックの重み付き集計。
• リスクレベル: 5 段階(veryLow / low / medium / high / critical)。
• コンプライアンスステータス: clean / flagged / sanctioned(OFAC SDN 照合)。
• メトリック内訳: 各指標の値・ウェイト・チェーン別の説明文。
• 残高 + 90 日履歴: ユーザーの言語に対応した現地通貨で表示(CoinGecko リアルタイムレート)。
• 取引履歴一覧: 「もっと見る」でページング表示(初期 20 件、クリックごとに +20 件、最大 500 件まで)。取引相手アドレスをクリックで遷移。
• トークン保有 / 転送履歴: ETH のみ ERC-20 残高 + 転送ログを表示(ページング)。
• 「最新に更新」ボタン: キャッシュをバイパスして再計算(60 秒/アドレスのスロットル付き)。
• コミュニティ中央値: 全検索の集約データから自分のスコアと比較可能。
• ホエール / 大口送金フィード: 公開ページの上部に最新の大口取引(BTC など)をストリーム表示。

技術スタック

アプリケーション

インフラ

高レベル構成図

flowchart TB
  Browser["ユーザーブラウザ
(chain-score.com)
Next.js SSR + React"]

  subgraph Edge["エッジ (us-east-1 cert)"]
    CF["CloudFront + WAF
SSL 終端 / レート制限 / 静的キャッシュ"]
  end

  subgraph Region["ap-northeast-1"]
    ALB["ALB
/api/* → score-api / else → frontend"]

    subgraph ECS["ECS Fargate"]
      FE["frontend (Next.js × 2)"]
      API["score-api (Fastify × 2)"]
    end

    Redis[("ElastiCache Redis
スコア/レート制限/統計/価格キャッシュ")]
    DDB[("DynamoDB
scores / jobs
PITR 有効")]
    SQS[/"SQS
score-jobs + DLQ"/]
    Lambda["Lambda: score-engine
(Node 20)"]
    Secrets[["Secrets Manager
Etherscan API キー"]]
  end

  subgraph External["外部サービス"]
    Etherscan["Etherscan API
(EVM)"]
    Esplora["Blockstream Esplora
(Bitcoin)"]
    Xrpscan["xrpscan API
(XRP)"]
    Tron["TronGrid API
(TRON)"]
    Sol["Solana RPC
(SOL)"]
    Gecko["CoinGecko
(価格)"]
  end

  Browser -->|HTTPS| CF
  CF --> ALB
  ALB --> FE
  ALB --> API
  API --> Redis
  API --> DDB
  API --> SQS
  API -.価格プロキシ.-> Gecko
  SQS -->|trigger| Lambda
  Lambda --> DDB
  Lambda --> Redis
  Lambda --> Secrets
  Lambda --> Etherscan
  Lambda --> Esplora
  Lambda --> Xrpscan
  Lambda --> Tron
  Lambda --> Sol
  Lambda --> Gecko

コンポーネント

frontend/ (Next.js、ECS Fargate)

Next.js 14 App Router。基本的にクライアントコンポーネント中心、SEO メタデータと初期データ取得のみ軽い SSR を行う構成。

主要ファイル:

• app/layout.tsx — ルートメタデータ(OG・Twitter・JSON-LD WebSite/WebApplication・AdSense)、I18n プロバイダ。
• app/page.tsx — トップ。アドレス検索フォーム + 対応チェーン紹介 + コミュニティ統計。
• app/score/[address]/page.tsx — サーバ側でキャッシュスコアを取得、動的 OG 画像、noindex 設定。
• app/{about,privacy,terms,disclaimer}/page.tsx — 法的ページ。多言語、フル SEO メタデータ。
• app/sitemap.ts / app/robots.ts / app/manifest.ts — SEO アセット自動生成。
• app/opengraph-image.tsx — 動的 OG 画像生成(Edge runtime、next/og)。
• components/ScoreView.tsx — メイン結果パネル。ゲージ・レーダー・残高・取引・コンプラ・リスクバッジ・中央値比較。
• components/SupportedChains.tsx — トップに表示する対応チェーン紹介。
• components/StatsCard.tsx — チェーン別コミュニティ中央値。
• components/CookieConsent.tsx — GDPR 風の同意バナー。アナリティクスと AdSense をゲート。
• lib/i18n/{messages,uiExtra,legal}.ts — 7 言語の翻訳辞書。
• lib/chain.ts — アドレス検出正規表現(EVM / BTC bech32+legacy / XRP)。
• lib/risk.ts — スコア + コンプラ → 5 段階リスクレベル判定。
• lib/usePrice.ts — API プロキシ経由でリアルタイムレートを取得する React フック。

score-api/ (Fastify、ECS Fargate)

ステートレスな 2 レプリカ HTTP 層。リクエスト検証・キャッシュ・ジョブディスパッチを担当。

エンドポイント:

横断機能:

• @fastify/rate-limit(IP ごと 60 req/分、複数インスタンス間で整合させるため Redis バック)
• @fastify/cors を allow-list 制(chain-score.com / www.chain-score.com)
• ルートごとの Cache-Control ヘッダ(s-maxage + stale-while-revalidate で CloudFront 連携)
• 統計集約器(stats.ts)— チェーン別に Redis SET (stats:{chain}:addresses) で アドレス単位の重複排除。同じアドレスを再検索してもカウントもサンプルも増えない。スコア / メトリックサンプルは LPUSH+LTRIM で 1000 件上限の List に保持

score-engine/ (Lambda、SQS トリガー)

ステートレスなワーカー。重いオンチェーンデータ取得とスコア計算を担当。

メッセージごとの処理フロー:

1. Secrets Manager から API キーを取得(コンテナメモリでキャッシュ)。
2. CoinGecko から JPY レートを取得(3 通貨)。
3. チェーン別分岐:
   • EVM: Etherscan の tx 一覧 → 取引相手 + DeFi + 検証済みコントラクトの分析。NFT マーケットプレイス + ステーブルコイン + ガス効率のヒューリスティック。ERC-20 残高 + 転送ログも併せて取得。OFAC SDN とのコンプライアンス照合。
   • BTC: Blockstream Esplora の全取引履歴 + UTXO + 残高。SegWit / Taproot / Lightning 検出。手数料率の妥当性。
   • XRP: xrpscan のアカウント情報 + 取引履歴 + TrustLine。DEX(OfferCreate/OfferCancel) + Domain + RegularKey + DestinationTag のヒューリスティック。
   • TRON: TronGrid の /v1/accounts/:addr + 直近 200 件のトランザクション + TRC20(USDT)転送。Bandwidth 効率(free_net_usage vs free_net_limit)+ Smart Contract 比率。
   • Solana: getSignaturesForAddress(直近 200 件)+ 各 tx を getTransaction で展開(レート制限を考慮し最大 40 件のみフルパース)。SPL トークンアクティビティ + プログラム多様性。
4. scoring.ts で重み付きスコアを計算(チェーン別ウェイトは合計 100%)。
5. DynamoDB(scores テーブル)と Redis に保存。
   • 400 KB アイテム上限を踏まえたキャップ: recentTxs ≤ 500 件、tokenTxs ≤ 300 件、history ≤ 90 ポイント。
6. ジョブステータスを done に更新。

失敗時: エラーをジョブテーブルに failed として記録。3 回リトライ後 DLQ に送信。

infra/ (CloudFormation + スクリプト)

2 リージョンに 3 スタック:

スクリプト:

• bootstrap.bat — ネットワークスタックを構築し、VPC ID を .env.local.bat に書き出す。
• build-push.bat — Docker ビルド + ECR push + Lambda コード更新。
• deploy.bat — cert スタック → メインスタックの CloudFormation deploy。
• update.bat — コード変更のみの高速更新(イメージ再ビルド + ECS 強制再デプロイ + CloudFront キャッシュ無効化)。反復開発時はこれを使う。
• destroy.bat — 削除阻害要因の事前処理(ECR 空に / DDB 保護解除 / Secrets 強制削除) → 3 スタック削除。
• run.bat — 完全プロビジョニング(bootstrap → build-push → deploy → build-push)。新規環境で 25〜40 分。

リクエスト / ジョブの流れ

コールドアドレス(キャッシュなし)

sequenceDiagram
  autonumber
  participant B as ブラウザ
  participant CF as CloudFront
  participant ALB as ALB
  participant API as score-api
  participant Q as SQS
  participant L as Lambda
score-engine
  participant S as DDB / Redis

  B->>CF: GET /score/0xabc
  CF->>ALB: forward
  ALB->>API: GET /api/score/:addr
  API->>S: キャッシュ / DDB 検索
  S-->>API: miss
  API->>Q: ジョブ enqueue
  API-->>B: 202 (jobId)

  Q->>L: trigger
  L->>L: オンチェーン取得
(Etherscan / Esplora / etc.)
  L->>L: スコア計算
  L->>S: スコア + キャッシュ書き込み

  loop 完了するまで polling
    B->>API: GET /api/score/:addr/status
    API->>S: 状態確認
    S-->>API: done
    API-->>B: { status: "done" }
  end

  B->>API: GET /api/score/:addr
  API->>S: hit
  S-->>API: スコア JSON
  API-->>B: スコア JSON

ウォームアドレス(キャッシュヒット)

同じフローだが、最初の DDB / Redis 検索でキャッシュ済みレコードが返り、ジョブ enqueue は発生しない。

データモデル

DynamoDB — chainscore-scores

PK: address           (S)   例: "0xabc..." (EVM は小文字化、BTC/XRP/TRON/SOL は原文ママ)
SK: chain#timestamp   (S)   例: "eth#2025-04-25T08:14:00.000Z"

属性:
  chain        S    "eth" | "btc" | "xrp" | "tron" | "sol"
  timestamp    S    ISO 8601
  score        N    0–1000
  metrics      L    [{ key, label, weight, value }]
  balance      M    { native, symbol, jpy, jpyPerNative }
  history      L    [{ t, v }]            ← 90 ポイント上限
  recentTxs    L    [{ hash, ts, direction, counterparty, valueNative, status, flagged }]  ← 500 件上限
  tokens       L    [{ symbol, contract, decimals, balance }]            ← ETH のみ ERC-20 残高
  tokenTxs     L    [{ hash, ts, direction, counterparty, symbol, contract, value, status, flagged }]  ← 300 件上限、ETH のみ
  compliance   M    { status, selfSanctioned, sanctionedCounterpartyHits, notes }
  ttl          N    エポック秒(30 日後に自動削除)

ScanIndexForward: false + Limit: 1 で、各チェーン × アドレスごとの最新スコアを取得。

DynamoDB — chainscore-jobs

PK: jobId   (S)   uuidv4

属性:
  address      S
  chain        S
  status       S    "pending" | "processing" | "done" | "failed"
  error        S    (status="failed" の場合のみ)
  createdAt    S
  updatedAt    S

Redis キー一覧

スコアリング方式

各チェーンが固有のメトリックセットを持ち、ウェイトの合計は 100%。compliance は意図的に重め(16%)で、selfSanctioned 該当アドレスはスコア ≤ 100 に強制キャップ。

Ethereum(14 メトリック)

Bitcoin(13 メトリック)

TRON(12 メトリック)

Solana(14 メトリック)

XRP(14 メトリック)

リスクレベル(5 段階)

外部サービス

OFAC リストは score-engine/scripts/update-sanctions.ts で更新(手動またはスケジュール実行)。sanctions-data.json を出力し、sanctions.ts がランタイムで読み込みます。

多言語対応

7 言語対応 — 日本語(デフォルト)、英語、中国語(簡体字)、韓国語、スペイン語、ポルトガル語(BR)、ロシア語。

lib/i18n/
├── messages.ts        ← UI コア文字列(MessageKey は ja から自動派生)
├── uiExtra.ts         ← フッター / 同意 / ナビ / メトリックラベル / メトリック説明 / 統計
├── metrics.ts         ← key + chain → MessageKey 解決
├── I18nContext.tsx    ← React Provider、useT() フック
├── legal/
│   ├── types.ts
│   ├── ja.ts  en.ts  zh.ts  ko.ts  es.ts  pt.ts  ru.ts
│   └── index.ts
└── methodology/
    └── ja.ts  en.ts  zh.ts  ko.ts  es.ts  pt.ts  ru.ts   ← 各チェーンのスコアリング方式の詳細

• 選択は localStorage["chainscore.locale"] に永続化。
• <html lang> を動的に更新。
• デフォルトは ja で SSR/SEO に効く。
• 数値・通貨・日付は Intl.NumberFormat / toLocaleString で LOCALE_BCP47 をキーに自動整形。
• 各 locale は対応する法定通貨にマッピング(ja → JPY、en → USD、zh → CNY 等)。残高カードはユーザー通貨で CoinGecko リアルタイムレート取得。

セキュリティとプライバシー

運用

新規プロビジョニング

infra/run.bat
  └─ bootstrap.bat        → chainscore-network スタック (ap-northeast-1)
  └─ build-push.bat       → Docker ビルド + ECR push + Lambda コード更新
  └─ deploy.bat           → chainscore-cert (us-east-1) + chainscore (ap-northeast-1)
  └─ build-push.bat       → Lambda コード再公開(最終)

合計: 25〜40 分(ElastiCache + CloudFront が長時間要因)。

反復更新

infra/update.bat
  └─ build-push.bat                                      → イメージ再ビルド + push + Lambda bundle
  └─ aws ecs update-service --force-new-deployment        → ECS に新イメージを引かせる
  └─ aws cloudfront create-invalidation /*                → CDN フラッシュ

合計: 5〜10 分。

環境破棄

infra/destroy.bat -y
  ├─ DDB DeletionProtection 解除
  ├─ Secrets Manager 強制削除
  ├─ ECR リポジトリを空に
  └─ 削除順: chainscore → chainscore-cert → chainscore-network

デプロイパイプライン

1. ローカル: npm test(Vitest)+ 全 3 パッケージで tsc --noEmit。
2. ビルド: frontend/ と score-api/ は Dockerfile。score-engine/ は esbuild --bundle。
3. Push: aws ecr get-login-password | docker login → docker push。
4. 適用:
   • CFN 変更あり → deploy.bat
   • コードのみ → update.bat(高速パス)
5. 検証:
   • aws ecs describe-services でロールアウト状態を確認
   • aws cloudformation describe-stack-events で IaC 変更を追跡
   • CloudWatch Logs /ecs/* と /aws/lambda/* でランタイム問題を確認

可観測性

コスト試算

低トラフィック時(約 100 検索 / 日)の月額概算:

低トラフィック時は NAT ゲートウェイと ALB がコストを支配します。スケール時は分散されますが、小規模時は Cloud Run / Vercel に置換すれば月額下限を約 $10 まで下げられます。

約 10,000 検索 / 日まで成長すると、Etherscan 有料プラン(約 $200/月)+ Lambda 増(約 $5〜10)が加算されます。Fargate コストはオーバープロビジョニングのため大きく変動しません。

ライセンス・帰属

外部データ:

• Etherscan API — Etherscan の利用規約に従う。
• Blockstream Esplora — オープンソース、公正利用。
• xrpscan API — xrpscan ToS に従う。
• CoinGecko API — 無料枠は帰属表示が必要。
• OFAC SDN リスト — 米財務省のパブリックドメインデータ。

本サイトは 投資助言ではありません。スコアは推定値であり、詳細は /disclaimer を参照してください。