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, orFailed.status— granular progress:NotProcessed,Pending,Confirmed,Submitted, and terminalExchangeFailed/Failed/Withdrawn(refund states).
A full field-by-field walkthrough of a request record lives in the
API reference (Request schema).
REST equivalents
| SDK method | Endpoint |
|---|---|
getRequestStatusByTxId | GET /api/v2/teleswap/requests/tx/{txId} |
getRequests / getAllRequests | GET /api/v2/teleswap/requests |
getWaitingRequests | GET /api/v1/teleswap/cross-chain/waiting-request/{address} |