squeaknode/README.md
Jonathan Zernik cef4eeca03
Update main config ini (#582)
* Fix network in main config.ini

* Update README and DOCKER doc
2021-01-08 02:42:32 -08:00

1.2 KiB

squeaknode

Node for Squeak protocol

Run a node:

Requirements

  • a bitcoin node
  • an LND node
  • Python 3.6 or later

If you don't already have a bitcoin node or lightning node, you can follow the instructions here to launch them in Docker.

Steps

  • Update the config.ini file and fill in the relevant sections to connect to your bitcoin and lnd nodes:

    [core]
    network=testnet
    
    [lnd]
    host=localhost
    external_host=lnd_server
    tls_cert_path=~/.lnd/tls.cert
    macaroon_path=~/.lnd/data/chain/bitcoin/testnet/admin.macaroon
    
    [bitcoin]
    rpc_host=localhost
    rpc_port=18332
    rpc_user=devuser
    rpc_pass=devpass
    
    [webadmin]
    enabled=true
    username=devuser
    password=devpass
    
  • Install squeaknode:

    $ pip install squeaknode
    

    or

    $ pip install -r requirements.txt
    $ python setup.py install
    
  • Start the squeak server:

    $ runsqueaknode --config config.ini run-server
    
  • Go to http://localhost:12994/ and use the username/password in config.ini to log in.

Test

Unit tests:

Requirements

  • tox
$ make test

Integration tests:

Requirements

  • docker-compose
  • jq
$ make itest