Robinhood Chain 테스트넷 파셋
API key로 테스트 ETH 받기: 계정 요구사항, 수령 한도, 접수 트랜잭션 및 오류 처리.
Robinhood Chain 테스트넷(robinhood_testnet, 체인 ID 46630)에서 트랜잭션을 실행하는 데 필요한 테스트 ETH를 파셋에서 받으세요. 수령은 무료이며 CU를 소모하지 않습니다. 이후의 테스트넷 RPC 호출에는 정상적인 CU 요금이 부과됩니다.
수령 전 준비 사항
BlockVectra 계정을 등록하고 보유한 API key 중 하나를 사용하세요. 콘솔에서 키를 생성하거나 프로그래밍 방식 회원가입 가이드를 참고하세요.
0x 뒤에 40자리 16진수 문자가 오는 주소를 사용하며, 소문자 또는 유효한 EIP-55 체크섬이 적용된 대소문자 혼합 주소를 지원합니다. 응답의 주소는 소문자로 반환되며, 동일한 주소의 다른 표기 방식도 동일한 수령 한도를 공유합니다.
수령 요청 보내기
Content-Type: application/json 헤더와 x-api-key에 API key를 포함하여 POST https://api.blockvectra.com/v1/faucet/robinhood_testnet을 호출하세요. 이 엔드포인트는 URL 경로 또는 Authorization 헤더에서 키를 읽지 않습니다.
{api_key}를 실제 키로, 예시 주소를 수신자 주소로 바꾸세요:
curl -i "https://api.blockvectra.com/v1/faucet/robinhood_testnet" \
-H "Content-Type: application/json" \
-H "x-api-key: {api_key}" \
-d '{"address":"0x1111111111111111111111111111111111111111"}'JSON 요청 본문에는 address만 포함되어야 하며 64KiB 이내여야 합니다. 알 수 없는 필드나 잘못된 JSON은 400 invalid_request를 반환합니다. 쿼리 파라미터 없이 정확한 엔드포인트를 사용하세요.
수령 기간 및 한도
- 접수된 각 요청당 0.001 테스트 ETH(
1000000000000000wei)가 전송됩니다. - 각 계정과 각 수신자 주소는 24시간 롤링 윈도우당 1회의 신규 요청만 가능합니다. 동일한 계정의 다른 키를 사용해도 한도가 늘어나지 않습니다.
- 파셋은 모든 사용자를 합쳐 UTC 일일 최대 1,000건의 신규 요청을 접수합니다.
- 요청은
/v1/account와 함께 키당 초당 5회 요청 한도를 공유합니다.
next_eligible_at은 접수 시각에 24시간을 더한 값이며, RFC 3339 UTC 타임스탬프로 표시됩니다. 계정 및 주소 윈도우는 UTC 자정에 리셋되지 않습니다. 수령 한도 초과 시의 429 응답에는 error.data.scope(account, address, 또는 global)와 error.data.next_eligible_at이 포함됩니다. global의 경우 타임스탬프는 다음 UTC 날짜의 시작 시각입니다. 요청 빈도 초과 시의 429에는 scope가 포함되지 않습니다.
접수가 온체인 확정을 의미하지는 않습니다
HTTP 202는 요청이 접수되었음을 의미하며, 온체인에 성공적으로 포함되었음을 의미하지는 않습니다. JSON 응답에는 다음이 포함됩니다:
| 필드 | 의미 |
|---|---|
chain / chain_id | robinhood_testnet / 46630 |
address | 소문자 수신자 주소 |
amount_wei | 10진수 정수 문자열 형태의 수령 금액 |
tx_hash | 접수된 트랜잭션의 고유 해시 |
next_eligible_at | 롤링 윈도우 기준 다음 수령 가능 시각 |
동일한 계정에서 24시간 이내에 동일한 정규화 주소로 재시도하면 원래의 202 응답과 동일한 tx_hash가 반환되며, 해당 계정의 다른 유효한 키를 사용하는 경우에도 마찬가지입니다. 추가 전송은 발생하지 않습니다. 응답이 유실된 경우 동일한 계정으로 동일한 주소에 대해 재시도하세요.
기존 테스트넷 RPC 엔드포인트를 사용하여 트랜잭션을 확인하세요. {tx_hash}를 접수 응답에서 받은 해시로 바꾸세요. 이 RPC 조회에는 일반 CU 요금이 적용됩니다:
curl -s "https://api.blockvectra.com/v1/robinhood_testnet" \
-H "Content-Type: application/json" \
-H "x-api-key: {api_key}" \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_getTransactionReceipt","params":["{tx_hash}"]}'오류 및 재시도
오류 엔벨로프에는 error.code, error.message, error.data가 포함됩니다. error.data.reason은 error.code와 동일하며, docs_url, retryable, request_id는 오류 레퍼런스, 재시도 정책 및 요청 식별자를 제공합니다. 모든 429 또는 503 오류에 대해 재시도하기 전에 Retry-After 응답 헤더에 지정된 초만큼 대기하세요. 접수 응답을 받지 못한 경우 테스트 ETH가 전송되었다고 간주하지 마세요.
| HTTP | 오류 코드 | 조치 방법 |
|---|---|---|
| 400 | invalid_address | 주소 형식 또는 EIP-55 체크섬을 수정하세요. error.data.field는 /address입니다. |
| 400 | invalid_request | address만 포함된 유효한 JSON을 전송하세요. |
| 401 | missing_api_key / invalid_api_key | x-api-key에 유효한 키를 제공하세요. |
| 403 | key_expired | 새 API key를 생성하세요. |
| 404 | not_found | 경로, 체인, POST 메서드 및 쿼리 파라미터가 없는지 확인하세요. 파셋을 일시적으로 사용할 수 없을 수도 있습니다. |
| 413 | request_too_large | 요청 본문 크기를 64KiB 이내로 줄이세요. |
| 429 | rate_limited | Retry-After 동안 대기하세요. 응답에 포함된 경우 scope와 next_eligible_at을 확인하세요. |
| 503 | faucet_empty | 파셋에 수령 금액 및 수수료를 지급할 잔액이 부족합니다. Retry-After 동안 대기하세요. |
| 503 | service_unavailable | 수령 처리를 일시적으로 사용할 수 없거나 이전 수령 건의 영수증이 아직 생성되지 않았습니다. Retry-After 동안 대기하세요. |
| 503 | auth_unavailable / upstream_unavailable | Retry-After 동안 대기한 후 재시도하세요. |
기계 판독 가능한 안내는 오류 레퍼런스 또는 /errors.json을 참조하고, RPC 연결은 Robinhood Chain 가이드를 확인하세요.
키 없이 읽기 및 WebSocket 로그는 Robinhood Chain 테스트넷 RPC 시작 가이드를 참조하세요. 퍼블릭 RPC URL과 지원 메서드는 테스트넷 체인 페이지에서 확인할 수 있습니다.
최종 수정일: