Skip to content

Latest commit

 

History

History
 
 

faucet

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Ten Faucet

This tools contains a Faucet to allow allocation of ETH tokens within an Ten network. For more information on Ten see the Ten repo and documentation.

Repository Structure

The top level structure of the tool is as below;

├── Dockerfile                 # Docker file to build container
├── README.md                  # This readme file
├── cmd                        # Source code for the CLI application
├── container_build.sh         # Build a local container
├── container_run.sh           # Run a local container
├── faucet                     # Source code for faucet implementation
├── go.mod                     # Golang dependency management 
└── go.sum                     # Goland dependency checksums

Running a local container

To run a local container and run the Faucet use the below;

$ ./container_run.sh 

By default, when running locally the Faucet will connect to a local testnet started as described in the go-ten project repo readme. It will connect to the Ten node running within the local testnet on host validator-host and port 13010. The Faucet opens on port 80 within the container, but maps port 8080 on the host machine to this.

Allocating ETH to an EOA on a local testnet

Allocating ETH to an externally owned account is done through a POST command to the /fund/eth endpoint, where the data in the POST command specifies the address e.g. for the account 0x0d2166b7b3A1522186E809e83d925d7b0B6db084

curl --location --request POST 'http://127.0.0.1:8080/fund/eth' \
--header 'Content-Type: application/json' \
--data-raw '{ "address":"0x0d2166b7b3A1522186E809e83d925d7b0B6db084" }'