KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #open-source #deepseek-harness #dsh-plugin #python #mcp

rh-flash-toolkit

★ 14 Open GitHub ↗

Foundry-based toolkit for Flash Loan (Morpho Blue) and Flash Swap (Uniswap V2) on RobinhoodChain (chainId 4663). Includes Solidity contracts, Foundry scripts, and standalone Python runner.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# rh-flash-toolkit

Foundry-based toolkit untuk **Flash Loan (Morpho Blue)** dan **Flash Swap (Uniswap V2)** di **RobinhoodChain** (chainId `4663`).

---

## 💸 Donate

If this helped you, support the dev:

- **EVM:** `0x9Cd42f217574aA4418C9C7a8770f2711401caFfd`
- **SOL:** `QWXyYvMnLsSLBqWTDVmSvnPK8TYMdozozNaEMpMhepo`

---

## 📊 Bagaimana Transfer Flow Kelihatan di Explorer

### Flash Swap (Uniswap V2)

![Flash Swap flow](https://raw.githubusercontent.com/FlipZ3ro/rh-flash-toolkit/main/docs/flash-swap.svg)

```
  Pair       ──── amount X token ────▶  Borrower   (loan sent)
  Borrower   ──── amount X * 1000/997 ──▶  Pair    (repay + 0.3% fee)

▶ Net cost: 0.3% dari amount (fee UniV2 hardcoded)
```

### Flash Loan (Morpho Blue)

![Flash Loan flow](https://raw.githubusercontent.com/FlipZ3ro/rh-flash-toolkit/main/docs/flash-loan.svg)

```
  Morpho     ──── amount X token ────▶  Borrower   (loan sent)
  Borrower   ──── amount X token ────▶  Morpho     (repay — exact same amount)

▶ Net cost: 0 (Morpho flash loan gratis — cuma bayar gas)
```

**Kunci:** UniV2 balik **lebih** (fee 0.3% hardcoded). Morpho balik **persis sama** (0 fee protocol).

---

## 📁 Struktur Project

```
rh-flash-toolkit/
├── src/                          Solidity contracts
│   ├── FlashSwap.sol             Uniswap V2 flash swap borrower
│   ├── MorphoFlash.sol           Morpho Blue flash loan borrower
│   └── FlashToolkit.sol          Combined helpers
├── script/                       Foundry deploy + exec scripts
│   ├── Deploy.s.sol
│   └── ExecFlashLoan.s.sol
├── test/
│   └── Flash.t.sol               Foundry tests
├── execute.py                    Standalone Python runner (no Foundry needed)
├── foundry.toml                  Foundry config
├── .env.example                  Config template
└── docs/                         Flow diagrams
    ├── flash-swap.svg
    └── flash-loan.svg
```

---

## 🚀 Quick Start

### Option A — Foundry (recommended)

```bash
# Install foundry kalau belum
curl -L https://foundry.paradigm.xyz | bash && foundryup

# Clone + setup
cd rh-flash-toolkit
cp .env.example .env
# edit .env: isi PRIVATE_KEY

# Build
forge build

# Deploy MorphoFlash + FlashSwap contracts
forge script script/Deploy.s.sol --rpc-url robinhood --broadcast
# → catat alamat kedua contract, masukin ke .env (MORPHO_FLASH_ADDR + FLASH_SWAP_ADDR)

# Run flash loan
forge script script/ExecFlashLoan.s.sol --rpc-url robinhood --broadcast
```

### Option B — Python standalone (no Foundry)

```bash
pip install web3 eth_account py-solc-x
cp .env.example .env  # edit PRIVATE_KEY

python execute.py deploy-morpho
python execute.py flash-loan USDG 1000000
python execute.py deploy-swap
python execute.py flash-swap 0.5
```

Lihat `SETUP-WINDOWS.md` untuk step-by-step Windows.

---

## 🧠 Perbedaan Inti

### Flash Swap (Uniswap V2)
- **Sumber:** pool AMM (pair token0/token1)
- **Mekanik:** `pair.swap(amountOut, 0, to, data)` dengan `data != ""` → pair kirim token, panggil callback `uniswapV2Call`, repay di akhir
- **Fee: WAJIB 0.3%** — hardcoded di `require(balance0Adjusted * balance1Adjusted >= reserve0 * reserve1 * 1000^2)`. Repay = `amount * 1000 / 997` (≈0.3009%)
- **Batas:** `amountOut < reserve` (ga bisa pinjam > likuiditas pool)

### Flash Loan (Morpho Blue)
- **Sumber:** lending protocol Morpho core
- **Mekanik:** `morpho.flashLoan(token, amount, data)` → Morpho kirim token, panggil `onMorphoFlashLoan`, `approve` balik, Morpho tarik via `transferFrom`
- **Fee: 0** — Morpho flash loan gratis, cuma bayar gas
- **Batas:** `amount <= balanceOf(morpho, token)` (total idle liquidity di Morpho)

---

## 🎯 Kapan Pakai Yang Mana

### ✅ Flash Swap COCOK untuk Arbitrase 2-pool

Karena kamu **udah butuh swap token** sebagai bagian strategi:
1. Pinjam token A dari pool 1 (via flash swap)
2. Jual di pool 2 dengan harga lebih tinggi
3. Balikin token A + fee 0.3% ke pool 1
4. **Sisa = profit**

Fee 0.3% "terbayar" karena arb spread biasanya > 0.3%. Flash swap = **swap + pinjaman jadi satu**, efisien untuk arb dua-pool. Tidak perlu modal awal, tidak perlu approve token dulu.

### ❌ Flash Swap TIDAK cocok untuk pinjam murni (non-swap)

Kalau cuma butuh "pinjam lalu balikin" tanpa aksi swap (self-liquidation, collateral swap, refinance), **fee 0.3% itu murni kerugian**. Tidak ada spread yang nutup.

### ✅ Flash Loan Morpho COCOK untuk pinjaman murni

**0 fee**, cocok untuk operasi yang tidak menghasilkan spread:
- **Self-liquidation** — tutup posisi sendiri sebelum kena likuidasi
- **Collateral swap** — ganti jaminan tanpa nutup posisi
- **Debt refinance** — pindah utang antar protocol
- **Leverage looping** — buka/tutup posisi leverage
- **Arbitrase juga bisa** — bahkan lebih untung karena 0 fee

### 🧭 Aturan Praktis

```
Butuh pinjam token + langsung swap di AMM    → Flash Swap (kalau ga ada 0-fee source)
Butuh pinjam murni / ada Morpho 0-fee        → Flash Loan (SELALU lebih murah)
```

Di **RobinhoodChain**, Morpho tersedia & **0 fee**, jadi untuk hampir semua kasus **Flash Loan Morpho menang** — kecuali arb yang spesifik butuh token yang cuma tersedia di UniV2 pool dan Morpho tidak punya token itu.

---

## 📌 Public Protocol Addresses (RobinhoodChain)

| Contract | Address |
|---|---|
| Morpho Blue core | `0x9D53d5E3bd5E8d4Cbfa6DB1ca238AEA02E651010` |
| Uniswap V2 factory | `0x8bCeAA40b9ACdFAEDF85Adf4FF01f5aD6517937f` |
| USDG token | `0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168` |
| WETH token | `0x0bd7d308f8e1639fab988df18a8011f41eacad73` |

**Verify di explorer:** `https://robinhoodchain.blockscout.com`

**RPC:** `https://rpc.mainnet.chain.robinhood.com` — chainId **4663**

---

## ⚠️ Disclaimer

Toolkit ini **experimental/educational**. Kode contract audited-informal aja — baca sendiri sebelum pakai modal besar. Flash loan/swap bisa gagal (revert) kalau logic dalam callback keliru — dan tetap kena biaya gas. **Test di small amount dulu** sebelum scale up.

---

## 📜 License

MIT — pakai sesuka hati, tapi kalau kepake buat cari cuan, pertimbangin donate 🙏 (address di atas).

rh-flash-toolkit

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README