命令和参数¶
可以在配置文件中指定(除了``-datadir``和``-conf``之外)的所有命令行选项,也可以在命令行中指定所有配置文件选项。命令行选项会覆盖配置文件中的设定值。配置文件是一个包含``setting=value``的列表,每行都有,除此之外,文件中还包括以 #
字符开头的可选注释。
配置文件不是自动创建的。用户可以通过纯文本编辑器来完成创建。在默认情况下,dash-qt(或dashd)会在达世币数据目录中查找名为``dash.conf``的文件。不过,用户可以使用 -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 |
注意:如果用户在测试网环境下运行达世币核心钱包,子文件夹 testnet3
会被自动添加到数据目录中。
命令行参数¶
达世币核心版本0.12.2.1.开始这些命令是准确的
dashd¶
Dash Core Daemon
使用¶
- dashd [选项]
- 开启Dash Core Daemon
选项¶
--help | 这则帮助信息 |
--version | 打印版本并退出 |
--alerts | 接收并显示P2P网络的警报(默认值:1) |
--alertnotify=<cmd> | |
在接收到相关警报或看到相当长的分叉后执行命令(cmd中的%s被消息所替代) | |
--blocknotify=<cmd> | |
在最佳区块更改时执行命令(cmd中的%s被区块哈希值所替代) | |
--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) | |
--par=<n> | 设置脚本验证线程的数量(范围:-1到16,0 则为自动设置,<0 则为闲置,默认值:0) |
--pid=<file> | 指定pid文件(默认值:dashd.pid) |
--prune=<n> | 通过(删除)减少陈旧的区块来降低存储要求。这一设置与-txindex和-rescan不兼容。警告:恢复这一设置需要重新下载整个区块链。 (默认:0 意为精简区块,> 945 用于设置区块文件的大小) |
--reindex-chainstate | |
以当前索引的区块为基础重建区块链状态 | |
--reindex | 以磁盘上的 blk*.dat文件为基础重建区块链状态和区块索引 |
--sysperms | 使用系统默认权限而不是umask 077创建新文件(仅对已禁用的钱包功能有效) |
--txindex | 维护getrawtransaction rpc所使用的完整的交易索引(默认值:1) |
--addressindex | 维护完整的地址索引,以便查询钱包地址上的余额、交易ID和未使用的输出(默认值:0) |
--timestampindex | |
维护区块哈希值的时间戳索引,以便通过一系列时间戳查询区块哈希值(默认值:0) | |
--spentindex | 维护一个完整的支付索引,以便查询输出点的消费交易ID和输入索引(默认值:0) |
连接选项¶
--addnode=<ip> | 添加想要连接的节点,并尝试保持连接的开放 |
--banscore=<n> | 对连接不畅或操作不当的其他用户设置的阈值(默认值:100) |
--bantime=<n> | 防止操作不当的其他用户重新连接的秒数(默认值:86400) |
--bind=<addr> | 绑定到既定的地址,并始终读取它的消息。使用IPv6协议的[host]:端口 |
--connect=<ip> | 只连接到指定的节点(多个) |
--discover | 发现个人的IP地址(默认值:1表示始终读取,没有-externalip 或 -proxy) |
--dns | 允许DNS查找-addnode、-seednode和-connect(默认值:1) |
--dnsseed | 如果地址不足,则通过DNS查询其他用户的地址(默认值:1 除非 -connect) |
--externalip=<ip> | |
指定个人的公共地址 | |
--forcednsseed | 始终通过DNS查询其他用户的地址(默认值:0) |
--listen | 允许来自外部的连接(默认值:如果不是-proxy 或-connect,则默认值为1) |
--listenonion | 自动创建Tor隐藏服务(默认值:1) |
--maxconnections=<n> | |
最多与<n>位其他用户保持连接(其中不包括临时的服务连接)(默认值:125) | |
--maxreceivebuffer=<n> | |
每次连接的最大数据接收缓存为<n>*1000字节(默认值:5000) | |
--maxsendbuffer=<n> | |
每次连接的最大数据发送缓存为<n>*1000字节(默认值:1000) | |
--onion=<ip:port> | |
使用独立的SOCKS5代理和Tor隐藏服务连接到其它用户(默认值:-proxy) | |
--onlynet=<net> | |
仅连接到网络<net>中的节点(ipv4, ipv6 或 onion) | |
--permitbaremultisig | |
通过非P2SH 多重签名完成中转(默认值:1) | |
--peerbloomfilters | |
支持用户使用bloom过滤器来过滤区块和交易(默认值:1) | |
--port=<port> | 读取<port>上的连接(默认值:9999或测试网:19999) |
--proxy=<ip:port> | |
通过SOCKS5代理建立连接 | |
--proxyrandomize | |
随意排列各个代理连接的凭证。这项操作将激活Tor的流量隔离功能(默认值:1) | |
--seednode=<ip> | |
连接到节点,以便检索其他用户的地址,然后断开连接 | |
--timeout=<n> | 以毫秒为单位指定连接超时(最小值:1,默认值:5000) |
--torcontrol=<ip:port> | |
在启用洋葱读取功能的前提下使用Tor控制端口(默认值:127.0.0.1:9051) | |
--torpassword=<pass> | |
Tor控制端口的密码(默认值:空) | |
--upnp | 使用通用即插即用功能映射读取端口(默认值:0) |
--whitebind=<addr> | |
绑定到既定地址并将连接到该地址的用户列入白名单。使用IPv6的[host]:端口 | |
--whitelist=<netmask> | |
被列入白名单的用户从既定的网络掩码或IP地址上建立连接。用户可以进行多次指定。用户无法对列入白名单的用户使用禁用服务的功能。即使白名单用户的交易已经存在内存池当中,它们也总是会被中继 | |
--whitelistrelay | |
即使没有出现交易中继,也总是接受来自白名单用户的中继交易(默认值:1) | |
--whitelistforcerelay | |
即使被列入白名单的用户违反了本地中继政策,也强制执行交易中继(默认值:1) | |
--maxuploadtarget=<n> | |
使出站流量维持在既定目标以下(单位为MiB/24小时),0 表示无限制(默认值:0) |
钱包选项¶
--disablewallet | |
不要加载钱包,并禁用钱包的远程过程调用功能 | |
--keypool=<n> | 将密钥池的大小设置为<n>(默认值:1000) |
--fallbackfee=<amt> | |
当费用计算缺乏必要的数据时所使用的费率,该费率以 (DASH/kB) 为单位(默认值:0.0002) | |
--mintxfee=<amt> | |
比上述费率(DASH/kB)更低的收费被定义为零费率的交易创建(默认值:0.0001) | |
--paytxfee=<amt> | |
添加到发送的交易所需的费用(DASH/kB)(默认值:0.00) | |
--rescan | 在启动时重新扫描区块链,以便查找丢失的交易 |
--salvagewallet | |
在启动时尝试从损坏的wallet.dat中恢复私钥 | |
--sendfreetransactions | |
如有可能,使用零费率交易进行交易(默认值:0) | |
--spendzeroconfchange | |
在发送交易时使用未经确认的零钱(默认值:1) | |
--txconfirmtarget=<n> | |
如果没有设置支付交易手续费,用户须在交易中包含足够的费用,方便交易在n个区块上开始确认(默认值:2) | |
--maxtxfee=<amt> | |
单笔钱包交易所需的费用的最高值,这一数值以达世币(DASH)为单位。如果用户对这个数值的设置过低,那么用户的大额交易就可能会被中止(默认值:0.20) | |
--usehd | 在bip39/bip44之后使用分层确定性私钥生成(HD)功能。这项功能只在钱包创建或首次启动时有效(默认值:0) |
--mnemonic | 用户定义的HD钱包(bip39)。这项功能只在钱包创建/首次启动时有效(默认值:随机生成) |
--mnemonicpassphrase | |
用户定义的HD钱包的密码(bip39)。这项功能只在钱包创建/首次启动时有效(默认值:空字符串) | |
--hdseed | 用户定义的HD钱包的种子(应为十六进制)。这项功能只在钱包创建/首次启动时有效(默认值:随机生成) |
--upgradewallet | |
在启动时将钱包升级到最新格式 | |
--wallet=<file> | |
(在数据目录中)指定钱包文件(默认值:wallet.dat) | |
--walletbroadcast | |
确保钱包广播交易(默认值:1) | |
--walletnotify=<cmd> | |
钱包交易发生变化时执行命令(cmd中的%s被交易ID所替代) | |
--zapwallettxes=<mode> | |
删除所有钱包交易,并且仅在启动时通过-rescan恢复区块链的部分(1表示保留交易元数据,例如账户所有人和请求支付的信息,2 表示删除交易元数据) | |
--createwalletbackups=<n> | |
自动钱包备份的数量(默认值:10) | |
--walletbackupsdir=<dir> | |
指定自动钱包备份的目录的完整路径(前提是自动钱包备份必须存在) | |
--keepass | 借助KeePassHttp插件来使用KeePass 2集成功能(默认值:0) |
--keepassport=<port> | |
通过端口<port>上连接到KeePassHttp(默认值:19455) | |
--keepasskey=<key> | |
借助KeePassHttp密钥使用KeePass 加密通信功能 | |
--keepassid=<name> | |
已建立关联的KeePassHttp身份 | |
--keepassname=<name> | |
用于为KeePass条目构建网址的名称。该条目存储了钱包的密码 |
ZeroMQ通知选项¶
--zmqpubhashblock=<address> | |
在<address>中启用发布哈希区块的功能 | |
--zmqpubhashtx=<address> | |
在<address>中启用发布哈希交易的功能 | |
--zmqpubhashtxlock=<address> | |
在<address>中启用发布哈希交易的功能(通过即时发送功能锁定资金) | |
--zmqpubhashgovernancevote=<address> | |
Enable publish hash of governance votes in <address> | |
--zmqpubhashgovernanceobject=<address> | |
Enable publish hash of governance objects (like proposals) in <address> | |
--zmqpubhashinstantsenddoublespend=<address> | |
Enable publish transaction hashes of attempted InstantSend double spend in <address> | |
--zmqpubrawblock=<address> | |
在<address>中启用发布原始区块的功能 | |
--zmqpubrawtx=<address> | |
在<address>中启用发布原始交易的功能 | |
--zmqpubrawtxlock=<address> | |
在<address>中启用发布原始交易的功能(通过即时发送功能锁定资金) | |
--zmqpubrawinstantsenddoublespend=<address> | |
Enable publish raw transactions of attempted InstantSend double spend in <address> |
调试/测试选项¶
--uacomment=<cmt> | |
将注释添加到用户代理字符串 | |
--debug=<category> | |
输出调试信息(默认值:0,用户也可以选择<category>)。如果<category>不可选或<category> = 1,则输出所有调试信息。<category>可以是以下选项:addrman、alert、bench、coindb、db、http、libevent、lock、mempool、mempoolrej、net、proxy、prune、rand、reindex、 rpc、selectcoins、tor、zmq或者dash(具体来说,它可以是gobject、instantsend、keepass、masternode、mnpayments、mnsync、privatesend和spork)。 | |
--gen | 生成币(默认值:0) |
--genproclimit=<n> | |
如果启用这一功能,用户就会设置达世币生成的线程数(-1 表示所有核心,默认值:1) | |
--help-debug | 显示所有的调试选项(用法:–help -help-debug) |
--logips | 在调试输出中包含IP地址(默认值:0) |
--logtimestamps | |
使用时间戳预先调试输出(默认值:1) | |
--minrelaytxfee=<amt> | |
比上述费率(DASH/kB)更低的收费被定义为零费率的中继、挖矿和交易创建(默认值:0.0001) | |
--printtoconsole | |
将追踪和调试信息发送到控制台而不是debug.log文件 | |
--printtodebuglog | |
将追踪和调试信息发送到debug.log文件(默认值:1) | |
--shrinkdebugfile | |
在启动客户端时缩小debug.log文件(默认值:在没有-debug的前提下,默认值是1) |
区块链选择的选项¶
--testnet | 使用测试区块链 |
--litemode=<n> | 禁用所有达世币的特定功能(主节点、匿名发送、即时发送和管理机制等)(范围:0-1,默认值:0) |
主节点选项¶
--masternode=<n> | |
以客户端充当主节点(范围:0-1,默认值:0) | |
--mnconf=<file> | |
指定主节点配置文件(默认值:masternode.conf) | |
--mnconflock=<n> | |
通过主节点配置文件锁定主节点(默认值:1) | |
--masternodeprivkey=<n> | |
设置主节点私钥 |
匿名发送选项¶
--enableprivatesend=<n> | |
批准对本钱包中的资金自动使用匿名发送功能(0-1,默认值:0) | |
--privatesendmultisession=<n> | |
对每个区块使用多重匿名发送混币流程,这是一个实验性的操作(0-1,默认值:0) | |
--privatesendrounds=<n> | |
借助N个主节点为既定的交易完成混币(N的范围:2-16,默认值:2) | |
--privatesendamount=<n> | |
保持N个DASH匿名(默认值:1000) | |
--liquidityprovider=<n> | |
通过不频繁的混币操作为匿名发送功能提供流动性(范围:0-100,默认值:0,1表示非常频繁和高额费用,100 表示频率和费用极低) |
即时发送选项¶
--enableinstantsend=<n> | |
启用即时发送功能,显示有关交易锁定的确认信息(范围:0-1,默认值:1) | |
--instantsenddepth=<n> | |
显示成功锁定交易的N个确认信息(范围:0-9999,默认值:5) | |
--instantsendnotify=<cmd> | |
当成功锁定即时发送功能时执行命令(cmd中的%s被替换为交易ID) |
节点中继选项¶
--bytespersigop | |
在中继和挖矿活动中,每个sigop的最小字节数(默认值:20) | |
--datacarrier | 在中继和挖矿活动中的数据载体交易(默认值:1) |
--datacarriersize | |
在中继和挖矿活动中,数据载体交易的数据最大值(默认值:83) | |
--mempoolreplacement | |
在内存池中启用交易替换功能(默认值:0) |
区块创建选项¶
--blockminsize=<n> | |
以字节为单位设置区块大小的最小值(默认值:0) | |
--blockmaxsize=<n> | |
以字节为单位设置区块大小的最大值(默认值:750000) | |
--blockprioritysize=<n> | |
以字节为单位设置高优先级和最低交易成本的交易(默认值:10000) |
远程过程调用服务器选项¶
--server | 接受命令行和JSON-RPC命令 |
--rest | 接受公共REST请求(默认值:0) |
--rpcbind=<addr> | |
绑定到既定地址以等待JSON-RPC连接。使用IPv6的 [host]:端口。用户可以多次设定这个选项(默认值:绑定到所有接口) | |
--rpccookiefile=<loc> | |
身份验证cookie的位置(默认值:数据目录) | |
--rpcuser=<user> | |
JSON-RPC连接的用户名 | |
--rpcpassword=<pw> | |
JSON-RPC连接的密码 | |
--rpcauth=<userpw> | |
JSON-RPC连接的用户名和哈希密码。字段<userpw>的格式为<USERNAME>:<SALT>$<HASH>。share/rpcuser中包含规范的python脚本。用户可以多次设定这个选项。 | |
--rpcport=<port> | |
在<port>上等待JSON-RPC连接(默认值: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> | |
设置远程过程调用的线程数(默认值:4) |
dash-qt¶
Dash Core QT GUI,使用与dashd相同的命令行选项,并添加以下的用户界面设置。
使用¶
- dash-qt [命令行选项]
- 启动Dash Core QT GUI
钱包选项¶
--windowtitle=<name> | |
钱包窗口标题 |
调试/测试选项¶
--debug=<category> | |
输出调试信息(默认值:0,用户也可以选择<category>)。如果<category>不可选或<category> = 1,则输出所有调试信息。<category>可以是以下选项:addrman、alert、bench、coindb、db、http、libevent、lock、mempool、mempoolrej、net、proxy、prune、rand、reindex、 rpc、selectcoins、tor、zmq、qt或者dash(具体来说,它可以是gobject、instantsend、keepass、masternode、mnpayments、mnsync、privatesend和spork) |
用户界面选项¶
--choosedatadir | |
在启动时选择数据目录(默认值:0) | |
--lang=<lang> | 设置语言,例如”de_DE”(默认值:系统定位) |
--min | 开始最小化 |
--rootcertificates=<file> | |
为支付申请设置SSL root 认证(默认值:-system-) | |
--splash | 启动时显示启动画面(默认值:1) |
--resetguisettings | |
重置GUI变更的所有设置 |
dash-cli¶
Dash Core RPC客户端
使用¶
- dash-cli [options] <command> [params]
- 向达世币核心发送命令
- dash-cli [options] help
- 命令列表
- dash-cli [options] help <command>
- 获得帮助命令
选项¶
--help | 这则帮助信息 |
--conf=<file> | 指定配置文件(默认:dash.conf) |
--datadir=<dir> | |
指定数据目录 |
区块链选择的选项¶
--testnet | 使用测试区块链 |
--regtest | 进入回归测试模式,该模式使用一个特殊的链,可以立即处理区块。这项操作适用于回归测试工具和应用程序开发。 |
--rpcconnect=<ip> | |
向在<ip>运行的节点发送命令(默认: 127.0.0.1) | |
--rpcport=<port> | |
在<port>连接JSON-RPC(默认:9998或测试网:19998) | |
--rpcwait | 等待RPC服务启动 |
--rpcuser=<user> | |
JSON-RPC连接的用户名 | |
--rpcpassword=<pw> | |
JSON-RPC连接的密码 | |
--rpcclienttimeout=<n> | |
HTTP请求超时(默认:900) |
dash-tx¶
Dash Core dash-tx 功能
使用¶
- dash-tx [options] <hex-tx> [commands]
- 升级十六进制达世币交易
- dash-tx [options] -create [commands]
- 创建十六进制达世币交易
选项¶
--help | 这则帮助信息 |
--create | 创建新的,空白交易。 |
--json | 选择JSON输出 |
--txid | 仅输出交易结果的十六进制编码的交易ID |
区块链选择的选项¶
--testnet | 使用测试区块链 |
--regtest | 进入回归测试模式,该模式使用一个特殊的链,可以立即处理区块。这项操作适用于回归测试工具和应用程序开发。 |
命令¶
- delin=N
- 从交易中删除输入N
- delout=N
- 从交易中删除输出N
- in=TXID:VOUT
- 向交易增加输入
- locktime=N
- 设置交易锁定时间为N
- nversion=N
- 设置交易版本为N
- outaddr=VALUE:ADDRESS
- 向交易增加基于地址的输出
- outdata=[VALUE:]DATA
- 向交易增加基于数据的输出
- outscript=VALUE:SCRIPT
- 向交易增加原始脚本
- sign=SIGHASH-FLAGS
- 为交易添加零个或多个签名。这一命令要求JSON registers:prevtxs=JSON object且privatekeys=JSON object。有关sighash标志和JSON对象的格式的更多信息请参考signrawtransaction文件。
注册命令¶
- load=NAME:FILENAME
- Load JSON file FILENAME into register NAME
- set=NAME:JSON-STRING
- Set register NAME to given JSON-STRING
RPC 命令¶
本文档列出了达世币0.12.2.1版本中所有的可用的远程过程调用命令及各项命令的功能。如需阅读有关参数、结果和示例的完整文档,用户需要输入help( “command” ),从而在控制台中查看完整的介绍信息。用户也可以从钱包中的 工具 > 调试 控制台中输入命令,或使用 *“dash-cli * ”和 * dashd*来完成这项操作。
地址索引¶
- getaddressbalance
- 返回(多)地址的余额(需启用addressindex功能)。
- getaddressdeltas
- 返回地址的所有零钱(需启用addressindex功能)。
- getaddressmempool
- 返回地址的所有内存池(需启用addressindex功能)。
- getaddresstxids
- 返回(多)地址的所有交易ID(需启用addressindex功能)。
- getaddressutxos
- 返回地址的所有未发送的输出(需启用addressindex功能)。
区块链¶
- getbestblockhash
- 返回最长区块链中的最佳(tip)区块的哈希值。
- getblock “hash” ( verbose )
- 如果verbose错误,则为区块哈希返回序列化’的十六进制字符串数据。如果verbose正确,则返回包含区块<hash>的相关信息的对象。
- getblockchaininfo
- 返回包含有关区块链处理的各类状态信息的对象。
- getblockcount
- 返回最长区块链中的区块的数量。
- getblockhash index
- 返回提供索引时最佳区块链的区块哈希值。
- getblockhashes timestamp
- 返回在既定的时间戳范围内的区块哈希数组。
- getblockheader “hash” ( verbose )
- 如果verbose错误,则为blockheader哈希返回序列化’的十六进制字符串数据。如果verbose正确,则返回包含blockheader<hash>的相关信息的对象。
- getblockheaders “hash” ( count verbose )
- 返回一个项目数组,数组中包含从<hash>开始的blockheader<count>的信息。如果verbose错误,则每个项目都应是单个区块头的序列化’的十六进制字符串。如果verbose正确,则每个项目都应是包含单个blockheader相关信息的对象。
- getchaintips ( count branchlen )
- 返回有关区块树中所有已知末梢的信息,包括主链和独立分支。
- getdifficulty
- 将工作量证明难度作为最小难度的倍数返回。
- getmempoolinfo
- 返回有关交易内存值的活跃状态的细节信息。
- getrawmempool ( verbose )
- 将交易ID的JSON数组作为内存池中的所有交易ID予以返回。
- getspentinfo
- 返回输出所用的交易ID和索引。
- gettxout “txid” n ( includemempool )
- 返回有关未使用的交易输出的详细信息。
- gettxoutproof [“txid”,…] ( blockhash )
- 返回一个十六进制编码的证明,其中”交易ID”包含在一个区块当中。
- gettxoutsetinfo
- 返回有关未使用的交易输出的统计信息。需要注意的是这个步骤需要花费一些时间。
- verifychain ( checklevel numblocks )
- 验证区块链数据库。
- verifytxoutproof “proof”
- 验证证明是否指向区块中的交易。如果该区块不是最佳区块,则返回它所指向的交易并提示远程过程调用错误。
Control¶
- 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 )
- 更改动态调试类别。指定单个类别或使用逗号指定多个类别。
- getinfo
- 超时。返回包含各种状态信息的对象。
- help ( “command” )
- 列出所有命令,或借助于指定的命令。
- stop
- 停止达世币核心服务器。
达世币¶
- getgovernanceinfo
- 返回包含管理参数的对象。
- getpoolinfo
- 返回包含混币池的相关信息的对象。
- getsuperblockbudget index
- 返回允许的超级块支付的最大绝对值。
- gobject “command”…
管理管理对象。可用命令:
- check
- 验证管理对象数据(仅限提案)
- prepare
- 通过签名和创建交易来准备管理对象
- submit
- 将管理对象提交到网络
- deserialize
- 将管理对象从十六进制字符串反序列化为JSON
- count
- 统计管理对象的数量并投票
- get
- 通过哈希值获取管理对象
- getvotes
- 获取为管理对象哈希值所进行的投票(包括之前的投票)
- getcurrentvotes
- 获取管理对象哈希值的(当前)投票(不包括之前的投票)。
- list
- 列出管理对象(可以通过信号和/或对象类型进行过滤)
- diff
- 列出自上次diff后出现的差异
- vote-alias
- 通过主节点别名对管理对象进行投票(通过masternode.conf完成设置)
- vote-conf
- 通过dash.conf中配置的主节点对管理对象进行投票
- vote-many
- 通过所有主节点对管理对象进行投票(通过masternode.conf完成设置)
- masternode “command”…
用于执行与主节点相关的操作的命令集。可用命令:
- count
- 打印所有已知主节点的数量(可选:’ps’, ‘enabled’, ‘all’, ‘qualify’)
- current
- 打印当前主节点获奖者的信息,以便在下一个区块中予以支付(本地计算)
- genkey
- 生成新的主节点私钥
- outputs
- 打印主节点兼容性输出
- start-alias
- 通过masternode.conf中配置的已分配别名启动单个的远程主节点
- start-<mode>
- 启动masternode.conf中配置的远程主节点(<mode>可代表all、missing或disabled)
- status
- 打印主节点状态信息
- list
- 打印所有已知主节点的名单(查阅主节点名单来了解更多信息)
- list-conf
- 以JSON的格式打印masternode.conf
- winner
- 打印下一位主节点获奖者的信息,以便投票
- winners
- 打印主节点获奖者名单
- masternodebroadcast “command”…
用于创建和中继主节点广播消息的命令集。可用命令:
- create-alias
- 通过masternode.conf中配置的已分配别名创建单个的远程主节点广播消息
- create-all
- 为masternode.conf中配置的所有主节点创建远程主节点广播消息
- decode
- 解码主节点广播消息
- relay
- 在网络上中继主节点广播消息
- masternodelist ( “mode” “filter” )
- 获取不同模式下的主节点的列表
- mnsync [status|next|reset]
- 返回同步状态,更新到下一步或完全重置。
- privatesend “command”
可用命令:
- start
- Start mixing
- stop
- Stop mixing
- reset
- Reset mixing
- sentinelping version
- Sentinel ping.
- spork <name> [<value>]
- 表示对应的叉勺名称或所’显示’的当前的叉勺设置。如果显示为<name>,则表示叉勺处于活跃状态。<value>表示启用或禁用叉勺的日期和时间。用户需要使用钱包密码和walletpassphrase call来完成设置。
- voteraw <masternode-tx-hash> <masternode-tx-index> <governance-hash> <vote-signal> [yes|no|abstain] <time> <vote-sig>
- 使用提供的外部签名来编译和转发管理投票,而不是在内部签署投票。
Generating¶
- generate numblocks
- (在远程过程调用返回之前)立即挖取区块。
- getgenerate
- 无论服务器设置是否是生成货币,都返回。默认设置是错误。它使用命令行参数-gen(或dash.conf setting gen)进行设置。用户也可以使用setgenerate调用来完成设置。
- setgenerate generate ( genproclimit )
- 将生成功能设置为打开或关闭。这项功能仅限于genproclimit处理器,-1表示没有设限。请参阅getgenerate调用来获取当前设置。
挖矿¶
- getblocktemplate ( “jsonrequestobject” )
- 如果请求参数包含’模式’键,则请求参数用于在默认’模板’请求或’提议’之间做出选择。它返回构建区块所需的数据。
- getmininginfo
- 返回包含与挖矿相关的信息的JSON对象。
- getnetworkhashps ( blocks height )
- 基于最后的n个块返回每秒钟的网络哈希值。输入[blocks]来覆盖# of blocks,-1用于指定最后一次的难度变化。输入[height]来计算找到某个区块时的网络速度。
- prioritisetransaction <txid> <priority delta> <fee delta>
- 将在已挖区块中的交易设置为更高(或更低)的优先级。
- submitblock “hexdata” ( “jsonparametersobject” )
- 尝试向网络提交新的区块。目前,jsonparametersobject参数已被忽略。如需阅读规范全文,请访问网址 https://en.bitcoin.it/wiki/BIP_0022 。
Network¶
- addnode “node” “add|remove|onetry”
- 尝试在addnode列表中添加或删除节点,或尝试连接一个节点一次。
- clearbanned
- 清除所有被禁用的IP。
- disconnectnode “node”
- 立即断开与某个节点的连接。
- getaddednodeinfo dummy ( “node” )
- 返回有关既定的添加节点或所有的添加节点的信息(请注意,此处并未列出onetry addnodes)。
- getconnectioncount
- 返回与其他节点的连接数量。
- getnettotals
- 返回有关网络流量的信息,其中包括字节数、字节输出和当前时间。
- getnetworkinfo
- 返回包含有关P2P网络的各种状态信息的对象。
- getpeerinfo
- 以JSON对象数组的形式返回有关每个连接的网络节点的数据。
- listbanned
- 列出所有禁用的IP/子网。
- ping
- 请求将ping发送到所有其它节点,以测量ping时间。 以getpeerinfo、pingtime和pingwait字段的形式显示结果。 Ping命令和所有其它命令一起在队列中等待处理,因此它将测量积压的待办事项,而不仅仅是网络ping。
- setban “ip(/netmask)” “add|remove” (bantime) (absolute)
- 尝试在被禁列表中添加或删除IP或子网。
- setnetworkactive true|false
- 禁用/启用所有的P2P活动。
Rawtransactions¶
- createrawtransaction [{“txid”:”id”,”vout”:n},…] {“address”:amount,”data”:”hex”,…} ( locktime )
- 创建一个根据输入来完成交易并创建新输出的交易。输出可以是地址或数据。以十六进制编码返回原始交易。请注意,交易的输入未签名,并且不存储在钱包中或传输到网络上。
- decoderawtransaction “hexstring”
- 返回表示序列化十六进制编码交易的JSON对象。
- decodescript “hex”
- 解码十六进制编码的脚本。
- fundrawtransaction “hexstring” includeWatching
- 为交易添加输入,直到它具备足够的数值来满足输出的需求。这项操作不会修改现有的输入,但会向输出添加一个更改输出。
- getrawtransaction “txid” ( verbose )
- 返回原始交易数据。如果verbose 设置为0,则为交易ID返回序列化的十六进制字符串数据。如果verbose设置不为零,则返回一个包含交易ID信息的对象。
- sendrawtransaction “hexstring” ( allowhighfees instantsend )
- 将序列化的(十六进制原始)交易提交到本地节点和网络。如需了解其它信息,请参阅createrawtransaction和signrawtransaction调用。
- signrawtransaction “hexstring” ( [{“txid”:”id”,”vout”:n,”scriptPubKey”:”hex”,”redeemScript”:”hex”},…] [“privatekey1”,…] sighashtype )
- 以序列化的(十六进制编码)的形式签署原始交易的输入。第二个可选参数(可以为零)是此前交易的数组,它是交易所依赖的数组,但可能还不存在于区块链上。第三个可选参数(可以为零)是base58编码的私钥数组,如果这些参数已经给定,那么这些数组将是为交易签名的唯一数组。
Util¶
- createmultisig nrequired [“key”,…]
- 创建一个多签名地址,其中用户需要取得m个签名中的n个才能授权交易。它返回一个带有地址和redeemScript的JSON对象。
- estimatefee nblocks
- 估算交易中每千字节的费率,以便在nblocks区块中开始确认。
- estimatepriority nblocks
- 估算零费用交易所需的优先级,以便在nblocks区块中开始确认。
- estimatesmartfee nblocks
- 警告:本页面不稳定,可能出现页面消失或改变的情况。如有可能,请计算交易中每千字节的费率,以便在nblocks区块中开始确认。此外,请返回计算有效的区块数量。
- estimatesmartpriority nblocks
- 警告:本页面不稳定,可能出现页面消失或改变的情况。如有可能,请计算零交易手续费交易的优先级,以便在nblocks区块中开始确认。此外,请返回计算有效的区块数量。
- validateaddress “dashaddress”
- 返回既定达世币地址的相关信息。
- verifymessage “dashaddress” “signature” “message”
- 验证已签名的信息。
钱包¶
- abandontransaction “txid”
- 将钱包内的交易<txid>标记为已放弃。这意味着该交易和后续的钱包内部交易已经被放弃,它们的输入将被重新分配。
- addmultisigaddress nrequired [“key”,…] ( “account” )
- 向钱包添加一个无需签名的多重签名地址。每个私钥都是一个达世币地址或者十六进制编码的公钥。如果指定了“帐户”(DEPRECATED),则为该帐户分配地址。
- backupwallet “destination”
- 将wallet.dat安全地复制到目标地址,这个目标地址可以是目录或具备文件名的路径。
- dumphdinfo
- 返回包含有关本HD钱包的敏感隐私信息的对象。
- dumpprivkey “dashaddress”
- 显示与’达世币地址’对应的私钥。importprivkey可用于这项输出。
- dumpwallet “filename”
- 以用户可读的格式转存所有的钱包私钥。
- encryptwallet “passphrase”
- 使用密码加密钱包。这是钱包的首次加密。之后,任何与私钥进行交互的调用,例如发送和签名等,都要求事先输入密码。借助walletpassphrase调用和walletlock调用进行这项操作。如果钱包已经被加密了,请使用walletpassphrasechange调用。注意:这个操作会关停服务器。
- getaccount “dashaddress”
- 超时。返回与既定地址关联的帐户。
- getaccountaddress “account”
- 超时。返回当前用于本账户的支付接收的达世币地址。
- getaddressesbyaccount “account”
- 超时。返回既定账户的地址列表。
- getbalance ( “account” minconf addlockconf includeWatchonly )
- 如果没有指定账户,返回服务器上的可用总余额。如果指定了帐户(DEPRECATED),则返回帐户中的余额。请注意,帐户”“与参数留空不同。服务器上的可用总余额可能与默认帐户上的余额不同”“。
- getnewaddress ( “account” )
- 返回用于接收付款的新达世币地址。如果指定了帐户(DEPRECATED),则账户会被添加到地址簿中,以便将该地址收到的付款记入帐户总额。
- getrawchangeaddress
- 返回新达世币地址,用于接收零钱。这项用于原始交易,非正常使用。
- getreceivedbyaccount “account” ( minconf addlockconf )
- 超时。返回在地址上收到的总金额,这些<account>交易已经完成了最低限度的确认的交易。
- getreceivedbyaddress “dashaddress” ( minconf addlockconf )
- 返回在既定达世币地址上收到的总金额,这些交易已经完成了最低限度的确认。
- gettransaction “txid” ( includeWatchonly )
- 获取有关钱包内部交易<txid>的相关信息。
- getunconfirmedbalance
- 返回服务器上的未确认的总余额。
- getwalletinfo
- 返回包含各种钱包状态信息的对象。
- importaddress “address” ( “label” rescan p2sh )
- 添加一个(十六进制的)脚本或可以浏览的地址,这个地址存在于钱包当中,但不能用于消费。
- importelectrumwallet “filename” index
- 从轻钱包输出文件中导入地址(.csv或.json)。
- importprivkey “dashprivkey” ( “label” rescan )
- 把(由dumpprivkey返回的)一个私钥添加钱包。
- importpubkey “pubkey” ( “label” rescan )
- 添加一个(十六进制的)可以浏览的公钥,这个地址存在于钱包当中,但不能用于消费。
- importwallet “filename”
- 从钱包转存文件导入私钥(更多信息请参阅dumpwallet)。
- instantsendtoaddress “dashaddress” amount ( “comment” “comment-to” subtractfeefromamount )
- 将金额发送到既定地址。金额应为实数,并四舍五入到0.00000001。
- keepass <genkey|init|setpassphrase>
- Keepass 设置。
- keypoolrefill ( newsize )
- 填充私钥池。
- listaccounts ( minconf addlockconf includeWatchonly)
- 超时。返回以账户名称为私钥、以账户余额为价值的对象。
- listaddressgroupings
- 列出因共同使用输入或因此前交易的变更而公开了所有权的一系列地址。
- listlockunspent
- 返回暂时不能支出的输出的列表。请参考lockunspent调用来锁定和解锁支出交易。
- listreceivedbyaccount ( minconf addlockconf includeempty includeWatchonly)
- 超时。列出各个账户的余额。
- listreceivedbyaddress ( minconf addlockconf includeempty includeWatchonly)
- 通过接收地址列出余额。
- listsinceblock ( “blockhash” target-confirmations includeWatchonly)
- 从[blockhash]区块中获取所有交易或省略所有交易。
- listtransactions ( “account” count from includeWatchonly)
- Returns up to ‘count’ most recent transactions skipping the first ‘from’ transactions for account ‘account’.
- listunspent ( minconf maxconf [“address”,…] )
- 返回在minconf和maxconf之间(包含)没有支出的交易输出数组。可过滤除向指定地址的支付之外的其它交易。
- lockunspent unlock [{“txid”:”txid”,”vout”:n},…]
- 更新暂时不能输出的列表。暂时锁定(unlock = false)或解锁(unlock = true)指定的交易输出。
- move “fromaccount” “toaccount” amount ( minconf “comment” )
- 超时。将指定金额从钱包中的一个帐户移动到另一个帐户。
- sendfrom “fromaccount” “todashaddress” amount ( minconf addlockconf “comment” “comment-to” )
- 超时。(通过sendtoaddress)将账户中的一定金额发送到一个达世币地址。
- sendmany “fromaccount” {“address”:amount,…} ( minconf addlockconf “comment” [“address”,…] subtractfeefromamount use_is use_ps )
- 多次发送。数量是双倍精度浮点数。
- sendtoaddress “dashaddress” amount ( “comment” “comment-to” subtractfeefromamount use_is use_ps )
- 将金额发送到指定地址。
- setaccount “dashaddress” “account”
- 超时。设置与既定地址关联的账户。
- settxfee amount
- 设置每千字节的交易费用。覆盖paytxfee参数。
- signmessage “dashaddress” “message”
- 使用地址私钥对消息进行签名。
- walletlock
- 从内存中删除钱包的加密私钥并锁定钱包。调用这一方法后,用户需要再次调用walletpassphrase才能调用任何需要解锁钱包的方法。
- walletpassphrase “passphrase” timeout ( mixingonly )
- 在内存中存储钱包解密私钥。在执行与私钥相关的交易,例如发送达世币之前,用户需要完成这项操作。
- walletpassphrasechange “oldpassphrase” “newpassphrase”
- 将钱包密码从’oldpassphrase’更改为’newpassphrase’。