Documentation

    Documentation

    Documentation

    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    Ring Platform Logo

    Завантаження документації...

    Підготовка контенту платформи Ring

    1. /
    2. /Настройка токеномики

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

    1. /
    2. /Настройка токеномики

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

    1. /
    2. /Настройка токеномики

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

    navigation.docs_sidebar.audience.founderHint

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Следующие шаги
    Архитектура
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom
    Proxy и интернационализация
    Real Time
    Security
    Функции
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)
    Протокол Tunnel
    Web3 Кошелек
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    API-интерфейс
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store
    Администрирование
    CLI
    Кастомизация
    Настройка токеномики
    Branding
    Features
    Localization
    Themes
    Components
    Web3
    Token launch jurisdictions
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup
    Разработка
    Local Setup
    Code Structure
    Компоненты документации
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Дорожная карта
    Примеры
    Quick Start
    Authentication
    Email AI-CRM — гайд разработчика
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты
    Api Examples
    Интеграции
    Ethereum-кошельки (Wagmi v3)

    Быстрый вход (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)

    navigation.docs_sidebar.audience.founderHint

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Следующие шаги
    Архитектура
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom
    Proxy и интернационализация
    Real Time
    Security
    Функции
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)
    Протокол Tunnel
    Web3 Кошелек
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    API-интерфейс
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store
    Администрирование
    CLI
    Кастомизация
    Настройка токеномики
    Branding
    Features
    Localization
    Themes
    Components
    Web3
    Token launch jurisdictions
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup
    Разработка
    Local Setup
    Code Structure
    Компоненты документации
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Дорожная карта
    Примеры
    Quick Start
    Authentication
    Email AI-CRM — гайд разработчика
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты
    Api Examples
    Интеграции
    Ethereum-кошельки (Wagmi v3)

    Быстрый вход (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)

    navigation.docs_sidebar.audience.founderHint

    Добро пожаловать в Ring Platform
    Краткий справочник
    С чего начать
    Предварительные требования
    Установка
    Миграции базы данных
    Первый успех
    Устранение неполадок
    Следующие шаги
    Архитектура
    Режимы бэкенда и базы данных
    Data Model
    Архитектура Аутентификации
    Архитектура Email AI-CRM
    Архитектура PaymentConductor
    Архитектура Refcodes
    Архитектура News Kingdom
    Proxy и интернационализация
    Real Time
    Security
    Функции
    Authentication
    Email AI-CRM
    Entities
    Opportunities
    Messaging
    Notifications
    Push-уведомления через FCM (Ring)
    Протокол Tunnel
    Web3 Кошелек
    Store
    Склад и остатки
    Управление вендорами
    Комиссии и расчёты
    Реферальные коды (Refcodes)
    Интеграция платежей
    PaymentConductor
    Интеграция WayForPay
    Модуль Новостей - Цифровой Газетный Опыт
    Блоги участников
    Научный редактор
    Система локалей
    Безопасность и соответствие
    NFT Маркетплейс
    Система Стейкинга Токенов
    Паттерны Оптимизации Производительности
    Мобильный Опыт
    API-интерфейс
    Аутентификация
    Email AI-CRM API
    Сущности
    Opportunities
    Messaging
    Notifications
    Wallet
    Store
    Администрирование
    CLI
    Кастомизация
    Настройка токеномики
    Branding
    Features
    Localization
    Themes
    Components
    Web3
    Token launch jurisdictions
    Развёртывание
    Self-hosted развёртывание
    Vercel
    Docker
    Environment
    Monitoring
    Оптимизация производительности
    Backup
    Разработка
    Local Setup
    Code Structure
    Компоненты документации
    Community tooling
    Ring MCP Server
    Генеративные изображения (ImageConductor)
    Автономная редакция (Grok)
    OSS vs enterprise
    Best Practices
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Дорожная карта
    Примеры
    Quick Start
    Authentication
    Email AI-CRM — гайд разработчика
    Api Integration
    Интеграция Web3
    White Label
    Реальные Проекты
    Api Examples
    Интеграции
    Ethereum-кошельки (Wagmi v3)

    Быстрый вход (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: «Ваша платформа должна работать на вашей экономике». Каждый клон Ring может поставляться с эталонным стеком RING или форкнуть его под собственный utility-токен.

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

    • Эталонная токеномика RING в contracts/RingToken.sol и contracts/RingMembership.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 / месяцТолько RingMembership вызывает 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-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.

    RingMembership (contracts/RingMembership.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/user-credit-service.tsБаланс, списания, членский взнос
    Подпискиservices/membership/subscription-service.tsСоздание, отмена, продление, batch
    Oracleservices/blockchain/price-oracle-service.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/ring — оплата 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 → RingMembership → 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 / RingMembership.sol или деплойте как есть со своим казначейством
    2. Обновите constants/web3.ts и env-адреса
    3. Настройте fee constants в user-credit-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/RingMembership.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 / месяцТолько RingMembership вызывает 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-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.

    RingMembership (contracts/RingMembership.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/user-credit-service.tsБаланс, списания, членский взнос
    Подпискиservices/membership/subscription-service.tsСоздание, отмена, продление, batch
    Oracleservices/blockchain/price-oracle-service.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/ring — оплата 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 → RingMembership → 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 / RingMembership.sol или деплойте как есть со своим казначейством
    2. Обновите constants/web3.ts и env-адреса
    3. Настройте fee constants в user-credit-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/RingMembership.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 / месяцТолько RingMembership вызывает 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-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.

    RingMembership (contracts/RingMembership.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/user-credit-service.tsБаланс, списания, членский взнос
    Подпискиservices/membership/subscription-service.tsСоздание, отмена, продление, batch
    Oracleservices/blockchain/price-oracle-service.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/ring — оплата 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 → RingMembership → 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 / RingMembership.sol или деплойте как есть со своим казначейством
    2. Обновите constants/web3.ts и env-адреса
    3. Настройте fee constants в user-credit-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-rpc.com
    
    # Ценообразование (опционально)
    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-rpc.com
    
    # Ценообразование (опционально)
    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-rpc.com
    
    # Ценообразование (опционально)
    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