Concepts
Events
The normalized on-chain event stream.
events exposes the normalized event stream produced by chain scanners and
provider webhooks — the raw source of truth StableOps uses to recognize
payments. Webhooks push these events to your
service; the events API lets you pull or replay them on demand.
Data model
Each row corresponds to a single (chain, tx_hash, log_index) on-chain log and
is globally unique. Typical uses:
- Replay: backfill or repair your ledger over a time window.
- Drill into a payment order: find the on-chain transfer behind a specific order.
- Internal observability: pipe the normalized stream into your own BI or reconciliation system.
Amount units
The amount field is always the smallest unit (a uint256 string). USDC
and USDT both have 6 decimals on every supported chain, so "10000000"
represents 10.00 USDC.
Payment orders carry amount as a decimal asset-unit string (e.g. "10.00").
StableOps converts both sides through the token's decimals before matching.
Next steps
- Webhooks — push delivery of the same event stream
- Payment Orders — how events drive the order state machine