Andamio Logo
Protocol/Protocol V2/Transaction sequences

Project · Contribute & earn

A contributor's path from committing to a task to claiming a reward credential.

The contributor path mirrors the student path: commit to a task (joining the project), submit your work as on-chain evidence, have a manager assess it, and — once accepted — claim a credential and reward.

Project · Contribute & earn

A contributor commits to a task (joining the project on first commit), does the work and submits evidence on-chain, has a manager assess it, and — once accepted — claims a credential and reward, recovering their deposit.

Step 1

Commit to Task

Actor
Contributor
On-chain effect

Validator action. contributor_state: CommitProject

Token Δ. On first commit, mints the contributor-state token (joins the project) and records the task commitment in one step; later commits skip minting. A recoverable contributor-state deposit is locked.

Resulting state
Contributor has joined the project; the task commitment with its evidence is on-chain and linked to the task.
Build endpoint
POST /api/v2/tx/project/contributor/task/commit
Transaction lifecycle

Step 2

Submit Task Work

Actor
Contributor
On-chain effect

Validator action. escrow1: UserAction

Token Δ. No mint or burn. The actual work happens off-chain; this transaction records the contributor's evidence of completion in the on-chain task state.

Resulting state
The contributor's submission is recorded on-chain and available for the manager to assess.
Build endpoint
POST /api/v2/tx/project/contributor/task/action
Transaction lifecycle

Step 3

Assess Tasks

Actor
Manager
On-chain effect

Validator action. escrow1: Accept + contributor_state: AddCompleted

Token Δ. No mint or burn — records an accept or reject decision per contributor against the task escrow (decisions can be batched).

Resulting state
Each submission is marked accepted or rejected on-chain; accepted contributors can claim their credential and reward.
Build endpoint
POST /api/v2/tx/project/manager/tasks/assess
Transaction lifecycle

Step 4

Claim Project Credential

Actor
Contributor
On-chain effect

Validator action. contributor_state: BurnContributor

Token Δ. Burns the contributor-state token, stores the credential hash in global state, pays the task reward, refunds the contributor-state deposit, and pays a small protocol fee — a net ADA gain for the contributor.

Resulting state
The contributor holds a verifiable project credential and reward on-chain; the deposit is returned and the commitment is marked rewarded.
Build endpoint
POST /api/v2/tx/project/contributor/credential/claim
Transaction lifecycle