Client quickstart

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

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

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"]
>   }'

Review proposals

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

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.

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.

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.

$	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"]
>	}'

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