TOC

Введение в EthereumJ

Введение в EthereumJ

1. Вступление

В этой статье мы рассмотрим библиотекуEthereumJ, которая позволяет нам взаимодействовать с блокчейномEthereum, используя Java.

Во-первых, давайте кратко рассмотрим, что это за технология.

2. Об Ethereum

Ethereum - этоcryptocurrency, использующий распределенную одноранговую базу данных в виде программируемойblockchain, виртуальной машины Ethereum (EVM). Он синхронизирован и управляется через разрозненный, но связанныйnodes.

По состоянию на 2017 годNodes синхронизируетblockchain посредством консенсуса, создает монеты посредством майнинга (proof of work), проверяет транзакции, выполняетsmart contracts, записанный вSolidity, и запускает EVM.

blockchain делится наblocks, которые содержатaccount states (включая транзакции междуaccounts) иproof of work.

3. Ethereum Facade

Классorg.ethereum.facade.Ethereum абстрагирует и объединяет множество пакетов EthereumJ в один простой в использовании интерфейс.

Можно подключиться к узлу для синхронизации с общей сетью, и после подключения мы можем работать с блокчейном.

Создать фасадный объект так же просто, как: 

Ethereum ethereum = EthereumFactory.createEthereum();

4. Подключение к сети Ethereum

Чтобы подключиться к сети, мы должны сначала подключиться к узлу, i.e., серверу, на котором запущен официальный клиент. Узлы представлены классомorg.ethereum.net.rlpx.Node.

org.ethereum.listener.EthereumListenerAdapter обрабатывает события блокчейна, обнаруженные нашим клиентом после успешного подключения к узлу.

4.1. Подключение к сети Ethereum

Давайте подключимся к узлу в сети. Это можно сделать вручную: 

String ip = "http://localhost";
int port = 8345;
String nodeId = "a4de274d3a159e10c2c9a68c326511236381b84c9ec...";

ethereum.connect(ip, port, nodeId);

Подключение к сети также может быть сделано автоматически с помощью bean-компонента: 

public class EthBean {
    private Ethereum ethereum;

    public void start() {
        ethereum = EthereumFactory.createEthereum();
        ethereum.addListener(new EthListener(ethereum));
    }

    public Block getBestBlock() {
        return ethereum.getBlockchain().getBestBlock();
    }

    public BigInteger getTotalDifficulty() {
        return ethereum.getBlockchain().getTotalDifficulty();
    }
}

Затем мы можем ввести нашEthBean в конфигурацию нашего приложения. Затем он автоматически подключается к сети Ethereum и начинает загрузку блокчейна.

Фактически, большая часть обработки соединений удобно обертывается и абстрагируется путем простого добавления экземпляраorg.ethereum.listener.EthereumListenerAdapter к нашему созданному экземпляруorg.ethereum.facade.Ethereum, как мы это сделали в нашем методеstart() выше: 

EthBean eBean = new EthBean();
Executors.newSingleThreadExecutor().submit(eBean::start);

4.2. Обработка блокчейна с помощью слушателя

Мы также можем создать подклассEthereumListenerAdapter для обработки событий блокчейна, обнаруженных нашим клиентом.

Для выполнения этого шага нам нужно сделать наш подкласс слушателя: 

public class EthListener extends EthereumListenerAdapter {

    private void out(String t) {
        l.info(t);
    }

    //...

    @Override
    public void onBlock(Block block, List receipts) {
        if (syncDone) {
            out("Net hash rate: " + calcNetHashRate(block));
            out("Block difficulty: " + block.getDifficultyBI().toString());
            out("Block transactions: " + block.getTransactionsList().toString());
            out("Best block (last block): " + ethereum
              .getBlockchain()
              .getBestBlock().toString());
            out("Total difficulty: " + ethereum
              .getBlockchain()
              .getTotalDifficulty().toString());
        }
    }

    @Override
    public void onSyncDone(SyncState state) {
        out("onSyncDone " + state);
        if (!syncDone) {
            out(" ** SYNC DONE ** ");
            syncDone = true;
        }
    }
}

МетодonBlock() запускается при получении любого нового блока (старого или текущего). EthereumJ представляет и обрабатывает блоки с использованием классаorg.ethereum.core.Block.

МетодonSyncDone() запускается после завершения синхронизации, обновляя наши локальные данные Ethereum.

5. Работа с блокчейном

Теперь, когда мы можем подключиться к сети Ethereum и работать напрямую с блокчейном, мы рассмотрим несколько основных, но, тем не менее, очень важных операций, которые мы будем часто использовать.

5.1. Отправка транзакции

Теперь, когда мы подключились к блокчейну, мы можем отправить транзакцию. ОтправитьTransaction относительно просто, но создание фактическогоTransaction само по себе длинная тема: 

ethereum.submitTransaction(new Transaction(new byte[]));

5.2. Доступ к объектуBlockchain

The Метод[.pl-en]# getBlockchain#() возвращает объект фасадаBlockchain с геттерами для получения текущих сетевых трудностей и конкретныхBlocks.

Поскольку мы настроили нашEthereumListener в разделе 4.3, мы можем получить доступ к цепочке блоков, используя вышеуказанный метод: 

ethereum.getBlockchain();

5.3. Возврат адреса учетной записи Ethereum

Мы также можем вернуть EthereumAddress.

Чтобы получить EthereumAccount –, нам сначала нужно аутентифицировать пару открытого и закрытого ключей в блокчейне.

Давайте создадим новый ключ с новой случайной парой ключей: 

org.ethereum.crypto.ECKey key = new ECKey();

И давайте создадим ключ из заданного закрытого ключа: 

org.ethereum.crypto.ECKey key = ECKey.fromPivate(privKey);

Затем мы можем использовать наш ключ для инициализацииAccount. Вызывая.init(), мы устанавливаем какECKey, так и связанныйAddress на объектеAccount: 

org.ethereum.core.Account account = new Account();
account.init(key);

6. Другая функциональность

Фреймворк предоставляет две другие основные функции, которые мы здесь не будем рассматривать, но о которых стоит упомянуть.

Во-первых, у нас есть возможность составлять и выполнять интеллектуальные контракты Solidity. Тем не менее, создание контрактов в Solidity, а затем их компиляция и выполнение - обширная тема сама по себе.

Во-вторых, хотя платформа поддерживает ограниченный майнинг с использованием ЦП, рекомендуется использовать майнер на основе графического процессора, учитывая недостаточную прибыльность первого.

Более сложные темы, касающиеся самого Ethereum, можно найти в официальномdocs.

7. Заключение

В этом кратком руководстве мы показали, как подключиться к сети Ethereum, и несколько важных методов работы с блокчейном.

Как всегда, код, используемый в этом примере, находится вover on GitHub.

Related