Bridge
Request human help for physical-world tasks. Bridge verifies the work was done before releasing payment.
Start the server
uvicorn bridge.app:app --port 8015
Create a task with verification criteria
curl -s -X POST http://localhost:8015/v1/tasks \
-H "Content-Type: application/json" \
-d '{
"description": "Pick up package at 123 Main St, photograph it",
"budget_usdc": "25.00",
"verification_criteria": [
{"type": "gps_proof", "description": "At pickup location", "params": {"latitude": 37.7749, "longitude": -122.4194, "radius_m": 100}},
{"type": "photo_proof", "description": "Photo of package", "params": {"min_photos": 1}}
]
}' | jq
Escrow is locked automatically. Fee is 5% of budget.
Submit proof and verify
curl -s -X POST http://localhost:8015/v1/tasks/TASK_ID/verify \
-H "Content-Type: application/json" \
-d '{
"worker_id": "worker-1",
"proofs": [
{"type": "gps_proof", "data": {"latitude": 37.7749, "longitude": -122.4194}},
{"type": "photo_proof", "data": {"photo_hashes": ["sha256:abc123"]}}
]
}' | jq
If ALL criteria pass → escrow released. If any fail → escrow held.
Dispute a task
curl -s -X POST http://localhost:8015/v1/tasks/TASK_ID/dispute \
-H "Content-Type: application/json" \
-d '{"reason": "GPS proof appears faked"}' | jq
Freezes escrow. No verification possible while disputed.
Milestone-based tasks (partial payment)
curl -s -X POST http://localhost:8015/v1/tasks \
-H "Content-Type: application/json" \
-d '{
"description": "Two-step delivery",
"budget_usdc": "100.00",
"milestones": [
{"description": "Pick up", "budget_pct": 40, "criteria": [{"type": "gps_proof", "description": "At pickup", "params": {"latitude": 37.77, "longitude": -122.42, "radius_m": 100}}]},
{"description": "Deliver", "budget_pct": 60, "criteria": [{"type": "photo_proof", "description": "Photo", "params": {"min_photos": 1}}]}
]
}' | jq
Verify milestones individually — each releases its share of the budget:
curl -s -X POST http://localhost:8015/v1/tasks/TASK_ID/verify-milestone \
-H "Content-Type: application/json" \
-d '{"worker_id": "w", "milestone_index": 0, "proofs": [{"type": "gps_proof", "data": {"latitude": 37.77, "longitude": -122.42}}]}' | jq
Worker reputation
curl -s http://localhost:8015/v1/workers | jq # Leaderboard (sorted by score)
curl -s http://localhost:8015/v1/workers/worker-1 | jq # Individual profile
Other endpoints
curl -s http://localhost:8015/v1/tasks | jq # List all tasks
curl -s http://localhost:8015/v1/tasks?status=posted | jq # Filter by status
curl -s http://localhost:8015/v1/tasks/TASK_ID/accept?worker_id=w -X POST # Accept task
curl -s http://localhost:8015/v1/platforms | jq # Available platforms
curl -s http://localhost:8015/v1/stats | jq # Platform statistics
Verification types
| Type | What it proves | How |
|---|
gps_proof | Worker was at location | Haversine distance < radius |
photo_proof | Photos submitted | Unique hash count >= min |
timestamp_proof | Done within deadline | Elapsed hours < max |
signature_proof | Cryptographic signature | Non-empty signature present |
multi_witness | N agents confirm completion | Unique attesting witness count >= threshold |
Surge pricing
- Standard: 5% base fee
- Urgent: +15% (total 20%)
- Critical: +40% (total 45%)
Escrow model
- Locked at task creation (budget held)
- Released only if ALL criteria pass (or per-milestone for milestone tasks)
- Frozen on dispute
- Refunded if deadline expires with no proof
