Testnet 12

Testnet 12 is the test network running Kaspa with covenants. The goal of this document is to provide a quick guide for anyone who wants to participate.

Overview

On the software side, participating requires three components:

kaspad - the Kaspa client
kaspa-miner - the Kaspa CPU miner
Rothschild - a transaction generator

The Rothschild tool is used to create a wallet, and once the wallet has some funds within, Rothschild will continuously create transactions from that wallet back to itself at the prescribed rate.

The Rothschild wallet could be funded by either mining to it directly (either for a short period or continuously) or by asking other experiment participants for some funds (e.g. on the Discord #testnet channel).

How to participate

The only prerequisite is running a node that's connected to Testnet 12. Other than that you produce blocks by running a miner, produce transactions by running Rothschild, or both.

Since we want the test condition to be as close as possible to organic, we encourage users to diversify their roles, and the hardware they use to participate.

The venue for discussing and monitoring the experiment will be the #testnet channel on Discord. We encourage participants to describe the experience in general, and also tell us what hardware they are using and how well it handles the load.

The recommended hardware requirements are 16GB of RAM, preferably a CPU with at least 8 cores, and an SSD drive with at least 250GB of free space (the 300GB for a safety margin is preferable). It might also be possible to operate with 8GB of RAM, by passing the --ram-scale=0.6 parameter to kaspad.

Setup Instructions

Testnet12 uses a dedicated P2P port (16311) so that nodes from the usual testnet (10) do not automatically attempt connecting to it.

We reiterate that only the included miner should be used to maintain a level playing field.

First, we set-up a node:

Download and extract the rusty-kaspa binaries. Alternatively, you can compile it from source yourself by following the instructions here. The rest of the instructions are written assuming the former option. If you choose to locally compile the code, replace any command of the form <program> <arguments> with cargo run --bin <program> --release -- <arguments> (see example in the next item). All actions described below should be performed on a command line window where you navigated to the directory into which the binaries were extracted.
Start the kaspad client with utxoindex enabled:

kaspad --testnet --netsuffix=12 --utxoindex

It is very important not to forget the --netsuffix=12 flag, otherwise your node will connect to mainnet or to the default testnet. If you complied the code yourself, you should instead run

cargo run --bin kaspad --release -- --testnet --netsuffix=12 --utxoindex

Leave this window open, there is no need to touch it as long as the node is running. Closing it will stop the node.

If you want to transmit transactions, first create a Rothschild wallet

Run rothschild to generate a wallet

The output will provide you with a private key (that looks like a bunch of gibberish) and a public address (that looks like "kaspatest:" followed by a bunch of gibberish). For example, the output could look like this:

2023-06-25 18:00:58.677+00:00 [INFO ] Connected to RPC
2023-06-25 18:00:58.677+00:00 [INFO ] Generated private key aa1c554386218eb28c4bsf6a02e5943799cf951dac7301324d88dec2d0119fce and address kaspatest:qzlpwt49f0useql6w0tzpnf8k2symdv5tu2x2pe9r9nvngw8mvx57q0tt9lr5. Send some funds to this address and rerun rothschild with `--private-key aa1c554386218eb28c4bsf6a02e5943799cf951dac7301324d88dec2d0119fce`

Here, the private key is aa1c554386218eb28c4bsf6a02e5943799cf951dac7301324d88dec2d0119fce and the address is kaspatest:qzlpwt49f0useql6w0tzpnf8k2symdv5tu2x2pe9r9nvngw8mvx57q0tt9lr5

Put some money into the wallet. This could be done by either mining to that wallet (see below) or asking other participants to send money to your public address in the #testnet Discord channel.
Once the wallet has been funded, run Rothschild with the private key:
```
rothschild --private-key <private-key> -t=5
```

The last parameter -t=5 means Rothschild will attempt broadcasting 5 transactions per second. We encourage participants to run with different TPS values. However, in order to encourage transaction spread and to simulate organic usage we highly recommend not to go above 100 TPS.

Like kaspad, the Rothschild window should remain open and undisturbed.

For mining, grab kaspa-miner from within the latest Release and run it with the following flags (this is currently the only miner that supports testnet-12): kaspa-miner --testnet --mining-address <address> -p 16210 -t 1

If you intend to run Rothschild, replace <address> with the address of the wallet generated by rothschild, you should then wait for a while before your wallet accumulates enough funds. Assuming several dozen participants, 20 minutes should be more than enough. If you just mine for the sake of mining, you could use any address, such as the one provided in the example above.

Like the Kaspad and Rothschild windows, the miner window should also be left undisturbed, and closing it will stop the mining.

Faucet: https://faucet-tn12.kaspanet.io/