Monitor Execution & Completion

After executing a supertransaction with meeClient.executeQuote(...), you need a way to track whether it succeeded. Biconomy MEE provides two main tools to monitor transaction status:

1. `waitForSupertransactionReceipt`

This is the recommended approach for most use cases.

const { hash } = await meeClient.executeQuote({ quote });

const receipt = await meeClient.waitForSupertransactionReceipt({
  hash,
  mode: "default",
  confirmations: 2, // optional
});

Parameters

hash (required): The supertransaction hash returned by executeQuote
confirmations (optional): How many confirmations to wait for after mining

When to use

Use this method when you:

Want a simple blocking workflow
Only proceed after the transaction is complete
Do not need partial updates or background monitoring

Example

if (receipt.transactionStatus === "MINED_SUCCESS") {
  console.log("Transaction succeeded!");
} else {
  console.error("Failed:", receipt.transactionStatus);
}

2. `getSupertransactionReceipt`

This method gives real-time, snapshot-based access to the current transaction status.

const receipt = await meeClient.getSupertransactionReceipt({
  hash,
  mode: "fast-block",
  waitForReceipts: true, // optional
  confirmations: 2, // optional
});

Parameters

hash (required): The supertransaction hash
waitForReceipts (optional, default: true): Wait for receipts before resolving
confirmations (optional): Number of confirmations to wait for

When to use

Use this method when you:

Want to check status in the background
Are building your own UI polling or refresh interval
Don’t want to block the app while waiting

Example

if (receipt.transactionStatus === "PENDING") {
  console.log("Still waiting...");
} else if (receipt.transactionStatus === "MINED_SUCCESS") {
  console.log("Confirmed on all chains!");
} else {
  console.log("Error or failure:", receipt.transactionStatus);
}

You can also inspect individual user operations:

receipt.userOps.forEach((op) => {
  console.log(`Chain ${op.chainId} status: ${op.executionStatus}`);
});

3. Supertransaction Wait Mode

string

default:"default"

Transaction confirmation mode. Controls how many confirmations to wait for before returning a response.Options:

default - Waits for multiple confirmations (recommended for most use cases)
fast-block - Returns after 1 block confirmation for faster response times
The fast-block mode only waits for 1 block confirmation. In worst-case scenarios, the transaction may be reorged or replaced.

4. Generating a MEE Scan Link

To let users view their transaction on an explorer:

import { getMeeScanLink } from "@biconomy/abstractjs";

const link = getMeeScanLink(hash);
console.log("View your transaction:", link);

You can also display explorer links from the receipt:

receipt.explorerLinks.forEach((link) => console.log(link));

With these two monitoring tools, you can choose between blocking and non-blocking strategies depending on your app flow. For most users, waitForSupertransactionReceipt will be easiest to integrate.

Welcome

ERC-8211 Smart Batching

Supertransaction API

AbstractJS SDK

Monitor Execution & Completion

1. `waitForSupertransactionReceipt`

Parameters

When to use

Example

2. `getSupertransactionReceipt`

Parameters

When to use

Example

3. Supertransaction Wait Mode

4. Generating a MEE Scan Link

​1. waitForSupertransactionReceipt

​Parameters

​When to use

​Example

​2. getSupertransactionReceipt

​Parameters

​When to use

​Example

​3. Supertransaction Wait Mode

​4. Generating a MEE Scan Link

1. `waitForSupertransactionReceipt`

Parameters

When to use

Example

2. `getSupertransactionReceipt`

Parameters

When to use

Example

3. Supertransaction Wait Mode

4. Generating a MEE Scan Link