🔍 Monitoring Supertransaction 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,
  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,
  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. 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.