Skip to Content
DocsGuidesDecoding Events

Decoding Events

NaraLabs uses SEP-0048 event schemas to turn raw Soroban event payloads into readable fields and summaries.

Decode pipeline

  1. Index — Atlas worker ingests events from Stellar RPC
  2. Match schema — Registry lookup by contract + event type
  3. Decode — Map topics and value to semantic fields
  4. Preview — Generate summary_preview for list views

Decode status

StatusMeaning
decodedSchema matched; semantic fields available
rawIndexed but no schema or partial decode

Schema registry

The schema registry (Atlas registry module) stores SEP-0048 definitions submitted by contract authors. When a schema is registered for a contract event type, newly ingested events are decoded automatically.

Raw vs decoded in the UI

  • Homepage & list tables show decode badges and summaries
  • Event detail shows full JSON topics/value plus decode metadata
  • Filters on /events let you narrow to decoded or raw-only events

Contributing schemas

Publish schemas via the Atlas registry API (POST /v1/schemas). Full request format, validation rules, and list/get endpoints are documented in the Atlas README  and at /docs → API reference, or interactively at http://localhost:8080/docs when Atlas is running locally.

Last updated on
ContractsEvents · Naralabs Explorer