Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Real-Time Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Real-Time Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)

    Documentation

    Концепции, ценность и типичные сценарии клонирования — меньше кода.

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Первый успех
    Следующие шаги
    Функции
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    SubscriptionConductor
    PaymentConductor
    Интеграция платежей
    Интеграция WayForPay
    Web3 Кошелек
    Реферальные коды (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкинга Токенов
    Entities
    Opportunities
    Real-Time Messaging
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Система Резервирования Имён Пользователей
    Научный редактор
    Notifications
    Push-уведомления через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безопасность и соответствие
    Система локалей
    Мобильный Опыт
    Паттерны Оптимизации Производительности
    Примеры
    Quick Start
    White Label
    Интеграция Web3
    Реальные Проекты
    Кастомизация
    Branding
    Темы оформления
    Features
    Localization
    Настройка токеномики
    Web3
    Token launch jurisdictions
    Интеграции
    Ethereum-кошельки (Wagmi v3)
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Конфигурация Окружения
    Monitoring
    Оптимизация производительности
    Backup
    Архитектура
    Data Model
    Security
    Real Time
    Архитектура PaymentConductor
    Бекенд Сервисы
    Интеграция Firebase
    Разработка
    Ring MCP Server

    Быстрый вход (CTO · аудиторы · агенты)

    Приветствие — миссия и аудитории
    Краткий справочник
    С чего начать
    Архитектура и Auth.js
    Режимы бэкенда и базы данных (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP Tools
    Ring MCP Server
    Token economics
    Token launch jurisdictions
    Деплой (Docker · k8s)
    Безопасность и соответствие требованиям
    ringdom.org — база LegioX
    Исходный код — лицензия MIT (GitHub)
    Ring Platform Logo

    Loading documentation...

    Preparing Ring Platform content

    Ring Platform Logo

    Loading documentation...

    Preparing Ring Platform content

    Ring Platform Logo

    Loading documentation...

    Preparing Ring Platform content

    Настройка токеномики

    Философия Ring: «Ваша платформа должна работать на вашей экономике». Каждый клон Ring может поставляться с эталонным стеком RING или форкнуть его под собственный utility-токен.

    Платформы Ring выравнивают стимулы через on-chain utility: членские взносы, потоки маркетплейса, реферальные награды и опциональный стейкинг. В этом руководстве:

    • Эталонная токеномика RING в contracts/RingToken.sol и contracts/Membership.sol
    • Интеграция в Next.js — кредитные балансы, подписки и price oracle
    • Собственный токен для white-label развёртывания

    Зачем нужна токеномика

    Традиционные платформы централизуют захват ценности — пользователи создают контент и транзакции, а контроль остаётся у основателей и инвесторов.

    Токенные платформы Ring направляют комиссии в прозрачное казначейство, открывают премиум-функции через utility-балансы и со временем позволяют сообществу расширять экономику через governance и стейкинг.

    ПотокПоведение эталона RING
    Членство1 RING / месяц → казначейство
    Минимальный буфер12 RING (год) рекомендуется до подписки
    Эмиссия1 000 000 000 RING минтится в казначейство при деплое
    Сеть по умолчаниюPolygon (настраивается в клоне)

    Эталонная архитектура RING

    Ring поставляет два upgradeable (UUPS) контракта, работающих вместе:

    RingToken (contracts/RingToken.sol)

    Upgradeable ERC-20 с burn, pause и распределением через казначейство.

    ПараметрЗначениеПримечание
    INITIAL_SUPPLY1 000 000 000 RINGМинт в казначейство при initialize
    MEMBERSHIP_FEE1 RING / месяцТолько Membership вызывает deductMembershipFee
    MIN_SUBSCRIPTION_BALANCE12 RINGView-хелпер — год взносов
    Decimals18Стандартная точность ERC-20

    Ключевые функции:

    • deductMembershipFee(member) — переводит 1 RING участнику → казначейству; только связанный membership-контракт
    • creditTokens(recipient, amount, reason) — owner переводит из казначейства (airdrop, компенсации)
    • hasSubscriptionBalance(user) / getRemainingMembershipMonths(user) — хелперы для UI и ops
    • pause() / unpause() — экстренная остановка трансферов
    • setTreasury / setMembershipContract — конфигурация owner после деплоя

    RING спроектирован как utility-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.

    Membership (contracts/Membership.sol)

    Управляет рекуррентной оплатой членства on-chain.

    ПараметрЗначение
    SUBSCRIPTION_PERIOD30 дней
    GRACE_PERIOD7 дней после срока оплаты
    MAX_FAILED_ATTEMPTS3 до истечения подписки

    Жизненный цикл подписки:

    1. createSubscription() — нужен баланс ≥ 1 RING; первый месяц списывается сразу
    2. processBatchPayments(batchSize) — owner/cron обрабатывает продления
    3. Неудачные попытки увеличивают failedAttempts; после трёх — статус EXPIRED
    4. cancelSubscription() — отмена пользователем; suspendSubscription / reactivateSubscription — админ
    5. hasActiveMembership(user) — true пока ACTIVE и в пределах grace period

    Статусы: INACTIVE, ACTIVE, EXPIRED, CANCELLED, SUSPENDED

    ReferralRewards (contracts/contracts-src/ReferralRewards.sol)

    Опциональный контракт для gasless реферальных выплат. Роль operator платит реферерам в токене проекта в режиме MINT или TRANSFER, с идемпотентным orderRef против двойных выплат.

    Деплой отдельно при включении store referral commissions:

    Укажите REFERRAL_REWARDS_ADDRESS и REFERRAL_REWARD_TOKEN_ADDRESS в env клона (on-chain ops — EN canonical в Refcodes).

    Интеграция с платформой

    On-chain контракты работают вместе с серверными сервисами — пользователю не нужна подпись на каждое ежемесячное продление.

    Переменные окружения

    Клиентские константы — в constants/web3.ts: метаданные токена, заготовки staking pool и хелперы Polygonscan.

    Кредитный баланс и подписки

    Приложение ведёт off-chain кредитный ledger, синхронизированный со статусом членства:

    СервисПутьРоль
    Кредитыfeatures/wallet/services/credit-balance-service.tsБаланс, списания, членский взнос
    Подпискиservices/membership/subscription-service.tsСоздание, отмена, продление, batch
    Oraclefeatures/wallet/services/native-token-price-oracle.tsRING/USD с fallback-источниками

    Типичный апгрейд:

    1. Роль SUBSCRIBER и достаточный RING-кредит (≥ 1 токена)
    2. subscriptionService.createSubscription списывает кредит и ставит next due (+30 дней)
    3. Cron или admin batch обрабатывает продления; grace period до даунгрейда
    4. При успехе роль повышается до MEMBER

    API (представительно):

    • GET /api/wallet/credit/balance — баланс и снимок подписки
    • POST /api/membership/subscription/create — старт подписки
    • POST /api/membership/payment/token — оплата RING
    • GET /api/prices/ring-usd — конвертация для UI и чеков

    Стейкинг (опционально)

    constants/web3.ts задаёт заготовку RING staking pool (RING_STAKING_ADDRESS, 20% APR placeholder, минимум 100 RING). Агро/кооперативные клоны могут подключить пулы DAAR/DAARION через features/staking/staking.config.ts. Параметры стейкинга — конфигурация клона, не глобальные правила протокола RING.

    Деплой контрактов

    Hardhat-проект: ring-platform.org/contracts/.

    1. 1

      Установка и компиляция:

    2. 2

      Testnet (скрипт Polygon Mumbai):

      Порядок: RingToken → Membership → setMembershipContract. JSON деплоя — deployments/mumbai-deployment.json.

    3. 3

      Mainnet:

      Нужны RING_TREASURY_MAINNET и достаточно MATIC на deployer. scripts/deploy-mainnet.js — только после аудита и multisig казначейства.

    4. 4

      Пропишите адреса в .env клона, передеплойте приложение, верифицируйте контракты на Polygonscan.

    Проведите профессиональный аудит смарт-контрактов перед mainnet. Используйте multisig для казначейства и owner-ключей.

    Собственный white-label токен

    Используйте RING как шаблон для брендированной экономики.

    Шаг 1 — Классификация токена

    1. 1

      Utility-токен (рекомендуется): Листинги, членство, комиссии маркетплейса. Без обещаний прибыли.

    2. 2

      Security-токен: Доля или revenue share — регулирование ценных бумаг; обязателен legal review.

    3. 3

      Один vs несколько токенов: Один проще; разделяйте governance и utility только при реальной необходимости.

    Шаг 2 — Параметры

    Паттерны распределения:

    • Community-first: 40–50% награды и airdrop, 20% стейкинг, 20% разработка (vesting), 10% казначейство
    • Enterprise: Больше казначейству и партнёрам; ограниченный on-chain governance

    Политика supply: Фиксированная (модель RING), контролируемая инфляция (staking rewards) или дефляция через burn комиссий.

    Шаг 3 — Комиссии и функции

    Собирайте комиссии в казначейство; часть направляйте на staking rewards или burn согласно tokenomics paper.

    Шаг 4 — Интеграция с Ring

    1. Форкните RingToken.sol / Membership.sol или деплойте как есть со своим казначейством
    2. Обновите constants/web3.ts и env-адреса
    3. Настройте fee constants в credit-balance-service и subscription-service
    4. Включите wallet UI и гейты членства в portal config

    Экономическая модель

    Поток токенных комиссий

    Метрики здоровья:

    • Активные подписки и доля неудачных платежей
    • Баланс казначейства и сверка с credit ledger
    • Скорость обращения токена и концентрация у китов
    • Задержка RING/USD oracle и использование fallback

    Юридические аспекты и документация

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

    • Публикуйте понятный tokenomics paper — utility, комиссии, казначейство, без инвестиционных заявлений
    • Храните отчёты аудита и процедуры для upgrade admin keys
    • Раскрывайте волатильность и налоговые обязательства пользователям
    • Рассмотрите KYC/AML для крупных fiat on-ramp

    Следующие шаги

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

    Сразу

    • Решить: эталон RING vs форк под бренд
    • Назначить multisig казначейства и owner контрактов
    • Подготовить tokenomics paper и legal review

    Разработка

    • Деплой в testnet; прогон contracts/test
    • Прописать env и credit/subscription сервисы
    • Smoke-test апгрейда членства и cron продлений

    Запуск

    • Mainnet после аудита
    • Верификация на Polygonscan
    • Мониторинг подписок и алертов казначейства

    Нужна помощь с внедрением? Смотрите возможности кастомизации Ring или интеграцию платежей для fiat + token checkout.

    Настройка токеномики

    Философия Ring: «Ваша платформа должна работать на вашей экономике». Каждый клон Ring может поставляться с эталонным стеком RING или форкнуть его под собственный utility-токен.

    Платформы Ring выравнивают стимулы через on-chain utility: членские взносы, потоки маркетплейса, реферальные награды и опциональный стейкинг. В этом руководстве:

    • Эталонная токеномика RING в contracts/RingToken.sol и contracts/Membership.sol
    • Интеграция в Next.js — кредитные балансы, подписки и price oracle
    • Собственный токен для white-label развёртывания

    Зачем нужна токеномика

    Традиционные платформы централизуют захват ценности — пользователи создают контент и транзакции, а контроль остаётся у основателей и инвесторов.

    Токенные платформы Ring направляют комиссии в прозрачное казначейство, открывают премиум-функции через utility-балансы и со временем позволяют сообществу расширять экономику через governance и стейкинг.

    ПотокПоведение эталона RING
    Членство1 RING / месяц → казначейство
    Минимальный буфер12 RING (год) рекомендуется до подписки
    Эмиссия1 000 000 000 RING минтится в казначейство при деплое
    Сеть по умолчаниюPolygon (настраивается в клоне)

    Эталонная архитектура RING

    Ring поставляет два upgradeable (UUPS) контракта, работающих вместе:

    RingToken (contracts/RingToken.sol)

    Upgradeable ERC-20 с burn, pause и распределением через казначейство.

    ПараметрЗначениеПримечание
    INITIAL_SUPPLY1 000 000 000 RINGМинт в казначейство при initialize
    MEMBERSHIP_FEE1 RING / месяцТолько Membership вызывает deductMembershipFee
    MIN_SUBSCRIPTION_BALANCE12 RINGView-хелпер — год взносов
    Decimals18Стандартная точность ERC-20

    Ключевые функции:

    • deductMembershipFee(member) — переводит 1 RING участнику → казначейству; только связанный membership-контракт
    • creditTokens(recipient, amount, reason) — owner переводит из казначейства (airdrop, компенсации)
    • hasSubscriptionBalance(user) / getRemainingMembershipMonths(user) — хелперы для UI и ops
    • pause() / unpause() — экстренная остановка трансферов
    • setTreasury / setMembershipContract — конфигурация owner после деплоя

    RING спроектирован как utility-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.

    Membership (contracts/Membership.sol)

    Управляет рекуррентной оплатой членства on-chain.

    ПараметрЗначение
    SUBSCRIPTION_PERIOD30 дней
    GRACE_PERIOD7 дней после срока оплаты
    MAX_FAILED_ATTEMPTS3 до истечения подписки

    Жизненный цикл подписки:

    1. createSubscription() — нужен баланс ≥ 1 RING; первый месяц списывается сразу
    2. processBatchPayments(batchSize) — owner/cron обрабатывает продления
    3. Неудачные попытки увеличивают failedAttempts; после трёх — статус EXPIRED
    4. cancelSubscription() — отмена пользователем; suspendSubscription / reactivateSubscription — админ
    5. hasActiveMembership(user) — true пока ACTIVE и в пределах grace period

    Статусы: INACTIVE, ACTIVE, EXPIRED, CANCELLED, SUSPENDED

    ReferralRewards (contracts/contracts-src/ReferralRewards.sol)

    Опциональный контракт для gasless реферальных выплат. Роль operator платит реферерам в токене проекта в режиме MINT или TRANSFER, с идемпотентным orderRef против двойных выплат.

    Деплой отдельно при включении store referral commissions:

    Укажите REFERRAL_REWARDS_ADDRESS и REFERRAL_REWARD_TOKEN_ADDRESS в env клона (on-chain ops — EN canonical в Refcodes).

    Интеграция с платформой

    On-chain контракты работают вместе с серверными сервисами — пользователю не нужна подпись на каждое ежемесячное продление.

    Переменные окружения

    Клиентские константы — в constants/web3.ts: метаданные токена, заготовки staking pool и хелперы Polygonscan.

    Кредитный баланс и подписки

    Приложение ведёт off-chain кредитный ledger, синхронизированный со статусом членства:

    СервисПутьРоль
    Кредитыfeatures/wallet/services/credit-balance-service.tsБаланс, списания, членский взнос
    Подпискиservices/membership/subscription-service.tsСоздание, отмена, продление, batch
    Oraclefeatures/wallet/services/native-token-price-oracle.tsRING/USD с fallback-источниками

    Типичный апгрейд:

    1. Роль SUBSCRIBER и достаточный RING-кредит (≥ 1 токена)
    2. subscriptionService.createSubscription списывает кредит и ставит next due (+30 дней)
    3. Cron или admin batch обрабатывает продления; grace period до даунгрейда
    4. При успехе роль повышается до MEMBER

    API (представительно):

    • GET /api/wallet/credit/balance — баланс и снимок подписки
    • POST /api/membership/subscription/create — старт подписки
    • POST /api/membership/payment/token — оплата RING
    • GET /api/prices/ring-usd — конвертация для UI и чеков

    Стейкинг (опционально)

    constants/web3.ts задаёт заготовку RING staking pool (RING_STAKING_ADDRESS, 20% APR placeholder, минимум 100 RING). Агро/кооперативные клоны могут подключить пулы DAAR/DAARION через features/staking/staking.config.ts. Параметры стейкинга — конфигурация клона, не глобальные правила протокола RING.

    Деплой контрактов

    Hardhat-проект: ring-platform.org/contracts/.

    1. 1

      Установка и компиляция:

    2. 2

      Testnet (скрипт Polygon Mumbai):

      Порядок: RingToken → Membership → setMembershipContract. JSON деплоя — deployments/mumbai-deployment.json.

    3. 3

      Mainnet:

      Нужны RING_TREASURY_MAINNET и достаточно MATIC на deployer. scripts/deploy-mainnet.js — только после аудита и multisig казначейства.

    4. 4

      Пропишите адреса в .env клона, передеплойте приложение, верифицируйте контракты на Polygonscan.

    Проведите профессиональный аудит смарт-контрактов перед mainnet. Используйте multisig для казначейства и owner-ключей.

    Собственный white-label токен

    Используйте RING как шаблон для брендированной экономики.

    Шаг 1 — Классификация токена

    1. 1

      Utility-токен (рекомендуется): Листинги, членство, комиссии маркетплейса. Без обещаний прибыли.

    2. 2

      Security-токен: Доля или revenue share — регулирование ценных бумаг; обязателен legal review.

    3. 3

      Один vs несколько токенов: Один проще; разделяйте governance и utility только при реальной необходимости.

    Шаг 2 — Параметры

    Паттерны распределения:

    • Community-first: 40–50% награды и airdrop, 20% стейкинг, 20% разработка (vesting), 10% казначейство
    • Enterprise: Больше казначейству и партнёрам; ограниченный on-chain governance

    Политика supply: Фиксированная (модель RING), контролируемая инфляция (staking rewards) или дефляция через burn комиссий.

    Шаг 3 — Комиссии и функции

    Собирайте комиссии в казначейство; часть направляйте на staking rewards или burn согласно tokenomics paper.

    Шаг 4 — Интеграция с Ring

    1. Форкните RingToken.sol / Membership.sol или деплойте как есть со своим казначейством
    2. Обновите constants/web3.ts и env-адреса
    3. Настройте fee constants в credit-balance-service и subscription-service
    4. Включите wallet UI и гейты членства в portal config

    Экономическая модель

    Поток токенных комиссий

    Метрики здоровья:

    • Активные подписки и доля неудачных платежей
    • Баланс казначейства и сверка с credit ledger
    • Скорость обращения токена и концентрация у китов
    • Задержка RING/USD oracle и использование fallback

    Юридические аспекты и документация

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

    • Публикуйте понятный tokenomics paper — utility, комиссии, казначейство, без инвестиционных заявлений
    • Храните отчёты аудита и процедуры для upgrade admin keys
    • Раскрывайте волатильность и налоговые обязательства пользователям
    • Рассмотрите KYC/AML для крупных fiat on-ramp

    Следующие шаги

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

    Сразу

    • Решить: эталон RING vs форк под бренд
    • Назначить multisig казначейства и owner контрактов
    • Подготовить tokenomics paper и legal review

    Разработка

    • Деплой в testnet; прогон contracts/test
    • Прописать env и credit/subscription сервисы
    • Smoke-test апгрейда членства и cron продлений

    Запуск

    • Mainnet после аудита
    • Верификация на Polygonscan
    • Мониторинг подписок и алертов казначейства

    Нужна помощь с внедрением? Смотрите возможности кастомизации Ring или интеграцию платежей для fiat + token checkout.

    Настройка токеномики

    Философия Ring: «Ваша платформа должна работать на вашей экономике». Каждый клон Ring может поставляться с эталонным стеком RING или форкнуть его под собственный utility-токен.

    Платформы Ring выравнивают стимулы через on-chain utility: членские взносы, потоки маркетплейса, реферальные награды и опциональный стейкинг. В этом руководстве:

    • Эталонная токеномика RING в contracts/RingToken.sol и contracts/Membership.sol
    • Интеграция в Next.js — кредитные балансы, подписки и price oracle
    • Собственный токен для white-label развёртывания

    Зачем нужна токеномика

    Традиционные платформы централизуют захват ценности — пользователи создают контент и транзакции, а контроль остаётся у основателей и инвесторов.

    Токенные платформы Ring направляют комиссии в прозрачное казначейство, открывают премиум-функции через utility-балансы и со временем позволяют сообществу расширять экономику через governance и стейкинг.

    ПотокПоведение эталона RING
    Членство1 RING / месяц → казначейство
    Минимальный буфер12 RING (год) рекомендуется до подписки
    Эмиссия1 000 000 000 RING минтится в казначейство при деплое
    Сеть по умолчаниюPolygon (настраивается в клоне)

    Эталонная архитектура RING

    Ring поставляет два upgradeable (UUPS) контракта, работающих вместе:

    RingToken (contracts/RingToken.sol)

    Upgradeable ERC-20 с burn, pause и распределением через казначейство.

    ПараметрЗначениеПримечание
    INITIAL_SUPPLY1 000 000 000 RINGМинт в казначейство при initialize
    MEMBERSHIP_FEE1 RING / месяцТолько Membership вызывает deductMembershipFee
    MIN_SUBSCRIPTION_BALANCE12 RINGView-хелпер — год взносов
    Decimals18Стандартная точность ERC-20

    Ключевые функции:

    • deductMembershipFee(member) — переводит 1 RING участнику → казначейству; только связанный membership-контракт
    • creditTokens(recipient, amount, reason) — owner переводит из казначейства (airdrop, компенсации)
    • hasSubscriptionBalance(user) / getRemainingMembershipMonths(user) — хелперы для UI и ops
    • pause() / unpause() — экстренная остановка трансферов
    • setTreasury / setMembershipContract — конфигурация owner после деплоя

    RING спроектирован как utility-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.

    Membership (contracts/Membership.sol)

    Управляет рекуррентной оплатой членства on-chain.

    ПараметрЗначение
    SUBSCRIPTION_PERIOD30 дней
    GRACE_PERIOD7 дней после срока оплаты
    MAX_FAILED_ATTEMPTS3 до истечения подписки

    Жизненный цикл подписки:

    1. createSubscription() — нужен баланс ≥ 1 RING; первый месяц списывается сразу
    2. processBatchPayments(batchSize) — owner/cron обрабатывает продления
    3. Неудачные попытки увеличивают failedAttempts; после трёх — статус EXPIRED
    4. cancelSubscription() — отмена пользователем; suspendSubscription / reactivateSubscription — админ
    5. hasActiveMembership(user) — true пока ACTIVE и в пределах grace period

    Статусы: INACTIVE, ACTIVE, EXPIRED, CANCELLED, SUSPENDED

    ReferralRewards (contracts/contracts-src/ReferralRewards.sol)

    Опциональный контракт для gasless реферальных выплат. Роль operator платит реферерам в токене проекта в режиме MINT или TRANSFER, с идемпотентным orderRef против двойных выплат.

    Деплой отдельно при включении store referral commissions:

    Укажите REFERRAL_REWARDS_ADDRESS и REFERRAL_REWARD_TOKEN_ADDRESS в env клона (on-chain ops — EN canonical в Refcodes).

    Интеграция с платформой

    On-chain контракты работают вместе с серверными сервисами — пользователю не нужна подпись на каждое ежемесячное продление.

    Переменные окружения

    Клиентские константы — в constants/web3.ts: метаданные токена, заготовки staking pool и хелперы Polygonscan.

    Кредитный баланс и подписки

    Приложение ведёт off-chain кредитный ledger, синхронизированный со статусом членства:

    СервисПутьРоль
    Кредитыfeatures/wallet/services/credit-balance-service.tsБаланс, списания, членский взнос
    Подпискиservices/membership/subscription-service.tsСоздание, отмена, продление, batch
    Oraclefeatures/wallet/services/native-token-price-oracle.tsRING/USD с fallback-источниками

    Типичный апгрейд:

    1. Роль SUBSCRIBER и достаточный RING-кредит (≥ 1 токена)
    2. subscriptionService.createSubscription списывает кредит и ставит next due (+30 дней)
    3. Cron или admin batch обрабатывает продления; grace period до даунгрейда
    4. При успехе роль повышается до MEMBER

    API (представительно):

    • GET /api/wallet/credit/balance — баланс и снимок подписки
    • POST /api/membership/subscription/create — старт подписки
    • POST /api/membership/payment/token — оплата RING
    • GET /api/prices/ring-usd — конвертация для UI и чеков

    Стейкинг (опционально)

    constants/web3.ts задаёт заготовку RING staking pool (RING_STAKING_ADDRESS, 20% APR placeholder, минимум 100 RING). Агро/кооперативные клоны могут подключить пулы DAAR/DAARION через features/staking/staking.config.ts. Параметры стейкинга — конфигурация клона, не глобальные правила протокола RING.

    Деплой контрактов

    Hardhat-проект: ring-platform.org/contracts/.

    1. 1

      Установка и компиляция:

    2. 2

      Testnet (скрипт Polygon Mumbai):

      Порядок: RingToken → Membership → setMembershipContract. JSON деплоя — deployments/mumbai-deployment.json.

    3. 3

      Mainnet:

      Нужны RING_TREASURY_MAINNET и достаточно MATIC на deployer. scripts/deploy-mainnet.js — только после аудита и multisig казначейства.

    4. 4

      Пропишите адреса в .env клона, передеплойте приложение, верифицируйте контракты на Polygonscan.

    Проведите профессиональный аудит смарт-контрактов перед mainnet. Используйте multisig для казначейства и owner-ключей.

    Собственный white-label токен

    Используйте RING как шаблон для брендированной экономики.

    Шаг 1 — Классификация токена

    1. 1

      Utility-токен (рекомендуется): Листинги, членство, комиссии маркетплейса. Без обещаний прибыли.

    2. 2

      Security-токен: Доля или revenue share — регулирование ценных бумаг; обязателен legal review.

    3. 3

      Один vs несколько токенов: Один проще; разделяйте governance и utility только при реальной необходимости.

    Шаг 2 — Параметры

    Паттерны распределения:

    • Community-first: 40–50% награды и airdrop, 20% стейкинг, 20% разработка (vesting), 10% казначейство
    • Enterprise: Больше казначейству и партнёрам; ограниченный on-chain governance

    Политика supply: Фиксированная (модель RING), контролируемая инфляция (staking rewards) или дефляция через burn комиссий.

    Шаг 3 — Комиссии и функции

    Собирайте комиссии в казначейство; часть направляйте на staking rewards или burn согласно tokenomics paper.

    Шаг 4 — Интеграция с Ring

    1. Форкните RingToken.sol / Membership.sol или деплойте как есть со своим казначейством
    2. Обновите constants/web3.ts и env-адреса
    3. Настройте fee constants в credit-balance-service и subscription-service
    4. Включите wallet UI и гейты членства в portal config

    Экономическая модель

    Поток токенных комиссий

    Метрики здоровья:

    • Активные подписки и доля неудачных платежей
    • Баланс казначейства и сверка с credit ledger
    • Скорость обращения токена и концентрация у китов
    • Задержка RING/USD oracle и использование fallback

    Юридические аспекты и документация

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

    • Публикуйте понятный tokenomics paper — utility, комиссии, казначейство, без инвестиционных заявлений
    • Храните отчёты аудита и процедуры для upgrade admin keys
    • Раскрывайте волатильность и налоговые обязательства пользователям
    • Рассмотрите KYC/AML для крупных fiat on-ramp

    Следующие шаги

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

    Сразу

    • Решить: эталон RING vs форк под бренд
    • Назначить multisig казначейства и owner контрактов
    • Подготовить tokenomics paper и legal review

    Разработка

    • Деплой в testnet; прогон contracts/test
    • Прописать env и credit/subscription сервисы
    • Smoke-test апгрейда членства и cron продлений

    Запуск

    • Mainnet после аудита
    • Верификация на Polygonscan
    • Мониторинг подписок и алертов казначейства

    Нужна помощь с внедрением? Смотрите возможности кастомизации Ring или интеграцию платежей для fiat + token checkout.

    bash
    
    cd contracts && npm run deploy:referral
    env
    
    # Смарт-контракты (Polygon)
    NEXT_PUBLIC_RING_TOKEN_ADDRESS=0x...
    RING_MEMBERSHIP_CONTRACT_ADDRESS=0x...
    RING_TREASURY_WALLET_ADDRESS=0x...
    POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_KEY
    
    # Ценообразование (опционально)
    CHAINLINK_RING_USD_FEED=0x...
    COINMARKETCAP_API_KEY=...
    
    # Реферальные награды (опционально)
    REFERRAL_REWARDS_ADDRESS=0x...
    REFERRAL_REWARD_TOKEN_ADDRESS=0x...
    bash
    
    cd contracts
    npm install
    npx hardhat compile
    bash
    
    RING_TREASURY_TESTNET=0xYourTreasury \
    npx hardhat run scripts/deploy-testnet.js --network polygon
    bash
    
    cd contracts && npm run deploy:referral
    env
    
    # Смарт-контракты (Polygon)
    NEXT_PUBLIC_RING_TOKEN_ADDRESS=0x...
    RING_MEMBERSHIP_CONTRACT_ADDRESS=0x...
    RING_TREASURY_WALLET_ADDRESS=0x...
    POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_KEY
    
    # Ценообразование (опционально)
    CHAINLINK_RING_USD_FEED=0x...
    COINMARKETCAP_API_KEY=...
    
    # Реферальные награды (опционально)
    REFERRAL_REWARDS_ADDRESS=0x...
    REFERRAL_REWARD_TOKEN_ADDRESS=0x...
    bash
    
    cd contracts
    npm install
    npx hardhat compile
    bash
    
    RING_TREASURY_TESTNET=0xYourTreasury \
    npx hardhat run scripts/deploy-testnet.js --network polygon
    bash
    
    cd contracts && npm run deploy:referral
    env
    
    # Смарт-контракты (Polygon)
    NEXT_PUBLIC_RING_TOKEN_ADDRESS=0x...
    RING_MEMBERSHIP_CONTRACT_ADDRESS=0x...
    RING_TREASURY_WALLET_ADDRESS=0x...
    POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_KEY
    
    # Ценообразование (опционально)
    CHAINLINK_RING_USD_FEED=0x...
    COINMARKETCAP_API_KEY=...
    
    # Реферальные награды (опционально)
    REFERRAL_REWARDS_ADDRESS=0x...
    REFERRAL_REWARD_TOKEN_ADDRESS=0x...
    bash
    
    cd contracts
    npm install
    npx hardhat compile
    bash
    
    RING_TREASURY_TESTNET=0xYourTreasury \
    npx hardhat run scripts/deploy-testnet.js --network polygon
    1. Документация
    2. /Кастомизация
    3. /Настройка токеномики

    6 мин прослушивания

    1. Документация
    2. /Кастомизация
    3. /Настройка токеномики

    6 мин прослушивания

    1. Документация
    2. /Кастомизация
    3. /Настройка токеномики

    6 мин прослушивания