corellia

Corellia is a CLI tool that funds an address with testnet tokens from the Alchemy faucet and distributes testnet tokens between addresses. Supported testnets are Mumbai and Goerli.

Status

Summary

A CLI tool to perform the following operations with testnet tokens:

• fund an address with testnet tokens,
• get balance of testnet tokens,
• distribute an amount of testnet tokens equally to a number of addresses
• send testnet tokens to an address.

Table of Contents

• Installation
• Introduction
• Prerequisites
• Install Tool
• Usage
• License

Installation

Install the package with npm:

npm install

Introduction

This project scrapes the Alchemy faucets in order to get 2 testnet Matic (mumbai) or 0.2 testnet Eth (Goerli).

Prerequisites

Please make sure to setup the tool with an Alchemy email and password. For this purpose, an account should be created in Alchemy in order to use it in the faucet and get 2 Matic/day or 0.2 Eth/day. The funding from the faucet can take place once every 24 hours.

Install Tool

To install the corellia CLI localy:

npm install corellia

Usage

corellia [options] [command]

Options:
  -h, --help                 display help for command

Commands:
  set-credentials [options]  Setup user credentials for Alchemy: email, password and api-key (optional).
  get-credentials            Get user credentials for Alchemy.
  get-balance [options]      Get testnet tokens balance for address.
  funding [options]          Fund address with testnet tokens.
  distribute [options]       Distribute testnet tokens equally between some addresses.
  help [command]             display help for command

Get Balance:

corellia get-balance -address 0x1385C6709022a02434333ECCe688b9390ee71306 -network mumbai

Distribute:

In order to distribute an amount of testnet tokens equally between a number of addresses:

corellia distribute -amount 10 -address 0x54324eda3Fbe99F09872Cd75E59481De714EA222 -privatekey 02bbf09b20e49406d99f4d3507fae0e6fb4fbdb0d2d120g2b000a7a46q1a6419 -addresses 0x80a0A464cF065af842afBc2243a3899d98E4332a,0xd80A1209E123444bDf3D7EeDfb4da822F12B4dD6 -network mumbai

Funding:

In order to fund an address with testnet Matic:

corellia funding -address 0x1385C6709022a02434333ECCe688b9390ee71306 -network mumbai

License

This library is released under MIT.