API JSON-RPC

Para que um aplicativo de software interaja com a blockchain Ethereum - lendo os dados da blockchain ou enviando transações para a rede - ele deve se conectar na Ethereum.

Para essa finalidade, todo cliente Ethereum implementa uma especificação JSON-RPC (opens in a new tab), de modo que haja um conjunto uniforme de métodos nos quais os aplicativos podem confiar, independentemente da implementação específica do nó ou do cliente.

JSON-RPC (opens in a new tab) é um protocolo de chamada de procedimento remoto (RPC) leve e sem estado. Ele define várias estruturas de dados e as regras em torno de seu processamento. É agnóstico de transporte no sentido de que os conceitos podem ser usados dentro do mesmo processo, sobre sockets, HTTP ou em vários ambientes de passagem de mensagens. Usa o formato de dados JSON (RFC 4627).

Implementações de cliente

Cada cliente Ethereum pode utilizar linguagens de programação diferentes ao implementar a especificação JSON-RPC. Consulte a documentação do cliente individual para mais detalhes relacionados a linguagens de programação específicas. Recomendamos verificar a documentação de cada cliente para as informações mais recentes de suporte à API.

Bibliotecas de conveniência

Embora você possa optar por interagir diretamente com clientes da Ethereum usando a API JSON-RPC, muitas vezes existem opções mais fáceis para desenvolvedores de dapps. Existem muitas bibliotecas de JavaScript e API de backend que fornecem wrappers sobre a API JSON-RPC. Com essas bibliotecas, os desenvolvedores podem escrever intuitivamente métodos de uma linha para inicializar requisições JSON RPC (sob os capôs) que interagem com a Ethereum.

APIs de cliente de consenso

Esta página trata principalmente da API JSON-RPC usada pelos clientes de execução Ethereum. No entanto, os clientes de consenso também têm uma API RPC que permite aos usuários consultar informações sobre o nó, solicitar blocos Beacon, estado do Beacon, e outras informações relacionadas ao consenso diretamente de um nó. Esta API está documentada na página da Beacon API (opens in a new tab).

Uma API interna também é usada para comunicação entre clientes dentro de um nó - ou seja, permite que o cliente de consenso e o cliente de execução troquem dados. Isso é chamado de 'Engine API' e as especificações estão disponíveis no GitHub (opens in a new tab).

Especificação do cliente de execução

Leia a especificação completa da API JSON-RPC no GitHub (opens in a new tab). Esta API está documentada na página da web da API de Execução (opens in a new tab) e inclui um Inspetor para experimentar todos os métodos disponíveis.

Convenções

Codificação de valor hexadecimal

Dois tipos de dados-chave são passados pelo JSON: arrays (matrizes) e quantidade de bytes não formatados. Ambos são passados com uma codificação hexadecimal, mas com diferentes requisitos de formatação.

Quantidades

Ao codificar quantidades (inteiros, números): codifique como hexadecimal, prefixe com "0x", a representação mais compacta (pequena exceção: zero deve ser representado como "0x0").

Veja aqui alguns exemplos:

• 0x41 (65 em decimal)
• 0x400 (1024 em decimal)
• ERRADO: 0x (deve sempre ter pelo menos um dígito - zero é "0x0")
• ERRADO: 0x0400 (sem zeros à esquerda permitidos)
• ERRADO: ff (deve ser prefixado 0x)

Dados não formatados

Ao codificar dados não formatados (arrays de bytes, endereços de contas, hashes, matrizes de bytecodes): codifique como hexadecimal, prefixe com "0x", dois dígitos hexadecimais por byte.

Veja aqui alguns exemplos:

• 0x41 (tamanho 1, "A")
• 0x004200 (tamanho 3, "0B0")
• 0x (tamanho 0, "")
• ERRADO: 0xf0f0f (deve ser um número par de dígitos)
• ERRADO: 004200 (deve ser prefixado 0x)

O parâmetro de bloco

Os seguintes métodos têm um parâmetro de bloco:

• eth_getBalance
• eth_getCode
• eth_getTransactionCount
• eth_getStorageAt
• eth_call

Quando são feitas solicitações que consultam o estado do Ethereum, o parâmetro de bloco fornecido determina a altura do bloco.

As seguintes opções são possíveis para o parâmetro de bloco:

• String HEX - um número de bloco inteiro
• String "earliest" para o bloco mais antigo/gênese
• String "latest" - para o último bloco proposto
• String "safe" - para o último bloco principal seguro
• String "finalized" - para o último bloco finalizado
• String "pending" - para o estado/transações pendentes

Exemplos

Nesta página, fornecemos exemplos de como usar endpoints individuais da API JSON_RPC usando a ferramenta de linha de comando curl (opens in a new tab). Esses exemplos de endpoint individuais são encontrados abaixo na seção Exemplos de Curl. Mais adiante na página, também fornecemos um exemplo de ponta a ponta para compilar e implantar um contrato inteligente usando um nó Geth, a API JSON_RPC e o curl.

Exemplos de Curl

Abaixo, são fornecidos exemplos de uso da API JSON_RPC, fazendo solicitações com o curl (opens in a new tab) para um nó do Ethereum. Cada exemplo inclui uma descrição do endpoint específico, seus parâmetros, tipo de retorno e um exemplo funcional de como ele deve ser usado.

Os pedidos curl podem retornar uma mensagem de erro relacionada ao tipo de conteúdo. Isso ocorre porque a opção --data define o tipo de conteúdo para application/x-www-form-urlencoded. Se o seu nó reclamar sobre isso, defina manualmente o cabeçalho, inserindo -H "Content-Type: application/json" no início da chamada. Os exemplos também não incluem a combinação de URL/IP e porta que deve ser o último argumento dado ao curl (por exemplo, 127.0.0.1:8545). Uma solicitação de curl completa, incluindo esses dados adicionais, tem o seguinte formato:

1curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545

Gossip, Estado, Histórico

Alguns métodos JSON-RPC principais exigem dados da rede Ethereum e se enquadram em três categorias principais: Gossip, Estado e Histórico. Use os links nestas seções para pular para cada método ou use a tabela de conteúdos para explorar toda a lista de métodos.

Métodos Gossip

Esses métodos rastreiam o cabeçalho da cadeia. É assim que as transações se deslocam pela rede, encontram o caminho para os blocos e como os clientes descobrem novos blocos.

• eth_blockNumber
• eth_sendRawTransaction

Métodos de Estado

Métodos que relatam o estado atual de todos os dados armazenados. O "estado" é como um grande pedaço compartilhado de RAM e inclui saldos de contas, dados de contratos e estimativas de gás.

• eth_getBalance
• eth_getStorageAt
• eth_getTransactionCount
• eth_getCode
• eth_call
• eth_estimateGas

Métodos de Histórico

Busca o histórico de registros de cada bloco até à gênesis (início). Isso é como um arquivo grande que apenas insere e inclui todos os cabeçalhos de bloco, corpos de bloco, blocos de tio e recibos de transação.

• eth_getBlockTransactionCountByHash
• eth_getBlockTransactionCountByNumber
• eth_getUncleCountByBlockHash
• eth_getUncleCountByBlockNumber
• eth_getBlockByHash
• eth_getBlockByNumber
• eth_getTransactionByHash
• eth_getTransactionByBlockHashAndIndex
• eth_getTransactionByBlockNumberAndIndex
• eth_getTransactionReceipt
• eth_getUncleByBlockHashAndIndex
• eth_getUncleByBlockNumberAndIndex

Playground da API JSON-RPC

Você pode usar a ferramenta de playground (opens in a new tab) para descobrir e testar os métodos da API. Ele também mostra quais métodos e redes são suportados por vários provedores de nós.

Métodos da API JSON-RPC

web3_clientVersion

Retorna a versão atual do cliente.

Parâmetros

Nenhum

Retornos

String - A versão atual do cliente

Exemplo

1// Solicitação
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
3// Resultado
4{
5  "id":67,
6  "jsonrpc":"2.0",
7  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
8}
Copiar

web3_sha3

Retorna o Keccak-256 (não o SHA3-256 padronizado) dos dados fornecidos.

Parâmetros

1. DATA - Os dados a serem convertidos em um hash SHA3

1params: ["0x68656c6c6f20776f726c64"]
Copiar

Retornos

DATA - O resultado SHA3 da string fornecida.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
3// Resultado
4{
5  "id":64,
6  "jsonrpc": "2.0",
7  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
8}
Copiar

net_version

Retorna a id da rede atual.

Parâmetros

Nenhum

Retornos

String - O id da rede atual.

A lista completa dos IDs de rede atuais está disponível em chainlist.org (opens in a new tab). Alguns exemplos comuns são:

• 1: Rede Principal do Ethereum
• 11155111: Rede de teste Sepolia
• 560048 : Rede de teste Hoodi

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
3// Resultado
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "3"
8}
Copiar

net_listening

Retorna true se o cliente está ativamente escutando por conexões de rede.

Parâmetros

Nenhum

Retornos

Booleano - true quando escutando, caso contrário, false.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
3// Resultado
4{
5  "id":67,
6  "jsonrpc":"2.0",
7  "result":true
8}
Copiar

net_peerCount

Retorna o número de pares atualmente conectados ao cliente.

Parâmetros

Nenhum

Retornos

QUANTITY - número inteiro de pares conectados.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
3// Resultado
4{
5  "id":74,
6  "jsonrpc": "2.0",
7  "result": "0x2" // 2
8}
Copiar

eth_protocolVersion

Retorna a versão atual do protocolo Ethereum. Observe que este método não está disponível no Geth (opens in a new tab).

Parâmetros

Nenhum

Retornos

String - A versão atual do protocolo Ethereum

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
3// Resultado
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "54"
8}
Copiar

eth_syncing

Retorna um objeto com dados sobre o status da sincronização ou false.

Parâmetros

Nenhum

Retornos

Os dados de retorno precisos variam entre as implementações do cliente. Todos os clientes retornam False quando o nó não está sincronizando, e todos os clientes retornam os seguintes campos.

Objeto|Booleano, um objeto com dados de status de sincronização ou FALSE, quando não está sincronizando:

• startingBlock: QUANTITY - O bloco no qual a importação foi iniciada (só será reiniciado depois que a sincronização atingir o bloco principal)
• currentBlock: QUANTITY - O bloco atual, o mesmo que eth_blockNumber
• highestBlock: QUANTITY - O bloco mais alto estimado

No entanto, os clientes individuais também podem fornecer dados adicionais. Por exemplo, Geth retorna o seguinte:

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": {
5    "currentBlock": "0x3cf522",
6    "healedBytecodeBytes": "0x0",
7    "healedBytecodes": "0x0",
8    "healedTrienodes": "0x0",
9    "healingBytecode": "0x0",
10    "healingTrienodes": "0x0",
11    "highestBlock": "0x3e0e41",
12    "startingBlock": "0x3cbed5",
13    "syncedAccountBytes": "0x0",
14    "syncedAccounts": "0x0",
15    "syncedBytecodeBytes": "0x0",
16    "syncedBytecodes": "0x0",
17    "syncedStorage": "0x0",
18    "syncedStorageBytes": "0x0"
19  }
20}
Exibir tudo
Copiar

Enquanto Besu retorna:

1{
2  "jsonrpc": "2.0",
3  "id": 51,
4  "result": {
5    "startingBlock": "0x0",
6    "currentBlock": "0x1518",
7    "highestBlock": "0x9567a3",
8    "pulledStates": "0x203ca",
9    "knownStates": "0x200636"
10  }
11}
Exibir tudo
Copiar

Consulte a documentação do seu cliente específico para obter mais detalhes.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": {
8    startingBlock: '0x384',
9    currentBlock: '0x386',
10    highestBlock: '0x454'
11  }
12}
13// Ou quando não estiver sincronizando
14{
15  "id":1,
16  "jsonrpc": "2.0",
17  "result": false
18}
Exibir tudo
Copiar

eth_coinbase

Retorna o endereço de coinbase do cliente.

Observação: Este método foi preterido a partir da v1.14.0 e não tem mais suporte. Tentar usar este método resultará em um erro de "Método não suportado".

Parâmetros

Nenhum

Retornos

DATA, 20 bytes - o endereço coinbase atual.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
3// Resultado
4{
5  "id":64,
6  "jsonrpc": "2.0",
7  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
8}
Copiar

eth_chainId

Retorna a ID da cadeia usada para assinar transações protegidas contra reprodução.

Parâmetros

Nenhum

Retornos

chainId, valor hexadecimal como uma string representando o número inteiro do ID da cadeia atual.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
3// Resultado
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "0x1"
8}
Copiar

eth_mining

Retorna true se o cliente estiver minerando ativamente novos blocos. Isso só pode retornar true para redes de prova de trabalho e pode não estar disponível em alguns clientes desde A Fusão.

Parâmetros

Nenhum

Retornos

Booleano - retorna true se o cliente estiver minerando, caso contrário, false.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
3//
4{
5  "id":71,
6  "jsonrpc": "2.0",
7  "result": true
8}
Copiar

eth_hashrate

Retorna o número de hashes por segundo do nó que está minerando. Isso só pode retornar true para redes de prova de trabalho e pode não estar disponível em alguns clientes desde A Fusão.

Parâmetros

Nenhum

Retornos

QUANTITY - número de hashes por segundo.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
3// Resultado
4{
5  "id":71,
6  "jsonrpc": "2.0",
7  "result": "0x38a"
8}
Copiar

eth_gasPrice

Retorna uma estimativa do preço atual por unidade de gás em wei. Por exemplo, o cliente Besu examina os últimos 100 blocos e retorna o preço unitário médio do gás por padrão.

Parâmetros

Nenhum

Retornos

QUANTITY - número inteiro do preço do gás atual em wei.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
3// Resultado
4{
5  "id":73,
6  "jsonrpc": "2.0",
7  "result": "0x1dfd14000" // 8049999872 Wei
8}
Copiar

eth_accounts

Retorna uma lista de endereços de propriedade do cliente.

Parâmetros

Nenhum

Retornos

Array de DATA, 20 Bytes - endereços pertencentes ao cliente.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
8}
Copiar

eth_blockNumber

Retorna o número do bloco mais recente.

Parâmetros

Nenhum

Retornos

QUANTITY - número inteiro do bloco atual em que o cliente está.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
3// Resultado
4{
5  "id":83,
6  "jsonrpc": "2.0",
7  "result": "0x4b7" // 1207
8}
Copiar

eth_getBalance

Retorna o saldo da conta de um determinado endereço.

Parâmetros

1. DATA, 20 Bytes - endereço para verificar o saldo.
2. QUANTITY|TAG - número de bloco inteiro, ou a string "latest", "earliest", "pending", "safe" ou "finalized", veja o parâmetro de bloco

1params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]
Copiar

Retornos

QUANTITY - número inteiro do saldo atual em wei.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x0234c8a3397aab58" // 158972490234375000
8}
Copiar

eth_getStorageAt

Retorna o valor de uma posição de armazenamento em um determinado endereço.

Parâmetros

1. DATA, 20 Bytes - endereço do armazenamento.
2. QUANTITY - inteiro da posição no armazenamento.
3. QUANTITY|TAG - número de bloco inteiro, ou a string "latest", "earliest", "pending", "safe" ou "finalized", veja o parâmetro de bloco

Retornos

DATA - o valor nesta posição de armazenamento.

Exemplo Calcular a posição correta depende do armazenamento a ser recuperado. Considere o seguinte contrato implantado em 0x295a70b2de5e3953354a6a8344e616ed314d7251 pelo endereço 0x391694e7e0b0cce554cb130d723a9d27458f9298.

1contract Storage {
2    uint pos0;
3    mapping(address => uint) pos1;
4    constructor() {
5        pos0 = 1234;
6        pos1[msg.sender] = 5678;
7    }
8}

Recuperar o valor de pos0 é simples:

1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
2{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}
Copiar

Recuperar um elemento do mapa é mais difícil. A posição de um elemento no mapa é calculada com:

1keccak(LeftPad32(key, 0), LeftPad32(map position, 0))
Copiar

Isso significa que para recuperar o armazenamento na pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] precisamos calcular a posição com:

1keccak(
2  decodeHex(
3    "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
4      "0000000000000000000000000000000000000000000000000000000000000001"
5  )
6)
Copiar

O console geth fornecido com a biblioteca Web3 pode ser usado para fazer o cálculo:

1> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"
2undefined
3> web3.sha3(key, {"encoding": "hex"})
4"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"
Copiar

Agora, para buscar o armazenamento:

1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
2{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}
Copiar

eth_getTransactionCount

Retorna o número de transações enviadas de um endereço.

Parâmetros

1. DATA, 20 Bytes - endereço.
2. QUANTITY|TAG - número de bloco inteiro, ou a string "latest", "earliest", "pending", "safe" ou "finalized", veja o parâmetro de bloco

1params: [
2  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
3  "latest", // estado no bloco mais recente
4]
Copiar

Retornos

QUANTITY - inteiro do número de transações enviadas a partir deste endereço.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x1" // 1
8}
Copiar

eth_getBlockTransactionCountByHash

Retorna o número de transações em um bloco a partir de um bloco que corresponde ao hash de bloco fornecido.

Parâmetros

1. DATA, 32 Bytes - hash de um bloco

1params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]
Copiar

Retornos

QUANTITY - inteiro do número de transações neste bloco.

Exemplo

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x8b" // 139
8}
Copiar

eth_getBlockTransactionCountByNumber

Retorna o número de transações em um bloco a partir de um bloco que corresponde ao hash de bloco fornecido.

Parâmetros

1. QUANTITY|TAG - inteiro de um número de bloco ou a string "earliest", "latest", "pending", "safe" ou "finalized", como no parâmetro de bloco.

1params: [
2  "0x13738ca", // 20396234
3]
Copiar

Retornos

QUANTITY - inteiro do número de transações neste bloco.

Exemplo

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x8b" // 139
8}
Copiar

eth_getUncleCountByBlockHash

Retorna o número de transações em um bloco a partir de um bloco que corresponde ao hash de bloco fornecido.

Parâmetros

1. DATA, 32 Bytes - hash de um bloco

1params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]
Copiar

Retornos

QUANTITY - inteiro do número de tios neste bloco.

Exemplo

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x1" // 1
8}
Copiar

eth_getUncleCountByBlockNumber

Retorna o número de transações em um bloco a partir de um bloco que corresponde ao hash de bloco fornecido.

Parâmetros

1. QUANTITY|TAG - inteiro de um número de bloco, ou a string "latest", "earliest", "pending", "safe" ou "finalized", veja o parâmetro de bloco

1params: [
2  "0xe8", // 232
3]
Copiar

Retornos

QUANTITY - inteiro do número de tios neste bloco.

Exemplo

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x0" // 0
8}
Copiar

eth_getCode

Retorna o código em um endereço fornecido.

Parâmetros

1. DATA, 20 Bytes - endereço
2. QUANTITY|TAG - número de bloco inteiro, ou a string "latest", "earliest", "pending", "safe" ou "finalized", veja o parâmetro de bloco

1params: [
2  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
3  "0x5daf3b", // 6139707
4]
Copiar

Retornos

DATA - o código do endereço fornecido.

Exemplo

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
8}
Copiar

eth_sign

O método de assinatura calcula uma assinatura específica do Ethereum com: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).

Ao adicionar um prefixo à mensagem, a assinatura calculada é reconhecível como uma assinatura específica do Ethereum. Isso evita o uso indevido, no qual um dapp mal-intencionado pode assinar dados arbitrários (por exemplo, uma transação) e usar a assinatura para se passar pela vítima.

Observação: o endereço de assinatura deve estar desbloqueado.

Parâmetros

1. DATA, 20 Bytes - endereço
2. DATA, N Bytes - mensagem a ser assinada

Retornos

DATA: Assinatura

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}
Copiar

eth_signTransaction

Assina uma transação que pode ser enviada à rede posteriormente usando eth_sendRawTransaction.

Parâmetros

1. Objeto - O objeto da transação

• tipo:
• from: DATA, 20 Bytes - O endereço de onde a transação é enviada.
• to: DATA, 20 Bytes - (opcional ao criar um novo contrato) O endereço para o qual a transação é direcionada.
• gas: QUANTITY - (opcional, padrão: 90000) Inteiro do gás fornecido para a execução da transação. Retornará o gás não utilizado.
• gasPrice: QUANTITY - (opcional, padrão: a ser determinado) Inteiro do gasPrice usado para cada gás pago, em Wei.
• value: QUANTITY - (opcional) Inteiro do valor enviado com esta transação, em Wei.
• data: DATA - O código compilado de um contrato OU o hash da assinatura do método invocado e parâmetros codificados.
• nonce: QUANTITY - (opcional) Inteiro de um nonce. Isso permite substituir suas próprias transações pendentes que usam o mesmo nonce.

Retornos

DATA, o objeto da transação codificado por RLP e assinado pela conta especificada.

Exemplo

1// Requisição
2curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
3// Resultado
4{
5    "id": 1,
6    "jsonrpc": "2.0",
7    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}
Copiar

eth_sendTransaction

Cria uma nova transação de chamada de mensagem ou uma criação de contrato, se o campo de dados contiver código, e o assina usando a conta especificada em from.

Parâmetros

1. Objeto - O objeto da transação

• from: DATA, 20 Bytes - O endereço de onde a transação é enviada.
• to: DATA, 20 Bytes - (opcional ao criar um novo contrato) O endereço para o qual a transação é direcionada.
• gas: QUANTITY - (opcional, padrão: 90000) Inteiro do gás fornecido para a execução da transação. Retornará o gás não utilizado.
• gasPrice: QUANTITY - (opcional, padrão: a ser determinado) Inteiro do gasPrice usado para cada gás pago.
• value: QUANTITY - (opcional) Inteiro do valor enviado com esta transação.
• input: DATA - O código compilado de um contrato OU o hash da assinatura do método invocado e dos parâmetros codificados.
• nonce: QUANTITY - (opcional) Inteiro de um nonce. Isso permite substituir suas próprias transações pendentes que usam o mesmo nonce.

1params: [
2  {
3    from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
4    to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
5    gas: "0x76c0", // 30400
6    gasPrice: "0x9184e72a000", // 10000000000000
7    value: "0x9184e72a", // 2441406250
8    input:
9      "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
10  },
11]
Exibir tudo
Copiar

Retornos

DATA, 32 Bytes - o hash da transação, ou o hash zero se a transação ainda não estiver disponível.

Use eth_getTransactionReceipt para obter o endereço do contrato, depois de a transação ter sido proposta em um bloco, quando você criou um contrato.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}
Copiar

eth_sendRawTransaction

Cria uma nova transação de chamada de mensagem ou um contrato para transações assinadas.

Parâmetros

1. DATA, Os dados da transação assinada.

1params: [
2  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
3]
Copiar

Retornos

DATA, 32 Bytes - o hash da transação, ou o hash zero se a transação ainda não estiver disponível.

Use eth_getTransactionReceipt para obter o endereço do contrato, depois de a transação ter sido proposta em um bloco, quando você criou um contrato.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}
Copiar

eth_call

Executa uma nova chamada de mensagem imediatamente sem criar uma transação no blockchain. Frequentemente usado para executar funções de contrato inteligente somente leitura, por exemplo, o balanceOf para um contrato ERC-20.

Parâmetros

1. Objeto - O objeto de chamada de transação

• from: DATA, 20 Bytes - (opcional) O endereço de onde a transação é enviada.
• to: DATA, 20 Bytes - O endereço para o qual a transação é direcionada.
• gas: QUANTITY - (opcional) Inteiro do gás fornecido para a execução da transação. eth_call consome zero gás, mas este parâmetro pode ser necessário para algumas execuções.
• gasPrice: QUANTITY - (opcional) Inteiro do gasPrice usado para cada gás pago
• value: QUANTITY - (opcional) Inteiro do valor enviado com esta transação
• input: DATA - (opcional) Hash da assinatura do método e parâmetros codificados. Para obter detalhes, consulte IAB do Contrato Ethereum na documentação do Solidity (opens in a new tab).

2. QUANTITY|TAG - número de bloco inteiro, ou a string "latest", "earliest", "pending", "safe" ou "finalized", veja o parâmetro de bloco

Retornos

DATA - o valor de retorno do contrato executado.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x"
8}
Copiar

eth_estimateGas

Gera e retorna uma estimativa de quantas unidades de gás são necessárias para permitir que a transação seja concluída. A transação não será adicionada à blockchain. Observe que a estimativa pode ser significativamente maior do que a quantidade de gás realmente usada pela transação, por vários motivos, incluindo a mecânica do EVM e o desempenho do nó.

Parâmetros

Consulte os parâmetros de eth_call, exceto que todas as propriedades são opcionais. Se nenhum limite de gás é especificado, o geth usa o limite de gás do bloco pendente como um limite superior. Como resultado, a estimativa retornada pode não ser suficiente para executar a chamada/transação quando a quantidade de gás for maior que o limite de gás do bloco pendente.

Retornos

QUANTITY - a quantidade de gás usada.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x5208" // 21000
8}
Copiar

eth_getBlockByHash

Retorna informações sobre um bloco por hash.

Parâmetros

1. DATA, 32 Bytes - Hash de um bloco.
2. Booleano - Se true, retorna os objetos de transação completos; se false, apenas os hashes das transações.

1params: [
2  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
3  false,
4]
Copiar

Retornos

Objeto - Um objeto de bloco, ou nulo quando nenhum bloco foi encontrado:

• number: QUANTITY - o número do bloco. null quando o bloco está pendente.
• hash: DATA, 32 Bytes - hash do bloco. null quando o bloco está pendente.
• parentHash: DATA, 32 Bytes - hash do bloco pai.
• nonce: DATA, 8 Bytes - hash da prova de trabalho gerada. null quando seu bloco estiver pendente, 0x0 para blocos de prova de participação (desde A Fusão)
• sha3Uncles: DATA, 32 Bytes - SHA3 dos dados dos tios no bloco.
• logsBloom: DATA, 256 Bytes - o filtro bloom para os logs do bloco. null quando o bloco está pendente.
• transactionsRoot: DATA, 32 Bytes - a raiz da árvore de transação do bloco.
• stateRoot: DATA, 32 Bytes - a raiz da árvore do estado final do bloco.
• receiptsRoot: DATA, 32 Bytes - a raiz da árvore de recibos do bloco.
• miner: DATA, 20 Bytes - o endereço do beneficiário a quem as recompensas do bloco foram dadas.
• difficulty: QUANTITY - inteiro da dificuldade para este bloco.
• totalDifficulty: QUANTITY - inteiro da dificuldade total da cadeia até este bloco.
• extraData: DATA - o campo "dados extras" deste bloco.
• size: QUANTITY - inteiro do tamanho deste bloco em bytes.
• gasLimit: QUANTITY - o gás máximo permitido neste bloco.
• gasUsed: QUANTITY - o total de gás usado por todas as transações neste bloco.
• timestamp: QUANTITY - o carimbo de data/hora unix no momento em que o bloco foi agrupado.
• transactions: Array - Matriz de objetos de transação, ou hashes de transação de 32 Bytes, dependendo do último parâmetro fornecido.
• uncles: Array - Matriz de hashes tio.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
3// Resultado
4{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "result": {
8    "difficulty": "0x4ea3f27bc",
9    "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
10    "gasLimit": "0x1388",
11    "gasUsed": "0x0",
12    "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
13    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
14    "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
15    "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
16    "nonce": "0x689056015818adbe",
17    "number": "0x1b4",
18    "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
19    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
20    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
21    "size": "0x220",
22    "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
23    "timestamp": "0x55ba467c",
24    "totalDifficulty": "0x78ed983323d",
25    "transactions": [
26    ],
27    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
28    "uncles": [
29    ]
30  }
31}
Exibir tudo
Copiar

eth_getBlockByNumber

Retorna informações sobre um bloco por número de bloco.

Parâmetros

1. QUANTITY|TAG - inteiro de um número de bloco ou a string "earliest", "latest", "pending", "safe" ou "finalized", como no parâmetro de bloco.
2. Booleano - Se true, retorna os objetos de transação completos; se false, apenas os hashes das transações.

1params: [
2  "0x1b4", // 436
3  true,
4]
Copiar

Retornos Consulte eth_getBlockByHash

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'
Copiar

Resultado: consulte eth_getBlockByHash

eth_getTransactionByHash

Retorna as informações sobre uma transação solicitada pelo hash de transação.

Parâmetros

1. DATA, 32 Bytes - hash de uma transação

1params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]
Copiar

Retornos

Objeto - Um objeto de transação ou null quando nenhuma transação foi encontrada:

• blockHash: DATA, 32 Bytes - hash do bloco onde esta transação estava localizada. null quando está pendente.
• blockNumber: QUANTITY - número do bloco onde esta transação estava localizada. null quando está pendente.
• from: DATA, 20 Bytes - endereço do remetente.
• gas: QUANTITY - gás fornecido pelo remetente.
• gasPrice: QUANTITY - preço do gás fornecido pelo remetente em Wei.
• hash: DATA, 32 Bytes - hash da transação.
• input: DATA - os dados enviados com a transação.
• nonce: QUANTITY - o número de transações feitas pelo remetente antes desta.
• to: DATA, 20 Bytes - endereço do destinatário. null quando for uma transação de criação de contrato.
• transactionIndex: QUANTITY - inteiro da posição do índice de transações no bloco. null quando está pendente.
• value: QUANTITY - valor transferido em Wei.
• v: QUANTITY - ID de recuperação ECDSA
• r: QUANTITY - Assinatura ECDSA r
• s: QUANTITY - Assinatura ECDSA s

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
3// Resultado
4{
5  "jsonrpc":"2.0",
6  "id":1,
7  "result":{
8    "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
9    "blockNumber":"0x5daf3b", // 6139707
10    "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",
11    "gas":"0xc350", // 50000
12    "gasPrice":"0x4a817c800", // 20000000000
13    "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
14    "input":"0x68656c6c6f21",
15    "nonce":"0x15", // 21
16    "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",
17    "transactionIndex":"0x41", // 65
18    "value":"0xf3dbb76162000", // 4290000000000000
19    "v":"0x25", // 37
20    "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",
21    "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"
22  }
23}
Exibir tudo
Copiar

eth_getTransactionByBlockHashAndIndex

Retorna informações sobre uma transação por hash de bloco e a posição do índice de transação.

Parâmetros

1. DATA, 32 Bytes - hash de um bloco.
2. QUANTITY - inteiro da posição do índice da transação.

1params: [
2  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
3  "0x0", // 0
4]
Copiar

Retornos Consulte eth_getTransactionByHash

Exemplo

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'
Copiar

Resultado: consulte eth_getTransactionByHash

eth_getTransactionByBlockNumberAndIndex

Retorna informações sobre uma transação pelo número do bloco e posição do índice da transação.

Parâmetros

1. QUANTITY|TAG - um número de bloco, ou a string "earliest", "latest", "pending", "safe" ou "finalized", como no parâmetro de bloco.
2. QUANTITY - a posição do índice da transação.

1params: [
2  "0x9c47cf", // 10241999
3  "0x24", // 36
4]
Copiar

Retornos Consulte eth_getTransactionByHash

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'
Copiar

Resultado: consulte eth_getTransactionByHash

eth_getTransactionReceipt

Retorna o recebimento de uma transação pelo hash de transação.

Observação Que o recibo não está disponível para transações pendentes.

Parâmetros

1. DATA, 32 Bytes - hash de uma transação

1params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]
Copiar

Retornos Objeto - Um objeto de recibo de transação, ou null quando nenhum recibo foi encontrado:

• transactionHash : DATA, 32 Bytes - hash da transação.
• transactionIndex: QUANTITY - inteiro da posição do índice de transações no bloco.
• blockHash: DATA, 32 Bytes - hash do bloco onde esta transação estava localizada.
• blockNumber: QUANTITY - número do bloco onde esta transação estava localizada.
• from: DATA, 20 Bytes - endereço do remetente.
• to: DATA, 20 Bytes - endereço do destinatário. null quando for uma transação de criação de contrato.
• cumulativeGasUsed : QUANTITY - A quantidade total de gás utilizada quando esta transação foi executada no bloco.
• effectiveGasPrice : QUANTITY - A soma da taxa base e gorjeta pagas por unidade de gás.
• gasUsed : QUANTITY - A quantidade de gás usada apenas por esta transação específica.
• contractAddress : DATA, 20 Bytes - O endereço do contrato criado, se a transação foi uma criação de contrato, caso contrário, null.
• logs: Array - Matriz de objetos de log gerados por esta transação.
• logsBloom: DATA, 256 Bytes - Filtro Bloom para clientes leves para recuperar rapidamente os logs relacionados.
• type: QUANTITY - inteiro do tipo de transação, 0x0 para transações legadas, 0x1 para tipos de lista de acesso, 0x2 para taxas dinâmicas.

Também retorna seja:

• root: DATA 32 bytes da raiz do estado pós-transação (pré-Byzantium)
• status: QUANTITY seja 1 (sucesso) ou 0 (falha)

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'
3// Resultado
4{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "result": {
8    "blockHash":
9      "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",
10    "blockNumber": "0xeff35f",
11    "contractAddress": null, // string do endereço se ele foi criado
12    "cumulativeGasUsed": "0xa12515",
13    "effectiveGasPrice": "0x5a9c688d4",
14    "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",
15    "gasUsed": "0xb4c8",
16    "logs": [{
17      // logs como retornado por getFilterLogs, etc.
18    }],
19    "logsBloom": "0x00...0", // filtro bloom de 256 bytes
20    "status": "0x1",
21    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
22    "transactionHash":
23      "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",
24    "transactionIndex": "0x66",
25    "type": "0x2"
26  }
27}
Exibir tudo
Copiar

eth_getUncleByBlockHashAndIndex

Retorna informações sobre um tio de um bloco por hash e posição de índice do tio.

Parâmetros

1. DATA, 32 Bytes - O hash de um bloco.
2. QUANTITY - A posição do índice tio.

1params: [
2  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
3  "0x0", // 0
4]
Copiar

Retornos Consulte eth_getBlockByHash

Exemplo

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'
Copiar

Resultado: consulte eth_getBlockByHash

Observação: um tio não contém transações individuais.

eth_getUncleByBlockNumberAndIndex

Retorna informações sobre um tio de um bloco por número e posição do índice do tio.

Parâmetros

1. QUANTITY|TAG - um número de bloco, ou a string "earliest", "latest", "pending", "safe", "finalized", como no parâmetro de bloco.
2. QUANTITY - a posição do índice tio.

1params: [
2  "0x29c", // 668
3  "0x0", // 0
4]
Copiar

Retornos Consulte eth_getBlockByHash

Observação: um tio não contém transações individuais.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'
Copiar

Resultado: consulte eth_getBlockByHash

eth_newFilter

Cria um objeto de filtro, com base nas opções de filtro, para notificar quando o estado é alterado (logs). Para verificar se o estado mudou, chame eth_getFilterChanges.

Uma observação sobre a especificação de filtros de tópicos: Os tópicos dependem da ordem. Uma transação com um log com tópicos [A, B] será combinada pelos seguintes filtros de tópicos:

• [] "qualquer coisa"
• [A] "A na primeira posição (e qualquer coisa depois)"
• [null, B] "qualquer coisa na primeira posição E B na segunda posição (e qualquer coisa depois)"
• [A, B] "A na primeira posição E B na segunda posição (e qualquer coisa depois)"
• [[A, B], [A, B]] "(A OU B) na primeira posição E (A OU B) na segunda posição (e qualquer coisa depois)"
• Parâmetros

1. Objeto - As opções de filtro:

• fromBlock: QUANTITY|TAG - (opcional, padrão: "latest") Número de bloco inteiro, ou "latest" para o último bloco proposto, "safe" para o último bloco seguro, "finalized" para o último bloco finalizado, ou "pending", "earliest" para transações que ainda não estão em um bloco.
• toBlock: QUANTITY|TAG - (opcional, padrão: "latest") Número de bloco inteiro, ou "latest" para o último bloco proposto, "safe" para o último bloco seguro, "finalized" para o último bloco finalizado, ou "pending", "earliest" para transações que ainda não estão em um bloco.
• address: DATA|Array, 20 Bytes - (opcional) Endereço do contrato ou uma lista de endereços dos quais os logs devem ser originados.
• topics: Array de DATA, - (opcional) Array de 32 Bytes de tópicos de DATA. Os tópicos são dependentes da ordem. Cada tópico também pode ser uma matriz de DADOS (array of DATA) com opções “ou”.

1params: [
2  {
3    fromBlock: "0x1",
4    toBlock: "0x2",
5    address: "0x8888f1f195afa192cfee860698584c030f4c9db1",
6    topics: [
7      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
8      null,
9      [
10        "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
11        "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc",
12      ],
13    ],
14  },
15]
Exibir tudo
Copiar

Retornos QUANTITY - Uma ID de filtro.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x1" // 1
8}
Copiar

eth_newBlockFilter

Cria um filtro no nó para notificar quando um novo bloco chega. Para verificar se o estado mudou, chame eth_getFilterChanges.

Parâmetros Nenhum

Retornos QUANTITY - Uma ID de filtro.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc":  "2.0",
7  "result": "0x1" // 1
8}
Copiar

eth_newPendingTransactionFilter

Cria um filtro no nó para notificar quando chegam novas transações pendentes. Para verificar se o estado mudou, chame eth_getFilterChanges.

Parâmetros Nenhum

Retornos QUANTITY - Uma ID de filtro.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc":  "2.0",
7  "result": "0x1" // 1
8}
Copiar

eth_uninstallFilter

Desinstala um filtro com a ID fornecida. Deve ser sempre chamado quando nenhum tipo de observação é necessária. Além disso, os filtros expiram quando não são solicitados com eth_getFilterChanges por um período de tempo.

Parâmetros

1. QUANTITY - A ID do filtro.

1params: [
2  "0xb", // 11
3]
Copiar

Retornos Booleano - true se o filtro foi desinstalado com sucesso, caso contrário, false.

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": true
8}
Copiar

eth_getFilterChanges

Método de sondagem para um filtro, que retorna uma matriz de logs produzidos desde a última sondagem.

Parâmetros

1. QUANTITY - a ID do filtro.

1params: [
2  "0x16", // 22
3]
Copiar

Retornos Array - Matriz de objetos de log, ou uma matriz vazia se nada mudou desde a última sondagem.

• Para filtros criados com eth_newBlockFilter, o retorno são hashes de bloco (DATA, 32 Bytes), por exemplo, ["0x3454645634534..."].

• Para filtros criados com eth_newPendingTransactionFilter , o retorno são hashes de transação (DATA, 32 Bytes), por exemplo, ["0x6345343454645..."].

• Para filtros criados com eth_newFilter, os logs são objetos com os seguintes parâmetros:

  • removed: TAG - true quando o log foi removido, devido a uma reorganização da cadeia. false se for um log válido.
  • logIndex: QUANTITY - inteiro da posição do índice de log no bloco. null quando o log estiver pendente.
  • transactionIndex: QUANTITY - inteiro da posição do índice de transações a partir do qual o log foi criado. null quando o log estiver pendente.
  • transactionHash: DATA, 32 Bytes - hash das transações a partir das quais este log foi criado. null quando o log estiver pendente.
  • blockHash: DATA, 32 Bytes - hash do bloco onde este log estava localizado. null quando está pendente. null quando o log estiver pendente.
  • blockNumber: QUANTITY - o número do bloco onde este log estava localizado. null quando está pendente. null quando o log estiver pendente.
  • address: DATA, 20 Bytes - endereço de origem deste log.
  • data: DATA - dados de log de comprimento variável e não indexados. (Em solidity: zero ou mais argumentos de log de 32 Bytes não indexados.)
  • topics: Array de DATA - Matriz de 0 a 4 DATA de 32 Bytes de argumentos de log indexados. (Em solidity: O primeiro tópico é o hash da assinatura do evento (ex., Deposit(address,bytes32,uint256)), exceto se você declarou o evento com o especificador anonymous.)

• Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'
3// Resultado
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": [{
8    "logIndex": "0x1", // 1
9    "blockNumber":"0x1b4", // 436
10    "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
11    "transactionHash":  "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
12    "transactionIndex": "0x0", // 0
13    "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
14    "data":"0x0000000000000000000000000000000000000000000000000000000000000000",
15    "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]
16    },{
17      ...
18    }]
19}
Exibir tudo
Copiar

eth_getFilterLogs

Retorna uma matriz de todos os logs correspondentes ao filtro com a ID fornecida.

Parâmetros

1. QUANTITY - A ID do filtro.

1params: [
2  "0x16", // 22
3]
Copiar

Retornos Consulte eth_getFilterChanges

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'
Copiar

Resultado: consulte eth_getFilterChanges

eth_getLogs

Retorna uma matriz de todos os logs que correspondem a um determinado objeto de filtro.

Parâmetros

1. Objeto - As opções de filtro:

• fromBlock: QUANTITY|TAG - (opcional, padrão: "latest") Número de bloco inteiro, ou "latest" para o último bloco proposto, "safe" para o último bloco seguro, "finalized" para o último bloco finalizado, ou "pending", "earliest" para transações que ainda não estão em um bloco.
• toBlock: QUANTITY|TAG - (opcional, padrão: "latest") Número de bloco inteiro, ou "latest" para o último bloco proposto, "safe" para o último bloco seguro, "finalized" para o último bloco finalizado, ou "pending", "earliest" para transações que ainda não estão em um bloco.
• address: DATA|Array, 20 Bytes - (opcional) Endereço do contrato ou uma lista de endereços dos quais os logs devem ser originados.
• topics: Array de DATA, - (opcional) Array de 32 Bytes de tópicos de DATA. Os tópicos são dependentes da ordem. Cada tópico também pode ser uma matriz de DADOS (array of DATA) com opções “ou”.
• blockHash: DATA, 32 Bytes - (opcional, futuro) Com a adição do EIP-234, blockHash será uma nova opção de filtro que restringe os logs retornados ao bloco único com o hash de 32-byte blockHash. Usar blockHash é equivalente a fromBlock = toBlock = o número do bloco com hash blockHash. Se blockHash estiver presente nos critérios de filtro, fromBlock e toBlock não serão permitidos.

1params: [
2  {
3    topics: [
4      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
5    ],
6  },
7]
Copiar

Retornos Consulte eth_getFilterChanges

Exemplo

1// Requisição
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'
Copiar

Resultado: consulte eth_getFilterChanges

Exemplo de uso

Implantando um contrato usando JSON_RPC

Esta seção inclui uma demonstração de como implantar um contrato usando apenas a interface RPC. Existem rotas alternativas para a implantação de contratos nos quais essa complexidade é abstraída, por exemplo, usando bibliotecas criadas sobre a interface RPC, como web3.js (opens in a new tab) e web3.py (opens in a new tab). Essas abstrações são geralmente mais fáceis de entender e menos propensas a erros, mas ainda é útil entender o que está acontecendo internamente, ou seja, sem que o usuário perceba.

Veja a seguir um contrato inteligente simples chamado Multiply7 que será implantado usando a interface JSON-RPC em um nó Ethereum. Este tutorial pressupõe que o leitor já esteja executando um nó Geth. Mais informações sobre nós e clientes estão disponíveis aqui. Consulte a documentação específica de cada cliente para ver como iniciar o JSON-RPC HTTP para clientes não Geth. A maioria dos clientes atende por padrão em localhost:8545.

1contract Multiply7 {
2    event Print(uint);
3    function multiply(uint input) returns (uint) {
4        Print(input * 7);
5        return input * 7;
6    }
7}

A primeira coisa a fazer é verificar se a interface HTTP RPC está habilitada. Isso significa que fornecemos ao Geth o sinalizador --http na inicialização. Neste exemplo, usamos o nó Geth em uma cadeia de desenvolvimento privada. Usando essa abordagem, não precisamos de ether na rede real.

geth --http --dev console 2>>geth.log

Isso iniciará a interface HTTP RPC em http://localhost:8545.

Podemos verificar se a interface está em execução recuperando o endereço coinbase (obtendo o primeiro endereço da matriz de contas) e o saldo usando o curl (opens in a new tab). Observe que os dados nesses exemplos serão diferentes no seu nó local. Se você quiser tentar esses comandos, substitua os parâmetros de solicitação na segunda solicitação curl pelo resultado retornado da primeira.

curl --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[], "id":1}' -H "Content-Type: application/json" localhost:8545
{"id":1,"jsonrpc":"2.0","result":["0x9b1d35635cc34752ca54713bb99d38614f63c955"]}
curl --data '{"jsonrpc":"2.0","method":"eth_getBalance", "params": ["0x9b1d35635cc34752ca54713bb99d38614f63c955", "latest"], "id":2}' -H "Content-Type: application/json" localhost:8545
{"id":2,"jsonrpc":"2.0","result":"0x1639e49bba16280000"}

Como os números são codificados em hexa, o saldo é retornado em Wei como uma cadeia de caracteres hexadecimal. Se quisermos ter o saldo em ether como um número, podemos usar a Web3 do console Geth.

1web3.fromWei("0x1639e49bba16280000", "ether")
2// "410"

Agora que já temos alguns Ether em nossa cadeia de desenvolvimento privada, podemos implantar o contrato. O primeiro passo é compilar o contrato Multiply7 em byte code, que pode ser enviado para a EVM. Para instalar o solc, o compilador do Solidity, siga a documentação do Solidity (opens in a new tab). (Você pode usar uma versão mais antiga do solc para corresponder à versão do compilador usada em nosso exemplo (opens in a new tab).)

O próximo passo é compilar o contrato Multiply7 para bytecode que pode ser enviado para a EVM.

echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin
======= <stdin>:Multiply7 =======
Binary:
6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029

Agora que temos o código compilado, precisamos determinar o quanto a sua implantação custará em gás. A interface RPC tem um método eth_estimateGas que nos dará uma estimativa.

curl --data '{"jsonrpc":"2.0","method": "eth_estimateGas", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 5}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":5,"result":"0x1c31e"}

Finalmente, implante o contrato.

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "gas": "0x1c31e", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 6}' -H "Content-Type: application/json" localhost:8545
{"id":6,"jsonrpc":"2.0","result":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"}

A transação é aceita pelo nó e um hash de transação é retornado. Esse hash pode ser usado para rastrear a transação. O próximo passo é determinar o endereço onde nosso contrato está implantado. Cada transação executada criará uma confirmação de recebimento. Essa confirmação de recebimento contém várias informações sobre a transação, como em qual bloco a transação foi incluída e quanto gás foi usado pela EVM. Se uma transação criar um contrato, ela também conterá o endereço do contrato. Podemos recuperar o recibo com o método eth_getTransactionReceipt da RPC.

curl --data '{"jsonrpc":"2.0","method": "eth_getTransactionReceipt", "params": ["0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"], "id": 7}' -H "Content-Type: application/json" localhost:8545
{"jsonrpc":"2.0","id":7,"result":{"blockHash":"0x77b1a4f6872b9066312de3744f60020cbd8102af68b1f6512a05b7619d527a4f","blockNumber":"0x1","contractAddress":"0x4d03d617d700cf81935d7f797f4e2ae719648262","cumulativeGasUsed":"0x1c31e","from":"0x9b1d35635cc34752ca54713bb99d38614f63c955","gasUsed":"0x1c31e","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf","transactionIndex":"0x0"}}

Nosso contrato foi criado em 0x4d03d617d700cf81935d7f797f4e2ae719648262. Um resultado nulo em vez de um recibo significa que a transação ainda não foi incluída em um bloco. Espere um momento e verifique se o termo de consentimento do cliente está ativo e tente novamente.

Interagindo com contratos inteligentes

Neste exemplo, enviaremos uma transação usando eth_sendTransaction para o método multiply do contrato.

eth_sendTransaction requer vários argumentos, especificamente from, to e data. From é o endereço público de nossa conta, e to é o endereço do contrato. O argumento data contém um payload que define qual método deve ser chamado e com quais argumentos. É aqui que a IAB (interface binária de aplicativo) (opens in a new tab) entra em jogo. A ABI é um arquivo JSON que estabelece como definir e codificar dados para a EVM.

Os bytes da carga definem qual método no contrato é chamado. Esses são os primeiros 4 bytes do hash Keccak sobre o nome da função e seus tipos de argumento, com codificação hexadecimal. A função multiplicar aceita um uint, que é um alias de uint256. Isso nos deixa com:

1web3.sha3("multiply(uint256)").substring(0, 10)
2// "0xc6888fa1"

O próximo passo é codificar os argumentos. Existe apenas um uint256, por exemplo, o valor 6. A ABI tem uma seção que especifica como codificar os tipos uint256.

int<M>: enc(X) é a codificação de complemento de dois big-endian de X, preenchida no lado de ordem superior (esquerdo) com 0xff para X negativo e com bytes zero para X positivo, de modo que o comprimento seja um múltiplo de 32 bytes.

Isso codifica para 0000000000000000000000000000000000000000000000000000000000000006.

Combinando o seletor de função e o argumento codificado, nossos dados serão 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006.

Isso agora pode ser enviado para o nó:

curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0xeb85a5557e5bdc18ee1934a89d8bb402398ee26a", "to": "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d", "data": "0xc6888fa10000000000000000000000000000000000000000000000000000000000000006"}], "id": 8}' -H "Content-Type: application/json" localhost:8545
{"id":8,"jsonrpc":"2.0","result":"0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74"}

Como uma transação foi enviada, um hash de transação foi retornado. A recuperação do recibo:

1{
2   blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
3   blockNumber: 268,
4   contractAddress: null,
5   cumulativeGasUsed: 22631,
6   gasUsed: 22631,
7   logs: [{
8      address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d",
9      blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",
10      blockNumber: 268,
11      data: "0x000000000000000000000000000000000000000000000000000000000000002a",
12      logIndex: 0,
13      topics: ["0x24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"],
14      transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
15      transactionIndex: 0
16  }],
17  transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
18  transactionIndex: 0
19}
Exibir tudo

O recibo contém um log. Esse log foi gerado pela EVM na execução da transação e incluído no recibo. A função multiply mostra que o evento Print foi acionado com a entrada multiplicada por 7. Como o argumento para o evento Print era um uint256, podemos decodificá-lo de acordo com as regras da IAB, o que nos deixará com o decimal esperado 42. Além dos dados, vale ressaltar que os tópicos podem ser usados para determinar qual evento criou o log:

1web3.sha3("Print(uint256)")
2// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"

Esta foi apenas uma breve introdução a algumas das tarefas mais comuns, demonstrando o uso direto do JSON-RPC.

Tópicos relacionados

• Especificação JSON-RPC (opens in a new tab)
• Nós e clientes
• APIs de JavaScript
• APIs de backend
• Clientes de execução