On-chain List Helpers
Use these helpers when your recipient source is on-chain list chunk data. They are most useful for readers, explorers, indexers, and custom tooling.
Decoders
parseListChunk
Decodes a full list chunk into recipient entries.
parseRecipient
Decodes one recipient from serialized list data.
parseRecipientAtIndex
Decodes one recipient at a given index.
Range Mapping
Map entry indices to chunk ranges and offsets.
| Function | Returns |
|---|---|
getListChunkRange | The chunk range covering a given entry index |
getRecipientRange | The recipient range within a chunk |
getListChunkIndex | The chunk index for a given entry index |
getListChunkOffset | The byte offset within the chunk for a given recipient |
When to Use
- Building a recipient explorer or indexer
- Verifying a recipient is in a specific chunk before fetching it
- Implementing custom claim verification tooling
For active claim flows where you read recipients via the client, use listOnchainRecipients instead.
Next Step
Continue to Validation and Errors for pre-checks and error normalization.
Last updated on