51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
# TxVulcano is a test-mode random transaction generation application.
|
|
|
|
This application is both a test application for Flowee the Hub's APIs and a
|
|
useful way to generate sizeable blocks for propagation and mining tests.
|
|
|
|
Flowee the Hub by default enables its APIs without password access, but
|
|
only when you run both the Hub and the client applications on the same
|
|
host. It uses the loopback device for communication.
|
|
|
|
To run the Hub and the txVulcano on different machines start the Hub with
|
|
the config option (or command-line argument) `apibind`, followed with
|
|
the IP address of the local network card it should listen on.
|
|
The argument can be passed multiple times if you want the Hub to listen on
|
|
multiple network cards.
|
|
|
|
It is essential to understand that creating a huge amount of transactions,
|
|
and mining those blocks in the Hub can only happen in the `regtest`
|
|
development mode. The main reason of this is cost. Mostly cost of mining.
|
|
|
|
The suggested way to start the Hub is then;
|
|
|
|
```
|
|
hub -regtest -blockmaxsize=500000000 \
|
|
-limitancestorcount=5000 \
|
|
-limitancestorsize=1000000 \
|
|
-limitdescendantcount=5000 \
|
|
-limitdescendantsize=1000000
|
|
```
|
|
|
|
The txVulcano application has several option as well, but generally the
|
|
defaults will be fine for a testrun. But please do check out the `--help`
|
|
option for what is possible.
|
|
|
|
The simplest way to start creating transactions and mining blocks is to
|
|
run;
|
|
`txVulcano localhost`
|
|
|
|
where 'localhost' is the hostname or IP address where the Hub can be found.
|
|
|
|
# wallet
|
|
|
|
The txVulcano application will create a simple wallet file named 'mywallet'
|
|
that is stored in the directory you started the vulcano application from.
|
|
This allows multiple runs of the vulcano app without the need to first mine
|
|
a lot of empty blocks just to get some coin we can spent.
|
|
|
|
|
|
Enjoy playing with this and please let me know if it was useful for you!
|
|
|
|
Tom
|