Перейти до основного вмісту
Change page

JSON-RPC API

Щоб програмний застосунок міг взаємодіяти з блокчейном Етеріуму — читаючи дані блокчейну або надсилаючи транзакції в мережу — він має підключитися до вузла Етеріуму.

Для цього кожен клієнт Етеріуму реалізує специфікацію JSON-RPC (opens in a new tab), тому існує єдиний набір методів, на який застосунки можуть покладатися незалежно від конкретного вузла або реалізації клієнта.

JSON-RPC (opens in a new tab) — це легкий протокол віддаленого виклику процедур (RPC) без збереження стану. Він визначає кілька структур даних і правила їх обробки. Він не залежить від транспорту, оскільки його концепції можна використовувати в межах одного процесу, через сокети, через HTTP або в багатьох різних середовищах передачі повідомлень. Він використовує JSON (RFC 4627) як формат даних.

Реалізації клієнтів

Клієнти Етеріуму можуть використовувати різні мови програмування під час реалізації специфікації JSON-RPC. Перегляньте документацію окремих клієнтів для отримання додаткової інформації щодо конкретних мов програмування. Ми рекомендуємо перевіряти документацію кожного клієнта щодо найновішої інформації про підтримку API.

Зручні бібліотеки

Хоча ви можете взаємодіяти з клієнтами Етеріуму безпосередньо через JSON-RPC API, часто існують простіші варіанти для розробників децентралізованих застосунків (dapp). Існує багато бібліотек JavaScript та API бекенду, які надають обгортки поверх JSON-RPC API. За допомогою цих бібліотек розробники можуть писати інтуїтивно зрозумілі однорядкові методи обраною мовою програмування для ініціалізації запитів JSON-RPC (внутрішньо), які взаємодіють з Етеріумом.

API клієнтів консенсусу

Ця сторінка в основному присвячена JSON-RPC API, який використовується клієнтами виконання Етеріуму. Однак клієнти консенсусу також мають RPC API, який дозволяє користувачам запитувати інформацію про вузол, запитувати блоки Beacon, стан Beacon та іншу інформацію, пов'язану з консенсусом, безпосередньо з вузла. Цей API задокументовано на вебсторінці Beacon API (opens in a new tab).

Внутрішній API також використовується для зв'язку між клієнтами всередині вузла — тобто він дозволяє клієнту консенсусу та клієнту виконання обмінюватися даними. Він називається «Engine API», а його специфікації доступні на GitHub (opens in a new tab).

Специфікація клієнта виконання

Ознайомтеся з повною специфікацією JSON-RPC API на GitHub (opens in a new tab). Цей API задокументовано на вебсторінці API виконання (opens in a new tab) та містить інструмент Inspector для тестування всіх доступних методів.

Угоди

Кодування шістнадцяткових значень

Через JSON передаються два ключові типи даних: неформатовані масиви байтів та величини. Обидва передаються у шістнадцятковому кодуванні, але з різними вимогами до форматування.

Величини

При кодуванні величин (цілих чисел, чисел): кодуйте у шістнадцятковому форматі, додавайте префікс «0x», використовуйте найбільш компактне представлення (невеликий виняток: нуль має бути представлений як «0x0»).

Ось кілька прикладів:

  • 0x41 (65 у десятковій системі)
  • 0x400 (1024 у десятковій системі)
  • НЕПРАВИЛЬНО: 0x (завжди має бути принаймні одна цифра — нуль це «0x0»)
  • НЕПРАВИЛЬНО: 0x0400 (початкові нулі не допускаються)
  • НЕПРАВИЛЬНО: ff (має бути префікс 0x)

Неформатовані дані

При кодуванні неформатованих даних (масивів байтів, адрес акаунтів, хешів, масивів байт-коду): кодуйте у шістнадцятковому форматі, додавайте префікс «0x», по дві шістнадцяткові цифри на байт.

Ось кілька прикладів:

  • 0x41 (розмір 1, «A»)
  • 0x004200 (розмір 3, «0B0»)
  • 0x (розмір 0, «»)
  • НЕПРАВИЛЬНО: 0xf0f0f (має бути парна кількість цифр)
  • НЕПРАВИЛЬНО: 004200 (має бути префікс 0x)

Параметр блоку

Наступні методи мають параметр блоку:

Коли виконуються запити, які опитують стан Етеріуму, наданий параметр блоку визначає висоту блоку.

Для параметра блоку можливі такі варіанти:

  • HEX String — ціле число, номер блоку
  • String "earliest" для найранішого/генезис-блоку
  • String "latest" — для останнього запропонованого блоку
  • String "safe" — для останнього безпечного головного блоку
  • String "finalized" — для останнього фіналізованого блоку
  • String "pending" — для стану/транзакцій в очікуванні

Приклади

На цій сторінці ми наводимо приклади того, як використовувати окремі кінцеві точки JSON_RPC API за допомогою інструмента командного рядка curl (opens in a new tab). Ці приклади окремих кінцевих точок наведено нижче в розділі Приклади використання curl. Далі на сторінці ми також наводимо наскрізний приклад компіляції та розгортання смарт-контракту з використанням вузла Geth, JSON_RPC API та curl.

Приклади curl

Нижче наведено приклади використання API JSON_RPC шляхом виконання curl (opens in a new tab)-запитів до вузла Етеріуму. Кожен приклад містить опис конкретної кінцевої точки, її параметрів, типу повернення та практичний приклад її використання.

Запити curl можуть повертати повідомлення про помилку, пов'язане з типом контенту. Це відбувається тому, що параметр --data встановлює тип контенту як application/x-www-form-urlencoded. Якщо ваш вузол видає помилку через це, встановіть заголовок вручну, додавши -H "Content-Type: application/json" на початку виклику. Приклади також не містять комбінації URL/IP та порту, яка має бути останнім аргументом, переданим до curl (наприклад, 127.0.0.1:8545). Повний запит curl із цими додатковими даними має такий вигляд:

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

Gossip, стан та історія

Кілька основних методів JSON-RPC потребують даних з мережі Етеріум і чітко поділяються на три основні категорії: Gossip, стан та історія. Використовуйте посилання в цих розділах, щоб перейти до кожного методу, або скористайтеся змістом, щоб переглянути весь список методів.

Методи Gossip

Ці методи відстежують вершину ланцюга. Саме так транзакції поширюються мережею, потрапляють у блоки, а клієнти дізнаються про нові блоки.

Методи стану

Методи, які повідомляють про поточний стан усіх збережених даних. «Стан» схожий на один великий спільний обсяг оперативної пам'яті та включає баланси акаунтів, дані контрактів і оцінки витрат газу.

Методи історії

Отримують історичні записи кожного блоку аж до генезис-блоку. Це схоже на один великий файл, у який можна лише додавати дані, і він містить усі заголовки блоків, тіла блоків, uncle-блоки та квитанції транзакцій.

Пісочниця JSON-RPC API

Ви можете використовувати інструмент пісочниці (opens in a new tab), щоб знаходити та випробовувати методи API. Він також показує, які методи та мережі підтримуються різними провайдерами вузлів.

Методи JSON-RPC API

web3_clientVersion

Повертає поточну версію клієнта.

Параметри

Немає

Повертає

String - поточна версія клієнта

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// Результат
{
  "id":67,
  "jsonrpc":"2.0",
  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
}

web3_sha3

Повертає Keccak-256 (а не стандартизований SHA3-256) із заданих даних.

Параметри

  1. DATA - Дані для перетворення на хеш SHA3
params: ["0x68656c6c6f20776f726c64"]

Повертає

DATA - Результат SHA3 для заданого рядка.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// Результат
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}

net_version

Повертає поточний ідентифікатор мережі.

Параметри

Немає

Повертає

String — поточний ідентифікатор мережі.

Повний список поточних ідентифікаторів мереж доступний на chainlist.org (opens in a new tab). Деякі з найпоширеніших:

  • 1: головна мережа Ethereum
  • 11155111: тестова мережа Sepolia
  • 560048 : тестова мережа Hoodi

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// Результат
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "3"
}

net_listening

Повертає true, якщо клієнт активно прослуховує мережеві з'єднання.

Параметри

Немає

Повертає

Boolean - true під час прослуховування, інакше false.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// Результат
{
  "id":67,
  "jsonrpc":"2.0",
  "result":true
}

net_peerCount

Повертає кількість пірів, які наразі підключені до клієнта.

Параметри

Немає

Повертає

QUANTITY - ціле число, що позначає кількість підключених пірів.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// Результат
{
  "id":74,
  "jsonrpc": "2.0",
  "result": "0x2" // 2
}

eth_protocolVersion

Повертає поточну версію протоколу Етеріум. Зверніть увагу, що цей метод недоступний у Geth (opens in a new tab).

Параметри

Немає

Повертає

String — поточна версія протоколу Етеріум

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// Результат
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "54"
}

eth_syncing

Повертає об'єкт з даними про статус синхронізації або false.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

Немає

Повертає

Точні дані, що повертаються, відрізняються залежно від реалізації клієнта. Усі клієнти повертають False, коли вузол не синхронізується, і всі клієнти повертають наступні поля.

Object|Boolean, Об'єкт з даними про статус синхронізації або FALSE, коли синхронізація не виконується:

  • startingBlock: QUANTITY - Блок, на якому розпочався імпорт (буде скинуто лише після того, як синхронізація досягне його вершини)
  • currentBlock: QUANTITY - Поточний блок, те саме, що й eth_blockNumber
  • highestBlock: QUANTITY - Очікуваний найвищий блок

Однак окремі клієнти також можуть надавати додаткові дані. Наприклад, Geth повертає наступне:

Тоді як Бесу повертає:

Зверніться до документації вашого конкретного клієнта для отримання додаткової інформації.

Приклад

eth_coinbase

Повертає адресу coinbase клієнта.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Примітка: Цей метод визнано застарілим починаючи з версії v1.14.0 і більше не підтримується. Спроба використати цей метод призведе до помилки "Method not supported".

Параметри

Немає

Повертає

DATA, 20 байтів — поточна адреса coinbase.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// Результат
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_chainId

Повертає ID ланцюга, що використовується для підписання транзакцій, захищених від повторного відтворення.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

Немає

Повертає

chainId — шістнадцяткове значення у вигляді рядка, що представляє ціле число поточного ID ланцюга.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
// Результат
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "0x1"
}

eth_mining

Повертає true, якщо клієнт активно майнить нові блоки. Це може повернути true лише для мереж із доказом виконання роботи (PoW) і може бути недоступним у деяких клієнтах після Злиття.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

Немає

Повертає

Boolean — повертає true, якщо клієнт майнить, інакше false.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
//
{
  "id":71,
  "jsonrpc": "2.0",
  "result": true
}

eth_hashrate

Повертає кількість хешів за секунду, з якою вузол здійснює майнінг. Це може повернути true лише для мереж із доказом виконання роботи (PoW) і може бути недоступним у деяких клієнтах після Злиття.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

Немає

Повертає

QUANTITY — кількість хешів за секунду.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// Результат
{
  "id":71,
  "jsonrpc": "2.0",
  "result": "0x38a"
}

eth_gasPrice

Повертає оцінку поточної ціни за газ у Wei. Наприклад, клієнт Бесу за замовчуванням перевіряє останні 100 блоків і повертає медіанну ціну за одиницю газу.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

Немає

Повертає

QUANTITY — ціле число поточної ціни газу у Wei.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// Результат
{
  "id":73,
  "jsonrpc": "2.0",
  "result": "0x1dfd14000" // 8049999872 Wei
}

eth_accounts

Повертає список адрес, що належать клієнту.

Спробувати ендпоінт у пісочниці (opens in a new tab)

Параметри

Немає

Повертає

Array of DATA, 20 байтів - адреси, що належать клієнту.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

eth_blockNumber

Повертає номер останнього блоку.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

Немає

Повертає

QUANTITY — ціле число поточного номера блоку, на якому знаходиться клієнт.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// Результат
{
  "id":83,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}

eth_getBalance

Повертає баланс акаунта за вказаною адресою.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 20 байтів — адреса для перевірки балансу.
  2. QUANTITY|TAG — ціле число номера блоку або рядок "latest", "earliest", "pending", "safe" чи "finalized", див. параметр блоку
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]

Повертає

QUANTITY — ціле число поточного балансу у Wei.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58" // 158972490234375000
}

eth_getStorageAt

Повертає значення з позиції сховища за вказаною адресою.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 20 байтів — адреса сховища.
  2. QUANTITY — ціле число позиції у сховищі.
  3. QUANTITY|TAG — ціле число номера блоку або рядок "latest", "earliest", "pending", "safe", "finalized", див. параметр блоку

Повертає

DATA — значення на цій позиції сховища.

Приклад Обчислення правильної позиції залежить від сховища, яке потрібно отримати. Розглянемо наступний контракт, розгорнутий за адресою 0x295a70b2de5e3953354a6a8344e616ed314d7251 з адреси 0x391694e7e0b0cce554cb130d723a9d27458f9298.

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

Отримання значення pos0 є простим:

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

Отримати елемент відображення складніше. Позиція елемента у відображенні обчислюється за допомогою:

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

Це означає, що для отримання сховища на pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] нам потрібно обчислити позицію за допомогою:

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

Консоль Geth, яка постачається з бібліотекою Web3, може бути використана для виконання цього обчислення:

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

Тепер, щоб отримати дані зі сховища:

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

Повертає кількість транзакцій, відправлених з адреси.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 20 байтів - адреса.
  2. QUANTITY|TAG - цілочисельний номер блоку або рядок "latest", "earliest", "pending", "safe" чи "finalized", див. параметр блоку
params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "latest", // стан на останньому блоці
]

Повертає

QUANTITY - ціле число кількості транзакцій, відправлених з цієї адреси.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getBlockTransactionCountByHash

Повертає кількість транзакцій у блоці для блоку, що відповідає заданому хешу блоку.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 32 байти — хеш блоку
params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]

Повертає

QUANTITY — ціле число, що позначає кількість транзакцій у цьому блоці.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getBlockTransactionCountByNumber

Повертає кількість транзакцій у блоці, що відповідає заданому номеру блоку.

Випробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. QUANTITY|TAG — ціле число номера блоку, або рядок "earliest", "latest", "pending", "safe" чи "finalized", як у параметрі блоку.
params: [
  "0x13738ca", // 20396234
]

Повертає

QUANTITY — ціле число, що позначає кількість транзакцій у цьому блоці.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getUncleCountByBlockHash

Повертає кількість uncle-блоків у блоці, що відповідає заданому хешу блоку.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 32 байти — хеш блоку
params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]

Повертає

QUANTITY — ціле число, що позначає кількість uncle-блоків у цьому блоці.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getUncleCountByBlockNumber

Повертає кількість uncle-блоків у блоці, що відповідає заданому номеру блоку.

Спробувати ендпоінт у пісочниці (opens in a new tab)

Параметри

  1. QUANTITY|TAG — ціле число, що позначає номер блоку, або рядок "latest", "earliest", "pending", "safe" чи "finalized", див. параметр блоку
params: [
  "0xe8", // 232
]

Повертає

QUANTITY — ціле число, що позначає кількість uncle-блоків у цьому блоці.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0" // 0
}

eth_getCode

Повертає код за вказаною адресою.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 20 байтів - адреса
  2. QUANTITY|TAG - цілочисельний номер блоку або рядок "latest", "earliest", "pending", "safe" чи "finalized", див. параметр блоку
params: [
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "0x5daf3b", // 6139707
]

Повертає

DATA - код із вказаної адреси.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
}

eth_sign

Метод sign обчислює специфічний для Етеріуму підпис за допомогою: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).

Додавання префікса до повідомлення робить обчислений підпис розпізнаваним як специфічний для Етеріуму підпис. Це запобігає зловживанням, коли зловмисний децентралізований застосунок (dapp) може підписати довільні дані (наприклад, транзакцію) і використати підпис, щоб видати себе за жертву.

Примітка: адреса для підпису має бути розблокована.

Параметри

  1. DATA, 20 байтів - адреса
  2. DATA, N байтів - повідомлення для підпису

Повертає

DATA: Підпис

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_signTransaction

Підписує транзакцію, яка може бути відправлена в мережу пізніше за допомогою eth_sendRawTransaction.

Параметри

  1. Object - Об'єкт транзакції
  • type:
  • from: DATA, 20 байтів - Адреса, з якої відправляється транзакція.
  • to: DATA, 20 байтів - (необов'язково при створенні нового контракту) Адреса, на яку спрямована транзакція.
  • gas: QUANTITY - (необов'язково, за замовчуванням: 90000) Ціле число газу, наданого для виконання транзакції. Невикористаний газ буде повернено.
  • gasPrice: QUANTITY - (необов'язково, за замовчуванням: буде визначено) Ціле число gasPrice, що використовується для кожної одиниці оплаченого газу, у Wei.
  • value: QUANTITY - (необов'язково) Ціле число значення, відправленого з цією транзакцією, у Wei.
  • data: DATA - Скомпільований код контракту АБО хеш підпису викликаного методу та закодованих параметрів.
  • nonce: QUANTITY - (необов'язково) Ціле число нонсу. Це дозволяє перезаписувати ваші власні транзакції в очікуванні, які використовують той самий нонс.

Повертає

DATA, Об'єкт транзакції в кодуванні RLP, підписаний вказаним акаунтом.

Приклад

// Запит
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"}]}'
// Результат
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_sendTransaction

Створює нову транзакцію виклику повідомлення або створення контракту, якщо поле даних містить код, і підписує її за допомогою акаунта, вказаного в from.

Параметри

  1. Object - Об'єкт транзакції
  • from: DATA, 20 байтів - Адреса, з якої надсилається транзакція.
  • to: DATA, 20 байтів - (необов'язково при створенні нового контракту) Адреса, на яку спрямована транзакція.
  • gas: QUANTITY - (необов'язково, за замовчуванням: 90000) Ціле число газу, наданого для виконання транзакції. Невикористаний газ буде повернуто.
  • gasPrice: QUANTITY - (необов'язково, за замовчуванням: визначається пізніше) Ціле число gasPrice, що використовується для кожної одиниці оплаченого газу.
  • value: QUANTITY - (необов'язково) Ціле число значення, надісланого з цією транзакцією.
  • input: DATA - Скомпільований код контракту АБО хеш підпису викликаного методу та закодованих параметрів.
  • nonce: QUANTITY - (необов'язково) Ціле число нонсу. Це дозволяє перезаписувати ваші власні транзакції в очікуванні, які використовують той самий нонс.

Повертає

DATA, 32 байти - хеш транзакції або нульовий хеш, якщо транзакція ще недоступна.

Використовуйте eth_getTransactionReceipt, щоб отримати адресу контракту після того, як транзакція була запропонована в блоці, якщо ви створили контракт.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_sendRawTransaction

Створює нову транзакцію виклику повідомлення або створення контракту для підписаних транзакцій.

Параметри

  1. DATA, Дані підписаної транзакції.
params: [
  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
]

Повертає

DATA, 32 байти — хеш транзакції або нульовий хеш, якщо транзакція ще недоступна.

Використовуйте eth_getTransactionReceipt, щоб отримати адресу контракту після того, як транзакція була запропонована в блоці, якщо ви створили контракт.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

Негайно виконує новий виклик повідомлення без створення транзакції в блокчейні. Часто використовується для виконання функцій смарт-контракту лише для читання, наприклад, balanceOf для контракту ERC-20.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. Object - Об'єкт виклику транзакції
  • from: DATA, 20 байтів - (необов'язково) Адреса, з якої надсилається транзакція.
  • to: DATA, 20 байтів - Адреса, на яку спрямована транзакція.
  • gas: QUANTITY - (необов'язково) Ціле число, що визначає обсяг газу, наданого для виконання транзакції. eth_call споживає нуль газу, але цей параметр може знадобитися для деяких виконань.
  • gasPrice: QUANTITY - (необов'язково) Ціле число, що визначає ціну газу (gasPrice), яка використовується для кожної оплаченої одиниці газу
  • value: QUANTITY - (необов'язково) Ціле число, що визначає значення (value), надіслане з цією транзакцією
  • input: DATA - (необов'язково) Хеш підпису методу та закодованих параметрів. Детальніше див. ABI контрактів Ethereum у документації Solidity (opens in a new tab).
  1. QUANTITY|TAG - ціле число номера блоку або рядок "latest", "earliest", "pending", "safe" або "finalized", див. параметр блоку

Повертає

DATA - значення, що повертається виконаним контрактом.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x"
}

eth_estimateGas

Генерує та повертає оцінку того, скільки газу необхідно для завершення транзакції. Транзакція не буде додана до блокчейну. Зверніть увагу, що оцінка може бути значно більшою за кількість газу, фактично використаного транзакцією, з різних причин, включаючи механіку EVM та продуктивність вузла.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

Дивіться параметри eth_call, за винятком того, що всі властивості є необов'язковими. Якщо ліміт газу не вказано, geth використовує ліміт газу очікуючого блоку як верхню межу. У результаті повернутої оцінки може бути недостатньо для виконання виклику/транзакції, якщо кількість газу перевищує ліміт газу очікуючого блоку.

Повертає

QUANTITY — кількість використаного газу.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}

eth_getBlockByHash

Повертає інформацію про блок за хешем.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 32 байти — хеш блоку.
  2. Boolean — якщо true, повертає повні об'єкти транзакцій, якщо false — лише хеші транзакцій.
params: [
  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
  false,
]

Повертає

Object — об'єкт блоку або null, якщо блок не знайдено:

  • number: QUANTITY — номер блоку. null, якщо це блок в очікуванні.
  • hash: DATA, 32 байти — хеш блоку. null, якщо це блок в очікуванні.
  • parentHash: DATA, 32 байти — хеш батьківського блоку.
  • nonce: DATA, 8 байтів — хеш згенерованого доказу виконання роботи (PoW). null, якщо це блок в очікуванні, 0x0 для блоків доказу частки (PoS) (після Злиття).
  • sha3Uncles: DATA, 32 байти — SHA3 даних uncles у блоці.
  • logsBloom: DATA, 256 байтів — фільтр Блума для логів блоку. null, якщо це блок в очікуванні.
  • transactionsRoot: DATA, 32 байти — корінь дерева транзакцій блоку.
  • stateRoot: DATA, 32 байти — корінь фінального дерева стану блоку.
  • receiptsRoot: DATA, 32 байти — корінь дерева квитанцій блоку.
  • miner: DATA, 20 байтів — адреса бенефіціара, якому було видано винагороду за блок.
  • difficulty: QUANTITY — ціле число складності для цього блоку.
  • totalDifficulty: QUANTITY — ціле число загальної складності ланцюга до цього блоку.
  • extraData: DATA — поле «додаткових даних» (extra data) цього блоку.
  • size: QUANTITY — ціле число розміру цього блоку в байтах.
  • gasLimit: QUANTITY — максимальна кількість газу, дозволена в цьому блоці.
  • gasUsed: QUANTITY — загальна кількість газу, використана всіма транзакціями в цьому блоці.
  • timestamp: QUANTITY — часова мітка Unix, коли блок був сформований.
  • transactions: Array — масив об'єктів транзакцій або 32-байтових хешів транзакцій, залежно від останнього переданого параметра.
  • uncles: Array — масив хешів uncles.

Приклад

eth_getBlockByNumber

Повертає інформацію про блок за його номером.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. QUANTITY|TAG — ціле число номера блоку або рядок "earliest", "latest", "pending", "safe" чи "finalized", як у параметрі блоку.
  2. Boolean — якщо true, повертає повні об'єкти транзакцій, якщо false — лише хеші транзакцій.
params: [
  "0x1b4", // 436
  true,
]

Повертає Див. eth_getBlockByHash

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'

Результат див. у eth_getBlockByHash

eth_getTransactionByHash

Повертає інформацію про транзакцію, запитану за хешем транзакції.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 32 байти — хеш транзакції
params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

Повертає

Object — об'єкт транзакції або null, якщо транзакцію не знайдено:

  • blockHash: DATA, 32 байти — хеш блоку, в якому знаходилася ця транзакція. null, якщо вона в очікуванні.
  • blockNumber: QUANTITY — номер блоку, в якому знаходилася ця транзакція. null, якщо вона в очікуванні.
  • from: DATA, 20 байтів — адреса відправника.
  • gas: QUANTITY — газ, наданий відправником.
  • gasPrice: QUANTITY — ціна газу, надана відправником у Wei.
  • hash: DATA, 32 байти — хеш транзакції.
  • input: DATA — дані, надіслані разом із транзакцією.
  • nonce: QUANTITY — кількість транзакцій, здійснених відправником до цієї.
  • to: DATA, 20 байтів — адреса одержувача. null, якщо це транзакція створення контракту.
  • transactionIndex: QUANTITY — ціле число, що позначає позицію індексу транзакції в блоці. null, якщо вона в очікуванні.
  • value: QUANTITY — переказана сума у Wei.
  • v: QUANTITY — ідентифікатор відновлення ECDSA
  • r: QUANTITY — підпис ECDSA r
  • s: QUANTITY — підпис ECDSA s

Приклад

eth_getTransactionByBlockHashAndIndex

Повертає інформацію про транзакцію за хешем блоку та позицією індексу транзакції.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 32 байти - хеш блоку.
  2. QUANTITY - ціле число позиції індексу транзакції.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

Повертає Див. eth_getTransactionByHash

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

Результат див. у eth_getTransactionByHash

eth_getTransactionByBlockNumberAndIndex

Повертає інформацію про транзакцію за номером блоку та позицією індексу транзакції.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. QUANTITY|TAG - номер блоку або рядок "earliest", "latest", "pending", "safe" чи "finalized", як у параметрі блоку.
  2. QUANTITY - позиція індексу транзакції.
params: [
  "0x9c47cf", // 10241999
  "0x24", // 36
]

Повертає Див. eth_getTransactionByHash

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'

Результат див. у eth_getTransactionByHash

eth_getTransactionReceipt

Повертає квитанцію транзакції за хешем транзакції.

Примітка. Квитанція недоступна для транзакцій, що очікують на виконання.

Параметри

  1. DATA, 32 байти — хеш транзакції
params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]

Повертає Object — об'єкт квитанції транзакції або null, якщо квитанцію не знайдено:

  • transactionHash : DATA, 32 байти — хеш транзакції.
  • transactionIndex: QUANTITY — ціле число, індекс позиції транзакції в блоці.
  • blockHash: DATA, 32 байти — хеш блоку, в якому знаходилася ця транзакція.
  • blockNumber: QUANTITY — номер блоку, в якому знаходилася ця транзакція.
  • from: DATA, 20 байтів — адреса відправника.
  • to: DATA, 20 байтів — адреса отримувача. null, якщо це транзакція створення контракту.
  • cumulativeGasUsed : QUANTITY — загальна кількість газу, використаного під час виконання цієї транзакції в блоці.
  • effectiveGasPrice : QUANTITY — сума базової комісії та пріоритетної комісії, сплачена за одиницю газу.
  • gasUsed : QUANTITY — кількість газу, використаного лише цією конкретною транзакцією.
  • contractAddress : DATA, 20 байтів — адреса створеного контракту, якщо транзакція була створенням контракту, інакше null.
  • logs: Array — масив об'єктів логів, згенерованих цією транзакцією.
  • logsBloom: DATA, 256 байтів — фільтр Блума для легких клієнтів, щоб швидко отримувати пов'язані логи.
  • type: QUANTITY — ціле число, тип транзакції: 0x0 для застарілих транзакцій, 0x1 для типів зі списком доступу, 0x2 для динамічних комісій.

Він також повертає одне з двох:

  • root : DATA 32 байти кореня стану після транзакції (до Бізантіум)
  • status: QUANTITY або 1 (успіх), або 0 (невдача)

Приклад

eth_getUncleByBlockHashAndIndex

Повертає інформацію про uncle-блок за хешем та позицією індексу.

Спробувати кінцеву точку в пісочниці (opens in a new tab)

Параметри

  1. DATA, 32 байти — хеш блоку.
  2. QUANTITY — позиція індексу uncle-блоку.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

Повертає Див. eth_getBlockByHash

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

Результат див. у eth_getBlockByHash

Примітка: uncle-блок не містить окремих транзакцій.

eth_getUncleByBlockNumberAndIndex

Повертає інформацію про uncle-блок за номером блоку та позицією індексу uncle-блоку.

Спробувати ендпоінт у пісочниці (opens in a new tab)

Параметри

  1. QUANTITY|TAG - номер блоку або рядок "earliest", "latest", "pending", "safe", "finalized", як у параметрі блоку.
  2. QUANTITY - позиція індексу uncle-блоку.
params: [
  "0x29c", // 668
  "0x0", // 0
]

Повертає Див. eth_getBlockByHash

Примітка: uncle-блок не містить окремих транзакцій.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'

Результат див. у eth_getBlockByHash

eth_newFilter

Створює об'єкт фільтра на основі параметрів фільтра, щоб сповіщати про зміну стану (логи). Щоб перевірити, чи змінився стан, викличте eth_getFilterChanges.

Примітка щодо вказування фільтрів тем: Теми залежать від порядку. Транзакція з логом із темами [A, B] відповідатиме таким фільтрам тем:

  • [] "будь-що"
  • [A] "A на першій позиції (і будь-що після)"
  • [null, B] "будь-що на першій позиції ТА B на другій позиції (і будь-що після)"
  • [A, B] "A на першій позиції ТА B на другій позиції (і будь-що після)"
  • [[A, B], [A, B]] "(A АБО B) на першій позиції ТА (A АБО B) на другій позиції (і будь-що після)"
  • Параметри
  1. Object - Параметри фільтра:
  • fromBlock: QUANTITY|TAG - (необов'язково, за замовчуванням: "latest") Цілочисельний номер блока, або "latest" для останнього запропонованого блока, "safe" для останнього безпечного блока, "finalized" для останнього фіналізованого блока, або "pending", "earliest" для транзакцій, які ще не включені в блок.
  • toBlock: QUANTITY|TAG - (необов'язково, за замовчуванням: "latest") Цілочисельний номер блока, або "latest" для останнього запропонованого блока, "safe" для останнього безпечного блока, "finalized" для останнього фіналізованого блока, або "pending", "earliest" для транзакцій, які ще не включені в блок.
  • address: DATA|Array, 20 байтів - (необов'язково) Адреса контракту або список адрес, від яких мають походити логи.
  • topics: Array of DATA, - (необов'язково) Масив 32-байтових тем DATA. Теми залежать від порядку. Кожна тема також може бути масивом DATA з параметрами «або».

Повертає QUANTITY - Ідентифікатор фільтра.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_newBlockFilter

Створює фільтр у вузлі для сповіщення про появу нового блоку. Щоб перевірити, чи змінився стан, викличте eth_getFilterChanges.

Параметри Немає

Повертає QUANTITY - Ідентифікатор фільтра.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
// Результат
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_newPendingTransactionFilter

Створює фільтр у вузлі для сповіщення про надходження нових транзакцій в очікуванні. Щоб перевірити, чи змінився стан, викличте eth_getFilterChanges.

Параметри Немає

Повертає QUANTITY — ідентифікатор фільтра.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
// Результат
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_uninstallFilter

Видаляє фільтр із заданим id. Цей метод завжди слід викликати, коли спостереження більше не потрібне. Крім того, час дії фільтрів закінчується, якщо до них не звертаються за допомогою eth_getFilterChanges протягом певного періоду часу.

Параметри

  1. QUANTITY - id фільтра.
params: [
  "0xb", // 11
]

Повертає Boolean - true, якщо фільтр було успішно видалено, інакше false.

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
// Результат
{
  "id":1,
  "jsonrpc": "2.0",
  "result": true
}

eth_getFilterChanges

Метод опитування для фільтра, який повертає масив логів, що з'явилися з моменту останнього опитування.

Параметри

  1. QUANTITY — ідентифікатор фільтра.
params: [
  "0x16", // 22
]

Повертає Array — масив об'єктів логів або порожній масив, якщо з моменту останнього опитування нічого не змінилося.

  • Для фільтрів, створених за допомогою eth_newBlockFilter, повертаються хеші блоків (DATA, 32 байти), наприклад, ["0x3454645634534..."].

  • Для фільтрів, створених за допомогою eth_newPendingTransactionFilter , повертаються хеші транзакцій (DATA, 32 байти), наприклад, ["0x6345343454645..."].

  • Для фільтрів, створених за допомогою eth_newFilter, логи є об'єктами з такими параметрами:

    • removed: TAG — true, якщо лог було видалено через реорганізацію ланцюга. false, якщо це дійсний лог.
    • logIndex: QUANTITY — ціле число, що вказує на позицію індексу логу в блоці. null, якщо це лог в очікуванні.
    • transactionIndex: QUANTITY — ціле число, що вказує на позицію індексу транзакції, з якої було створено лог. null, якщо це лог в очікуванні.
    • transactionHash: DATA, 32 байти — хеш транзакції, з якої було створено цей лог. null, якщо це лог в очікуванні.
    • blockHash: DATA, 32 байти — хеш блоку, в якому знаходився цей лог. null, якщо він в очікуванні. null, якщо це лог в очікуванні.
    • blockNumber: QUANTITY — номер блоку, в якому знаходився цей лог. null, якщо він в очікуванні. null, якщо це лог в очікуванні.
    • address: DATA, 20 байтів — адреса, з якої походить цей лог.
    • data: DATA — неіндексовані дані логу змінної довжини. (У Solidity: нуль або більше неіндексованих аргументів логу по 32 байти.)
    • topics: Array of DATA — масив від 0 до 4 індексованих аргументів логу по 32 байти DATA. (У Solidity: перша тема — це хеш підпису події (наприклад, Deposit(address,bytes32,uint256)), за винятком випадків, коли ви оголосили подію зі специфікатором anonymous.)

  • Приклад

eth_getFilterLogs

Повертає масив усіх логів, що відповідають фільтру із заданим ідентифікатором.

Параметри

  1. QUANTITY - ідентифікатор фільтра.
params: [
  "0x16", // 22
]

Повертає Див. eth_getFilterChanges

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'

Результат див. eth_getFilterChanges

eth_getLogs

Повертає масив усіх логів, що відповідають заданому об'єкту фільтра.

Параметри

  1. Object - Параметри фільтра:
  • fromBlock: QUANTITY|TAG - (необов'язково, за замовчуванням: "latest") Номер блоку у вигляді цілого числа, або "latest" для останнього запропонованого блоку, "safe" для останнього безпечного блоку, "finalized" для останнього фіналізованого блоку, або "pending", "earliest" для транзакцій, які ще не включені в блок.
  • toBlock: QUANTITY|TAG - (необов'язково, за замовчуванням: "latest") Номер блоку у вигляді цілого числа, або "latest" для останнього запропонованого блоку, "safe" для останнього безпечного блоку, "finalized" для останнього фіналізованого блоку, або "pending", "earliest" для транзакцій, які ще не включені в блок.
  • address: DATA|Array, 20 байтів - (необов'язково) Адреса контракту або список адрес, з яких мають походити логи.
  • topics: Array of DATA, - (необов'язково) Масив 32-байтових DATA тем. Порядок тем має значення. Кожна тема також може бути масивом DATA з варіантами "або".
  • blockHash: DATA, 32 байти - (необов'язково, у майбутньому) З додаванням EIP-234, blockHash стане новим параметром фільтра, який обмежує повернені логи одним блоком із 32-байтовим хешем blockHash. Використання blockHash еквівалентно fromBlock = toBlock = номер блоку з хешем blockHash. Якщо blockHash присутній у критеріях фільтра, то ні fromBlock, ні toBlock не допускаються.
params: [
  {
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    ],
  },
]

Повертає Див. eth_getFilterChanges

Приклад

// Запит
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'

Результат див. у eth_getFilterChanges

Приклад використання

Розгортання контракту за допомогою JSON-RPC

Цей розділ містить демонстрацію того, як розгорнути контракт, використовуючи лише інтерфейс RPC. Існують альтернативні шляхи розгортання контрактів, де ця складність абстрагована — наприклад, за допомогою бібліотек, створених поверх інтерфейсу RPC, таких як web3.js (opens in a new tab) та web3.py (opens in a new tab). Ці абстракції, як правило, легше зрозуміти, і вони менш схильні до помилок, але все одно корисно розуміти, що відбувається всередині.

Нижче наведено простий смарт-контракт під назвою Multiply7, який буде розгорнуто за допомогою інтерфейсу JSON-RPC на вузлі Етеріуму. Цей посібник передбачає, що читач вже запустив вузол Geth. Більше інформації про вузли та клієнти доступно тут. Будь ласка, зверніться до документації відповідного клієнта, щоб дізнатися, як запустити HTTP JSON-RPC для клієнтів, відмінних від Geth. Більшість клієнтів за замовчуванням працюють на localhost:8545.

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

Перше, що потрібно зробити, це переконатися, що інтерфейс HTTP RPC увімкнено. Це означає, що ми передаємо Geth прапорець --http під час запуску. У цьому прикладі ми використовуємо вузол Geth у приватному ланцюзі для розробки. Використовуючи цей підхід, нам не потрібен етер у реальній мережі.

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

Це запустить інтерфейс HTTP RPC на http://localhost:8545.

Ми можемо перевірити, що інтерфейс працює, отримавши адресу Coinbase (шляхом отримання першої адреси з масиву акаунтів) та баланс за допомогою curl (opens in a new tab). Зверніть увагу, що дані в цих прикладах будуть відрізнятися на вашому локальному вузлі. Якщо ви хочете спробувати ці команди, замініть параметри запиту в другому запиті curl на результат, повернутий з першого.

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

Оскільки числа закодовані в шістнадцятковому форматі, баланс повертається у Wei як шістнадцятковий рядок. Якщо ми хочемо отримати баланс в етерах як число, ми можемо використати Web3 з консолі Geth.

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

Тепер, коли в нашому приватному ланцюзі для розробки є трохи етеру, ми можемо розгорнути контракт. Першим кроком є компіляція контракту Multiply7 у байт-код, який можна відправити до EVM. Щоб встановити solc, компілятор Solidity, дотримуйтесь документації Solidity (opens in a new tab). (Можливо, ви захочете використати старіший випуск solc, щоб він відповідав версії компілятора, використаній у нашому прикладі (opens in a new tab).)

Наступним кроком є компіляція контракту Multiply7 у байт-код, який можна відправити до 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

Тепер, коли ми маємо скомпільований код, нам потрібно визначити, скільки газу коштуватиме його розгортання. Інтерфейс RPC має метод eth_estimateGas, який надасть нам оцінку.

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

І, нарешті, розгорнути контракт.

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

Транзакція приймається вузлом, і повертається хеш транзакції. Цей хеш можна використовувати для відстеження транзакції. Наступним кроком є визначення адреси, за якою розгорнуто наш контракт. Кожна виконана транзакція створюватиме квитанцію. Ця квитанція містить різноманітну інформацію про транзакцію, наприклад, у який блок була включена транзакція та скільки газу було використано EVM. Якщо транзакція створює контракт, вона також міститиме адресу контракту. Ми можемо отримати квитанцію за допомогою методу RPC 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"}}

Наш контракт було створено за адресою 0x4d03d617d700cf81935d7f797f4e2ae719648262. Нульовий результат замість квитанції означає, що транзакція ще не була включена в блок. Зачекайте хвилинку, перевірте, чи працює ваш клієнт консенсусу, і спробуйте ще раз.

Взаємодія зі смарт-контрактами

У цьому прикладі ми будемо надсилати транзакцію за допомогою eth_sendTransaction до методу multiply контракту.

eth_sendTransaction вимагає кількох аргументів, зокрема from, to та data. From — це публічна адреса нашого акаунта, а to — адреса контракту. Аргумент data містить корисне навантаження, яке визначає, який метод потрібно викликати та з якими аргументами. Тут у гру вступає ABI (двійковий інтерфейс застосунку) (opens in a new tab). ABI — це файл JSON, який визначає, як визначати та кодувати дані для EVM.

Байти корисного навантаження визначають, який метод у контракті викликається. Це перші 4 байти з хешу Кеччак від імені функції та типів її аргументів, закодовані в шістнадцятковому форматі. Функція множення приймає uint, що є псевдонімом для uint256. Це залишає нам:

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

Наступним кроком є кодування аргументів. Є лише один uint256, скажімо, значення 6. ABI має розділ, який визначає, як кодувати типи uint256.

int<M>: enc(X) — це кодування X у доповняльному коді з прямим порядком байтів (big-endian), доповнене з боку старших розрядів (зліва) байтами 0xff для від'ємного X та нульовими байтами для додатного X так, щоб довжина була кратною 32 байтам.

Це кодується як 0000000000000000000000000000000000000000000000000000000000000006.

Поєднуючи селектор функції та закодований аргумент, наші дані будуть 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006.

Тепер це можна відправити до вузла:

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

Оскільки транзакцію було надіслано, повернувся хеш транзакції. Отримання квитанції дає:

Квитанція містить лог. Цей лог був згенерований EVM під час виконання транзакції та включений до квитанції. Функція multiply показує, що подія Print була викликана з вхідним значенням, помноженим на 7. Оскільки аргументом для події Print був uint256, ми можемо декодувати його відповідно до правил ABI, що дасть нам очікуване десяткове число 42. Окрім даних, варто зазначити, що теми (topics) можна використовувати для визначення того, яка подія створила лог:

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

Це був лише короткий вступ до деяких найпоширеніших завдань, що демонструє пряме використання JSON-RPC.