University of Management & Technology (UMT), Lahore  ·  Colosseum Frontier Hackathon  ·  Superteam Pakistan
🧠

How FreelancePay Works

Explained so simply that even a 10-year-old could understand it.
No jargon. No fluff. Just the idea.

💡

The Big Idea in One Sentence

A client locks money in a digital safe box, a freelancer delivers the work, and the money is released automatically — no bank, no PayPal, no middleman, no delays.

Step by Step

Each step has a simple version and a slightly more detailed version.

🤝
ClientStep 1

Client hires a freelancer

SIMPLE VERSION

Imagine you want someone to build you a website. You find a freelancer and agree on a price — let's say 1 SOL.

TECHNICAL VERSION

The client creates an escrow contract on FreelancePay, enters the freelancer's wallet address and the agreed amount.

🔒
Money gets lockedStep 2

SOL is locked in a safe box

SIMPLE VERSION

Instead of paying the freelancer right away (what if they disappear?), the money goes into a digital safe box on Solana. Nobody can touch it — not even you.

TECHNICAL VERSION

The SOL is transferred into a Program Derived Account (PDA) — a smart contract vault that only releases funds when both parties complete their role.

✍️
FreelancerStep 3

Freelancer does the work

SIMPLE VERSION

The freelancer builds the website. When done, they press 'Submit Work' and write what they delivered — like a GitHub link or a description. This gets saved on Solana forever.

TECHNICAL VERSION

The freelancer calls the submit_work instruction, recording their delivery note permanently on-chain. The escrow status changes from Active → Submitted.

ClientStep 4

Client checks and approves

SIMPLE VERSION

You look at the work. Happy with it? Click 'Approve'. The money instantly flies from the safe box straight into the freelancer's wallet. Done!

TECHNICAL VERSION

The client calls approve_work. The smart contract closes the escrow account and transfers the full SOL balance to the freelancer's wallet in the same transaction.

↩️
ClientStep 5

Or cancel if needed

SIMPLE VERSION

If the freelancer never starts the work and the status is still Active, the client can cancel and get their money back. No loss.

TECHNICAL VERSION

The client calls cancel_escrow. The contract closes and refunds the full SOL to the client's wallet. This only works before the freelancer submits.

The Flow at a Glance

🔒
Client creates escrow
✍️
Freelancer submits work
Client approves
SOL sent instantly

Common Questions

Q.What if the freelancer disappears after I pay?

A.You never actually 'pay' the freelancer upfront. Your SOL goes into the smart contract safe box. If the freelancer never submits work, you can cancel and get it all back.

Q.What if the client refuses to approve even after I deliver?

A.This version is a learning/hackathon project. In a full production version, a dispute system or time-based auto-release would handle this. For now, both parties should agree before creating the escrow.

Q.Is this real money?

A.Not right now. The app runs on Solana Devnet — a test environment where SOL has no real value. You can get free devnet SOL from faucet.solana.com to test it out.

Q.What is a smart contract?

A.Think of it as a vending machine. You put money in, press a button, and the machine automatically gives you the snack — no human needed. A smart contract works the same way: rules are written in code, and it executes automatically when conditions are met.

Q.What is Solana?

A.Solana is a blockchain — a public digital ledger that thousands of computers around the world share. Transactions on Solana take less than 2 seconds and cost almost nothing (fractions of a cent).

🚀

Ready to try it?

The app runs on Solana Devnet — free test SOL, no real money involved.

I'm a ClientI'm a Freelancer