Calculate ADA costs for Andamio operations. Estimate total cost for courses, projects, and user scenarios with four-component breakdowns.
Calculates ADA costs for different Andamio scenarios. Accepts natural-language descriptions like "course with 3 teachers and 10 modules" and returns a four-component breakdown: transaction fees, service fees, min UTXO deposits, and recoverable deposits.
${CLAUDE_PLUGIN_ROOT} is set): Read specs from ${CLAUDE_PLUGIN_ROOT}/specs/.specs/ relative to project root.specs/cost-registry.json for real execution unit data and fee structures.reference/tx-loops.yaml for canonical loop definitions, dotted names, and validated fees.knowledge/cost-scenarios.yaml for previously calculated scenarios. Proceed without it if missing.Andamio operations are organized into named transaction loops — multi-step workflows that accomplish a complete outcome. Reference loops by their dotted name (e.g., course.credential, project.setup).
Validated loops (tested against live stack, real fee data):
| Loop | Dotted Name | Total Cost | Notes |
|---|---|---|---|
| Course Setup | course.setup | ~111 ADA | course_create + modules_manage |
| Project Setup | project.setup | ~112 ADA + treasury deposit | project_create + treasury_fund + tasks_manage |
| Course Credential | course.credential | ~1.32 ADA | Per student: enroll → assess → claim |
| Project Credential | project.credential | ~1.21 ADA fees | Contributor net positive (deposit refund + reward) |
| Access Token | general.access-token | ~5.36 ADA | Prerequisite for course/project creation |
Stubbed loops (defined, not yet tested): project.credential.native-assets, course.credential.sequential, course.credential.refused, project.credential.refused, project.credential.denied, project.tasks.replace, course.modules.ongoing, course.teachers.rotate, course.credential.cohort, project.treasury.drawdown, general.auth.headless
When estimating costs, compose from loops:
general.access-token + course.setup + 50 × course.credentialgeneral.access-token + course.setup + project.setup + 10 × (course.credential + project.credential)See reference/tx-loops.yaml for full step sequences, roles, prerequisites, and known gotchas.
Every Andamio transaction has up to four cost components:
| Component | Recoverable? | Description |
|---|---|---|
| Transaction Fee | No | Network fee to stake pool operators. Varies by script complexity: 0.27–1.30 ADA |
| Service Fee | No | Protocol fee to Andamio treasury. Varies by transaction type: 0–120 ADA |
| Min UTXO Deposits | Partially | Minimum ADA locked in validator UTxOs. Released when UTxOs are consumed. |
| Recoverable Deposits | Yes | ADA locked in state UTxOs. Refunded when credentials are claimed. |
| Transaction | Tx Fee | Service Fee | Min UTXO | Notes |
|---|---|---|---|---|
| Mint Access Token | ~0.36 ADA | 5 ADA | ~3.76 ADA (3 index nodes) | Entry point. ~7.9 ADA total. |
| Transaction | Tx Fee | Service Fee | Min UTXO | Notes |
|---|---|---|---|---|
| Create Course | ~0.55 ADA | 100 ADA + 10 ADA/extra teacher | ~19 ADA | ~130 ADA for 1 teacher |
| Update Teachers | ~0.30 ADA | 10 ADA | 0 | Spend-and-recreate |
| Manage Modules | ~0.27 ADA | 0 (free) | ~1.59 ADA/module | Scales linearly |
| Student Enroll | ~0.40 ADA | 0 | ~1.74 ADA | ~2.14 ADA total |
| Update Assignment | ~0.28 ADA | 0 | ~0.05 ADA | Datum grows |
| Assess Assignment | ~0.28 ADA | 0 | -0.07 ADA refund | Teacher gets small refund |
| Claim Credential | ~0.35 ADA | 0 | -1.38 ADA refund | Student gains ~1.03 ADA |
| Transaction | Tx Fee | Service Fee | Min UTXO | Notes |
|---|---|---|---|---|
| Create Project | ~1.30 ADA | 100 ADA + 10 ADA/extra manager | ~40 ADA + treasury deposit | ~363 ADA with 200 ADA treasury |
| Update Managers | ~0.30 ADA | 10 ADA | 0 | Spend-and-recreate |
| Manage Blacklist | ~0.34 ADA | 0 | 0 | — |
| Create Tasks | ~0.43 ADA | 0 | task reward amount | Reward locked in escrow |
| First Task Commit | ~0.51 ADA | 0 | ~14.5 ADA | State deposit (recoverable) |
| Subsequent Commits | ~0.51 ADA | 0 | 0 | No new deposit |
| Assess Tasks | ~0.35 ADA | 0 | 0 | — |
| Claim Project Credential | ~0.35 ADA | 1 ADA | -14.5 ADA refund | Contributor gains ~13 ADA |
| Add Treasury Funds | ~0.30–0.50 ADA | 0 | deposit amount | — |
When the developer describes a scenario, calculate the total:
Example: "Course with 3 teachers and 10 modules, expecting 50 students doing 5 assignments each"
Course Setup (one-time):
Create course (3 teachers): 100 + 20 + 0.55 + 19 = ~139.55 ADA
Create 10 modules: 10 × 1.86 = ~18.60 ADA
Setup subtotal: = ~158.15 ADA
Per Student (50 students × 5 assignments each):
Enroll (per student): 2.14 × 50 = ~107.00 ADA
Update (per assignment): 0.33 × 250 = ~82.50 ADA
Assess (per assignment): 0.21 × 250 = ~52.50 ADA
Claim (per student): -1.03 × 50 = ~-51.50 ADA
Student/teacher subtotal: = ~190.50 ADA
TOTAL: ~348.65 ADA
One-time costs: ~158.15 ADA (non-recoverable)
Operational costs: ~190.50 ADA (partially recoverable via claims)
Cost per student: ~3.81 ADA net (across 5 assignments)
Always present results with:
Always include:
Costs are based on the bundled cost registry and may vary slightly with Cardano protocol parameter updates. Transaction fees depend on network conditions and script execution complexity. Last updated: [read date from cost-registry.json].
On preprod, these costs apply but test ADA is free from the Cardano faucet at https://docs.cardano.org/cardano-testnets/tools/faucet/
Offer when relevant: