{"name":"satledger","summary":"Tamper-evident usage and action ledgers for AI agents. Every event is ed25519-signed and hash-chained; state is computed by replaying the events under frozen public rules.","protocol":{"name":"SATROOT-1","specification":"https://github.com/parthod0x/satroot","verifier":"pip install satroot[crypto,validation]"},"openapi":"https://api.satledger.org/openapi.json","operations":{"timestamp_receipt":"POST /x402/receipt","create_agent":"POST /agents","rotate_key":"POST /workspace/rotate-key","record_usage":"POST /agents/{agent_id}/usage","record_action":"POST /agents/{agent_id}/actions","grant_credits":"POST /agents/{agent_id}/grants","anchor":"POST /agents/{agent_id}/anchor","export":"GET /agents/{agent_id}/export.zip"},"authentication":{"header":"X-API-Key","value":"the api_key returned once when a workspace is bought","obtain":"https://api.satledger.org/x402/provision","note":"The key is shown exactly once and is not stored. POST /workspace/rotate-key issues a new one; everything else about the workspace survives."},"pricing":{"unit":"recorded event","free_allowance_units":10000,"block_units":100000,"block_price_atomic":"20000000","price_decimals":6,"tiers":[{"name":"starter","units":2500,"price_atomic":"500000","price_display":"0.50"},{"name":"block","units":100000,"price_atomic":"20000000","price_display":"20.00"}],"receipt":{"price_atomic":"50000","price_display":"0.05","grants_units":false,"note":"A single timestamp receipt, bought per call. No account, no balance, nothing stored here afterwards."},"operations":{"agent.create":1,"credit.grant":1,"usage.record":1,"action.record":1,"anchor.create":100},"free_operations":["export.create","export.download","every read path"],"notes":"Export is free permanently: this service's claim is that you can verify without trusting it and leave whenever you like, so the exit is never priced."},"payment":{"x402":{"enabled":true,"provision":"https://api.satledger.org/x402/provision","receipt":"https://api.satledger.org/x402/receipt","discovery":"https://api.satledger.org/discovery/resources"}},"verification":{"offline":true,"how":"Every export contains the full signed event history, the public keys, the action log, and an Apache-2.0 verifier. Your customer replays it without contacting this service."},"limits":{"operator_holds_signing_keys":true,"what_that_means":"This service signs your events, so it could in principle write one you did not cause. What it cannot do is alter history you have already exported or anchored: the export is replayable offline and an anchor pins the ledger to a third-party timestamp this service does not control.","completeness":"An export proves what it contains is internally consistent and was timestamped. Proving nothing was omitted requires an anchor, or a ledger head you kept.","the_key_is_the_account":"A workspace bought over x402 has no identity attached - no email, no account, only the key. So possession of the key is the only proof of ownership this service can check. Rotate it yourself at POST /workspace/rotate-key if it leaks; a lost key cannot be recovered by anyone, because an operator who restored access on a plausible story would be the weakest part of this product."}}