Skip to content

🌴 Goacoin daemon container for headless wallet and masternode.

License

Notifications You must be signed in to change notification settings

LePetitBloc/goacoind

Repository files navigation

Docker Stars

Goacoin core Wallet Daemon for headless wallets and masternodes.

For a list of all available wallet images see https://lepetitbloc.github.io/wallets/

Issues

Usage

The container can either be used as a classic headless wallet or a masternode, only the command arguments will differ.

Headless wallet

  1. Run a wallet container and specify at least the rpcuser and rpcpassword to interact with the Goacoin daemon:
docker run --name goacoin-wallet --restart always -d lepetitbloc/goacoind:v0.12.1.9 -rpcuser=goacoin-wallet -rpcpassword=xnrqivbw

We recommend to mount a volume for easier access to the data and the configuration files. You should also create a configuration for your RPC credentials (see ./wallet/.goacoincore/goacoin.conf) to avoid retyping them when using the internal goacoin-cli.

docker run --name goacoin-wallet --restart always -d -v ${PWD}/wallet/:/home/goacoin/ lepetitbloc/goacoind:v0.12.1.9

⚠️ Ensure that a data directory exists and is writable in the mounted host directory.

  1. Once your wallet is running, you can print your main address:
docker exec goacoin-wallet goacoin-cli getaccountaddress ""

GK92mbjS9bCAUuU7DEyyuK9US1qLqkoyce

  1. Encrypt your wallet:

You can use pwgen first to generate your passphrase:

pwgen 32 1

quohd4kaw9guvi8ie7phaighawaiLoo6

docker exec goacoin-wallet goacoin-cli encryptwallet quohd4kaw9guvi8ie7phaighawaiLoo6

Wallet encrypted; Goacoin Core server stopping, restart to run with encrypted wallet. The keypool has been flushed, you need to make a new backup.

‼️ Don't forget to backup your passphrase.

Masternode

Prerequisites

  1. You must have received 1000 GOA on your wallet in a single transaction, and must have waited for, at least, 1 confirmation.

Note1: If the 1000 GOA came from multiple transactions, you can send them back to yourself.

Note2: Beware of the transaction cost, you should own 1001 GOA as a safety measure.

  1. Only then you may find the corresponding transaction hash and index :
docker exec goacoin-wallet goacoin-cli masternode outputs
{
 "8e835a7d867d335434925c32f38902268e131e99a5821557d3e77f8ca3829fd8" : "0"
}
  1. Then generate a masternode private key:
masternode genkey
7ev3RXQXYfztreEz8wmPKgJUpNiqkAkkdxt24C3ZKtg5qEVfou9
  1. And finally creates the ./wallet/.goacoincore//masternode.conf file, and fill in following this template:

mn01 masternode:21529 YouMasterNodePrivateKey TransactionHash 0 YourWalletAddress:100

touch ./wallet/.goacoincore//masternode.conf

Setup

  1. As a classic wallet, create a ./masternode/.goacoincore/goacoin.conf configuration file
rpcuser=goacoin-mn01
rpcpassword=xnrqivbw
masternode=1
masternodeprivkey=7ev3RXQXYfztreEz8wmPKgJUpNiqkAkkdxt24C3ZKtg5qEVfou9
externalip=YOUR.EXTERNAL.IP:1947

  1. Run a container as a masternode:
docker run --name goacoin-masternode --restart always -d -p 1947:1947 -p 1948:1948 -v ${PWD}/masternode/:/home/goacoin/ lepetitbloc/goacoind:v0.12.1.9 -masternode=1
  1. Check the the number of blocks until the chain is sync:
docker exec goacoin-masternode goacoin-cli getinfo
  1. Once the chain synced you can start the masternode from your wallet:
docker exec goacoin-wallet goacoin-cli goacoin-masternode start-all

You might need to unlock your wallet first:

 docker exec goacoin-wallet goacoin-cli walletpassphrase quohd4kaw9guvi8ie7phaighawaiLoo6 60

⚠️ Mind the space before the command above, that's not a typo, it’s meant to avoid storing your passphrase in history.

  1. Then check the masternode status with your initial transaction hash:
docker exec goacoin-wallet goacoin-cli masternodelist | grep 6d94f70499c3f7ba2c59acaa5c04e54ef123d0e460bb07c55ace6464deaf3c85

"6d94f70499c3f7ba2c59acaa5c04e54ef123d0e460bb07c55ace6464deaf3c85-1": "ENABLED",

docker-compose

You could setup both at the same time using docker-compose. Check the provided docker-compose.yml as an example and tweak it to your needs!

docker-compose up --build

Resources

Parent project

Parent image

  • Berkeley DB v4.8.30.NC FROM lepetitbloc/bdb:4.8.30.NC

https://github.com/LePetitBloc/bdb/tree/4.8.30.NC https://hub.docker.com/r/lepetitbloc/bdb/

Licence

MIT