Robinhood Chain testnet faucet'i

Kendi API anahtarınızla test ETH talep edin: hesap gereksinimleri, talep sınırları, kabul edilen işlemler ve hata yönetimi.

Robinhood Chain testnet (robinhood_testnet, zincir kimliği 46630) üzerindeki işlemler için test ETH almak üzere faucet'i kullanın. Talep etmek ücretsizdir ve CU tüketmez; sonraki testnet RPC çağrıları normal CU faturalandırmasını kullanır.

İlk adım: Aşağıdaki curl örneğini kullanarak kendi API anahtarınız ve alıcı adresinizle bir talep gönderin.
Tamamlanma kriteri: HTTP 202 ve bir tx_hash kabul edildiğini onaylar; talebi onaylanmış kabul etmeden önce zincir üstü dahil edilmeyi kontrol etmek için aşağıdaki işlem makbuzu sorgusunu kullanın.

Testnet parametreleri ve erişim seçenekleri.

Talep etmeden önce

Bir BlockVectra hesabı açın ve kendi API anahtarlarınızdan birini kullanın. Konsolda bir anahtar oluşturun veya programatik kayıt rehberini takip edin.

Geçerli bir EIP-55 sağlama toplamına sahip küçük harf veya karışık harfli, 0x ve ardından gelen 40 onaltılık karakter kullanın. Yanıtlar küçük harfli adresler kullanır; aynı adresin farklı yazımları aynı talep sınırını paylaşır.

Talep gönderin

Content-Type: application/json ve x-api-key başlığında anahtarınızla POST https://api.blockvectra.com/v1/faucet/robinhood_testnet uç noktasını çağırın. Bu uç nokta URL yolundan veya Authorization başlığından anahtar okumaz.

{api_key} yerine anahtarınızı ve örnek adres yerine alıcı adresinizi yazın:

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 gövdesi yalnızca address içerir ve 64 KiB içine sığmalıdır. Bilinmeyen alanlar veya geçersiz JSON 400 invalid_request döndürür. Sorgu parametreleri olmadan tam uç noktayı kullanın.

Talep penceresi ve sınırlar

Kabul edilen her talep 0.001 test ETH (1000000000000000 wei) gönderir.
Her hesap ve her alıcı adresi kayan 24 saatte bir yeni talebe sahip olabilir. Aynı hesapta başka bir anahtar kullanmak sınırı artırmaz.
Faucet, tüm kullanıcılar genelinde UTC günü başına en fazla 1.000 yeni talep kabul eder.
İstekler, /v1/account ile paylaşılan anahtar başına saniyede 5 istek sınırına tabidir.

next_eligible_at, kabul zamanı artı 24 saattir ve RFC 3339 UTC zaman damgası olarak ifade edilir. Hesap ve adres pencereleri UTC gece yarısında sıfırlanmaz. Talep sınırı 429, error.data.scope (account, address veya global) ve error.data.next_eligible_at içerir; global için zaman damgası bir sonraki UTC gününün başlangıcıdır. İstek sıklığı 429 yanıtında scope bulunmaz.

Kabul edildi, onaylandı anlamına gelmez

HTTP 202, zincir üstüne başarıyla dahil edildiği anlamına gelmez, kabul edildiği anlamına gelir. JSON yanıtı şunları içerir:

Alan	Anlamı
`chain` / `chain_id`	`robinhood_testnet` / `46630`
`address`	Küçük harfli alıcı adresi
`amount_wei`	Ondalık tamsayı dizesi olarak talep miktarı
`tx_hash`	Kabul edilen işlemin kararlı hash'i
`next_eligible_at`	Kayan pencere için bir sonraki uygunluk zamanı

Aynı hesaptan aynı normalleştirilmiş adresi 24 saat içinde yeniden denemek, söz konusu hesaptan geçerli başka bir anahtar kullanıldığında da dahil olmak üzere orijinal 202 yanıtını ve aynı tx_hash değerini döndürür. Başka bir ödeme göndermez. Bir yanıt kaybolursa, aynı hesapla aynı adresi yeniden deneyin.

Mevcut testnet RPC uç noktasını kullanarak işlemi kontrol edin. {tx_hash} yerine kabul edilen yanıttaki hash'i yazın; bu RPC sorgusu normal CU faturalandırmasını kullanır:

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}"]}'

Hatalar ve yeniden denemeler

Hata zarfı error.code, error.message ve error.data içerir. error.data.reason, error.code ile eşittir; docs_url, retryable ve request_id hata referansını, yeniden deneme politikasını ve istek tanımlayıcısını sağlar. Her 429 veya 503 için yeniden denemeden önce Retry-After yanıt başlığındaki saniye kadar bekleyin. Kabul edilmiş bir yanıt olmadan test ETH'nin gönderildiğini varsaymayın.

HTTP	Hata kodu	Ne yapılmalı
400	`invalid_address`	Adres biçimini veya EIP-55 sağlama toplamını düzeltin; `error.data.field` değeri `/address` olur.
400	`invalid_request`	Yalnızca `address` içeren geçerli bir JSON gönderin.
401	`missing_api_key` / `invalid_api_key`	`x-api-key` içinde geçerli bir anahtar sağlayın.
403	`key_expired`	Yeni bir API anahtarı oluşturun.
404	`not_found`	Yolu, zinciri, POST yöntemini ve sorgu parametrelerinin bulunmadığını kontrol edin; faucet kullanılamıyor olabilir.
413	`request_too_large`	Gövdeyi 64 KiB altına sığacak şekilde küçültün.
429	`rate_limited`	`Retry-After` süresini bekleyin; varsa `scope` ve `next_eligible_at` alanlarını inceleyin.
503	`faucet_empty`	Faucet, talep ve ücretler için yetersiz bakiyeye sahiptir. `Retry-After` süresini bekleyin.
503	`service_unavailable`	Talep işleme geçici olarak kullanılamıyor veya önceki bir talebin henüz makbuzu yok. `Retry-After` süresini bekleyin.
503	`auth_unavailable` / `upstream_unavailable`	`Retry-After` süresini bekleyin, ardından yeniden deneyin.

Makine tarafından okunabilir rehberlik için Hata referansına veya /errors.json dosyasına, RPC erişimi için Robinhood Chain rehberine bakın.

Anahtarsız okumalar ve WebSocket logları için Robinhood Chain Testnet RPC başlangıç rehberi ile devam edin. Genel RPC URL'sini ve desteklenen yöntemleri testnet zincir sayfasında bulun.