|
@ -7,185 +7,185 @@ images: |
|
|
sm: /images/pages/testnet-sm.svg |
|
|
sm: /images/pages/testnet-sm.svg |
|
|
--- |
|
|
--- |
|
|
|
|
|
|
|
|
# Command-line Subcommands and Options |
|
|
## Command-line Subcommands and Options |
|
|
|
|
|
|
|
|
## mocknet |
|
|
### mocknet |
|
|
|
|
|
|
|
|
Start a node based on a fast local setup emulating a burnchain. Ideal for smart contract development. |
|
|
Start a node based on a fast local setup emulating a burnchain. Ideal for smart contract development. |
|
|
|
|
|
|
|
|
## krypton (deprecated) |
|
|
### krypton (deprecated) |
|
|
|
|
|
|
|
|
Start a node that will join and stream blocks from the public krypton testnet, powered by Blockstack via (Proof of Transfer). |
|
|
Start a node that will join and stream blocks from the public krypton testnet, powered by Blockstack via (Proof of Transfer). |
|
|
|
|
|
|
|
|
## xenon |
|
|
### xenon |
|
|
|
|
|
|
|
|
Start a node that will join and stream blocks from the public xenon testnet, decentralized. |
|
|
Start a node that will join and stream blocks from the public xenon testnet, decentralized. |
|
|
|
|
|
|
|
|
## start |
|
|
### start |
|
|
|
|
|
|
|
|
Start a node with a config of your own. Can be used for joining a network, starting new chain, etc. |
|
|
Start a node with a config of your own. Can be used for joining a network, starting new chain, etc. |
|
|
|
|
|
|
|
|
### Arguments: |
|
|
#### Arguments: |
|
|
|
|
|
|
|
|
#### --config: relative or absolute path to the TOML config file |
|
|
##### --config: relative or absolute path to the TOML config file |
|
|
|
|
|
|
|
|
Example: |
|
|
Example: |
|
|
stacks-node start --config=/path/to/config.toml |
|
|
stacks-node start --config=/path/to/config.toml |
|
|
|
|
|
|
|
|
See [Configuration File Options](link to anchor) for more information. |
|
|
See [Configuration File Options](link to anchor) for more information. |
|
|
|
|
|
|
|
|
### version |
|
|
#### version |
|
|
|
|
|
|
|
|
Displays information about the current version and the release cycle. |
|
|
Displays information about the current version and the release cycle. |
|
|
|
|
|
|
|
|
### help |
|
|
#### help |
|
|
|
|
|
|
|
|
Displays a help message. |
|
|
Displays a help message. |
|
|
|
|
|
|
|
|
# Configuration File Options |
|
|
## Configuration File Options |
|
|
|
|
|
|
|
|
The TOML configuration file has multiple sections under which an option may be placed. |
|
|
The TOML configuration file has multiple sections under which an option may be placed. |
|
|
|
|
|
|
|
|
## Section: node |
|
|
### Section: node |
|
|
|
|
|
|
|
|
This section contains configuration options pertaining to the stacks-node. |
|
|
This section contains configuration options pertaining to the stacks-node. |
|
|
|
|
|
|
|
|
### rpc_bind |
|
|
#### rpc_bind |
|
|
|
|
|
|
|
|
Address and port stacks-node should use for RPC connections. |
|
|
Address and port stacks-node should use for RPC connections. |
|
|
|
|
|
|
|
|
Example: `"0.0.0.0:20443"` |
|
|
Example: `"0.0.0.0:20443"` |
|
|
|
|
|
|
|
|
### p2p_bind |
|
|
#### p2p_bind |
|
|
|
|
|
|
|
|
Address and port stacks-node should use for P2P connections. |
|
|
Address and port stacks-node should use for P2P connections. |
|
|
|
|
|
|
|
|
Example: `"0.0.0.0:20444"` |
|
|
Example: `"0.0.0.0:20444"` |
|
|
|
|
|
|
|
|
### bootstrap_node (optional) |
|
|
#### bootstrap_node (optional) |
|
|
|
|
|
|
|
|
Public key, address, and port stacks-node should use to pull transaction data from when starting. |
|
|
Public key, address, and port stacks-node should use to pull transaction data from when starting. |
|
|
|
|
|
|
|
|
Example: `"048dd4f26101715853533dee005f0915375854fd5be73405f679c1917a5d4d16aaaf3c4c0d7a9c132a36b8c5fe1287f07dad8c910174d789eb24bdfb5ae26f5f27@krypton.blockstack.org:20444"` |
|
|
Example: `"048dd4f26101715853533dee005f0915375854fd5be73405f679c1917a5d4d16aaaf3c4c0d7a9c132a36b8c5fe1287f07dad8c910174d789eb24bdfb5ae26f5f27@krypton.blockstack.org:20444"` |
|
|
|
|
|
|
|
|
### seed (optional) |
|
|
#### seed (optional) |
|
|
|
|
|
|
|
|
The private key to use for mining. Only needed if `miner` is set to `true`. |
|
|
The private key to use for mining. Only needed if `miner` is set to `true`. |
|
|
[See this page for information on how to generate a private key.](https://docs.blockstack.org/mining) |
|
|
[See this page for information on how to generate a private key.](https://docs.blockstack.org/mining) |
|
|
|
|
|
|
|
|
Example: `"replace-with-your-private-key"` |
|
|
Example: `"replace-with-your-private-key"` |
|
|
|
|
|
|
|
|
### local_peer_seed (optional) |
|
|
#### local_peer_seed (optional) |
|
|
|
|
|
|
|
|
The private key to use for mining. |
|
|
The private key to use for mining. |
|
|
[See this page for information on how to generate a private key.](https://docs.blockstack.org/mining) |
|
|
[See this page for information on how to generate a private key.](https://docs.blockstack.org/mining) |
|
|
|
|
|
|
|
|
Example: `"replace-with-your-private-key"` |
|
|
Example: `"replace-with-your-private-key"` |
|
|
|
|
|
|
|
|
### miner |
|
|
#### miner |
|
|
|
|
|
|
|
|
Determines whether the stacks-node is running a follower (`false`) or a miner (`true`). |
|
|
Determines whether the stacks-node is running a follower (`false`) or a miner (`true`). |
|
|
[See this page for information on how to run a miner.](https://docs.blockstack.org/mining) |
|
|
[See this page for information on how to run a miner.](https://docs.blockstack.org/mining) |
|
|
|
|
|
|
|
|
Example: `true` |
|
|
Example: `true` |
|
|
|
|
|
|
|
|
### prometheus_bind (optional) |
|
|
#### prometheus_bind (optional) |
|
|
|
|
|
|
|
|
Address and port stacks-node should open for Prometheus metrics collection. |
|
|
Address and port stacks-node should open for Prometheus metrics collection. |
|
|
|
|
|
|
|
|
Example: `"0.0.0.0:9153"` |
|
|
Example: `"0.0.0.0:9153"` |
|
|
|
|
|
|
|
|
## Section: events_observer |
|
|
### Section: events_observer |
|
|
|
|
|
|
|
|
### endpoint |
|
|
#### endpoint |
|
|
|
|
|
|
|
|
Address and port to a stacks-node-api to watch for events. |
|
|
Address and port to a stacks-node-api to watch for events. |
|
|
|
|
|
|
|
|
Example: `"address-to-my-local.stacks-node-api.com:3700"` |
|
|
Example: `"address-to-my-local.stacks-node-api.com:3700"` |
|
|
|
|
|
|
|
|
### retry_count |
|
|
#### retry_count |
|
|
|
|
|
|
|
|
Number of times to retry before failing. |
|
|
Number of times to retry before failing. |
|
|
|
|
|
|
|
|
Example: `255` |
|
|
Example: `255` |
|
|
|
|
|
|
|
|
### events_keys |
|
|
#### events_keys |
|
|
|
|
|
|
|
|
Event keys for which to watch. |
|
|
Event keys for which to watch. |
|
|
|
|
|
|
|
|
Example: `["*"]` |
|
|
Example: `["*"]` |
|
|
|
|
|
|
|
|
## Section: burnchain |
|
|
### Section: burnchain |
|
|
|
|
|
|
|
|
This section contains configuration options pertaining to the blockchain the stacks-node binds to on the backend for proof-of-transfer (BTC). |
|
|
This section contains configuration options pertaining to the blockchain the stacks-node binds to on the backend for proof-of-transfer (BTC). |
|
|
|
|
|
|
|
|
### chain |
|
|
#### chain |
|
|
|
|
|
|
|
|
The blockchain stacks-node binds to on the backend for proof-of-transfer. |
|
|
The blockchain stacks-node binds to on the backend for proof-of-transfer. |
|
|
|
|
|
|
|
|
Example: `"bitcoin"` |
|
|
Example: `"bitcoin"` |
|
|
|
|
|
|
|
|
### mode |
|
|
#### mode |
|
|
|
|
|
|
|
|
The profile of which to run stacks-node. |
|
|
The profile of which to run stacks-node. |
|
|
|
|
|
|
|
|
Example: `"krypton"` |
|
|
Example: `"krypton"` |
|
|
|
|
|
|
|
|
### peer_host |
|
|
#### peer_host |
|
|
|
|
|
|
|
|
Host running the BTC blockchain. |
|
|
Host running the BTC blockchain. |
|
|
|
|
|
|
|
|
Example: `"bitcoind.krypton.blockstack.org"` |
|
|
Example: `"bitcoind.krypton.blockstack.org"` |
|
|
|
|
|
|
|
|
### rpc_port |
|
|
#### rpc_port |
|
|
|
|
|
|
|
|
peer_host's port stacks-node will connect to for RPC connections. |
|
|
peer_host's port stacks-node will connect to for RPC connections. |
|
|
|
|
|
|
|
|
Example: `18443` |
|
|
Example: `18443` |
|
|
|
|
|
|
|
|
### peer_port |
|
|
#### peer_port |
|
|
|
|
|
|
|
|
peer_host's port stacks-node will connect to for P2P connections. |
|
|
peer_host's port stacks-node will connect to for P2P connections. |
|
|
|
|
|
|
|
|
Example: `18444` |
|
|
Example: `18444` |
|
|
|
|
|
|
|
|
### process_exit_at_block_height |
|
|
#### process_exit_at_block_height |
|
|
|
|
|
|
|
|
Block height of the burnchain at which the stacks-node will self-terminate. Used during the testnet phases for various testing cycles. |
|
|
Block height of the burnchain at which the stacks-node will self-terminate. Used during the testnet phases for various testing cycles. |
|
|
|
|
|
|
|
|
Example: `5340` |
|
|
Example: `5340` |
|
|
|
|
|
|
|
|
### burnchain_op_tx_fee |
|
|
#### burnchain_op_tx_fee |
|
|
|
|
|
|
|
|
Transaction fee per each burnchain operation. |
|
|
Transaction fee per each burnchain operation. |
|
|
|
|
|
|
|
|
Example: `5500` |
|
|
Example: `5500` |
|
|
|
|
|
|
|
|
### burn_fee_cap |
|
|
#### burn_fee_cap |
|
|
|
|
|
|
|
|
Max burn fee for a transaction. |
|
|
Max burn fee for a transaction. |
|
|
|
|
|
|
|
|
Example: `30000` |
|
|
Example: `30000` |
|
|
|
|
|
|
|
|
### commit_anchor_block_within |
|
|
#### commit_anchor_block_within |
|
|
|
|
|
|
|
|
TODO |
|
|
TODO |
|
|
|
|
|
|
|
|
Example: `10000` |
|
|
Example: `10000` |
|
|
|
|
|
|
|
|
## Section: mstx_balance |
|
|
### Section: mstx_balance |
|
|
|
|
|
|
|
|
This section contains configuration options pertaining to the micro-STX balanaces for various addresses. |
|
|
This section contains configuration options pertaining to the micro-STX balanaces for various addresses. |
|
|
|
|
|
|
|
|
-> This section can be repeated multiple times. |
|
|
-> This section can be repeated multiple times. |
|
|
|
|
|
|
|
|
### address |
|
|
#### address |
|
|
|
|
|
|
|
|
Address which maintains a micro-STX balance. |
|
|
Address which maintains a micro-STX balance. |
|
|
|
|
|
|
|
|
Example: `"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"` |
|
|
Example: `"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"` |
|
|
|
|
|
|
|
|
### amount |
|
|
#### amount |
|
|
|
|
|
|
|
|
The balance of micro-STX given to the address. |
|
|
The balance of micro-STX given to the address. |
|
|
Example: `10000000000000000` |
|
|
Example: `10000000000000000` |
|
|