Decentralized Freelance Work Management on the Sui Blockchain
Try the App Β· View Docs Β· Report a Bug
- About the Project
- Features
- Architecture
- Tech Stack
- Smart Contract
- Frontend
- Mobile App
- Installation
- Usage
- Security
- License
WorkSeal is a fully decentralized work management platform that secures agreements between freelancers and clients using blockchain technology. Powered by smart contracts written on the Sui blockchain, it provides payment security, transparent job tracking, and independent dispute resolution β with no intermediaries required.
| Traditional Platforms | WorkSeal |
|---|---|
| 5β20% commission fee | Zero platform commission |
| Subject to platform rules | Contract rules are immutable |
| Payments can be delayed | Instant, automatic payment upon approval |
| Platform acts as arbitrator | Independent, on-chain arbitration system |
| Data stored on central servers | All data lives on the Sui blockchain |
- The client locks payment into the contract; no payment is released until the freelancer delivers.
- Separate approval and payment flow for each milestone.
- All transactions are recorded immutably on-chain.
- Contracts can be created with multiple milestones.
- Each milestone has its own title and SUI amount.
- Freelancers can attach a proof link and notes for each milestone.
- If the client approves, payment is released instantly; if rejected, the freelancer can resubmit.
- When a dispute is raised, an arbitrator is automatically assigned from the on-chain arbitrator pool.
- The arbitrator has separate private messaging channels with both the client and freelancer.
- Upon resolution, the arbitrator receives a 2% commission; the remainder goes to the winning party.
- Either the admin or the assigned arbitrator can finalize the dispute.
- A group chat accessible to all parties.
- Private channel between the arbitrator and the client.
- Private channel between the arbitrator and the freelancer.
- All messages are stored on-chain with timestamps.
- zkLogin with Google β no wallet required, sign in with one tap.
- Real-time balance display and SUI transfers.
- Full dark mode and multi-language support.
- Connect with any Sui wallet via dapp-kit.
- Create and manage contracts.
- Live job listing and discovery page.
- Escrow, invoice, and dispute management panels.
WorkSeal
βββ contracts/ # Sui Move smart contracts
β βββ sources/
β β βββ contracts.move # Main WorkSeal module
β βββ tests/
β βββ contracts_tests.move
β
βββ frontend/ # Next.js 16 web application
β βββ src/
β βββ app/ # App Router pages
β β βββ (app)/ # Dashboard, contracts, escrow, disputes...
β β βββ connect/
β βββ components/ # Reusable UI components
β βββ hooks/ # useContracts, useContractDetails...
β βββ contexts/ # Notifications and global state
β βββ config/ # Constants and network settings
β βββ types/ # TypeScript type definitions
β
βββ mobile/ # Expo React Native application
βββ app/
β βββ (tabs)/ # Main tabs (dashboard, wallet, profile...)
β βββ contracts/ # Contract detail screens
β βββ wallet/ # Wallet operations
βββ components/ # AppBackground, ContractCard, TabBar...
βββ constants/ # config.ts, theme.ts, translations.ts
βββ lib/ # zklogin, wallet-store, sui-tx, sui-client
βββ hooks/ # Custom React hooks
[User]
β
ββββ Web (Next.js) βββΊ @mysten/dapp-kit βββΊ Sui RPC
β
ββββ Mobile (Expo) βββΊ zkLogin (Google) βββΊ Sui RPC
β
Enoki Prover API
(ZK Proof generation)
β
[WorkSeal Move Contract]
Sui Testnet Blockchain
| Technology | Version | Description |
|---|---|---|
| Move | 2024 Edition | Sui's native smart contract language |
| Sui Framework | latest | Object model, coin, and event system |
| Technology | Version | Description |
|---|---|---|
| Next.js | 16.2.4 | React-based full-stack framework |
| React | 19.2.4 | UI library |
| TypeScript | ^5 | Type-safe development |
| TailwindCSS | ^4 | Utility-first CSS |
| @mysten/dapp-kit | ^1.0.4 | Sui wallet integration |
| @mysten/sui | ^2.16.0 | Sui SDK |
| TanStack Query | ^5.99.0 | Server state management |
| shadcn/ui | ^4.3.0 | Component library |
| React Hook Form | ^7.72.1 | Form management |
| Zod | ^4.3.6 | Schema validation |
| Lucide React | ^1.8.0 | Icon set |
| Technology | Version | Description |
|---|---|---|
| Expo | ~54.0.0 | React Native development platform |
| React Native | 0.81.5 | Cross-platform mobile framework |
| Expo Router | ~6.0.23 | File-based routing |
| @mysten/enoki | ^1.0.8 | Enoki service for zkLogin |
| @mysten/sui | ^1.3.0 | Sui SDK |
| Zustand | ^4.5.2 | Global state management |
| i18next | ^23.10.1 | Multi-language support |
| React Native Reanimated | ~4.1.1 | Animation engine |
| WalletConnect | ^2.23.9 | Sui wallet connection infrastructure |
| Expo Secure Store | ~15.0.8 | Secure local storage |
The WorkSeal contract is deployed on Sui Testnet at 0x347761a22dd046d6c4b34b17a35fe388c644c8315bf5830d28bcf9429c4c4e86.
[0] Created βββΊ [1] Active (Funded) βββΊ [2] Completed
β
ββββΊ [3] Disputed βββΊ [2] Resolved
β
ββββΊ [4] Cancelled
| Function | Authorized By | Description |
|---|---|---|
create_contract |
Anyone | Creates a new work contract |
fund_contract |
Client | Funds the contract (escrow) |
take_job |
Freelancer | Claims the job |
submit_milestone |
Freelancer | Submits milestone proof |
approve_and_release_funds |
Client | Approves and releases payment |
reject_milestone |
Client | Rejects proof; allows resubmission |
raise_dispute |
Either party | Opens a dispute; arbitrator is assigned |
resolve_dispute_arbitrator |
Arbitrator | Finalizes the dispute |
resolve_dispute_admin |
Admin | Finalizes the dispute with admin authority |
cancel_contract |
Client | Cancels an unfunded or unassigned contract |
send_message |
All parties | Sends a group message |
send_private_message |
Arbitrator / Parties | Sends a private message |
resume_contract_arbitrator |
Arbitrator | Resumes a paused contract |
register_arbitrator |
Admin | Registers a new arbitrator |
| Event | Triggered When |
|---|---|
ContractCreatedEvent |
A contract is created |
ContractFundedEvent |
Escrow is funded |
PaymentReleasedEvent |
A milestone payment is released |
MilestoneRejectedEvent |
A milestone is rejected |
DisputeRaisedEvent |
A dispute is opened |
DisputeResolvedEvent |
A dispute is resolved |
ArbitratorAssignedEvent |
An arbitrator is assigned |
ContractCancelledEvent |
A contract is cancelled |
ContractResumedEvent |
A contract is resumed |
A web application built with Next.js 16 using the App Router. Connects to Sui wallets via @mysten/dapp-kit.
| Route | Description |
|---|---|
/ |
Landing page β project overview and live job counter |
/connect |
Wallet connection |
/(app)/dashboard |
User summary and overview |
/(app)/contracts |
Contract list and management |
/(app)/explore |
Open job listings and discovery |
/(app)/escrow |
Escrow management |
/(app)/disputes |
Disputes and arbitrator panel |
/(app)/invoices |
Invoice and payment history |
/(app)/arbitrator |
Arbitrator management panel |
/(app)/profile |
User profile |
cd frontend
npm install
npm run devThe app starts at http://localhost:3000.
A mobile application built with Expo SDK ~54, supporting both iOS and Android.
Users can sign in with their Google account without needing a crypto wallet. Under the hood:
- An Ed25519 ephemeral keypair and nonce are generated.
- A JWT is obtained via Google OAuth.
- A ZK proof is requested from Mysten Labs' Enoki Prover.
- A deterministic Sui address is derived for the user.
- All session data is securely stored using
expo-secure-store.
| Screen | Description |
|---|---|
login.tsx |
Google zkLogin sign-in flow |
dashboard.tsx |
Active contracts and summary cards |
contracts.tsx |
Contract list, creation, and detail view |
wallet.tsx |
Balance, transfers, and testnet faucet |
explore.tsx |
Open job listings and job application |
profile.tsx |
User profile and settings |
invoices.tsx |
Invoice history |
support.tsx |
Support and FAQ |
cd mobile
npm install
# For Android
npm run android
# For iOS (requires macOS)
npm run ios
# Preview with Expo Go
npm startNote: An
expo-go.apkfile is included in the project. Install it on your Android device to quickly test the app.
- Node.js >= 18
- Sui CLI (for contract deployment)
- Expo CLI (for mobile)
- Android Studio or Xcode (for emulator instead of physical device)
git clone https://github.com/salihtore/WorkSeal.git
cd WorkSealcd contracts
sui move build
sui move testTo deploy the contract to Sui Testnet:
sui client publish --gas-budget 100000000cd frontend
npm install
npm run devcd mobile
npm install
npm start- Connect β Link your wallet (web or mobile).
- Create a Contract β Define the job title, description, deadline, and milestones.
- Fund β Transfer the total budget to escrow (SUI).
- Review Milestones β Evaluate the proof submitted by the freelancer.
- Approve / Reject β Approving releases payment automatically; rejecting prompts a resubmission.
- Raise a Dispute β If there's a disagreement, an on-chain arbitrator steps in.
- Explore β Browse and filter open jobs.
- Claim the Job β Call
take_jobon the contract of your choice. - Submit Milestones β Add a proof link and notes for each phase.
- Get Paid β SUI is automatically transferred to your balance as the client approves each milestone.
- You are automatically assigned when a dispute is opened.
- You can communicate privately with each party in separate channels.
- After reviewing, determine the winner; a 2% commission is automatically sent to your account.
- Escrow Guarantee: Payment is only released upon client approval; funds are never lost.
- Authorization Checks: Every function verifies the sender's address (
ENotAuthorized). - Double-Payment Protection: The
is_paidflag prevents the same milestone from being paid twice. - Cancellation Rules: Only unfunded or unassigned contracts can be cancelled; otherwise cancellation is blocked (
ECancelNotAllowed). - Nonce Verification: The Google JWT nonce is cryptographically verified during the zkLogin flow.
- Secure Storage: Mobile session data is encrypted using
expo-secure-store.
This project is licensed under the MIT License. See the LICENSE file for details.
WorkSeal β Lock Your Freelance Work into the Chain π
Built on the power of the Sui blockchain