MetaMask 및 Rabby 커스텀 RPC 설정: URL 및 Chain ID

MetaMask 또는 Rabby에 RPC URL, Chain ID 및 네이티브 심볼을 추가하고, 인증이 필요한 경우 전용 지갑 키를 사용하세요.

1. 커스텀 RPC를 사용하는 이유

블록체인 생태계는 일반적으로 기본 커뮤니티 사용 및 개발자 온보딩을 위한 기본 퍼블릭 RPC 엔드포인트를 제공합니다. 하지만 공식 네트워크 문서에는 이러한 엔드포인트에 대한 명시적인 속도 제한(rate limits)과 사용 범위가 명시되어 있습니다:

• Robinhood Chain: 공식 문서 페이지 Connecting to Robinhood Chain에서는 퍼블릭 엔드포인트 https://rpc.mainnet.chain.robinhood.com에 속도 제한이 있으며 프로덕션 워크로드에는 권장되지 않는다고 명시하고 있습니다(The following public endpoints are available but are rate-limited and not recommended for production use. For production, use a provider).
• HyperEVM: 공식 문서 페이지 Rate limits and user limits에서는 퍼블릭 엔드포인트 rpc.hyperliquid.xyz/evm에 대해 IP 기반으로 분당 최대 100회의 EVM JSON-RPC 요청 제한을 지정하고 있습니다(Maximum of 100 EVM JSON-RPC requests per minute for rpc.hyperliquid.xyz/evm).

2. 필수 지갑 필드 및 네트워크 파라미터

EVM 지갑에서 네트워크를 추가하거나 편집할 때 다음과 같은 몇 가지 특정 필드가 필요합니다:

1. Network Name: 지갑 인터페이스에 표시되는 사람이 읽을 수 있는 레이블입니다.
2. RPC URL: 통신 엔드포인트입니다. api.blockvectra.com에서 /v1/{chain}/{api_key} 경로를 사용하여 API key를 URL 경로에 포함해야 합니다:

   텍스트 복사

   /v1/{chain}/{api_key}

   중요: MetaMask 및 Rabby 같은 지갑은 RPC URL 필드에 표준 HTTP(S) URL만 허용하며 커스텀 요청 헤더를 지원하지 않습니다(x-api-key: {api_key} 등). 따라서 지갑 연결 시에는 API key를 URL 경로에 직접 제공해야 합니다. {api_key} 뒤에 후행 슬래시를 포함하지 마세요. 알 수 없는 {chain}을 대상으로 하는 요청은 HTTP 404를 반환합니다.

3. Chain ID: EIP-155 정수 체인 식별자입니다.
4. Currency Symbol: 체인의 네이티브 가스 자산 심볼입니다(예: ETH, HYPE).
5. Block Explorer URL: 네트워크 블록 탐색기(explorer)의 기본 웹 주소입니다.

지원 체인 네트워크 파라미터 표

HyperEVM 읽기 전용 제한: BlockVectra HyperEVM 엔드포인트는 읽기를 지원하지만 트랜잭션을 브로드캐스트하지 않습니다. 지갑에서 트랜잭션을 전송할 때는 eth_sendRawTransaction을 지원하는 RPC를 사용하세요. 브로드캐스트에 대한 자세한 내용은 HyperEVM 가이드의 Foundry 또는 Hardhat으로 배포를 참조하세요.

경로의 {chain}을 원하는 체인 슬러그로 대체하면 하나의 API key를 모든 지원 체인에서 사용할 수 있습니다. 공유 할당량 및 URL 라우팅에 대한 자세한 내용은 하나의 키로 여러 체인 사용 가이드를 참조하세요.

3. 지갑별 단계별 설정 가이드

MetaMask 설정 단계

공식 MetaMask 도움말 가이드 How to add a custom network RPC를 기반으로 합니다:

1. MetaMask 브라우저 확장 프로그램 또는 모바일 애플리케이션을 엽니다.
2. 인터페이스 상단의 네트워크 선택기 드롭다운을 클릭합니다(또는 설정 > 네트워크로 이동).
3. 네트워크 추가(Add network)를 선택한 다음 하단의 네트워크 수동 추가(Add a network manually)를 선택합니다.
4. 위의 표를 참조하여 네트워크 세부 정보를 입력합니다:
   • Network Name: 위 표의 체인 이름을 입력합니다.
   • New RPC URL: https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}와 같이 경로 인증 엔드포인트를 입력합니다({api_key}를 실제 API key로 교체).
   • Chain ID: 위 표의 정수 Chain ID를 입력합니다.
   • Currency Symbol: 위 표의 네이티브 자산 심볼을 입력합니다.
   • Block Explorer URL: 위 표의 공식 블록 탐색기 주소를 입력합니다(선택 사항).
5. 저장(Save)을 클릭하여 네트워크를 추가하고 해당 네트워크로 전환합니다.

HyperEVM에서 트랜잭션 전송: BlockVectra HyperEVM 엔드포인트는 읽기를 지원하지만 트랜잭션을 브로드캐스트하지 않습니다. 지갑에서 트랜잭션을 전송할 때는 eth_sendRawTransaction을 지원하는 RPC를 사용하세요(HyperEVM 브로드캐스트 설명 참조).

기존 네트워크 편집: 이미 목록에 있는 네트워크의 RPC 엔드포인트를 업데이트하려면 설정 > 네트워크로 이동하여 대상 네트워크를 선택하고, RPC URL 필드에서 BlockVectra URL을 편집하거나 추가한 후 변경 사항을 저장하세요.

Rabby Wallet 설정 단계

Rabby의 커스텀 네트워크 또는 커스텀 RPC 설정에서 위 표의 파라미터를 입력합니다: Network Name, RPC URL(경로 키 포함: https://api.blockvectra.com/v1/{chain}/{api_key}), Chain ID, Currency Symbol 및 Block Explorer URL.

참고: 커스텀 네트워크 또는 테스트넷을 추가할 때는 네트워크 ID 불일치 오류를 방지하기 위해 Chain ID가 엔드포인트에서 반환하는 ID와 일치하는지 확인하세요.

4. 보안 팁 및 사용량 관리

커스텀 RPC를 운영할 때는 다음 보안 및 청구 원칙을 염두에 두세요:

[!WARNING] API Key 노출 위험: RPC URL 경로에는 API key가 평문으로 포함됩니다. 지갑의 네트워크 설정 스크린샷을 공개 대화방이나 포럼에 공유하지 마시고, 실제 키가 포함된 URL을 공개 코드 저장소나 문서에 커밋하지 마세요.

1. 지갑 요청은 계정 사용량에 포함됩니다: 지갑을 열거나 계정을 전환하거나 자산 목록을 새로 고치면 실시간 JSON-RPC 호출(eth_blockNumber, eth_getBalance, eth_call 등)이 트리거됩니다. 이러한 요청은 호출된 메서드의 CU 가중치(요금 페이지 참조)에 따라 계정 한도 내에서 용량을 소모합니다.
2. 각 지갑에 전용 API key 생성: 콘솔에서 지갑 전용 라벨(예: metamask-desktop 또는 rabby-extension)을 지정하여 전용 API key를 생성하세요. 이렇게 하면 개인 지갑 트래픽을 서버 애플리케이션, 자동화 스크립트 및 AI 에이전트와 격리할 수 있습니다.
3. 유출 시 독립적인 해지: 지갑에 구성된 API key가 노출되었다고 의심되는 경우, 실행 중인 다른 키나 서비스에 영향을 주지 않고 콘솔에서 해당 개별 키를 즉시 해지하세요. 세션이 만료되었거나 키를 분실한 경우 프로그래밍 방식 회원가입 가이드의 세션이나 API 키를 분실하셨나요?를 참조하여 이더리움 지갑 서명을 통해 제어권을 다시 확보하세요.

5. 관련 리소스

• 과거 상태 한도: 이전 잔액이나 컨트랙트 값을 요청하기 전에 인증된 상태 윈도우와 키 없는 기록을 확인하세요. 로그 쿼리 범위는 별도의 한도입니다.
• 하나의 키로 여러 체인 사용 가이드: 상세 URL 라우팅 규칙, GET /v1/chains를 통한 프로그래밍 방식 검색 및 크로스체인 할당량 메커니즘.
• 요금 및 플랜 한도: CU 가중치, 처리량 보충 속도 및 결제 예치금 업그레이드에 대한 정보.

다음 단계

• 데이터셋 디렉터리 둘러보기: BlockVectra가 인덱싱하는 모든 데이터셋 확인.
• 무료 플랜 및 요금 확인: 내 계정에 포함된 혜택 확인.
• 콘솔 로그인: API key 생성.