A secure freelance marketplace for the Pi Network ecosystem — Architecture, Security and Escrow Transaction Flows
WorkPiServ is a secure freelance marketplace for the Pi Network ecosystem, allowing Pioneers to exchange professional services in Pi in a transparent and secure way.
The platform rests on three core pillars:
| Wallet | Definition | Control |
|---|---|---|
| Native Pi Wallet | The original wallet in the Pi Network app where the Pioneer receives their mined Pi | Pi Network exclusively |
| Internal Balance (Ledger) | An accounting entry kept by WorkPiServ for each Pioneer — not a blockchain wallet, only a number in a database representing what is owed to them | WorkPiServ platform |
Not that of the Pioneer's native Pi wallet,
nor that of any other wallet declared on the platform.
WorkPiServ stores only the public Pi address — never private data.
| Data | Stored? | Reason |
|---|---|---|
| Public Pi address | ✓ YES | To send/receive Pi |
| Seed phrase (native wallet) | ✗ NEVER | Exclusively owned by the Pioneer |
| Seed phrase (any other wallet) | ✗ NEVER | WorkPiServ has no access to it |
| Private key | ✗ NEVER | Exclusively owned by the Pioneer |
| WPS internal balance | ✓ YES | Platform escrow management |
| WPS transaction history | ✓ YES | Audit and transparency |
Two kinds of movement coexist in this flow: real blockchain transactions ⛓️ (the Pi physically move) and internal accounting entries 📒 (a number simply changes in the WorkPiServ ledger; no Pi move).
CLIENT (native Pi Network wallet)
│
│ ⛓️ BLOCKCHAIN TRANSACTION — Pi Browser SDK
▼
╔═══════════════════════════════════════════╗
║ SINGLE ON-CHAIN WORKPISERV WALLET ║
║ (the only real wallet) ║
║ The Pi of ALL Pioneers pass through it ║
╚═══════════════════════════════════════════╝
│
│ 📒 LEDGER ENTRY (no Pi move)
│ Client internal balance: +10 π available
▼
ORDER — Purchase of a 2 π service
│
│ 📒 LEDGER ENTRY
│ Client balance: -2 π → Escrow locked: +2 π
▼
WORKPISERV ESCROW [2 π locked — still in the single wallet]
│
│ 📒 Client validates ✅ (LEDGER ENTRY)
│ Freelancer internal balance: +1.8 π (90%)
│ WPS commission balance : +0.2 π (10%)
▼
🛡️ SAFETY PERIOD — 15 DAYS
(Pi still physically in WorkPiServ's single wallet)
│
│ ⛓️ BLOCKCHAIN TRANSACTION — Real A2U payment
▼
NATIVE Pi Network WALLET — Freelancer
(address set in their profile)
WorkPiServ applies a 15-day period between the validation of an order and the availability of withdrawal. This is not a technical constraint — it is a design choice that protects both the freelancer and the client against late disputes, and it sits in the same range as industry standards:
| Platform | Safety period |
|---|---|
| Fiverr (new seller) | 14 days after approval |
| Fiverr (Top Rated seller) | 7 days after approval |
| Upwork (fixed-price) | 5 days after approval |
| Upwork (hourly) | 10 days after the billed week |
| WorkPiServ | 15 days after validation |
Golden rule of escrow: WorkPiServ's single wallet physically holds the Pi of all Pioneers (available balances + active escrow). The internal ledger keeps the exact record of what belongs to whom. An automatic reconciliation periodically (every 6 hours) checks that the wallet holds at least as much Pi as the sum of all promised balances — see section 6.3.
| Status | Description | Next action |
|---|---|---|
pending | Pi received in escrow | Freelancer delivers the service |
delivered | Service delivered by the freelancer | Client validates or opens a dispute |
completed | Client validates — payment released | 90% freelancer / 10% WPS |
completed + safety period | 🛡️ Funds credited to the freelancer's ledger, locked for 15 days | Withdrawal available after the period |
disputed | Dispute opened by the client | WorkPiServ arbitrates |
refunded | Refund granted | Pi returned to the client |
| Flow | Amount | Destination |
|---|---|---|
| Service price (total) | 100% | WorkPiServ escrow (locked) |
| WorkPiServ commission | 10% | WorkPiServ operating wallet |
| Freelancer payment | 90% | Freelancer's WPS internal wallet |
Service ordered: 2 π │ ├──▶ 0.2 π ──▶ WorkPiServ (10% commission) └──▶ 1.8 π ──▶ Freelancer (90% payment) Client: 10 π - 2 π = 8 π left on WPS wallet
Login to WorkPiServ is handled exclusively by the Pi Network SDK. WorkPiServ receives only the strictly necessary data.
| Data received by WPS | Via SDK? | Sensitive? |
|---|---|---|
| Pioneer uid | YES | No |
| Pi username | YES | No |
| Public Pi address | YES | No (public by nature) |
| Seed phrase | NEVER | YES — stays with the Pioneer |
| Private key | NEVER | YES — stays with the Pioneer |
Since version 1.1, WorkPiServ includes an always-on fraud detection engine and a periodic solvency reconciliation system.
Before using the platform, every Pioneer must explicitly accept the Terms through a versioned consent gate, available in French, English and Arabic (with native RTL support for Arabic). WorkPiServ also provides dedicated Privacy, Terms of Use and Cookies pages, translated into the same languages.
Communication between buyer and provider takes place directly within the platform, before, during and after the order — without ever leaving the secure WorkPiServ environment.
WorkPiServ is available in 5 languages to reach the whole global Pi Network community:
Pioneers, your turn: try WorkPiServ with small amounts and share your feedback at WorkPiServ@gmail.com. Every comment helps us improve the platform.