Документация блокчейн-платформы 0x0.su
Версия 2.3 | Последнее обновление: 2026-03-29

1. Введение

0x0.su — это приватный децентрализованный блокчейн, ориентированный на безопасный обмен данными, токенизацию активов и создание dApps. Платформа сочетает конфиденциальность, масштабируемость и гибкость, поддерживая как публичные, так и корпоративные сценарии.

Ключевые преимущества:
- Приватность: Анонимность участников и возможность скрытия данных.
- Безопасность: Криптографические алгоритмы (SHA-256, ECDSA).
- Масштабируемость: Шардинг и адаптивная скорость формирования блоков (1–60 сек).
- Гибкость: Поддержка текста, изображений, видео и смарт-контрактов.
- Децентрализованное управление: Решения принимаются через консенсус PoA с участием доверенных валидаторов.

2. Основные понятия

  • Блокчейн: Распределённый реестр с неизменяемыми блоками данных.
  • Смарт-контракт: Автономный код на Solidity (EVM-совместимый).
  • Транзакция: Операция передачи данных/активов (до 30,000 tr/сек).
  • Узлы (Ноды): Участники сети с ролью валидаторов (PoA-консенсус).
  • Токен 0x0: Нативный токен для оплаты транзакций и взаимодействия с сетью.

3. Архитектура и технические параметры

3.1 Слои блокчейна:
- Сетевой слой: P2P-сеть с межсетевыми мостами (Ethereum, BSC).
- Консенсусный слой: Proof of Authority (PoA) для доверенных узлов.
- Слой приложений: Поддержка dApps, интеграция с IPFS и Metamask.

3.2 Технические характеристики:

Параметр Значение
Скорость блоков 1 сек (при нагрузке) / 60 сек (в ожидании)
Размер блока 700,000,000 GAS (~30,000 транзакций)
Пропускная способность До 30,000 tr/сек (теоретическая)
Хранение данных Децентрализованное (IPFS + локальные ноды)

4. Использование платформы

4.1 Сценарии применения:
- Корпоративные решения: Управление цепочками поставок, документами.
- Лояльность: Системы бонусов и NFT-купонов.
- Геймификация: Токенизация игровых активов.

4.2 Начало работы:
1. Кошелёк:
- Подключите Metamask через metamask.0x0.su.
- Сохраните мнемоническую фразу.
2. Транзакции:

javascript // Пример безопасного взаимодействия с Web3.js // ВНИМАНИЕ: Это пример кода. Всегда проверяйте адреса и данные транзакций const tx = { to: '0x...', value: web3.utils.toWei('1', 'ether'), gas: 21000 }; web3.eth.sendTransaction(tx);
3. Управление: Решения о развитии сети принимаются через голосование валидаторов PoA.

4.3 Развертывание ERC20-токенов и системы лояльности
Благодаря EVM-совместимости платформа 0x0.su поддерживает создание токенов по стандарту ERC20, который определяет правила взаимодействия токенов в блокчейне . Это открывает возможности для реализации гибких систем лояльности и коалиционных моделей.

Применение ERC20-токенов в системах лояльности

  1. Бонусы за активность:
  2. Пользователи получают токены за покупки, регистрацию или выполнение задач. Например, за каждую покупку начисляется 1% от суммы в виде токенов .

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

  4. Персонализация:

  5. Смарт-контракты автоматизируют начисление бонусов с учетом индивидуальных условий (например, повышенные бонусы для VIP-пользователей) .

  6. Интеграция с DApp:

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

Коалиционные системы лояльности

В таких моделях несколько организаций объединяют свои программы, создавая единую экосистему:
- Многосторонний обмен: Токены используются у разных партнеров (например, кафе, магазины, сервисы), что повышает их ценность для пользователей .
- Гибкие правила: Условия начисления и списания задаются через смарт-контракты, включая ограничения по сроку действия или зоне применения .
- Прозрачность: Все операции записываются в блокчейн, исключая мошенничество и ошибки в начислениях .

Преимущества ERC20 для лояльности

  • Стандартизация: Совместимость с кошельками (Metamask, Trust Wallet) и DApp упрощает интеграцию .
  • Автоматизация: Смарт-контракты управляют процессами без участия третьих сторон .
  • Ликвидность: Токены можно торговать на биржах, добавляя им реальной ценности .

Пример реализации

Проект может выпустить токен LOYAL, который:
- Начисляется пользователям за покупки в партнерских магазинах.
- Обменивается на скидки или подарки через DApp.
- Интегрируется в мобильное приложение с отслеживанием баланса через эксплорер блоков .

Техническая реализация

  1. Развёртывание контракта:
  2. Используйте библиотеки вроде OpenZeppelin для реализации функций:
    • totalSupply() — общее количество токенов.
    • balanceOf(address) — баланс пользователя.
    • transfer(address, uint256) — перевод токенов .

  3. Пример кода:

    ```solidity pragma solidity ^0.8.0;

    import "@openzeppelin/contracts/token/ERC20/ERC20.sol";

    contract LoyaltyToken is ERC20 { constructor(uint256 initialSupply) ERC20("LoyaltyToken", "LOY") { _mint(msg.sender, initialSupply * 10 ** decimals()); } } ```
    2. Развёртывание:
    - Компилируйте и отправляйте контракт через Remix IDE или Hardhat, указав RPC-адрес ноды: nodes.0x0.su .
    3. Проверка: - Отслеживайте транзакции через эксплорер блоков .

4.4 Расчёт Стоимости Транзакций в Gwei

Описание: Gas Price = 20 Gwei. Минимальная стоимость простой транзакции (перевод токенов, 21 000 gas): Формула: Gas Used × Gas Price = 21 000 × 20 Gwei. Результат: 420 000 Gwei (эквивалентно 0.00042 нативного токена, если 1 токен = 10^9 Gwei).

Для более сложных транзакций (например, смарт-контракт в лояльности, ~100 000 gas): Стоимость: ~2 000 000 Gwei.

Преимущества: По сравнению с публичными сетями (где часто 50+ Gwei) — супернизкие fees, почти бесплатно для приватной сети.

4.5 Развертывание смарт-контрактов на Node.js с Hardhat

Hardhat — это среда разработки для Ethereum-совместимых блокчейнов, которая упрощает компиляцию, тестирование и развертывание смарт-контрактов. Платформа 0x0.su полностью совместима с Hardhat благодаря поддержке EVM.

Установка и настройка Hardhat

  1. Инициализация проекта: bash mkdir my-contract && cd my-contract npm init -y npm install --save-dev hardhat npx hardhat init

  2. Настройка сети 0x0.su: В файле hardhat.config.js добавьте конфигурацию для сети 0x0.su: ```javascript require("@nomicfoundation/hardhat-toolbox");

module.exports = { solidity: "0.8.19", networks: { "0x0": { url: "https://nodes.0x0.su", accounts: [process.env.PRIVATE_KEY], chainId: 0x0 } } }; ```

Создание смарт-контракта

  1. Пример контракта ERC20: Создайте файл contracts/LoyaltyToken.sol: ```solidity // SPDX-License-Identifier: MIT pragma solidity ^0.8.19;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol"; import "@openzeppelin/contracts/access/Ownable.sol";

contract LoyaltyToken is ERC20, Ownable { constructor(uint256 initialSupply) ERC20("LoyaltyToken", "LOY") { _mint(msg.sender, initialSupply * 10 ** decimals()); }

   function mint(address to, uint256 amount) public onlyOwner {
       _mint(to, amount);
   }

} ```

  1. Установка зависимостей: bash npm install @openzeppelin/contracts

Развертывание контракта

  1. Скрипт развертывания: Создайте файл scripts/deploy.js: ```javascript const hre = require("hardhat");

async function main() { const initialSupply = 1000000; // 1 миллион токенов

 const LoyaltyToken = await hre.ethers.getContractFactory("LoyaltyToken");
 const token = await LoyaltyToken.deploy(initialSupply);

 await token.waitForDeployment();

 console.log("Контракт развернут по адресу:", await token.getAddress());

}

main() .then(() => process.exit(0)) .catch((error) => { console.error(error); process.exit(1); }); ```

  1. Запуск развертывания: bash npx hardhat run scripts/deploy.js --network 0x0

Верификация контракта

После развертывания рекомендуется верифицировать контракт в эксплорере блоков:

npx hardhat verify --network 0x0 DEPLOYED_ADDRESS "Constructor Argument"

Преимущества использования Hardhat

  • Интегрированное тестирование: Запуск unit-тестов с помощью Mocha и Chai.
  • Отладка: Подробные сообщения об ошибках и трассировка транзакций.
  • Плагины: Расширяемая экосистема для дополнительного функционала.
  • Совместимость: Полная поддержка EVM-совместимых сетей, включая 0x0.su.

5. Инструменты для разработчиков

5.1 Block Explorer API Платформа предоставляет Block Explorer API для программного доступа к данным блокчейна. API доступен по адресу: https://api.explorer.0x0.su

Основные эндпоинты

  • Проверка здоровья:
  • GET / — статус здоровья приложения
  • GET /api/health — простая проверка работоспособности

  • GET /api/health/detailed — детальная проверка (БД, блокчейн, очередь задач)

  • Информация об аккаунтах:

  • GET /account/{account} — детали аккаунта (баланс, количество транзакций, тип контракта)
  • GET /balance/{address}/latest — последний баланс адреса
  • GET /balance/{address}/by_date — баланс по дате

  • GET /balance/{address}/latest/{contract_address} — баланс токена контракта

  • Информация о блоках:

  • GET /last_block — номер последнего блока

  • GET /block/{block_number} — детали блока (хеш, timestamp, транзакции и т.д.)

  • Информация о транзакциях:

  • GET /tx/{tx_hash} — детали транзакции (отправитель, получатель, сумма, gas и т.д.)

  • Регистрация контрактов:

  • POST /contract/register — регистрация нового контракта (требуется JWT-аутентификация)

Все запросы возвращают данные в формате JSON. Для регистрации контрактов необходимо получить JWT-токен аутентификации.

Примеры использования

# Получение баланса адреса
curl -X GET "https://api.explorer.0x0.su/balance/0x742d35Cc6.../latest"

# Получение информации о блоке
curl -X GET "https://api.explorer.0x0.su/block/12345"

# Регистрация контракта (с JWT)
curl -X POST "https://api.explorer.0x0.su/contract/register" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "MyContract", "address": "0x...", "abi": "[...]", "description": "Contract description"}'

6. Безопасность и управление

  • Антиспам-механизмы: Динамические комиссии и лимиты.
  • Консенсус PoA: Управление сетью осуществляется через доверенные ноды.

7. Лицензия и поддержка

  • Лицензия: Apache 2.0
  • Контакты:
  • Сайт: 0x0.su
  • Email: support@0x0.su

Изменения в версии 2.1:
- Удалены упоминания о DAO-управлении.
- Акцент на Proof of Authority (PoA) и технические улучшения.
- Уточнена роль токена 0x0 (оплата транзакций, взаимодействие с сетью).
- Добавлено описание поддержки ERC20-токенов и их применение в системах лояльности.

Изменения в версии 2.2: - Добавлен расчет стоимости транзакций в Gwei вместо Wei для большей понятности. - Интегрирована информация о Block Explorer API для разработчиков. - Удален устаревший раздел основного API. - Улучшена структура документации для лучшей читаемости.

Изменения в версии 2.3: - Добавлен подраздел 4.5 "Развертывание смарт-контрактов на Node.js с Hardhat". - Добавлены инструкции по установке и настройке Hardhat для работы с сетью 0x0.su. - Добавлен пример создания и развертывания ERC20-токена с использованием Hardhat. - Добавлена информация о верификации контрактов в эксплорере блоков.