Интерфейсы командной строки

Архив Core содержит три исполняемых файла:

Файл	Роль
`parano1d`	Полная нода, серверная часть кошелька и необязательный внутренний конвейер доказательства и майнинга
`parano1d-cli`	Тонкий JSON-RPC-клиент работающей ноды
`parano1d-miner`	Отдельный вычислитель nonce Poseidon2b

Демон Core

Обычная нода запускается без режима:

parano1d

Публичные параметры демона:

Параметр	Значение
`-c, --config FILE`	Путь к конфигурации TOML
`--mode node`	Обычная нода без майнинга
`--mode miner`	Нода со встроенным конвейером доказательства и PoW
`--mode extminer`	Нода строит доказательство, внешний вычислитель ищет nonce
`--miner`	Краткая форма `--mode miner`
`--extminer`	Краткая форма `--mode extminer`
`--miner-address ADDRESS`	Адрес выплаты; по умолчанию активный владелец кошелька
`--cpu-threads N`	Общий бюджет потоков встроенного майнера
`--data-dir PATH`	Каталог цепи, кошелька и данных времени выполнения
`--p2p-listen HOST:PORT`	Адрес приёма P2P-соединений; по умолчанию `0.0.0.0:9400`
`--rpc-listen HOST:PORT`	Адрес приёма JSON-RPC-соединений; по умолчанию `127.0.0.1:9401`
`--seed ENDPOINT`	Добавить адрес первоначального подключения; можно повторять
`--log LEVEL`	Фильтр tracing: `error`, `warn`, `info`, `debug` и другие
`--mining-key TOKEN`	Требовать токен доступа к RPC
`--allow-custom-coinbase`	Разрешить аутентифицированному внешнему вычислителю запросить свою выплату
`--purge-state`	Очистить базу цепи и заново синхронизировать цепь и Live State у пиров
`--check-hardware`	Проверить совместимость CPU и выйти, не затрагивая данные ноды

Параметры конкретного режима отклоняются там, где неприменимы. --cpu-threads относится ко встроенному майнеру. Внешний режим требует --mining-key, а --allow-custom-coinbase — одновременно внешний режим и этот ключ.

--purge-state — инструмент восстановления, а не обычный параметр запуска. Он очищает всю базу цепи: заголовки, индексы, сохранённые полные блоки, данные отката и Live State. Файлы кошелька, чеки и идентификатор пира хранятся отдельно и сохраняются; после очистки цепь и Live State синхронизируются заново.

Примеры:

# Ordinary node
parano1d --data-dir ~/.parano1d/data

# Internal miner using 12 logical CPUs
parano1d --mode miner --cpu-threads 12

# Node with a local external nonce worker
parano1d --mode extminer --mining-key 'LONG-RANDOM-TOKEN'

Оставляйте RPC на локальном интерфейсе, если он не защищён приватным или аутентифицированным транспортом. Токен доступа аутентифицирует запросы, но не шифрует их.

Внешний майнер

parano1d-miner запрашивает уже доказанный неизменяемый шаблон и ищет только его 128-битный nonce.

Параметр	По умолчанию	Значение
`--rpc URL`	`http://127.0.0.1:9401`	Адрес JSON-RPC ноды
`--key TOKEN`	—	Токен доступа, совпадающий с `--mining-key` ноды
`--threads N`	`0`	Потоки PoW; ноль использует все видимые логические CPU
`--coinbase ADDRESS`	—	Пользовательская выплата `o1…`, если нода явно её разрешила
`--poll-ms MS`	`500`	Задержка перед запросом следующего шаблона
`--log LEVEL`	`info`	Фильтр журнала вычислителя
`--check-hardware`	—	Проверить совместимость CPU и выйти

Обычный локальный запуск:

parano1d-miner \
  --rpc http://127.0.0.1:9401 \
  --key 'LONG-RANDOM-TOKEN' \
  --threads 12

Границы удалённого транспорта и пользовательской выплаты описаны в разделе Внешний майнер.

Клиент ноды

parano1d-cli — тонкий клиент работающего Core. У него нет отдельного ключа; операции кошелька выполняются через локальный JSON-RPC.

Общие параметры

-r, --rpc URL   адрес RPC
-j, --json      необработанный вывод JSON

Стандартный адрес — http://127.0.0.1:9401. Его можно изменить переменной окружения NOID_RPC; параметр --rpc имеет приоритет.

Суммы в командах кошелька указываются в NOID, не более шести десятичных знаков:

1 NOID = 1,000,000 μNOID

Нода и цепь

Команда	Аргументы	Результат
`status`	—	Вершина, хеш, сложность и сводка Live State
`block-hash`	`HEIGHT`	Постоянный ID блока с nonce
`block-header`	`HEIGHT`	Структурированный постоянный заголовок
`header`	`HEIGHT`	Необработанный канонический 212-байтный заголовок в hex
`block`	`HEIGHT`	Необработанный полный блок в hex, пока сохранён
`history-step-terminal`	—	Текущее локальное терминальное доказательство в hex
`tx`	`TXID`	Постоянное место подтверждения
`slot`	`INDEX`	Текущее содержимое слота
`utxos-of`	`o1…`	Текущие UTXO указанного адреса
`state`	—	Вместимость, заполнение и размер Live State
`epoch`	—	Текущий якорь пользовательской эпохи в 144 блока

Примеры:

parano1d-cli status
parano1d-cli block-header 420
parano1d-cli block 420
parano1d-cli slot 9700063
parano1d-cli utxos-of o1...

block возвращает данные только внутри 18-блочного окна хранения тел. header и block-header доступны для каждой канонической высоты постоянно.

Сеть и майнинг

Команда	Параметры	Результат
`peers`	—	Число подключённых пиров
`mining`	—	Сложность, следующая награда и состояние майнинга
`block-template`	`--miner-addr o1…`	Внешний шаблон майнинга, принадлежащий ноде
`submit-block`	`TEMPLATE_ID NONCE_HEX`	Отправить один 16-байтный nonce в порядке от младшего байта к старшему

Команды внешнего майнинга низкоуровневые. parano1d-miner автоматически обновляет шаблоны и кодирует nonce.

Комиссии и мемпул

parano1d-cli estimate-fee 2 --inputs 1
parano1d-cli mempool
parano1d-cli mempool-tx TXID

estimate-fee сообщает текущий минимум, принимаемый нодой для заявленного числа активных входов и выходов. Строки мемпула — логические транзакции PagedSpend, а не отдельные физические страницы.

Проверка адреса

parano1d-cli validate o1...

Команда сообщает, корректен ли адрес, и выводит его каноническую форму bech32m и необработанную 32-байтную полезную нагрузку.

Адреса кошелька

parano1d-cli address
parano1d-cli address --list
parano1d-cli address --new
parano1d-cli address --index 3
parano1d-cli address --use 3

--new, --index и --use — взаимоисключающие действия. Созданный адрес остаётся неактивным до явного выбора. Отправка использует только UTXO активного владельца и возвращает сдачу ему же.

Баланс и UTXO

parano1d-cli balance
parano1d-cli utxos
parano1d-cli scan

balance отдельно показывает подтверждённые, зарезервированные исходящие, ожидающие входящие и расходуемые суммы. scan заново загружает активного владельца из проверенного постоянного индекса.

Отправка

Предпросмотр:

parano1d-cli send o1... 10.5 --dry-run

Отправка с автоматической комиссией:

parano1d-cli send o1... 10.5

Точную комиссию в NOID задавайте только при необходимости:

parano1d-cli send o1... 10.5 --fee 0.012

Возвращаемый ID относится ко всей логической транзакции. Рекомендуется автоматическая комиссия, поскольку заполнение State и локальная граница ретрансляции могут измениться.

История и чеки

parano1d-cli history
parano1d-cli history --last 20
parano1d-cli history --address o1...

Экспорт подтверждённого исходящего чека:

parano1d-cli receipt TXID > receipt.hex

Проверка:

parano1d-cli verify "$(tr -d '\n' < receipt.hex)"

Экспорт возможен только для локально сохранённого платежа другому владельцу.

Остановка

parano1d-cli stop

Команда запрашивает корректное завершение демона. Она эквивалентна обычному выходу из GUI, а не уничтожению процесса.

Скрипты

Используйте --json и проверяйте код завершения:

height="$(
  parano1d-cli --json status |
    jq -er '.height'
)"

Человекочитаемый вывод и цвета относятся к представлению. Скрипты должны обрабатывать JSON.