https://github.com/amanraj1608/rebalancer-service
rebalance funds between ethereum mainnet and mantle chain
https://github.com/amanraj1608/rebalancer-service
Last synced: about 1 month ago
JSON representation
rebalance funds between ethereum mainnet and mantle chain
- Host: GitHub
- URL: https://github.com/amanraj1608/rebalancer-service
- Owner: AmanRaj1608
- Created: 2024-12-23T10:42:02.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-12-23T22:48:19.000Z (10 months ago)
- Last Synced: 2025-05-14T08:11:58.661Z (5 months ago)
- Language: TypeScript
- Homepage:
- Size: 48.8 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Rebalancer Service Architecture
A high-level implementation of a rebalancer service that automatically rebalances assets between ETH Mainnet and Mantle Chain using Socket/Bungee for bridging.
```mermaid
flowchart TD
A[Balance Monitor Service] -->|Watch| B[ETH Mainnet]
A -->|Watch| C[Mantle Chain]
A -->|Trigger| D[Rebalancing Service]
subgraph Rebalancing Service
D -->|Calculate| E[Price Service]
E -->|Get USD Values| F[CoinMarketCap API]
D -->|Execute| G[Transaction Service]
G -->|Bridge| H[Socket/Bungee API]
end
subgraph Transaction Flow
H -->|1. Get Quote| I[Socket Quote API]
I -->|2. Build Tx| J[Socket Build API]
J -->|3. Approve| K[Token Approval]
K -->|4. Bridge| L[Bridge Transaction]
L -->|5. Monitor| M[Bridge Status API]
end
subgraph State Management
N[Supabase DB] <-->|Track| D
N -->|Store| O[Operation Status]
O -->|Monitor| M
end
subgraph Notification System
D -->|Alert| P[Telegram Bot]
P -->|Send| Q[Admin Chat]
end
```
In this flow:
- Price based rebalancing: Using CMC API to calculate USD values for accurate rebalancing.
- Multi Step Bridging: Supports direct token bridging any token→ETH→token paths.
- Transaction Monitoring: Tracks bridge status and handles transaction failures
- State Management: Uses Supabase to track operation status and resume interrupted operations
- Admin Notifications: Telegram bot integration for monitoring and alerts
### Getting Started
Clone the repository and install dependencies. Add your .env file with the required keys.
```bash
git clone https://github.com/your-repo/rebalance-bot.git
cd rebalance-bot
cp .env.example .env
npm install
npm run dev
```
Or use Docker:
```bash
docker build -t rebalancer .
docker run -d --name rebalancer --env-file .env rebalancer
```
### Future Enhancements for Production
1. Smart Contract: Add support for smart contracts(safe) for rebalancing.
2. Fallback solutions: Implement (Symbiosis Bridge, Mantle Bridge, etc.) without relying solely on Bungee.
3. WebSockets: For tg bot instead of long-polling, which can fail in multi-server setups.
4. Use NestJS: better structuring of controllers, services.