リリース 0.42.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.42.0 です。

• 読み取り用のReactウォレットの prepareOwnerTransaction で review を渡せます。詳しくはアプリ認証のガイドを参照してください。ウォレットへ進む を押すまで、操作の状態は reviewing です。状態の switch では reviewing も処理してください。
• review.origin を渡すと、最初の確認画面がページ内の矩形から始まります。ウォレット承認には適用されません。視差効果を減らす設定では、その場に表示されます。詳しくは独自のモーダルから始めるを参照してください。
• review.onVisible({ stage, rect }) は、画面が表示された時点で review または wallet を報告します。Back to review を押すと、もう一度 review を報告します。コールバックのエラーがトランザクションを変えることはありません。
• 鍵のエクスポート用ドロワーが再び表示されます。SDK 0.39.0から0.41.1では表示されないため、標準のドロワーでエクスポートを完了できませんでした。
• 読み込み中のウォレットがページのフォーカスを解除しなくなりました。表示された確認画面は、見出しにキーボードフォーカスを移します。
• 高さの低い画面でトランザクションの詳細を開いても、フォーカスのあるコントロールが画面内に残ります。この不具合は0.30.0からありました。
• Firefoxで、単独表示のモーダルとドロワーが閉じるボタンにフォーカスリングを付けて開くことがなくなりました。
• 最初の設定スナップショットが、すでに読み取ったウォレットを示す場合、ページ読み込み時のセッション読み取りが1回減ります。
• prepareOwnerTransaction の review には0.42.0のウォレットホストが必要です。古いホストは review_invalid_input を返します。パッケージのコードとホストのアセットは同じバージョンにしてください。

0.42.0-rc.1 はnpmの next タグで公開したテスト版です。0.42.0を使ってください。

Walletのiframeプロトコルは 23.0.0、ウォレット管理プロトコルは 5 のままです。 署名付きリカバリーCLIは 0.29.0 のままです。このリリースにデータベースのマイグレーションはありません。

リリース 0.41.1

ブラウザーSDK、サーバーSDK、VoiceIDは 0.41.1 です。

• ft_transfer または ft_transfer_call のアクションが1つだけで、添付額がちょうど 1 yoctoNEAR のNEARリクエストでは、トークン金額を見出しに表示します。確認画面には最終的な受取人とトークンコントラクトを表示し、詳細ではこの添付額を必須のセキュリティデポジットとして示します。
• シンボルと小数桁数は、ウォレット自身のリストまたはトークンコントラクトの ft_metadata から読み取ります。アプリケーションの値は使いません。メタデータを2秒以内に取得できない場合は、正確な基本単位の値を表示します。
• 公式の図柄を使うのは、ウォレットのリストにあるトークンだけです。リストにないコントラクトがリスト上のシンボルを名乗ると、警告を表示します。
• ほかのアクションやNEARの添付がある場合は、NEARの金額を見出しのままにし、トークン転送は行として併せて表示します。
• ネイティブ値のないERC-20の transfer 呼び出しでは、トークン金額を見出しに表示し、最終的な受取人とトークンコントラクトも表示します。トークン名を示すのは、そのチェーンのウォレットのリストにあるトークンだけです。ほかのトークンは正確な基本単位の値を表示します。コントラクト自身のシンボルは証明にならないためです。
• EthereumとBaseのネイティブ値は、weiではなくETHで表示します。
• 確認画面にBTC、ETH、stNEAR、NEAR、USDC、USDT、SOL、ZECの図柄と、WBTCなどリストにあるラップ版の図柄を追加しました。
• 長い金額は折り返すため、すべての桁が見えます。
• トランザクションの詳細では、0.00001 NEAR未満の添付額を 0 NEAR とせず正確に表示します。スクロールバーはウォレットのテーマに従います。

Wallet iframeプロトコルは 23.0.0、ウォレット管理プロトコルは 5 のままです。 署名付きリカバリーCLIは 0.29.0 のままです。このリリースにデータベース移行はありません。

リリース 0.41.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.41.0 です。

• 取引が上限を待っている間、所有者NEARの unresolved には retirementWait が含まれます。lastAcceptedBlockHeight、finalBlockHeight、submission を保持します。エラー文ではなくこのフィールドを読んでください。他の unresolved にはありません。
• ハッシュのみのレシートは、安全のための待機であることを示します。この上限は最初の観測から数えるもので、NEARの制限ではありません。
• 所有者操作はRPC URLではなくNEARネットワークに紐づきます。同じネットワークの別のRPCでも、同じレシートと保留ガードを参照します。
• 別のチェーンを報告するRPCでは、操作を終了できません。
• SDK 0.40.0以前の記録は、書き込んだURLで開いたときにネットワークへの紐づけに移行します。RPC URLを変更する前に開くか完了してください。

Walletのiframeプロトコルは 23.0.0、ウォレット管理プロトコルは 5 のままです。 署名付きリカバリーCLIは 0.29.0 のままです。このリリースにデータベース移行はありません。

リリース 0.40.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.40.0 です。

• 所有者NEARのレシートは、最初の送信前に署名鍵、nonce、参照ブロック、送信段階を保存します。
• 確定ブロックが期限切れの取引が未実行であることを証明した場合、復元は proof.execution: 'not_executed' を持つ retired を返します。
• NEARが今後の実行を拒否しても過去の未実行を証明できない場合、復元は retirement_available を返します。retire() にはWalletオリジンでの新しい所有者パスキー承認が必要です。
• SDK 0.39.0以前のハッシュだけのレシートは、SDK 0.40.0で最初に復元した後、有効期間が過ぎるまで未解決のままです。
• 退役処理は再送信せず、対応する保留操作だけを解除します。

Wallet iframeプロトコルは 23.0.0 になります。ウォレット管理プロトコルは 5 のままです。 古いブラウザーSDKは0.40.0のホスト型Walletに接続できません。ブラウザーSDK、ホストアセット、サーバーSDK、VoiceIDを同時に更新してください。 署名付き復元CLIは 0.29.0 のままです。このリリースにはデータベースの移行はありません。

リリース 0.39.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.39.0 です。

• ウォレットの読み込み中もページのクリック、入力、フォーカスを維持します。内容の準備ができてからモーダルを開きます。
• NEAR所有者操作の復元では、モーダルと承認待ち行列を使いません。承認操作ではモーダルを使います。
• 復元の通信期限は35秒です。進捗通知では延長せず、遅れた応答も別の承認を妨げません。
• 状態照会には tx と wait_until: 'NONE' を使います。不明または未確定の結果は保留状態を維持し、再送信しません。
• 状態照会の前に保存済みのハッシュを公開します。以前の操作で保留になったハンドルは、復元の進捗とエラーでも元の操作IDを保持します。

Wallet iframeプロトコルは 22.0.0、ウォレット管理プロトコルは 5 のままです。 署名付き復元CLIは 0.29.0 のままです。SDK、ホストアセット、サーバー、VoiceIDを同時に更新してください。 このリリースにはデータベースの移行はありません。トランザクションが見つからないことだけでは未送信を証明できず、過去の記録を安全に破棄できません。

リリース 0.37.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.37.0 です。

• ホスト側の課金拒否は、新しいセッション認証情報を返す前に billing_credit_exhausted を返します。
• 署名操作の取得と同じトランザクションで与信を確保します。同じ操作の再試行は追加の枠を消費しません。
• 実行前の失敗が確認できた場合は確保した枠を解放します。実行結果が不明な場合は保持します。
• ホスト型課金ポリシーの下でも復元と鍵のエクスポートは利用できます。
• Walletコアが、検証済みの登録結果からVoiceID登録レコードを構築します。

ホスト型署名の与信を有効にする前に、サーバー移行 0088_signing_credit_commitments.sql を適用してください。 この移行はランタイムの使用量管理を追加します。与信ポリシー、ログインに基づくMAU、月次請求はConsole側で提供します。 パッケージの公開だけでは課金は有効になりません。後払いを有効にする前にConsoleの移行とランタイムの展開を調整してください。

Wallet iframeプロトコルは 22.0.0、ウォレット管理プロトコルは 5 のままです。 署名付き復元CLIは 0.29.0 のままです。SDK、ホストアセット、サーバー、VoiceIDを同時に更新してください。

リリース 0.36.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.36.0 です。

• NEAR所有者操作の failed を not_submitted と recovery_unavailable に分離します。
• unresolved はトランザクションハッシュと復元IDを保持します。SDKが返すIDを保存してください。
• 送信前にハッシュを公開します。ブラウザーの記録がないことだけでは未送信を証明できません。
• 送信と状態照会は30秒で待機を終了します。タイムアウト後も不確実な結果を保持し、再送信しません。
• 確定したリバートを直ちに返します。記録の書き込み失敗は、確認済みの結果を変更しません。
• サンプルは再読み込み後もハッシュを保持し、未解決の操作の置き換えを防ぎます。
• アプリ認証と所有者証明の再試行は、元の認可と接続を保持します。
• VoiceIDの登録、有効化、承認はWalletホストの明示的な状態を使います。

Wallet iframeプロトコルは 22.0.0 になります。アプリのSDKとWalletホストアセットを同時に更新してください。 古いiframeプロトコルでは接続できません。アプリのSDK更新が必要です。 サーバーSDKとVoiceIDも同じパッケージバージョンに更新してください。 署名付き復元CLIは 0.29.0、ウォレット管理プロトコルは 5 のままです。 このリリースにはデータベースの移行はありません。 所有者操作の復元を参照してください。

リリース 0.35.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.35.0 です。

• 小さいNEAR金額は、短く正確に表示できる場合にyoctoNEARを使います。
• 0.000001 NEAR 未満の金額をクリックすると、正確な金額と < 0.000001 NEAR を切り替えます。
• 金額と単位は1行に表示します。EnterキーとSpaceキーでも切り替えられます。

ブラウザーSDK、Walletホストアセット、サーバーSDK、VoiceIDプラグインを同時に更新してください。 署名付き復元CLIは 0.29.0、Wallet iframeプロトコルは 21.0.0、ウォレット管理プロトコルは 5 です。 このリリースにはデータベースの移行とプロトコルの変更はありません。

リリース 0.34.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.34.0 です。

• SDKの実行時と開発用の依存関係は、未確認の更新への露出を減らすため、正確なバージョンに固定します。
• ReactとReact DOMは任意のピア依存関係として >=19.0.0 を指定します。React 20以降も含みます。
• SDKの開発にはReactとReact DOMの 19.2.9 を使います。
• 各アプリの依存関係とロックファイルで、インストールするReactのバージョンを選びます。
• この範囲は将来のReactのインストールを許可します。未検証のバージョンの動作を保証するものではありません。

ブラウザーSDK、Walletホストアセット、サーバーSDK、VoiceIDプラグインを同時に更新してください。 署名付き復元CLIは 0.29.0、Wallet iframeプロトコルは 21.0.0、ウォレット管理プロトコルは 5 のままです。 データベースの移行とプロトコルの変更は追加しません。

リリース 0.33.0

ブラウザーSDK、サーバーSDK、VoiceIDは 0.33.0 です。

• 外部ウォレットの接続状態をフッターに表示し、一時的なスクロールバーを非表示にします。
• ウォレットのアイコンは元の色で表示します。
• recoveryOptions に collapsible（既定）、expanded、hidden を指定できます。
• footerBrand でフッターをアプリのロゴと代替テキストに置き換えられます。
• Meteorがサイトに公開されていない場合は、拡張機能を有効にする案内を表示します。

Wallet iframeプロトコルは 21.0.0 になります。 ブラウザーSDK、Walletホストアセット、サーバーSDK、VoiceIDプラグインを同時に更新してください。 React連携には react@19.1.1 と react-dom@19.1.1 が必要です。 署名付き復元CLIは 0.29.0、ウォレット管理プロトコルは 5 です。データベースの移行は追加しません。

リリース 0.32.0

バージョン 0.32.0 は、0.31.0で固定した依存関係とReactのバージョンを引き継ぎます。 ブラウザーSDK、サーバーSDK、VoiceIDは 0.32.0 です。

React連携には react@19.1.1 と react-dom@19.1.1 が必要です。 ブラウザーSDK、Walletホストアセット、サーバーSDK、VoiceIDプラグインを同時に更新してください。 署名付き復元CLIは 0.29.0、Wallet iframeプロトコルは 20.0.0、ウォレット管理プロトコルは 5 です。 データベースの移行とiframeプロトコルの変更は追加しません。

リリース 0.31.0

バージョン 0.31.0 は、npmとCargoの外部依存関係を固定し、Walletランタイムのビルドを統一します。 ブラウザーSDK、サーバーSDK、VoiceIDは 0.31.0 です。

React連携には react@19.1.1 と react-dom@19.1.1 が必要です。 QR連携を利用する場合は jsqr@1.4.0 と qrcode@1.5.4 を使ってください。 ブラウザーSDK、Walletホストアセット、サーバーSDK、VoiceIDプラグインを同時に更新してください。 署名付き復元CLIは 0.29.0、Wallet iframeプロトコルは 20.0.0、ウォレット管理プロトコルは 5 です。 データベースの移行とiframeプロトコルの変更は追加しません。

リリース 0.30.0

バージョン 0.30.0 は、Seams認証と外部ウォレット接続を同じ画面に表示します。 ブラウザーSDK、サーバーSDK、VoiceIDは 0.30.0、Wallet iframeプロトコルは 20.0.0 です。 署名付き復元CLIは 0.29.0、ウォレット管理プロトコルは 5 のままです。

• HostedSeamsAuthMenuのwalletAlternatives.primaryとsecondaryで項目と順序を指定します。
• 設定を省略するか、配列を空にすると、対応するセクションを非表示にします。
• NEARとEVMの既存コントローラーを再利用し、接続コールバックはアプリ側に保持します。
• Recover or link walletで、デバイス連携と復元を開きます。
• アイコンは通常モノクロで、ホバーまたはキーボードフォーカス時に色を表示します。
• 接続中に閉じるかコントローラーを変更すると、その要求を無効にします。
• 署名セッションの既定値はsealed refreshです。保存済みのセッションがない場合もパスキーでロック解除できます。

WalletConnectorMenuは削除しました。項目をHostedSeamsAuthMenu.walletAlternativesへ移してください。 外部接続の成功時はwallet_connectedを通知し、Seamsのセッションは作成しません。 アプリのSDKとWalletホストアセットを同時に更新してください。データベースの移行は追加しません。 設定はReactリファレンスを参照してください。

リリース 0.29.0

バージョン 0.29.0 は、信頼したアプリのセッションを読み取り専用のウォレット接続へ引き継ぎます。 NEARの各操作には、ウォレットのオリジンで新しい所有者のパスキー承認が必要です。

4つの公開パッケージは 0.29.0、Wallet iframeプロトコルは 19.0.0、ウォレット管理プロトコルは 5 です。

• Googleとアプリのパスキー認証に、同じ安定したアプリのユーザーIDを使えます。
• 再利用できる署名セッションを作らずに、関連付けと解除を承認できます。
• registration.registerOwnerWallet は、NEAR専用のパスキーウォレットを登録します。
• near.prepareOwnerTransaction は、トランザクションごとに新しい所有者証明を要求します。
• Reactの読み取り接続と署名セッションを型で区別します。
• 送信結果が不明な場合、保存済みのハッシュを照会し、再送信を防ぎます。

ブラウザーSDK、Walletアセット、サーバーSDK、VoiceIDプラグインを同時に更新してください。 Signerの 0086 と 0087、Consoleの 0112 のマイグレーションを適用してください。 Signerの更新前に、未完了のウォレット移動を完了してください。 初期の操作専用APIは、NEARとウォレットのオリジンに登録した所有者パスキーを対象とします。 アプリのセッションと操作ごとの所有者承認を参照してください。

リリース 0.28.0

バージョン 0.28.0 では、アプリのGoogle IDトークンを使って、関連付けたウォレットの設定を開けます。署名や鍵管理には、引き続きウォレット所有者の認証が必要です。 設定と実装の手順は、Google SSOガイドを参照してください。

コンポーネント	バージョン
ブラウザーSDK @seams/wallet	0.28.0
サーバーSDK @seams/wallet-server	0.28.0
オプションプラグイン @seams/voiceid	0.28.0
ネイティブCLIランチャー @seams/wallet-cli	0.28.0
Wallet iframeプロトコル	18.0.0

• auth.authenticate はGoogle認証情報、またはブラウザーに紐付いたバックエンドの引き継ぎコードを受け取ります。所有者による関連付けの承認が必要です。
• 設定セッションには読み取り権限、オリジンの紐付け、有効期限、失効確認があります。署名枠の発行や秘密情報の復号は行いません。
• ウォレット設定にレスポンシブなドロワーを追加しました。
• VoiceIDでCitrinetとAuroraの文字起こしモデルを選択できます。フレーズの調整ツールも更新しました。

ブラウザーSDK、Walletホストアセット、サーバーSDK、有効なVoiceIDプラグインを同時に更新してください。外部認証を有効にする前にサーバーのマイグレーションを適用してください。

リリース 0.27.0

バージョン 0.27.0 は、カスタマイズ可能なウォレット接続メニュー、テーマ対応、NEARの結果表示、VoiceIDの読み込み復旧を追加します。

コンポーネント	バージョン
ブラウザーSDK @seams/wallet	0.27.0
サーバーSDK @seams/wallet-server	0.27.0
オプションプラグイン @seams/voiceid	0.27.0
ネイティブCLIランチャー @seams/wallet-cli	0.25.0
Wallet iframeプロトコル	17.0.0

• WalletConnectorMenuは、公式アイコン、文言の変更、認証画面への連続した切り替えを提供します。
• 戻る操作でウォレット選択へ戻れます。接続メニューと認証成功表示はSDKのテーマを使います。
• 取引詳細は画面内でスクロールでき、レシートの切り替えで文字がずれません。
• NEARの送信前失敗、送信状態不明、実行結果未確定を区別します。
• VoiceIDの読み込み失敗から再試行でき、マイク入力を試行間で統一します。

ブラウザーSDK、Walletホストアセット、サーバーSDK、有効なVoiceIDプラグインを同時に更新してください。

リリース 0.26.0

バージョン 0.26.0 は、パスキーのコールド復元後にブラウザーの権限情報が古いまま残る問題を修正します。

コンポーネント	バージョン
ブラウザーSDK @seams/wallet	0.26.0
サーバーSDK @seams/wallet-server	0.26.0
オプションプラグイン @seams/voiceid	0.26.0
ネイティブCLIランチャー @seams/wallet-cli	0.25.0
Wallet iframeプロトコル	17.0.0

• 復元で検証したEd25519のアクティベーションを保存し、置き換えられたローカルのシールを削除します。既存の古い権限情報も、通常のパスキーアンロックで修復できます。
• 権限の識別情報、許可、失効、同時ロックの確認は維持します。遅れて届いた応答は、新しいセッションを置き換えません。
• ブラウザーのTLSによるパスキー拒否では、信頼されたHTTPSを使うよう案内します。ユーザーによるキャンセルはエラーとして表示しません。
• デバイス連携にはWalletオリジン内での明示的な承認が必要です。親アプリから承認を渡すことはできません。

アプリのSDKとホストするWalletアセットを同時に更新してください。VoiceIDには同じバージョンのプラグインを使ってください。 ブラウザーSDK 0.25.0 は、復元後に古い権限情報が残り、次のアンロックに失敗することがあるため、使用を避けてください。

リリース 0.25.0

バージョン 0.25.0 は、アプリの広範なCSSからSDKの操作部品を保護し、アプリから開く設定モーダルを追加します。

構成要素	バージョン
ブラウザーSDK @seams/wallet	0.25.0
サーバーSDK @seams/wallet-server	0.25.0
オプションプラグイン @seams/voiceid	0.25.0
ネイティブCLIランチャー @seams/wallet-cli	0.25.0
Wallet iframeプロトコル	17.0.0

• SDKの操作部品とポータル表示は、共通の名前空間と明示的な初期スタイルを使います。
• AccountMenuButtonは、ドロップダウンと、isMenuOpenおよびonMenuOpenChangeで制御するモーダルに対応します。
• presentation="modal"を指定すると、アプリ独自のボタンから設定を開けます。
• VoiceIDの操作チャレンジは、confirmationCommandで操作に応じた発話を選択できます。

CLIには、macOSのApple Silicon・IntelとLinux x86_64向けの署名済みネイティブバイナリーを含みます。 インストールと検証は復元CLIのガイドを参照してください。

設定APIはReactリファレンスを参照してください。 ブラウザーSDKと一致するウォレットホストのアセットをデプロイしてください。

過去のリリース

リリース 0.24.0

バージョン 0.24.0 では、VoiceIDの登録、アンロック、NEARおよびArcテストネットの取引承認を利用できます。

構成要素	バージョン
ブラウザーSDK @seams/wallet	0.24.0
サーバーSDK @seams/wallet-server	0.24.0
オプションプラグイン @seams/voiceid	0.24.0
Wallet iframeプロトコル	17.0.0

VoiceIDのモデルと推論コードは、別パッケージの @seams/voiceid に含まれます。 基本のWalletパッケージには、VoiceIDのモデルや推論エンジンは含まれません。 voiceIdAuthMethod を @seams/voiceid からインポートし、authMethods で明示的に有効にします。 Walletホストの運用者は、seams-voiceid-host ./wallet-with-voiceidでプラグインのアセットを配置します。 アプリとホストの手順はVoiceIDの設定を参照してください。 設定を有効にするだけでは、VoiceIDのダウンロードは始まりません。

初回のVoiceID操作では、エンジンと3つのモデルに共通の進捗バーを表示し、その後に Preparing VoiceID… を表示します。 音声サンプルは、所有者が変更または削除するまで保持されます。話者照合のしきい値は0.5です。 VoiceBeam と VoiceAssistantCard は @seams/voiceid/react から、カードのスタイルは @seams/voiceid/styles から読み込みます。

リリース 0.22.0

このドキュメントは、ブラウザーSDKとサーバーSDKのバージョン0.22.0を対象とします。復元CLIは0.21.0です。

2026-10-25に準備しました。npmへの公開と各ホスト環境へのデプロイは、個別に確認してください。

0.22.0の変更点

• アンロックメニューは、認証の準備中に保存済みウォレットを表示します。
• トランザクション設定には、確認スイッチとモーダルまたはドロワーの表示形式があります。
• NEP-413メッセージ署名は、3本のトラックが埋まった完了レシートを表示します。
• デバイス連携の認証方法セレクターと「続行」ボタンは、ウォレットのテーマに従います。
• NEARリレイヤーは、アクセスキーと最新ブロックを並行して取得します。

構成要素	バージョン	要件
ブラウザーSDK @seams/wallet	0.22.0	アプリのコードとウォレットオリジンのアセットを一致させる
サーバーSDK @seams/wallet-server	0.22.0	連携するバックエンドの各ロールをデプロイする
ネイティブCLIランチャー @seams/wallet-cli	0.21.0	署名済みネイティブアセットとダッシュボードのコマンドを使う
ウォレットiframeプロトコル	16.0.0	アプリとウォレットホストを一致させる

CLIは公開前に交換した新しい復元ルートを固定します。以前のルートで署名した復元パッケージには、 新しいパッケージと証明書が必要です。古いルートとの継続ブリッジはありません。

復元の安全性

ブラウザーSDKは、復元の認証情報をサーバーへ送る前にパスキーPRF出力を取り除きます。 サーバーは、拡張機能の出力値が残る復元の認証情報と登録情報を拒否します。 ECDSA署名の追加認証と鍵エクスポートの証明もPRF出力を送らず、サーバーは除去済みの認証情報だけを受け付けます。 復元の管理には、操作に結び付いた新しい完全所有者の証明が必要です。

ドキュメント

日本語ドキュメントは、デプロイ、復元、実装例、APIリファレンスを含むサイト全体に対応しました。 形式検証のドキュメントでは、証明済みの不変条件、仮定、残る作業を区別します。

ホストするウォレットの操作

• ホスト環境での認証は、成功を確認してから画面を閉じ、アプリへ結果を返します。
• メニューが開く前にキャンセルすると、ウォレットホストはメニューを表示しません。
• アカウントパネル、鍵のエクスポート行、QRカメラ画面は、狭い画面や拡大縮小したホストに収まります。

英語と日本語の表示

このリリースでは、ブラウザーSDKとサーバーSDKを0.22.0に統一します。復元CLIは0.21.0です。 ウォレットiframeプロトコルは16.0.0のままです。

プロバイダーの設定を作成する際に、SDKの言語を指定してください。

import { normalizeWalletLocale } from '@seams/wallet';

const appearance = {
  locale: normalizeWalletLocale(new URL(location.href).searchParams.get('locale')),
};

appearanceをdefineSeamsConfigまたはSeamsWebProviderのconfigへ渡します。 日本語にはappearance: { locale: 'ja' }を使います。英語にはlocaleの指定を省略します。 プロバイダーとウォレットオリジンのUIは、この設定を共有します。 SDKのプレビューでも、AccountMenuButtonMockとSeamsAuthMenuMockのlocaleを指定できます。 アプリ独自の見出しやカスタム文言の翻訳は、アプリ側で用意してください。

Consoleのブラウザー・サーバーパッケージを正確な0.22.0に固定し、対応するウォレットオリジンのアセットをデプロイしてください。 アプリだけを更新しても、古いホスト環境のウォレットは翻訳されません。

導入

はじめにに従ってブラウザーSDKをインストールしてください。 ウォレットホストとバックエンドについては、ホスト環境への導入を参照してください。 アプリのコードとウォレットのアセットを一緒にデプロイしてください。

ReactのuseSeams()は、認証操作と現在紐づいているwalletを提供します。

const { unlock, lock, wallet } = useSeams();

サインアウト中のウォレットはnullです。NEARアカウントの準備が整うまで、NEAR署名機能もnullです。 署名前にwallet?.nearを確認してください。アンロック完了後の認証済みレンダーからウォレットを取得してください。

登録時の既定動作では、サーバーがウォレットIDを割り当てます。 この動作には、registerWalletのwalletを省略してください。ウォレットを明示的に選ぶこともできます。 設定済みチェーンと既定のプロビジョニングを使うには、signerSelectionを省略してください。 独自の署名対象も指定できます。

デプロイ

対応するウォレットホスト、Gateway、Wallet Runtime、Router、コントロールプレーン、両Deriver、Signing Workerをデプロイしてください。 各Workerがトラフィックを処理する前に、同梱のD1マイグレーションを適用してください。

デプロイした各サービスのリリース識別情報を確認してください。パッケージの公開とホスト環境へのデプロイは別の手順です。 本番環境の確認事項に従い、復元ツールに依存する前に復元CLIを確認してください。

準備中のNEARコネクター

各ウォレットはwalletsで明示的に有効化します。デモと実装例はMeteorのみを選択します。 setWalletsによる実行中の変更と、空のリストによる全無効化にも対応します。 設定は外部NEARウォレットの選択を参照してください。

2026-10-26に確認したnpmの最新ブラウザーSDKは0.22.0です。 外部NEARコネクターはdevに実装済みですが、このリリースには含まれていません。 新しいパッケージの公開やデプロイが完了したことを示すものではありません。

コネクターガイドには、Meteor、HOT、Intear、 2つの新しいインポート先、開発版に対してコンパイルした実装例があります。 実際のMeteor拡張機能で、テストネット接続、ゼロデポジット取引の最終実行、コントラクトの正確な読み戻しを検証しました。 実際のHOT拡張機能でも、メインネット接続とポップアップを閉じた後の再試行を検証しました。 HOTの取引署名と、Intearの実ウォレット検証は未実施です。 公開と非公開アプリへの導入には、正確なSDKリリースバージョンが必要です。