io.github.jdhart81/agent-compute-ledger

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 passed

Reviewed 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.