🚀 Zero-G Unstake

The Gasless Emergency Exit

Unstake your tokens with zero BNB in your wallet. Powered by EIP-7702 Account Abstraction on BSC.

🏆 BSC Hackathon 2025 — EIP-7702 Track

Zero-G Unstake is a novel rescue protocol that enables users to exit staking positions even when they have absolutely no native gas tokens (BNB) in their wallet. By leveraging EIP-7702's temporary EOA delegation, users can pay for gas using the very tokens they're unstaking.

❌ The Problem

The "Out of Gas" Trap

Imagine this scenario:

✅ You staked 1,000 USDT into a yield vault 30 days ago
✅ The lock period has expired — your tokens are ready to withdraw
❌ Your wallet has 0 BNB — you cannot pay gas fees
😰 You're stuck. Your valuable assets are locked, visible but unreachable.

This is a critical UX failure in DeFi:

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   💰 Your Wallet                                                │
│   ├── BNB Balance:    0.000 BNB                                 │
│   └── Staked USDT:    1,000 USDT (Ready to Unstake!)            │
│                                                                 │
│   ⛽ Gas Required:     0.001 BNB (~$0.60)                        │
│                                                                 │
│   ❌ RESULT: Cannot unstake. Assets trapped.                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Current workarounds are painful:

🔄 Ask a friend to send you BNB (trust + coordination required)
💱 Use a CEX to buy and withdraw BNB (KYC, fees, delays)
🌉 Bridge from another chain (complex, risky, slow)

There has to be a better way.

✅ The Solution

EIP-7702: Rescue-7702 Protocol

Zero-G Unstake introduces a paradigm shift using EIP-7702's account delegation:

"What if your EOA could temporarily become a smart account, unstake your tokens, and pay gas from the unstaked amount — all in one atomic transaction?"

The Magic of EIP-7702

EIP-7702 allows an Externally Owned Account (EOA) to temporarily delegate its execution logic to a smart contract. This means:

🔐 Your keys, your control — Only you can authorize the delegation
⚡ Temporary upgrade — Your EOA "borrows" smart contract capabilities
🔄 Atomic execution — Unstake + gas payment happens in one transaction
💸 Pay with what you have — Use your staked tokens to cover gas fees

🔧 How It Works

Step-by-Step Rescue Flow

┌──────────────────────────────────────────────────────────────────────────┐
│                                                                          │
│  STEP 1: User Authorization (Off-Chain)                                  │
│  ═══════════════════════════════════════                                 │
│                                                                          │
│  User signs an EIP-7702 authorization payload:                           │
│  • Delegates EOA logic → UnstakeDelegate contract                        │
│  • Specifies: vault address, token, expected amount                      │
│  • NO gas required — this is just a signature!                           │
│                                                                          │
├──────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  STEP 2: Relayer Submission (On-Chain)                                   │
│  ═══════════════════════════════════════                                 │
│                                                                          │
│  A Relayer bot picks up the authorization:                               │
│  • Bundles the EIP-7702 auth into a transaction                          │
│  • Pays the BNB gas fee upfront                                          │
│  • Submits to BSC Testnet                                                │
│                                                                          │
├──────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  STEP 3: Atomic Execution (On-Chain)                                     │
│  ════════════════════════════════════                                    │
│                                                                          │
│  The UnstakeDelegate logic executes FROM the user's EOA:                 │
│                                                                          │
│  ┌─────────────────────────────────────────────────────────────┐         │
│  │ 1. Call vault.unstake() ──────────────► Tokens released     │         │
│  │ 2. Receive ERC20 tokens ──────────────► Into user's EOA     │         │
│  │ 3. Calculate gas cost + fee ──────────► e.g., 5 USDT        │         │
│  │ 4. Transfer fee to Relayer ───────────► Relayer reimbursed  │         │
│  │ 5. Keep remaining tokens ─────────────► User's wallet       │         │
│  └─────────────────────────────────────────────────────────────┘         │
│                                                                          │
│  ALL STEPS ARE ATOMIC — If any step fails, everything reverts!           │
│                                                                          │
└──────────────────────────────────────────────────────────────────────────┘

The Result

Before	After
0 BNB	0 BNB (unchanged)
1,000 USDT (staked)	995 USDT (in wallet)
❌ Trapped	✅ Free!

The user paid ~5 USDT (gas + fee) and rescued 995 USDT — without ever holding BNB.

🏗️ Architecture Flow

                                    ┌─────────────────┐
                                    │   BSC TESTNET   │
                                    │   BLOCKCHAIN    │
                                    └────────▲────────┘
                                             │
                                             │ 3. Submit Tx
                                             │    (Pays Gas)
                                             │
┌──────────────┐   1. Sign Auth    ┌─────────┴─────────┐
│              │ ────────────────► │                   │
│     USER     │   (Off-Chain)     │     RELAYER       │
│   (0 BNB)    │                   │      (Bot)        │
│              │ ◄──────────────── │                   │
└──────────────┘   6. Success!     └───────────────────┘
       │                                     │
       │                                     │
       ▼                                     ▼
┌──────────────────────────────────────────────────────────────┐
│                        ON-CHAIN EXECUTION                    │
│  ┌────────────────────────────────────────────────────────┐  │
│  │                   User's EOA                           │  │
│  │            (Temporarily Upgraded via 7702)             │  │
│  │                         │                              │  │
│  │    ┌────────────────────▼────────────────────┐         │  │
│  │    │         UnstakeDelegate Logic           │         │  │
│  │    │  ┌────────────┐    ┌─────────────────┐  │         │  │
│  │    │  │  unstake() │───►│ Transfer Tokens │  │         │  │
│  │    │  │  from Vault│    │ (User + Relayer)│  │         │  │
│  │    │  └────────────┘    └─────────────────┘  │         │  │
│  │    └─────────────────────────────────────────┘         │  │
│  └────────────────────────────────────────────────────────┘  │
│                              │                               │
│              ┌───────────────┴───────────────┐               │
│              ▼                               ▼               │
│     ┌─────────────────┐             ┌─────────────────┐      │
│     │   Staking Vault │             │   ERC20 Token   │      │
│     │   (Releases $)  │             │   (USDT/etc)    │      │
│     └─────────────────┘             └─────────────────┘      │
└──────────────────────────────────────────────────────────────┘

⭐ Key Features

🔄 Atomic Execution

Every step — from unstaking to relayer reimbursement — happens in a single, atomic transaction. If any part fails, the entire operation reverts. Your funds are never at risk of being partially processed.

⏱️ No Cool-Down Required

Unlike traditional meta-transaction solutions that require pre-setup or session keys, Zero-G Unstake works instantly. Sign once, rescue immediately.

⛽ True Gas Abstraction

Users don't just "defer" gas payment — they pay with a different asset entirely. No BNB needed, ever. The gas cost is deducted from the unstaked tokens.

🔐 Non-Custodial & Trustless

Private keys never leave the user's device
The Relayer cannot steal funds (atomic execution ensures fair reimbursement)
EIP-7702 delegation is temporary and scoped

💱 Automatic Fee Calculation

The delegate contract calculates the real-time gas cost (in BNB) and converts it to the equivalent token amount plus a small service fee. Transparent and fair.

🌐 BSC Testnet Ready

Built and tested on BSC Testnet with full EIP-7702 support. Ready for mainnet deployment post-audit.

📜 Smart Contracts

Contract	Description
`MockERC20.sol`	Test token for simulating staked assets
`StakingVault.sol`	Simple time-locked staking vault
`UnstakeDelegate.sol`	Core EIP-7702 delegate logic for rescue operations
`Relayer.sol`	(Optional) On-chain relayer registry and fee management

🚀 Getting Started

Prerequisites

Foundry installed
Node.js v18+ (for Viem scripts)
BSC Testnet BNB (for relayer operations)

Installation

# Clone the repository
git clone https://github.com/your-team/zero-g-unstake.git
cd zero-g-unstake

# Install Foundry dependencies
forge install

# Install Node.js dependencies
npm install

Build & Test

# Compile contracts
forge build

# Run tests
forge test -vvv

# Deploy to BSC Testnet
forge script script/Deploy.s.sol --rpc-url $BSC_TESTNET_RPC --broadcast

Run the Relayer

# Start the relayer bot
npx ts-node scripts/relayer.ts

🛣️ Features & Roadmap

✅ Core Features (Complete)

Core concept & architecture design
Smart contract implementation (ZeroGToken, StakingVault, UnstakeDelegate)
Comprehensive Foundry test suite (14 tests passing)
Viem-based relayer with EIP-7702 support
Sepolia Testnet deployment & demo

✅ Bonus Features (Complete)

MEV-Safe Execution - Transactions routed through Flashbots/MEV Blocker
Auto-Unstake Bot - Monitors users and auto-rescues when lock expires
One-Click Frontend - React/Next.js UI with ConnectKit wallet integration

🚀 Quick Start

Prerequisites

Foundry installed
Node.js v18+ (for Viem scripts)
Sepolia Testnet ETH (for relayer operations)

Installation

# Clone the repository
git clone https://github.com/Shubhojit-17/Zero-G_Unstake.git
cd Zero-G_Unstake

# Install Foundry dependencies
forge install

# Install Node.js dependencies
npm install

Build & Test

# Compile contracts
forge build

# Run tests
forge test -vvv

Run Demo

# Copy and configure environment
cp .env.example .env
# Edit .env with your keys

# Run the full demo
npx tsx scripts/demo.ts

Start Frontend

cd frontend
npm install
npm run dev

Start Auto-Unstake Bot

# Register users for auto-rescue
npx tsx scripts/autoUnstakeBot.ts register <user-address>

# Start the bot
npx tsx scripts/autoUnstakeBot.ts start

📦 Deployed Contracts (Sepolia)

Contract	Address
ZeroGToken	`0xACDca6c55F4CBA946763413854341b9E5556212A`
StakingVault	`0x5085d1DD5FbDA9166094C3a3dc41dea7Df8fD9e7`
UnstakeDelegate	`0x8ca2A267D31989FE05111cd46326AFA6971607AF`

🤝 Team

Built with ❤️ for the BSC EIP-7702 Hackathon 2025

📄 License

MIT License — See LICENSE for details.

Zero-G Unstake — Because your tokens shouldn't be held hostage by gas fees.

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
Logo		Logo
frontend		frontend
lib		lib
script		script
scripts		scripts
src		src
test		test
.env.example		.env.example
.gitignore		.gitignore
.gitmodules		.gitmodules
ABOUT_PROJECT.md		ABOUT_PROJECT.md
DEPLOYMENT.md		DEPLOYMENT.md
README.md		README.md
TEST.md		TEST.md
foundry.lock		foundry.lock
foundry.toml		foundry.toml
package-lock.json		package-lock.json
package.json		package.json
tech_stack.md		tech_stack.md
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

🚀 Zero-G Unstake

The Gasless Emergency Exit

🏆 BSC Hackathon 2025 — EIP-7702 Track

📋 Table of Contents

❌ The Problem

The "Out of Gas" Trap

✅ The Solution

EIP-7702: Rescue-7702 Protocol

The Magic of EIP-7702

🔧 How It Works

Step-by-Step Rescue Flow

The Result

🏗️ Architecture Flow

⭐ Key Features

🔄 Atomic Execution

⏱️ No Cool-Down Required

⛽ True Gas Abstraction

🔐 Non-Custodial & Trustless

💱 Automatic Fee Calculation

🌐 BSC Testnet Ready

📜 Smart Contracts

🚀 Getting Started

Prerequisites

Installation

Build & Test

Run the Relayer

🛣️ Features & Roadmap

✅ Core Features (Complete)

✅ Bonus Features (Complete)

🚀 Quick Start

Prerequisites

Installation

Build & Test

Run Demo

Start Frontend

Start Auto-Unstake Bot

📦 Deployed Contracts (Sepolia)

🤝 Team

📄 License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages