Skip to main content

Status & history

Status by transaction id​

Pass an EVM, TON, or Bitcoin TXID to retrieve a request's status.

const txId = "...";
const response = await sdk.teleportdao.getRequestStatusByTxId(txId);
console.log(response.state); // "Pending" | "Done" | "Failed"
warning

There may be a short delay after broadcasting before the request becomes queryable. While state is Pending, sourceTransaction may be null and fee fields may be 0.

Account history​

Fetch requests for one or more Bitcoin/EVM addresses.

const addresses = ["0x...", "bc1..."];

const response = await sdk.teleportdao.getRequests(addresses, {
type: "WrapAndSwap", // Wrap | Unwrap | WrapAndSwap | SwapAndUnwrap
tokenType: "BTC", // BTC
filter: "done", // all | done | pending (default: done)
limit: 10,
offset: 0,
order: "desc",
});

// Or fetch everything matching the config:
const all = await sdk.teleportdao.getAllRequests({ filter: "all" });

Waiting requests​

Requests in the Waiting state are not included in getRequests. Fetch them for an EVM address:

const waiting = await sdk.teleportdao.getWaitingRequests(evmAddress);

State vs. status​

  • state — high-level lifecycle: Pending, Done, or Failed.
  • status — granular progress: NotProcessed, Pending, Confirmed, Submitted, and terminal ExchangeFailed / Failed / Withdrawn (refund states).

A full field-by-field walkthrough of a request record lives in the API reference (Request schema).

REST equivalents​

SDK methodEndpoint
getRequestStatusByTxIdGET /api/v2/teleswap/requests/tx/{txId}
getRequests / getAllRequestsGET /api/v2/teleswap/requests
getWaitingRequestsGET /api/v1/teleswap/cross-chain/waiting-request/{address}