Documentation

    Documentation

    Documentation

    Ring Platform Logo

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

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

    Ring Platform Logo

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

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

    Ring Platform Logo

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

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

    1. /
    2. /Налаштування токеноміки

    6 хв прослуховування

    1. /
    2. /Налаштування токеноміки

    6 хв прослуховування

    1. /
    2. /Налаштування токеноміки

    6 хв прослуховування

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

    Ласкаво просимо до Ring
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Міграції бази даних
    Валідація першого успіху
    Усунення несправностей
    Наступні кроки
    Архітектура
    Режими бекенду та бази даних
    Data Model
    Архітектура Аутентифікації
    Архітектура Email AI-CRM
    Архітектура PaymentConductor
    Архітектура Refcodes
    Архітектура News Kingdom
    Proxy та інтернаціоналізація
    Real Time
    Security
    Функції
    Authentication
    Email AI-CRM
    Сутності
    Можливості
    Повідомлення
    Notifications
    Push-сповіщення через FCM (Ring)
    Протокол Tunnel
    Web3 Гаманець
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Реферальні коди (Refcodes)
    Інтеграція платежів
    PaymentConductor
    Інтеграція WayForPay
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Науковий редактор
    Система локалей
    Безпека та відповідність
    NFT Маркетплейс
    Система Стейкінга Токенів
    Паттерни Оптимізації Продуктивності
    Мобільний Досвід
    API-інтерфейс
    Аутентифікація
    Email AI-CRM API
    Entities
    Можливості
    API повідомлень
    API повідомлень
    Гаманець
    API магазину
    API адміністратора
    CLI
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вибір бекенду бази даних
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Налаштування агентів ШІ
    Еталонні деплої Ring
    Брендування
    Функції
    Локалізація
    Теми
    Компоненти
    Web3
    Token launch jurisdictions
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Environment
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Розробка
    Локальне налаштування
    Структура коду
    Компоненти документації
    Community tooling
    Ring MCP Server
    Генеративні зображення (ImageConductor)
    Автономна редакція (Grok)
    OSS vs enterprise
    Найкращі практики
    Workflow
    Code Style
    Performance
    Тестування
    Розгортання
    Налагодження
    Співпраця
    Дорожня карта
    Приклади
    Швидкий старт
    Автентифікація
    Email AI-CRM — гайд розробника
    Інтеграція API
    Інтеграція Web3
    Білий лейбл
    Реальні приклади
    Приклади API
    Інтеграції
    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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Міграції бази даних
    Валідація першого успіху
    Усунення несправностей
    Наступні кроки
    Архітектура
    Режими бекенду та бази даних
    Data Model
    Архітектура Аутентифікації
    Архітектура Email AI-CRM
    Архітектура PaymentConductor
    Архітектура Refcodes
    Архітектура News Kingdom
    Proxy та інтернаціоналізація
    Real Time
    Security
    Функції
    Authentication
    Email AI-CRM
    Сутності
    Можливості
    Повідомлення
    Notifications
    Push-сповіщення через FCM (Ring)
    Протокол Tunnel
    Web3 Гаманець
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Реферальні коди (Refcodes)
    Інтеграція платежів
    PaymentConductor
    Інтеграція WayForPay
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Науковий редактор
    Система локалей
    Безпека та відповідність
    NFT Маркетплейс
    Система Стейкінга Токенів
    Паттерни Оптимізації Продуктивності
    Мобільний Досвід
    API-інтерфейс
    Аутентифікація
    Email AI-CRM API
    Entities
    Можливості
    API повідомлень
    API повідомлень
    Гаманець
    API магазину
    API адміністратора
    CLI
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вибір бекенду бази даних
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Налаштування агентів ШІ
    Еталонні деплої Ring
    Брендування
    Функції
    Локалізація
    Теми
    Компоненти
    Web3
    Token launch jurisdictions
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Environment
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Розробка
    Локальне налаштування
    Структура коду
    Компоненти документації
    Community tooling
    Ring MCP Server
    Генеративні зображення (ImageConductor)
    Автономна редакція (Grok)
    OSS vs enterprise
    Найкращі практики
    Workflow
    Code Style
    Performance
    Тестування
    Розгортання
    Налагодження
    Співпраця
    Дорожня карта
    Приклади
    Швидкий старт
    Автентифікація
    Email AI-CRM — гайд розробника
    Інтеграція API
    Інтеграція Web3
    Білий лейбл
    Реальні приклади
    Приклади API
    Інтеграції
    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
    Швидкий довідник
    Початок роботи
    Передумови
    Встановлення
    Міграції бази даних
    Валідація першого успіху
    Усунення несправностей
    Наступні кроки
    Архітектура
    Режими бекенду та бази даних
    Data Model
    Архітектура Аутентифікації
    Архітектура Email AI-CRM
    Архітектура PaymentConductor
    Архітектура Refcodes
    Архітектура News Kingdom
    Proxy та інтернаціоналізація
    Real Time
    Security
    Функції
    Authentication
    Email AI-CRM
    Сутності
    Можливості
    Повідомлення
    Notifications
    Push-сповіщення через FCM (Ring)
    Протокол Tunnel
    Web3 Гаманець
    Магазин
    Склад і залишки
    Керування вендорами
    Комісії та розрахунки
    Реферальні коди (Refcodes)
    Інтеграція платежів
    PaymentConductor
    Інтеграція WayForPay
    Модуль Новин - Цифровий Газетний Досвід
    Блоги учасників
    Науковий редактор
    Система локалей
    Безпека та відповідність
    NFT Маркетплейс
    Система Стейкінга Токенів
    Паттерни Оптимізації Продуктивності
    Мобільний Досвід
    API-інтерфейс
    Аутентифікація
    Email AI-CRM API
    Entities
    Можливості
    API повідомлень
    API повідомлень
    Гаманець
    API магазину
    API адміністратора
    CLI
    Кастомізація
    Швидкий старт — ваш перший клон Ring
    Повний посібник налаштування
    Вибір бекенду бази даних
    Налаштування токеноміки
    Інтеграція платіжних шлюзів
    Налаштування агентів ШІ
    Еталонні деплої Ring
    Брендування
    Функції
    Локалізація
    Теми
    Компоненти
    Web3
    Token launch jurisdictions
    Розгортання
    Self-hosted розгортання
    Vercel
    Docker
    Environment
    Моніторинг та аналітика
    Оптимізація продуктивності
    Резервне копіювання та відновлення
    Розробка
    Локальне налаштування
    Структура коду
    Компоненти документації
    Community tooling
    Ring MCP Server
    Генеративні зображення (ImageConductor)
    Автономна редакція (Grok)
    OSS vs enterprise
    Найкращі практики
    Workflow
    Code Style
    Performance
    Тестування
    Розгортання
    Налагодження
    Співпраця
    Дорожня карта
    Приклади
    Швидкий старт
    Автентифікація
    Email AI-CRM — гайд розробника
    Інтеграція API
    Інтеграція Web3
    Білий лейбл
    Реальні приклади
    Приклади API
    Інтеграції
    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