Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/degencap777/runeairdropbackend

The Rune Airdrop Backend that can airdrop runes to large amount of users keeping the most optimzed fee. it provides both of different amount's and same amount's rune token airdrop.
https://github.com/degencap777/runeairdropbackend

airdrop backend bitcoin bitcoinjs-lib postorder-traversal psbt runes runestone tree-structure typescript utxo

Last synced: 5 days ago
JSON representation

The Rune Airdrop Backend that can airdrop runes to large amount of users keeping the most optimzed fee. it provides both of different amount's and same amount's rune token airdrop.

Awesome Lists containing this project

README 

        
---



# Mystic Runestone Airdrop Tool Backend



## Overview



The Runestone Airdrop Backend is a server application that facilitates the airdrop 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



```

root/

├── config/

│   └── config.ts

├── routes

│   └── AirdropRoute

│        ├── different-amount.route.ts

│        ├── large-different-amount.route.ts

│        ├── large-different-amount-airdrop.route.ts

│        ├── same-amount.route.ts

│   └── EstimateRoute

│        ├── different-amount-estimate.route.ts

│        ├── same-amount-estimate.route.ts

│   └── SubRoute

│        └── runestone-fee.route.ts

├── service/

│   └── psbt/

│       ├── CreateAirdropRunestonePsbt.ts

│       ├── redeemRunestoneAmountRunestone.ts

│       ├── redeemRunestoneSameAmount.ts

│       ├── RuneOne.ts

│       ├── RuneSub.ts

│       └── SameAmountEstimate.ts

├── test/

│   ├── CreateTest.ts

│   ├── freeTierAirdrop.ts

│   ├── matchTests.ts

│   └── MWtests.ts

├── utils/

│   ├── blockcypher.api.ts

│   ├── mempool.api.ts

│   ├── TS

│   │   ├── mw.ts

│   │   └── TsUtils.ts

│   └── unisat.api.ts

├── .env.example

├── package.json

├── README.md

├── swagger.yaml

├── tsconfig.json

└── yarn.lock

env

```



## Installation



1. Clone the repository:



   ```

   git clone https://github.com/libraiger/runeAirdropBE

   cd rune-airdrop-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-airdrop-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 Airdrop

- **Endpoint:** `/estimate/different-amount`

- **HTTP Method:** POST



#### Estimate Same Amount Rune Airdrop



- **Description:** Estimate the same amount Rune Airdrop

- **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.

Contact me in 

Twitter: https://t.me/lovely_libra777 or 

Telegram: https://x.com/libraiger