Provision the shard set of a sharded-purpose system account (idempotent)
Provisions the full shard set for a system account whose purpose is registered as sharded.
/v1/ledgers/{ledgerId}/system-accountsProvisions the full shard set for a system account whose purpose is registered as sharded. Idempotent: it creates what is missing and returns quietly when the set is already whole, so it is safe to call at every boot. Sharding exists because a single fee or float row is the contention point that caps throughput; the shards spread the write.
Authorization
bearerAuth In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/problem+json
curl -X POST "https://example.com/v1/ledgers/497f6eca-6276-4993-bfeb-53cbbbba6f08/system-accounts" \ -H "Content-Type: application/json" \ -d '{ "owner_type": "string", "purpose": "string", "commodity": "string" }'Close an account (terminal; requires zero balance, nothing reserved)
Closes an account for good. Terminal, and deliberately strict: the balance must be exactly zero and no pending may still be active, otherwise the request is refused as invalid with the offending fi...
One shard of a system account; random, or stable per seed
Returns one shard of a system account. Without seed the shard is chosen at random, which is what a fresh posting wants.