Přejít na hlavní obsah
Change page

JSON-RPC API

Aby mohla softwarová aplikace komunikovat s blockchainem Etherea – ať už čtením dat z blockchainu, nebo odesíláním transakcí do sítě – musí se připojit k uzlu Etherea.

Za tímto účelem implementuje každý klient Etherea specifikaci JSON-RPC (opens in a new tab), takže existuje jednotná sada metod, na které se mohou aplikace spolehnout bez ohledu na konkrétní implementaci uzlu nebo klienta.

JSON-RPC (opens in a new tab) je bezstavový, odlehčený protokol pro vzdálené volání procedur (RPC). Definuje několik datových struktur a pravidla pro jejich zpracování. Je nezávislý na transportní vrstvě v tom smyslu, že jeho koncepty lze použít v rámci stejného procesu, přes sockety, přes HTTP nebo v mnoha různých prostředích pro předávání zpráv. Jako datový formát používá JSON (RFC 4627).

Implementace klientů

Klienti Etherea mohou při implementaci specifikace JSON-RPC využívat různé programovací jazyky. Další podrobnosti týkající se konkrétních programovacích jazyků najdete v dokumentaci jednotlivých klientů. Doporučujeme zkontrolovat dokumentaci každého klienta, kde najdete nejnovější informace o podpoře API.

Pomocné knihovny

Ačkoli se můžete rozhodnout komunikovat s klienty Etherea přímo přes JSON-RPC API, pro vývojáře decentralizovaných aplikací (dapp) často existují jednodušší možnosti. Existuje mnoho knihoven pro JavaScript a backendová API, které poskytují obálky nad JSON-RPC API. Díky těmto knihovnám mohou vývojáři psát intuitivní, jednořádkové metody ve svém oblíbeném programovacím jazyce, které (na pozadí) inicializují JSON-RPC požadavky pro interakci s Ethereem.

API konsensuálních klientů

Tato stránka se zabývá především JSON-RPC API, které používají exekuční klienti Etherea. Nicméně konsensuální klienti mají také RPC API, které uživatelům umožňuje dotazovat se na informace o uzlu, vyžadovat Beacon bloky, Beacon stav a další informace související s konsensem přímo z uzlu. Toto API je zdokumentováno na webové stránce Beacon API (opens in a new tab).

Pro komunikaci mezi klienty v rámci uzlu se používá také interní API – to znamená, že umožňuje konsensuálnímu klientovi a exekučnímu klientovi vyměňovat si data. Nazývá se „Engine API“ a jeho specifikace jsou k dispozici na GitHubu (opens in a new tab).

Specifikace exekučního klienta

Přečtěte si úplnou specifikaci JSON-RPC API na GitHubu (opens in a new tab). Toto API je dokumentováno na webové stránce Execution API (opens in a new tab) a obsahuje nástroj Inspector pro vyzkoušení všech dostupných metod.

Konvence

Kódování hexadecimálních hodnot

Přes JSON se předávají dva klíčové datové typy: neformátovaná pole bajtů a kvantity. Oba se předávají v hexadecimálním kódování, ale s odlišnými požadavky na formátování.

Kvantity

Při kódování kvantit (celá čísla, čísla): kódujte jako hexadecimální hodnotu, přidejte předponu "0x", použijte nejkompaktnější reprezentaci (drobná výjimka: nula by měla být reprezentována jako "0x0").

Zde je několik příkladů:

  • 0x41 (65 v desítkové soustavě)
  • 0x400 (1024 v desítkové soustavě)
  • ŠPATNĚ: 0x (vždy by měla mít alespoň jednu číslici - nula je "0x0")
  • ŠPATNĚ: 0x0400 (nejsou povoleny žádné úvodní nuly)
  • ŠPATNĚ: ff (musí mít předponu 0x)

Neformátovaná data

Při kódování neformátovaných dat (pole bajtů, adresy účtů, hashe, pole bajtkódu): kódujte jako hexadecimální hodnotu, přidejte předponu "0x", dvě hexadecimální číslice na bajt.

Zde je několik příkladů:

  • 0x41 (velikost 1, "A")
  • 0x004200 (velikost 3, "0B0")
  • 0x (velikost 0, "")
  • ŠPATNĚ: 0xf0f0f (musí mít sudý počet číslic)
  • ŠPATNĚ: 004200 (musí mít předponu 0x)

Parametr bloku

Následující metody mají parametr bloku:

Když jsou vzneseny požadavky, které dotazují stav Etherea, poskytnutý parametr bloku určuje výšku bloku.

Pro parametr bloku jsou možné následující možnosti:

  • HEX String - celočíselné číslo bloku
  • String "earliest" pro nejranější/genesis blok
  • String "latest" - pro nejnovější navržený blok
  • String "safe" - pro nejnovější bezpečný vrcholový blok
  • String "finalized" - pro nejnovější finalizovaný blok
  • String "pending" - pro čekající stav/transakce

Příklady

Na této stránce uvádíme příklady, jak používat jednotlivé koncové body JSON_RPC API pomocí nástroje příkazového řádku curl (opens in a new tab). Tyto příklady jednotlivých koncových bodů naleznete níže v sekci Příklady použití curl. Dále na této stránce také uvádíme komplexní příklad pro kompilaci a nasazení chytrého kontraktu pomocí uzlu Geth, JSON_RPC API a nástroje curl.

Příklady curl

Níže jsou uvedeny příklady použití JSON_RPC API pomocí curl (opens in a new tab) požadavků na uzel Etherea. Každý příklad obsahuje popis konkrétního koncového bodu, jeho parametrů, návratového typu a praktický ukázkový příklad jeho použití.

Požadavky curl mohou vrátit chybovou zprávu týkající se typu obsahu. Je to proto, že volba --data nastavuje typ obsahu na application/x-www-form-urlencoded. Pokud váš uzel hlásí tuto chybu, nastavte hlavičku ručně umístěním -H "Content-Type: application/json" na začátek volání. Příklady také nezahrnují kombinaci URL/IP adresy a portu, která musí být posledním argumentem předaným příkazu curl (např. 127.0.0.1:8545). Kompletní požadavek curl včetně těchto dodatečných dat má následující podobu:

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

Gossip, stav a historie

Několik základních metod JSON-RPC vyžaduje data ze sítě Ethereum a úhledně spadá do tří hlavních kategorií: Gossip, stav a historie. Pomocí odkazů v těchto sekcích můžete přeskočit na jednotlivé metody, nebo použijte obsah k prozkoumání celého seznamu metod.

Gossip metody

Tyto metody sledují vrchol řetězce. Tímto způsobem se transakce šíří po síti, dostávají se do bloků a klienti se dozvídají o nových blocích.

Stavové metody

Metody, které informují o aktuálním stavu všech uložených dat. „Stav“ je jako jedna velká sdílená paměť RAM a zahrnuje zůstatky na účtech, data kontraktů a odhady gasu.

Historické metody

Získávají historické záznamy každého bloku až po genesis blok. Je to jako jeden velký soubor, do kterého lze pouze přidávat (append-only), a obsahuje všechny hlavičky bloků, těla bloků, uncle bloky a stvrzenky transakcí.

JSON-RPC API Playground

Můžete použít nástroj playground (opens in a new tab) k objevování a vyzkoušení metod API. Také vám ukáže, které metody a sítě jsou podporovány různými poskytovateli uzlů.

Metody JSON-RPC API

web3_clientVersion

Vrací aktuální verzi klienta.

Parametry

Žádné

Vrací

String - Aktuální verze klienta

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// Výsledek
{
  "id":67,
  "jsonrpc":"2.0",
  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
}

web3_sha3

Vrací Keccak-256 (nikoli standardizovaný SHA3-256) zadaných dat.

Parametry

  1. DATA - Data k převodu na SHA3 hash
params: ["0x68656c6c6f20776f726c64"]

Vrací

DATA - Výsledek SHA3 zadaného řetězce.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// Výsledek
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}

net_version

Vrací aktuální ID sítě.

Parametry

Žádné

Vrací

String - Aktuální ID sítě.

Úplný seznam aktuálních ID sítí je k dispozici na chainlist.org (opens in a new tab). Mezi ty běžné patří:

  • 1: Ethereum Mainnet
  • 11155111: Sepolia testnet
  • 560048 : Hoodi testnet

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// Výsledek
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "3"
}

net_listening

Vrací true, pokud klient aktivně naslouchá síťovým připojením.

Parametry

Žádné

Vrací

Boolean - true, když naslouchá, jinak false.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// Výsledek
{
  "id":67,
  "jsonrpc":"2.0",
  "result":true
}

net_peerCount

Vrací počet peerů aktuálně připojených ke klientovi.

Parametry

Žádné

Vrací

QUANTITY - celé číslo udávající počet připojených peerů.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// Výsledek
{
  "id":74,
  "jsonrpc": "2.0",
  "result": "0x2" // 2
}

eth_protocolVersion

Vrací aktuální verzi protokolu Ethereum. Vezměte na vědomí, že tato metoda není dostupná v Gethu (opens in a new tab).

Parametry

Žádné

Vrací

String - Aktuální verze protokolu Ethereum

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// Výsledek
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "54"
}

eth_syncing

Vrací objekt s daty o stavu synchronizace nebo false.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Žádné

Vrací

Přesná návratová data se liší mezi implementacemi klientů. Všichni klienti vrací False, když se uzel nesynchronizuje, a všichni klienti vrací následující pole.

Object|Boolean, Objekt s daty o stavu synchronizace nebo FALSE, když se nesynchronizuje:

  • startingBlock: QUANTITY - Blok, na kterém začal import (bude resetováno pouze poté, co synchronizace dosáhne svého vrcholu)
  • currentBlock: QUANTITY - Aktuální blok, stejné jako eth_blockNumber
  • highestBlock: QUANTITY - Odhadovaný nejvyšší blok

Jednotliví klienti však mohou poskytovat i další data. Například Geth vrací následující:

Zatímco Besu vrací:

Další podrobnosti naleznete v dokumentaci vašeho konkrétního klienta.

Příklad

eth_coinbase

Vrací adresu coinbase klienta.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Poznámka: Tato metoda je od verze v1.14.0 zastaralá a již není podporována. Pokus o její použití povede k chybě „Method not supported“.

Parametry

Žádné

Vrací

DATA, 20 bajtů – aktuální adresa coinbase.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// Výsledek
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_chainId

Vrací ID řetězce používané pro podepisování transakcí chráněných proti znovupřehrání.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Žádné

Vrací

chainId, hexadecimální hodnota jako řetězec představující celé číslo aktuálního ID řetězce.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
// Výsledek
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "0x1"
}

eth_mining

Vrací true, pokud klient aktivně těží nové bloky. Toto může vrátit true pouze pro sítě s důkazem prací (PoW) a od Merge to v některých klientech nemusí být dostupné.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Žádné

Vrací

Boolean - vrací true, pokud klient těží, jinak false.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
//
{
  "id":71,
  "jsonrpc": "2.0",
  "result": true
}

eth_hashrate

Vrací počet hashů za sekundu, se kterými uzel těží. Toto může vrátit true pouze pro sítě využívající důkaz prací (PoW) a v některých klientech to nemusí být dostupné od Merge.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Žádné

Vrací

QUANTITY - počet hashů za sekundu.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// Výsledek
{
  "id":71,
  "jsonrpc": "2.0",
  "result": "0x38a"
}

eth_gasPrice

Vrací odhad aktuální ceny za gas ve Wei. Například klient Besu standardně prozkoumá posledních 100 bloků a vrátí mediánovou cenu za jednotku gasu.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Žádné

Vrací

QUANTITY - celé číslo udávající aktuální cenu plynu ve Wei.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// Výsledek
{
  "id":73,
  "jsonrpc": "2.0",
  "result": "0x1dfd14000" // 8049999872 Wei
}

eth_accounts

Vrací seznam adres vlastněných klientem.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Žádné

Vrací

Array of DATA, 20 bajtů - adresy vlastněné klientem.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

eth_blockNumber

Vrací číslo nejnovějšího bloku.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Žádné

Vrací

QUANTITY - celé číslo aktuálního čísla bloku, na kterém se klient nachází.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// Výsledek
{
  "id":83,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}

eth_getBalance

Vrací zůstatek účtu na dané adrese.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 20 bajtů - adresa, u které se má zkontrolovat zůstatek.
  2. QUANTITY|TAG - celé číslo bloku, nebo řetězec "latest", "earliest", "pending", "safe" nebo "finalized", viz parametr bloku
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]

Vrací

QUANTITY - celé číslo aktuálního zůstatku ve Wei.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58" // 158972490234375000
}

eth_getStorageAt

Vrací hodnotu z pozice úložiště na dané adrese.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 20 bajtů - adresa úložiště.
  2. QUANTITY - celé číslo pozice v úložišti.
  3. QUANTITY|TAG - celé číslo bloku, nebo řetězec "latest", "earliest", "pending", "safe", "finalized", viz parametr bloku

Vrací

DATA - hodnota na této pozici v úložišti.

Příklad Výpočet správné pozice závisí na úložišti, které se má načíst. Uvažujme následující kontrakt nasazený na 0x295a70b2de5e3953354a6a8344e616ed314d7251 adresou 0x391694e7e0b0cce554cb130d723a9d27458f9298.

contract Storage {
    uint pos0;
    mapping(address => uint) pos1;
    constructor() {
        pos0 = 1234;
        pos1[msg.sender] = 5678;
    }
}

Získání hodnoty pos0 je přímočaré:

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

Získání prvku z mapy je složitější. Pozice prvku v mapě se vypočítá pomocí:

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

To znamená, že pro získání úložiště na pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] musíme vypočítat pozici pomocí:

keccak(
  decodeHex(
    "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
      "0000000000000000000000000000000000000000000000000000000000000001"
  )
)

K výpočtu lze použít konzoli Geth, která je součástí knihovny Web3:

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

Nyní k načtení úložiště:

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

eth_getTransactionCount

Vrací počet transakcí odeslaných z dané adresy.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 20 bajtů - adresa.
  2. QUANTITY|TAG - celé číslo bloku, nebo řetězec "latest", "earliest", "pending", "safe" nebo "finalized", viz parametr bloku
params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "latest", // stav v nejnovějším bloku
]

Vrací

QUANTITY - celé číslo udávající počet transakcí odeslaných z této adresy.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getBlockTransactionCountByHash

Vrací počet transakcí v bloku, který odpovídá zadanému hashi bloku.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 32 bajtů - hash bloku
params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]

Vrací

QUANTITY - celé číslo udávající počet transakcí v tomto bloku.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getBlockTransactionCountByNumber

Vrací počet transakcí v bloku odpovídajícím zadanému číslu bloku.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. QUANTITY|TAG - celé číslo představující číslo bloku, nebo řetězec "earliest", "latest", "pending", "safe" nebo "finalized", jako v parametru bloku.
params: [
  "0x13738ca", // 20396234
]

Vrací

QUANTITY - celé číslo představující počet transakcí v tomto bloku.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getUncleCountByBlockHash

Vrací počet uncle bloků v bloku odpovídajícím zadanému hashi bloku.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 32 bajtů - hash bloku
params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]

Vrací

QUANTITY - celé číslo udávající počet uncle bloků v tomto bloku.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getUncleCountByBlockNumber

Vrací počet uncle bloků v bloku odpovídajícím zadanému číslu bloku.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. QUANTITY|TAG - celé číslo představující číslo bloku, nebo řetězec "latest", "earliest", "pending", "safe" nebo "finalized", viz parametr bloku
params: [
  "0xe8", // 232
]

Vrací

QUANTITY - celé číslo představující počet uncle bloků v tomto bloku.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0" // 0
}

eth_getCode

Vrací kód na dané adrese.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 20 bajtů - adresa
  2. QUANTITY|TAG - celočíselné číslo bloku, nebo řetězec "latest", "earliest", "pending", "safe" nebo "finalized", viz parametr bloku
params: [
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "0x5daf3b", // 6139707
]

Vrací

DATA - kód z dané adresy.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
}

eth_sign

Metoda sign vypočítá specifický podpis pro Ethereum pomocí: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).

Přidáním předpony ke zprávě se vypočítaný podpis stane rozpoznatelným jako specifický podpis pro Ethereum. To zabraňuje zneužití, kdy by škodlivá decentralizovaná aplikace (dapp) mohla podepsat libovolná data (např. transakci) a použít podpis k vydávání se za oběť.

Poznámka: adresa, kterou se má podepisovat, musí být odemčená.

Parametry

  1. DATA, 20 bajtů - adresa
  2. DATA, N bajtů - zpráva k podepsání

Vrací

DATA: Podpis

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_signTransaction

Podepíše transakci, která může být později odeslána do sítě pomocí eth_sendRawTransaction.

Parametry

  1. Object - Objekt transakce
  • type:
  • from: DATA, 20 bajtů - Adresa, ze které je transakce odeslána.
  • to: DATA, 20 bajtů - (volitelné při vytváření nového kontraktu) Adresa, na kterou je transakce směrována.
  • gas: QUANTITY - (volitelné, výchozí: 90000) Celé číslo udávající gas poskytnutý pro provedení transakce. Nevyužitý gas bude vrácen.
  • gasPrice: QUANTITY - (volitelné, výchozí: bude určeno) Celé číslo udávající gasPrice použitou pro každý zaplacený gas, ve Wei.
  • value: QUANTITY - (volitelné) Celé číslo udávající hodnotu odeslanou s touto transakcí, ve Wei.
  • data: DATA - Zkompilovaný kód kontraktu NEBO hash podpisu volané metody a zakódovaných parametrů.
  • nonce: QUANTITY - (volitelné) Celé číslo udávající nonce. To umožňuje přepsat vaše vlastní čekající transakce, které používají stejnou nonce.

Vrací

DATA, RLP zakódovaný objekt transakce podepsaný zadaným účtem.

Příklad

// Požadavek
curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
// Výsledek
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_sendTransaction

Vytvoří novou transakci volání zprávy nebo vytvoření kontraktu, pokud datové pole obsahuje kód, a podepíše ji pomocí účtu specifikovaného v from.

Parametry

  1. Object - Objekt transakce
  • from: DATA, 20 bajtů - Adresa, ze které je transakce odeslána.
  • to: DATA, 20 bajtů - (volitelné při vytváření nového kontraktu) Adresa, na kterou je transakce směrována.
  • gas: QUANTITY - (volitelné, výchozí: 90000) Celé číslo udávající gas poskytnutý pro provedení transakce. Vrátí nepoužitý gas.
  • gasPrice: QUANTITY - (volitelné, výchozí: bude určeno) Celé číslo udávající cenu plynu použitou pro každý zaplacený gas.
  • value: QUANTITY - (volitelné) Celé číslo udávající hodnotu odeslanou s touto transakcí.
  • input: DATA - Zkompilovaný kód kontraktu NEBO hash podpisu volané metody a zakódovaných parametrů.
  • nonce: QUANTITY - (volitelné) Celé číslo udávající nonce. To umožňuje přepsat vaše vlastní čekající transakce, které používají stejnou nonce.

Vrací

DATA, 32 bajtů - hash transakce, nebo nulový hash, pokud transakce ještě není k dispozici.

Pro získání adresy kontraktu (pokud jste kontrakt vytvořili) použijte eth_getTransactionReceipt poté, co byla transakce navržena v bloku.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_sendRawTransaction

Vytváří novou transakci volání zprávy nebo vytvoření kontraktu pro podepsané transakce.

Parametry

  1. DATA, Podepsaná data transakce.
params: [
  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
]

Vrací

DATA, 32 bajtů - hash transakce, nebo nulový hash, pokud transakce ještě není k dispozici.

Pokud jste vytvořili kontrakt, použijte eth_getTransactionReceipt k získání adresy kontraktu poté, co byla transakce navržena v bloku.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

Okamžitě provede nové volání zprávy bez vytvoření transakce na blockchainu. Často se používá k provádění funkcí chytrých kontraktů pouze pro čtení, například balanceOf pro kontrakt ERC-20.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. Object - Objekt volání transakce
  • from: DATA, 20 bajtů - (volitelné) Adresa, ze které je transakce odeslána.
  • to: DATA, 20 bajtů - Adresa, na kterou je transakce směrována.
  • gas: QUANTITY - (volitelné) Celé číslo udávající gas poskytnutý pro provedení transakce. eth_call nespotřebovává žádný gas, ale tento parametr může být u některých spuštění vyžadován.
  • gasPrice: QUANTITY - (volitelné) Celé číslo udávající gasPrice použitou pro každý zaplacený gas
  • value: QUANTITY - (volitelné) Celé číslo udávající hodnotu odeslanou s touto transakcí
  • input: DATA - (volitelné) Hash podpisu metody a zakódovaných parametrů. Podrobnosti viz Ethereum Contract ABI v dokumentaci Solidity (opens in a new tab).
  1. QUANTITY|TAG - celé číslo bloku, nebo řetězec "latest", "earliest", "pending", "safe" nebo "finalized", viz parametr bloku

Vrací

DATA - návratová hodnota provedeného kontraktu.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x"
}

eth_estimateGas

Generuje a vrací odhad toho, kolik gasu je potřeba k dokončení transakce. Transakce nebude přidána na blockchain. Vezměte na vědomí, že odhad může být z různých důvodů, včetně mechanismů EVM a výkonu uzlu, výrazně vyšší než množství gasu skutečně spotřebovaného transakcí.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

Viz parametry eth_call s tím rozdílem, že všechny vlastnosti jsou volitelné. Pokud není specifikován žádný limit plynu, geth použije jako horní hranici limit plynu z čekajícího bloku. V důsledku toho vrácený odhad nemusí stačit k provedení volání/transakce, pokud je množství gasu vyšší než limit plynu čekajícího bloku.

Vrací

QUANTITY - množství spotřebovaného gasu.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}

eth_getBlockByHash

Vrací informace o bloku podle hashe.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 32 bajtů - Hash bloku.
  2. Boolean - Pokud je true, vrací celé objekty transakcí, pokud je false, vrací pouze hashe transakcí.
params: [
  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
  false,
]

Vrací

Object - Objekt bloku, nebo null, pokud nebyl nalezen žádný blok:

  • number: QUANTITY - číslo bloku. null, pokud se jedná o čekající blok.
  • hash: DATA, 32 bajtů - hash bloku. null, pokud se jedná o čekající blok.
  • parentHash: DATA, 32 bajtů - hash rodičovského bloku.
  • nonce: DATA, 8 bajtů - hash vygenerovaného důkazu prací (PoW). null, pokud se jedná o čekající blok, 0x0 pro bloky s důkazem podílem (PoS) (od Merge).
  • sha3Uncles: DATA, 32 bajtů - SHA3 dat uncle bloků v bloku.
  • logsBloom: DATA, 256 bajtů - bloom filter pro logy bloku. null, pokud se jedná o čekající blok.
  • transactionsRoot: DATA, 32 bajtů - kořen transakční trie bloku.
  • stateRoot: DATA, 32 bajtů - kořen finální stavové trie bloku.
  • receiptsRoot: DATA, 32 bajtů - kořen trie stvrzenek bloku.
  • miner: DATA, 20 bajtů - adresa příjemce, kterému byly uděleny odměny za blok.
  • difficulty: QUANTITY - celé číslo představující obtížnost tohoto bloku.
  • totalDifficulty: QUANTITY - celé číslo představující celkovou obtížnost řetězce až po tento blok.
  • extraData: DATA - pole „extra data“ tohoto bloku.
  • size: QUANTITY - celé číslo představující velikost tohoto bloku v bajtech.
  • gasLimit: QUANTITY - maximální povolený gas v tomto bloku.
  • gasUsed: QUANTITY - celkový gas spotřebovaný všemi transakcemi v tomto bloku.
  • timestamp: QUANTITY - unixové časové razítko (timestamp) okamžiku, kdy byl blok sestaven.
  • transactions: Array - Pole objektů transakcí, nebo 32bajtových hashů transakcí v závislosti na posledním zadaném parametru.
  • uncles: Array - Pole hashů uncle bloků.

Příklad

eth_getBlockByNumber

Vrací informace o bloku podle čísla bloku.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. QUANTITY|TAG - celé číslo čísla bloku, nebo řetězec "earliest", "latest", "pending", "safe" nebo "finalized", jako v parametru bloku.
  2. Boolean - Pokud je true, vrátí celé objekty transakcí, pokud je false, vrátí pouze hashe transakcí.
params: [
  "0x1b4", // 436
  true,
]

Vrací Viz eth_getBlockByHash

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'

Výsledek viz eth_getBlockByHash

eth_getTransactionByHash

Vrací informace o transakci vyžádané pomocí hashe transakce.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 32 bajtů - hash transakce
params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

Vrací

Object - Objekt transakce, nebo null, pokud nebyla nalezena žádná transakce:

  • blockHash: DATA, 32 bajtů - hash bloku, ve kterém se tato transakce nacházela. null, pokud čeká na vyřízení.
  • blockNumber: QUANTITY - číslo bloku, ve kterém se tato transakce nacházela. null, pokud čeká na vyřízení.
  • from: DATA, 20 bajtů - adresa odesílatele.
  • gas: QUANTITY - gas poskytnutý odesílatelem.
  • gasPrice: QUANTITY - cena plynu poskytnutá odesílatelem ve Wei.
  • hash: DATA, 32 bajtů - hash transakce.
  • input: DATA - data odeslaná spolu s transakcí.
  • nonce: QUANTITY - počet transakcí provedených odesílatelem před touto transakcí.
  • to: DATA, 20 bajtů - adresa příjemce. null, pokud se jedná o transakci vytvoření kontraktu.
  • transactionIndex: QUANTITY - celé číslo pozice indexu transakce v bloku. null, pokud čeká na vyřízení.
  • value: QUANTITY - převedená hodnota ve Wei.
  • v: QUANTITY - ID obnovy ECDSA
  • r: QUANTITY - podpis ECDSA r
  • s: QUANTITY - podpis ECDSA s

Příklad

eth_getTransactionByBlockHashAndIndex

Vrací informace o transakci podle hashe bloku a pozice indexu transakce.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 32 bajtů - hash bloku.
  2. QUANTITY - celé číslo pozice indexu transakce.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

Vrací Viz eth_getTransactionByHash

Příklad

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

Výsledek viz eth_getTransactionByHash

eth_getTransactionByBlockNumberAndIndex

Vrací informace o transakci podle čísla bloku a pozice indexu transakce.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. QUANTITY|TAG - číslo bloku, nebo řetězec "earliest", "latest", "pending", "safe" nebo "finalized", jako v parametru bloku.
  2. QUANTITY - pozice indexu transakce.
params: [
  "0x9c47cf", // 10241999
  "0x24", // 36
]

Vrací Viz eth_getTransactionByHash

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'

Výsledek viz eth_getTransactionByHash

eth_getTransactionReceipt

Vrací stvrzenku transakce podle hashe transakce.

Poznámka: Stvrzenka není k dispozici pro čekající transakce.

Parametry

  1. DATA, 32 bajtů - hash transakce
params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]

Vrací Object - Objekt stvrzenky transakce, nebo null, pokud nebyla nalezena žádná stvrzenka:

  • transactionHash : DATA, 32 bajtů - hash transakce.
  • transactionIndex: QUANTITY - celé číslo pozice indexu transakce v bloku.
  • blockHash: DATA, 32 bajtů - hash bloku, ve kterém se tato transakce nacházela.
  • blockNumber: QUANTITY - číslo bloku, ve kterém se tato transakce nacházela.
  • from: DATA, 20 bajtů - adresa odesílatele.
  • to: DATA, 20 bajtů - adresa příjemce. null, pokud se jedná o transakci vytvoření kontraktu.
  • cumulativeGasUsed : QUANTITY - Celkové množství gasu spotřebovaného při provedení této transakce v bloku.
  • effectiveGasPrice : QUANTITY - Součet základního poplatku a prioritního poplatku zaplaceného za jednotku gasu.
  • gasUsed : QUANTITY - Množství gasu spotřebovaného pouze touto konkrétní transakcí.
  • contractAddress : DATA, 20 bajtů - Adresa vytvořeného kontraktu, pokud se jednalo o transakci vytvoření kontraktu, jinak null.
  • logs: Array - Pole objektů logů, které tato transakce vygenerovala.
  • logsBloom: DATA, 256 bajtů - Bloomův filtr pro lehké klienty k rychlému získání souvisejících logů.
  • type: QUANTITY - celé číslo typu transakce, 0x0 pro starší (legacy) transakce, 0x1 pro typy se seznamem přístupů (access list), 0x2 pro dynamické poplatky.

Vrací také buď :

  • root : DATA 32 bajtů kořene stavu po transakci (před aktualizací Byzantium)
  • status: QUANTITY buď 1 (úspěch), nebo 0 (selhání)

Příklad

eth_getUncleByBlockHashAndIndex

Vrací informace o strýci bloku podle hashe a pozice indexu strýce.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. DATA, 32 bajtů - Hash bloku.
  2. QUANTITY - Pozice indexu strýce.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

Vrací Viz eth_getBlockByHash

Příklad

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

Výsledek viz eth_getBlockByHash

Poznámka: Strýc neobsahuje jednotlivé transakce.

eth_getUncleByBlockNumberAndIndex

Vrací informace o uncle bloku podle čísla bloku a pozice indexu uncle bloku.

Vyzkoušet endpoint v playgroundu (opens in a new tab)

Parametry

  1. QUANTITY|TAG - číslo bloku, nebo řetězec "earliest", "latest", "pending", "safe", "finalized", jako v parametru bloku.
  2. QUANTITY - pozice indexu uncle bloku.
params: [
  "0x29c", // 668
  "0x0", // 0
]

Vrací Viz eth_getBlockByHash

Poznámka: Uncle blok neobsahuje jednotlivé transakce.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'

Výsledek viz eth_getBlockByHash

eth_newFilter

Vytvoří objekt filtru na základě možností filtru, aby upozornil na změnu stavu (logy). Chcete-li zkontrolovat, zda se stav změnil, zavolejte eth_getFilterChanges.

Poznámka k zadávání filtrů témat: Témata závisí na pořadí. Transakce s logem s tématy [A, B] bude odpovídat následujícím filtrům témat:

  • [] "cokoliv"
  • [A] "A na první pozici (a cokoliv po něm)"
  • [null, B] "cokoliv na první pozici A ZÁROVEŇ B na druhé pozici (a cokoliv po něm)"
  • [A, B] "A na první pozici A ZÁROVEŇ B na druhé pozici (a cokoliv po něm)"
  • [[A, B], [A, B]] "(A NEBO B) na první pozici A ZÁROVEŇ (A NEBO B) na druhé pozici (a cokoliv po něm)"
  • Parametry
  1. Object - Možnosti filtru:
  • fromBlock: QUANTITY|TAG - (volitelné, výchozí: "latest") Celočíselné číslo bloku, nebo "latest" pro poslední navržený blok, "safe" pro nejnovější bezpečný blok, "finalized" pro nejnovější finalizovaný blok, nebo "pending", "earliest" pro transakce, které ještě nejsou v bloku.
  • toBlock: QUANTITY|TAG - (volitelné, výchozí: "latest") Celočíselné číslo bloku, nebo "latest" pro poslední navržený blok, "safe" pro nejnovější bezpečný blok, "finalized" pro nejnovější finalizovaný blok, nebo "pending", "earliest" pro transakce, které ještě nejsou v bloku.
  • address: DATA|Array, 20 bajtů - (volitelné) Adresa kontraktu nebo seznam adres, ze kterých by měly logy pocházet.
  • topics: Array of DATA, - (volitelné) Pole 32bajtových DATA témat. Témata závisí na pořadí. Každé téma může být také polem DATA s možnostmi „nebo“ (or).

Vrací QUANTITY - ID filtru.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_newBlockFilter

Vytvoří filtr v uzlu, který upozorní na příchod nového bloku. Chcete-li zkontrolovat, zda se změnil stav, zavolejte eth_getFilterChanges.

Parametry Žádné

Vrací QUANTITY - ID filtru.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
// Výsledek
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_newPendingTransactionFilter

Vytvoří filtr v uzlu, který upozorní na příchod nových čekajících transakcí. Chcete-li zkontrolovat, zda se stav změnil, zavolejte eth_getFilterChanges.

Parametry Žádné

Vrací QUANTITY - ID filtru.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
// Výsledek
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_uninstallFilter

Odinstaluje filtr se zadaným ID. Mělo by se volat vždy, když už sledování není potřeba. Navíc platnost filtrů vyprší, pokud nejsou po určitou dobu dotazovány pomocí eth_getFilterChanges.

Parametry

  1. QUANTITY - ID filtru.
params: [
  "0xb", // 11
]

Vrací Boolean - true, pokud byl filtr úspěšně odinstalován, jinak false.

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
// Výsledek
{
  "id":1,
  "jsonrpc": "2.0",
  "result": true
}

eth_getFilterChanges

Metoda dotazování pro filtr, která vrací pole logů, které se vyskytly od posledního dotazu.

Parametry

  1. QUANTITY - ID filtru.
params: [
  "0x16", // 22
]

Vrací Array - Pole objektů logů, nebo prázdné pole, pokud se od posledního dotazu nic nezměnilo.

  • Pro filtry vytvořené pomocí eth_newBlockFilter jsou návratovou hodnotou hashe bloků (DATA, 32 bajtů), např. ["0x3454645634534..."].

  • Pro filtry vytvořené pomocí eth_newPendingTransactionFilter jsou návratovou hodnotou hashe transakcí (DATA, 32 bajtů), např. ["0x6345343454645..."].

  • Pro filtry vytvořené pomocí eth_newFilter jsou logy objekty s následujícími parametry:

    • removed: TAG - true, když byl log odstraněn kvůli reorganizaci řetězce. false, pokud se jedná o platný log.
    • logIndex: QUANTITY - celé číslo pozice indexu logu v bloku. null, když se jedná o čekající log.
    • transactionIndex: QUANTITY - celé číslo pozice indexu transakce, ze které byl log vytvořen. null, když se jedná o čekající log.
    • transactionHash: DATA, 32 bajtů - hash transakce, ze které byl tento log vytvořen. null, když se jedná o čekající log.
    • blockHash: DATA, 32 bajtů - hash bloku, ve kterém se tento log nacházel. null, když čeká na vyřízení. null, když se jedná o čekající log.
    • blockNumber: QUANTITY - číslo bloku, ve kterém se tento log nacházel. null, když čeká na vyřízení. null, když se jedná o čekající log.
    • address: DATA, 20 bajtů - adresa, ze které tento log pochází.
    • data: DATA - neindexovaná data logu s proměnnou délkou. (V Solidity: nula nebo více 32bajtových neindexovaných argumentů logu.)
    • topics: Array of DATA - Pole 0 až 4 32bajtových DATA indexovaných argumentů logu. (V Solidity: Prvním tématem je hash podpisu události (např. Deposit(address,bytes32,uint256)), pokud jste událost nedeklarovali pomocí specifikátoru anonymous.)

  • Příklad

eth_getFilterLogs

Vrací pole všech logů odpovídajících filtru s daným id.

Parametry

  1. QUANTITY - Id filtru.
params: [
  "0x16", // 22
]

Vrací Viz eth_getFilterChanges

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'

Výsledek viz eth_getFilterChanges

eth_getLogs

Vrací pole všech logů odpovídajících danému objektu filtru.

Parametry

  1. Object - Možnosti filtru:
  • fromBlock: QUANTITY|TAG - (volitelné, výchozí: "latest") Celočíselné číslo bloku, nebo "latest" pro poslední navržený blok, "safe" pro nejnovější bezpečný blok, "finalized" pro nejnovější finalizovaný blok, nebo "pending", "earliest" pro transakce, které ještě nejsou v bloku.
  • toBlock: QUANTITY|TAG - (volitelné, výchozí: "latest") Celočíselné číslo bloku, nebo "latest" pro poslední navržený blok, "safe" pro nejnovější bezpečný blok, "finalized" pro nejnovější finalizovaný blok, nebo "pending", "earliest" pro transakce, které ještě nejsou v bloku.
  • address: DATA|Array, 20 bajtů - (volitelné) Adresa kontraktu nebo seznam adres, ze kterých by měly logy pocházet.
  • topics: Array of DATA, - (volitelné) Pole 32bajtových DATA témat (topics). Témata závisí na pořadí. Každé téma může být také polem DATA s možnostmi „nebo“ (or).
  • blockHash: DATA, 32 bajtů - (volitelné, budoucí) S přidáním EIP-234 bude blockHash novou možností filtru, která omezí vrácené logy na jediný blok s 32bajtovým hashem blockHash. Použití blockHash je ekvivalentní fromBlock = toBlock = číslo bloku s hashem blockHash. Pokud je blockHash přítomen v kritériích filtru, pak nejsou povoleny ani fromBlock, ani toBlock.
params: [
  {
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    ],
  },
]

Vrací Viz eth_getFilterChanges

Příklad

// Požadavek
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'

Výsledek viz eth_getFilterChanges

Příklad použití

Nasazení kontraktu pomocí JSON-RPC

Tato část obsahuje ukázku, jak nasadit kontrakt pouze pomocí RPC rozhraní. Existují i alternativní způsoby nasazení kontraktů, kde je tato složitost abstrahována – například pomocí knihoven postavených nad RPC rozhraním, jako jsou Web3.js (opens in a new tab) a Web3.py (opens in a new tab). Tyto abstrakce jsou obecně snáze pochopitelné a méně náchylné k chybám, ale přesto je užitečné pochopit, jak to funguje pod pokličkou.

Následuje jednoduchý chytrý kontrakt s názvem Multiply7, který bude nasazen pomocí rozhraní JSON-RPC na uzel Etherea. Tento tutoriál předpokládá, že čtenář již provozuje uzel Geth. Více informací o uzlech a klientech je k dispozici zde. Informace o tom, jak spustit HTTP JSON-RPC pro klienty jiné než Geth, naleznete v dokumentaci k jednotlivým klientům. Většina klientů ve výchozím nastavení běží na localhost:8545.

contract Multiply7 {
    event Print(uint);
    function multiply(uint input) returns (uint) {
        Print(input * 7);
        return input * 7;
    }
}

První věc, kterou musíte udělat, je ujistit se, že je povoleno rozhraní HTTP RPC. To znamená, že při spuštění poskytneme Gethu příznak --http. V tomto příkladu používáme uzel Geth v soukromém vývojovém řetězci. Díky tomuto přístupu nepotřebujeme ether ve skutečné síti.

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

Tím se spustí rozhraní HTTP RPC na http://localhost:8545.

Můžeme ověřit, že rozhraní běží, načtením adresy Coinbase (získáním první adresy z pole účtů) a zůstatku pomocí curl (opens in a new tab). Upozorňujeme, že data v těchto příkladech se budou na vašem lokálním uzlu lišit. Pokud si chcete tyto příkazy vyzkoušet, nahraďte parametry požadavku ve druhém požadavku curl výsledkem vráceným z prvního.

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

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

Protože jsou čísla kódována hexadecimálně, zůstatek se vrací ve Wei jako hexadecimální řetězec. Pokud chceme mít zůstatek v etheru jako číslo, můžeme použít Web3 z konzole Geth.

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

Nyní, když je v našem soukromém vývojovém řetězci nějaký ether, můžeme nasadit kontrakt. Prvním krokem je kompilace kontraktu Multiply7 do bajtkódu, který lze odeslat do EVM. Pro instalaci solc, kompilátoru Solidity, postupujte podle dokumentace Solidity (opens in a new tab). (Možná budete chtít použít starší verzi solc, aby odpovídala verzi kompilátoru použité v našem příkladu (opens in a new tab).)

Dalším krokem je kompilace kontraktu Multiply7 do bajtkódu, který lze odeslat do EVM.

echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin

======= <stdin>:Multiply7 =======
Binary:
6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029

Nyní, když máme zkompilovaný kód, musíme určit, kolik gasu bude stát jeho nasazení. Rozhraní RPC má metodu eth_estimateGas, která nám poskytne odhad.

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

A nakonec kontrakt nasadíme.

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

Transakce je přijata uzlem a je vrácen hash transakce. Tento hash lze použít ke sledování transakce. Dalším krokem je určení adresy, na které je náš kontrakt nasazen. Každá provedená transakce vytvoří stvrzenku. Tato stvrzenka obsahuje různé informace o transakci, například do kterého bloku byla transakce zahrnuta a kolik gasu EVM spotřeboval. Pokud transakce vytvoří kontrakt, bude obsahovat také adresu kontraktu. Stvrzenku můžeme získat pomocí RPC metody eth_getTransactionReceipt.

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

Náš kontrakt byl vytvořen na 0x4d03d617d700cf81935d7f797f4e2ae719648262. Nulový výsledek (null) místo stvrzenky znamená, že transakce ještě nebyla zahrnuta do bloku. Chvíli počkejte, zkontrolujte, zda běží váš konsensuální klient, a zkuste to znovu.

Interakce s chytrými kontrakty

V tomto příkladu budeme odesílat transakci pomocí eth_sendTransaction do metody multiply daného kontraktu.

eth_sendTransaction vyžaduje několik argumentů, konkrétně from, to a data. From je veřejná adresa našeho účtu a to je adresa kontraktu. Argument data obsahuje payload (užitečné zatížení), který definuje, jaká metoda musí být volána a s jakými argumenty. Zde vstupuje do hry ABI (aplikační binární rozhraní) (opens in a new tab). ABI je soubor JSON, který definuje, jak definovat a kódovat data pro EVM.

Bajty payloadu definují, která metoda v kontraktu je volána. Jedná se o první 4 bajty z Keccak hashe názvu funkce a typů jejích argumentů, kódované hexadecimálně. Funkce multiply přijímá uint, což je alias pro uint256. To nám dává:

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

Dalším krokem je zakódování argumentů. Existuje pouze jeden uint256, řekněme hodnota 6. ABI má sekci, která specifikuje, jak kódovat typy uint256.

int<M>: enc(X) je big-endian kódování dvojkového doplňku X, doplněné na straně vyššího řádu (vlevo) hodnotou 0xff pro záporné X a nulovými bajty pro kladné X tak, aby délka byla násobkem 32 bajtů.

To se zakóduje jako 0000000000000000000000000000000000000000000000000000000000000006.

Spojením selektoru funkce a zakódovaného argumentu budou naše data 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006.

Toto lze nyní odeslat do uzlu:

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

Protože byla odeslána transakce, byl vrácen hash transakce. Načtení stvrzenky poskytne:

Stvrzenka obsahuje log. Tento log byl vygenerován EVM při provádění transakce a zahrnut do stvrzenky. Funkce multiply ukazuje, že byla vyvolána událost Print se vstupem vynásobeným 7. Vzhledem k tomu, že argumentem pro událost Print byl uint256, můžeme jej dekódovat podle pravidel ABI, což nám poskytne očekávanou desítkovou hodnotu 42. Kromě dat stojí za zmínku, že témata (topics) lze použít k určení, která událost vytvořila log:

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

Toto byl jen stručný úvod do některých nejběžnějších úloh, který demonstruje přímé použití JSON-RPC.