Перейти к основному контенту
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 задокументирован на странице Execution API (opens in a new tab) и включает Инспектор для тестирования всех доступных методов.

Соглашения

Кодирование шестнадцатеричных значений

Через 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" — для ожидающего состояния/транзакций

Примеры

На этой странице мы приводим примеры использования отдельных конечных точек API JSON_RPC с помощью инструмента командной строки curl (opens in a new tab). Примеры для этих отдельных конечных точек находятся ниже в разделе Примеры использования curl. Далее на странице мы также приводим комплексный пример компиляции и развертывания смарт-контракта с использованием узла Geth, API JSON_RPC и 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. Она также показывает, какие методы и сети поддерживаются различными провайдерами узлов.

Методы API JSON-RPC

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

Извлечь элемент отображения (map) сложнее. Позиция элемента в отображении вычисляется с помощью:

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

Возвращает количество дядей в блоке, соответствующем заданному хешу блока.

Попробовать эндпоинт в песочнице (opens in a new tab)

Параметры

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

Возвращает

QUANTITY — целое число, количество дядей в этом блоке.

Пример

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

eth_getUncleCountByBlockNumber

Возвращает количество дядей в блоке, соответствующем заданному номеру блока.

Попробовать эндпоинт в песочнице (opens in a new tab)

Параметры

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

Возвращает

QUANTITY — целое число, обозначающее количество дядей в этом блоке.

Пример

// Запрос
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 — (необязательно) целое число значения, отправленного с этой транзакцией
  • 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 для блоков доказательства доли владения (после Слияния).
  • 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 — r подписи ECDSA
  • s: QUANTITY — s подписи ECDSA

Пример

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

Возвращает информацию об анкле блока по хешу и позиции индекса анкла.

Опробовать эндпоинт в песочнице (opens in a new tab)

Параметры

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

Возвращает См. eth_getBlockByHash

Пример

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

Результат см. в eth_getBlockByHash

Примечание: анкл не содержит отдельных транзакций.

eth_getUncleByBlockNumberAndIndex

Возвращает информацию о дяде блока по номеру и позиции индекса дяди.

Попробовать эндпоинт в песочнице (opens in a new tab)

Параметры

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

Возвращает См. eth_getBlockByHash

Примечание: дядя не содержит отдельных транзакций.

Пример

// Запрос
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

Удаляет фильтр с заданным идентификатором. Его всегда следует вызывать, когда наблюдение больше не требуется. Кроме того, фильтры удаляются по тайм-ауту, если они не запрашиваются с помощью eth_getFilterChanges в течение некоторого времени.

Параметры

  1. QUANTITY — идентификатор фильтра.
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 индексированных аргументов лога DATA по 32 байта. (В 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 с параметрами «или» (or).
  • 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. Нулевой результат (null) вместо квитанции означает, что транзакция еще не была включена в блок. Подождите немного, проверьте, запущен ли ваш клиент консенсуса, и повторите попытку.

Взаимодействие со смарт-контрактами

В этом примере мы отправим транзакцию с использованием eth_sendTransaction к методу контракта multiply.

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

Байты полезной нагрузки определяют, какой метод в контракте вызывается. Это первые 4 байта хеша Keccak от имени функции и типов ее аргументов, закодированные в шестнадцатеричном формате. Функция multiply принимает uint, который является псевдонимом для uint256. В результате мы получаем:

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

Следующий шаг — закодировать аргументы. Имеется только один uint256, скажем, значение 6. В ABI есть раздел, в котором указано, как кодировать типы uint256.

int<M>: enc(X) — это кодирование X в дополнительном коде с прямым порядком байтов, дополненное со стороны старших разрядов (слева) байтами 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.