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

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, почти бесплатно для приватной сети.

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. - Улучшена структура документации для лучшей читаемости.