Simple Escrow with Split Bill🔒

Demo project for Final Project on Rootstock Dev Course

📋 Project Overview

Simple Escrow is a minimal, educational smart contract that demonstrates time-based escrow - a fundamental blockchain primitive where funds are held until both parties approve OR a deadline passes for refund.

Core Primitive: Time-based state machine with multi-party approval

Key Concept: Funds are held in the contract until:

• ✅ Both parties approve (success) → funds go to payee
• ⏰ Deadline passes without full approval → payer gets refund

---

📍 Contract Deployment

• Network: RSK Testnet
• Contract Address:0x24a9f4ba13a490f7165725d311bb668814edb8d1
• Explorer Link:View on RSK Explorer
• Contract Verified: ✅

---

✅ Features

• ✅ Smart contract deployed on RSK Testnet
• ✅ Create escrow with single payee
• ✅ Deposit RBTC to escrow
• ✅ Release funds to approval state
• ✅ Approve from both parties (payer + payee)
• ✅ Automatic completion when both approve
• ✅ Refund after deadline passes

---

🔄 How It Works

State Machine:

AWAITING_PAYMENT → AWAITING_APPROVAL → COMPLETED
↘ EXPIRED

User Flows:

Happy Path (Success):

1. Payer creates escrow with RBTC deposit
2. Payer releases funds to contract
3. Payer approves
4. Payee approves
5. Funds automatically sent to payee

Refund Path (Dispute/No Action):

1. Payer creates escrow
2. Payer releases funds
3. Deadline passes (e.g., 7 days)
4. Payer calls refund
5. Funds returned to payer

---

🧪 How to Test

1. Connect MetaMask to RSK Testnet

   • Network: RSK Testnet
   • Chain ID: 31
   • RPC: https://public-node.testnet.rsk.co

2. Get tRBTC from faucet

   • Visit RSK Faucet
   • Enter your wallet address
   • Request funds

3. Create an escrow

   • Enter title, payee address, amount, deadline
   • Confirm MetaMask transaction

4. Release and approve

   • Click "Release" to move funds to approval state
   • Approve from payer account
   • Switch to payee account in MetaMask
   • Approve from payee account

5. Complete

   • Funds automatically transfer to payee
   • Status shows "Completed"

---

🎯 Why This Design?

Design Choice	Reason
Two parties only	Clear responsibility, easier to understand
4-state machine	Complete coverage of all scenarios
Separate release & approve	Explicit intent, safety net
Time-based refund	No external oracles needed
No DeFi features	Focus on one primitive, matches feedback

---

📁 Project Structure

split-bill/
├── contracts/
│ └── SimpleEscrow.sol # ~120 lines - core escrow logic
├── frontend/
│ └── src/
│ ├── App.js # React frontend
│ └── abis/
│ └── SimpleEscrow.json
├── scripts/
│ └── deploy.js # Deployment script
├── test/
│ └── SimpleEscrow.test.js
├── hardhat.config.js
└── package.json

---

🛠 Tech Stack

Component	Technology
Smart Contract	Solidity 0.8.20
Development	Hardhat
Frontend	React + Ethers.js
Wallet	MetaMask
Network	RSK Testnet

---

🚀 Run Locally

# Clone repository
git clone https://github.com/Rsync25/Split-Bill.git
cd Split-Bill
# Install dependencies
npm install
cd frontend && npm install &&cd ..
# Compile contracts
npx hardhat compile
# Deploy to RSK Testnet
npx hardhat run scripts/deploy.js --network rskTestnet
# Run frontendcd frontend
npm start

---

📊 Rules Enforced

Rule	How It's Enforced
Only payer can create/release/refund	require(msg.sender == escrow.payer)
Only payer/payee can approve	require(msg.sender == payer OR payee)
Cannot approve twice	require(!escrow.payerApproved)
Cannot approve before release	State must be AWAITING_APPROVAL
Refund only after deadline	require(block.timestamp > deadline)

---

📝 Capstone Requirements

Requirement	How This Project Meets It
One clear primitive	Time-based escrow state machine
Not product-oriented	Focuses on mechanism, not platform
Educational value	Demonstrates state management, time-based logic
Complete but simple	4 states, 5 functions, ~120 lines
Demo-friendly	2-minute walkthrough shows both paths
Deployed on RSK	Testnet deployment verified

---

🔗 Links

• Contract Address:0x24a9f4ba13a490f7165725d311bb668814edb8d1 (RSK Testnet)
• Explorer:View Contract
• GitHub:github.com/Rsync25/Split-Bill

---

📞 Contact

For questions about this project, please reach out via the course platform.

---

Tests sucessful!

• Test 2: https://explorer.testnet.rootstock.io/tx/0xc41469de1dd271f979c5b708beec6964c12cbb32982476e8c5d848d8722aba60
• Test 1: https://explorer.testnet.rootstock.io/tx/0x52f531083003ae27a6a72df45e7916d40398689f6a2f30e89fcf97754c0f24a7

Made for RSK Developer Course Capstone Project 🚀

---