Project · Author & operate
How an owner creates a project with a treasury and managers define funded tasks.
Standing up a project mirrors a course: an owner mints the project instance and treasury, adds managers, and managers define funded tasks. Anyone can top up the treasury that pays task rewards.
Project · Author & operate
An owner stands up a project instance with a treasury, adds managers, and managers define funded tasks. Anyone can top up the treasury that pays task rewards. Each beat is a single transaction keyed on the project's policy ID.
Step 1
Create Project
- Actor
- Project Owner
- On-chain effect
Validator action.
instance_governance: governance action (mint project instance)Token Δ. Mints a new project instance on-chain (6 mints, 2 observers), registering the creator as owner and first manager and establishing the treasury system. Returns the project's policy ID (project_id).
- Resulting state
- Project instance and treasury exist on-chain; the creator is owner and first manager; project_id is issued for all subsequent project operations.
- Build endpoint
POST /api/v2/tx/instance/owner/project/create
Step 1
Create Project
- Actor
- Project Owner
- On-chain effect
Validator action.
instance_governance: governance action (mint project instance)Token Δ. Mints a new project instance on-chain (6 mints, 2 observers), registering the creator as owner and first manager and establishing the treasury system. Returns the project's policy ID (project_id).
- Resulting state
- Project instance and treasury exist on-chain; the creator is owner and first manager; project_id is issued for all subsequent project operations.
- Build endpoint
POST /api/v2/tx/instance/owner/project/create
Step 2
Manage Managers
- Actor
- Project Owner
- On-chain effect
Validator action.
instance_governance: governance action (update manager list)Token Δ. No token mint or burn — updates the on-chain manager-list datum, replacing the previous set entirely.
- Resulting state
- The project's manager list is updated on-chain and mirrored to the database; only listed managers can create and assess tasks.
- Build endpoint
POST /api/v2/tx/project/owner/managers/manage
Step 3
Manage Tasks
- Actor
- Manager
- On-chain effect
Validator action.
treasury: ManageToken Δ. No new tokens minted — uses existing treasury tokens. Adds or removes task definitions; each active task's reward amount is held in task escrow.
- Resulting state
- Tasks are live on-chain with rewards escrowed; contributors can commit to them. Removed tasks are cancelled.
- Build endpoint
POST /api/v2/tx/project/manager/tasks/manage
Step 4
Fund Treasury
- Actor
- Any user
- On-chain effect
Validator action.
treasury: CommitFundsToken Δ. No mint or burn — deposits ADA or native assets into the project's on-chain treasury that funds task rewards.
- Resulting state
- The treasury balance increases on-chain (tracked on-chain only, no database sync); more reward funding is available for tasks.
- Build endpoint
POST /api/v2/tx/project/user/treasury/add-funds