Project Protocol

The Project Protocol enables credential-gated collaborative work with built-in treasury management and transparent reward distribution. Projects can define skill requirements, manage contributor enrollment, track work completion, and distribute rewards—all with complete on-chain auditability.

Project Lifecycle

1. Project Creation

A project creator initializes a new project by creating:

• Project UTxO: Holds project configuration and state
• Treasury: Stores project funds for contributor rewards
• Prerequisites: Optional credential requirements for contributors

See: admin-init-project-step-1, admin-init-project-step-2

2. Contributor Enrollment

Contributors with required credentials can:

• Mint project state token: Creates local state for tracking contributions
• Lock credentials: Prerequisites are verified and locked as proof of eligibility
• Join project: Begin working on project tasks

See: contributor-mint-project-state, contributor-commit-project

3. Work & Rewards

As contributors complete tasks:

• Add contribution info: Update local state with completed work
• Unlock rewards: Withdraw earned funds from treasury
• Get rewards: Claim available rewards to wallet

See: contributor-add-project-info, contributor-unlock-project-rewards, contributor-get-project-rewards

4. Project Completion

When the project ends:

• Burn project state: Contributors can clean up their local state
• Final rewards: Remaining treasury funds distributed
• Audit trail: Complete history preserved on-chain

See: contributor-burn-project-state

Key Components

Contributor State

The contributor state scripts manage individual contributor participation. Each contributor has a local project state UTxO that tracks:

• Credential verification (prerequisite course completions)
• Work completed and contributions made
• Rewards earned and claimed
• Participation history

Project Treasury

The treasury scripts manage project funding. The treasury:

• Holds project funds securely
• Tracks reward allocations
• Enforces withdrawal rules
• Provides complete audit trail of fund distribution

Escrow System

The escrow validators provide secure intermediate holding for sensitive operations:

• Credential locking during enrollment
• Reward distribution coordination
• State transition safety

Project-Specific Features

Credential-Based Access

Projects can require specific course completions before allowing enrollment. When contributors mint their project state, the validator checks their course completion tokens to verify they meet all prerequisites.

Transparent Treasury

All project funding is visible on-chain. Contributors can verify available funds, track reward distribution, and audit the complete financial history of the project.

Flexible Contribution Tracking

Project states can track arbitrary contribution data, allowing projects to define their own metrics for work completion and reward allocation.

Composability

The Project Protocol builds on the Global State (for identity) and Course Protocol (for credentials), demonstrating how Andamio's validator systems compose to create powerful collaborative structures.