Змінні середовища
Усі сервіси читають налаштування зі змінних середовища; .env.example у репозиторії перелічує їх з коментарями. Значення за замовчуванням нижче — те, що використовує код, коли змінну не задано.
Кілька значень протоколу (бюджет газу, стейк, винагороди, слешинг, пороги AI) — параметри управління, що зберігаються в мережі. Якщо для такого є змінна середовища, вона перекриває значення з мережі на цій ноді під час запуску — це для тестових мереж; у спільній мережі кожен валідатор має використовувати однакове значення. Див. Управління → Параметри.
Нода
Мережа й ідентичність
| Змінна | За замовчуванням | Значення |
|---|---|---|
CHAIN_ENV | mainnet | mainnet: суворі підписи, кран вимкнено, RPC на localhost. testnet: підписи лише з попередженням, кран увімкнено |
NEUROCHAIN_NETWORK | neurochain-mainnet-1 | Id мережі |
NEUROCHAIN_DATA_DIR | ./data | Папка даних (стан, WAL, ключ) |
NEUROCHAIN_MODELS_DIR | ./models | Ваги AI-моделей |
NEUROCHAIN_RPC_PORT | 9933 | Порт HTTP RPC |
NEUROCHAIN_RPC_HOST | localhost (mainnet) / 0.0.0.0 (testnet) | Адреса прив'язки RPC |
NEUROCHAIN_P2P_PORT | 30333 | P2P-порт (несе й консенсус) |
NEUROCHAIN_P2P_PORT_MIN / _MAX | 1024 / 65534 | Допустимий діапазон портів пірів |
NEUROCHAIN_NODE_ADDR | localhost:<p2p port> | Адреса, за якою піри досягають цієї ноди; не може бути 0.0.0.0. Зіставляє ноду з її записом валідатора в генезисі |
NEUROCHAIN_BOOTSTRAP | — | Піри через кому, до яких підключитися на старті |
NEUROCHAIN_PEER_DISCOVERY_SECS | 30 | Інтервал пошуку пірів |
NEUROCHAIN_P2P_CONN_RATE_LIMIT | 20 | Вхідних P2P-з'єднань за секунду з одного IP |
NEUROCHAIN_TLS_CERT, NEUROCHAIN_TLS_KEY | — | Обслуговувати RPC через HTTPS |
Генезис
| Змінна | За замовчуванням | Значення |
|---|---|---|
NEUROCHAIN_GENESIS_VALIDATORS | лише ця нода | `neuro:name.node |
NEUROCHAIN_GENESIS_ACCOUNTS | — | `neuro:addr.human |
NEUROCHAIN_FAUCET_BALANCE | 1 000 000 000 NRO | Баланс сховища крана при генезисі |
NEUROCHAIN_INITIAL_BALANCE | 0 | uNRO, що зараховуються невідомому акаунту при першому читанні (лише тестові мережі) |
NEUROCHAIN_GAS_SPONSOR | neuro:faucet.vault | Спонсор газу для новачків |
NEUROCHAIN_GAS_SPONSOR_FUND | 1 000 000 NRO | Його пул газу при генезисі |
NEUROCHAIN_CHECKPOINT_URL | — | Запустити порожню ноду зі знімка стану цієї ноди |
Консенсус і шардинг
| Змінна | За замовчуванням | Значення |
|---|---|---|
NEUROCHAIN_MIN_VALIDATORS | 7 | Нижче цього нода попереджає про знижену стійкість до збоїв |
NEUROCHAIN_BLOCK_MS | 200 | Мінімальне очікування перед пропозицією блоку з транзакціями |
NEUROCHAIN_EMPTY_BLOCK_MS | 2000 | Мінімальне очікування перед пропозицією порожнього блоку |
NEUROCHAIN_SYNC_HISTORY_BLOCKS | 10000 | Скільки вирішених блоків тримати для пірів, що наздоганяють |
NEUROCHAIN_JAIL_BLOCKS | 10000 | Тривалість jail після слешингу (параметр управління jail_blocks) |
NEUROCHAIN_SLASH_FRACTION_DOUBLE_SIGN_BPS | 500 | Слешинг за подвійний підпис, базисні пункти від min_stake |
NEUROCHAIN_SLASH_REWARD_FRACTION_BPS | 100 | Частка слешингу тому, хто повідомив |
NEUROCHAIN_SLASH_EVIDENCE_WINDOW | 10000 | Найстаріше порушення (у блоках), яке можуть довести докази |
NEUROCHAIN_SHARD_ID | — | Шард, який обслуговує ця нода; не задано = один шард |
NEUROCHAIN_SHARDS | 4 з id шарда, інакше 1 | Кількість шардів |
NEUROCHAIN_SHARD_DIR_PREFIX | shard | Назва підпапки для кожного шарда |
Економіка й мемпул
| Змінна | За замовчуванням | Значення |
|---|---|---|
NEUROCHAIN_UNBONDING_BLOCKS | управління (1 512 000) | Блокування стейку |
NEUROCHAIN_REWARD_INTERVAL_BLOCKS | управління (216 000) | Блоків між виплатами винагород |
NEUROCHAIN_FUEL_PER_GAS_UNIT | 20000 | Fuel контракту за одиницю газу |
NEUROCHAIN_MAX_SPONSORED_FEE | 100000 uNRO | Найбільша комісія, яку пул газу платить за транзакцію |
NEUROCHAIN_MAX_MEMPOOL | 10000 | Скільки очікуваних транзакцій тримати |
NEUROCHAIN_MAX_PENDING_PER_ACCOUNT | 64 | Очікуваних транзакцій на відправника |
NEUROCHAIN_RBF_MIN_BUMP_PCT | 10 | Підвищення ціни газу, потрібне для заміни очікуваної транзакції |
NEUROCHAIN_MIN_FEE_PER_GAS | 0 | Додатковий мінімум ціни в мемпулі |
NEUROCHAIN_FAUCET_MAX_NRO | 100 | Найбільший запит до крана (тестові мережі) |
NEUROCHAIN_FAUCET_COOLDOWN_SECS | 86400 | Пауза крана для адреси; 0 = без паузи |
AI
| Змінна | За замовчуванням | Значення |
|---|---|---|
MONITOR_INTERVAL_SECS | 20 | Повторний аудит розгорнутих контрактів |
MONITOR_SCORE_THRESHOLD | 10 | Зміна оцінки, що запускає оновлення сертифіката |
NEUROCHAIN_SENTINEL_POLICY_ENABLED | управління (0) | Шар політик Sentinel увімкнено/вимкнено |
NEUROCHAIN_SENTINEL_HOLD_THRESHOLD | управління (60) | Оцінка × 100, з якої перекази утримуються |
NEUROCHAIN_SENTINEL_STEPUP_THRESHOLD | управління (70) | Оцінка × 100, з якої власник має підтвердити |
NEUROCHAIN_SENTINEL_HOLD_BLOCKS | управління (50) | Затримка автоматичного звільнення |
NEUROCHAIN_SENTINEL_CONFIRM_EXPIRY_BLOCKS | управління (1000) | Очікування підтвердження до повернення |
NEUROCHAIN_SENTINEL_AGENT_CONFIRM_THRESHOLD | управління (60) | Поріг для переказів сесійним ключем |
NEUROCHAIN_TRUST_ACTIVATION_BLOCKS | управління (300) | Затримка, перш ніж довірений отримувач почне діяти |
AI_EXPORT_MAX_LIMIT | 5000 | Рядків на запит експорту даних для AI |
IBC v2
Див. IBC v2 і шардинг → Конфігурація: NEUROCHAIN_IBC_OPERATOR_PUBKEYS, NEUROCHAIN_IBC_TRUSTED_PUBKEYS, NEUROCHAIN_IBC_REQUIRE_HEADER, NEUROCHAIN_IBC_REQUIRE_PACKET_COMMITMENT, NEUROCHAIN_IBC_TIMEOUT_BLOCKS, NEUROCHAIN_IBC_MAX_PACKET_UNRO, NEUROCHAIN_IBC_MAX_CHANNEL_ESCROW_UNRO, NEUROCHAIN_IBC_NATIVE_DENOM.
Нативні активи
| Змінна | За замовчуванням | Значення |
|---|---|---|
NEUROCHAIN_ASSET_ISSUERS | — | Адреси, що отримують рівень емітента verified при генезисі |
NEUROCHAIN_RESERVED_SYMBOLS | — | Тікери, зарезервовані при генезисі |
Обидві читаються один раз, при генезисі; далі реєстри змінюються лише через управління.
Доступ і ліміти
| Змінна | За замовчуванням | Значення |
|---|---|---|
NEUROCHAIN_RPC_RATE_LIMIT | 100 | RPC-запитів за секунду на IP |
CORS_ALLOWED_ORIGINS | * | Дозволені джерела браузера |
NEUROCHAIN_INTERNAL_TOKEN | — | Обов'язковий X-Internal-Token для внутрішніх ендпоінтів |
NEUROCHAIN_SNAPSHOT_TOKEN | — | Обов'язковий bearer-токен для /api/v1/state/snapshot |
NEUROCHAIN_ALLOW_SERVER_DERIVE | false | Дозволити POST /api/v1/wallet/derive-address (отримує фразу відновлення) у тестових мережах; у mainnet завжди вимкнено |
RUST_LOG | neurochain=info,warn | Рівень журналу |
Gateway
З поясненнями — на сторінці Gateway: PORT, NODE_RPC_URL, NEUROCHAIN_SHARD_NODES, SHARD_NODE_URLS, NETWORK_ID, CORS_ALLOWED_ORIGINS, TLS_CERT, TLS_KEY, ліміти (GLOBAL_RL_MAX_RPS, AI_RL_MAX_RPM, WS_*), спостереження за мережею (POLL_NODE_INTERVAL_MS, SENTINEL_*, ALERT_COOLDOWN_MS), кран (FAUCET_AMOUNT, FAUCET_COOLDOWN_SECS, REDIS_URL) і AI-інструменти (ANTHROPIC_API_KEY, SMARTFORGE_*, AI_EXPORT_TOKEN, ASSISTANT_*).
Вебзастосунок
| Змінна | За замовчуванням | Значення |
|---|---|---|
WEB_PORT | 8080 | Порт сервера розробки |
WEB_HOST | localhost | Прив'язка сервера розробки; 0.0.0.0, щоб відкрити в мережі |
GATEWAY_URL | http://localhost:3000 | Gateway, на який сервер розробки проксує /api і /ws |
VUE_APP_NEUROCHAIN_RPC | — (те саме джерело) | Вшити у збірку фіксовану базову адресу API |
VUE_APP_SITE_URL, VUE_APP_SITE_NAME, VUE_APP_SITE_OG_IMAGE | — | Метадані розгорнутого застосунку |
VUE_APP_DOCS_URL | — | Посилання на цю документацію |
Сайт документації
| Змінна | За замовчуванням | Значення |
|---|---|---|
DOCS_SITE_URL | https://docs.nro.world | Канонічні адреси, sitemap, hreflang, llms.txt |
DOCS_OG_IMAGE | /og-image.png | Зображення для прев'ю в соцмережах |
DOCS_GOOGLE_SITE_VERIFICATION, DOCS_BING_SITE_VERIFICATION | — | Токени підтвердження власності для пошукових консолей |
DOCS_HOST, DOCS_PORT | localhost, 5173 | Сервер розробки |
DOCS_BASE | / | Базовий шлях |
MCP-сервер
| Змінна | За замовчуванням | Значення |
|---|---|---|
NEUROCHAIN_MCP_CONFIG | — | Шлях до JSON-конфігурації — див. AI-агенти (MCP) |