UniSat Wallet "버퍼 길이를 초과하여 액세스를 시도하는 중" 오류를 수정하는 방법은 무엇입니까? (버그 수정)

UniSat Wallet의 버퍼 길이 오류 문제 해결

1. 이 오류는 일반적으로 지갑이 BRC-20 토큰 전송 또는 비문 페이로드에서 잘못되었거나 크기가 큰 바이너리 데이터를 구문 분석하려고 시도할 때 QR 코드 스캔 또는 거래 서명 중에 나타납니다.

2. 근본적인 원인은 UniSat의 내부 버퍼 처리가 신뢰할 수 없는 입력의 바이트 시퀀스를 해석하는 방식에 있습니다. 특히 비표준 인코딩 또는 잘린 비문 데이터가 있는 서수를 구문 분석할 때 그렇습니다.

3. 사용자는 사용자 정의 스크립트를 포함하거나 Bitcoin의 블록 구조에 의해 부과된 4MB 크기 제한을 초과하는 실험적 비문과 상호 작용할 때 가장 자주 발생합니다.

4. 이는 네트워크 연결 또는 RPC 노드 구성 오류와 관련이 있는 것이 아니라 UTXO 직렬화를 담당하는 UniSat의 기본 WASM 모듈 내에서 검사하는 엄격한 경계와 관련이 있습니다.

5. 오류는 지갑 손상이나 시드 구문 손상을 나타내지 않습니다. 이는 낮은 수준의 디코딩 루틴에서 안전하지 않은 메모리 액세스에 대한 런타임 보호를 반영합니다.

코드 수정 없이 즉각적인 해결 방법

1. UniSat Web Wallet을 사용하는 경우 브라우저 캐시와 로컬 저장소를 지운 다음 다른 스캔 또는 서명 작업을 시도하기 전에 인터페이스를 다시 로드하십시오.

2. QR 코드 가져오기에서 수동 거래 브로드캐스트로 전환: 블록체인 탐색기를 통해 원시 16진수를 복사하고 UniSat의 "Broadcast Raw TX" 도구에 붙여넣은 다음 버퍼 구문 분석 논리를 트리거하지 않고 확인합니다.

3. 의심스럽거나 새로 생성된 서수, 특히 알 수 없는 발행 계약에서 유래했거나 중첩된 JSON 구조를 포함하는 서수에 대해서는 "비문 보기"를 클릭하지 마십시오.

4. UniSat의 샌드박스 iframe 환경에 충돌하는 스크립트 컨텍스트를 주입할 수 있는 MetaMask 또는 Rainbow와 같은 브라우저 확장을 비활성화합니다.

5. 대규모 비문을 처리할 때 데스크톱 버전 대신 UniSat Mobile(v3.8.2+)을 사용하세요. 기본 버퍼 할당자는 WebAssembly 기반 데스크톱 빌드보다 엣지 케이스를 더 강력하게 처리합니다.

사용자 정의 통합을 위한 개발자 수준 수정 사항

1. 비문 데이터를 UniSat의 decodeInscription() 유틸리티에 전달하기 전에 엄격한 페이로드 검증을 시행합니다. 3.9MB를 초과하거나 처음 16자리에 null 바이트가 포함된 페이로드를 거부합니다.

2. try/catch 블록을 사용하여 signPsbt() 에 대한 모든 호출을 래핑하고 BitGo 또는 Blockstream Green PSBT 엔드포인트를 통해 외부 서명에 대한 폴백을 구현합니다.

3. Uint8Array.from() 호출하기 전에 MAX_BUFFER_SIZE = 4194304 에 대한 비행 전 길이 검사를 추가하여 UniSat의 buffer-utils.ts를 패치합니다.

4. Buffer.from(hexString, 'hex') 의 직접 사용을 Buffer.allocUnsafe() 로 바꾸고 명시적인 길이 클램핑을 사용하여 레거시 Node.js 환경에서 오버플로를 방지합니다.

5. bip174 및 bitcoinjs-lib 버전과 같은 타사 라이브러리를 감사합니다. 이전 릴리스에는 BRC-20 전송에 필요한 경계 인식 PSBT 구문 분석이 부족합니다.

커뮤니티 검증 복구 단계

1. 지갑의 확장 공개 키(xpub)를 내보내고 UniSat 설정에 표시된 것과 일치하는지 확인합니다. 이를 통해 키 파생 손상이 발생하지 않았음을 확인합니다.

2. mempool.space API를 사용하여 UTXO를 수동으로 재구성하고 UniSat에 표시된 잔액과 확인된 잔액을 교차 확인합니다. 불일치는 버퍼 오류가 아니라 불완전한 동기화를 나타냅니다.

3. 거래 내역 무결성을 검증하기 위해 12단어 시드를 사용하여 지갑을 Sparrow Wallet으로 다시 가져옵니다. Sparrow가 전체 기록을 표시하는 경우 문제는 UniSat의 렌더링 레이어에만 있는 것입니다.

4. PR #1427 및 #1509에 대한 UniSat의 GitHub 문제 페이지를 모니터링합니다. 여기에는 base64에서 바이너리로 변환 파이프라인의 개별 오류를 해결하는 v3.9.0+에 적용되는 핫픽스 패치가 포함되어 있습니다.

5. 2024년 3월보다 오래된 백업에서 지갑을 복원하지 마세요. v3.7.0 이전 스냅샷에는 리하이드레이션 중에 잘못된 버퍼 오버런을 유발하는 잘못된 indexDB 항목이 포함될 수 있습니다.

자주 묻는 질문

Q: 이 오류는 내 BRC-20 토큰이 손실되었음을 의미합니까? A: 아니요. 오류는 온체인 결제가 아닌 표시 또는 서명 중에 발생합니다. 귀하의 토큰은 개인 키로 보호되며 ordinals.com과 같은 탐색기를 통해 볼 수 있습니다.

Q: RPC 끝점을 변경하여 오류를 우회할 수 있습니까? A: 아니요. UniSat Wallet은 자체 색인 서비스를 사용하며 비문 구문 분석을 위해 외부 RPC에 의존하지 않습니다. 노드 전환은 버퍼 유효성 검사 논리에 아무런 영향을 미치지 않습니다.

Q: 이 취약점을 원격으로 악용할 수 있습니까? A: 알려진 원격 코드 실행 벡터가 없습니다. 이 오류는 사용자가 시작한 작업이 악의적으로 제작된 로컬 파일이나 QR 코드를 로드하는 경우에만 발생하며 네트워크 기반 주입 경로는 존재하지 않습니다.

Q: UniSat에는 이 오류가 표시되지만 Xverse에는 표시되지 않는 이유는 무엇입니까? A: Xverse는 보다 느슨한 버퍼 제약 조건을 구현하고 복잡한 비문 구문 분석을 백엔드 서비스로 연기합니다. UniSat는 모든 디코딩을 클라이언트 측에서 수행하므로 잘못된 입력에 더욱 민감해집니다.