Vai al contenuto principale
Venice Crypto RPC è un proxy HTTP per leggere lo stato della blockchain e inoltrare transazioni firmate. Utilizza la stessa autenticazione API key di Venice o wallet x402 degli altri endpoint Venice a pagamento, quindi la tua applicazione non necessita di un account separato con un provider RPC. Venice non conserva mai le tue chiavi private. Firma le transazioni nella tua applicazione e invia il payload firmato con eth_sendRawTransaction.

​
Scoprire le reti supportate

Recupera l’elenco attuale degli slug di rete:
L’endpoint di discovery è pubblico e non richiede autenticazione. La sua risposta è autoritativa; usa uno degli slug restituiti come {network} nell’endpoint RPC.

​
Inviare una richiesta RPC

Invia una richiesta JSON-RPC 2.0 alla rete selezionata:
Il proxy supporta richieste singole e batch fino a 100 richieste. I metodi supportati, i livelli di prezzo e la disponibilità variano; consulta il riferimento API Crypto RPC prima di affidarti a un metodo.

​
Flussi di lettura e scrittura

​
Leggere lo stato della chain

Usa metodi come eth_blockNumber, eth_getBalance, eth_call e eth_getLogs per interrogare i dati pubblici della chain. Raggruppa in batch le chiamate correlate quando riguardano la stessa rete.

​
Inoltrare una transazione

1

Costruisci la transazione

Leggi il nonce dell’account, i dati sulle fee e la stima del gas dalla rete di destinazione.
2

Firma localmente

Firma con la libreria wallet della tua applicazione. Non inviare mai una chiave privata o una seed phrase a Venice.
3

Invia il payload firmato

Chiama eth_sendRawTransaction e imposta un header Idempotency-Key in modo che i retry non creino un secondo relay fatturabile.
4

Verifica la ricevuta

Interroga eth_getTransactionReceipt fino a quando la transazione non viene inclusa, poi ispeziona il suo stato.

​
Retry sicuri

Imposta una chiave di idempotenza sulle richieste che potrebbero essere ripetute, in particolare i relay di transazioni:
Venice memorizza la risposta nella cache per 24 ore. Riutilizzare la chiave con lo stesso corpo della richiesta restituisce la risposta memorizzata senza un ulteriore addebito; riutilizzarla con un corpo diverso restituisce un errore.

​
Vincoli importanti

  • Il proxy è solo HTTP e non supporta le sottoscrizioni WebSocket.
  • I metodi di filtro stateful non sono supportati; usa metodi stateless come eth_getLogs.
  • Venice non conserva chiavi né espone metodi di firma.
  • I metodi al di fuori della allowlist restituiscono un errore.
  • Ispeziona X-Venice-RPC-Credits e X-Venice-RPC-Cost-USD per monitorare il costo della richiesta.

​
Risorse correlate