📖 О платформе Erachain

Архитектура

Erachain — это блокчейн-платформа с открытым исходным кодом, написанная на Java 8 с использованием NoSQL-базы данных MapDB. Платформа поддерживает все операционные системы и может работать как в GUI-режиме, так и в headless-режиме (без графического интерфейса).

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

Консенсус Proof-of-Stake & People

Гибридный консенсус, где формирование блоков зависит от экономической доли пользователей в сети (баланса ERA). В отличие от Proof-of-Work (Bitcoin), форжинг не требует мощного оборудования.

Валютная система

ERA — базовая валюта

ERA является официальной внутренней цифровой расчётной единицей, дающей её держателю дополнительные права на управление экосистемой. Участники с 100 ERA и более имеют право на форжинг и верификацию публичных ключей новых пользователей.

• Фиксированная эмиссия: 10 000 000 ERA
• Не подлежит дополнительной эмиссии
• Используется для определения веса в консенсусе

COMPU — расчётная единица

COMPU используется для оплаты транзакций и выдаётся в качестве награды за создание блоков. Эмиссия происходит при верификации публичного ключа и при создании блока.

• Минимальная комиссия транзакции: 0.000159 COMPU
• Максимальный доход форжера: 4 COMPU
• Примерно 6289 финансовых транзакций за 1 COMPU

Встроенные функции

Система идентификации

Технология платформы основана на механизме верификации личности:

1. Анонимный — без персональных данных
2. Верификация — Verifier (100+ ERA) проверяет данные и подтверждает публичный ключ
3. Регистрация — Registrar заносит данные в блокчейн

⚙️ Установка и запуск ноды

Системные требования

Установка на Linux (Ubuntu 20.04)

1. Установка зависимостей

sudo apt update
sudo apt install screen unzip openjdk-8-jre -y

2. Скачивание и распаковка

wget https://github.com/erachain/Erachain/releases/latest/download/Erachain.zip
unzip Erachain.zip
cd Erachain

3. Запуск ноды

# Создание нового кошелька
screen -S erachain
java -jar erachain.jar -pass=YOUR_PASSWORD -seed=1:new:YOUR_PASSWORD -nogui -rpc=on -rpcallowed=127.0.0.1

# Отключение от screen (нода продолжит работать)
Ctrl+A+D

4. Подключение к существующему кошельку

java -jar erachain.jar -pass=YOUR_PASSWORD -nogui -rpc=on -rpcallowed=127.0.0.1

Установка на Windows

1. Установка Java 8

Скачайте и установите Java SE Development Kit 8 с официального сайта Oracle.

2. Сборка из исходников

1. Установите IDE с поддержкой Java
2. File → New → Project from Version Control → Git
3. URL: https://github.com/erachain/Erachain.git
4. После загрузки: Import Gradle project
5. Установите плагин Lombok (Settings → Plugins)
6. Выберите Application, установите Main class: org.erachain.Start
7. Working Directory: \ERA
8. Модуль: ERA_main

3. Сборка JAR

Task: build
Arguments: --exclude-task test

macOS

Создайте файл startARGS.txt в папке проекта (см. примеры в z_START_EXAMPLES/)

-pass=YOUR_PASSWORD
-seed=1:new:YOUR_PASSWORD
-nogui
-rpc=on
-rpcallowed=127.0.0.1

Параметры запуска

CLI-режим

# Запуск в CLI-режиме
java -jar erachain.jar -cli

# Разблокировка кошелька
post wallet/unlock YOUR_PASSWORD

# Получение адресов
get addresses

# Получение seed-фразы
get wallet/seed

# Баланс
get addresses/balance/YOUR_ADDRESS

👛 Управление кошельком

Создание кошелька

При первом запуске Erachain автоматически создаёт кошелёк. Для создания нового кошелька используйте параметр -seed=1:new:PASSWORD:

java -jar erachain.jar -pass=123456789 -seed=1:new:123456789 -nogui

Структура кошелька

Шифрование кошелька

GUI: Settings → Encrypt Wallet → введите надёжный пароль

CLI:

post wallet/encrypt YOUR_PASSWORD

Управление аккаунтами

В одном кошельке можно создать неограниченное количество аккаунтов:

• Анонимные аккаунты — без персональных данных
• Верифицированные аккаунты — с подтверждённой личностью

Просмотр баланса

GUI: Баланс отображается на главной панели

CLI:

get addresses/balance/YOUR_ADDRESS

API:

GET /api/addresses/balance/{address}

Пути к файлам кошелька

💸 Транзакции и переводы

Типы транзакций

Отправка средств (GUI)

1. Перейдите во вкладку Send или Перевод
2. Введите адрес получателя (или отсканируйте QR-код)
3. Выберите актив: ERA или COMPU
4. Укажите сумму перевода
5. Добавьте сообщение (опционально, до 4000 байт)
6. Проверьте комиссию
7. Нажмите Отправить и подтвердите паролем

Отправка через API

POST /api/transaction
{
  "type": 31,
  "creator": "7NhZBb8CeWB...",
  "recipient": "7NhZBb8CeWB...",
  "amount": 100000000,
  "assetKey": 0,
  "feePow": 0,
  "timestamp": 1234567890,
  "signature": "base64_encoded_signature"
}

Расчёт комиссий

Комиссия зависит от:

• Размера транзакции в байтах (минимум 159 байт)
• Типа операции
• Количества вложенных данных/сообщений

Отслеживание транзакции

После отправки транзакция получает уникальный signature (ID):

GET /api/transaction/{signature}

Время подтверждения

🪙 Создание и управление активами

Что можно токенизировать

Erachain поддерживает создание цифровых активов для представления:

• 🏠 Недвижимости и земельных участков
• 🚗 Транспортных средств
• 📋 Услуг и подписок
• 📈 Финансовых инструментов (акции, облигации)
• 📦 Товаров и сырья
• 🎨 Цифровых коллекционных предметов (NFT)

Процесс создания актива

1. Перейдите в раздел Assets → Issue Asset
2. Заполните параметры:
   • Название — уникальное имя актива
   • Количество — общая эмиссия
   • Делимость — знаков после запятой (0-8)
   • Описание — метаданные
3. Укажите тип: взаимозаменяемый или уникальный
4. Определите права владельца
5. Оплатите комиссию (в COMPU)
6. Подпишите транзакцию

Параметры актива

Передача актива

Активы передаются аналогично ERA/COMPU:

POST /api/transaction
{
  "type": 31,
  "creator": "ADDRESS",
  "recipient": "ADDRESS",
  "amount": 1000,
  "assetKey": ASSET_ID,
  "feePow": 0
}

Актив в долг (Asset in Debt)

Функция позволяет одолжить актив другому пользователю с условиями возврата:

• Цифровой аккредитив
• Залоговое обеспечение
• Кредитование под проценты

🔄 Внутренняя DEX

Как работает DEX в Erachain

Erachain использует встроенный механизм ордеров на уровне протокола. Все сделки записываются непосредственно в блокчейн — нет необходимости во внешних смарт-контрактах для каждой пары.

Создание ордера

1. Перейдите в раздел Exchange или DEX
2. Выберите торговую пару (ERA/COMPU, ERA/ВашАктив)
3. Тип ордера:
   • Buy — покупка по указанной цене
   • Sell — продажа по указанной цене
4. Укажите количество и цену за единицу
5. Оплатите комиссию сети

Исполнение ордера

После исполнения активы автоматически зачисляются на баланс (минус комиссия).

Отмена ордера

1. Найдите ордер в списке Мои ордера
2. Нажмите Cancel
3. Подпишите транзакцию отмены

Просмотр истории

GET /api/asset/{assetId}/orders
GET /api/trades/{asset1}/{asset2}

🆔 Система идентификации

Уровни идентификации

Процесс верификации

1. Подача заявки — заполните форму:
   • ФИО
   • Фотография
   • Дата и место рождения
   • Биография
   • Контактные данные
2. Проверка Verifier'ом — проверка данных и подтверждение публичного ключа
3. Регистрация — Registrar заносит данные в блокчейн

Роли

• Verifier — проверяет данные, подтверждает ключ. Требование: 100+ ERA
• Registrar — вносит данные в блокчейн. Verifier и Registrar могут быть одним лицом

Ограничения

Проверка статуса

GET /api/person/{address}

⛏️ Форжинг (создание блоков)

Что такое форжинг

Форжинг — процесс создания новых блоков в блокчейне Erachain. Основан на Proof-of-Stake & People — формирование блоков зависит от экономической доли (баланса ERA) пользователя в сети.

Требования

• Минимум 100 ERA на балансе
• Запущенная и синхронизированная нода
• Включён режим форжинга

Активация форжинга

1. Убедитесь, что нода синхронизирована
2. Проверьте баланс: минимум 100 ERA
3. GUI: Settings → Forging → Start Forging
4. Введите пароль кошелька

CLI-активация

post forging/start

Факторы доходности

Мониторинг

GET /api/block/forger/{address}
GET /api/blocks

📋 Делегирование права форжинга

Концепция

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

Процесс делегирования

1. Создайте транзакцию Asset in Debt с активом ERA
2. Укажите адрес делегата (получателя займа)
3. Установите срок и условия возврата
4. Подпишите транзакцию

Доходность

Риски

🔌 REST API

Введение

Erachain предоставляет REST API для программного взаимодействия с блокчейном. Базовый URL: http://localhost:9047

Блоки

GET /api/block/{height}
GET /api/block/last
GET /api/blocks?limit=50&offset=0

Транзакции

GET /api/transaction/{signature}
GET /api/transactions?address={address}&limit=50
GET /api/transactions/unconfirmed

Адреса

GET /api/address/{address}
GET /api/addresses/balance/{address}
GET /api/addresses/assets/{address}

Активы

GET /api/assets?limit=50&offset=0
GET /api/asset/{key}
GET /api/asset/{key}/orders
GET /api/asset/{key}/trades

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

POST /api/transaction
{
  "type": 31,
  "creator": "7NhZBb8CeWB...",
  "recipient": "7NhZBb8CeWB...",
  "amount": 100000000,
  "assetKey": 0,
  "feePow": 0,
  "timestamp": 1234567890,
  "signature": "base64_encoded_signature"
}

Типы транзакций (type)

📡 RPC API

Введение

RPC API предоставляет низкоуровневый доступ к ноде Erachain. Формат запросов — JSON-RPC 2.0.

Базовый запрос

curl -X POST "http://localhost:9047" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "getblockcount",
    "params": [],
    "id": 1
  }'

Wallet RPC

// Разблокировка кошелька
post wallet/unlock YOUR_PASSWORD

// Получение адресов
get addresses

// Получение seed-фразы
get wallet/seed

// Баланс
get addresses/balance/YOUR_ADDRESS

// Экспорт приватного ключа
get addresses/privatekey/YOUR_ADDRESS

Block RPC

get block/HEIGHT
get block/last
get blocks?limit=50&offset=0

Transaction RPC

get transaction/SIGNATURE
get transactions?address=ADDRESS&limit=50
get transactions/unconfirmed

📱 DAPP и смарт-контракты

Архитектура DAPP

DAPP в Erachain состоят из трёх компонентов:

• Смарт-контракт (Java) — бэкенд, развёрнутый в блокчейне
• Фронтенд — веб-интерфейс, взаимодействующий с API
• Хранилище — данные в блокчейне + внешнее (опционально)

Создание DAPP

package org.erachain.dapp;

public class MyDAPP extends DAPP {

    @Override
    public Transaction process() {
        // Логика обработки транзакции
        // Проверка условий
        // Изменение состояния
        return resultTransaction;
    }

    @Override
    public boolean isValid() {
        // Валидация входных данных
        return true;
    }
}

Развёртывание

1. Скомпилируйте DAPP в JAR
2. Загрузите в блокчейн через транзакцию создания DAPP
3. Получите address DAPP — уникальный идентификатор
4. Интегрируйте с фронтендом через API

Взаимодействие с DAPP

POST /api/transaction
{
  "type": 35,  // DAPP transaction
  "creator": "7NhZBb8CeWB...",
  "recipient": "DAPP_ADDRESS",
  "amount": 0,
  "data": "base64_encoded_params",
  "feePow": 0
}

Примеры встроенных DAPP

🛠️ SDK для разработки

JavaScript SDK

npm install erachain-sdk

Репозиторий: github.com/erachain/sdk-js

PHP SDK

composer require erachain/sdk-php

Репозиторий: github.com/erachain/sdk-php

Java SDK

Используйте исходный код Erachain как зависимость в вашем Gradle/Maven проекте.

🔒 Резервное копирование

Файл wallet.dat

Файл wallet.dat содержит все приватные ключи. Его потеря = потеря доступа к средствам.

Резервное копирование

1. Закройте Erachain (не копируйте при запущенном приложении!)
2. Найдите файл wallet.dat
3. Скопируйте в надёжное место:
   • Внешний USB-накопитель
   • Зашифрованный архив
   • Облако (только если зашифровано!)
4. Сделайте минимум 2 копии в разных физических местах

Восстановление

1. Установите Erachain на новое устройство
2. Закройте приложение
3. Переименуйте существующий wallet.dat в wallet.dat.old
4. Скопируйте резервный wallet.dat в папку данных
5. Запустите Erachain — кошелёк загрузится автоматически
6. Дождитесь синхронизации

Экспорт приватных ключей

Альтернативный метод — экспорт отдельных ключей:

get addresses/privatekey/YOUR_ADDRESS

USB-кошелёк

java -jar erachain.jar --datadir=/path/to/USB

🛡️ Лучшие практики безопасности

Защита wallet.dat

• ✅ Всегда шифруйте кошелёк паролем
• ✅ Используйте сложный пароль (16+ символов)
• ✅ Храните бэкапы офлайн
• ✅ Делайте регулярные бэкапы

Безопасность транзакций

• ✅ Проверяйте адрес по первым и последним 6 символам
• ✅ Используйте QR-коды вместо ручного ввода
• ✅ Отправляйте тестовую сумму перед крупным переводом

Защита от фишинга

• ❌ Никогда не вводите приватные ключи на сторонних сайтах
• ❌ Не скачивайте кошелёк с неофициальных источников
• ✅ Используйте только официальный GitHub репозиторий Erachain

Сетевая безопасность

Чек-лист безопасности

📚 Глоссарий терминов

А

Актив (Asset)

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

Адрес (Address)

Публичный идентификатор аккаунта для получения средств. Производится из публичного ключа.

Анонимный аккаунт

Аккаунт без верифицированных персональных данных. Имеет ограниченные возможности.

Б

Блок (Block)

Набор транзакций, записанных в блокчейн. В Erachain — каждые 288 секунд, до 20 000 транзакций.

Блокчейн

Распределённый реестр, в котором хранятся все транзакции сети.

В

Верификация

Процесс подтверждения личности пользователя. Требует 100+ ERA на балансе Verifier'а.

Верифицированный аккаунт

Аккаунт с подтверждённой личностью. Имеет право на форжинг и верификацию других.

Д

Делегирование

Передача права форжинга другому пользователю через механизм займа ERA.

DEX

Децентрализованная биржа. В Erachain — встроенный механизм обмена активами на уровне протокола.

К

COMPU

Внутренняя расчётная единица Erachain. Используется для оплаты комиссий и наград за блоки.

Консенсус

Механизм достижения согласия в сети. В Erachain — Proof-of-Stake & People.

Ф

Форжинг (Forging)

Процесс создания новых блоков в блокчейне. Требует минимум 100 ERA на балансе.

Форжер (Forger)

Пользователь, участвующий в создании блоков и получающий награду в COMPU.

Э

ERA

Базовая валюта Erachain. Фиксированная эмиссия 10 000 000. Даёт право на форжинг и управление.

Эмиссия

Процесс создания новых единиц валюты. ERA — фиксированная, COMPU — при верификации и форжинге.

❓ Часто задаваемые вопросы

Какая минимальная сумма для форжинга?

100 ERA на балансе аккаунта. Чем больше ERA — тем выше вероятность сформировать блок.

Можно ли восстановить кошелёк без бэкапа?

Нет. Если у вас нет wallet.dat и вы не записали seed-фразу — восстановить доступ невозможно.

Какая комиссия за транзакцию?

Минимум 0.000159 COMPU. Зависит от размера транзакции в байтах (минимум 159 байт).

Можно ли перевести средства с верифицированного на анонимный аккаунт?

Нет. Это защита от кражи и отмывания средств. Только анонимный → анонимный и верифицированный → верифицированный.

Как долго синхронизируется нода?

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

Можно ли запустить ноду без GUI?

Да, используйте флаг -nogui или -cli для командной строки.

Какой Java нужен?

Java 8 (JDK 1.8). Другие версии могут вызвать ошибки с MapDB.

Где взять ERA?

ERA можно приобрести на биржах, где торгуется Erachain, или получить у других участников сети.

Что такое COMPU и как его получить?

COMPU выдаётся при верификации публичного ключа и как награда за форжинг блоков.

Как создать свой токен?

GUI: Assets → Issue Asset. Укажите название, количество, делимость и тип актива.

⚡ Технические параметры сети

Блокчейн

Валюта

Форжинг

API

Системные требования