NewChainFaucet

This is a server program that can get free money for the address of the NewChain blockchain.

• Call faucet to get free money
• Call balance to check your money

QuickStart

Download from releases

Binary archives are published at releases.

Building the source

To get from gitlab via go get, this will get source and executable program.

Linux or Mac

git clone https://github.com/newtonproject/newchain-faucet && cd newchain-faucet && make all

newchain-faucet is for ethereum and newchain-faucet-newton is for newton.

run NewChainFaucet

./newchain-faucet

Usage

Help

Use command NewChainFaucet help to display the usage.

Usage:
  NewChainFaucet [flags]
  NewChainFaucet [command]

Available Commands:
  account     Manage NewChain accounts
  help        Help about any command
  init        Initialize config file
  start       start NewChainFaucet server
  version     Get version of NewChainFaucet CLI

Flags:
  -c, --config path            The path to config file (default "./config.toml")
  -h, --help                   help for NewChainFaucet
  -i, --rpcURL url             Geth json rpc or ipc url (default "https://rpc1.newchain.newtonproject.org")
  -w, --walletPath directory   Wallet storage directory (default "./wallet/")

Use "NewChainFaucet [command] --help" for more information about a command.

Use config.toml

You can use a configuration file to simplify the command line parameters.

One available configuration file config.toml is as follows:

rpcurl = "http://192.168.168.33"
walletpath = "./wallet/"

[faucet]
  amount = "16888"
  from = "0x83B4aB41173385A265788b835d8Ee5d3b84081D4"
  port = 8888
  unit = "NEW"
  password = "newton"

Initialize config file

# Initialize config file
newchain-faucet init

Just press Enter to use the default configuration, and it's best to create a new user.

$ NewChainFaucet init
Initialize config file
Enter file in which to save (./config.toml):
Enter the wallet storage directory (./wallet/):
Enter geth json rpc or ipc url (https://rpc1.newchain.newtonproject.org):
Create a new account or not: [Y/n]
Your new account is locked with a password. Please give a password. Do not forget this password.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
0xF69501bE4271eEC6AA21b975240b34f088bAb754
Your configuration has been saved in  ./config.toml

Create account

# Create an account
newchain-faucet account new

# Create 10 accounts
newchain-faucet account new -n 10

List all accounts

# list all accounts of the walletPath
newchain-faucet account list

Start faucet server

Make sure the default wallet address has a large balance before starting the server

# Start faucet server with rpc url
newchain-faucet start

Get balance

• Open the browser and enter the url http://localhost:8888/balance?address=0xDB2C9C06E186D58EFe19f213b3d5FaF8B8c99481

• Use curl command

# Use curl command
curl http://localhost:8888/balance?address=0xDB2C9C06E186D58EFe19f213b3d5FaF8B8c99481

Get faucet

• Open the browser and enter the url http://localhost:8888/faucet?address=0xDB2C9C06E186D58EFe19f213b3d5FaF8B8c99481

• Use curl command

# Use curl command
curl http://localhost:8888/faucet?address=0xDB2C9C06E186D58EFe19f213b3d5FaF8B8c99481