EQB Node

David McFadzean edited this page Feb 12, 2019 · 5 revisions

See Release Notes

Installation

Windows binaries

  • Download and unpack eqb-node-0208.zip to your local drive
  • Optionally customize data\equibit.conf (doc TBD)
  • Run start-node.bat to launch the equibit testnet node
  • Run monitor-log.bat to ensure it syncs OK

When running the batch files under Windows 10, Windows Defender will likely popup a warning for an "unrecognized app". Click the "More info" followed by "Run anyway".

Ubuntu

To run natively on Ubuntu you will have to build from source. If you're comfortable with git and build tools you should be good to go. I would suggest building bitcoin core first to make sure you have all the right dependencies.

Docker

  • You'll probably want to install Docker
  • Create a data folder
  • Add a configuration file equibit.conf to the folder (see template below)
  • Start the node: docker run --rm --name testnet -p 17331:17331 -p 18331:18331 -v [data folder]:/data -d macterra/eqb-testnet:v02.08
    • Substitute the path for your own data folders
    • Expose the same ports that is specified in the equibit.conf file
    • The 17331 port should be exposed if you are running a seed node (specify listen=1 in the config file and add port forwarding if you are behind a firewall)
    • The 18331 (RPC) port should be exposed for the miner to connect
  • Make sure it syncs OK: docker logs -f testnet
  • Login to the container to issue commands: docker exec -it testnet bash
    • Once logged in you can use the alias ec instead of equibit-client -datadir=/data, e.g. ec uptime
  • When you stop the container docker stop testnet it will be automatically removed but the blockchain data will persist in your data folder so you can restart any time

Configuration

  • Create a data folder
  • Add a configuration file named equibit.conf to the data folder
  • Run: equibitd -datadir=[path to data folder]

Template for equibit.conf

rpcuser=equibit
rpcpassword=equibit
rpcallowip=0.0.0.0/0
uacomment=anon-node

testnet=1
server=1
txindex=0
rest=1
listen=1
logtimemicros=1
debug=1
debugexclude=libevent
debugexclude=leveldb
debugexclude=tor
keypool=1
discover=0
mocktime=0
port=17331
rpcport=18331
addnode=35.207.42.65:17331

CLI Commands

  • equibit-cli -datadir=[path] uptime to check if the node is running
  • equibit-cli -datadir=[path] getwalletinfo to check your balance
  • equibit-cli -datadir=[path] getnewaddress main bech32 to generate an address in the main account to receive funds
  • equibit-cli -datadir=[path] sendtoaddress [address] [amount] to send funds
  • equibit-cli -datadir=[path] help [command] to get documentation
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.