Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/muffin819/rune-dispatcher-be
Backend for Rune Dispatcher
https://github.com/muffin819/rune-dispatcher-be
airdrop bitcoin bitcoinjs dispatcher psbt rune
Last synced: 27 days ago
JSON representation
Backend for Rune Dispatcher
- Host: GitHub
- URL: https://github.com/muffin819/rune-dispatcher-be
- Owner: muffin819
- Created: 2024-10-23T09:42:49.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-12-07T15:25:07.000Z (about 1 month ago)
- Last Synced: 2024-12-07T16:23:45.519Z (about 1 month ago)
- Topics: airdrop, bitcoin, bitcoinjs, dispatcher, psbt, rune
- Language: TypeScript
- Homepage:
- Size: 134 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
---
# Runestone Dispatcher Backend
## Overview
The Runestone Dispatcher Backend is a server application that facilitates the distribution to many users of Runestone tokens. The backend is developed using Node.js and Express.js and includes API endpoints for various functionalities such as redeeming fees, estimating transaction fees, and managing different amounts for airdrops. The project also integrates Swagger UI for API documentation.
## Project Structure
## Installation
1. Clone the repository:
```
git clone https://github.com/leionion/rune-dispatcher-backend.git
cd rune-dispatcher-backend
```
2. Install dependencies:
```
yarn install
```
3. Create a `.env` file:
```
cp .env.example .env
```
4. Configure the environment variables in `.env` file:
```
PORT=your-port
```
## Usage
1. Start the server:
```
yarn dev
```
2. The server should be running on the specified port. You can visit `http://localhost:[PORT]` to check if the server is up and running.
3. Access the API documentation via Swagger UI at `http://localhost:[PORT]/api-docs`.
## API Endpoints
Here are some key API endpoints provided by the backend:
- **GET /**: Check if the backend server is running.
- **POST /api/redeem-fee**: Redeem Runestone fees.
- **POST /api/same-amount**: Handle airdrops with the same amount.
- **POST /api/different-amount**: Handle airdrops with different amounts.
- **POST /api/large-different-amount**: Handle large different amount airdrops.
- **POST /api/large-different-amount-airdrop**: Handle large airdrop transactions with different amounts.
- **POST /api/estimate/same-amount**: Estimate transaction fee for same amount airdrop.
- **POST /api/estimate/different-amount**: Estimate transaction fee for different amount airdrop.
## Middleware
- **CORS**: Cross-Origin Resource Sharing is enabled using the `cors` package.
- **Body-Parser**: JSON and URL-encoded data parsing with `body-parser` and `express.json`.
## Swagger
Swagger UI is integrated to provide interactive API documentation. The `swagger.yaml` file is required to configure API documentation, which can be accessed at `/api-docs`.
## Mutex
Mutex from `async-mutex` is used for API rate limit protection functionality.
## Global Variables
- `app.locals.walletIndex`: Global iterator for wallet management.
- `app.locals.iterator`: Global iterator for unisat API distribution.
## Swagger Usage
### Base URL
The base URL for the API is:
- Development: `http://localhost:5000/api`
- Production: `https://rune-dispatcher-backend.onrender.com/api`
### Endpoints
#### Different Amount Rune Airdrop
- **Description:** Transfer different amounts of Rune tokens to different addresses
- **Endpoint:** `/different-amount`
- **HTTP Method:** POST
#### Large Different Amount Rune Airdrop
- **Description:** Transfer different amounts of Rune tokens to different addresses (for a large number of addresses)
- **Endpoint:** `/large-different-amount`
- **HTTP Method:** POST
#### Large Different Amount Rune Airdrop (Execute)
- **Description:** Execute the large different amount Rune Airdrop with a pre-generated transaction ID
- **Endpoint:** `/large-different-amount-airdrop`
- **HTTP Method:** POST
#### Same Amount Rune Airdrop
- **Description:** Transfer the same amount of Rune tokens to different addresses
- **Endpoint:** `/same-amount`
- **HTTP Method:** POST
#### Calculate Runestone Transaction Fee
- **Description:** Calculate the fee for a runestone transaction
- **Endpoint:** `/runestone-fee`
- **HTTP Method:** GET
#### Estimate Different Amount Rune Airdrop
- **Description:** Estimate the different amount Rune
- **Endpoint:** `/estimate/different-amount`
- **HTTP Method:** POST
#### Estimate Same Amount Rune Airdrop
- **Description:** Estimate the same amount Rune
- **Endpoint:** `/estimate/same-amount`
- **HTTP Method:** POST
### Error Handling
In case of errors, the API responds with appropriate HTTP status codes along with error messages in the response body.