Wallet Bot

Self-custody, headless wallet service that runs as a daemon process within your data center. It manages your software operation's private keys so that your apps can securely send payments on any peer to peer payments network.

Installation and Setup

The application runs as a long-running process which should be managed by k8s, docker, or your system service manager such as systemd or similar. It may be run in a node.js environment or as an isolated docker container. The single process requires no additional services such as database servers to be run.

docker pull anypay/wallet-bot

Setting Up Wallet Keys

Rather than managing your own private key generation and backup, allow wallet bot to generate keys offline and automatically output a wallet-bot.json config file for you. Simply save a copy of this file to your organizations' vaults to restore funds in case of a machine failure.

docker run anypay/wallet-bot new_wallet > wallet-bot.json

You may view with cat wallet-bot.json that one private key has been created for each of the supported coins.

Alternatively you may provide your own wallet keys using the Wallet Import Format (WIF) inside wallet-bot.json.

Running the Service

To run with wallet-bot.json config file:

docker run \
  -v /path/to/wallet-bot.json:/etc/wallet-bot/wallet-bot.json \
  anypay/wallet-bot start

To run with environment variables:

docker run --env-file=/path/to/.env anypay/wallet-bot start

You may also combine some variables from one method with others from the other method.

Configuration

Wallets and system settings may be configured by a combination of json config files, environment variables, and command line flags. All variables may be provided by either of the config variations.

Environment Variables

*required

Variable name	Description
ANYPAY_API_TOKEN *	https://anypayx.com/dashboard/developer/wallet-bot
SLACK_WEBHOOK_URL	Will receive Slack-formatted messages on certain events
WEBHOOK_URL	Will receive messages on certain events
LOG_LEVEL	[error, debug, info, warn] defaults to info
BSV_PRIVATE_KEY	Private signing key to BSV wallet
BTC_PRIVATE_KEY	Private signing key to BTC wallet
BCH_PRIVATE_KEY	Private signing key to BCH wallet
DASH_PRIVATE_KEY	Private signing key to DASH wallet
DOGE_PRIVATE_KEY	Private signing key to DOGE wallet
LTC_PRIVATE_KEY	Private signing key to LTC wallet
ZEC_PRIVATE_KEY	Private signing key to ZEC wallet

Configuration should be provided by a file mounted at /etc/wallet-bot/wallet-bot.json

Testing

To run tests run npm run test

Development

To commit new code run npm run commit