Track swap order status and review order history on Hidooor
Track swap progress and review order history.
hidooor_order_status({ orderId: "<uuid>" })
Response fields:
| Field | Description |
|---|---|
orderId | Unique order identifier |
status | Current processing stage |
actualOutput | Final token amount received (when complete) |
outputMint | Target token mint address |
error | Error message if the order failed |
retryCount | How many times the backend retried |
depositTxId| SOL deposit to derived address |
privacyDepositTxId | Deposit into ZK privacy pool |
privacyWithdrawTxId | Withdrawal from privacy pool |
swapTxId | Jupiter DEX swap transaction |
sendTxId | Final token delivery to user wallet |
refundTxId | SOL refund (if swap failed and was refunded) |
sendTxId is present and status is complete, the swap succeeded — tokens are in the user's walletrefundTxId is present, the swap failed but funds were returnederror is set, explain what went wrong and suggest next stepsretryCount > 0, the backend already attempted automatic recoveryWhen monitoring an active swap, poll every few seconds. Tell the user which stage it's at based on which transaction IDs have appeared.
hidooor_user_orders({ walletAddress: "<base58 address>" })
Returns array of:
orderId — can be used with hidooor_order_status for detailsstatus — current statusoutputMint — what token was being boughtrequestedLamports — how much SOL was sent (in lamports, divide by 1e9 for SOL)createdAt — timestamphidooor_order_status for full detailsAll transaction IDs (*TxId fields) can be verified on Solana Explorer:
https://explorer.solana.com/tx/<txId>
When sharing tx IDs with the user, mention they can verify on-chain.