A manifesto, in six parts
How Sunvasi works.
A field guide for the freelancer in Lagos and the client in Berlin. Read it straight through, or jump to a section.
01 — The parties
The parties.
Every Sunvasi contract is between two human parties and three on-chain roles you don't have to think about. The two humans are the Client and the Freelancer. The three on-chain roles are the Approver, the Release Signer, and the Dispute Resolver.
By default the Client is the Approver and the Release Signer (they say “done” and the funds go). The Dispute Resolver is Sunvasi's arbitrator — invoked only when the parties disagree, and constrained by the rules published on the arbitration page.
02 — The lifecycle
The lifecycle.
- DRAFT — you compose the contract.
- AWAITING FUNDING — the client receives the link.
- ACTIVE — funds are held in escrow on Stellar.
- COMPLETED — every milestone released.
- DISPUTED — the arbitrator is reviewing.
- RESOLVED — verdict applied, funds distributed.
03 — Milestones
Milestones.
A contract is a list of milestones. Each milestone has a title, a description, acceptance criteria, and an amount. The sum of milestones is the total budget; you can't fund the contract until they add up.
When the freelancer submits a milestone — files, links, a note — the milestone enters submitted. The client has the auto-release window (default seven days) to approve, request changes, or open a dispute.
04 — Auto-release
Auto-release.
Once a milestone is submitted, a countdown begins. If the client approves before the countdown ends, funds release immediately. If the countdown ends without action, funds release automatically. The default window is seven days; the freelancer sets the range (3–14 days) at contract creation and the client agrees by funding.
Auto-release is the most important feature of the system, because it removes the ghosting failure mode. A client who simply disappears does not strand the freelancer's payment.
05 — Disputes
Disputes.
Either party can dispute a submitted milestone. The dispute form asks three structured questions — what was promised, what was delivered, what's the gap — and accepts file uploads. The other side gets a parallel form.
The AI arbitrator then runs. It can ask one clarifying question of each party. It produces a transparent verdict — release X% to the freelancer, refund the rest — with reasoning a non-lawyer can read in under ninety seconds. If confidence is “insufficient,” no funds move and the dispute escalates to a human reviewer.
The verdict is signed on-chain by the Dispute Resolver and the milestone splits accordingly.
06 — Why this is trustless
Why this is trustless.
Sunvasi never holds the funds. The escrow is a non-custodial Stellar smart contract from Trustless Work. You can inspect the state of any contract via the Escrow Viewer link on its page. The rules the arbitrator follows are published on the arbitration page and version-hashed into every verdict, so old decisions remain reproducible.
When the system is in full agreement, no human at Sunvasi is in the loop. When the system requires a tie-break, the tie-breaker's rules are publicly auditable. That is what we mean by trustless.