agent-compute-ledger
Compute-is-carbon energy/carbon ledger for agent work with Landauer-limit validation.
- 0.3.0
- Version
- remote
- Transport
- 12
- Tools
Security review
Review passedReviewed Jan 1, 2000.
- tools: 12 tools scanned
- metadata: scanned
No findings.
Tools (12)
record_work
Record a unit of agent compute work. energy_j = power_w * duration_s; carbon_g follows from grid intensity. If bit_ops is declared, the entry is validated against the Landauer floor (bit_ops * kB * T * ln2) — physically impossible claims are rejected. Idempotent on entry_id.
footprint
Aggregate footprint for an agent: total J, kWh, gCO2e, cost, and mean Landauer efficiency. Totals are exact sums of the ledger entries.
attest
Issue a content-addressed attestation for a ledger entry (verifiable green-compute / energy claim).
verify_attestation
Verify an attestation by recomputing the entry hash.
verify_chain
Verify the tamper-evident hash chain of an agent's ledger.
list_entries
List all ledger entries for an agent.
carbon_receipt
Emit an x402-C carbon receipt for a recorded work entry — the physically-grounded {version, g_co2e, energy_j, method, landauer_*, ...} object an x402 machine-payment receipt can carry. method is 'landauer-floor' when the workload declared bit_ops (thermodynamically validated), else 'measured'. Pass offset_ref (a retirement id from the offset clearinghouse) to assert carbon-neutrality. Read-only; the returned attestation_hash binds the receipt to the ledger's hash chain.
record_inventory
Record an audited GHG inventory in a separate append-only chain. mass_g is exact integer grams; content and factor-pack digests are bare lowercase SHA-256 hex. Idempotent on inventory_id.
get_inventory
Fetch one immutable inventory record by inventory_id.
list_inventories
List the separate GHG inventory chain for an agent.
verify_inventory_chain
Verify an agent's inventory hash chain independently of compute work.
describe_agent
Fleet-standard self-description.