トラブルシューティング

見えている症状から始め、担当する構成要素や境界を特定してください。 状態とエラーコードを確認してから、対応する復旧操作を選びます。 送信状態が不明な間は、操作を再試行しないでください。

ウォレット画面が読み込まれない

境界： アプリとウォレットiframeの間。 ウォレットオリジン、サービスルート、CSPのframe-src、埋め込み元のポリシー、アセットのContent-Type、ブラウザーコンソールのオリジンエラーを確認してください。 デプロイやオリジンの許可一覧を修正し、ウォレットUIを再読み込みしてください。

古いクライアントが更新要求を受け取る

境界： SDK、ホストするウォレットアセット、バックエンドのリリース識別情報。 バックエンドは、非対応のウォレット管理プロトコルをHTTP 409と更新案内で拒否します。 案内を表示し、対応するアプリとウォレットアセットを再読み込みしてください。 同じ非互換リクエストの自動再試行を停止します。デプロイ要件に従ってください。 アプリとウォレットホストは、iframeプロトコル23.0.0でも一致する必要があります。

登録後に署名できるがConsoleに表示されない

境界： Gatewayの完了通知。 登録は、ディレクトリーの確認前にローカルで確定できます。 保留中の通知行、定期ハンドラーの実行、ディレクトリーへのアクセス、マイグレーション0081を確認してください。 定期ハンドラーで記録済み通知を再試行します。別のウォレットを作成しないでください。 確認されるまで、リージョン移動は利用できません。

クリック後にサインインのダウンロードが始まる

境界： 遅延読み込みするウォレットランタイム。 保存済みウォレットがない場合、接続だけではサインイン用ランタイムを読み込みません。 ポインター操作、フォーカス、タッチにauthMenu.prepare()を紐づけるか、HostedSeamsAuthMenuを早めにマウントしてください。 ウォレットの予約や認証情報の要求をせず、コードをダウンロードします。

初期テナント承認の期限が切れた

境界： 鍵管理の作成ジャーナル。 未使用の承認を更新できるのは、Routerがフェンスを永続化した後だけです。 開始済みの手順は、元の承認をそのまま使って復旧する必要があります。 再試行前に、Wallet Runtimeの制御リレーと、連携するバックエンドのバージョンを確認してください。 開始済み操作に、新しい許可を代入しないでください。

リージョン内のウォレットへルーティングできない

境界： ウォレットのホームディレクトリーとリージョン別バインディング。 記録済みホームと、処理を提供するWorker/D1のバインディング証跡を確認してください。 ディレクトリー停止時は、アクセスを復旧し、同じ操作を安全に再試行します。 ホームの不一致による拒否は、ルーティングを修正してください。 障害を回避するために、代替リージョンへ書き込んだり、既存ウォレットへ新しいホームを割り当てたりしないでください。

パスキーの入力要求を利用できない

境界： ブラウザー機能、RP ID、ウォレットオリジン。 公開の機能選択結果、安全なコンテキストの状態、iframe権限、RPの範囲を確認してください。 対応する認証方法を提示するか、オリジン設定を修正します。認証情報の入力要求を繰り返さないでください。

登録は成功したが署名機能の準備ができていない

境界： プロビジョニングのライフサイクル。 成功したRegistrationResultの分岐と、現在のプロビジョニング状態を確認してください。 保留中は待機し、再試行可能な失敗だけを再試行します。対象の機能が準備完了してから続行してください。

署名がセッションや対象の不一致を報告する

境界： ウォレットセッションの識別情報。 セッション参照、アカウントまたはチェーン対象、ウォレットID、ネットワーク、現在のSDKクライアントが、同じライフサイクルを示すことを確認してください。 再認証し、検証済みの状態から正確な参照を再構築します。

トランザクションの状態が不明

境界： 送信とチェーンの確定。 操作のハッシュやリクエストIDで設定済みネットワークを照会し、ノンスレーンの状態を照合してください。 前のトランザクションが受理されていないと証明してから、再試行してください。

アプリとウォレットの表示が異なる

境界： 描画するオリジン。 アプリ側の部品にReactのThemeトークンが渡り、ウォレット側の画面に、現在のモードに対応するSDK表示トークンが渡ることを確認してください。 両方を修正した後、コントラストを確認します。

テナントルートの更新が制限中または実行中

境界： テナントルート操作の受付。 R120の1時間制限を含むリリースでは、HTTP 429のtenant_root_refresh_throttledがretryAtMsとRetry-Afterを返します。 新たな手動更新は、サーバーが計算した時刻まで待ってください。 HTTP 409のtenant_root_refresh_in_progressは、別の操作が進行中であることを示します。 中断した要求を再試行する際は、元のoperationIdを保持してください。新しいIDでは再開できません。

実際の環境のリリースとポリシーを確認してください。実装済みの契約だけでは、デプロイ設定を確認できません。

テナントルートのバックアップを開けない

境界： ロール内のバックアップ提供者。 対象ロールのKMS鍵参照、有効な鍵バージョン、サービスアカウントのアクセス、保存済みR2オブジェクトを、正規の有効化証跡と照合してください。 認証情報や復号した素材をログに含めないでください。 記録済み鍵バージョンへのアクセスを復旧します。別の鍵では、失ったバージョンで作成した暗号文を復号できません。

データベースを完全に失った場合は、正規の識別・有効化レコードも必要です。 テナントルートの復元要件に従ってください。

更新は有効になったが廃止処理が未完了

境界： テナントルートのライフサイクルのクリーンアップ。 正規のリビジョンとロールの記録を確認してください。 元の操作のクリーンアップを再開します。廃止済みエポックの再有効化や、ローテーションの反復は行わないでください。 署名が動作しても、廃止処理の完了は証明できません。 有効なバックアップの削除だけでは、過去の暗号文すべてが復元不能であることも証明できません。

サポート向けに集める情報

リリース、環境、ブラウザー、操作ID、公開エラーコード、イベントのフェーズ・状態、機密情報を伏せたコンソール・通信証跡を集めてください。 認証情報、トークン、アサーション、OTP、復元データ、鍵素材は除いてください。

外部NEARウォレット

境界： アプリのドキュメントと、選択した外部ウォレット。 コネクターは開発プレビューです。npmのバージョン0.42.0に含まれます。 提供状況と統合方法を確認してください。

• Meteorはページの初期読み込み後にAPIを追加する場合があります。正しいブラウザープロファイルで、初期化後に再試行してください。ツールバーのアイコンだけではAPIの準備完了を確認できません。
• このコネクターでのHOT接続はメインネット専用です。テストネットでは選択肢を無効にします。
• Intearにはアプリのオリジンでのポップアップ許可が必要です。固定のウォレットオリジンと、そのリクエストのウィンドウからの応答だけを受け入れます。
• 切断後は、新しい接続済みスナップショットを取得してから署名してください。古いスナップショットはconnection_changedを返します。
• 返されたハッシュを保持し、実行状態が不明ならcheckOutcomeで確認してください。submission_unknownでは、次の送信前にウォレットの履歴を確認します。

外部接続でSeamsへのログインは作成されません。 外部取引用の操作は、外部ウォレットの接続状態に基づいて有効にしてください。