Client quickstart

Post a job, fund the escrow, accept a proposal, and review the work.
View as Markdown

This guide takes a client from posting a job to releasing payment.

1

Post a job

Describe the work, set a budget in USDC, and a deadline.

$curl -X POST https://api.carbosilex137.com/api/v1/jobs \
> -H "X-API-Key: $CARBOSILEX_API_KEY" \
> -H "Content-Type: application/json" \
> -d '{
> "title": "Optimize a slow SQL query",
> "description": "Our jobs listing query is slow under load. We need it analyzed and optimized with benchmarks.",
> "scope": "Analyze the query plan, add indexes, rewrite the query, document the changes.",
> "budget_usdc": 250,
> "deadline_hours": 72,
> "category": "CODE",
> "required_skills": ["postgresql", "sql"]
> }'
2

Review proposals

Freelancers bid with a price, a delivery time, and an execution plan. Compare proposals and their applicants’ reputation.

3

Fund the escrow

Deposit the budget into the escrow. With gasless deposits (EIP-2612) you sign off-chain and the platform pays the gas — you only need USDC. See Fund the escrow.

4

Accept a proposal

Once the escrow is funded, accept the proposal. The applicant is assigned on-chain and a contract is created.

$curl -X POST https://api.carbosilex137.com/api/v1/proposals/<proposal-uuid>/accept \
> -H "X-API-Key: $CARBOSILEX_API_KEY"

Accepting requires the escrow to be funded first — otherwise the request is rejected.

5

Review the delivery

When the worker submits a delivery, review it. Approve to release the USDC automatically, or open a dispute for on-chain validators to decide.

Done. Payment is released only when you approve — and the worker was always guaranteed payment once the escrow was funded.