API di JSON-RPC

Affinché un'applicazione software interagisca con la blockchain di Ethereum, leggendo i dati della blockchain o inviando transazioni alla rete, deve connettersi a un nodo di Ethereum.

Per questo scopo, ogni client di Ethereum implementa una specifica JSON-RPC(opens in a new tab), quindi esiste un insieme uniforme di metodi cui le applicazioni possono affidarsi, indipendentemente dagli specifici nodi o implementazioni del client.

JSON-RPC(opens in a new tab) è un protocollo di chiamata a procedura remota (RPC) leggero e privo di stato. Definisce diverse strutture di dati e le regole per la loro elaborazione. È indipendente dal trasporto, poiché i concetti sono utilizzabili entro lo stesso processo, su prese, via HTTP o in svariati ambienti di passaggio dei messaggi. Usa JSON (RFC 4627) come formato dei dati.

Implementazioni del client

I client di Ethereum possono usare linguaggi di programmazione diversi per l'implementazione della specifica di JSON-RPC. Visualizza la documentazione dei singoli client per ulteriori dettagli sui linguaggi di programmazione specifici. Consigliamo di consultare la documentazione di ogni client per le informazioni più aggiornate sul supporto dell'API.

Librerie utili

Anche se è possibile scegliere di interagire direttamente con i client di Ethereum tramite l'API di JSON-RPC, spesso esistono opzioni più semplici per gli sviluppatori di dApp. Esistono molte librerie di JavaScript e dell'API del backend che forniscono wrapper sull'API di JSON-RPC. Con queste librerie, gli sviluppatori possono scrivere metodi intuitivi di una riga nel linguaggio di programmazione di loro scelta per inizializzare le richieste di JSON-RPC (sottostanti) che interagiscono con Ethereum.

API del client di consenso

Questa pagina tratta principalmente dell'API di JSON-RPC usata dai client di esecuzione di Ethereum. Tuttavia, anche i client del consenso hanno un'API RPC che consente agli utenti di interrogare le informazioni sul nodo, richiedere blocchi della Beacon, lo stato della Beacon e altre informazioni correlate al consenso, direttamente da un nodo. Questa API è documentata sulla pagina web dell'API Beacon(opens in a new tab).

Inoltre, un'API interna viene usata per la comunicazione tra client in un nodo, ovvero consente al client di consenso e al client di esecuzione di scambiarsi dati. Questa è detta "Engine API" e le specifiche sono disponibili su GitHub(opens in a new tab).

Specifiche del client di esecuzione

Leggi le specifiche complete dell'API JSON-RPC su GitHub(opens in a new tab).

Convenzioni

Codifica del valore esadecimale

Su JSON vengono passati due tipi di dati chiave: insiemi di byte non formattati e quantità. Entrambi vengono passati con una codifica esadecimale, ma con requisiti di formattazione differenti.

Quantità

Per la codifica delle quantità (interi, numeri): codifica come esadecimali, prefisso "0x", la rappresentazione più compatta (lieve eccezione: zero dovrebbe essere rappresentato come "0x0").

Ecco alcuni esempi:

• 0x41 (65 in decimale)
• 0x400 (1024 in decimale)
• ERRATO: 0x (dovrebbe sempre avere almeno una cifra: zero è "0x0")
• ERRATO: 0x0400 (nessuno zero iniziale consentito)
• ERRATO: ff (deve avere il prefisso 0x)

Dati non formattati

Codificando i dati non formattati (insiemi di dati, indirizzi dei conti, hash, insiemi di bytecode): codifica come esadecimali, prefisso "0x", due cifre esadecimali per byte.

Ecco alcuni esempi:

• 0x41 (dimensione 1, "A")
• 0x004200 (dimensione 3, "\0B\0")
• 0x (dimensione 0, "")
• ERRATO: 0xf0f0f (dev'essere un numero di cifre pari)
• ERRATO: 004200 (deve avere il prefisso 0x)

Il parametro del blocco predefinito

I seguenti metodi hanno un parametro del blocco predefinito aggiuntivo:

• eth_getBalance
• eth_getCode
• eth_getTransactionCount
• eth_getStorageAt
• eth_call

Quando sono effettuate richieste che agiscono sullo stato di Ethereum, il parametro dell'ultimo blocco predefinito determina l'altezza del blocco.

Le seguenti opzioni sono possibili per il parametro defaultBlock:

• HEX String - un numero intero del blocco
• String "earliest" per il primo blocco o quello di genesi
• String "latest" - per l'ultimo blocco estratto
• String "safe" - per l'ultimo blocco di testa sicuro
• String "finalized" - per l'ultimo blocco finalizzato
• String "pending" - per lo stato/le transazioni in sospeso

Esempi

Su questa pagina forniamo esempi su come usare gli endpoint individuali dell'API JSON_RPC usando lo strumento della riga di comando, curl(opens in a new tab). Questi esempi di endpoint individuali si trovano di seguito nella sezione esempi di Curl. In seguito nella pagina, forniamo anche un esempio completo per la compilazione e la distribuzione di un contratto intelligente usando un nodo di Geth, l'API JSON_RPC e curl.

Esempi di Curl

Di seguito sono riportati esempi dell'uso dell'API di JSON_RPC effettuando richieste di curl(opens in a new tab) a un nodo di Ethereum. Ogni esempio include una descrizione dell'endpoint specifico, i suoi parametri, il tipo di restituzione e un esempio definito di come dovrebbe essere utilizzato.

Le richieste di curl potrebbero restituire un messaggio d'errore correlato al tipo di contenuto. Ciò avviene perché l'opzione --data imposta il tipo di contenuto su application/x-www-form-urlencoded. Se il tuo nodo se ne lamenta, imposta manualmente l'intestazione posizionando -H "Content-Type: application/json" all'inizio della chiamata. Gli esempi, inoltre, non includono la combinazione di URL/IP e porta, che deve essere l'ultimo argomento fornito al curl (ad es. 127.0.0.1:8545). Una richiesta di curl completa, comprensiva di questi dati aggiuntivi, assume la seguente forma:

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

Gossip, Stato, Storico

Alcuni metodi base del protocollo JSON-RPC richiedono dati dalla rete di Ethereum e rientrano in tre importanti categorie:Gossip, Stato e Storico. Usa i collegamenti in questa sezione per passare da un metodo all'altro oppure usa la tabella di contenuti per esplorare l'intera lista di metodi.

Metodi di Gossip

Questi metodi tracciano la testa della catena. Ecco come le transazioni si fanno strada all'interno della rete ed entrano nei blocchi e come i Client fanno ricerche sui nuovi blocchi.

• eth_blockNumber
• eth_sendRawTransaction

Metodi di Stato

Metodi che indicano lo stato corrente di tutti i dati immagazzinati. Lo "stato" è come una grande porzione di RAM condivisa, che include i saldi dei conti, i dati dei contratti e le stime del gas.

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

Metodi dello Storico

Recupera lo storico dei record di ogni blocco fino alla genesi. Può essere paragonato a un grande file Append-Only contenente tutte le intestazioni del blocco, i corpi del blocco, i blocchi ommer (zio) e le ricevute delle transazioni.

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

I metodi dell'API JSON-RPC

web3_clientVersion

Restituisce la versione del client corrente.

Parametri

Nessuno

Restituisce

String - La versione del client corrente

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
3// Result
4{
5  "id":67,
6  "jsonrpc":"2.0",
7  "result": "Mist/v0.9.3/darwin/go1.4.1"
8}
9
 Copia

web3_sha3

Restituisce Keccak-256 (non lo SHA3-256 standardizzato) dei dati forniti.

Parametri

1. DATA - I dati da convertire in un hash SHA3

1params: ["0x68656c6c6f20776f726c64"]
2
 Copia

Restituisce

DATA - Il risultato di SHA3 della stringa data.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
3// Result
4{
5  "id":64,
6  "jsonrpc": "2.0",
7  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
8}
9
 Copia

net_version

Restituisce l'id di rete corrente.

Parametri

Nessuno

Restituisce

String - L'id di rete corrente.

L'elenco completo degli ID di rete correnti è disponibile su chainlist.org(opens in a new tab). Alcuni ID comuni sono:

• 1: Rete Principale di Ethereum
• 5: rete di prova Goerli
• 11155111: rete di prova Sepolia

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
3// Result
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "3"
8}
9
 Copia

net_listening

Restituisce true se il client sta ascoltando attivamente le connessioni di rete.

Parametri

Nessuno

Restituisce

Boolean - true quando è in ascolto, altrimenti false.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
3// Result
4{
5  "id":67,
6  "jsonrpc":"2.0",
7  "result":true
8}
9
 Copia

net_peerCount

Restituisce il numero di pari attualmente connessi al client.

Parametri

Nessuno

Restituisce

QUANTITY - intero del numero di pari connessi.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
3// Result
4{
5  "id":74,
6  "jsonrpc": "2.0",
7  "result": "0x2" // 2
8}
9
 Copia

eth_protocolVersion

Restituisce la versione corrente del protocollo di Ethereum. Si noti che questo metodo non è disponibile su Geth(opens in a new tab).

Parametri

Nessuno

Restituisce

String - La versione del protocollo di Ethereum corrente

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
3// Result
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "54"
8}
9
 Copia

eth_syncing

Restituisce un oggetto con i dati sullo stato di sincronizzazione o false.

Parametri

Nessuno

Restituisce

Object|Boolean, Un oggetto con i dati dello stato di sincronizzazione o FALSE, quando non è in sincronizzazione:

• startingBlock: QUANTITY - Il blocco in cui è iniziata l'importazione (si ripristina soltanto dopo che la sincronizzazione ha raggiunto la sua testa)
• currentBlock: QUANTITY - Il blocco corrente, uguale a eth_blockNumber
• highestBlock: QUANTITY - Il blocco più alto stimato

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": {
8    startingBlock: '0x384',
9    currentBlock: '0x386',
10    highestBlock: '0x454'
11  }
12}
13// Or when not syncing
14{
15  "id":1,
16  "jsonrpc": "2.0",
17  "result": false
18}
19
Mostra tutto
 Copia

eth_coinbase

Restituisce l'indirizzo di coinbase del client.

Parametri

Nessuno

Restituisce

DATA, 20 byte; l'indirizzo di coinbase corrente.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
3// Result
4{
5  "id":64,
6  "jsonrpc": "2.0",
7  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
8}
9
 Copia

eth_chainId

Restituisce l'ID della catena utilizzato per firmare le transazioni protette da riproduzione.

Parametri

Nessuno

Restituisce

chainId, valore esadecimale come stringa rappresentante l'intero dell'ID della catena corrente.

Esempio

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

eth_mining

Restituisce true se il client sta minando attivamente nuovi blocchi.

Parametri

Nessuno

Restituisce

Boolean - restituisce true se il client sta minando, altrimenti false.

Esempio

1// Request
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}
9
 Copia

eth_hashrate

Restituisce il numero di hash al secondo con cui il nodo sta minando.

Parametri

Nessuno

Restituisce

QUANTITY - numero di hash al secondo.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
3// Result
4{
5  "id":71,
6  "jsonrpc": "2.0",
7  "result": "0x38a"
8}
9
 Copia

eth_gasPrice

Restituisce il prezzo corrente del carburante in wei.

Parametri

Nessuno

Restituisce

QUANTITY - intero del prezzo corrente del carburante in wei.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
3// Result
4{
5  "id":73,
6  "jsonrpc": "2.0",
7  "result": "0x1dfd14000" // 8049999872 Wei
8}
9
 Copia

eth_accounts

Restituisce un elenco di indirizzi posseduti dal client.

Parametri

Nessuno

Restituisce

Array of DATA, 20 Byte; indirizzi posseduti dal client.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
8}
9
 Copia

eth_blockNumber

Restituisce il numero del blocco più recente.

Parametri

Nessuno

Restituisce

QUANTITY - intero del numero di blocco corrente su cui è attivo il client.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
3// Result
4{
5  "id":83,
6  "jsonrpc": "2.0",
7  "result": "0x4b7" // 1207
8}
9
 Copia

eth_getBalance

Restituisce il saldo del conto dell'indirizzo dato.

Parametri

1. DATA, 20 Byte - indirizzo per controllare il saldo.
2. QUANTITY|TAG - numero intero del blocco, o stringa "latest", "earliest" o "pending". Vedere il parametro predefinito del blocco

1params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]
2
 Copia

Restituisce

QUANTITY - intero del saldo corrente in wei.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x0234c8a3397aab58" // 158972490234375000
8}
9
 Copia

eth_getStorageAt

Restituisce il valore da una posizione di archiviazione a un dato indirizzo.

Parametri

1. DATA, 20 Bytes - Indirizzo di archiviazione.
2. QUANTITY - intero della posizione di archiviazione.
3. QUANTITY|TAG - numero intero del blocco, o stringa "latest", "earliest" o "pending". Vedere il parametro predefinito del blocco

Restituisce

DATA - il valore in questa posizione di archiviazione.

Esempio Il calcolo della posizione corretta dipende dall'archiviazione da recuperare. Considera il seguente contratto distribuito su 0x295a70b2de5e3953354a6a8344e616ed314d7251 dall'indirizzo 0x391694e7e0b0cce554cb130d723a9d27458f9298.

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

Recuperare il valore di pos0 è semplice:

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"}
3
 Copia

Recuperare un elemento della mappa è più difficile. La posizione di un elemento nella mappa è calcolata con:

1keccack(LeftPad32(key, 0), LeftPad32(map position, 0))
2
 Copia

Ciò significa che per recuperare l'archiviazione in pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] dobbiamo calcolare la posizione con:

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

La console geth che viene fornita con la libreria web3 può essere utilizzata per effettuare il calcolo:

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

A questo punto, per recuperare l'archiviazione:

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"}
3
 Copia

eth_getTransactionCount

Restituisce il numero di transazioni inviate da un indirizzo.

Parametri

1. DATA, 20 Bytes - indirizzo.
2. QUANTITY|TAG - numero intero del blocco, o stringa "latest", "earliest" o "pending". Vedere il parametro predefinito del blocco

1params: [
2  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
3  "latest", // state at the latest block
4]
5
 Copia

Restituisce

QUANTITY - Intero del numero di transazioni inviate da questo indirizzo.

Esempio

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

eth_getBlockTransactionCountByHash

Restituisce il numero di transazioni in un blocco da un blocco corrispondente al dato hash del blocco.

Parametri

1. DATA, 32 Byte - hash di un blocco

1params: ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"]
2
 Copia

Restituisce

QUANTITY - intero del numero di transazioni in questo blocco.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xb" // 11
8}
9
 Copia

eth_getBlockTransactionCountByNumber

Restituisce il numero di transazioni in un blocco corrispondente al numero di blocco specificato.

Parametri

1. QUANTITY|TAG - numero intero del blocco, o stringa "earliest", "latest" o "pending", come nel parametro predefinito del blocco.

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

Restituisce

QUANTITY - intero del numero di transazioni in questo blocco.

Esempio

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

eth_getUncleCountByBlockHash

Restituisce il numero di ommer in un blocco da un blocco corrispondente all'hash del blocco specificato.

Parametri

1. DATA, 32 Bytes - Hash di un blocco

1params: ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"]
2
 Copia

Restituisce

QUANTITY - intero del numero di ommer in questo blocco.

Esempio

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

eth_getUncleCountByBlockNumber

Restituisce il numero di ommer in un blocco da un blocco che corrisponde all'hash del blocco specificato.

Parametri

1. QUANTITY|TAG - intero del numero di blocco, o stringa "latest", "earliest" o "pending". Vedere il parametro predefinito del blocco

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

Restituisce

QUANTITY - intero del numero di ommer in questo blocco.

Esempio

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": "0x1" // 1
8}
9
 Copia

eth_getCode

Restituisce il codice ad un indirizzo specificato.

Parametri

1. DATA, 20 Bytes - indirizzo
2. QUANTITY|TAG - numero intero del blocco, o stringa "latest", "earliest" o "pending". Vedere il parametro predefinito del blocco

1params: [
2  "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
3  "0x2", // 2
4]
5
 Copia

Restituisce

DATA - il codice dall'indirizzo specificato.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x2"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x600160008035811a818181146012578301005b601b6001356025565b8060005260206000f25b600060078202905091905056"
8}
9
 Copia

eth_sign

Il metodo della firma calcola una firma specifica di Ethereum con: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).

Aggiungendo un prefisso al messaggio si rende la firma calcolata riconoscibile come firma specifica di Ethereum. Ciò impedisce l'uso improprio in cui una dapp malevola può firmare i dati arbitrari (es. la transazione) e usare la firma per impersonare la vittima.

Nota: l'indirizzo con cui firmare deve essere sbloccato.

Parametri

1. DATA, 20 Bytes - indirizzo
2. DATA, N Byte - messaggio da firmare

Restituisce

DATA: Firma

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}
9
 Copia

eth_signTransaction

Firma una transazione che può essere inviata alla rete in un secondo momento utilizzando eth_sendRawTransaction.

Parametri

1. Object - L'oggetto della transazione

• from: DATI, 20 Bytes - L'indirizzo da cui viene inviata la transazione.
• to: DATI, 20 Bytes - (opzionale quando si crea un nuovo contratto) L'indirizzo a cui è indirizzata la transazione.
• gas: QUANTITY: (facoltativo, prededfinito: 90000) Intero del gas fornito per l'esecuzione della transazione. Restituirà il gas inutilizzato.
• gasPrice: QUANTITY - (facoltativo, predefinito: To-Be-Determined) Intero del gasPrice usato per ogni unità di carburante pagata, in Wei.
• value: QUANTITY - (facoltativo) Intero del valore inviato con questa transazione, in Wei.
• data: DATI - Il codice compilato di un contratto OPPURE l'hash della firma del metodo richiamato e i parametri codificati.
• nonce: QUANTITÀ - (opzionale) Intero di una nonce. Questo permette di sovrascrivere le tue transazioni in sospeso che utilizzano la stessa nonce.

Restituisce

DATA, L'oggetto della transazione firmato.

Esempio

1// Request
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// Result
4{
5    "id": 1,
6    "jsonrpc": "2.0",
7    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}
9
 Copia

eth_sendTransaction

Se il campo dati contiene codice, crea una nuova transazione di chiamata di messaggio o la stipula di un contratto.

Parametri

1. Oggetto - L'oggetto della transazione

• from: DATA, 20 Bytes - L'indirizzo da cui viene inviata la transazione.
• to: DATA, 20 Bytes - (opzionale quando si crea un nuovo contratto) L'indirizzo a cui è indirizzata la transazione.
• gas: QUANTITY - (facoltativo, predefinito: 90000) Intero del carburante fornito per l'esecuzione della transazione. Restituirà il carburante inutilizzato.
• gasPrice: QUANTITY - (facoltativo, predefinito: To-Be-Determined) Intero del gasPrice usato per ogni unità di carburante pagata.
• value: QUANTITY - (facoltativo) Intero del valore inviato con questa transazione, in Wei.
• data: DATA - Il codice compilato di un contratto OPPURE l'hash della firma del metodo richiamato e i parametri codificati.
• nonce: QUANTITY - (facoltativo) Intero di un nonce. Ciò permette di sovrascrivere le proprie transazioni in sospeso che utilizzano lo stesso nonce.

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

Restituisce

DATI, 32 Bytes - l'hash della transazione, o l'hash zero se la transazione non è ancora disponibile.

Usa eth_getTransactionReceipt quando hai creato un contratto per ottenere l'indirizzo del contratto, dopo che la transazione è stata minata.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}
9
 Copia

eth_sendRawTransaction

Crea una nuova transazione di chiamata di messaggio o la stipula di un contratto, per le transazioni firmate.

Parametri

1. DATA, L'oggetto transazione firmato.

1params: [
2  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
3]
4
 Copia

Restituisce

DATA, 32 Bytes - l'hash della transazione, o l'hash zero se la transazione non è ancora disponibile.

Usa eth_getTransactionReceipt quando hai creato un contratto per ottenere l'indirizzo del contratto dopo che la transazione è stata minata.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}
9
 Copia

eth_call

Esegue immediatamente una nuova chiamata di messaggio senza creare una transazione nella blockchain.

Parametri

1. Object - L'oggetto della chiamata della transazione

• from: DATA, 20 Bytes - (facoltativo) L'indirizzo da cui viene inviata la transazione.
• to: DATA, 20 Bytes - L'indirizzo a cui è indirizzata la transazione.
• gas: QUANTITY - (facoltativo) Intero del carburante fornito per l'esecuzione della transazione. eth_call consuma zero carburante, ma questo parametro potrebbe essere necessario per alcune esecuzioni.
• gasPrice: QUANTITY - (facoltativo) Intero del gasPrice usato per ogni unità di carburante pagata
• value: QUANTITY - (facoltativo) Intero del valore inviato con questa transazione
• data: DATA - (facoltativo) Hash della firma del metodo e dei parametri codificati. Per maggiori dettagli consulta Ethereum Contract ABI nella documentazione di Solidity(opens in a new tab)

2. QUANTITY|TAG - numero intero del blocco, o stringa "latest", "earliest" o "pending". Vedere il parametro predefinito del blocco

Restituisce

DATA - Il valore di ritorno del contratto eseguito.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x"
8}
9
 Copia

eth_estimateGas

Genera e restituisce una stima di quanto carburante è necessario per consentire il completamento della transazione. La transazione non verrà aggiunta alla blockchain. Nota che la stima potrebbe esser significativamente superiore all'importo di carburante effettivamente usato dall'operazione, per vari motivi, incluse le meccaniche dell'EVM e le prestazioni del nodo.

Parametri

Vedi i parametri di eth_call, tranne che tutte le proprietà sono facoltative. Se non è specificato alcun limite di carburante, geth usa il limite di carburante del blocco dal blocco in sospeso come limite massimo. Di conseguenza, la stima restituita potrebbe non esser sufficiente per eseguire la chiamata/transazione quando l'importo di carburante è superiore al limite di carburante del blocco.

Restituisce

QUANTITY - la quantità di carburante utilizzato.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x5208" // 21000
8}
9
 Copia

eth_getBlockByHash

Restituisce informazioni su un blocco tramite hash.

Parametri

1. DATA, 32 Byte - Hash di un blocco.
2. Boolean - Se true restituisce gli oggetti di transazione completi, se falso solo gli hash delle transazioni.

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

Restituisce

Object - Un oggetto blocco, o null quando non viene trovato alcun blocco:

• number: QUANTITY - il numero di blocco. null quando è in attesa del blocco.
• hash: DATA, 32 Bytes - hash del blocco. null quando è in attesa del blocco.
• hash: DATA, 32 Bytes - hash del blocco genitore.
• nonce: DATA, 8 Bytes - hash del proof-of-work generato. null quando è in attesa del blocco.
• sha3Uncles: DATA, 32 Bytes - SHA3 dei dati ommer del blocco.
• logsBloom: DATA, 256 Bytes - il filtro bloom per i registri del blocco. null quando è in attesa del blocco.
• transactionsRoot: DATA, 32 Bytes - la radice dell'albero delle transazioni del blocco.
• stateRoot: DATA, 32 Bytes - la radice dell'albero di stato finale del blocco.
• receiptsRoot: DATA, 32 Bytes - la radice dell'albero delle ricevute del blocco.
• miner: DATA, 20 Bytes - l'indirizzo del beneficiario a cui sono state fornite le ricompense di mining.
• difficulty: QUANTITY - intero della difficoltà per questo blocco.
• totalDifficulty: QUANTITY - intero della difficoltà totale della catena fino a questo blocco.
• extraData: DATA - il campo "dati extra" di questo blocco.
• size: QUANTITY - intero in bytes della dimensione di questo blocco.
• gasLimit: QUANTITY - il carburante massimo consentito in questo blocco.
• gasUsed: QUANTITY - il carburante totale usato da tutte le transazioni in questo blocco.
• timestamp: QUANTITY - la marca temporale unix relativa a quando il blocco è stato collazionato.
• transactions: Array - Array di oggetti transazione, o hash di transazione da 32 Bytes a seconda dell'ultimo parametro specificato.
• uncles: Array - Array di hash ommer.

Esempio

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

eth_getBlockByNumber

Restituisce informazioni su un blocco per numero di blocco.

Parametri

1. QUANTITY|TAG - numero intero del blocco, o stringa "earliest", "latest" o "pending", come nel parametro predefinito del blocco.
2. Boolean - Se true restituisce gli oggetti di transazione completi, se falso solo gli hash delle transazioni.

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

Restituisce Vedi eth_getBlockByHash

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'
3
 Copia

Risultato vedi eth_getBlockByHash

eth_getTransactionByHash

Restituisce le informazioni su una transazione richiesta dall'hash della transazione.

Parametri

1. DATA, 32 Bytes - hash di una transazione

1params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]
2
 Copia

Restituisce

Object - Un oggetto transazione, oppure null quando non viene trovata alcuna transazione:

• blockHash: DATA, 32 byte - hash del blocco in cui si trovava questa transazione. null quando è in sospeso.
• blockNumber: QUANTITY - numero di blocco in cui si trovava questa transazione. null quando è in sospeso.
• from: DATA, 20 Bytes - indirizzo del mittente.
• gas: QUANTITY - carburante fornito dal mittente.
• gasPrice: QUANTITY - prezzo del carburante fornito dal mittente in Wei.
• hash: DATA, 32 Bytes - hash della transazione.
• input: DATA - i dati inviati insieme alla transazione.
• nonce: QUANTITY - il numero di transazioni effettuate dal mittente prima di questa.
• to: DATA, 20 Bytes - l'indirizzo del destinatario. null quando è una transazione di creazione del contratto.
• transactionIndex: QUANTITY - intero della posizione dell'indice delle transazioni nel blocco. null quando è in sospeso.
• value: QUANTITY - valore trasferito in Wei.
• v: QUANTITY - ID di recupero ECDSA
• r: QUANTITY - firma r ECDSA
• s: QUANTITY - firma s ECDSA

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
3// Result
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}
24
Mostra tutto
 Copia

eth_getTransactionByBlockHashAndIndex

Restituisce informazioni su una transazione per hash del blocco e posizione dell'indice della transazione.

Parametri

1. DATA, 32 Byte - hash di un blocco.
2. QUANTITY - intero della posizione dell'indice della transazione.

1params: [
2  "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
3  "0x0", // 0
4]
5
 Copia

Restituisce Vedi eth_getTransactionByHash

Esempio

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

Risultato vedi eth_getBlockByHash

eth_getTransactionByBlockNumberAndIndex

Restituisce informazioni su una transazione per hash del blocco e posizione dell'indice della transazione.

Parametri

1. QUANTITY|TAG - intero del blocco, o stringa "earliest", "latest" oppure "pending", come nel parametro predefinito del blocco.
2. QUANTITY - la posizione dell'indice della transazione.

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

Restituisce Vedi eth_getTransactionByHash

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'
3
 Copia

Risultato vedi eth_getBlockByHash

eth_getTransactionReceipt

Restituisce la ricevuta di una transazione tramite l'hash di transazione.

Nota che la ricevuta non è disponibile per le transazioni in sospeso.

Parametri

1. DATA, 32 Bytes - hash di una transazione

1params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]
2
 Copia

Restituisce Object - Un oggetto ricevuta della transazione, o null quando non è stata trovata nessuna ricevuta:

• transactionHash: DATA, 32 Bytes - hash della transazione.
• transactionIndex: QUANTITY - intero della posizione dell'indice delle transazioni nel blocco.
• blockHash: DATA, 32 byte - hash del blocco in cui si trovava questa transazione.
• blockNumber: QUANTITY - numero di blocco in cui si trovava questa transazione.
• from: DATA, 20 Bytes - indirizzo del mittente.
• to: DATA, 20 Bytes - l'indirizzo del destinatario. null quando è una transazione di creazione del contratto.
• cumulativeGasUsed: QUANTITY - La quantità totale di carburante usato nel blocco per l'esecuzione della transazione.
• effectiveGasPrice : QUANTITY - La somma della commissione di base e delle mance pagata per unità di carburante.
• gasUsed: QUANTITY - La quantità di carburante usato solo da questa specifica transazione.
• contractAddress: DATA, 20 Bytes - L'indirizzo del contratto creato, se la transazione consisteva nella creazione di un contratto, altrimenti null.
• logs: Array - Array di oggetti di registro generati da questa transazione.
• logsBloom: DATA, 256 Bytes - Filtro Bloom per i client leggeri per recuperare rapidamente i registri correlati.
• type: QUANTITY - intero del tipo di transazione, 0x0 per le transazioni ereditarie, 0x1 per i tipi di elenco d'accesso, 0x2 per le commissioni dinamiche. Restituisce anche in alternativa:
• root : DATA 32 bytes dello stateroot post-transazione (pre Byzantium)
• status: QUANTITY o 1 (successo) o 0 (insuccesso)

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'
3// Result
4{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "result": {
8    "blockHash":
9      "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",
10    "blockNumber": "0xeff35f",
11    "contractAddress": null, // string of the address if it was created
12    "cumulativeGasUsed": "0xa12515",
13    "effectiveGasPrice": "0x5a9c688d4",
14    "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",
15    "gasUsed": "0xb4c8",
16    "logs": [{
17      // logs as returned by getFilterLogs, etc.
18    }],
19    "logsBloom": "0x00...0", // 256 byte bloom filter
20    "status": "0x1",
21    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
22    "transactionHash":
23      "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",
24    "transactionIndex": "0x66",
25    "type": "0x2"
26  }
27}
28
Mostra tutto
 Copia

eth_getUncleByBlockHashAndIndex

Restituisce informazioni su un ommer di un blocco in base all'hash e alla posizione dell'indice dell'ommer.

Parametri

1. DATA, 32 Byte - hash di un blocco.
2. QUANTITY - La posizione dell'indice dell'ommer.

1params: [
2  "0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b",
3  "0x0", // 0
4]
5
 Copia

Restituisce Vedi eth_getBlockByHash

Esempio

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

Risultato vedi eth_getBlockByHash

Nota: Un ommer non contiene transazioni individuali.

eth_getUncleByBlockNumberAndIndex

Restituisce informazioni su un ommer di un blocco in base al numero e alla posizione dell'indice dell'ommer.

Parametri

1. QUANTITY|TAG - intero del blocco, o stringa "earliest", "latest" oppure "pending", come nel parametro predefinito del blocco.
2. QUANTITY - la posizione dell'indice dell'ommer.

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

Restituisce Vedi eth_getBlockByHash

Nota: Un ommer non contiene transazioni individuali.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'
3
 Copia

Risultato vedi eth_getBlockByHash

eth_getCompilers

Restituisce un elenco di compilatori disponibili nel client.

Parametri Nessuno

Restituisce Array - Array dei compilatori disponibili.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCompilers","params":[],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": ["solidity", "lll", "serpent"]
8}
9
 Copia

eth_compileSolidity

Restituisce il codice Solidity compilato.

Parametri

1. Stringa - Il codice sorgente.

1params: [
2  "contract test { function multiply(uint a) returns(uint d) {   return a * 7;   } }",
3]
4
 Copia

Restituisce DATA - Il codice sorgente compilato.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_compileSolidity","params":["contract test { function multiply(uint a) returns(uint d) {   return a * 7;   } }"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": {
8      "code": "0x605880600c6000396000f3006000357c010000000000000000000000000000000000000000000000000000000090048063c6888fa114602e57005b603d6004803590602001506047565b8060005260206000f35b60006007820290506053565b91905056",
9      "info": {
10        "source": "contract test {\n   function multiply(uint a) constant returns(uint d) {\n       return a * 7;\n   }\n}\n",
11        "language": "Solidity",
12        "languageVersion": "0",
13        "compilerVersion": "0.9.19",
14        "abiDefinition": [
15          {
16            "constant": true,
17            "inputs": [
18              {
19                "name": "a",
20                "type": "uint256"
21              }
22            ],
23            "name": "multiply",
24            "outputs": [
25              {
26                "name": "d",
27                "type": "uint256"
28              }
29            ],
30            "type": "function"
31          }
32        ],
33        "userDoc": {
34          "methods": {}
35        },
36        "developerDoc": {
37          "methods": {}
38        }
39      }
40}
41
Mostra tutto
 Copia

eth_compileLLL

Restituisce il codice LLL compilato.

Parametri

1. String - Il codice sorgente.

1params: ["(returnlll (suicide (caller)))"]
2
 Copia

Restituisce DATA - Il codice sorgente compilato.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_compileLLL","params":["(returnlll (suicide (caller)))"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x603880600c6000396000f3006001600060e060020a600035048063c6888fa114601857005b6021600435602b565b8060005260206000f35b600081600702905091905056" // the compiled source code
8}
9
 Copia

eth_compileSerpent

Restituisce il codice Serpent compilato.

Parametri

1. String - Il codice sorgente.

1params: ["/* some serpent */"]
2
 Copia

Restituisce DATA - Il codice sorgente compilato.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_compileSerpent","params":["/* some serpent */"],"id":1}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x603880600c6000396000f3006001600060e060020a600035048063c6888fa114601857005b6021600435602b565b8060005260206000f35b600081600702905091905056" // the compiled source code
8}
9
 Copia

eth_newFilter

Crea un oggetto filtro, basato sulle opzioni di filtro, per notificare quando lo stato cambia (registri). Per verificare se lo stato è cambiato, chiama eth_getFilterChanges.

Una nota per specificare i filtri degli argomenti: Gli argomenti dipendono dall'ordine. Una transazione con un registro con argomenti [A, B] sarà abbinata ai seguenti filtri tematici:

• [] "qualsiasi"
• [A]: "A in prima posizione (e tutto il resto segue)"
• [null, B]: "tutto nella prima posizione AND B nella seconda (e tutto il resto segue)"
• [A, B]: "A in prima posizione AND B in seconda (e tutto il resto segue)"
• [[A, B], [A, B]]: "(A OR B) in prima posizione AND (A OR B) in seconda posizione (e tutto il resto segue)"
• Parametri

1. Object - Le opzioni di filtro:

• fromBlock: QUANTITY|TAG - (facoltativo, predefinito: "latest") Intero del numero di blocco, oppure "latest" per l'ultimo blocco minato oppure "pending", "earliest" per le transazioni non ancora minate.
• toBlock: QUANTITY|TAG - (facoltativo, predefinito: "latest") Intero del numero di blocco, oppure "latest" per l'ultimo blocco minato, oppure "pending", "earliest" per le transazioni non ancora minate.
• address: DATA|Array, 20 Bytes - (facoltativo) Indirizzo del contratto oppure un elenco di indirizzi da cui dovrebbero avere origine i registri.
• topics: Array of DATA, - (facoltativo) Array di argomenti DATA a 32 byte. Gli argomenti dipendono dall'ordine. Ogni argomento può anche essere un array di DATI con opzioni "or".

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]
16
Mostra tutto
 Copia

Restituisce QUANTITY - L'ID di un filtro.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": "0x1" // 1
8}
9
 Copia

eth_newBlockFilter

Crea un filtro nel nodo, per notificare quando arriva un nuovo blocco. Per verificare se lo stato è cambiato, chiama eth_getFilterChanges.

Parametri Nessuno

Restituisce QUANTITY - L'ID di un filtro.

Esempio

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

eth_newPendingTransactionFilter

Crea un filtro nel nodo, per avvisare quando arrivano nuove transazioni in sospeso. Per verificare se lo stato è cambiato, chiama eth_getFilterChanges.

Parametri Nessuno

Restituisce QUANTITY - L'ID di un filtro.

Esempio

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

eth_uninstallFilter

Disinstalla un filtro con un ID specificato. Dovrebbe essere sempre chiamato quando l'orologio non è più necessario. Inoltre, i filtri scadono quando non vengono richiesti con eth_getFilterChanges per un periodo di tempo.

Parametri

1. QUANTITY - L'ID del filtro.

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

Restituisce Boolean - true se il filtro è stato disinstallato con successo, altrimenti false.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc": "2.0",
7  "result": true
8}
9
 Copia

eth_getFilterChanges

Metodo di sondaggio per un filtro, che restituisce un array di registri che si sono verificati dall'ultimo sondaggio.

Parametri

1. QUANTITY - L'ID del filtro.

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

Restituisce Array - Array di oggetti registro, o un array vuoto se nulla è cambiato dall'ultimo sondaggio.

• Per i filtri creati con eth_newBlockFilter vengono restituiti hash di blocco (DATA, 32 Byte), ad esempio ["0x3454645634534..."].
• Per i filtri creati con eth_newPendingTransactionFiltro vengono restituiti hash di transazione (DATA, 32 Bytes), ad esempio ["0x6345343454645..."].
• Per i filtri creati con eth_newFiltro i registri sono oggetti con i seguenti parametri:
  • removed: TAG - true quando il registro è stato rimosso, a causa di una riorganizzazione della catena. false se il suo registro è valido.
  • transactionIndex: QUANTITY - intero della posizione dell'indice della transazione nel blocco. null quando il registro è in sospeso.
  • transactionIndex: QUANTITY - intero del registro della posizione dell'indice della transazione da cui è stato creato. null quando il registro è in sospeso.
  • transactionHash: DATA, 32 Bytes - hash delle transazioni da cui è stato creato il registro. null quando il registro è in sospeso.
  • blockHash: DATA, 32 byte - hash del blocco in cui si trovava questa transazione. null quando è in sospeso. null quando il registro è in sospeso.
  • blockNumber: QUANTITY il numero di blocco in cui si trovava questo registro. null quando è in sospeso. null quando il registro è in sospeso.
  • address: DATA, 20 Bytes - indirizzo da cui è stato originato questo registro.
  • data: DATA - contiene uno o più argomenti a 32 byte non indicizzati del registro.
  • topics: Array of DATA - Array da 0 a 432 byte di DATA di argomenti di registri indicizzati. (In solidity: il primo argomento è l'hash della firma dell'evento (ad es. Deposit(address,bytes32,uint256)), tranne se hai dichiarato l'evento con lo specificatore anonymous.)
• Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'
3// Result
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}
20
Mostra tutto
 Copia

eth_getFilterLogs

Restituisce un array di tutti i registri corrispondenti al filtro con un dato ID.

Parametri

1. QUANTITY - L'ID del filtro.

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

Restituisce Vedi eth_getBlockByHash

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'
3
 Copia

Risultato vedi eth_getFilterChanges

eth_getLogs

Restituisce un array di tutti i registri che corrispondono a un dato oggetto filtro.

Parametri

1. Oggetto - Le opzioni di filtro:

• fromBlock: QUANTITY|TAG - (facoltativo, predefinito: "latest") Intero del numero di blocco, oppure "latest" per l'ultimo blocco minato oppure "pending", "earliest" per le transazioni non ancora minate.
• toBlock: QUANTITY|TAG - (facoltativo, predefinito: "latest") Intero del numero di blocco, oppure "latest" per l'ultimo blocco minato, oppure "pending", "earliest" per le transazioni non ancora minate.
• address: DATA|Array, 20 Bytes - (facoltativo) Indirizzo del contratto oppure un elenco di indirizzi da cui dovrebbero avere origine i registri.
• topics: Array of DATA, - (facoltativo) Array di argomenti DATA a 32 byte. Gli argomenti dipendono dall'ordine. Ogni argomento può anche essere un array di DATI con opzioni "or".
• blockhash: DATI, 32 Bytes - (facoltativo, future) Con l'aggiunta di EIP-234, blockHash sarà una nuova opzione di filtro che limita i registra restituiti al singolo blocco con l'hash blockHash da 32 byte. L'utilizzo di blockHash equivale a fromBlock = toBlock = il numero di blocco con hash blockHash. Se blockHash è presente nei criteri di filtraggio, non sono permessi né fromBlock né toBlock.

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

Restituisce Vedi eth_getBlockByHash

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'
3
 Copia

Risultato vedi eth_getFilterChanges

eth_getWork

Restituisce l'hash del blocco corrente, il seedHash e la condizione di confine da soddisfare ("target").

Parametri Nessuno

Restituisce Array - Array con le seguenti proprietà:

1. DATA, 32 Byte - intestazione pow-hash del blocco corrente
2. DATA, 32 Byte - il seed hash utilizzato per il DAG.
3. DATA, 32 Byte - la condizione di confine ("target"), 2^256 / difficoltà.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getWork","params":[],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": [
8      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
9      "0x5EED00000000000000000000000000005EED0000000000000000000000000000",
10      "0xd1ff1c01710000000000000000000000d1ff1c01710000000000000000000000"
11    ]
12}
13
Mostra tutto
 Copia

eth_submitWork

Utilizzato per presentare una soluzione proof-of-work.

Parametri

1. DATA, 8 Byte - Il nonce trovato (64 bit)
2. DATA, 32 Byte - il pow-hash dell'intestazione (256 bit)
3. DATA, 32 Byte - Il mix digest (256 bit)

1params: [
2  "0x0000000000000001",
3  "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
4  "0xD1FE5700000000000000000000000000D1FE5700000000000000000000000000",
5]
6
 Copia

Restituisce Boolean - restituisce true se la soluzione fornita è valida, altrimenti false.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0", "method":"eth_submitWork", "params":["0x0000000000000001", "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", "0xD1GE5700000000000000000000000000D1GE5700000000000000000000000000"],"id":73}'
3// Result
4{
5  "id":73,
6  "jsonrpc":"2.0",
7  "result": true
8}
9
 Copia

eth_submitHashrate

Usato per inviare hashrate di mining.

Parametri

1. Hashrate, una rappresentazione esadecimale della stringa (32 byte) dell'hashrate
2. ID, Stringa - Un ID esadecimale casuale (32 byte) che identifica il client

1params: [
2  "0x0000000000000000000000000000000000000000000000000000000000500000",
3  "0x59daa26581d0acd1fce254fb7e85952f4c09d0915afd33d3886cd914bc7d283c",
4]
5
 Copia

Restituisce Boolean - restituisce true se l'invio è andato a buon fine e falso in caso contrario.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0", "method":"eth_submitHashrate", "params":["0x0000000000000000000000000000000000000000000000000000000000500000", "0x59daa26581d0acd1fce254fb7e85952f4c09d0915afd33d3886cd914bc7d283c"],"id":73}'
3// Result
4{
5  "id":73,
6  "jsonrpc":"2.0",
7  "result": true
8}
9
 Copia

db_putString (deprecated)

Memorizza una stringa nel database locale.

Nota questa funzione è superata.

Parametri

1. String - Nome del database.
2. String - Nome della chiave.
3. String - Stringa da archiviare.

1params: ["testDB", "myKey", "myString"]
2
 Copia

Restituisce Boolean - true se il valore è stato memorizzato, altrimenti false.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"db_putString","params":["testDB","myKey","myString"],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": true
8}
9
 Copia

db_getString (deprecated)

Memorizza una stringa nel database locale. Nota questa funzione è superata.

Parametri

1. String - Nome del database.
2. String - Nome della chiave.

1params: ["testDB", "myKey"]
2
 Copia

Restituisce String - La stringa precedentemente memorizzata.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"db_getString","params":["testDB","myKey"],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": "myString"
8}
9
 Copia

db_putHex (deprecated)

Memorizza i dati binari nel database locale. Nota questa funzione è superata.

Parametri

1. String - Nome del database.
2. String - Nome della chiave.
3. DATA - I dati da archiviare.

1params: ["testDB", "myKey", "0x68656c6c6f20776f726c64"]
2
 Copia

Restituisce Boolean - true se il valore è stato memorizzato, altrimenti false.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"db_putHex","params":["testDB","myKey","0x68656c6c6f20776f726c64"],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": true
8}
9
 Copia

db_getHex (deprecated)

Restituisce i dati binari del database locale. Nota questa funzione è superata.

Parametri

1. String - Nome del database.
2. String - Nome della chiave.

1params: ["testDB", "myKey"]
2
 Copia

Restituisce DATA - I dati precedentemente memorizzati.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"db_getHex","params":["testDB","myKey"],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": "0x68656c6c6f20776f726c64"
8}
9
 Copia

shh_version (deprecated)

Restituisce la versione corrente del protocollo Whisper.

Nota questa funzione è superata.

Parametri Nessuno

Restituisce Stringa - La versione corrente del protocollo Whisper

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"shh_version","params":[],"id":67}'
3// Result
4{
5  "id":67,
6  "jsonrpc": "2.0",
7  "result": "2"
8}
9
 Copia

shh_post (deprecated)

Invia un messaggio Whisper.

Nota questa funzione è superata.

Parametri

1. Object -Il contenuto dei post di Whisper:

• da: DATA, 60 Byte - (facoltativo) L'identità del mittente.
• to: DATA, 60 Byte - (facoltativo) L'identità del destinatario. Se presente, Whisper cifrerà il messaggio in modo che solo il destinatario possa decifrarlo.
• topics: Array of DATA - Array di argomenti DATA, affinché il destinatario possa identificare i messaggi.
• payload: DATA - Il payload del messaggio.
• priority: QUANTITY - L'intero della priorità in un range da ... (?).
• ttl: QUANTITY - intero del tempo residuo in secondi.

1params: [
2  {
3    from: "0x04f96a5e25610293e42a73908e93ccc8c4d4dc0edcfa9fa872f50cb214e08ebf61a03e245533f97284d442460f2998cd41858798ddfd4d661997d3940272b717b1",
4    to: "0x3e245533f97284d442460f2998cd41858798ddf04f96a5e25610293e42a73908e93ccc8c4d4dc0edcfa9fa872f50cb214e08ebf61a0d4d661997d3940272b717b1",
5    topics: [
6      "0x776869737065722d636861742d636c69656e74",
7      "0x4d5a695276454c39425154466b61693532",
8    ],
9    payload: "0x7b2274797065223a226d6",
10    priority: "0x64",
11    ttl: "0x64",
12  },
13]
14
Mostra tutto
 Copia