Update configs (#2652)

* chore: update sample/example stacks-node configs and some docs * chore: update configs * docs: update README * docs: update mainnet-follower-conf bitcoin properties
2026-01-12 22:43:42 +08:00 · 2021-05-27 11:56:42 -04:00
parent 67dccdf6d1
commit 08c4b9d61b
16 changed files with 126 additions and 171 deletions
--- a/README.md
+++ b/README.md
@@ -129,7 +129,7 @@ cargo run --bin blockstack-cli generate-sk --testnet
 #  stacksAddress: "ST2ZRX0K27GW0SP3GJCEMHD95TQGJMKB7G9Y0X1MH"
 # }
 ```
-This keypair is already registered in the `Stacks.toml` file, so it can be used as presented here. 
+This keypair is already registered in the `testnet-follower-conf.toml` file, so it can be used as presented here. 

 We will interact with the following simple contract `kv-store`. In our examples, we will assume this contract is saved to `./kv-store.clar`:

@@ -178,10 +178,10 @@ cargo run --bin blockstack-cli publish b8d99fd45da58038d630d9855d3ca2466e8e0f89d
 You can observe the state machine in action locally by running:

 ```bash
-cargo testnet start --config=./testnet/stacks-node/Stacks.toml
+cargo testnet start --config=./testnet/stacks-node/conf/testnet-follower-conf.toml
 ```

-`Stacks.toml` is a configuration file that you can use for setting genesis balances or configuring Event observers.  You can grant an address an initial account balance by adding the following entries:
+`testnet-follower-conf.toml` is a configuration file that you can use for setting genesis balances or configuring Event observers.  You can grant an address an initial account balance by adding the following entries:

 ```
 [[ustx_balance]]
--- a/src/main.rs
+++ b/src/main.rs
@@ -720,7 +720,7 @@ simulating a miner.
            StacksChainState::open(false, 0x80000000, old_chainstate_path).unwrap();
        let old_sortition_db = SortitionDB::open(old_sort_path, true).unwrap();

-        // initial argon balances -- see testnet/stacks-node/conf/argon-follower-conf.toml
+        // initial argon balances -- see testnet/stacks-node/conf/testnet-follower-conf.toml
        let initial_balances = vec![
            (
                StacksAddress::from_string("STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6")
--- a/testnet/stacks-node/conf/argon-follower-conf.toml
+++ b/testnet/stacks-node/conf/argon-follower-conf.toml
@@ -1,35 +0,0 @@
-[node]
-rpc_bind = "0.0.0.0:20443"
-p2p_bind = "0.0.0.0:20444"
-bootstrap_node = "048dd4f26101715853533dee005f0915375854fd5be73405f679c1917a5d4d16aaaf3c4c0d7a9c132a36b8c5fe1287f07dad8c910174d789eb24bdfb5ae26f5f27@argon-master.blockstack.xyz:20444"
-wait_time_for_microblocks = 15000
-
-[burnchain]
-chain = "bitcoin"
-mode = "argon"
-peer_host = "argon.blockstack.org"
-rpc_port = 18443
-peer_port = 18444
-process_exit_at_block_height = 28160
-
-[connection_options]
-# public_ip_address = "x.y.z.a:20444"
-download_interval = 10
-walk_interval = 30
-
-
-[[ustx_balance]]
-address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "ST1HB1T8WRNBYB0Y3T7WXZS38NKKPTBR3EG9EPJKR"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "STRYYQQ9M8KAF4NS7WNZQYY59X93XEKR31JP64CP"
-amount = 10000000000000000
--- a/testnet/stacks-node/conf/local-follower-conf.toml
+++ b/testnet/stacks-node/conf/local-follower-conf.toml
@@ -2,16 +2,21 @@
 rpc_bind = "127.0.0.1:30443"
 p2p_bind = "127.0.0.1:30444"
 bootstrap_node = "04ee0b1602eb18fef7986887a7e8769a30c9df981d33c8380d255edef003abdcd243a0eb74afdf6740e6c423e62aec631519a24cf5b1d62bf8a3e06ddc695dcb77@127.0.0.1:20444"
-miner = false
 pox_sync_sample_secs = 10
+wait_time_for_microblocks = 0

 [burnchain]
 chain = "bitcoin"
 mode = "krypton"
 peer_host = "127.0.0.1"
-rpc_port = 28443
+rpc_port = 18443
 peer_port = 18444
-poll_time_secs = 5
+
+# Used for sending events to a local stacks-blockchain-api service
+# [[events_observer]]
+# endpoint = "localhost:3700"
+# retry_count = 255
+# events_keys = ["*"]

 [[ustx_balance]]
 # Private key: b8d99fd45da58038d630d9855d3ca2466e8e0f89d3894c4724f0efc9ff4b51f001
@@ -133,7 +138,3 @@ amount = 100000000000000
 # Private key: b4dc4945b57c9649ae2ef51aba46ad24f1ec45721969b096a4a9eabfff5e58df01
 address = "ST289WH00WPBAG852K4FRCBNFV7HQ76SZKBHQZ427"
 amount = 100000000000000
-
-# [[events_observer]]
-# endpoint = "http://127.0.0.1:8080"
-# events_keys = ["*"]
--- a/testnet/stacks-node/conf/local-leader-conf.toml
+++ b/testnet/stacks-node/conf/local-leader-conf.toml
@@ -4,7 +4,6 @@ p2p_bind = "127.0.0.1:20444"
 seed = "0000000000000000000000000000000000000000000000000000000000000000"
 local_peer_seed = "0000000000000000000000000000000000000000000000000000000000000000"
 miner = true
-mine_microblocks = false
 prometheus_bind = "127.0.0.1:4000"
 pox_sync_sample_secs = 10
 wait_time_for_microblocks = 0
@@ -13,9 +12,8 @@ wait_time_for_microblocks = 0
 chain = "bitcoin"
 mode = "krypton"
 peer_host = "127.0.0.1"
-rpc_port = 28443
+rpc_port = 18443
 peer_port = 18444
-poll_time_secs = 5

 [[ustx_balance]]
 # Private key: b8d99fd45da58038d630d9855d3ca2466e8e0f89d3894c4724f0efc9ff4b51f001
@@ -137,8 +135,3 @@ amount = 100000000000000
 # Private key: b4dc4945b57c9649ae2ef51aba46ad24f1ec45721969b096a4a9eabfff5e58df01
 address = "ST289WH00WPBAG852K4FRCBNFV7HQ76SZKBHQZ427"
 amount = 100000000000000
-
-
-# [[events_observer]]
-# endpoint = "http://127.0.0.1:8080"
-# events_keys = ["*"]
--- a/testnet/stacks-node/conf/local-second-miner.toml
+++ b/testnet/stacks-node/conf/local-second-miner.toml
@@ -1,34 +0,0 @@
-[node]
-rpc_bind = "127.0.0.1:30443"
-p2p_bind = "127.0.0.1:30444"
-bootstrap_node = "04ee0b1602eb18fef7986887a7e8769a30c9df981d33c8380d255edef003abdcd243a0eb74afdf6740e6c423e62aec631519a24cf5b1d62bf8a3e06ddc695dcb77@127.0.0.1:20444"
-seed = "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef"
-miner = true
-
-[burnchain]
-chain = "bitcoin"
-mode = "neon"
-peer_host = "127.0.0.1"
-rpc_port = 28443
-peer_port = 18444
-
-[[ustx_balance]]
-# Private key: b8d99fd45da58038d630d9855d3ca2466e8e0f89d3894c4724f0efc9ff4b51f001
-address = "ST2ZRX0K27GW0SP3GJCEMHD95TQGJMKB7G9Y0X1MH"
-amount = 10000000000000000
-[[ustx_balance]]
-# Private key: 3a4e84abb8abe0c1ba37cef4b604e73c82b1fe8d99015cb36b029a65099d373601
-address = "ST26FVX16539KKXZKJN098Q08HRX3XBAP541MFS0P"
-amount = 10000000000000000
-[[ustx_balance]]
-# Private key: 052cc5b8f25b1e44a65329244066f76c8057accd5316c889f476d0ea0329632c01
-address = "ST3CECAKJ4BH08JYY7W53MC81BYDT4YDA5M7S5F53"
-amount = 10000000000000000
-[[ustx_balance]]
-# Private key: 9aef533e754663a453984b69d36f109be817e9940519cc84979419e2be00864801
-address = "ST31HHVBKYCYQQJ5AQ25ZHA6W2A548ZADDQ6S16GP"
-amount = 10000000000000000
-
-# [[events_observer]]
-# endpoint = "http://127.0.0.1:8080"
-# events_keys = ["*"]
--- a/testnet/stacks-node/conf/mainnet-follower-conf.toml
+++ b/testnet/stacks-node/conf/mainnet-follower-conf.toml
@@ -0,0 +1,20 @@
+[node]
+# working_dir = "/dir/to/save/chainstate"
+rpc_bind = "0.0.0.0:20443"
+p2p_bind = "0.0.0.0:20444"
+bootstrap_node = "02da7a464ac770ae8337a343670778b93410f2f3fef6bea98dd1c3e9224459d36b@seed-0.mainnet.stacks.co:20444,02afeae522aab5f8c99a00ddf75fbcb4a641e052dd48836408d9cf437344b63516@seed-1.mainnet.stacks.co:20444,03652212ea76be0ed4cd83a25c06e57819993029a7b9999f7d63c36340b34a4e62@seed-2.mainnet.stacks.co:20444"
+
+[burnchain]
+chain = "bitcoin"
+mode = "mainnet"
+peer_host = "bitcoind.stacks.co"
+username = "blockstack"
+password = "blockstacksystem"
+rpc_port = 8332
+peer_port = 8333
+
+# Used for sending events to a local stacks-blockchain-api service
+# [[events_observer]]
+# endpoint = "localhost:3700"
+# retry_count = 255
+# events_keys = ["*"]
--- a/testnet/stacks-node/conf/mainnet-miner-conf.toml
+++ b/testnet/stacks-node/conf/mainnet-miner-conf.toml
@@ -1,4 +1,5 @@
 [node]
+# working_dir = "/dir/to/save/chainstate"
 rpc_bind = "0.0.0.0:20443"
 p2p_bind = "0.0.0.0:20444"
 seed = "<YOUR_SEED>"
@@ -10,9 +11,9 @@ bootstrap_node = "02da7a464ac770ae8337a343670778b93410f2f3fef6bea98dd1c3e9224459
 chain = "bitcoin"
 mode = "mainnet"
 peer_host = "127.0.0.1"
-rpc_port = 8332
-peer_port = 8333
 username = "<USERNAME>"
 password = "<PASSWORD>"
+rpc_port = 8332
+peer_port = 8333
 satoshis_per_byte = 100
 burn_fee_cap = 20000
--- a/testnet/stacks-node/conf/mocknet-follower-conf.toml
+++ b/testnet/stacks-node/conf/mocknet-follower-conf.toml
@@ -0,0 +1,33 @@
+[node]
+# working_dir = "/dir/to/save/chainstate"
+rpc_bind = "0.0.0.0:20443"
+p2p_bind = "0.0.0.0:20444"
+bootstrap_node = "04ee0b1602eb18fef7986887a7e8769a30c9df981d33c8380d255edef003abdcd243a0eb74afdf6740e6c423e62aec631519a24cf5b1d62bf8a3e06ddc695dcb77@127.0.0.1:20444"
+wait_time_for_microblocks = 10000
+use_test_genesis_chainstate = true
+
+[burnchain]
+chain = "bitcoin"
+mode = "mocknet"
+
+# Used for sending events to a local stacks-blockchain-api service
+# [[events_observer]]
+# endpoint = "localhost:3700"
+# retry_count = 255
+# events_keys = ["*"]
+
+[[ustx_balance]]
+address = "ST3EQ88S02BXXD0T5ZVT3KW947CRMQ1C6DMQY8H19"
+amount = 100000000000000
+
+[[ustx_balance]]
+address = "ST3KCNDSWZSFZCC6BE4VA9AXWXC9KEB16FBTRK36T"
+amount = 100000000000000
+
+[[ustx_balance]]
+address = "STB2BWB0K5XZGS3FXVTG3TKS46CQVV66NAK3YVN8"
+amount = 100000000000000
+
+[[ustx_balance]]
+address = "STSTW15D618BSZQB85R058DS46THH86YQQY6XCB7"
+amount = 100000000000000
--- a/testnet/stacks-node/conf/mocknet-miner-conf.toml
+++ b/testnet/stacks-node/conf/mocknet-miner-conf.toml
@@ -0,0 +1,29 @@
+[node]
+# working_dir = "/dir/to/save/chainstate"
+rpc_bind = "0.0.0.0:20443"
+p2p_bind = "0.0.0.0:20444"
+seed = "0000000000000000000000000000000000000000000000000000000000000000"
+local_peer_seed = "0000000000000000000000000000000000000000000000000000000000000000"
+miner = true
+wait_time_for_microblocks = 10000
+use_test_genesis_chainstate = true
+
+[burnchain]
+chain = "bitcoin"
+mode = "mocknet"
+
+[[ustx_balance]]
+address = "ST3EQ88S02BXXD0T5ZVT3KW947CRMQ1C6DMQY8H19"
+amount = 100000000000000
+
+[[ustx_balance]]
+address = "ST3KCNDSWZSFZCC6BE4VA9AXWXC9KEB16FBTRK36T"
+amount = 100000000000000
+
+[[ustx_balance]]
+address = "STB2BWB0K5XZGS3FXVTG3TKS46CQVV66NAK3YVN8"
+amount = 100000000000000
+
+[[ustx_balance]]
+address = "STSTW15D618BSZQB85R058DS46THH86YQQY6XCB7"
+amount = 100000000000000
--- a/testnet/stacks-node/conf/neon-follower-conf.toml
+++ b/testnet/stacks-node/conf/neon-follower-conf.toml
@@ -1,27 +0,0 @@
-[node]
-rpc_bind = "0.0.0.0:20443"
-p2p_bind = "0.0.0.0:20444"
-bootstrap_node = "048dd4f26101715853533dee005f0915375854fd5be73405f679c1917a5d4d16aaaf3c4c0d7a9c132a36b8c5fe1287f07dad8c910174d789eb24bdfb5ae26f5f27@neon.blockstack.org:20444"
-
-[burnchain]
-chain = "bitcoin"
-mode = "neon"
-peer_host = "neon.blockstack.org"
-rpc_port = 18443
-peer_port = 18444
-
-[[ustx_balance]]
-address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "ST1HB1T8WRNBYB0Y3T7WXZS38NKKPTBR3EG9EPJKR"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "STRYYQQ9M8KAF4NS7WNZQYY59X93XEKR31JP64CP"
-amount = 10000000000000000
--- a/testnet/stacks-node/conf/regtest-follower-conf.toml
+++ b/testnet/stacks-node/conf/regtest-follower-conf.toml
@@ -1,15 +1,24 @@
 [node]
+# working_dir = "/dir/to/save/chainstate"
 rpc_bind = "0.0.0.0:20443"
 p2p_bind = "0.0.0.0:20444"
-bootstrap_node = "048dd4f26101715853533dee005f0915375854fd5be73405f679c1917a5d4d16aaaf3c4c0d7a9c132a36b8c5fe1287f07dad8c910174d789eb24bdfb5ae26f5f27@krypton.blockstack.org:20444"
+bootstrap_node = "048dd4f26101715853533dee005f0915375854fd5be73405f679c1917a5d4d16aaaf3c4c0d7a9c132a36b8c5fe1287f07dad8c910174d789eb24bdfb5ae26f5f27@regtest.stacks.co:20444"
+wait_time_for_microblocks = 10000

 [burnchain]
 chain = "bitcoin"
 mode = "krypton"
-peer_host = "bitcoind.krypton.blockstack.org"
+peer_host = "bitcoind.regtest.stacks.co"
+username = "blockstack"
+password = "blockstacksystem"
 rpc_port = 18443
 peer_port = 18444
-process_exit_at_block_height = 5130
+
+# Used for sending events to a local stacks-blockchain-api service
+# [[events_observer]]
+# endpoint = "localhost:3700"
+# retry_count = 255
+# events_keys = ["*"]

 [[ustx_balance]]
 address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
--- a/testnet/stacks-node/conf/testnet-follower-conf.toml
+++ b/testnet/stacks-node/conf/testnet-follower-conf.toml
@@ -1,20 +1,25 @@
 [node]
+# working_dir = "/dir/to/save/chainstate"
 rpc_bind = "0.0.0.0:20443"
 p2p_bind = "0.0.0.0:20444"
-seed = "037435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d"
-local_peer_seed = "037435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d"
-miner = false
-bootstrap_node = "047435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d51651f7f1d566532c804da506c117bbf79ad62eea81213ba58f8808b4d9504ad@xenon.blockstack.org:20444"
+bootstrap_node = "047435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d51651f7f1d566532c804da506c117bbf79ad62eea81213ba58f8808b4d9504ad@testnet.stacks.co:20444"
+wait_time_for_microblocks = 10000

 [burnchain]
 chain = "bitcoin"
 mode = "xenon"
-peer_host = "bitcoind.xenon.blockstack.org"
+peer_host = "bitcoind.testnet.stacks.co"
 username = "blockstack"
 password = "blockstacksystem"
 rpc_port = 18332
 peer_port = 18333

+# Used for sending events to a local stacks-blockchain-api service
+# [[events_observer]]
+# endpoint = "localhost:3700"
+# retry_count = 255
+# events_keys = ["*"]
+
 [[ustx_balance]]
 address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
 amount = 10000000000000000
@@ -30,8 +35,3 @@ amount = 10000000000000000
 [[ustx_balance]]
 address = "STRYYQQ9M8KAF4NS7WNZQYY59X93XEKR31JP64CP"
 amount = 10000000000000000
-
-
-# [[events_observer]]
-# endpoint = "127.0.0.1:8080"
-# events_keys = ["*"]
--- a/testnet/stacks-node/conf/testnet-miner-conf.toml
+++ b/testnet/stacks-node/conf/testnet-miner-conf.toml
@@ -1,19 +1,21 @@
 [node]
+# working_dir = "/dir/to/save/chainstate"
 rpc_bind = "0.0.0.0:20443"
 p2p_bind = "0.0.0.0:20444"
 seed = "<YOUR_SEED>"
 local_peer_seed = "<YOUR_SEED>"
 miner = true
-bootstrap_node = "047435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d51651f7f1d566532c804da506c117bbf79ad62eea81213ba58f8808b4d9504ad@xenon.blockstack.org:20444"
+bootstrap_node = "047435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d51651f7f1d566532c804da506c117bbf79ad62eea81213ba58f8808b4d9504ad@testnet.stacks.co:20444"
+wait_time_for_microblocks = 10000

 [burnchain]
 chain = "bitcoin"
 mode = "xenon"
 peer_host = "127.0.0.1"
+username = "<USERNAME>"
+password = "<PASSWORD>"
 rpc_port = 18332
 peer_port = 18333
-username = "xenon"
-password = "password"

 [[ustx_balance]]
 address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
--- a/testnet/stacks-node/conf/xenon-autonomous-follower-conf.toml
+++ b/testnet/stacks-node/conf/xenon-autonomous-follower-conf.toml
@@ -1,37 +0,0 @@
-[node]
-rpc_bind = "0.0.0.0:20443"
-p2p_bind = "0.0.0.0:20444"
-seed = "037435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d"
-local_peer_seed = "037435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d"
-miner = false
-bootstrap_node = "047435c194e9b01b3d7f7a2802d6684a3af68d05bbf4ec8f17021980d777691f1d51651f7f1d566532c804da506c117bbf79ad62eea81213ba58f8808b4d9504ad@xenon.blockstack.org:20444"
-
-[burnchain]
-chain = "bitcoin"
-mode = "xenon"
-peer_host = "127.0.0.1"
-rpc_port = 18332
-peer_port = 18333
-username = "xenon"
-password = "password"
-
-[[ustx_balance]]
-address = "STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "ST1HB1T8WRNBYB0Y3T7WXZS38NKKPTBR3EG9EPJKR"
-amount = 10000000000000000
-
-[[ustx_balance]]
-address = "STRYYQQ9M8KAF4NS7WNZQYY59X93XEKR31JP64CP"
-amount = 10000000000000000
-
-
-# [[events_observer]]
-# endpoint = "127.0.0.1:8080"
-# events_keys = ["*"]
--- a/testnet/stacks-node/src/main.rs
+++ b/testnet/stacks-node/src/main.rs
@@ -200,7 +200,7 @@ xenon\t\tStart a node that will join and stream blocks from the public xenon tes

 start\t\tStart a node with a config of your own. Can be used for joining a network, starting new chain, etc.
 \t\tArguments:
-\t\t  --config: path of the config (such as https://github.com/blockstack/stacks-blockchain/blob/master/testnet/Stacks.toml).
+\t\t  --config: path of the config (such as https://github.com/blockstack/stacks-blockchain/blob/master/testnet/stacks-node/conf/testnet-follower-conf.toml).
 \t\tExample:
 \t\t  stacks-node start --config=/path/to/config.toml