Skip to main content
The Mirador SDKs let you create and manage distributed traces, correlate them with blockchain transactions, and follow those transactions end-to-end across chains, bridges, and protocols. Two SDKs are available today:
  • Web SDK (@miradorlabs/web-sdk) — for browser-based applications, with automatic browser metadata collection
  • Node.js SDK (@miradorlabs/nodejs-sdk) — for server-side applications
SDKs for Python, Go, Rust, and other languages are currently in development. Contact us if you’re interested in early access.

​
Key Features

Blockchain Integration

Follow transactions end-to-end across chains, bridges, and protocols on Ethereum, Polygon, Arbitrum, Base, Optimism, and BSC

Web3 Demo App

Interactive example app covering wallet discovery, transaction sending, and full trace lifecycle

Browser Metadata

Automatic collection of 27+ browser environment metrics

Fluent Builder Pattern

Clean, chainable API for building traces

TypeScript Support

Full type definitions included for excellent developer experience

Stack Trace Capture

Capture stack traces at trace creation and event points for debugging

​
Quick Example

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

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

const trace = client.trace({ name: 'SwapExecution' })
  .addAttribute('from', '0xabc...')
  .addTags(['dex', 'swap'])
  .addEvent('quote_received');
// → CreateTrace sent automatically at end of current microtask

trace.addEvent('transaction_signed')
     .addTxHint('0xtxhash...', 'ethereum');
// → UpdateTrace sent automatically

​
Browser Compatibility

The SDK is compatible with modern browsers:
  • Chrome
  • Firefox
  • Safari
  • Edge
For older browsers, you may need polyfills for ES2020+ features, Fetch API, and Promises.

​
Next Steps

Quickstart

Get up and running in minutes

Core Concepts

Learn about traces, events, and attributes

Web3 Demo App

See a full working example with real wallet interactions