https://github.com/bh2smith/safe-airdrop-agent
API Server that constructs a multi-asset transfer as a single Safe transaction from CSV file.
https://github.com/bh2smith/safe-airdrop-agent
Last synced: 11 months ago
JSON representation
API Server that constructs a multi-asset transfer as a single Safe transaction from CSV file.
- Host: GitHub
- URL: https://github.com/bh2smith/safe-airdrop-agent
- Owner: bh2smith
- Created: 2025-02-04T09:17:51.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-02T12:11:42.000Z (11 months ago)
- Last Synced: 2025-09-02T14:21:12.081Z (11 months ago)
- Language: TypeScript
- Homepage: https://safe-airdrop-agent.vercel.app
- Size: 599 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Safe Airdrop Agent
A Next.js project that provides an AI assistant for generating multi-asset-transfers for [Safe](https://safe.global) accounts. This agent performs equivalent functionality to the existing CSV Airdrop in the Safe App Store.
## Features
### Multisend Endpoint
`/api/multisend`
- Enables batch transfers of tokens (ERC20, ERC721, ERC1155) to multiple recipients
- Accepts CSV input as url reference to a google sheet or a plain csv file with the following format:
```csv
receiver,token_type,token_address,amount,id
0x123...,erc20,0xabc...,100,
0x456...,erc721,0xdef...,1,42
0x789...,erc1155,0xghi...,5,123
```
- Supports ENS resolution for receiver addresses
- Validates token addresses and transfer parameters
### Drain Safe Endpoint
`/api/drain-safe`
- Transfers all tokens from a Safe to a specified address
- Supports multiple token types:
- Native tokens (ETH)
- ERC20 tokens
- NFTs (ERC721 and ERC1155)
- Automatically detects and processes all token balances
## Getting Started
Run the development server:
```bash
bun dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser to access the API.