Підготовка контенту платформи Ring
Підготовка контенту платформи Ring
Підготовка контенту платформи Ring
navigation.docs_sidebar.audience.founderHint
navigation.docs_sidebar.audience.founderHint
navigation.docs_sidebar.audience.founderHint
Философия Ring: «Ваша платформа должна работать на вашей экономике». Каждый клон Ring может поставляться с эталонным стеком RING или форкнуть его под собственный utility-токен.
Платформы Ring выравнивают стимулы через on-chain utility: членские взносы, потоки маркетплейса, реферальные награды и опциональный стейкинг. В этом руководстве:
contracts/RingToken.sol и contracts/RingMembership.solТрадиционные платформы централизуют захват ценности — пользователи создают контент и транзакции, а контроль остаётся у основателей и инвесторов.
Токенные платформы Ring направляют комиссии в прозрачное казначейство, открывают премиум-функции через utility-балансы и со временем позволяют сообществу расширять экономику через governance и стейкинг.
| Поток | Поведение эталона RING |
|---|---|
| Членство | 1 RING / месяц → казначейство |
| Минимальный буфер | 12 RING (год) рекомендуется до подписки |
| Эмиссия | 1 000 000 000 RING минтится в казначейство при деплое |
| Сеть по умолчанию | Polygon (настраивается в клоне) |
Ring поставляет два upgradeable (UUPS) контракта, работающих вместе:
contracts/RingToken.sol)Upgradeable ERC-20 с burn, pause и распределением через казначейство.
| Параметр | Значение | Примечание |
|---|---|---|
INITIAL_SUPPLY | 1 000 000 000 RING | Минт в казначейство при initialize |
MEMBERSHIP_FEE | 1 RING / месяц | Только RingMembership вызывает deductMembershipFee |
MIN_SUBSCRIPTION_BALANCE | 12 RING | View-хелпер — год взносов |
| Decimals | 18 | Стандартная точность ERC-20 |
Ключевые функции:
deductMembershipFee(member) — переводит 1 RING участнику → казначейству; только связанный membership-контрактcreditTokens(recipient, amount, reason) — owner переводит из казначейства (airdrop, компенсации)hasSubscriptionBalance(user) / getRemainingMembershipMonths(user) — хелперы для UI и opspause() / unpause() — экстренная остановка трансферовsetTreasury / setMembershipContract — конфигурация owner после деплояRING спроектирован как utility-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.
contracts/RingMembership.sol)Управляет рекуррентной оплатой членства on-chain.
| Параметр | Значение |
|---|---|
SUBSCRIPTION_PERIOD | 30 дней |
GRACE_PERIOD | 7 дней после срока оплаты |
MAX_FAILED_ATTEMPTS | 3 до истечения подписки |
Жизненный цикл подписки:
createSubscription() — нужен баланс ≥ 1 RING; первый месяц списывается сразуprocessBatchPayments(batchSize) — owner/cron обрабатывает продленияfailedAttempts; после трёх — статус EXPIREDcancelSubscription() — отмена пользователем; suspendSubscription / reactivateSubscription — админhasActiveMembership(user) — true пока ACTIVE и в пределах grace periodСтатусы: INACTIVE, ACTIVE, EXPIRED, CANCELLED, SUSPENDED
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 |
| Oracle | services/blockchain/price-oracle-service.ts | RING/USD с fallback-источниками |
Типичный апгрейд:
subscriptionService.createSubscription списывает кредит и ставит next due (+30 дней)API (представительно):
GET /api/wallet/credit/balance — баланс и снимок подпискиPOST /api/membership/subscription/create — старт подпискиPOST /api/membership/payment/ring — оплата RINGGET /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/.
Установка и компиляция:
Testnet (скрипт Polygon Mumbai):
Порядок: RingToken → RingMembership → setMembershipContract. JSON деплоя — deployments/mumbai-deployment.json.
Mainnet:
Нужны RING_TREASURY_MAINNET и достаточно MATIC на deployer. scripts/deploy-mainnet.js — только после аудита и multisig казначейства.
Пропишите адреса в .env клона, передеплойте приложение, верифицируйте контракты на Polygonscan.
Проведите профессиональный аудит смарт-контрактов перед mainnet. Используйте multisig для казначейства и owner-ключей.
Используйте RING как шаблон для брендированной экономики.
Utility-токен (рекомендуется): Листинги, членство, комиссии маркетплейса. Без обещаний прибыли.
Security-токен: Доля или revenue share — регулирование ценных бумаг; обязателен legal review.
Один vs несколько токенов: Один проще; разделяйте governance и utility только при реальной необходимости.
Паттерны распределения:
Политика supply: Фиксированная (модель RING), контролируемая инфляция (staking rewards) или дефляция через burn комиссий.
Собирайте комиссии в казначейство; часть направляйте на staking rewards или burn согласно tokenomics paper.
RingToken.sol / RingMembership.sol или деплойте как есть со своим казначействомconstants/web3.ts и env-адресаuser-credit-service и subscription-serviceМетрики здоровья:
Запуск токена имеет последствия в зависимости от юрисдикции. Привлеките юристов до публичной продажи, листинга на бирже или маркетинга доходности.
Готовы к запуску? Пройдите чеклист для своего клона.
contracts/testНужна помощь с внедрением? Смотрите возможности кастомизации Ring или интеграцию платежей для fiat + token checkout.
Философия Ring: «Ваша платформа должна работать на вашей экономике». Каждый клон Ring может поставляться с эталонным стеком RING или форкнуть его под собственный utility-токен.
Платформы Ring выравнивают стимулы через on-chain utility: членские взносы, потоки маркетплейса, реферальные награды и опциональный стейкинг. В этом руководстве:
contracts/RingToken.sol и contracts/RingMembership.solТрадиционные платформы централизуют захват ценности — пользователи создают контент и транзакции, а контроль остаётся у основателей и инвесторов.
Токенные платформы Ring направляют комиссии в прозрачное казначейство, открывают премиум-функции через utility-балансы и со временем позволяют сообществу расширять экономику через governance и стейкинг.
| Поток | Поведение эталона RING |
|---|---|
| Членство | 1 RING / месяц → казначейство |
| Минимальный буфер | 12 RING (год) рекомендуется до подписки |
| Эмиссия | 1 000 000 000 RING минтится в казначейство при деплое |
| Сеть по умолчанию | Polygon (настраивается в клоне) |
Ring поставляет два upgradeable (UUPS) контракта, работающих вместе:
contracts/RingToken.sol)Upgradeable ERC-20 с burn, pause и распределением через казначейство.
| Параметр | Значение | Примечание |
|---|---|---|
INITIAL_SUPPLY | 1 000 000 000 RING | Минт в казначейство при initialize |
MEMBERSHIP_FEE | 1 RING / месяц | Только RingMembership вызывает deductMembershipFee |
MIN_SUBSCRIPTION_BALANCE | 12 RING | View-хелпер — год взносов |
| Decimals | 18 | Стандартная точность ERC-20 |
Ключевые функции:
deductMembershipFee(member) — переводит 1 RING участнику → казначейству; только связанный membership-контрактcreditTokens(recipient, amount, reason) — owner переводит из казначейства (airdrop, компенсации)hasSubscriptionBalance(user) / getRemainingMembershipMonths(user) — хелперы для UI и opspause() / unpause() — экстренная остановка трансферовsetTreasury / setMembershipContract — конфигурация owner после деплояRING спроектирован как utility-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.
contracts/RingMembership.sol)Управляет рекуррентной оплатой членства on-chain.
| Параметр | Значение |
|---|---|
SUBSCRIPTION_PERIOD | 30 дней |
GRACE_PERIOD | 7 дней после срока оплаты |
MAX_FAILED_ATTEMPTS | 3 до истечения подписки |
Жизненный цикл подписки:
createSubscription() — нужен баланс ≥ 1 RING; первый месяц списывается сразуprocessBatchPayments(batchSize) — owner/cron обрабатывает продленияfailedAttempts; после трёх — статус EXPIREDcancelSubscription() — отмена пользователем; suspendSubscription / reactivateSubscription — админhasActiveMembership(user) — true пока ACTIVE и в пределах grace periodСтатусы: INACTIVE, ACTIVE, EXPIRED, CANCELLED, SUSPENDED
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 |
| Oracle | services/blockchain/price-oracle-service.ts | RING/USD с fallback-источниками |
Типичный апгрейд:
subscriptionService.createSubscription списывает кредит и ставит next due (+30 дней)API (представительно):
GET /api/wallet/credit/balance — баланс и снимок подпискиPOST /api/membership/subscription/create — старт подпискиPOST /api/membership/payment/ring — оплата RINGGET /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/.
Установка и компиляция:
Testnet (скрипт Polygon Mumbai):
Порядок: RingToken → RingMembership → setMembershipContract. JSON деплоя — deployments/mumbai-deployment.json.
Mainnet:
Нужны RING_TREASURY_MAINNET и достаточно MATIC на deployer. scripts/deploy-mainnet.js — только после аудита и multisig казначейства.
Пропишите адреса в .env клона, передеплойте приложение, верифицируйте контракты на Polygonscan.
Проведите профессиональный аудит смарт-контрактов перед mainnet. Используйте multisig для казначейства и owner-ключей.
Используйте RING как шаблон для брендированной экономики.
Utility-токен (рекомендуется): Листинги, членство, комиссии маркетплейса. Без обещаний прибыли.
Security-токен: Доля или revenue share — регулирование ценных бумаг; обязателен legal review.
Один vs несколько токенов: Один проще; разделяйте governance и utility только при реальной необходимости.
Паттерны распределения:
Политика supply: Фиксированная (модель RING), контролируемая инфляция (staking rewards) или дефляция через burn комиссий.
Собирайте комиссии в казначейство; часть направляйте на staking rewards или burn согласно tokenomics paper.
RingToken.sol / RingMembership.sol или деплойте как есть со своим казначействомconstants/web3.ts и env-адресаuser-credit-service и subscription-serviceМетрики здоровья:
Запуск токена имеет последствия в зависимости от юрисдикции. Привлеките юристов до публичной продажи, листинга на бирже или маркетинга доходности.
Готовы к запуску? Пройдите чеклист для своего клона.
contracts/testНужна помощь с внедрением? Смотрите возможности кастомизации Ring или интеграцию платежей для fiat + token checkout.
Философия Ring: «Ваша платформа должна работать на вашей экономике». Каждый клон Ring может поставляться с эталонным стеком RING или форкнуть его под собственный utility-токен.
Платформы Ring выравнивают стимулы через on-chain utility: членские взносы, потоки маркетплейса, реферальные награды и опциональный стейкинг. В этом руководстве:
contracts/RingToken.sol и contracts/RingMembership.solТрадиционные платформы централизуют захват ценности — пользователи создают контент и транзакции, а контроль остаётся у основателей и инвесторов.
Токенные платформы Ring направляют комиссии в прозрачное казначейство, открывают премиум-функции через utility-балансы и со временем позволяют сообществу расширять экономику через governance и стейкинг.
| Поток | Поведение эталона RING |
|---|---|
| Членство | 1 RING / месяц → казначейство |
| Минимальный буфер | 12 RING (год) рекомендуется до подписки |
| Эмиссия | 1 000 000 000 RING минтится в казначейство при деплое |
| Сеть по умолчанию | Polygon (настраивается в клоне) |
Ring поставляет два upgradeable (UUPS) контракта, работающих вместе:
contracts/RingToken.sol)Upgradeable ERC-20 с burn, pause и распределением через казначейство.
| Параметр | Значение | Примечание |
|---|---|---|
INITIAL_SUPPLY | 1 000 000 000 RING | Минт в казначейство при initialize |
MEMBERSHIP_FEE | 1 RING / месяц | Только RingMembership вызывает deductMembershipFee |
MIN_SUBSCRIPTION_BALANCE | 12 RING | View-хелпер — год взносов |
| Decimals | 18 | Стандартная точность ERC-20 |
Ключевые функции:
deductMembershipFee(member) — переводит 1 RING участнику → казначейству; только связанный membership-контрактcreditTokens(recipient, amount, reason) — owner переводит из казначейства (airdrop, компенсации)hasSubscriptionBalance(user) / getRemainingMembershipMonths(user) — хелперы для UI и opspause() / unpause() — экстренная остановка трансферовsetTreasury / setMembershipContract — конфигурация owner после деплояRING спроектирован как utility-токен для доступа к платформе, а не инвестиционный продукт. Проконсультируйтесь с юристами перед обещаниями доходности, прибыли или ликвидности на вторичном рынке.
contracts/RingMembership.sol)Управляет рекуррентной оплатой членства on-chain.
| Параметр | Значение |
|---|---|
SUBSCRIPTION_PERIOD | 30 дней |
GRACE_PERIOD | 7 дней после срока оплаты |
MAX_FAILED_ATTEMPTS | 3 до истечения подписки |
Жизненный цикл подписки:
createSubscription() — нужен баланс ≥ 1 RING; первый месяц списывается сразуprocessBatchPayments(batchSize) — owner/cron обрабатывает продленияfailedAttempts; после трёх — статус EXPIREDcancelSubscription() — отмена пользователем; suspendSubscription / reactivateSubscription — админhasActiveMembership(user) — true пока ACTIVE и в пределах grace periodСтатусы: INACTIVE, ACTIVE, EXPIRED, CANCELLED, SUSPENDED
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 |
| Oracle | services/blockchain/price-oracle-service.ts | RING/USD с fallback-источниками |
Типичный апгрейд:
subscriptionService.createSubscription списывает кредит и ставит next due (+30 дней)API (представительно):
GET /api/wallet/credit/balance — баланс и снимок подпискиPOST /api/membership/subscription/create — старт подпискиPOST /api/membership/payment/ring — оплата RINGGET /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/.
Установка и компиляция:
Testnet (скрипт Polygon Mumbai):
Порядок: RingToken → RingMembership → setMembershipContract. JSON деплоя — deployments/mumbai-deployment.json.
Mainnet:
Нужны RING_TREASURY_MAINNET и достаточно MATIC на deployer. scripts/deploy-mainnet.js — только после аудита и multisig казначейства.
Пропишите адреса в .env клона, передеплойте приложение, верифицируйте контракты на Polygonscan.
Проведите профессиональный аудит смарт-контрактов перед mainnet. Используйте multisig для казначейства и owner-ключей.
Используйте RING как шаблон для брендированной экономики.
Utility-токен (рекомендуется): Листинги, членство, комиссии маркетплейса. Без обещаний прибыли.
Security-токен: Доля или revenue share — регулирование ценных бумаг; обязателен legal review.
Один vs несколько токенов: Один проще; разделяйте governance и utility только при реальной необходимости.
Паттерны распределения:
Политика supply: Фиксированная (модель RING), контролируемая инфляция (staking rewards) или дефляция через burn комиссий.
Собирайте комиссии в казначейство; часть направляйте на staking rewards или burn согласно tokenomics paper.
RingToken.sol / RingMembership.sol или деплойте как есть со своим казначействомconstants/web3.ts и env-адресаuser-credit-service и subscription-serviceМетрики здоровья:
Запуск токена имеет последствия в зависимости от юрисдикции. Привлеките юристов до публичной продажи, листинга на бирже или маркетинга доходности.
Готовы к запуску? Пройдите чеклист для своего клона.
contracts/testНужна помощь с внедрением? Смотрите возможности кастомизации Ring или интеграцию платежей для fiat + token checkout.
cd contracts && npm run deploy:referral
# Смарт-контракты (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...
cd contracts
npm install
npx hardhat compile
RING_TREASURY_TESTNET=0xYourTreasury \
npx hardhat run scripts/deploy-testnet.js --network polygon
cd contracts && npm run deploy:referral
# Смарт-контракты (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...
cd contracts
npm install
npx hardhat compile
RING_TREASURY_TESTNET=0xYourTreasury \
npx hardhat run scripts/deploy-testnet.js --network polygon
cd contracts && npm run deploy:referral
# Смарт-контракты (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...
cd contracts
npm install
npx hardhat compile
RING_TREASURY_TESTNET=0xYourTreasury \
npx hardhat run scripts/deploy-testnet.js --network polygon