AElf Faucet Backend

The AElf Faucet Backend is a service designed to provide users with test tokens on the AElf blockchain network. This service is primarily intended for developers who need test tokens for development and testing purposes.

AElf Faucet Backend

Overview

This project implements a backend service that allows users to request test tokens from an AElf testnet faucet. It includes endpoints for claiming tokens and verifying eligibility based on various criteria.

Features

Claim test tokens
Verification of eligibility
Logging and monitoring
Easy configuration and deployment

Prerequisites

Before you begin, ensure you have met the following requirements:

.NET SDK (version 6.0 or later)
AElf SDK

Installation

Clone the repository:

git clone https://github.com/AElfProject/faucet-backend.git
cd faucet-backend

Restore the dependencies:
```
dotnet restore
```
Build the project:
```
dotnet build
```

Configuration

Create a appsettings.json file in the AELFFaucet.Web directory of the project with the following content:

{
  "App": {
    "AllowedHosts": "*",
    "CorsOrigins": "*"
  },
  "ConnectionStrings": {
    "Default": "mongodb://localhost:27017/SendTokenDB"
  },
  "ApiConfig": {
    "BaseUrl": "http://3.25.10.185:8000",
    "BaseUrlForMainchain": "https://aelf-test-node.aelf.io",
    "BaseUrlForSidechain": "https://tdvw-test-node.aelf.io",
    "PrivateKey": "b192e307da4c4e1a00eeed442a4b5e8e0b7b2c6f838d0472627b846e5280c51c",
    "SendCount": 100,
    "NftSeedPrivateKey": "97a1747af1539a6b839c92227c8f5ca90ef0e7de70e5c2f46c64f27b12fabdd7"
  },
  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://*:8801/"
      }
    }
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "System": "Error",
      "Microsoft": "Error"
    }
  }
}

Replace the PrivateKey and NftSeedPrivateKey with your actual AElf testnet node private keys for storing token pool for token distribution.

Usage

Run the service:

dotnet run

The service will be available at http://localhost:8801. You can access the swagger documentation at http://localhost:8801/swagger/index.html.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

AElfProject/faucet-backend