Pular para o conteúdo principal
O Venice Crypto RPC é um proxy HTTP para leitura do estado da blockchain e retransmissão de transações assinadas. Ele usa a mesma autenticação via chave de API da Venice ou carteira x402 dos demais endpoints pagos da Venice, portanto sua aplicação não precisa de uma conta separada com um provedor de RPC. A Venice nunca armazena suas chaves privadas. Assine as transações na sua aplicação e envie o payload assinado com eth_sendRawTransaction.

​
Descubra as redes suportadas

Consulte a lista atual de slugs de rede:
O endpoint de descoberta é público e não exige autenticação. Sua resposta é autoritativa; use um dos slugs retornados como {network} no endpoint RPC.

​
Envie uma requisição RPC

Envie uma requisição JSON-RPC 2.0 para a rede selecionada:
O proxy suporta requisições únicas e lotes de até 100 requisições. Os métodos suportados, os níveis de preço e a disponibilidade variam; consulte a referência da API Crypto RPC antes de depender de um método.

​
Fluxos de leitura e escrita

​
Ler o estado da chain

Use métodos como eth_blockNumber, eth_getBalance, eth_call e eth_getLogs para consultar dados públicos da chain. Agrupe chamadas relacionadas em lote quando forem para a mesma rede.

​
Retransmitir uma transação

1

Monte a transação

Leia o nonce da conta, os dados de taxa e a estimativa de gas na rede de destino.
2

Assine localmente

Assine com a biblioteca de carteira da sua aplicação. Nunca envie uma chave privada ou seed phrase para a Venice.
3

Envie o payload assinado

Chame eth_sendRawTransaction e defina um header Idempotency-Key para que retentativas não gerem uma segunda retransmissão faturável.
4

Confira o recibo

Faça polling em eth_getTransactionReceipt até a transação ser incluída e depois inspecione seu status.

​
Retentativas seguras

Defina uma chave de idempotência em requisições que possam ser repetidas, especialmente retransmissões de transações:
A Venice armazena em cache a resposta por 24 horas. Reutilizar a chave com o mesmo corpo de requisição retorna a resposta em cache sem nova cobrança; reutilizá-la com um corpo diferente retorna um erro.

​
Restrições importantes

  • O proxy é somente HTTP e não suporta assinaturas via WebSocket.
  • Métodos de filtro com estado não são suportados; use métodos sem estado como eth_getLogs.
  • A Venice não armazena chaves nem expõe métodos de assinatura.
  • Métodos fora da allowlist retornam erro.
  • Inspecione X-Venice-RPC-Credits e X-Venice-RPC-Cost-USD para acompanhar o custo da requisição.

​
Recursos relacionados