Hacknet

Configured for 3 stacks miners and signers
bind-mounts a local filesystem for data persistence
Uses a chainstate archive to boot the network quickly
Configurable signing weight across the 3 signers

Quickstart

Start network using a chainstate archive

Note: default chainstate archive at ./docker/chainstate.tar.zstd will be used unless overridden by CHAINSTATE_ARCHIVE env var.

Creates a dynamic chainstate folder at ./docker/chainstate/$(date +%s) from a chainstate archive

make up

To override the archive used to restore the network:

CHAINSTATE_ARCHIVE=./docker/chainsate_new.tar.zstd make up

To override the chainstate dir and resume a stopped network: Note: will not work for the genesis chainstate dir and absolute path is required

CHAINSTATE_DIR=$(pwd)/docker/chainsate/<existing chainstate dir> make up

Start network from genesis

Creates a static chainstate folder at ./docker/chainstate/genesis

make genesis

Stop the network

make down

Full list of options

Logs

docker logs -f <service> will work, along with some defined Makefile targets

Store logs from all services under the current chainstate folder

make backup-logs

Stream logs from all services

make log-all

Stream single service logs

make log stacks-signer-1 -- -f

Log from a single service

note this will not follow the logs

make log stacks-signer-1

Pause/Unpause service

To pause all services on the network

make pause

To resume the network

make unpause

Restart a service

Used to simulate a node dropping off of the network

make restart <container name> <number of seconds before restarting>

ex:

make restart stacks-miner-3 61

Stop/Start service (kill)

Stop a single service

make stop <service name>

Restart the stopped service

make start <service name>

Stress the CPU

To simulate CPU load. Can be modified with:

STRESS_CORES to target how many worker threads (default will use all cores)
STRESS_TIMEOUT set a timeout (default of 120s)

make stress

STRESS_CORES=10 STRESS_TIMEOUT=60 make stress

Create a chainstate snapshot

Setting the env var PAUSE_HEIGHT is optional to pause the chain at a specific height, else a default of Bitcoin block 999999999999 is used.
Setting the env var MINE_INTERVAL_EPOCH3 is recommended to reach the PAUSE_HEIGHT more quickly to create the snapshot
Optionally, the CHAINSTATE_ARCHIVE env var may be set to store the archive in a non-default location/name This operation will work with either the up or genesis targets

make genesis

or with env vars set:

MINE_INTERVAL_EPOCH3=10 PAUSE_HEIGHT=240 make genesis

Followed by waiting until the Bitcoin miner reaches the specified height (ex: docker logs -f bitcoin-miner) Once the Bitcoin miner has reached the specified height:

make snapshot

This will first bring down the network, then replace the existing ./docker/chainstate.tar.zstd archive file used with the up Makefile target.

To create the chainstate archive in a non-default location/name File path must be absolute:

CHAINSTATE_ARCHIVE=$(pwd)/docker/chainstate_new.tar.zstd make snapshot

Note: CHAINSTATE_ARCHIVE must be defined to use with make up to use a non-default snapshot. ex:

CHAINSTATE_ARCHIVE=./docker/chainstate_new.tar.zstd make up

Force stop the hacknet network

If the network is in a "stuck" state where the Makefile targets are not stopping the services (i.e. the .current-chainstate-dir file was removed while network was running), down-force may be used to force stop the network.

make down-force

Additionally, clean target will call down-force and also delete any chainstates on disk in ./docker/chainstate/*

make clean

Containers

bitcoin: Runs a bitcoin regtest node
bitcoin-miner: creates 3 bitcoin regtest wallets and mines regtest blocks at a configurable cadence
stacks-miner-1: mines stacks blocks and sends events to stacks-signer-1
stacks-miner-2: mines stacks blocks and sends events to stacks-signer-2
stacks-miner-3: mines stacks blocks and sends events to stacks-signer-3
stacks-signer-1: event observer for stacks-miner-1
stacks-signer-2: event observer for stacks-miner-2
stacks-signer-3: event observer for stacks-miner-3
stacks-api: API instance receiving events from stacks-miner-1
postgres: postgres DB used by stacks-api
stacker: stack for stacks-signer-1, stacks-signer-2 and stacks-signer-3
tx-broadcaster: submits token transfer txs to ensure stacks block production during a sortition

Stacks Miner Accounts

Miner 1

‣ Mnemonic:               lunar amount hard result reunion aisle goat fluid sorry modify minute pretty point visa cart material left tilt travel sausage library clutch wire tuna
‣ Private Key:            23ad69119000a241706486b9349556bdc6dfabdf9d9131b153a57c6b0330fb0d01
‣ Public Key:             0383bca67d28fce336ea7c2fc1120ecc63fbe55e89251e20587c2eb877f971e56b
‣ BTC Address:            miEJtNKa3ASpA19v5ZhvbKTEieYjLpzCYT
‣ Stacks Address:         ST19XY8C456FWH704JR77ZKFTPBNVNK52Q1CK01JD
‣ WIF:                    cNn45HMeSuFeqg3pQESEuLz9FnmiYS83s11snXqDFqX4audaJbcb
‣ Miner Rewards
  ‣ Stacks address:         ST1XVSVQN0KP5SDYFNT8E5TXWVW0XZVQEDBMCJ3XM
  ‣ Private Key:            a6143d20cd73d0dce2179e2af7771372a95b9d6795924492bd4d15d17709531e01
  ‣ Mnemonic:               federal reform visual spot pioneer side knife crouch hazard happy home stem gentle squeeze brother scorpion fuel accident blade tonight world arch raw poet
  ‣ WIF:                    cT9Y8q23uyUkfzPwLvfQQDmHacBdyZKhSKBWTCQ9QZz2tkaL6g4e

Miner 2

‣ Mnemonic:               cherry lawn pull huge drift wisdom capable bulk tragic street first foam onion above come smart eyebrow about soon jungle select used front ecology
‣ Private Key:            1415e80bf3fe30fe95889c676681b4f64447f8888f718381840224b14ef4b97801
‣ Public Key:             03a1940aedd43c39a39c73a1686faaabc67b6bd918d9710292e6c400308df0130e
‣ BTC Address:            mxxRn3xP98tSJCUXxABq4dgg4SziNacF1Y
‣ Stacks Address:         ST2ZMPYMHV80HGY99P9B81CN8E66JHBYVXB8P5F55
‣ WIF:                    cNFkBfqr4tz3V7pcKbBvcibKsZ6XnTmcTwyWoqGm4CStmqN1bqh8
‣ Miner Rewards
  ‣ Stacks address:         ST2FW15NGB4H76FMVXKHYYSM865YVS6V3SA1GNABC
  ‣ Private Key:            fe3087801196d8027008146b13e6d365920c2e4b7bc9969729ec2f0f22ef74fc01
  ‣ Mnemonic:               acoustic physical genre canal today zone confirm whale fashion payment blanket slush crumble version exercise catch candy birth meadow penalty until protect kid wage
  ‣ WIF:                    cW6p6zjVTXFXKQu3JmwfvRtkM5nAqCe1nakyhbd1VrZU59FJLew1

Miner 3

‣ Mnemonic:               identify test gallery pave now pet just gospel erupt walnut demand oyster old trigger soup zoo sheriff oyster twenty tragic license casual twelve depth
‣ Private Key:            c1c3f3f7bb8cc0b64c3be0f79488a3b1e3dbca62f23a5ac84e13beba78cc961301
‣ Public Key:             025511871cb065df0ac108d149b5abe2267242745fd02b1d7a5fafb8dcf3ad66ce
‣ BTC Address:            miBGjFEQveJSbzFwB9XJ9a4GmkY3Unmb7b
‣ Stacks Address:         STEJYWJ2Y7E72AF9JMRWZWNR11ADBJBHD45P7D7K
‣ WIF:                    cU5McyYQu1VJw6tzekyAJd1Jm9NVtjkPhrcbyVm8LgGdiW1Htrf4
‣ Miner Rewards
  ‣ Stacks address:         ST2MES40ZEXTX9M4YXW9QSWHRVC9HYT419S198VPM
  ‣ Private Key:            ed7eb063c61b8e892987228f1fcfb74eab5009568861613dc4b074b708a7893701
  ‣ Mnemonic:               verb face bag shaft snack alcohol consider fork boat gate any energy property vessel olive system spin seek mean recipe layer catch anger bacon
  ‣ WIF:                    cVYMsUwHAZCdwfXZ2rgXWrFJDfqW2TrvLBAVpWCLCteCTTbv7UXL

Signer Accounts

Signer 1

‣ Mnemonic:     number pause unfold flash cover thank spray road moment scatter wreck scrap cricket enemy enlist chest all dog force magnet giggle canyon spatial such
‣ Private Key:  41634762d89dfa09133a4a8e9c1378d0161d29cd0a9433b51f1e3d32947a73dc01
‣ Public Key:   035249137286c077ccee65ecc43e724b9b9e5a588e3d7f51e3b62f9624c2a49e46
‣ STX Address:  ST24VB7FBXCBV6P0SRDSPSW0Y2J9XHDXNHW9Q8S7H
‣ BTC Address:  mt56SJB4aQRz8xA13gnkNnqxZc2dESq6Sq
‣ WIF:          cPmokz1FLbW5KyZGMeSoDBeoRB51358dPzRJatiazpjLUnfaDe55

Signer 2

‣ Mnemonic:     puppy ladder save liar close fix deliver later victory ugly rural artwork topic camera orphan depart power pottery retreat walk ignore army employ turkey
‣ Private Key:  9bfecf16c9c12792589dd2b843f850d5b89b81a04f8ab91c083bdf6709fbefee01
‣ Public Key:   031a4d9f4903da97498945a4e01a5023a1d53bc96ad670bfe03adf8a06c52e6380
‣ STX Address:  ST2XAK68AR2TKBQBFNYSK9KN2AY9CVA91A7CSK63Z
‣ BTC Address:  mxXw9bceXuFB6HZjqriS527kTqt5H9VczT
‣ WIF:          cSowFfhhyLhwsxCQHYzFGLKZYGjob3oQ6ZwH1v4WAAcxeb4Wn4ro

Signer 3

‣ Mnemonic:     want stove parent truly label duck small aspect pumpkin image purity stove pottery check voyage person weasel category cat inspire portion sun lab piece
‣ Private Key:  3ec0ca5770a356d6cd1a9bfcbf6cd151eb1bd85c388cc00648ec4ef5853fdb7401
‣ Public Key:   02007311430123d4cad97f4f7e86e023b28143130a18099ecf094d36fef0f6135c
‣ STX Address:  ST1J9R0VMA5GQTW65QVHW1KVSKD7MCGT27X37A551
‣ BTC Address:  mpgvmF9DSDBrbxUY4rbsPmWkYakoDXr19j
‣ WIF:          cPggi5foghgcKAGnbRwCLMDpQCCmWVUZ9r7PkWQ7cCfK69BWLXdk

Transaction-Generation Accounts

Account 1

‣ Mnemonic:     sorry door captain volume century wood soap asset scheme idea alley mammal effort shoulder gravity car pistol reform aisle gadget gown future lawsuit tone
‣ Private Key:  e26e611fc92fe535c5e2e58a6a446375bb5e3b471440af21bbe327384befb50a01
‣ Public Key:   03fb84a4a2931e7d0ec36bf6e695233bec878fd545bad580751cf4a49d78a7bb27
‣ STX Address:  ST1YEHRRYJ4GF9CYBFFN0ZVCXX1APSBEEQ5KEDN7M
‣ BTC Address:  mruR58H7NvUgmDydv1BM8zMT8og6QxN1Rx
‣ WIF:          cVArVw9FJPeygtZhRtHJEhDqEQTeC3Ybw3UjXt1ir6RgMkMj1Mcz

Account 2

‣ Mnemonic:     album bid grant because narrow unusual unknown machine quick core dolphin occur repair decade toilet betray word people mule assume gesture faint trend about
‣ Private Key:  e3ebd73a51da9a2ab0c6679145420876bf4338554a8972e3ab200cef7adbec6001
‣ Public Key:   03e5049566e351debe8c4d9918faafac751fdcc0e80d3db59069b45761b39015f5
‣ STX Address:  ST1WNJTS9JM1JYGK758B10DBAMBZ0K23ADP392SBV
‣ BTC Address:  mrabBBLKnSZq8fziECh4TsNwVbmdGv6JDV
‣ WIF:          cVDkVrPTBEVa9fFGwFQT4zKi9dXFUJqLym3Ct6MJTepT6Wh5413g

Account 3

‣ Mnemonic:     action still web blush proud cat axis barrel tower assault cram catch more soup auction require again valley letter calm license release fruit industry
‣ Private Key:  0bfff38daea4561a4343c9b3f29bfb06e32a988868fc68beed31a6c0f6de4cf701
‣ Public Key:   03a89261c20768ce41930371cd4c0d756c872e96b8ff749ac044199cc7100ccd71
‣ STX Address:  ST1MDWBDVDGAANEH9001HGXQA6XRNK7PX7A7X8M6R
‣ BTC Address:  mq5SjFHAPh93ZnFLc6Jev8yqn2iLg28Q5B
‣ WIF:          cMz2ZSsaVgWPFUkE44zHpJepB4NdwB9L938h53hQfFoot81AZFb3

Testing Accounts

Unused but funded accounts that may be used to deploy contracts or other txs

Deployer Account

Unused but funded account that may be used to deploy contracts or other txs

‣ Mnemonic:     keep can record bracket note hip face pudding castle detail few sunset review burger enhance foil lamp estate reopen butter then wasp pen kick
‣ Private Key:  27e27a9c242bcf79784bb8b19c8d875e23aaf65c132d54a47c84e1a5a67bc62601
‣ Public Key:   025fa7693cfe4b7c7beccdd9e4bfe77f77a3779d5a58faeb69ead7d1ba94d64f76
‣ STX Address:  ST2SBXRBJJTH7GV5J93HJ62W2NRRQ46XYBK92Y039
‣ BTC Address:  mwp5EpXXVsZxzQRC7yrDe1CJBsyub9f91n
‣ WIF:          cNvERZ1Ci4NQydr5dTuW8K2JuoyfjLJgYVskrLzBoXREnRVbS9qx

Tester 1

‣ Mnemonic:     turkey collect myth access museum demise beef sugar soccer regret frozen will accuse report carpet act grid always satoshi cruise heavy truck avocado dry
‣ Private Key:  38369c150fa7dd132a09a1baf78675a6af3e0612008f299612445f0a5c9f022601
‣ Public Key:   023b7b8652527648bae8efc9153c9b51ccf69f17547b92c70ac33b07de8124ec91
‣ STX Address:  ST332DWHNM323264X869MKXFZABSE5WZ60EA07TJ1
‣ BTC Address:  myagk4VdbTPZpmJsMiw2bmkY3SmSF9zAp3
‣ WIF:          cPTyPP8MtzppSCidZCCAdvecqakCrJ5NPNPs8N4ENGiB11c93hh6

Tester 2

‣ Mnemonic:     cheap render bench token hobby quiz food home twenty fresh until pool whip reduce snack draft club trim boost consider tired symptom amount utility
‣ Private Key:  c3201a1a063c452dda2c27ed5c5d1f8bd12e0c82a1c55ba79dc542c5414441f801
‣ Public Key:   02ea179e664324f495a74c717f128410503c18724ffa8356c5f9f66b9fb241c87a
‣ STX Address:  ST2FY5WGSFA209NFHDT08NCB8Y9J3P1H19YR2D674
‣ BTC Address:  mv6Mc23a3442ZxAbnfzMoSiev6HrYD1wdj
‣ WIF:          cU7zwyRUPanpZDvjSwsaivNjrqN9d8KYVYJuhPn52zCnELasvBMA

Tester 3

‣ Mnemonic:     mixed recycle enroll celery jar object access west loan quantum country race crouch achieve trend mesh invite inch cake wise gospel kick frog hour
‣ Private Key:  6b1474ff9fd29d281f1f3f204b13989a030b5451cc2e840c8c540328cd580cf801
‣ Public Key:   0205930579d15354f3b536f44113fde6ee0aea830a09ab09e89814260fa9e43501
‣ STX Address:  ST3SW0AXHXFDHGQY2XMMDHN6T7VPY395WS7ZRGQCD
‣ BTC Address:  n3jnhvRqD5S7uLRgXQRUeiyLmwLxAcYGt6
‣ WIF:          cRArJzg1NRQKtJQJSa7bT4EKxoR1QoxjLYyj1c4jLGYgaiQcdsXJ

Name		Name	Last commit message	Last commit date
Latest commit History 150 Commits
.github/workflows		.github/workflows
docker		docker
.dclintrc		.dclintrc
.gitignore		.gitignore
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md

License

stacks-network/hacknet

Folders and files

Latest commit

History

Repository files navigation