API di JSON-RPC

Ultima modifica: , Invalid DateTime

Visualizza chi ha contribuito

Modifica la pagina

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.

A tale scopo, ogni client di Ethereum implementa una specifica JSON-RPC, in modo che sia disponibile un insieme di metodi uniformi a cui possono affidarsi le applicazioni, indipendentemente dal nodo specifico o dall'implementazione del client.

JSON-RPC è 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.

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.

Specifiche del client di esecuzione

Leggi le specifiche complete dell'API JSON-RPC su GitHub.

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 "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. 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 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. Alcuni ID comuni sono: 1: Mainnet di Ethereum 2: Testnet di Morden (ora deprecata) 3: Testnet di Ropsten 4: Testnet di Rinkeby 5: Testnet di Goerli

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 del protocollo di Ethereum corrente.

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_mining

Restituisce true se il client sta minando attivamente i 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 gas in wei.

Parametri

Nessuno

Restituisce

QUANTITY: intero del prezzo corrente del gas 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 della stringa "latest", "earliest" or "pending", vedi il parametro del blocco predefinito

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 nella posizione di archiviazione.
3. QUANTITY|TAG - Numero di blocco intero o stringa"latest", "earliest" o "pending". Vedi il parametro di blocco predefinito

Restituisce

DATA - Il valore in questa posizione di archiviazione.

Esempio Il calcolo della posizione corretta dipende dalla memoria 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 lo storage su 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 lo spazio di 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". Vedi il parametro del blocco predefinito

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 "latest", "earliest" o "pending". Vedi il parametro del blocco predefinito.

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 - Il numero intero 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 - Il numero intero 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 la stringa "latest", "earliest" o "pending". Vedere il parametro del blocco predefinito

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

Restituisce

DATI - 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. DATI, N Byte - messaggio da firmare

Restituisce

DATI: 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. Oggetto - 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: QUANTITÀ: (facoltativo, predefinito: 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 gas pagato, in Wei.
• value: QUANTITÀ - (opzionale) 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. Ciò permette di sovrascrivere le proprie transazioni in sospeso che utilizzano la stessa nonce.

Restituisce

DATI, 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 il codice, crea una nuova transazione via messaggio o la stipula di un contratto.

Parametri

1. Oggetto - 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 gas pagato.
• value: QUANTITÀ - (opzionale) 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.

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

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

Parametri

1. DATA, L'oggetto transazione firmato.

1params: [
2  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
3]
4
 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_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 un nuovo messaggio di chiamata senza creare una transazione nella catena di blocchi.

Parametri

1. Oggetto - L'oggetto della chiamata della transazione

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

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 gas è 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 gas effettivamente usato dall'operazione, per vari motivi, incluse le meccaniche dell'EVM e le prestazioni del nodo.

Parametri

Vedi i parametri eth_call, tutte le proprietà dovrebbero essere opzionali. Se non è specificato alcun limite di gas, geth usa il limite di gas 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 gas è maggiore del limite di gas del blocco.

Restituisce

QUANTITY: l'importo di gas 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

Oggetto - 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 padre.
• 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 Bloom Filter 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: DATI, 32 Bytes - la radice dell'albero delle ricevute del blocco.
• miner: DATI, 20 Bytes - l'indirizzo del beneficiario a cui sono state fornite le ricompense di mining.
• difficoltà: QUANTITÀ - 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 gas massimo consentito in questo blocco.
• gasUsed: QUANTITY: il gas totale usato da tutte le transazioni in questo blocco.
• timestamp: QUANTITY - la marca temporale unix relativa a quando il blocco è stato collazionato.
• transactions: Array - Matrice di oggetti transazione o hash di transazione da 32 byte a seconda dell'ultimo parametro specificato.
• uncles: Array - Matrice di ommer hash.

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" oppure "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

Oggetto - Un oggetto di 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 - l'indirizzo del mittente.
• gas: QUANTITY: gas fornito dal mittente.
• gasPrice: QUANTITY: prezzo del gas 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 delle transazioni.

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 delle transazioni.

Parametri

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

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 ricezione 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: ["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"]
2
 Copia

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

• transactionHash: DATA, 32 Bytes - hash della transazione.
• transactionIndex: QUANTITY - numero 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 - l'indirizzo del mittente.
• to: DATA, 20 Bytes - l'indirizzo del destinatario. null quando è una transazione di creazione del contratto.
• cumulativeGasUsed: QUANTITY: L'importo totale di gas usato all'esecuzione nel blocco di questa transazione.
• gas Usato: QUANTITÀ: L'importo di gas 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 che questa transazione ha generato.
• logsBloom: DATA, 256 Bytes - Filtro Bloom per i client leggeri per recuperare rapidamente i log correlati. Restituisce anche either:
• 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":["0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238"],"id":1}'
3// Result
4{
5"id":1,
6"jsonrpc":"2.0",
7"result": {
8     transactionHash: '0xb903239f8543d04b5dc1ba6579132b143087c68db1b2168786408fcbce568238',
9     transactionIndex:  '0x1', // 1
10     blockNumber: '0xb', // 11
11     blockHash: '0xc6ef2fc5426d6ad6fd9e2a26abeab0aa2411b7ab17f30a99d3cb96aed1d1055b',
12     cumulativeGasUsed: '0x33bc', // 13244
13     gasUsed: '0x4dc', // 1244
14     contractAddress: '0xb60e8dd61c5d32be8058bb8eb970870f07233155', // or null, if none was created
15     logs: [{
16         // logs as returned by getFilterLogs, etc.
17     }, ...],
18     logsBloom: "0x00...0", // 256 byte bloom filter
19     status: '0x1'
20  }
21}
22
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 - numero 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 (log). 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 e B nella seconda (e tutto il resto segue)"
• [A, B]: "A in prima posizione e B in seconda (e tutto il resto segue)"
• [[A, B], [A, B]]: "(A o B) in prima posizione e (A o B) in seconda posizione (e tutto il resto segue)"
• Parametri

1. Object - Le opzioni di filtro:

• fromBlock: QUANTITY|TAG - (opzionale, predefinito: "latest") Numero intero del blocco, oppure "latest" per l'ultimo blocco estratto oppure "pending", "earliest" per le transazioni ancore non estratte.
• toBlock: QUANTITY|TAG - (opzionale, predefinito: "latest") numero intero del block, oppure "latest" per l'ultimo blocco estratto, oppure "pending", "earliest" per le transazioni ancora non estratte.
• address: DATA|Array, 20 Bytes - (opzionale) Gli indirizzi del contratto oppure un elenco di indirizzi da cui dovrebbero avere origine i registri.
• topics: Array of DATA, - (opzionale) Array di 32 Bytes DATA Argomento. Argomenti di analisi della dipendenza dei dati. Ogni argomento può anche essere una matrice di DATI con opzioni "oppure".

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 - Un filtro ID.

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 di log, 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 a catena. false se il suo registro è valido.
  • transactionIndex: QUANTITY - numero intero della posizione dell'indice delle transazioni nel blocco. null quando il log è in sospeso.
  • transactionIndex: QUANTITY - numero intero del registro della posizione dell'indice delle transazioni da cui è stato creato. null quando il log è in sospeso.
  • transactionHash: DATA, 32 Bytes - hash delle transazioni da cui è stato creato il registro. null quando il log è in sospeso.
  • blockHash: DATA, 32 byte - hash del blocco in cui si trovava questa transazione. null quando è in sospeso. null quando il log è in sospeso.
  • blockNumber: QUANTITY il numero di blocco in cui si trovava questo registro. null quando è in sospeso. null quando il log è in sospeso.
  • address: DATI, 20 Bytes - indirizzo da cui è nato 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 log 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 log 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 log che corrispondono a un dato oggetto filtro.

Parametri

1. Oggetto - Le opzioni di filtro:

• fromBlock: QUANTITY|TAG - (opzionale, predefinito: "latest") Numero intero del blocco, oppure "latest" per l'ultimo blocco minato oppure "pending", "earliest" per le transazioni non ancora minate.
• toBlock: QUANTITY|TAG - (opzionale, predefinito: "latest") numero intero del blocco, oppure "latest" per l'ultimo blocco minato, oppure "pending", "earliest" per le transazioni non ancora minate.
• address: DATA|Array, 20 Bytes - (opzionale) Gli indirizzi del contratto oppure un elenco di indirizzi da cui dovrebbero avere origine i registri.
• topics: Array of DATA, - (opzionale) Array di argomenti DATA a 32 byte. Gli argomenti dipendono dall'ordine. Ogni argomento può anche essere una matrice di DATA con opzioni "oppure".
• blockhash: DATI, 32 Bytes - (opzionale, future) Con l'aggiunta di EIP-234, blockHash sarà una nuova opzione di filtro che limita i log 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 limite da soddisfare ("target").

Parametri Nessuno

Restituisce Array - Array con le seguenti proprietà:

1. DATI, 32 Byte - intestazione pow-hash del blocco corrente
2. DATI, 32 Byte - il seed hash utilizzato per il DAG.
3. DATI, 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, in caso contrario 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)

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

Parametri

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

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

Restituisce DATI - 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 - (opzionale) L'identità del mittente.
• to: DATA, 60 Byte - (opzionale) 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 carico utile 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

Restituisce Boolean - restituisce true se il messaggio è stato inviato, altrimenti false.

Esempio

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"shh_post","params":[{"from":"0xc931d93e97ab07fe42d923478ba2465f2..","topics": ["0x68656c6c6f20776f726c64"],"payload":"0x68656c6c6f20776f726c64","ttl":0x64,"priority":0x64}],"id":73}'
3// Result
4{
5  "id":1,
6  "jsonrpc":"2.0",
7  "result": true
8}
9
 Copia