grswallet

June 20, 2020 ยท View on GitHub

grswallet is a daemon handling Groestlcoin wallet functionality for a single user. It acts as both an RPC client to grsd and an RPC server for wallet clients and legacy RPC applications.

grswallet is based on btcwallet and stays very similar to it.

Requirements

Go 1.12 or newer.

Installation

  • Install Go according to the installation instructions here: http://golang.org/doc/install

  • Ensure Go was installed properly and is a supported version:

$ go version
$ go env GOROOT GOPATH

NOTE: The GOROOT and GOPATH above must not be the same path. It is recommended that GOPATH is set to a directory in your home directory such as ~/goprojects to avoid write permission issues. It is also recommended to add $GOPATH/bin to your PATH at this point.

  • Run the following commands to obtain grswallet, all dependencies, and install it:
$ git clone https://github.com/Groestlcoin/grswallet
$ cd grswallet
$ make install

NOTE: Do not use go install command, because it will install the binary under wrong names.

  • grswallet will now be installed in $GOPATH/bin. If you did not already add the bin directory to your system path during Go installation, we recommend you do so now.

  • If you do not have GNU make in Windows just type commands from build section of Makefile:

C:\grswallet> go build -o grswallet .

grswallet.exe can be copied to any directory you like.

Updating

  • Run the following commands to update grswallet, all dependencies, and install it:
$ cd grswallet
$ git pull
$ make install

Getting Started

The following instructions detail how to get started with grswallet connecting to a localhost grsd. Commands should be run in cmd.exe or PowerShell on Windows, or any terminal emulator on unix-like systems.

  • Run the following command to start grsd:
grsd -u rpcuser -P rpcpass
  • Run the following command to create a wallet:
grswallet -u rpcuser -P rpcpass --create
  • Run the following command to start grswallet:
grswallet -u rpcuser -P rpcpass

If everything appears to be working, it is recommended at this point to copy the sample grsd (sample-grsd.conf) and grswallet (sample-grswallet.conf) configurations and update with your RPC username and password.

  • Use grsctl to control grswallet and grsd:
grsctl --wallet getinfo

Note how grsctl gains additional powers when you specify --wallet flag.

Ports

-Bitcoin mainnetGroestlcoin mainnetBitcoin testnetGroestlcoin testnet
Wallet/Original RPC833214411833217766
P2P RPC833313311833317777
btcd/grsd RPC833414441833417764

License

grswallet is licensed under the liberal ISC License.