DOCUMENTATION

title: str · description: str · deadline: str · value: GEN (required)

Creates a new job. The GEN sent with the transaction is locked in escrow. Title must be ≥ 3 chars, description ≥ 20 chars. Job starts in OPEN status.

… · milestone_titles: list (2–5) · value: GEN (required)

Creates a milestone job. The escrow is split evenly across 2–5 milestones, each delivered and approved (and paid) independently.

job_id: int · note: str (required) · bid: int (0 = at budget)

Freelancer submits a proposal for an OPEN job. One proposal per address. The bid is informational — escrow stays at the posted budget.

job_id: int · freelancer: str

Client assigns one of the applicants. The address must have applied. Transitions status to ACTIVE. This is the primary assignment flow.

job_id: int

Direct self-assignment (no-proposal fallback). Job must be OPEN; the caller cannot be the client. Transitions status to ACTIVE.

job_id: int

Client cancels an OPEN (unassigned) job and the escrow is refunded. Status becomes CANCELLED.

job_id: int · evidence_url: str (required) · evidence_note: str

Freelancer marks the job as delivered with a URL pointing to the work (GitHub, live site, Figma, Loom, etc.). Transitions status to DELIVERED.

job_id: int · client-only

Client triggers AI consensus evaluation. Validators independently fetch the evidence URL and run an LLM rubric. Untrusted submission content is fenced against prompt injection. If approved, funds transfer automatically. Status becomes COMPLETED or DISPUTED.

job_id: int

Client bypasses AI and approves payment directly. Job must be DELIVERED. Only the client can call this. Funds transfer immediately. Status becomes COMPLETED.

job_id: int · evidence_url: str (required) · evidence_note: str

Freelancer resubmits stronger evidence on a DISPUTED job (max 2 resubmits). Status returns to DELIVERED for re-evaluation.

job_id: int

Client reclaims escrow when an assigned freelancer never delivered and the deadline has passed (ghost protection). Status becomes CANCELLED.

job_id: int

Client reclaims escrow on a DISPUTED job once the freelancer has exhausted all resubmits. Status becomes REFUNDED — funds are never permanently locked.

job_id: int · stars: int (1–5) · review: str

Client rates the freelancer on a COMPLETED job (one rating per job). The average is aggregated into the freelancer's on-chain profile.

display_name: str · bio: str · skills: list

Any address sets its own public profile. Reputation, earnings, and ratings are computed by the contract and can never be forged here.

job_id: int · content: str (max 500 chars)

Appends a message to the job's chat thread. Only the client or assigned freelancer can message. Job must not be OPEN (messaging starts after a freelancer is assigned).

job_id: int → str (JSON)

Returns a single job as a JSON string. Returns empty string if the job does not exist.

→ str (JSON array)

Returns all jobs ever posted as a JSON array. Used by the browse page for client-side filtering and sorting.

offset: int · limit: int (clamped ≤ 50) → str (JSON)

Paginated, newest-first job read. Returns { total, offset, limit, jobs }. Keeps reads bounded as the job count grows.

job_id: int → str (JSON array)

Returns the proposals submitted for a job. Returns "[]" if none.

address: str → str (JSON)

Returns the address's profile: display name, bio, skills, reputation score, completed/disputed counts, total earned, and average star rating.

client: str → str (JSON array)

Returns all jobs posted by the given wallet address. Case-insensitive match.

freelancer: str → str (JSON array)

Returns all jobs taken by the given wallet address. Used by the notification system.

job_id: int → str (JSON array)

Returns the chat message array for a job as a JSON string. Returns "[]" if no messages exist.

→ int

Returns the total number of jobs ever posted (includes all statuses). Used by the landing page stats.

Consensus phases during AI evaluation

Score-based approval logic

The contract ignores the "approved" field from the LLM and recomputes it from the 5 numeric scores. Tests cover all three boundary cases:

avg = sum(scores.values()) / 5   # 5 criteria, each 0–10
approved = avg >= 6.0             # strict ≥ 6 threshold

Fetches all jobs on-chain. Refetches every 15 seconds. Used by Browse Jobs and Dashboard pages.

Fetches a single job by ID. Refetches every 10 seconds. Disabled when id is undefined.

Derived hook — filters useGetAllJobs() locally by client and freelancer address. No extra contract call.

Returns total job count. Refetches every 30 seconds. Used by landing page stats.

Fetches chat messages for a job. Refetches every 10 seconds. Returns [] if jobId is undefined.

Sends a payable post_job transaction. params: { title, description, deadline, budgetEth }. budgetEth is converted to wei via parseEther(). AI evaluation timeout: 90s.

Payable post_job_milestones transaction. params includes milestoneTitles: string[] (2–5). Escrow is split evenly across the milestones.

Freelancer submits a proposal for an OPEN job. bid is optional and informational (defaults to the posted budget).

Client assigns one of the applicants. The address must have applied. Transitions the job to ACTIVE.

Reads the proposals submitted for a job. Refetches every 30s and after any write.

Direct self-assignment fallback. Fails if job is not OPEN or caller is the client. The proposals flow is preferred.

Client cancels an OPEN job and reclaims the escrow.

Marks a job as DELIVERED with an evidence URL and optional note. Only the assigned freelancer can call this.

Client-only. Triggers AI consensus evaluation. Uses a 300s retry timeout because LLM inference across validators takes 1–5 minutes.

Client manually approves and pays the freelancer. Bypasses AI. Only callable by the client when status is DELIVERED.

Freelancer resubmits on a DISPUTED job (max 2×), returning it to DELIVERED for re-evaluation.

Client reclaims escrow on an ACTIVE job whose deadline passed without a delivery.

Client reclaims escrow on a DISPUTED job after the freelancer has exhausted all resubmits.

Client rates the freelancer (1–5★) on a COMPLETED job. One rating per job.

Updates the connected wallet's public profile (display name, bio, skill tags).

Reads an address's profile: reputation, completed/disputed counts, total earned, and average star rating.

Paginated, newest-first job read backed by the contract's get_jobs_page view.

Appends a message to the job's on-chain chat thread. Content is truncated to 500 chars on-chain.

Polls chain every 15s, diffs job state, fires typed notifications. Persists to localStorage. First poll is silent (no false positives on page load).

localStorage-backed job favorites under key arbiq:favorites. Hydrated in useEffect to avoid SSR mismatch.

Attach the returned ref to a container. All .reveal children animate in with staggered delay when they enter the viewport via IntersectionObserver.

Animates a number from 0 to target using easeOutExpo over duration ms. Only starts when trigger is true — pair with a scroll reveal intersection flag.

Contributing

Arbiq is open source. Have an idea or found a bug? Open an issue or PR on GitHub ↗. Feature requests that align with the roadmap are prioritised.