/swapy-test-faucet

Swapy Token test distribution

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Swapy Test Faucet

NOTE: This repository is intended to support the distribution of tokens to be used within our testnet releases.

Build Status License

Table of Contents

Deployed

Provider Faucet Token
Ropsten 0x6aa9c856b6f60ede7c06d1656f1bcad7df9d858f 0xddcc1ebf2f4d47b485a201b64f41c1ddd18ab247
Rinkeby 0x389b6c0fd02774c372914260355b97cf1207d0e8 0xc32d87cbc83983faf37cc947584c115ec6b4e197
Kovan unavailable unavailable
localhost Variable Variable

Usage

The Token's distribution follows a rate of 1 ETH to 300 SWAPY. To use the faucet and take SWAPY, just send the desired quantity of ETH to the Faucet's address (according to the networks above) and you'll receive tokens.

Setup

Install Dependencies

Install Node v6.11.2

Truffle is used for deployment. We run the version installed from our dependencies using npm scripts, but if you prefer to install it globally you can do:

$ npm install -g truffle

Install project dependencies:

$ npm install

Environment

For set up your wallet, an environment file is necessary. We provide a sample.env file. We recommend that you set up your own variables and rename the file to .env.

sample.env

# To get the twelve words, you need to set up
# your account on the MetaMask extension.
export WALLET_MNEMONIC="twelve words mnemonic ... potato bread coconut pencil"
export DEV_NETWORK_ID=...
export NETWORK_ID=...
export PROVIDER_URL="https://yourfavoriteprovider.../..."

Obs.: NETWORK_ID and PROVIDER_URL are for a custom provider only.

After that, make available your environment file inside the bash context:

$ source .env

Compile

Compile the contract with truffle:

$ npm run compile

Start local network

Start testrpc connection:

$ npm start

For a better understanding of a local blockchain connection, this lecture may be useful: Connecting to the network

Deploy

Run our migrations:

$ npm run migrate.test

We're running the application in a local network defined in truffle.js.

After the transaction mining, the Faucet and Token are disponible for usage.

Run tests

We're using Truffle's test support. The script scripts/test.sh creates a local network and calls the unit tests.

Type

$ npm test

and run the Faucet tests.

Interact with Faucet

Truffle console can be used to interact with Faucet. For example:

$ npm run console
truffle(test)> Faucet.deployed().token.call(); // 0xSomeHexaAddress