OKX 지갑에 맞춤형 네트워크를 추가하는 방법

네트워크 구성 요구 사항

1. 수동 네트워크 설정 시 유효한 체인 ID를 제공해야 합니다. OKX Wallet은 네트워크 등록을 허용하기 전에 이 값을 엄격하게 검증합니다.

2. RPC URL은 HTTPS를 활성화하고 공개적으로 액세스할 수 있어야 합니다. 유효하지 않거나 연결할 수 없는 엔드포인트는 연결 실패 및 지갑 거부를 초래합니다.

3. 블록 탐색기 URL은 기능적인 체인별 탐색기 인터페이스를 가리켜야 합니다. 탐색기가 누락되거나 잘못 구성되면 거래 확인 및 자산 추적이 불가능해집니다.

4. 통화 기호 필드에는 최대 6자의 대문자 영숫자 문자열만 허용됩니다. 길이를 초과하거나 특수 문자를 포함하는 기호는 입력 거부를 유발합니다.

5. 네트워크 이름은 유니코드를 지원하지만 제어 문자나 null 바이트를 포함해서는 안 됩니다. 눈에 보이지 않는 유니코드 수정자가 포함된 이름은 장치 유형 전반에 걸쳐 일관되지 않은 표시를 유발할 수 있습니다.

단계별 수동 추가 프로세스

1. OKX Wallet 확장 프로그램을 실행하고 설정 → 네트워크 → 네트워크 추가로 이동합니다.

2. "사용자 정의 네트워크"를 선택하고 필수 매개변수인 네트워크 이름, 새 RPC URL, 체인 ID, 통화 기호 및 블록 탐색기 URL을 입력합니다.

3. "저장"을 탭하여 검증을 시작합니다. Wallet은 RPC 엔드포인트에 대한 실시간 연결 확인을 수행합니다.

4. 유효성 검사가 통과되면 네트워크가 활성 목록에 나타나고 상단 탐색 모음에서 선택할 수 있게 됩니다.

5. 검증이 실패하면 오류 메시지는 일반 폴백 없이 시간 초과, 잘못된 체인 ID 또는 CORS 블록과 같은 정확한 실패 지점을 지정합니다.

체인 ID 검증 로직

1. 체인 ID는 10진법 정수로 구문 분석됩니다. 16진수 또는 부동 소수점 입력은 즉시 거부됩니다.

2. 1~2147483647 범위를 벗어나는 값은 오버플로 오류를 발생시킵니다. 음수나 0은 허용되지 않습니다.

3. 구성된 네트워크 전체에 중복된 체인 ID가 있으면 충돌 경고가 발생합니다. 월렛에서는 중복된 식별자를 저장하는 것을 금지합니다.

4. Ethereum(1), BSC(56) 및 XLayer(196)와 같은 사전 정의된 체인은 엄격한 불변성을 시행합니다. 사용자 정의 항목은 이러한 기본값을 재정의할 수 없습니다.

5. 테스트넷 체인 ID는 고유한 범위를 따릅니다. XLayer Testnet은 195를 사용하고 XLayer Testnet v2는 1952를 사용합니다. 버전이 일치하지 않으면 자동 트랜잭션 오류가 발생합니다.

RPC 끝점 동작 규칙

1. 지갑은 저장 시 경량의 eth_chainId 요청을 보냅니다. 초기 검증 중에는 잔액이나 계정 쿼리가 발생하지 않습니다.

2. 시간 초과의 기본값은 8초입니다. 이 창 내에서 응답하지 못하는 네트워크는 "접근할 수 없음"으로 표시됩니다.

3. CORS 헤더에는 * 또는 명시적인 OKX Wallet 원본 도메인이 포함되어야 합니다. 부재는 브라우저 수준에서 교차 출처 요청을 차단합니다.

4. 응답은 "id", "jsonrpc" 및 "result" 필드와 함께 JSON-RPC 2.0 호환 형식을 반환해야 합니다. 잘못된 페이로드는 즉시 거부됩니다.

5. HTTP 429를 반환하는 속도 제한 엔드포인트는 120초 동안 캐시됩니다. 해당 창 내의 후속 시도는 네트워크 호출을 완전히 우회합니다.

자주 묻는 질문

Q1. 체인 ID 0으로 네트워크를 추가할 수 있나요? 체인 ID 0은 명시적으로 금지됩니다. 지갑은 매개변수 구문 분석 중에 오류 코드 NW-ERR-003과 함께 이를 거부합니다.

Q2. OKX 지갑은 EIP-3085 wallet_addEthereumChain 요청을 지원합니까? 아니요. OKX 지갑은 EIP-3085를 구현하지 않습니다. 내부 네트워크 구성 UI에만 의존하며 dapp에서 시작한 네트워크 추가 프롬프트를 허용하지 않습니다.

Q3. 내 사용자 정의 RPC에 "연결됨"이 표시되지만 로드 밸런싱에 실패하는 이유는 무엇입니까? 이는 eth_chainId 응답이 성공했지만 후속 eth_getBalance 호출이 null 또는 잘못된 데이터를 반환했음을 나타냅니다. 노드가 전체 상태 응답을 제공하고 올바른 API 버전을 지원하는지 확인하세요.

Q4. 동일한 시드 문구를 사용하여 사용자 정의 네트워크가 여러 장치에서 동기화됩니까? 아니요. 네트워크 구성은 설치마다 로컬로 저장되며 시드 문구 복구의 일부가 아닙니다. 각 장치에는 독립적인 수동 설정이 필요합니다.