Аргументы и команды¶
Все параметры командной строки (за исключением -datadir
и -conf
) можно задать в файле конфигурации, и все параметры файла конфигурации можно также задать с помощью командной строки. Параметры, заданные через командную строку, превалируют над значениями, заданными в файле конфигурации. Файл конфигурации состоит из списка пар вида setting=value
, по одной в строке, возможно также наличие комментариев, которые начинаются с символа #
.
Файл конфигурации не создаётся автоматически; его можно создать с помощью вашего любимого текстового редактора. По умолчанию, dash-qt (или dashd) будет искать файл с названием dash.conf
в папке с данными dash, но путь к папке с данными, равно как и путь к файлу конфигурации, можно изменить с помощью аргументов командной строки -datadir и -conf.
Платформа | Путь к папке с данными | Стандартный путь к файлу конфигурации |
---|---|---|
Linux | ~/ | /home/username/.dashcore/dash.conf |
macOS | ~/Library/Application Support/ | /Users/username/Library/Application Support/DashCore/dash.conf |
Windows | %APPDATA% | (Vista-10) C:\Users\username\AppData\Roaming\DashCore\dash.conf (2000-XP) C:\Documents and Settings\username\Application Data\DashCore\dash.conf |
Обратите внимание: если Dash запущен в режиме тестнета, подпапка testnet3
будет автоматически добавлена в директорию с данными.
Аргументы командной строки¶
These commands are accurate as of Dash Core version 0.13.0.0.
dashd¶
Демон Dash Core
Применение¶
- dashd [options]
- Запустите демон Dash Core
Опции¶
--help | Print this help message and exit |
--version | Распечатать версию и выйти |
--alerts | Получить и вывести на экран сообщения P2P сети (по умолчанию: 1) |
--alertnotify=<cmd> | |
Выполнить команду, когда всплывает соответствующее уведомление, или мы видим действительно большой форк (%sв cmd заменяется сообщением) | |
--blocknotify=<cmd> | |
Выполнить команду, когда изменяется лучший блок (%s в cmd заменяется хэшем блока) | |
--assumevalid=<hex> | |
Если этот блок находится в цепочке, считать его и предшествующие блоки валидными и, возможно, пропустить верификацию с помощью скрипта (0 - верифицировать всё, по умолчанию: 00000000000000b4181bbbdddbae464ce11fede5d0292fb63fdede1e7c8ab21c, тестнет: 00000ce22113f3eb8636e225d6a1691e132fdd587aed993e1bc9b07a0235eea4) | |
--conf=<file> | Задать файл конфигурации (по умолчанию: dash.conf) |
--daemon | Запустить в фоновом режиме в качестве демона и принять команды |
--datadir=<dir> | |
Определить папку с данными | |
--dbcache=<n> | Установить размер кэша базы данных в мегабайтах (от 4 до 16384, по умолчанию - 100) |
--loadblock=<file> | |
При запуске импортировать блоки из внешнего файла blk000??.dat | |
--maxorphantx=<n> | |
Хранить в памяти максимум <n> неподключённую транзакцию (по умолчанию: 100) | |
--maxmempool=<n> | |
Следить, чтобы размер пула памяти был не больше <n> мегабайт (по умолчанию - 300) | |
--mempoolexpiry=<n> | |
Не хранить транзакции в мемпуле дольше <n> часов (по умолчанию - 72) | |
--blockreconstructionextratxn=<n> | |
Extra transactions to keep in memory for compact block reconstructions (default: 100) | |
--par=<n> | Установить количество ветвей верификаций скрипта (от -1 до 16, 0 = авто, <0 = оставить такое количество ядер свободными, по умолчанию - 0) |
--pid=<file> | Задать pid файл (по умолчанию: dashd.pid) |
--prune=<n> | Reduce storage requirements by enabling pruning (deleting) of old blocks. This allows the pruneblockchain RPC to be called to delete specific blocks, and enables automatic pruning of old blocks if a target size in MiB is provided. This mode is incompatible with -txindex and -rescan. Warning: Reverting this setting requires re-downloading the entire blockchain. (default: 0 = disable pruning blocks, 1 = allow manual pruning via RPC, >945 = automatically prune block files to stay under the specified target size in MiB) |
--reindex-chainstate | |
Восстановить состояние цепи из неиндексированных на данный момент блоков | |
--reindex | Восстановить состояние цепи и индекс блоков из файлов blk*.dat на диске |
--sysperms | Создать новые файлы с системными доступами по умолчанию, вместо umask 077 (работает только при условии, что функционал кошелька отключён) |
--txindex | Сохранять полный индекс транзакции, использованный при вызове getrawtransaction rpc (по умолчанию: 1) |
--addressindex | Сохранять полный индекс транзакции, использованный при запросе баланса, txids и неизрасходованных выводов для адресов (по умолчанию: 0) |
--timestampindex | |
Сохранять отметку времени для хэшей блока, использованных для запроса хэшей блока целым рядом временных отметок (по умолчанию: 0) | |
--spentindex | Сохранять полностью потраченный индекс, использованный для запроса потраченных txid и входящего индекса для точки вывода (по умолчанию: 0) |
Настройки соединения¶
--addnode=<ip> | Добавить ноду для подключения и держать канал связи открытым |
--allowprivatenet | |
Allow RFC1918 addresses to be relayed and connected to (default: 0) | |
--banscore=<n> | Порог для отключения плохо ведущих себя пиров (по умолчанию: 100) |
--bantime=<n> | Количество секунд, в течение которого плохо ведущие себя пиры не могут переподключиться (по умолчанию: 86400) |
--bind=<addr> | Привязать к определённому адресу и всегда обращать наа него внимание. Использовать запись [host]:port для IPv6 |
--connect=<ip> | Connect only to the specified node(s); -noconnect or -connect=0 alone to disable automatic connections |
--discover | Раскрыть собственный IP адрес (по умолчанию: 1 для внимания и -externalip or -proxy, когда нет) |
--dns | Позволить поиск по DNS для -addnode, -seednode и -connect (по умолчанию: 1) |
--dnsseed | Query for peer addresses via DNS lookup, if low on addresses (default: 1 unless -connect/-noconnect) |
--externalip=<ip> | |
Задать собственный публичный адрес | |
--forcednsseed | Всегда запрашивать адреса пиров через поиск по DNS (по умолчанию: 0) |
--listen | Принимать подключения извне (по умолчанию: 1, если отсутствует -proxy или -connect) |
--listenonion | Автоматически создавать скрытую службу Tor (по умолчанию: 1) |
--maxconnections=<n> | |
Поддерживать не более <n>подключений к пирам (за исключением подключений временных служб) (по умолчанию: 125) | |
--maxreceivebuffer=<n> | |
Максимальный размер входящего буфера на подключение, <n>*1000 байт (по умолчанию: 5000) | |
--maxsendbuffer=<n> | |
Максимальный размер исходящего буфера на подключение, <n>*1000 байт (по умолчанию: 1000) | |
--maxtimeadjustment | |
Maximum allowed median peer time offset adjustment. Local perspective of time may be influenced by peers forward or backward by this amount. (default: 4200 seconds) | |
--onion=<ip:port> | |
Использовать отдельный прокси SOCKS5 для подключения к пирам через скрытые службы Tor (по умолчанию: -proxy) | |
--onlynet=<net> | |
Подключаться только к нодам в сети <net> (ipv4, ipv6 или onion) | |
--permitbaremultisig | |
Передать не-P2SH мультиподпись (по умолчанию: 1) | |
--peerbloomfilters | |
Поддерживать фильтрацию блоков и транзакций с помощью имеющихся фильтров (по умолчанию: 1) | |
--port=<port> | Прислушиваться к подключениями по <port> (по умолчанию: 9999 или testnet: 19999) |
--proxy=<ip:port> | |
Подключаться через SOCKS5 прокси | |
--proxyrandomize | |
Рандомизировать мандаты для каждого прокси-подключения. Эта опция включает изоляцию стрима от Tor (по умолчанию: 1) | |
--seednode=<ip> | |
Подключиться к ноде, чтобы восстановить адреса пиров, а затем отключиться | |
--timeout=<n> | Задать время ожидания подключения в миллисекундах (минимум: 1, по умолчанию: 5000) |
--torcontrol=<ip:port> | |
Контрольный порт Tor для использования в том случае, если включён onion-мониторинг (по умолчанию: 127.0.0.1:9051) | |
--torpassword=<pass> | |
Пароль от контрольного порта Tor (по умолчанию: пусто) | |
--upnp | Использовать UPnP, чтобы отметить порт для мониторинга (по умолчанию: 0) |
--whitebind=<addr> | |
Привязать к заданному адресу и подключённому к этому адресу белому списку пиров. Использовать запись [host]:port для IPv6 | |
--whitelist=<IP address or network> | |
Whitelist peers connecting from the given IP address (e.g. 1.2.3.4) or CIDR notated network (e.g. 1.2.3.0/24). Can be specified multiple times. | |
--whitelistrelay | |
Принимать транслируемые транзакции, полученные от пиров из белого списка, даже когда транзакции не передаются (по умолчанию: 1) | |
--whitelistforcerelay | |
Force relay of transactions from whitelisted peers even if they violate local relay policy (default: 1) | |
--maxuploadtarget=<n> | |
Стараться держать количество исходящего трафика в заданных рамках (в кол-ве Мб за 24 часа), 0 = безлимитный, (по умолчанию: 0) |
Настройки кошелька¶
--disablewallet | |
Не загружать кошелёк и отключить RPC вызовы кошелька | |
--keypool=<n> | Установить размер пула для ключей <n>(по умолчанию: 1000) |
--fallbackfee=<amt> | |
A fee rate (in DASH/kB) that will be used when fee estimation has insufficient data (default: 0.00001) | |
--mintxfee=<amt> | |
Fees (in DASH/kB) smaller than this are considered zero fee for transaction creation (default: 0.00001) | |
--paytxfee=<amt> | |
Комиссия (в DASH/kB), которая добавляется к транзакциями, которые вы отправляете (по умолчанию: 0.00) | |
--rescan | При запуске повторно сканировать блокчейн на предмет потерянных транзакций кошелька |
--salvagewallet | |
Attempt to recover private keys from a corrupt wallet on startup | |
--spendzeroconfchange | |
Тратить неподтверждённую сдачу при отправке транзакций (по умолчанию: 1) | |
--txconfirmtarget=<n> | |
If paytxfee is not set, include enough fee so transactions begin confirmation on average within n blocks (default: 6) | |
--usehd | Use hierarchical deterministic key generation (HD) after BIP39/BIP44. Only has effect during wallet creation/first start (default: 0) |
--mnemonic | User defined mnemonic for HD wallet (BIP39). Only has effect during wallet creation/first start (default: randomly generated) |
--mnemonicpassphrase | |
User defined mnemonic passphrase for HD wallet (BIP39). Only has effect during wallet creation/first start (default: empty string) | |
--hdseed | Заданная пользователем мнемоническая последовательность для HD кошелька (должна быть в hex). Работает только при создании или первом запуске кошелька (по умолчанию: создаётся случайным образом) |
--upgradewallet | |
При запуске обновлять кошелёк до последней версии | |
--wallet=<file> | |
Задать файл кошелька (внутри папки с данными) (по умолчанию: wallet.dat) | |
--walletbroadcast | |
Транслировать транзакции кошелька (по умолчанию: 1) | |
--walletnotify=<cmd> | |
Выполнить команду, когда транзакция в кошельке изменяется (%sв cmd заменяется TxID) | |
--zapwallettxes=<mode> | |
Удалить все транзакции кошелька и восстанавливать те части блокчейна только с помощью -rescan при запуске кошелька (1 = хранить метаданные tx, например, данные о владельце аккаунта и информацию о запросе платежа, 2 = сбросить метаданные tx) | |
--createwalletbackups=<n> | |
Количество автоматических бэкапов кошелька (по умолчанию: 10) | |
--walletbackupsdir=<dir> | |
Задать полный путь к папке для автоматических бэкапов кошелька (должна быть создана заранее) | |
--keepass | Использование интеграции KeePass 2 при помощи плагина KeePassHttp (по умолчанию: 0) |
--keepassport=<port> | |
Соединение с KeePassHttp через порт <port> (по умолчанию: 19455) | |
--keepasskey=<key> | |
Ключ KeePassHttp для AES encrypted communication с помощью KeePass | |
--keepassid=<name> | |
KeePassHttp id для созданной ассоциации | |
--keepassname=<name> | |
Name to construct url for KeePass entry, в которой хранится фраза-пароль кошелька |
Настройки уведомлений ZeroMQ¶
--zmqpubhashblock=<address> | |
Разрешить публикацию хэша блока в <address> | |
--zmqpubhashtx=<address> | |
Разрешить публикацию хэша транзакции в <address> | |
--zmqpubhashtxlock=<address> | |
Разрешить публикацию хэша транзакции (заблокирована InstantSend) в <address> | |
--zmqpubhashgovernancevote=<address> | |
Разрешить публикацию хэша голосований управления в <address> | |
--zmqpubhashgovernanceobject=<address> | |
Разрешить публикацию хэша объектов управления (например, предложений) в <address> | |
--zmqpubhashinstantsenddoublespend=<address> | |
Разрешить публикацию хэшей транзакций для попытки двойного списания InstantSend в <address> | |
--zmqpubrawblock=<address> | |
Разрешить публикацию сырых блоков в <address> | |
--zmqpubrawtx=<address> | |
Разрешить публикацию сырых транзакций в <address> | |
--zmqpubrawtxlock=<address> | |
Разрешить публикацию сырых транзакций (заблокированных InstantSend) в <address> | |
--zmqpubrawinstantsenddoublespend=<address> | |
Разрешить публикацию сырых транзакций для попыток двойного списания InstantSend в <address> |
Настройки отладки / тестирования¶
--uacomment=<cmt> | |
Добавить комментарий к строке агента пользователя | |
--debug=<category> | |
Output debugging information (default: 0, supplying <category> is optional). If <category> is not supplied or if <category> = 1, output all debugging information.<category> can be: addrman, alert, bench, cmpctblock, coindb, db, http, leveldb, libevent, lock, mempool, mempoolrej, net, proxy, prune, rand, reindex, rpc, selectcoins, tor, zmq, dash (or specifically: gobject, instantsend, keepass, masternode, mnpayments, mnsync, privatesend, spork). | |
--help-debug | Показать все настройки отладки (использование: –help -help-debug) |
--logips | Включить IP адрес в вывод отладки (по умолчанию: 0) |
--logtimestamps | |
Поставить временную метку перед выводом отладки (по умолчанию: 1) | |
--minrelaytxfee=<amt> | |
Fees (in DASH/kB) smaller than this are considered zero fee for relaying, mining and transaction creation (default: 0.00001) | |
--maxtxfee=<amt> | |
Maximum total fees (in DASH) to use in a single wallet transaction or raw transaction; setting this too low may abort large transactions (default: 0.10) | |
--printtoconsole | |
Отправить информацию по отслеживанию/отладке на консоль вместо файла debug.log | |
--printtodebuglog | |
Отправить информацию по отслеживанию/отладке в файл debug.log (по умолчанию: 1) | |
--shrinkdebugfile | |
Анализировать файл debug.log при запуске клиента (по умолчанию: 1, когда нет отладки) |
Настройки выбора цепочки¶
--testnet | Использовать тестовую цепочку |
--devnet=<name> | |
Use devnet chain with provided name | |
--litemode=<n> | Отключить все присущие Dash функции (мастерноды, PrivateSend, InstantSend, Governance) (0-1, по умолчанию: 0) |
--sporkaddr=<hex> | |
Override spork address. Only useful for regtest and devnet. Using this on mainnet or testnet will ban you. | |
--minsporkkeys=<n> | |
Overrides minimum spork signers to change spork value. Only useful for regtest and devnet. Using this on mainnet or testnet will ban you. |
Настройки мастерноды¶
--masternode=<n> | |
Разрешить клиенту работать в качестве матерноды (0-1, по умолчанию: 0) | |
--mnconf=<file> | |
Задать файл конфигурации мастерноды (по умолчанию: masternode.conf) | |
--mnconflock=<n> | |
Оградить мастерноды от файла конфигурации мастернод (по умолчанию: 1) | |
--masternodeprivkey=<n> | |
Установить приватный ключ мастерноды | |
--masternodeblsprivkey=<hex> | |
Set the masternode BLS private key |
Настройки PrivateSend¶
--enableprivatesend=<n> | |
Разрешить автоматическое использование PrivateSend для средств в этом кошельке (0-1, по умолчанию: 0) | |
--privatesendmultisession=<n> | |
Разрешить множественные сессии перемешивания PrivateSend для блока, экспериментальная функция (0-1, по умолчанию: 0) | |
--privatesendsessions=<n> | |
Use N separate masternodes in parallel to mix funds (1-10, default: 4) | |
--privatesendrounds=<n> | |
Use N separate masternodes for each denominated input to mix funds (2-16, default: 4) | |
--privatesendamount=<n> | |
Keep N DASH anonymized (2-21000000, default: 1000) | |
--liquidityprovider=<n> | |
Сохранять ликвидность PrivateSend, изредка перемешивая монеты на постоянной основе (0-100, по умолчанию: 0, 1= очень часто, высокие комиссии, 100 = редко, низкие комиссии) |
Настройки InstantSend¶
--enableinstantsend=<n> | |
Разрешить InstantSend, показывать подтверждения для заблокированных транзакций (0-1, по умолчанию: 1) | |
--instantsendnotify=<cmd> | |
Выполнить команду, когда транзакция InstantSend из кошелька будет успешно заблокирована (1% в cmd заменяется на TxID) |
Настройки ретрансляции для ноды¶
--bytespersigop | |
Минимальное количество байт на операции с подписями в транзакциях, которые мы ретранслируем и майним (по умолчанию: 20) | |
--datacarrier | Ретранслировать и майнить транзакции с данными (по умолчанию: 1) |
--datacarriersize | |
Максимальный размер данных в транзакциях с данными, которые мы ретранслируем и майним (по умолчанию: 83) |
Настройки создания блока¶
--blockmaxsize=<n> | |
Set maximum block size in bytes (default: 2000000) | |
--blockprioritysize=<n> | |
Задать максимальный размер транзакции с высоким приоритетом / низкой комиссией, в байтах (по умолчанию: 10000) | |
--blockmintxfee=<amt> | |
Set lowest fee rate (in DASH/kB) for transactions to be included in block creation. (default: 0.00001) |
Настройки RPC сервера¶
--server | Принимать команды командной строки и JSON-RPC |
--rest | Принимать публичные запросы REST (по умолчанию: 0) |
--rpcbind=<addr> | |
Прослушивать заданный адрес на предмет JSON-RPC подключений. Использовать запись вида [host]:port для IPv6. Эту опцию можно настраивать множество раз (по умолчанию: прослушивать все интерфейсы) | |
--rpccookiefile=<loc> | |
Местонахождение auth cookie (по умолчанию: директория с данными) | |
--rpcuser=<user> | |
Имя пользователя для JSON-RPC подключений | |
--rpcpassword=<pw> | |
Пароль для JSON-RPC подключений | |
--rpcauth=<userpw> | |
Username and hashed password for JSON-RPC connections. The field <userpw> comes in the format: <USERNAME>:<SALT>$<HASH>. A canonical python script is included in share/rpcuser. The client then connects normally using the rpcuser=<USERNAME>/rpcpassword=<PASSWORD> pair of arguments. This option can be specified multiple times | |
--rpcport=<port> | |
Прослушивать JSON-RPC подключения на <port> (по умолчанию: 9998 или тестнет: 19998) | |
--rpcallowip=<ip> | |
Разрешить JSON-RPC подключения от заданного источника. Действительно для <ip> единичных IP (например, вида 1.2.3.4), сети/маски сети (например, 1.2.3.4/255.255.255.0) или сети/CIDR (например, 1.2.3.4/24). Эту опцию можно настраивать множество раз. | |
--rpcthreads=<n> | |
Задать количество потоков, которые обслуживают RPC вызовы (по умолчанию: 4) |
dash-qt¶
Dash Core QT GUI, использовать те же настройки командной строки, что и для dashd, с дополнительными настройками для UI, описанными ниже.
Применение¶
- dash-qt [command-line options]
- Запустить Dash Core QT GUI
Настройки кошелька¶
--windowtitle=<name> | |
Название окна кошелька |
Настройки отладки / тестирования¶
--debug=<category> | |
Output debugging information (default: 0, supplying <category> is optional). If <category> is not supplied or if <category> = 1, output all debugging information.<category> can be: addrman, alert, bench, cmpctblock, coindb, db, http, leveldb, libevent, lock, mempool, mempoolrej, net, proxy, prune, rand, reindex, rpc, selectcoins, tor, zmq, dash (or specifically: gobject, instantsend, keepass, masternode, mnpayments, mnsync, privatesend, spork), qt. |
Настройки UI¶
--choosedatadir | |
Выбрать папку с данными при запуске (по умолчанию: 0) | |
--lang=<lang> | Установить язык, например «de_DE» (по умолчанию: язык системы) |
--min | Запускать свёрнутым в системный лоток |
--rootcertificates=<file> | |
Установить корневые сертификаты SSL для платёжных запросов (по умолчанию -system-) | |
--splash | Показывать заставку при запуске (по умолчанию: 1) |
--resetguisettings | |
Сбросить все настройки, которые изменялись в GUI |
dash-cli¶
RPC клиент Dash Core
Применение¶
- dash-cli [options] <command> [params]
- Отправить команду Dash Core
- dash-cli [options] help
- Список команд
- dash-cli [options] help <command>
- Получить помощь по команде
Опции¶
--help | Справочное сообщение |
--conf=<file> | Задать файл конфигурации (по умолчанию: dash.conf) |
--datadir=<dir> | |
Определить папку с данными |
Настройки выбора цепочки¶
--testnet | Использовать тестовую цепочку |
--devnet=<name> | |
Use devnet chain with provided name | |
--regtest | Войти в регрессивный тестовый режим, использующий специальную цепочку, в которой блоки можно решать мгновенно. Он предназначен для инструментов регрессивного тестирования и разработки приложений. |
--named | Pass named instead of positional arguments (default: false) |
--rpcconnect=<ip> | |
Отправить команду ноде, работающей на <ip>(по умолчанию: 127.0.0.1) | |
--rpcport=<port> | |
Подключиться к JSON-RPC на <port> (по умолчанию: 9998 или тестнет: 19998) | |
--rpcwait | Ожидать, пока запустится RPC сервер |
--rpcuser=<user> | |
Имя пользователя для JSON-RPC подключений | |
--rpcpassword=<pw> | |
Пароль для JSON-RPC подключений | |
--rpcclienttimeout=<n> | |
Время ожидания между HTTP запросами (по умолчанию: 900) | |
--stdin | Read extra arguments from standard input, one per line until EOF/Ctrl-D (recommended for sensitive information such as passphrases) |
dash-tx¶
Утилита dash-tx в Dash Core
Применение¶
- dash-tx [options] <hex-tx> [commands]
- Обновить зашифрованную шестрандцатеричным кодированием транзакцию dash
- dash-tx [options] -create [commands]
- Создать зашифрованную шестрандцатеричным кодированием транзакцию dash
Опции¶
--help | Справочное сообщение |
--create | Создать новую, пустую TX |
--json | Выбрать вывод JSON |
--txid | Выводить только ID зашифрованной шестнадцатеричным кодированием транзакции. |
Настройки выбора цепочки¶
--testnet | Использовать тестовую цепочку |
--devnet=<name> | |
Use devnet chain with provided name | |
--regtest | Войти в регрессивный тестовый режим, использующий специальную цепочку, в которой блоки можно решать мгновенно. Он предназначен для инструментов регрессивного тестирования и разработки приложений. |
Команды¶
- delin=N
- Удалять ввод N из TX
- delout=N
- Удалять вывод N из TX
- in=TXID:VOUT
- Добавлять ввод к TX
- locktime=N
- Установить время блокирования TX на N
- nversion=N
- Установить версию TX на N
- outaddr=VALUE:ADDRESS
- Добавить к TX основанный на адресе вывод
- outpubkey=VALUE:PUBKEY[:FLAGS]
- Add pay-to-pubkey output to TX. Optionally add the «S» flag to wrap the output in a pay-to-script-hash.
- outdata=[VALUE:]DATA
- Добавить к TX основанный на данных вывод
- outscript=VALUE:SCRIPT[:FLAGS]
- Add raw script output to TX. Optionally add the «S» flag to wrap the output in a pay-to-script-hash.
- outmultisig=VALUE:REQUIRED:PUBKEYS:PUBKEY1:PUBKEY2:….[:FLAGS]
- Add Pay To n-of-m Multi-sig output to TX. n = REQUIRED, m = PUBKEYS. Optionally add the «S» flag to wrap the output in a pay-to-script-hash.
- sign=SIGHASH-FLAGS
- Добавить к транзакции ноль или более подписей. Для этой команды требуются регистры JSON: prevtxs = объект JSON, privatekeys=объект JSON. См. документы по подписи сырой транзакции, что узнать больше о форматах и sighash флажках, а также JSON объектах.
Команды регистра¶
- load=NAME:FILENAME
- Загрузить JSON файл ИМЯФАЙЛА в регистр ИМЯ
- set=NAME:JSON-STRING
- Установить регистр ИМЯ на заданную JSON-СТРОКУ
Команды RPC¶
This documentation lists all available RPC commands as of Dash version 0.13.0.0, and limited documentation on what each command does. For full documentation of arguments, results and examples, type help ( «command» ) to view full details at the console. You can enter commands either from Tools > Debug console in the QT wallet, or using dash-cli for headless wallets and dashd.
Addressindex¶
- getaddressbalance
- Выводит баланс адреса (адресов) (работает, если включена опция addressindex).
- getaddressdeltas
- Выводит все изменения адреса (работает, если включена опция addressindex).
- getaddressmempool
- Выводит все дельты мемпула адреса (работает, если включена опция addressindex).
- getaddresstxids
- Выводит txid адреса (адресов) (работает, если включена опция addressindex).
- getaddressutxos
- Выводит все непотраченные выводы адреса (работает, если включена опция addressindex).
Блокчейн¶
- getbestblockhash
- Returns the hash of the best (tip) block in the longest blockchain.
- getblock «blockhash» ( verbosity )
- If verbosity is 0, returns a string that is serialized, hex-encoded data for block „hash“. If verbosity is 1, returns an Object with information about block <hash>. If verbosity is 2, returns an Object with information about block <hash> and information about each transaction.
- getblockchaininfo
- Returns an object containing various state info regarding blockchain processing.
- getblockcount
- Returns the number of blocks in the longest blockchain.
- getblockhash height
- Returns hash of block in best-block-chain at height provided.
- getblockhashes timestamp
- Выводит массив хэшей блоков внутри заданного временного промежутка.
- getblockheader «hash» ( verbose )
- Если подробный режим является ложным, выводит строку, в которой содержатся сериализованные, закодированные шестнадцатеричным шифрованием данные хэша заголовка блока. Если подробный режим является верным, выводит Объект с информацией о заголовке блока <hash>.
- getblockheaders «hash» ( count verbose )
- Выводит массив элементов с информацией о <count> заголовках блока, начиная с <hash>.Если подробный режим является ложным, то каждый элемент является строкой, в которой содержатся сериализованные, закодированные шестнадцатеричным шифрованием данные заголовка блока. Если подробный режим является верным, то каждый элемент - это Объект с информацией о заголовке блока .
- getchaintips ( count branchlen )
- Выводит информацию обо всех известных верхушках на древе блоков, включая главную цепочку и брошенные ветви.
- getdifficulty
- Выводит сложность доказательства-работы в форме минимальной сложности.
- getmempoolancestors txid (verbose)
- If txid is in the mempool, returns all in-mempool ancestors.
- getmempooldescendants txid (verbose)
- If txid is in the mempool, returns all in-mempool descendants.
- getmempoolentry txid
- Returns mempool data for given transaction.
- getmempoolinfo
- Выводит подробности активного состояния пула памяти TX.
- getrawmempool ( verbose )
- Выводит ID всех транзакций в пуле памяти в виде массива JSON, состоящего из строк с ID транзакции.
- getspentinfo
- Выводит txid и индекс, где потрачен вывод.
- gettxout «txid» n ( include_mempool )
- Выводит детали непотраченного вывода транзакции.
- gettxoutproof [«txid»,…] ( blockhash )
- Выводит зашифрованное шестнадцатеричным кодированием доказательства, что «txid» включена в блок.
- gettxoutsetinfo
- Выводит статистику по непотраченному набору выводов транзакции. Обратите внимание, что это может занять некоторое время.
- preciousblock «blockhash»
- Treats a block as if it were received before others with the same work. A later preciousblock call can override the effect of an earlier one. The effects of preciousblock are not retained across restarts.
- pruneblockchain
- Prune blockchain up to specified height or unix timestamp.
- verifychain ( checklevel nblocks )
- Верифицирует базу данных блокчейна.
- verifytxoutproof «proof»
- Verifies that a proof points to a transaction in a block, returning the transaction it commits to and throwing an RPC error if the block is not in our best chain.
Контроль¶
- debug ( 0 | 1 | addrman | alert | bench | coindb | db | lock | rand | rpc | selectcoins | mempool | mempoolrej | net | proxy | prune | http | libevent | tor | zmq | dash | privatesend | instantsend | masternode | spork | keepass | mnpayments | gobject )
- Change debug category on the fly. Specify single category or use „+“ to specify many.
- getinfo
- DEPRECATED. Returns an object containing various state info.
- getmemoryinfo
- Returns an object containing information about memory usage
- help ( «command» ) («subCommand»)
- List all commands, or get help for a specified comm
- stop
- Остановить сервер Dash Core.
Dash¶
- getgovernanceinfo
- Выводит объект, содержащий параметры управления.
- getpoolinfo
- Выводит объект, содержащий информацию о пуле перемешивания.
- getsuperblockbudget index
- Выводит максимально возможную сумму платежей суперблоков.
- gobject «command»…
Настроить объекты управления. Доступные команды:
- check
- Подтвердить данные объекта управления (только для предложений)
- prepare
- Подготовить объект управления, подписав его и создав tx
- submit
- Отправить объект управления в сеть
- deserialize
- Десериализовать объект управления из шестнадцатеричной строки в JSON
- count
- Count governance objects and votes (additional param: „json“ or „all“, default: „json“)
- get
- Получить объект управления из хэша
- getvotes
- Получить все голоса за хэш объекта управления (включая старые голоса)
- getcurrentvotes
- Получить только текущие (подсчитываемые) голоса за хэш объекта управления (старые голоса не учитываются)
- list
- Вывести список объектов управления (можно фильтровать по сигналу и/или типу объекта)
- diff
- Вывести список различий с последнего поиска различий
- vote-alias
- Голосовать за объект управления с помощью псевдонима мастерноды (используя настройки masternode.conf)
- vote-conf
- Голосовать за объект управления мастернодой, которая указана в dash.conf
- vote-many
- Голосовать за объект управления всеми мастернодами (используя настройки masternode.conf)
- masternode «command»…
Список команд для связанных с мастернодами действий. Доступные команды:
- check
- Force check all masternodes and remove invalid ones
- count
- Get information about number of masternodes (DEPRECATED options: „total“, „ps“, „enabled“, „qualify“, „all“)
- current
- Напечатать информацию по текущей мастерноде-победителю, выплата которому будет в следующем блоке (рассчитывается локально)
- genkey
- Generate new masternodeprivkey, optional param: „compressed“ (boolean, optional, default=false) generate compressed privkey
- outputs
- Напечатать совместимые с мастернодой выводы
- start-alias
- Запустить одну удалённую мастерноду через связанный с ней псевдоним, прописанный в masternode.conf
- start-<mode>
- Запустить удалённую мастерноду, указанную в masternode.conf (<mode>: „all“, „missing“, „disabled“)
- status
- Напечатать информацию о статусе мастерноды
- list
- Напечатать список всех известных мастернод (чтобы узнать больше, см. masternodelist)
- list-conf
- Напечатать masternode.conf в JSON формате
- winner
- Распечатать информацию о следующей мастерноде-победителе, за которую будут голосовать
- winners
- Распечатать список всех мастернод-победителей
- masternodebroadcast «command»…
Набор команд, чтобы создавать и передавать транслируемые сообщения мастерноды. Доступные команды:
- create-alias
- Создать одно транслируемое удалённой мастернодой сообщение с помощью назначенного псевдонима, заданного в masternode.conf
- create-all
- Создать транслируемые удалённой мастернодой сообщения для всех мастернод, заданных в masternode.conf
- decode
- Расшифровать транслируемое мастернодой сообщение
- relay
- Передать транслируемое мастернодой сообщение в сеть
- masternode list ( «mode» «filter» )
- Get a list of masternodes in different modes. This call is identical to masternodelist call.
- mnsync [status | next | reset]
- Выводит статус синхронизации, обновляет до следующего шага или полностью её перезапускает
- privatesend «command»
Доступные команды:
- start
- Начать перемешивание
- stop
- Остановить перемешивание
- reset
- Перезапустить перемешивание
- sentinelping version
- Дежурный сигнал.
- spork «command»
Shows information about current state of sporks. Available commands:
- show
- Show all current spork values
- active
- Show which sporks are active
- voteraw <masternode-tx-hash> <masternode-tx-index> <governance-hash> <vote-signal> [yes | no | abstain] <time> <vote-sig>
- Compile and relay a governance vote with provided external signature instead of signing vote internally
Evo¶
- bls «command» …
Set of commands to execute BLS related actions. Available commands:
- generate
- Create a BLS secret/public key pair
- protx «command» …
Set of commands to execute ProTx related actions. Available commands:
- register
- Create and send ProTx to network
- register_fund
- Fund, create and send ProTx to network
- register_prepare
- Create an unsigned ProTx
- register_submit
- Sign and submit a ProTx
- list
- List ProTxs
- info
- Return information about a ProTx
- update_service
- Create and send ProUpServTx to network
- update_registrar
- Create and send ProUpRegTx to network
- revoke
- Create and send ProUpRevTx to network
- diff
- Calculate a diff and a proof between two masternode lists
Генерирование¶
- generate nblocks ( maxtries )
- Mine up to nblocks blocks immediately (before the RPC call returns)
- generatetoaddress nblocks address (maxtries)
- Mine blocks immediately to a specified address (before the RPC call returns)
Майнинг¶
- getblocktemplate ( TemplateRequest )
- Если параметры запроса включают в себя ключ „mode“, он используется чтобы чётко выбирать между стандартным запросом „template“ или „proposal“. Он выводит данные, необходимые для создания работающего блока.
- getmininginfo
- Вывод json-объект, который содержит относящуюся к майнингу информацию.
- getnetworkhashps ( nblocks height )
- Выводит приблизительные хэши в секунду для сети, на основании последних n блоков. Введите [blocks], чтобы обойти # блоков, -1 определяет изменения с последних данных о сложности. Введите [height], чтобы определить среднюю скорость сети во время открытия определённого блока.
- prioritisetransaction <txid> <priority delta> <fee delta>
- Accepts the transaction into mined blocks at a higher (or lower) priority
- submitblock «hexdata» ( «jsonparametersobject» )
- Стремится вывести новые блоки в сеть. Параметр „jsonparametersobject“ в данном случае игнорируется. Полную спецификацию см. на https://en.bitcoin.it/wiki/BIP_0022.
Сетевой траффик¶
- addnode «node» «add | remove | onetry»
- Стремится добавить или удалить ноду из списка addnode. Или пытается единожды подключиться к ноде.
- clearbanned
- Очистить все забаненные IP.
- disconnectnode «address»
- Немедленно отключается от заданной ноды.
- getaddednodeinfo ( «node» )
- Returns information about the given added node, or all added nodes (note that onetry addnodes are not listed here)
- getconnectioncount
- Выводит количество подключений к другим нодам.
- getnettotals
- Выводит информацию о трафике сети, включая количество входящих и исходящих байтов, а также текущее время.
- getnetworkinfo
- Выводит объект, содержащий различные данные о P2P сети.
- getpeerinfo
- Выводит данные о каждой подключённой к сети ноде в виде json массива объектов.
- listbanned
- Список всех забаненных IP / подсетей
- ping
- Делает запрос, чтобы всем остальным нодам был отправлен пинг для изменения времени пинга. Результаты в полях getpeerinfo, pingtime и pingwait выводятся в десятых долях секунды. Команда ping идёт вместе с другими командами, поэтому она измеряет не только время пинга сети, но ещё и обработку задержки.
- setban «subnet» «add | remove» (bantime) (absolute)
- Стремится добавить или удалить IP/подсеть из списка забаненных.
- setnetworkactive true | false
- Выключить / включить всю активность p2p сети.
Сырые транзакции¶
- createrawtransaction [{«txid»:»id»,»vout»:n},…] {«address»:amount,»data»:»hex»,…} ( locktime )
- Создаёт транзакцию, которая тратит заданные вводы и создаёт новые выводы. Выводы могут быть адресами или данными. Вывод зашифрованную шестнадцатеричным кодированием сырую транзакцию. Обратите внимание, что вводы транзакции не подписаны, и что она не хранится в кошельке и не передаётся в сеть.
- decoderawtransaction «hexstring»
- Вывести JSON объект в виде сериализованной, зашифрованной шестнадцатеричным кодированием транзакции
- decodescript «hexstring»
- Расшифровать зашифрованный шестнадцатеричным кодированием скрипт.
- fundrawtransaction «hexstring» ( options )
- Add inputs to a transaction until it has enough in value to meet its out value. This will not modify existing inputs, and will add at most one change output to the outputs.
- getrawtransaction «txid» ( verbose )
- Return the raw transaction data. If verbose is „true“, returns an Object with information about „txid“. If verbose is „false“ or omitted, returns a string that is serialized, hex-encoded data for „txid“.
- sendrawtransaction «hexstring» ( allowhighfees instantsend bypasslimits)
- Направляет сырые транзакции (сериализованные, зашифрованные шестнадцатеричным кодированием) локальной ноде и в сеть. См. также вызовы createrawtransaction и signrawtransaction.
- signrawtransaction «hexstring» ( [{«txid»:»id»,»vout»:n,»scriptPubKey»:»hex»,»redeemScript»:»hex»},…] [«privatekey1»,…] sighashtype )
- Подписать вводы для сырой транзакции (сериализованной, зашифрованной шестнадцатеричным кодированием). Второй возможный аргумент (который может быть нулём) это массив предыдущих выводов транзакции, от которых зависит эта транзакция, но которые могут ещё не находится в цепочке блоков. Третий возможный аргумент (может быть нулём) это массив зашифрованных base58 приватных ключей, который, если задан, будет состоять исключительно из ключей, использованных для подписания транзакции.
Утилита¶
- createmultisig nrequired [«key»,…]
- Создаёт адрес с мульти-подписью, с требованием n подписей от m ключей. Выводит json объект с адресом и redeemScript.
- estimatefee nblocks
- Оценивает для транзакции приблизительную комиссию за килобайт, чтобы начать подтверждение блоков среди nblocks.
- estimatepriority nblocks
- DEPRECATED. Estimates the approximate priority a zero-fee transaction needs to begin confirmation within nblocks blocks.
- estimatesmartfee nblocks
- ПРЕДУПРЕЖДЕНИЕ: этот интерфейс нестабилен и может измениться или исчезнуть! Оценивает примерный размер комиссии за килобайт, которая нужна, чтобы начать подтверждение блоков среди nblocks, если это возможно, и вывести количество блоков, для которых эти расчёты верны.
- estimatesmartpriority nblocks
- DEPRECATED. WARNING: This interface is unstable and may disappear or change! Estimates the approximate priority a zero-fee transaction needs to begin confirmation within nblocks blocks if possible and return the number of blocks for which the estimate is valid.
- signmessagewithprivkey «privkey» «message»
- Sign a message with the private key of an address
- validateaddress «address»
- Вывести информацию о данном адресе dash.
- verifymessage «address» «signature» «message»
- Verify a signed message
Кошелёк¶
- abandontransaction «txid»
- Пометить транзакцию <txid> внутри кошелька как брошенную. Эта команда пометит эту транзакцию и все относящиеся к ней транзакции внутри кошелька как брошенные, что позволит ещё раз использовать их вводы.
- addmultisigaddress nrequired [«key»,…] ( «account» )
- Добавить в кошелёк адрес с мульти-подписью и требованием n подписей. Каждый ключ - это адрес Dash или зашифрованный шестнадцатеричным кодированием публичный ключ. Если задан „account“ (НЕ РЕКОМЕНДУЕТСЯ), привязать адрес к этому аккаунту.
- backupwallet «destination»
- Safely copies current wallet file to destination, which can be a directory or a path with filename.
- dumphdinfo
- Выводит объект, содержащий деликатную приватную информацию об этом HD кошельке.
- dumpprivkey «address»
- Reveals the private key corresponding to „address“. Then the importprivkey can be used with this output
- dumpwallet «filename»
- Выводит все ключи кошелька в удобный для чтения формат.
- getaccount «address»
- УСТАРЕЛО. Выводит аккаунт, связанный с данным адресом.
- getaccountaddress «account»
- УСТАРЕЛО. Выводит текущий адрес Dash для получения платежей на этот аккаунт.
- getaddressesbyaccount «account»
- УСТАРЕЛО. Выводит список адресов данного аккаунта.
- getbalance ( «account» minconf addlocked include_watchonly )
- Если аккаунт не задан, выводит весь доступный на сервере баланс. Если аккаунт задан (УСТАРЕЛО), выводит баланс аккаунта. Обратите внимание, что аккаунт «» это не то же самое, что оставлять этот параметр незаполненным. Баланс сервера может отличать от баланса заданного по умолчанию «» аккаунта.
- getnewaddress ( «account» )
- Returns a new Dash address for receiving payments. If „account“ is specified (DEPRECATED), it is added to the address book so payments received with the address will be credited to „account“.
- getrawchangeaddress
- Выводит новый адрес Dash для получения сдачи. Подходит исключительно для сырых транзакций, НЕ для обычного использования.
- getreceivedbyaccount «account» ( minconf addlocked )
- УСТАРЕЛО. Выводит полную сумму полученную адресом за <account> транзакций с определённым минимальным количеством подтверждений.
- getreceivedbyaddress «address» ( minconf addlocked )
- Returns the total amount received by the given address in transactions with at least minconf confirmations.
- gettransaction «txid» ( include_watchonly )
- Получить детальную информацию о транзакции <txid> внутри кошелька
- getunconfirmedbalance
- Returns the server’s total unconfirmed balance
- getwalletinfo
- Выводит объект, содержащий различную информацию о состоянии кошелька.
- importaddress «address» ( «label» rescan p2sh )
- Добавляет скрипт (с шестнадцатеричным шифрованием) или адрес, за которым можно наблюдать так же, как если бы он был в вашем кошельке, но его нельзя использовать для траты средств.
- importelectrumwallet «filename» index
- Импортирует ключи из экспортированного файла кошелька Electrum (.csv or .json)
- importmulti «requests» «options»
- Import addresses/scripts (with private or public keys, redeem script (P2SH)), rescanning all addresses in one-shot-only (rescan can be disabled via options).
- importprivkey «dashprivkey» ( «label» ) ( rescan )
- Добавляет в ваш кошелёк приватный ключ (в том виде, в котором был выведен dumpprivkey)
- importprunedfunds
- Imports funds without rescan. Corresponding address or script must previously be included in wallet. Aimed towards pruned wallets. The end-user is responsible to import additional transactions that subsequently spend the imported outputs or rescan after the point in the blockchain the transaction is included.
- importpubkey «pubkey» ( «label» rescan )
- Добавляет публичный ключ (в шестнадцатеричном виде), за которым можно наблюдать так же, как если бы он был в вашем кошельке, но его нельзя использовать для траты средств.
- importwallet «filename»
- Импортирует ключи из дамп-файла кошелька (см. dumpwallet).
- instantsendtoaddress «address» amount ( «comment» «comment-to» subtractfeefromamount )
- Отправить сумму на заданный адрес. Сумма является реальной и округляется до ближайшего 0.00000001
- keepass <genkey | init | setpassphrase>
- Настройки keepass.
- keypoolrefill ( newsize )
- Fills the keypool. Requires wallet passphrase to be set with walletpassphrase call.
- listaccounts ( minconf addlocked include_watchonly)
- УСТАРЕЛО. Выводит объект, который содержит имя аккаунта в качестве ключа, а баланс аккаунта в качестве значения.
- listaddressbalances ( minamount )
- Lists addresses of this wallet and their balances
- listaddressgroupings
- Lists groups of addresses which have had their common ownership made public by common use as inputs or as the resulting change in past transactions
- listlockunspent
- Выводит список временно недоступных к использованию выводов. См. вызов lockunspent, чтобы заблокировать или разблокировать транзакции от трат.
- listreceivedbyaccount ( minconf addlocked include_empty include_watchonly)
- DEPRECATED. List incoming payments grouped by account.
- listreceivedbyaddress ( minconf addlocked include_empty include_watchonly)
- List incoming payments grouped by receiving address.
- listsinceblock ( «blockhash» target_confirmations include_watchonly)
- Получить все транзакции в блоках, начиная с блока [blockhash], или все транзакции, если параметр опущен
- listtransactions ( «account» count skip include_watchonly)
- Выводит последние транзакции до „count“, пропуская первые транзакции „from“ для аккаунта „account“.
- listunspent ( minconf maxconf [«addresses»,…] [include_unsafe] )
- Выводит массив неизрасходованных выводов транзакций, с количеством подтверждений между minconf и maxconf (включительно). При необходимости, фильтрует информацию и выводит только txouts, выплаченные определённым адресам.
- lockunspent unlock ([{«txid»:»txid»,»vout»:n},…])
- Обновляет список временно недоступных для использования выводов. Временно блокирует (unlock=false) или снимает блокировку (unlock=true) с заданных выводов транзакции.
- move «fromaccount» «toaccount» amount ( minconf «comment» )
- УСТАРЕЛО. Перенести заданную сумму с одного аккаунта вашего кошелька на другой.
- removeprunedfunds «txid»
- Deletes the specified transaction from the wallet. Meant for use with pruned wallets and as a companion to importprunedfunds. This will effect wallet balances.
- sendfrom «fromaccount» «toaddress» amount ( minconf addlocked «comment» «comment_to» )
- DEPRECATED (use sendtoaddress). Sent an amount from an account to a dash address. Requires wallet passphrase to be set with walletpassphrase call.
- sendmany «fromaccount» {«address»:amount,…} ( minconf addlocked «comment» [«address»,…] subtractfeefromamount use_is use_ps )
- Send multiple times. Amounts are double-precision floating point numbers. Requires wallet passphrase to be set with walletpassphrase call.
- sendtoaddress «address» amount ( «comment» «comment_to» subtractfeefromamount use_is use_ps )
- Отправить сумму на заданный адрес.
- setaccount «address» «account»
- УСТАРЕЛО. Задаёт аккаунт, связанный с данным адресом.
- setprivatesendamount amount
- Set the goal amount in DASH for PrivateSend mixing.
- setprivatesendrounds rounds
- Set the number of rounds for PrivateSend mixing.
- settxfee amount
- Задать комиссию транзакции за kB. Перезаписывает параметр paytxfee.
- signmessage «address» «message»
- Sign a message with the private key of an address Requires wallet passphrase to be set with walletpassphrase call.
- walletlock
- Удаляет из памяти шифровальный ключ кошелька, блокируя кошелёк. После вызова этого метода, вам нужно будет снова вызвать walletpassphrase, прежде чем вызывать какие-либо другие методы, потому что для этого требуется разблокировать кошелёк.
- walletpassphrase «passphrase» timeout ( mixingonly )
- Хранит в памяти шифровальный ключ кошелька в течение „timeout“ секунд. Это необходимо делать, прежде чем выполнять транзакции, связанные с приватными ключами, например отправление dashs.
- walletpassphrasechange «oldpassphrase» «newpassphrase»
- Изменяет кодовую фразу кошелька со „oldpassphrase“ на „newpassphrase“.