Attributes & Tags

trace.addAttribute('userId', 'user-123')
     .addAttribute('amount', 1.5)
     .addAttribute('currency', 'ETH');

trace.addAttributes({
  from: '0xabc...',
  to: '0xdef...',
  value: '1.5',
  gasLimit: 21000
});

trace.addAttribute('config', {
  slippage: 0.5,
  deadline: 300,
  route: ['ETH', 'USDC', 'DAI']
});
// Stored as: '{"slippage":0.5,"deadline":300,"route":["ETH","USDC","DAI"]}'

// User context
trace.addAttributes({
  userId: user.id,
  walletAddress: user.wallet,
  sessionId: session.id
});

// Transaction details
trace.addAttributes({
  txHash: receipt.hash,
  blockNumber: receipt.blockNumber,
  gasUsed: receipt.gasUsed.toString()
});

// Operation parameters
trace.addAttributes({
  inputToken: 'ETH',
  outputToken: 'USDC',
  inputAmount: '1.5',
  slippage: '0.5%'
});

trace.addTag('ethereum')
     .addTag('swap')
     .addTag('production');

trace.addTags(['dex', 'uniswap', 'v3']);

const trace = client.trace({ name: 'NFTMint' })
  .addTags(['nft', 'mint', 'ethereum', 'production']);

addAttribute(key: string, value: string | number | object): Trace
addAttributes(attrs: Record<string, string | number | object>): Trace

addTag(tag: string): Trace
addTags(tags: string[]): Trace

// Good - consistent camelCase
trace.addAttributes({
  userId: '123',
  walletAddress: '0x...',
  transactionHash: '0x...'
});

// Avoid - mixed conventions
trace.addAttributes({
  user_id: '123',
  WalletAddress: '0x...',
  'transaction-hash': '0x...'
});

// Good
trace.addAttribute('walletAddress', publicAddress);

// Never do this
trace.addAttribute('privateKey', wallet.privateKey);

// Good
trace.addTags(['ethereum', 'swap', 'uniswap']);

// Avoid
trace.addTags(['eth', 'sw', 'uni']);