UniSat ウォレットの「バッファ長を超えてアクセスしようとしています」エラーを修正するにはどうすればよいですか? (バグ修正)

UniSat ウォレットのバッファ長エラーのトラブルシューティング

1. このエラーは通常、QR コードのスキャン中またはトランザクション署名中に、ウォレットが BRC-20 トークン転送または碑文ペイロードからの不正な形式またはサイズ超過のバイナリ データを解析しようとしたときに発生します。

2. 根本的な原因は、UniSat の内部バッファ処理が信頼できない入力からのバイト シーケンスを解釈する方法にあります。特に、非標準エンコーディングまたは切り捨てられた碑文データを含む序数を解析する場合です。

3. ユーザーがこの問題に最も頻繁に遭遇するのは、カスタム スクリプトが埋め込まれている実験的な碑文を操作するとき、または Bitcoin のブロック構造によって課せられる 4MB のサイズ制限を超えるときです。

4. これはネットワーク接続や RPC ノードの設定ミスとは関係なく、UTXO シリアル化を担当する UniSat のネイティブ WASM モジュール内の厳密な境界チェックに関係しています。

5. このエラーは、ウォレットの破損やシード フレーズの侵害を示すものではありません。これは、低レベルのデコード ルーチンでの安全でないメモリ アクセスに対するランタイム ガードを反映しています。

コードを変更しない即時回避策

1. UniSat Web ウォレットを使用している場合はブラウザのキャッシュとローカル ストレージをクリアし、別のスキャンまたは署名操作を試行する前にインターフェイスをリロードします。

2. QR コードのインポートから手動トランザクション ブロードキャストに切り替えます。ブロックチェーン エクスプローラー経由で生の 16 進数をコピーし、UniSat の「Broadcast Raw TX」ツールに貼り付けて、バッファー解析ロジックをトリガーせずに確認します。

3. 疑わしい序数や新たに作成された序数、特に未知の minter コントラクトに由来する序数やネストされた JSON 構造を含む序数では、[View Inscription] をクリックしないようにします。

4. UniSat のサンドボックス iframe 環境に競合するスクリプト コンテキストを挿入する可能性がある MetaMask や Rainbow などのブラウザ拡張機能を無効にします。

5. 大規模な碑文を処理する場合は、デスクトップ バージョンの代わりに UniSat Mobile (v3.8.2+) を使用します。そのネイティブ バッファ アロケータは、WebAssembly ベースのデスクトップ ビルドよりもエッジ ケースをより堅牢に処理します。

カスタム統合のための開発者レベルの修正

1. 碑文データを UniSat のdecodeInscription()ユーティリティに渡す前に、厳密なペイロード検証を実施します。3.9MB を超えるペイロード、または最初の 16 桁に null バイトが含まれるペイロードを拒否します。

2.signPsbt()へのすべての呼び出しを try/catch ブロックでラップし、BitGo または Blockstream Green PSBT エンドポイントを介した外部署名へのフォールバックを実装します。

3. Uint8Array.from()を呼び出す前に、 MAX_BUFFER_SIZE = 4194304に対するプリフライト長チェックを追加して、UniSat のbuffer-utils.tsにパッチを適用します。

4. 従来の Node.js 環境でのオーバーフローを防ぐために、 Buffer.from(hexString, 'hex')の直接使用をBuffer.allocUnsafe()に置き換え、その後に明示的な長さのクランプを行います。

5. bip174やbitcoinjs-libバージョンなどのサードパーティ ライブラリを監査します。古いリリースには、BRC-20 転送に必要な境界を認識した PSBT 解析がありません。

コミュニティで検証された回復手順

1. ウォレットの拡張公開キー (xpub) をエクスポートし、それが UniSat の設定に表示されているものと一致することを確認します。これにより、キー導出の破損が発生していないことが確認されます。

2. mempool.space API を使用して UTXO を手動で再構築し、確認された残高を UniSat の表示された残高と照合します。矛盾がある場合は、バッファ障害ではなく同期が不完全であることを示唆します。

3. 12 ワード シードを使用してウォレットを Sparrow Wallet に再インポートし、トランザクション履歴の整合性を検証します。 Sparrow が完全な履歴を表示する場合、問題は UniSat のレンダリング層にのみ存在します。

4. UniSat の GitHub 問題ページで PR #1427 および #1509 を監視します。これらには、base64 からバイナリへの変換パイプラインのオフバイワン エラーを解決する v3.9.0 以降に適用されるホットフィックス パッチが含まれています。

5. 2024 年 3 月より古いバックアップからウォレットを復元しないでください。v3.7.0 より前のスナップショットには、リハイドレーション中に誤ったバッファ オーバーランを引き起こす不正な形式の IndexDB エントリが含まれている可能性があります。

よくある質問

Q: このエラーは、BRC-20 トークンが失われたことを意味しますか? A: いいえ。エラーは表示中または署名中に発生します。オンチェーン決済中は発生しません。トークンは秘密キーによって保護されたままであり、ordinals.com などのエクスプローラーを介して参照できます。

Q: RPC エンドポイントを変更することでエラーを回避できますか? A: いいえ。UniSat ウォレットは独自のインデックス サービスを使用し、碑文の解析に外部 RPC に依存しません。ノードを切り替えても、バッファ検証ロジックには影響しません。

Q: この脆弱性はリモートから悪用可能ですか? A: 既知のリモート コード実行ベクトルは存在しません。このエラーは、ユーザーが開始したアクションが悪意を持って作成されたローカル ファイルまたは QR コードを読み込んだ場合にのみトリガーされます。ネットワーク ベースの挿入パスは存在しません。

Q: Xverse では表示されないのに、UniSat ではこのエラーが表示されるのはなぜですか? A: Xverse は、より緩やかなバッファ制約を実装し、複雑な碑文解析をバックエンド サービスに任せます。 UniSat はすべてのデコードをクライアント側で実行するため、不正な入力に対してより敏感になります。