RPC 제공업체 선택 방법

실제 작업을 완료하는 데 드는 비용과 신뢰성을 기준으로 RPC 제공업체를 선택하세요. 먼저 지원 체인, 메서드 및 과거 데이터 지원 범위를 확인한 다음, 쿼리 수, 처리량 및 복구 능력을 측정합니다.

애플리케이션이나 AI Agent에 필요한 체인, 메서드, 고정 블록 높이, 일일 트래픽 분포, 피크 동시성, 알림 또는 데이터셋 종속성을 정리하세요. 아래의 BlockVectra 공개 데이터는 GET /v1/plans 및 GET /v1/chains에서 제공되며, 결정을 내리기 전에 다시 조회하세요. 데이터 지원 범위는 GET /v1/status에서 확인할 수 있습니다. 공개된 사양 선언은 테스트의 출발점일 뿐, 지연 시간 측정치나 SLA가 아닙니다.

메서드 단가와 청구 단위

단순한 요청 수만으로는 워크로드의 비용을 산정할 수 없습니다. 각 메서드의 청구 가중치, USD 환산율, 포함된 크레딧, 초과 요금, 구독료나 부가 서비스 요금을 기록하세요. 제공업체를 비교하기 전에 크레딧, CU, 요청 단위를 각각의 환산 기준에 맞춰 변환해야 합니다.

BlockVectra의 현재 메서드 가중치와 정가(list price)는 페이지 빌드 시 공개 플랜 엔드포인트에서 읽어옵니다:

workload_cu = sum(calls_for_method × current_method_cu_weight)
cu_per_usd = pricing.units_per_usd × pricing.cu_per_unit
list_cost_usd = workload_cu / cu_per_usd
paid_compute_usd = max(0, workload_cu − available_free_cu) / cu_per_usd

정가에는 무료 크레딧, 가스비, 부가 서비스 및 마이그레이션 작업 비용이 포함되지 않습니다. 주기적으로 충전되는 제공량과 만료되는 평가판을 구분하고, 추가 크레딧 단가와 기본 포함된 요청의 평균 비용을 구분하세요. 어떤 응답이 CU를 소모하는지는 청구 규칙을 확인하세요.

자체 테스트: 고정 블록을 대상으로 대표적인 소규모 메서드 조합을 리플레이하고 성공한 호출, 재시도, 과금 대상 오류를 기록합니다. 계정의 사용량 변화와 메서드 가중치 계산 결과를 대조하세요. 페이지네이션과 백필을 포함하여 완전한 결과를 반환하는 데 필요한 총 요청 수 기준으로 예산을 책정하세요. 환산 방법은 CU 요금제 확인하기를 참조하세요.

로그 범위와 과거 상태

eth_getLogs의 경우 특정 체인 및 플랜에 대한 블록 범위(span), 결과 크기 제한 및 필터 지원 여부를 확인하세요. 넓은 범위도 응답이 완전할 때만 유용합니다. BlockVectra의 인증된 요청 범위는 체인 카탈로그에서 가져옵니다:

과거 로그 조회와 과거 컨트랙트 실행은 서로 다른 기능입니다. eth_call의 경우 state_window_blocks를 확인하고, 키 없는 조회인 경우 public.history_blocks도 확인하세요. 필드가 누락되었거나 null인 것은 사양이 명시되지 않은 것이지 무제한 과거 데이터를 보장한다는 의미가 아닙니다. 과거 EVM 상태 조회를 참조하세요.

자체 테스트: 알려진 컨트랙트와 토픽이 있는 고정 구간을 선택하고, 공표된 범위에 맞춰 분할한 뒤, 결과의 합집합을 더 작은 중첩 쿼리 결과와 비교합니다. 블록 해시, 트랜잭션 해시, 로그 인덱스로 중복을 제거하고 구간 경계를 확인하세요. 이와 별개로 동일한 컨트랙트를 최근 고정 블록과 애플리케이션에 필요한 가장 오래된 블록에서 조회하여 실제 결과 또는 JSON-RPC 오류를 기록합니다. 이벤트가 밀집된 구간과 희소한 구간을 모두 테스트하고 재시도 횟수를 측정하세요. 진행 상황을 체크포인트로 저장하려면 로그 범위 및 복구를 따르세요.

무료 크레딧, 속도 제한 및 피크 트래픽

BlockVectra의 현재 주기 예산과 이를 통해 처리할 수 있는 호출 수는 플랜을 기준으로 계산됩니다:

무료 계정 호출 상한: 초당 최대 25회 호출, 계정 내 모든 키, 모든 체인 및 Data API에서 공유됩니다. 각 키에는 cu_per_sec 및 burst_cu 한도도 적용됩니다. 대상 주기의 리필은 무료 잔액을 목표 한도까지 보충하는 것이며, 전체 금액이 추가로 중복 지급되는 것은 아닙니다. 첫 유료 충전 시 주기 리필은 중단되지만 남은 무료 CU는 그대로 유지됩니다. 무료 플랜 규칙을 참조하세요.

일일 쿼터, 주기 잔액, 초당 요청 수(requests/s), 초당 CU(CU/s), 버스트 용량 및 동시 요청 수를 각각 구분하여 관리하세요. 사용량에 대해 비용을 지불한다고 해서 키당 처리량이 자동으로 늘어나는 것은 아닙니다.

자체 테스트: 인증된 키를 사용하여 계정 한도 내에서 작업에 필요한 속도와 동시성으로 소규모 제한 배치를 실행합니다. HTTP 상태, JSON-RPC 오류, 지연 시간 백분위수 및 완료된 호출 수를 기록하세요. 쿼터가 소진되면 중단하고, 속도 제한이 발생하면 유한 백오프를 사용하며 진행 상황을 영구 저장하세요. 비용이 높은 메서드는 초당 CU 예산을 더 많이 소모하므로 여러 메서드가 혼합된 샘플로 다시 테스트합니다. 일시적 버스트와 안정적인 트래픽을 비교하고, 공유 계정 상한을 확인할 때는 다른 키의 사용량도 함께 고려하세요.

체인, 메서드 및 프로토콜 지원 범위

체인 카탈로그를 사용하여 네트워크 식별자, jsonrpc, methods.allow, methods.deny, public.methods, ws 및 subscriptions를 확인하세요. 체인 이름이 지원된다고 해서 모든 메서드나 프로토콜을 사용할 수 있는 것은 아닙니다. 키 없는 공개 메서드와 인증된 메서드는 서로 다른 제한을 가질 수 있습니다.

자체 테스트: 선택한 네트워크의 public.url을 복사하고 public.methods에 있는 메서드를 호출합니다. 아래 Ethereum 예제의 경우 네트워크 ID를 확인한 다음, 인증된 키와 동일한 고정 블록을 사용하여 애플리케이션에 필요한 메서드를 실행합니다. 허용(allow) 규칙뿐만 아니라 거부(deny) 규칙도 확인하고, 엔드포인트 간 결과를 비교할 때는 블록 해시를 대조하세요.

curl --fail-with-body -sS --max-time 15 https://api.blockvectra.com/v1/eth_mainnet/public \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: curl BlockVectraQA/1' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

이 테스트는 공개 메서드를 확인하는 것이며, 아카이브 지원 범위나 인증된 처리 용량을 나타내지는 않습니다. 애플리케이션에 소켓 연결이 필요한 경우 ws 지원이 선언된 네트워크에서 필요한 구독, 연결 해제 및 재개 경로를 테스트하세요. WebSocket 구독을 참조하세요.

Push 전달 및 인덱싱된 데이터

주소 알림의 경우 체인의 push 선언 및 확인(confirmation) 설정을 확인하세요. BlockVectra는 단일 HTTPS 수신 엔드포인트를 사용하는 하나의 구독으로 지원되는 여러 체인에 걸쳐 동일한 주소 세트를 모니터링할 수 있습니다. 모니터링할 주소 수에 맞춰 셀프서비스 및 엔터프라이즈 용량을 확인하세요. Data API 쿼리의 경우 GET /v1/status에서 데이터셋과 인덱싱된 범위를 확인합니다. 인덱싱된 레코드가 임의의 과거 컨트랙트 실행을 보장하지는 않습니다. RPC 폴링, WebSocket 메시지, 전달된 Push 이벤트 및 모니터링된 주소일(address-days)은 서로 다른 과금 단위를 사용하므로, 필요한 각 워크플로를 플랜의 해당 가중치에 따라 계산하세요.

자체 테스트: Push의 경우 직접 제어하는 HTTPS 수신 엔드포인트를 사용하고, 서명을 검증하며, 직접 제어하는 주소의 이벤트를 통해 중복 처리, 재시도 및 리플레이를 테스트합니다. Data API의 경우 인덱싱된 알려진 트랜잭션 또는 전송 내역을 쿼리하여 RPC의 블록 해시와 비교하고, 페이지네이션을 끝까지 조회하며, 재개하기 전에 커서를 저장하세요. 데이터 공백과 과금된 이벤트 또는 호출 수를 기록합니다. 적절한 복구 경로는 Webhook 푸시, Webhook과 WebSocket 비교 및 Data API 레퍼런스를 참조하세요.

인증 및 Agent 접근

클라이언트가 키를 안전하게 전달하고, 기계 판독 가능한 문서를 탐색하며, 계정을 생성하고 오류에서 복구할 수 있는지 확인하세요. BlockVectra RPC는 POST /v1/{chain}/{api_key} 경로의 키 또는 POST /v1/{chain}의 x-api-key 헤더를 지원합니다. Data API는 x-api-key를 사용합니다. 키는 서버 환경에만 보관하고 브라우저 번들, 로그 및 채팅 메시지에 노출되지 않도록 하세요.

개발자와 AI Agent는 동일한 가격 정책과 제한을 적용받습니다. 프로그래밍 방식 회원가입에서는 지갑 기반 계정 생성을 설명하며, Agent 가이드에서는 문서 및 MCP 진입점을 제공합니다. Agent는 월간 RPC 구독 없이 문서화된 충전 절차에 따라 스테이블코인으로 계정 사용 잔액을 충전할 수 있습니다. 충전 지원 네트워크, 토큰 및 최소 충전 금액은 GET /v1/topup/status에서 확인할 수 있습니다.

자체 테스트: 대상 클라이언트가 체인과 메서드를 탐색하고, 문서를 읽으며, 환경 변수에서 키를 로드하여 제한된 인증 요청을 하나 실행하도록 합니다. HTTP 상태와 JSON-RPC error를 모두 확인하세요. 자격 증명을 로깅하지 않고 키 누락 시의 응답을 확인합니다. 잔액 부족 시 클라이언트가 진행 상황을 저장하고, 활성화된 충전 네트워크 및 토큰을 읽으며, 문서화된 충전 절차를 따르는지 검증하세요. 계정 생성 및 결제 단계는 직접 제어하는 계정을 사용해야 합니다. 문서 MCP에 연결되었다고 해서 Agent가 인증된 RPC 호출을 실행할 수 있다는 증거로 간주해서는 안 됩니다.

결정 사항 기록

간단한 결과 시트를 작성하여 보관하세요: 데이터 출처 및 샘플링 일자, 체인 및 메서드, 고정 블록 해시, 결과의 완전성, 총 호출 수 및 재시도 횟수, 사용 가능한 쿼터, 유료 작업 비용, 지연 시간 및 스로틀링(throttling), 히스토리 및 프로토콜 차이, 복구 단계, 마이그레이션 소요 비용. 워크로드에 계약상 지원이나 SLA가 필요한 경우 이러한 API 테스트와는 별도로 해당 약관을 확인하세요.

워크로드가 정의되면 특정 제공업체와 비교해 보세요:

• 특정 제공업체와 비교: 연산 요율 및 로그 범위.
• 특정 제공업체와 비교: 평가판 및 구독 청구.
• 특정 제공업체와 비교: HTTPS 요청 비용.
• 특정 제공업체와 비교: 일일 및 주기 예산.
• 특정 제공업체와 비교: 기본 포함 요청 및 초과 요금.