ADAMANT Payment v1.0 — 暗号通貨を主軸とした支払い、サブスクリプション、ライセンス管理プラットフォーム
ADAMANT Payment (adamant-payment) は、ADAMANTエコシステムおよび複数の第三者サービスを統合せずに暗号通貨ネイティブな収益化を必要とするあらゆる製品向けの新しいインフラです。これは、従来の adamant-client-auth 手法を、認証、課金、暗号通貨決済、サブスクリプション、ライセンス管理、ユーザーポータル、管理コンソールを備えた、自己ホスト可能な単一のソリューションであるモダンで製品に依存しないプラットフォームに置き換えます。
初回の統合対象は、ADAMANT Tradebot WebUIのサブスクリプション（シナリオB）です。ユーザーはadamant-payment上でサブスクリプションまたはトライアルを購入し、スコープ付きライセンストークンを取得します。その後、ボットが外部からパブリックWebUIリレーに接続します。このプラットフォームはTradebotに限定されておらず、ボット、SaaS、デスクトップアプリ、Web3サービス向けのスタンドアロン製品として設計されています。
アーキテクチャと主な強み
このプラットフォームは、後付けではなく、初めから暗号通貨決済を前提に構築されています。Web3プロジェクト、トレーディングボット、SaaS製品、グローバルなユーザー層に販売されるソフトウェアに最適です。初期の支払い対応はBitcoin（BTCPay Server経由）およびADM（ネイティブ、一意の入金アドレスとオンチェーンウォッチャーを使用）に加え、テスト用の開発者プロバイダーも含まれます。Webhookはべき等であり、一意の externalId／txid 値により支払いの正確性が保証されます。支払い決済時にライセンスが発行または延長されます。
認証、課金、暗号通貨決済、サブスクリプション、ライセンス管理、ユーザー向けポータル、管理パネルがすべて1つのソリューションに統合されており、複数の外部サービスを組み合わせる必要がありません。支払い後、プラットフォームは自動的にライセンスを発行し、有効期限、サブスクリプション、プラン、製品アクセスを管理できます。外部アプリケーションは /v1/... 配下のREST APIを通じてライセンスを検証でき、製品側でライセンスの状態、サブスクリプションの有効性、ユーザーのアクセス権をプログラムで確認できます。
ユーザーは、従来のメールアカウントでサインインするか、ADMまたはETHウォレットによる暗号署名認証（SIWE）を使用できます。これは特にWeb3ユーザーにとって有用であり、メールベースのIDを必須とせずにプラットフォームを利用可能です。JWTセッションとリフレッシュクッキーにより、ブラウザベースのアプリケーションをサポートします。
このソリューションには、ユーザー向けインターフェースと管理ダッシュボードが付属しています。顧客は支払い、ライセンス、サブスクリプションを管理し、製品所有者はユーザー、注文、プラン、アクセス権を管理します。管理パネルはADM 2FAおよびETH 2FA、Turnstileキャプチャ、IPおよびフィンガープリントによるロックアウト、監査ログをサポートします。本番環境では、管理パネルは別のオリジンで実行されます。
adamant-payment はADAMANT Messengerや特定のアプリケーションに紐付けられていません。BRAND_* 環境変数によりホワイトラベルのブランド化が可能で、データモデルは汎用的な製品スラグを使用します。Stripe、Paddle、Lemon Squeezy、または従来のライセンスSaaSとは異なり、独自のルール、暗号通貨決済フロー、価格モデル、製品に合わせてカスタマイズできます。PostgreSQLおよびNode.js上で自社インフラにデプロイ可能で、ユーザー、支払いロジック、ライセンス、ビジネスデータを完全に制御できます。Docker ComposeによるPostgresの設定が提供されており、必須のクラウドSaaS依存関係はありません。
v1.0の範囲
v1.0リリースでは、ユーザー登録、支払い、アクセス提供、サブスクリプション更新、管理、製品統合を含むコアな収益化フローをカバーしています。認証はADMメッセージコード、Ethereum（SIWE）、メール＋パスワードをサポートします。課金機能にはカタログ、14日間のトライアル（取引所とペアの組み合わせごとにグローバルに1回のみ）、有料ライセンス、プロモーションライセンス、手動ライセンスが含まれ、config/ 内のプランおよびプロモーションコードはホットリロード可能です。管理パネルには、統計情報、アカウント管理、ライセンス、請求書、ADM／BTCウォレットビューが含まれ、APIキー認証およびオプションの2FAをサポートします。国際化はリリース時点で英語とロシア語に対応しており、packages/shared で拡張可能なi18nを備えます。
技術スタックにはpnpmとTurborepo、Fastify 5、Prisma、PostgreSQL、React 18（Vite）を使用しています。CIはGitHub Actions上で実行され、インストール、Prisma生成、ビルド、lint、型チェックをカバーしています。
製品および統合要件
製品中立性はコア要件です。DBの列挙型にはTradebotやADAMANTのブランド名はハードコードされておらず、すべてデプロイ単位で設定可能です。ライセンスのスコープは取引所とペアごとに1ライセンスで、トライアルはスコープごとにグローバルに1回のみです。複数の認証方法（ADM、ETH、メール）が共存するマルチアイデンティティ認証を実現しています。運用セキュリティとして、本番環境では管理パネルを別のオリジンで実行し、APIキー、オプションの2FA、キャプチャ、ロックアウト、監査ログを必須とします。
エコシステム統合では、Tradebot WebUI（シナリオB）のリレーがadamant-payment APIを通じてライセンスを検証し、ボットはアウトバウンド接続モデルを使用します。refactor/new-webui-api ブランチのTradebot APIがライセンス検証を消費し、refactor/new-stack ブランチのTradebot WebUIがパブリックWebUIおよびリレーを提供します。課金コアを再構築せずに、新しい PaymentProvider 実装（例：追加のチェーン）を追加できます。
リリース基準
v1.0.0リリースはGitHubリリースとして公開およびタグ付けされます。dev ブランチおよび main へのリリースPRにおいてCIがグリーンである必要があります。ドキュメントは認証、課金、支払い、管理セキュリティ、ブランド化、データベース、BTCPay設定をカバーします。スモークテストは認証フロー、トライアル取得、チェックアウトからライセンス発行、管理パネル、ライセンス検証エンドポイントをカバーします。
v1以降のロードマップ
今後の計画には、サブスクリプション更新の自動化（BTCPayは請求書の作成のみ。更新ロジックはadamant-payment内に実装）、追加の支払いプロバイダーおよびチェーンのサポート、パブリックAPI向けのOpenAPIドキュメント、Tradebot以外の第三者製品との統合が含まれます。
リリース追跡: Adamant-im/adamant-payment#1