The Neon Faucet: How to Get Tokens to Test your Neon dApp

The Neon Faucet is a Neon service that distributes small amounts of test tokens to a user’s Neon EVM wallet address. This service exists in order to allow Neon users to experiment and play around with the Neon ecosystem for free, and therefore it only supports token distribution on devnet and testnet. On mainnet, however, a user is using ‘real’ tokens, and so cannot rely on the Neon Faucet to provide them.

How to Use the Neon Faucet

The following is a tutorial for using the Neon Faucet, based on the content found in the Neon Documentation. There are two ways to use the Neon Faucet — on the Neon Faucet website, and using the Neon Faucet API.

Requesting Test NEON Tokens via the Website​

Step 1​

Set up MetaMask by following the Setting up MetaMask guide.

Step 2​

Go to the NeonFaucet webpage to request test tokens.

Step 3​

Connect your MetaMask wallet:

• Click on the ‘CONNECT WALLET’ button to authorize the connection in the MetaMask pop-up.

• In the MetaMask pop-up window, select one or more accounts and click Next.

• Сlick on the Connect button to confirm your selection.

• In the form that appears, select the token and enter the amount of tokens you would like to request, and then click on the ‘SEND TEST TOKENS’ button.

Requesting Test NEON Tokens via HTTP API Endpoints

For this method, a client uses standard HTTP requests to send data to the server. Several endpoints are supported, as shown in the following table.

Some usage examples of the API method include the following:

An example of a JSON payload:

An example of a ping request with curl:

An example of a version request with curl:

An example of a NEON drop request with curl:

Configuration

The configuration file should be in the TOML format. A table containing all the configuration options with their descriptions is shown below.

A sample configuration file is as follows:

The configuration file is optional and, if present, can be incomplete (default values or environment variables will be used in such cases).

Environment Variables

Environment variables, if present, take precedence and override the configuration file.

Conclusion

The Neon Faucet is a service that allows users to easily obtain small amounts of test tokens for use in development and sandbox testing for the Neon EVM. It can be accessed via the NeonFaucet user interface or through its HTTP endpoints programmatically. This allows users and builders to experiment with Neon without having to worry about expending ‘real’ assets.