Type Alias: MessageSearchPage

MessageSearchPage = { cursor?: string; data: MessageSearchResult[]; hasNextPage: boolean; }

Defined in: api/types.ts:254

A page of message search results with cursor-based pagination.

Remarks

When hasNextPage is true, pass the cursor value to CCIPAPIClient.searchMessages to fetch the next page. The cursor encodes all original filters, so you do not need to re-supply them when paginating.

See

• MessageSearchFilters
• CCIPAPIClient.searchMessages
• CCIPAPIClient.searchAllMessages — async generator alternative that handles pagination automatically

Examples

TypeScript

let page = await api.searchMessages({ sender: '0x...' }, { limit: 10 })
while (page.hasNextPage) {
  page = await api.searchMessages(undefined, { cursor: page.cursor! })
}

TypeScript

for await (const msg of api.searchAllMessages({ sender: '0x...' })) {
  console.log(msg.messageId)
}

Properties

cursor?

optional cursor: string

Defined in: api/types.ts:260

Opaque cursor for fetching the next page

---

data

data: MessageSearchResult[]

Defined in: api/types.ts:256

Array of message search results

---

hasNextPage

hasNextPage: boolean

Defined in: api/types.ts:258

Whether more results are available