ERPC

Documentação do Bitcoin RPC endpoint | ERPC

Documentação do Bitcoin RPC endpoint

Use a ERPC como seu Bitcoin RPC endpoint para requisições HTTP JSON-RPC. O Bitcoin RPC faz parte das RPC APIs da ERPC dentro da nossa Global Edge Blockchain Infrastructure, e a API key pode ser gerenciada no ERPC Web Dashboard.
Você pode usar a mesma RPC key da Solana, do Ethereum e da Avalanche.
Passe sua API key no parâmetro de query api-key ou envie-a como Authorization: Bearer <YOUR_API_KEY>. Quando os dois estão presentes, o parâmetro de query é usado.

Endpoints

Envie requisições JSON-RPC como HTTP POST para:
text
https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>
ou para o host dedicado:
text
https://bitcoin.erpc.global?api-key=<YOUR_API_KEY>
As requisições são aceitas apenas em /.

Exemplos

Aqui está um exemplo de requisição HTTP com a API key no parâmetro de query.
bash
curl 'https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"1.0","id":1,
  "method":"getblockcount",
  "params":[]
}'
Aqui está a mesma requisição com a API key no cabeçalho Authorization.
bash
curl 'https://edge.erpc.global/bitcoin' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"1.0","id":1,
  "method":"getblockcount",
  "params":[]
}'
O Bitcoin aceita jsonrpc com o valor 1.0 ou 2.0, ou sem esse campo, e toda chamada precisa de um id.
Você pode obter e verificar sua API key no ERPC Web Dashboard: ERPC Web Dashboard

Requisições em lote

Lotes de JSON-RPC com 1 a 100 chamadas por requisição HTTP são suportados. Cada chamada precisa do seu próprio id, e os valores de id não podem se repetir dentro de um lote. Cada chamada em um lote é medida como uma chamada individual. O corpo da requisição pode ter até 1 MiB.

Medição de uso

O uso é medido em tokens, e a taxa de tokens pode variar conforme o método. Cada chamada em um lote HTTP é medida separadamente.

Limites do Plano Free

No Plano Free, sua conta pode enviar uma requisição a cada 10 segundos. O limite é contado por conta, e não por endpoint, então uma requisição a outra chain também pode contar para ele. Uma requisição enviada antes disso é respondida com HTTP 429, e o cabeçalho retry-after informa a espera em segundos.
No Plano Free, uma requisição que contém duas ou mais chamadas JSON-RPC é respondida com HTTP 429, e nenhuma de suas chamadas é enviada: cada chamada recebe um erro JSON-RPC com o código -32041. Envie essas chamadas uma de cada vez.

Métodos suportados

O endpoint atende estes 32 métodos JSON-RPC do Bitcoin Core.
decoderawtransaction, decodescript, estimatesmartfee, getbestblockhash, getblock, getblockchaininfo, getblockcount, getblockfilter, getblockhash, getblockheader, getblockstats, getchaintips, getchaintxstats, getconnectioncount, getdifficulty, getmempoolancestors, getmempooldescendants, getmempoolinfo, getmininginfo, getnetworkinfo, getrawmempool, getrawtransaction, gettransaction, gettxout, gettxoutproof, gettxoutsetinfo, sendrawtransaction, testmempoolaccept, validateaddress, verifychain, verifymessage, verifytxoutproof
Um método que não esteja listado é respondido com HTTP 400.

Códigos de status de resposta

HTTP statusSignificado
200Resposta JSON-RPC do upstream. Um erro JSON-RPC também é retornado com HTTP 200: ele mantém o id da requisição e o error.code, seu error.message é ERPC upstream error, e error.data não é retornado.
400Um método ou caminho fora da lista de métodos suportados, uma requisição JSON-RPC inválida, um lote vazio ou com mais de 100 chamadas, um id duplicado em um lote, ou um corpo acima de 1 MiB.
401API key ausente ou inválida, ou uma restrição de IP ou de Origin definida na key não foi atendida.
405Um método de requisição diferente de POST.
426Foi solicitado um WebSocket Upgrade. O endpoint atende apenas HTTP.
429Limitado por taxa, incluindo os limites do Plano Free acima: mais de uma requisição a cada 10 segundos, ou duas ou mais chamadas em uma requisição. Se houver um cabeçalho retry-after, aguarde o número de segundos indicado.
502A requisição upstream não pôde ser concluída: uma resposta upstream com falha, uma resposta acima de 8 MiB, ou nenhuma resposta em até 30 segundos.
503O serviço está temporariamente indisponível.

Métodos e Documentação Bitcoin RPC

Para a lista completa de métodos padrão, parâmetros e especificações, consulte a documentação oficial.
https://developer.bitcoin.org/reference/rpc/

Anterior

Bitcoin RPC Quickstart | ERPC

Próximo

Hyperliquid RPC Quickstart | ERPC