Demo project for Final Project on Rootstock Dev Course
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
- Network: RSK Testnet
- Contract Address:
0x24a9f4ba13a490f7165725d311bb668814edb8d1 - Explorer Link: View on RSK Explorer
- Contract Verified: β
- β 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
AWAITING_PAYMENT β AWAITING_APPROVAL β COMPLETED
β EXPIRED
Happy Path (Success):
- Payer creates escrow with RBTC deposit
- Payer releases funds to contract
- Payer approves
- Payee approves
- Funds automatically sent to payee
Refund Path (Dispute/No Action):
- Payer creates escrow
- Payer releases funds
- Deadline passes (e.g., 7 days)
- Payer calls refund
- Funds returned to payer
-
Connect MetaMask to RSK Testnet
- Network: RSK Testnet
- Chain ID: 31
- RPC: https://public-node.testnet.rsk.co
-
Get tRBTC from faucet
- Visit RSK Faucet
- Enter your wallet address
- Request funds
-
Create an escrow
- Enter title, payee address, amount, deadline
- Confirm MetaMask transaction
-
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
-
Complete
- Funds automatically transfer to payee
- Status shows "Completed"
| 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 |
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
| Component | Technology |
|---|---|
| Smart Contract | Solidity 0.8.20 |
| Development | Hardhat |
| Frontend | React + Ethers.js |
| Wallet | MetaMask |
| Network | RSK Testnet |
# 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 frontend cd frontend npm start
| 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) |
| 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 |
- Contract Address:
0x24a9f4ba13a490f7165725d311bb668814edb8d1(RSK Testnet) - Explorer: View Contract
- GitHub: github.com/Rsync25/Split-Bill
For questions about this project, please reach out via the course platform.
- 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 π