docs

日本語

English

日本語

English

表示テーマ

サーバーSDKとCLI

対応するWallet Serverのエントリーポイント、同梱ランタイムのコマンド、復元CLIの管理範囲。

サーバーSDKとCLI ​

@seams/wallet-server@0.42.0は、再利用可能なWalletサービス、ストレージアダプター、Cloudflare Workers、マイグレーション、署名用WASMバインディングを提供します。 現在の復元CLIランチャーは、@seams/wallet-cli@0.29.0です。 デプロイ用アセットを選ぶ前に、リリース状況を確認してください。

sh
pnpm add @seams/wallet-server@0.42.0
npm install --global @seams/wallet-cli@0.29.0

サーバーのエントリーポイント ​

インポートパス範囲
@seams/wallet-server共通のサーバーサービスと契約
@seams/wallet-server/router/cloudflareCloudflare Routerアダプター
@seams/wallet-server/router/rorRouter-of-Routersアダプター
@seams/wallet-server/storage/tenant-routeテナントルートの経路ストレージ
@seams/wallet-server/wasm/signer署名用WASMバインディング
@seams/wallet-server/cloud-hostホストする登録・権限サービス
@seams/wallet-server/hosted-wallet-gatewayGatewayの構成
@seams/wallet-server/hosted-wallet-gateway-workerホストするGateway Worker
@seams/wallet-server/local-hosted-wallet-gateway-workerローカルGateway Worker
@seams/wallet-server/tenant-rootテナントルートのライフサイクルと復元の契約
@seams/wallet-server/local-runtimeローカルランタイムの設定スクリプト
@seams/wallet-server/local-runtime/*同梱のローカルランタイムスクリプト
@seams/wallet-server/artifact-manifest.json同梱ランタイムの識別情報
@seams/wallet-server/migrations/d1-signer/*署名用マイグレーションファイル
@seams/wallet-server/package.jsonパッケージのメタデータ

各エントリーポイントは、異なる境界を公開します。記載したパッケージパスからインポートしてください。 内部ソースファイルは、対応する公開APIに含まれません。 Walletバックエンドは、Workers、Durable Objects、D1、Rust/WASMを使います。 旧Node Gateway、Expressアダプター、ネイティブVMのロールホストは削除済みです。

ローカルコマンド ​

インストールしたサーバーパッケージは、次のコマンドを提供します。

  • seams-wallet-server-local：ローカルのWalletシステム全体を起動。
  • seams-wallet-server-local-roles：分離したプロトコルロールを起動。
  • seams-wallet-server-local-init --root <directory>：ローカルの識別情報を初期化。
  • seams-wallet-server-d1-migrate：同梱のローカル署名用マイグレーションを適用。

公開ソースのチェックアウトでは、別々のターミナルでpnpm routerとpnpm siteを使います。 非公開Consoleのチェックアウトでは、そのリポジトリーのコマンドと、バージョンを固定したnpm依存関係を使います。 公開Walletの実装ソースを、Consoleリポジトリーへコピーしないでください。

ホスト環境での登録 ​

独自の登録権限サービスでは、@seams/wallet-server/cloud-hostのresumeRegistrationDirectoryPublicationsV1を定期実行する必要があります。 ローカルで確定済みでも、ディレクトリーから未確認の完了通知を再試行します。 同梱のローカルGatewayは、この処理を定期実行します。 マイグレーションと実行時期の要件は、ホスト環境への導入を参照してください。

非公開のロール間プロトコルが変わった場合は、対応するバックエンドロールをデプロイしてください。 アプリとiframe間の互換性だけでは、鍵管理Worker間の互換性は保証されません。

復元CLI ​

npmランチャーは、実行前に署名済みネイティブマニフェストとバイナリーを検証します。 macOS Apple Silicon、macOS Intel、Linux x86-64に対応します。ランチャーにはNode.js 22以降が必要です。

ダッシュボードの承認、保持者の鍵、バックアップ検証、中断した復元、アクティベーションは、復元CLIガイドを参照してください。 CLIは、未設定の移動先を許可したり、ウォレットのリージョン移動の所有者承認を代行したりしません。 テナントルートの復元とウォレットの移行は、対象範囲が異なります。 復元機能の提供状況を参照してください。