Skip to main content
When submitting requests with Bungee, monitoring the status of requests is essential. This is an explainer of the different status codes returned by the Bungee API and how to interpret them.

​
Checking Request Status

You can use the Bungee API endpoint to check the status of a request from Bungee Auto transactions and Bungee Manual crosschain swaps. The request hash can be either:
  • The requestHash returned from a submit request (for Auto routes)
  • The transaction hash (for Manual routes)
const BUNGEE_API_BASE_URL = "https://public-backend.bungee.exchange";

async function checkStatus(requestHash) {
  try {
    const response = await fetch(
      `${BUNGEE_API_BASE_URL}/api/v1/bungee/status?requestHash=${requestHash}`
    );
    const data = await response.json();

    if (!data.success) {
      const serverReqId = response.headers.get("server-req-id");
      throw new Error(
        `Status error: ${data.statusCode}: ${data.message}. server-req-id: ${serverReqId}`
      );
    }

    // It returns an array since we can have multiple requests in one requestHash
    return data.result[0];
  } catch (error) {
    console.error("Failed to check status:", error);
    throw error;
  }
}

​
Manual samechain swaps

For Bungee Manual samechain swaps, the swap is executed in the same onchain transaction you submit. Check the receipt status to determine success. 
// Example using viem
import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

const client = createPublicClient({ chain: mainnet, transport: http() });

async function checkManualSameChainTx(hash) {
  const receipt = await client.waitForTransactionReceipt({ hash });
  if (!receipt) {
    throw new Error("Transaction not found");
  }

  if (receipt.status !== "success") {
    throw new Error("Transaction failed/reverted");
  }

  return receipt;
}

​
Status Code Enum

Bungee uses the following enum to represent the status of a request. These status codes are returned in the bungeeStatusCode field of the status response: 
export enum RequestStatusEnum {
  PENDING = 0,
  ASSIGNED = 1,
  EXTRACTED = 2,
  FULFILLED = 3,
  SETTLED = 4,
  EXPIRED = 5,
  CANCELLED = 6,
  REFUNDED = 7,
}

​
Status Code Descriptions

​
PENDING (0)

The request has been submitted to the Bungee Auto system but has not yet been picked up by a solver. This is the initial state of all requests.

​
ASSIGNED (1)

A solver has been assigned to the request and is working on it. The solver is preparing to execute the request.

​
EXTRACTED (2)

The solver has extracted the funds from the source chain and is in the process of executing the request.

​
FULFILLED (3)

The request has been successfully executed on the destination chain. The funds have been delivered to the recipient address.

​
SETTLED (4)

The request has been fully settled, meaning all operations have been completed and confirmed on both chains.

​
EXPIRED (5)

The request has expired because it was not processed within the specified time limit. This could happen if no solver was available or if there were network issues.

​
CANCELLED (6)

The request was cancelled, either by the user or by the system.

​
REFUNDED (7)

The refund has been processed and the funds have been sent to the user’s address. The refund object contains details about the transaction hash and chain ID. Refund recipient:
  • If refunded on the source chain:
    • Onchain: Funds are sent to the msg.sender of the createRequest transaction
    • API: Funds are sent to the user address if submitted via submit endpoint
  • If refunded on the destination chain: Funds are sent to the receiver address

​
Example Implementation with Polling

Here’s an example of how to poll for status updates until a transaction is complete: 
// For Auto routes (using requestHash from submission)
// Terminal states: 3 = FULFILLED, 4 = SETTLED (success), 5 = EXPIRED, 6 = CANCELLED, 7 = REFUNDED (failure)
const TERMINAL_SUCCESS = [3, 4];
const TERMINAL_FAILURE = [5, 6, 7];
const TERMINAL_STATES = [...TERMINAL_SUCCESS, ...TERMINAL_FAILURE];

let status;
do {
  await new Promise((resolve) => setTimeout(resolve, 5000)); // Wait 5 seconds between checks
  console.log("Checking status...");
  try {
    status = await checkStatus(submitResult.requestHash);
    console.log("Status details:", status.bungeeStatusCode);
  } catch (error) {
    console.error("Failed to check status:", error?.message || "Unknown error");
  }
} while (!TERMINAL_STATES.includes(status?.bungeeStatusCode));

// Handle terminal states
if (TERMINAL_SUCCESS.includes(status?.bungeeStatusCode)) {
  console.log(
    "Transaction complete:",
    "\n- Hash:",
    status.destinationData?.txHash || "Transaction hash not available"
  );
} else {
  const statusNames = { 5: "EXPIRED", 6: "CANCELLED", 7: "REFUNDED" };
  console.error(
    "Transaction failed:",
    `\n- Status: ${statusNames[status?.bungeeStatusCode]} (${status?.bungeeStatusCode})`,
    "\n- Details:", JSON.stringify(status, null, 2)
  );
  throw new Error(`Request ${statusNames[status?.bungeeStatusCode]}`);
}

// For Manual routes (using transaction hash)
// Terminal states: 3 = FULFILLED, 4 = SETTLED (success), 5 = EXPIRED, 6 = CANCELLED, 7 = REFUNDED (failure)
const TERMINAL_SUCCESS = [3, 4];
const TERMINAL_FAILURE = [5, 6, 7];
const TERMINAL_STATES = [...TERMINAL_SUCCESS, ...TERMINAL_FAILURE];

let status;
do {
  await new Promise((resolve) => setTimeout(resolve, 5000)); // Wait 5 seconds between checks
  console.log("Checking status...");
  try {
    status = await checkStatus(transactionHash);
    console.log("Status details:", status?.bungeeStatusCode || "Pending");
  } catch (error) {
    console.error("Failed to check status:", error?.message || "Unknown error");
  }
} while (!status || !TERMINAL_STATES.includes(status?.bungeeStatusCode));

// Handle terminal states
if (TERMINAL_SUCCESS.includes(status?.bungeeStatusCode)) {
  console.log(
    "Transaction complete:",
    "\n- Hash:",
    status.destinationData?.txHash || "Transaction hash not available"
  );
} else {
  const statusNames = { 5: "EXPIRED", 6: "CANCELLED", 7: "REFUNDED" };
  console.error(
    "Transaction failed:",
    `\n- Status: ${statusNames[status?.bungeeStatusCode]} (${status?.bungeeStatusCode})`,
    "\n- Transaction Hash:", transactionHash,
    "\n- Details:", JSON.stringify(status, null, 2)
  );
  throw new Error(`Request ${statusNames[status?.bungeeStatusCode]}`);
}