Preparing Ring content
Preparing Ring content
Preparing Ring content
Ring Oracle — server-only фасад курсов в @/lib/ring-oracle. Он даёт коду платежей, кошелька, membership, public pools и магазина единый словарь стоимости проекта вместо жёстко прописанных символов токенов или fiat.
Используйте Основатель / Разработчик в боковой панели документации для фильтрации этой страницы. Основатели видят путь оператора и поведение checkout; разработчики видят проверенные модули, маршруты, payloads и smoke-команды.
| Деноминация | Значение | Настроенная идентичность |
|---|---|---|
credit_balance | Единица ledger, принадлежащая проекту | credit.creditBalanceUnitLabel и credit.creditBalanceUnitToMainCurrency |
native_token | Нативный токен клона | tokens.nativeToken.symbol |
main_currency | Fiat расчётов проекта | store.mainCurrency |
ValueDenomination содержит ровно эти три значения. Символы валют, такие как RING, USD или UAH, это значения отображения/конфига, а не ID деноминаций.
GET и POST /api/prices/conversion принимают только native_token и main_currency. credit_balance использует поверхность учёта кредитов, а устаревшие алиасы запроса RING / USD возвращают HTTP 400.
Кошелёк, checkout, membership и финансирование сообщества определяют стоимость проекта через одну модель деноминаций.
ProcessConductor обновляет fiat-курсы презентации, а ручные переопределения остаются доступны в конфиге клона.
Магазин разделяет то, что видит покупатель, и fiat-валюту, которую списывает карточный шлюз или PayPal.
Задайте в ring-config.json основную валюту проекта, поддерживаемые fiat-валюты презентации, поддерживаемые крипто-символы, нативный токен и курс учёта кредитов. Ring Oracle читает эти идентичности проекта; продуктовому коду не нужен особый случай .
Зависимость: PaymentConductor использует курсы Oracle, когда rail пересекает деноминации.
Тот же процесс: отображение каталога, презентация в checkout и создание списания на сервере.
Подробно: котировки Token Desk, учёт кредитов и балансы нативного токена.
См. также: награды за активность фиксируют getMainCurrencyCreditAccountingRate; аварийный выключатель credit.rewards.enabled.
Ring Oracle — server-only фасад курсов в @/lib/ring-oracle. Он даёт коду платежей, кошелька, membership, public pools и магазина единый словарь стоимости проекта вместо жёстко прописанных символов токенов или fiat.
Используйте Основатель / Разработчик в боковой панели документации для фильтрации этой страницы. Основатели видят путь оператора и поведение checkout; разработчики видят проверенные модули, маршруты, payloads и smoke-команды.
| Деноминация | Значение | Настроенная идентичность |
|---|---|---|
credit_balance | Единица ledger, принадлежащая проекту | credit.creditBalanceUnitLabel и credit.creditBalanceUnitToMainCurrency |
native_token | Нативный токен клона | tokens.nativeToken.symbol |
main_currency | Fiat расчётов проекта | store.mainCurrency |
ValueDenomination содержит ровно эти три значения. Символы валют, такие как RING, USD или UAH, это значения отображения/конфига, а не ID деноминаций.
GET и POST /api/prices/conversion принимают только native_token и main_currency. credit_balance использует поверхность учёта кредитов, а устаревшие алиасы запроса RING / USD возвращают HTTP 400.
Кошелёк, checkout, membership и финансирование сообщества определяют стоимость проекта через одну модель деноминаций.
ProcessConductor обновляет fiat-курсы презентации, а ручные переопределения остаются доступны в конфиге клона.
Магазин разделяет то, что видит покупатель, и fiat-валюту, которую списывает карточный шлюз или PayPal.
Задайте в ring-config.json основную валюту проекта, поддерживаемые fiat-валюты презентации, поддерживаемые крипто-символы, нативный токен и курс учёта кредитов. Ring Oracle читает эти идентичности проекта; продуктовому коду не нужен особый случай .
Зависимость: PaymentConductor использует курсы Oracle, когда rail пересекает деноминации.
Тот же процесс: отображение каталога, презентация в checkout и создание списания на сервере.
Подробно: котировки Token Desk, учёт кредитов и балансы нативного токена.
См. также: награды за активность фиксируют getMainCurrencyCreditAccountingRate; аварийный выключатель credit.rewards.enabled.
Ring Oracle — server-only фасад курсов в @/lib/ring-oracle. Он даёт коду платежей, кошелька, membership, public pools и магазина единый словарь стоимости проекта вместо жёстко прописанных символов токенов или fiat.
Используйте Основатель / Разработчик в боковой панели документации для фильтрации этой страницы. Основатели видят путь оператора и поведение checkout; разработчики видят проверенные модули, маршруты, payloads и smoke-команды.
| Деноминация | Значение | Настроенная идентичность |
|---|---|---|
credit_balance | Единица ledger, принадлежащая проекту | credit.creditBalanceUnitLabel и credit.creditBalanceUnitToMainCurrency |
native_token | Нативный токен клона | tokens.nativeToken.symbol |
main_currency | Fiat расчётов проекта | store.mainCurrency |
ValueDenomination содержит ровно эти три значения. Символы валют, такие как RING, USD или UAH, это значения отображения/конфига, а не ID деноминаций.
GET и POST /api/prices/conversion принимают только native_token и main_currency. credit_balance использует поверхность учёта кредитов, а устаревшие алиасы запроса RING / USD возвращают HTTP 400.
Кошелёк, checkout, membership и финансирование сообщества определяют стоимость проекта через одну модель деноминаций.
ProcessConductor обновляет fiat-курсы презентации, а ручные переопределения остаются доступны в конфиге клона.
Магазин разделяет то, что видит покупатель, и fiat-валюту, которую списывает карточный шлюз или PayPal.
Задайте в ring-config.json основную валюту проекта, поддерживаемые fiat-валюты презентации, поддерживаемые крипто-символы, нативный токен и курс учёта кредитов. Ring Oracle читает эти идентичности проекта; продуктовому коду не нужен особый случай .
Зависимость: PaymentConductor использует курсы Oracle, когда rail пересекает деноминации.
Тот же процесс: отображение каталога, презентация в checkout и создание списания на сервере.
Подробно: котировки Token Desk, учёт кредитов и балансы нативного токена.
См. также: награды за активность фиксируют getMainCurrencyCreditAccountingRate; аварийный выключатель credit.rewards.enabled.
RING/USDring-config.fx определяет провайдеров в таком порядке:
fx.byMainCurrency[store.mainCurrency]UAHfx.default для остальных основных валютПоставляемый default использует NBU для UAH и open_er_api в остальных случаях. fx.manualOverrides имеет приоритет и над статическими курсами, и над live overlay.
Откройте /admin/web3/settings как superadmin, чтобы обновить курс desk нативного токена, посмотреть определённого fiat FX-провайдера и время последней загрузки или принудительно обновить FX. UI читает GET /api/admin/web3/settings и GET /api/admin/fx; запись идёт через соответствующие POST-маршруты.
Production-планировщики вызывают GET /api/cron/fx-feed-refresh. Задайте CRON_SECRET и передавайте его как Bearer token. Маршрут записывает запуск через ProcessConductor под pipeline ID fx-feed-refresh; устаревание фида по-прежнему следует настроенному refreshHours.
Левая навигационная панель переключает только между main_currency (последний fiat-выбор покупателя) и native_token. Выпадающий список checkout следует этому режиму: fiat показывает настроенные SupportedCurrencies; native показывает настроенные SupportedCrypto.
Шаг проверки конвертирует строки товаров и итоги через convertPrice / displayPrice. Карта и PayPal остаются fiat-списаниями: checkout передаёт fiat paymentCurrency, а сервер пересчитывает сумму списания из итога заказа в основной валюте перед вызовом PaymentConductor.
Крипто-сумма на шаге проверки checkout это презентация, а не доказательство того, что карточный шлюз спишет крипту. Расчёт определяют платёжный rail и paymentCurrency.
| Учёт кредитов | lib/payments/credit-balance.ts | Хелперы единица кредита ↔ main |
| FX pipeline | lib/processes/fx/fx-feed-refresh.ts, lib/processes/registry.ts | Обработчик ProcessConductor, ID и путь cron |
| API конвертации | app/api/prices/conversion/route.ts | Публичный контракт курса и конвертации native ↔ main |
| SSR hydrate | app/layout.tsx | AuthenticatedAppShell прогревает и читает курсы |
| Client provider | components/providers/app-client-shell.tsx | Передаёт initialExchangeRates в контекст валюты магазина |
| Контекст валюты магазина | features/store/currency-context.tsx | Режим отображения, конвертация, форматирование, предпочтения |
| Презентация checkout | features/store/components/checkout/prebilling-page.tsx | Выпадающий список fiat/crypto и fiat paymentCurrency |
| Списание checkout | app/_actions/store-checkout-payment.ts | Серверный пересчёт fiat для карты/PayPal |
Серверный код импортирует курсы из фасада, а не из модулей реализации:
@/lib/ring-oracle импортирует server-only. Клиентские компоненты получают сериализуемые данные курсов через AuthenticatedAppShell, AppClientShell или client-safe server action getLiveExchangeRates.
ID провайдеров: nbu, open_er_api и frankfurter. Жёсткий guard заменяет NBU на open_er_api, если основная валюта не UAH.
Проверка авторизации зависит от наличия CRON_SECRET, поэтому production-деплои обязаны его настроить. Ответ включает runId ProcessConductor и метаданные обновления; отключённый фид сообщает об успешном пропущенном запуске. Курсы сохраняются в platform_settings с id fx_feed (тот же гибридный JSONB-паттерн, что и у desk oracle). Поставляйте k8s/cronjob-fx-feed-refresh.yaml для ежечасного обновления в кластере.
GET /api/admin/fx возвращает для platform admins определённую конфигурацию фида, переопределения, время загрузки, выборку курсов и определённые курсы. POST /api/admin/fx принимает { "force": true } и обновляет фид. Чтение и запись курса desk остаются на маршруте /api/admin/web3/settings только для superadmin.
GET /api/prices/conversion возвращает denominations: ["native_token", "main_currency"], обе пары направлений, курсы и обратные курсы, метаданные источника и лимиты от 0.000001 до 1000000.
amount должен быть положительной десятичной строкой, а from должен отличаться от to. Ответ включает ID деноминаций, настроенные валюты отображения, исходную сумму, сконвертированную сумму, курс, timestamp, confidence, нулевую комиссию конвертации и метаданные источника.
{ "from": "RING", "to": "USD" } недопустимо, даже если это настроенные символы клона. Отправляйте ID деноминаций, а не символы.
AuthenticatedAppShell вызывает ensureFxFeedFresh(), затем getExchangeRates(). Если обновление не удалось, shell оставляет initialExchangeRates равным null, и клиентский код откатывается к статическим курсам ring-config.
AppClientShell передаёт сериализуемые курсы в StorePaymentMethodsProvider. Провайдер стартует с этого SSR seed, затем после гидрации вызывает getLiveExchangeRates(), чтобы конвертация в браузере совпадала с серверным checkout.
StorePaymentMethodsProvider.displayMode принимает только main_currency | native_token. PrebillingPage строит выпадающий список из getSupportedCurrencies() или getSupportedCrypto(), сохраняя fiat paymentCurrency для карты и PayPal. submitStoreCheckoutPayment проверяет этот fiat по поддерживаемому пулу презентации и пересчитывает сумму на сервере.
Запустите поставляемый smoke smk46_ из ring-platform.org:
Smoke проверяет регистрацию pipeline, выбор и обновление провайдера, round-trip сервиса native ↔ main, опциональные контракты GET / POST конвертации, HTTP 400 для устаревших RING / USD и поведение ответа cron.
RING/USDring-config.fx определяет провайдеров в таком порядке:
fx.byMainCurrency[store.mainCurrency]UAHfx.default для остальных основных валютПоставляемый default использует NBU для UAH и open_er_api в остальных случаях. fx.manualOverrides имеет приоритет и над статическими курсами, и над live overlay.
Откройте /admin/web3/settings как superadmin, чтобы обновить курс desk нативного токена, посмотреть определённого fiat FX-провайдера и время последней загрузки или принудительно обновить FX. UI читает GET /api/admin/web3/settings и GET /api/admin/fx; запись идёт через соответствующие POST-маршруты.
Production-планировщики вызывают GET /api/cron/fx-feed-refresh. Задайте CRON_SECRET и передавайте его как Bearer token. Маршрут записывает запуск через ProcessConductor под pipeline ID fx-feed-refresh; устаревание фида по-прежнему следует настроенному refreshHours.
Левая навигационная панель переключает только между main_currency (последний fiat-выбор покупателя) и native_token. Выпадающий список checkout следует этому режиму: fiat показывает настроенные SupportedCurrencies; native показывает настроенные SupportedCrypto.
Шаг проверки конвертирует строки товаров и итоги через convertPrice / displayPrice. Карта и PayPal остаются fiat-списаниями: checkout передаёт fiat paymentCurrency, а сервер пересчитывает сумму списания из итога заказа в основной валюте перед вызовом PaymentConductor.
Крипто-сумма на шаге проверки checkout это презентация, а не доказательство того, что карточный шлюз спишет крипту. Расчёт определяют платёжный rail и paymentCurrency.
| Учёт кредитов | lib/payments/credit-balance.ts | Хелперы единица кредита ↔ main |
| FX pipeline | lib/processes/fx/fx-feed-refresh.ts, lib/processes/registry.ts | Обработчик ProcessConductor, ID и путь cron |
| API конвертации | app/api/prices/conversion/route.ts | Публичный контракт курса и конвертации native ↔ main |
| SSR hydrate | app/layout.tsx | AuthenticatedAppShell прогревает и читает курсы |
| Client provider | components/providers/app-client-shell.tsx | Передаёт initialExchangeRates в контекст валюты магазина |
| Контекст валюты магазина | features/store/currency-context.tsx | Режим отображения, конвертация, форматирование, предпочтения |
| Презентация checkout | features/store/components/checkout/prebilling-page.tsx | Выпадающий список fiat/crypto и fiat paymentCurrency |
| Списание checkout | app/_actions/store-checkout-payment.ts | Серверный пересчёт fiat для карты/PayPal |
Серверный код импортирует курсы из фасада, а не из модулей реализации:
@/lib/ring-oracle импортирует server-only. Клиентские компоненты получают сериализуемые данные курсов через AuthenticatedAppShell, AppClientShell или client-safe server action getLiveExchangeRates.
ID провайдеров: nbu, open_er_api и frankfurter. Жёсткий guard заменяет NBU на open_er_api, если основная валюта не UAH.
Проверка авторизации зависит от наличия CRON_SECRET, поэтому production-деплои обязаны его настроить. Ответ включает runId ProcessConductor и метаданные обновления; отключённый фид сообщает об успешном пропущенном запуске. Курсы сохраняются в platform_settings с id fx_feed (тот же гибридный JSONB-паттерн, что и у desk oracle). Поставляйте k8s/cronjob-fx-feed-refresh.yaml для ежечасного обновления в кластере.
GET /api/admin/fx возвращает для platform admins определённую конфигурацию фида, переопределения, время загрузки, выборку курсов и определённые курсы. POST /api/admin/fx принимает { "force": true } и обновляет фид. Чтение и запись курса desk остаются на маршруте /api/admin/web3/settings только для superadmin.
GET /api/prices/conversion возвращает denominations: ["native_token", "main_currency"], обе пары направлений, курсы и обратные курсы, метаданные источника и лимиты от 0.000001 до 1000000.
amount должен быть положительной десятичной строкой, а from должен отличаться от to. Ответ включает ID деноминаций, настроенные валюты отображения, исходную сумму, сконвертированную сумму, курс, timestamp, confidence, нулевую комиссию конвертации и метаданные источника.
{ "from": "RING", "to": "USD" } недопустимо, даже если это настроенные символы клона. Отправляйте ID деноминаций, а не символы.
AuthenticatedAppShell вызывает ensureFxFeedFresh(), затем getExchangeRates(). Если обновление не удалось, shell оставляет initialExchangeRates равным null, и клиентский код откатывается к статическим курсам ring-config.
AppClientShell передаёт сериализуемые курсы в StorePaymentMethodsProvider. Провайдер стартует с этого SSR seed, затем после гидрации вызывает getLiveExchangeRates(), чтобы конвертация в браузере совпадала с серверным checkout.
StorePaymentMethodsProvider.displayMode принимает только main_currency | native_token. PrebillingPage строит выпадающий список из getSupportedCurrencies() или getSupportedCrypto(), сохраняя fiat paymentCurrency для карты и PayPal. submitStoreCheckoutPayment проверяет этот fiat по поддерживаемому пулу презентации и пересчитывает сумму на сервере.
Запустите поставляемый smoke smk46_ из ring-platform.org:
Smoke проверяет регистрацию pipeline, выбор и обновление провайдера, round-trip сервиса native ↔ main, опциональные контракты GET / POST конвертации, HTTP 400 для устаревших RING / USD и поведение ответа cron.
RING/USDring-config.fx определяет провайдеров в таком порядке:
fx.byMainCurrency[store.mainCurrency]UAHfx.default для остальных основных валютПоставляемый default использует NBU для UAH и open_er_api в остальных случаях. fx.manualOverrides имеет приоритет и над статическими курсами, и над live overlay.
Откройте /admin/web3/settings как superadmin, чтобы обновить курс desk нативного токена, посмотреть определённого fiat FX-провайдера и время последней загрузки или принудительно обновить FX. UI читает GET /api/admin/web3/settings и GET /api/admin/fx; запись идёт через соответствующие POST-маршруты.
Production-планировщики вызывают GET /api/cron/fx-feed-refresh. Задайте CRON_SECRET и передавайте его как Bearer token. Маршрут записывает запуск через ProcessConductor под pipeline ID fx-feed-refresh; устаревание фида по-прежнему следует настроенному refreshHours.
Левая навигационная панель переключает только между main_currency (последний fiat-выбор покупателя) и native_token. Выпадающий список checkout следует этому режиму: fiat показывает настроенные SupportedCurrencies; native показывает настроенные SupportedCrypto.
Шаг проверки конвертирует строки товаров и итоги через convertPrice / displayPrice. Карта и PayPal остаются fiat-списаниями: checkout передаёт fiat paymentCurrency, а сервер пересчитывает сумму списания из итога заказа в основной валюте перед вызовом PaymentConductor.
Крипто-сумма на шаге проверки checkout это презентация, а не доказательство того, что карточный шлюз спишет крипту. Расчёт определяют платёжный rail и paymentCurrency.
| Учёт кредитов | lib/payments/credit-balance.ts | Хелперы единица кредита ↔ main |
| FX pipeline | lib/processes/fx/fx-feed-refresh.ts, lib/processes/registry.ts | Обработчик ProcessConductor, ID и путь cron |
| API конвертации | app/api/prices/conversion/route.ts | Публичный контракт курса и конвертации native ↔ main |
| SSR hydrate | app/layout.tsx | AuthenticatedAppShell прогревает и читает курсы |
| Client provider | components/providers/app-client-shell.tsx | Передаёт initialExchangeRates в контекст валюты магазина |
| Контекст валюты магазина | features/store/currency-context.tsx | Режим отображения, конвертация, форматирование, предпочтения |
| Презентация checkout | features/store/components/checkout/prebilling-page.tsx | Выпадающий список fiat/crypto и fiat paymentCurrency |
| Списание checkout | app/_actions/store-checkout-payment.ts | Серверный пересчёт fiat для карты/PayPal |
Серверный код импортирует курсы из фасада, а не из модулей реализации:
@/lib/ring-oracle импортирует server-only. Клиентские компоненты получают сериализуемые данные курсов через AuthenticatedAppShell, AppClientShell или client-safe server action getLiveExchangeRates.
ID провайдеров: nbu, open_er_api и frankfurter. Жёсткий guard заменяет NBU на open_er_api, если основная валюта не UAH.
Проверка авторизации зависит от наличия CRON_SECRET, поэтому production-деплои обязаны его настроить. Ответ включает runId ProcessConductor и метаданные обновления; отключённый фид сообщает об успешном пропущенном запуске. Курсы сохраняются в platform_settings с id fx_feed (тот же гибридный JSONB-паттерн, что и у desk oracle). Поставляйте k8s/cronjob-fx-feed-refresh.yaml для ежечасного обновления в кластере.
GET /api/admin/fx возвращает для platform admins определённую конфигурацию фида, переопределения, время загрузки, выборку курсов и определённые курсы. POST /api/admin/fx принимает { "force": true } и обновляет фид. Чтение и запись курса desk остаются на маршруте /api/admin/web3/settings только для superadmin.
GET /api/prices/conversion возвращает denominations: ["native_token", "main_currency"], обе пары направлений, курсы и обратные курсы, метаданные источника и лимиты от 0.000001 до 1000000.
amount должен быть положительной десятичной строкой, а from должен отличаться от to. Ответ включает ID деноминаций, настроенные валюты отображения, исходную сумму, сконвертированную сумму, курс, timestamp, confidence, нулевую комиссию конвертации и метаданные источника.
{ "from": "RING", "to": "USD" } недопустимо, даже если это настроенные символы клона. Отправляйте ID деноминаций, а не символы.
AuthenticatedAppShell вызывает ensureFxFeedFresh(), затем getExchangeRates(). Если обновление не удалось, shell оставляет initialExchangeRates равным null, и клиентский код откатывается к статическим курсам ring-config.
AppClientShell передаёт сериализуемые курсы в StorePaymentMethodsProvider. Провайдер стартует с этого SSR seed, затем после гидрации вызывает getLiveExchangeRates(), чтобы конвертация в браузере совпадала с серверным checkout.
StorePaymentMethodsProvider.displayMode принимает только main_currency | native_token. PrebillingPage строит выпадающий список из getSupportedCurrencies() или getSupportedCrypto(), сохраняя fiat paymentCurrency для карты и PayPal. submitStoreCheckoutPayment проверяет этот fiat по поддерживаемому пулу презентации и пересчитывает сумму на сервере.
Запустите поставляемый smoke smk46_ из ring-platform.org:
Smoke проверяет регистрацию pipeline, выбор и обновление провайдера, round-trip сервиса native ↔ main, опциональные контракты GET / POST конвертации, HTTP 400 для устаревших RING / USD и поведение ответа cron.