Documentation

    Концепції, цінність і типові сценарії

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Інтеграція платежів
    Інтеграція WayForPay
    Web3 Гаманець
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкінга Токенів
    Сутності
    Можливості
    Повідомлення
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безпека та відповідність
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Білий лейбл
    Інтеграція Web3
    Реальні приклади
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Web3
    Token launch jurisdictions
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Архітектура
    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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Інтеграція платежів
    Інтеграція WayForPay
    Web3 Гаманець
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкінга Токенів
    Сутності
    Можливості
    Повідомлення
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безпека та відповідність
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Білий лейбл
    Інтеграція Web3
    Реальні приклади
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Web3
    Token launch jurisdictions
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Архітектура
    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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Валідація першого успіху
    Наступні кроки
    Функції
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    SubscriptionConductor
    PaymentConductor
    Інтеграція платежів
    Інтеграція WayForPay
    Web3 Гаманець
    Реферальні коди (Refcodes)
    NFT Exhibition Marketplace
    Система Стейкінга Токенів
    Сутності
    Можливості
    Повідомлення
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Система Резервування Імен Користувачів
    Науковий редактор
    Notifications
    Push-сповіщення через FCM (Ring)
    Email AI-CRM
    Протокол Tunnel
    Authentication
    Безпека та відповідність
    Система локалей
    Мобільний Досвід
    Паттерни Оптимізації Продуктивності
    Приклади
    Швидкий старт
    Білий лейбл
    Інтеграція Web3
    Реальні приклади
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Брендування
    Теми
    Функції
    Локалізація
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Еталонні деплої Ring
    Web3
    Token launch jurisdictions
    Інтеграції
    Ethereum гаманці (Wagmi v3)
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Конфігурація Середовища
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Архітектура
    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 хв прослуховування