Transaction Hints

trace.addTxHint('0x123abc...', 'ethereum');

trace.addTxHint('0x123abc...', 'ethereum', 'Main swap transaction');
trace.addTxHint('0x456def...', 'polygon', 'Bridge to Polygon');

import type { ChainName } from '@miradorlabs/web-sdk';

const chain: ChainName = 'ethereum';
trace.addTxHint(txHash, chain);

const trace = client.trace({ name: 'CrossChainSwap' })
  .addEvent('swap_initiated');

// First transaction on Ethereum — Mirador follows it through the DEX
trace.addTxHint(ethTxHash, 'ethereum', 'Swap ETH to USDC');

// Bridge transaction — Mirador tracks it as it crosses to Polygon
trace.addTxHint(bridgeTxHash, 'ethereum', 'Bridge to Polygon');

// Final transaction on Polygon — full end-to-end trace across chains
trace.addTxHint(polygonTxHash, 'polygon', 'Receive on Polygon');

import { Client } from '@miradorlabs/web-sdk';

const client = new Client('your-api-key');

async function executeSwap(params: SwapParams) {
  const trace = client.trace({ name: 'TokenSwap' })
    .addAttributes({
      inputToken: params.inputToken,
      outputToken: params.outputToken,
      inputAmount: params.amount,
      userAddress: params.userAddress
    })
    .addTags(['swap', 'dex', params.chain])
    .addEvent('swap_initiated');

  try {
    // User signs transaction
    trace.addEvent('user_signing');
    const tx = await wallet.sendTransaction(swapTx);

    trace.addEvent('transaction_sent', { txHash: tx.hash });

    // Add transaction hint for correlation
    trace.addTxHint(tx.hash, params.chain, 'Swap transaction');

    // Wait for confirmation
    const receipt = await tx.wait();

    trace.addEvent('transaction_confirmed', {
      blockNumber: receipt.blockNumber,
      gasUsed: receipt.gasUsed.toString()
    });

  } catch (error) {
    trace.addEvent('swap_failed', { error: error.message });
  }
}

addTxHint(
  txHash: string,
  chain: ChainName,
  details?: string
): Trace

const tx = await wallet.sendTransaction(txData);

// Add hint immediately after sending
trace.addTxHint(tx.hash, 'ethereum');

// Then wait for confirmation
await tx.wait();

trace.addTxHint(approveTx, 'ethereum', 'Token approval');
trace.addTxHint(swapTx, 'ethereum', 'Swap execution');

// Correct
trace.addTxHint(polygonTxHash, 'polygon');

// Incorrect - wrong chain
trace.addTxHint(polygonTxHash, 'ethereum');