No description, website, or topics provided.
Go Shell
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
.gitignore
.travis.yml travis: Add go 1.7 and drop 1.5 support. (#101) Aug 17, 2016
LICENSE add license title (#100) Aug 12, 2016
README.md Update markdown files for GFM changes. May 25, 2017
actor.go fixed rpc import location Oct 6, 2017
btcd.go
btcd_test.go
btcwallet.go fixed rpc import location Oct 6, 2017
btcwallet_test.go travis: Add go 1.7 and drop 1.5 support. (#101) Aug 17, 2016
comm.go fixed rpc import location Oct 6, 2017
goclean.sh Update TravisCI to goclean script. Jan 16, 2015
main.go Update for recent chainhash-related API changes. (#97) Aug 10, 2016
miner.go
node.go fixed rpc import location Oct 6, 2017
signal.go
simulation.go
utils.go Update for recent chainhash-related API changes. (#97) Aug 10, 2016
utils_test.go

README.md

btcsim

Build Status ISC License GoDoc

btcsim implements a simulation test driver using the simnet network provided by btcd. It launches the required nodes, manages them, runs the simulation and cleans up when done, all by itself, so there's no manual setup/teardown involved. btcsim uses btcrpcclient to interface with the RPC servers.

The input is read from a CSV file with the following headers:

| block height | minimum utxos required | transactions required |

Example:

20000,40000,20000
20001,60000,30000

Based on the input, the minimum required number of utxos are generated by creating transactions using the existing utxos and dividing them until the required number is reached.

The required number of transactions are generated by simulating transactions between multiple actors and using the utxos generated previously.

Mining is controlled using the RPC clients to ensure that the blocks are generated only when required i.e. when the minimum required number of utxos and transactions are created.

Components

Node

This is the first btcd node that is launched. It acts as the server for all Actors and as a peer for the miner.

Actor

An Actor simulates a wallet "Agent" by launching a btcwallet instance which connects to the node server. It is responsible for generating transactions among itself as well as other actors. Multiple actors can be launched simultaneously to simulate a large load due to a heavy multi-user system.

Miner

The Miner launches a btcd instance and simulates a mining node. It is connected to the node server using the addnode RPC call. It is responsible for collecting transactions and mining them when required.

Installation

btcsim depends on btcd and btcwallet, so install those first

$ go get github.com/btcsuite/btcd
$ go get github.com/btcsuite/btcwallet

Now install btcsim

$ go get github.com/btcsuite/btcsim

Usage

Invoking the command btcsim without any flags initializes a single actor simulation, using a default linear curve of 0-10,000 transactions per block:

$ btcsim

For more options, see:

$ btcsim --help

Debugging

To debug btcsim itself, you can turn on profiling using the --profile flag. To debug the processes spawned by btcsim i.e. btcd and btcwallet, you can check the logs written to ~/.btcsim/.

License

Package btcsim is licensed under the copyfree ISC License.