Track an order

GetOrder takes the quote hash and returns everything known about it: the quote, the order, the deposit, and the fulfillment or refund.

const detail = await blink.getOrder({ quoteHash });

detail.quote;         // always present
detail.order;         // always present, see below
detail.deposit;       // the matched source-chain deposit
detail.fulfillment;   // present once a fulfillment is attempted
detail.refund;        // present once a refund is attempted

Until the deposit is indexed, GetOrder returns NOT_FOUND with order not found. Between the deposit landing and the indexer seeing it that is normal for the first seconds; keep polling. A Sui deposit that swaps first has a stage before the deposit: the user’s transaction only opens a swap intent, and the deposit appears once the relayer has run the swap. GetSourceSwap reports that stage. When it says executed, the order exists or is about to; when it says lapsed, no deposit will come from that intent and nothing left the user’s wallet. The SDK’s swap step does this polling for you.

Polling

Poll every couple of seconds, treat NOT_FOUND as waiting, and stop on a terminal state.

import { Code, ConnectError } from "@connectrpc/connect";
import { isTerminalState, orderOutcome } from "@mayanfinance/blink-sdk";

const settle = async (quoteHash: string) => {
  for (;;) {
    try {
      const { order } = await blink.getOrder({ quoteHash });
      if (order && isTerminalState(order.state)) {
        return orderOutcome(order.state);   // "fulfilled" | "refunded" | "failed"
      }
    } catch (e) {
      if (ConnectError.from(e).code !== Code.NotFound) throw e;
    }
    await new Promise((r) => setTimeout(r, 2000));
  }
};

Polling is the supported pattern for tracking one order; keep the interval at a couple of seconds and it stays well inside rate limits. An integrator that follows every order, such as an explorer, can use StreamOrderUpdates instead. There is no webhook.

What to render

Order state	Show
`NOT_FOUND`, no order yet	Waiting for the deposit to be seen. On a Sui swap-first deposit, show the swap stage from `GetSourceSwap`.
Source swap `lapsed`	The swap did not run in time. Nothing left the wallet; request a new quote.
`awaiting_finality`	Confirmation progress, from `src_confirmations` of `required_confirmations`.
`ready_to_fulfill`, `fulfilling`	Settling on the destination chain.
`fulfilled`	Done, with `dst_tx_hash` linked.
`pending_refund`, `refunding`, `awaiting_refund_window`	Refund in progress.
`refunded`	Refunded, with the refund transaction linked.
`review`	Under operator review. Say the funds are safe and show the quote hash.
`refund_skipped`, `support`	Needs support. Say so plainly and show the quote hash.

See Order lifecycle for what each state means.

dst_tx_hash is set when a transaction is submitted, not when it confirms. Only the order state tells you the funds arrived.

Explorer links

GetChains returns URL templates per chain. Substitute the hash or address rather than assembling explorer URLs yourself:

import { explorerTxUrl, explorerAddressUrl } from "@mayanfinance/blink-sdk";

const chain = chains.find((c) => c.chain === order.dstChain)!;
explorerTxUrl(chain.explorerTxUrl, order.dstTxHash);
explorerAddressUrl(chain.explorerAddressUrl, recipient);

The Blink explorer page for an order is https://hular.dev/explorer/<quote_hash>.

Finding orders another way

RPC	Input	Returns
`Search`	A quote hash, a source transaction hash, or a destination transaction hash	The single matching order detail
`SearchAddress`	An address	Matching orders, with state and chains
`ListOrders`	An address	A page of full order summaries for that address
`ListRecentOrders`	Nothing	A page of recent protocol-wide orders

Search is what a support box should call: it accepts whichever hash the user has in hand.

const detail = await blink.search({ query: userInput });

Pagination

Listing RPCs are cursor-paginated. Pass next_cursor from the previous page; an absent cursor means the end.

let cursor: string | undefined;
do {
  const page = await blink.listOrders({ address, limit: 50n, cursor });
  render(page.items);
  cursor = page.nextCursor;
} while (cursor);

Default page size is 20 and the maximum is 100; larger values are clamped rather than rejected. Cursors are opaque; do not parse or construct them.

Get started

Build a swap

Extend

Track an order

Polling

What to render

Explorer links

Finding orders another way

​Polling

​What to render

​Explorer links

​Finding orders another way

​Pagination

Polling

What to render

Explorer links

Finding orders another way

Pagination