WalletD developers
Event feed

Page the event feed ascending from a (xact, seq) cursor

Events are served in (xact, seq) order and only once every transaction older than theirs has finished, so a consumer that stores the last event's (xact, seq) as its cursor sees every event exactly...

GET/v1/ledgers/{ledgerId}/events

Events are served in (xact, seq) order and only once every transaction older than theirs has finished, so a consumer that stores the last event's (xact, seq) as its cursor sees every event exactly once, however long the writing transactions lived. The trade: delivery order follows transaction start, not commit, so a consumer must tolerate causally-later events (a pending's posted) arriving before earlier ones (its created). seq alone is NOT a safe cursor. When an old transaction pins the database-wide watermark the feed cannot advance, and an empty page would be a lie: that is refused as event_feed_blocked (503) instead of reported as caught up, so a stalled consumer retries rather than skipping events it was told did not exist. limit is clamped to the contract maximum.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

ledgerId*string
Formatuuid

Query Parameters

after_xact?integer
Formatint64
Default0
after?integer

seq tiebreaker within after_xact.

Formatint64
Default0
limit?integer
Rangevalue <= 1000
Default100

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/v1/ledgers/497f6eca-6276-4993-bfeb-53cbbbba6f08/events"
[  {    "xact": 0,    "seq": 0,    "kind": "string",    "payload": null,    "created_at": "2019-08-24T14:15:22Z"  }]