MiradorProvider

Web Client SDK:

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

Node.js SDK:

import { MiradorProvider } from '@miradorlabs/nodejs-sdk';

Overview

MiradorProvider wraps any EIP-1193 compatible provider and automatically captures transaction data into Mirador traces. It intercepts eth_sendTransaction and eth_sendRawTransaction calls, recording tx hints and errors, while passing all other RPC methods through unchanged.

Constructor

new MiradorProvider(
  underlying: EIP1193Provider,
  client: Client,
  options?: MiradorProviderOptions
)

Parameters

Parameter	Type	Required	Description
`underlying`	`EIP1193Provider`	Yes	The underlying wallet provider
`client`	`Client`	Yes	Mirador client instance
`options`	`MiradorProviderOptions`	No	Configuration options

MiradorProviderOptions

Option	Type	Description
`trace`	`Trace`	Bind to an existing trace (otherwise a new trace per tx)
`traceOptions`	`TraceOptions`	Options for auto-created traces (ignored if `trace` is set)

Examples

Basic usage:

const client = new Client('api-key');
const provider = new MiradorProvider(window.ethereum, client);

With trace options:

const provider = new MiradorProvider(window.ethereum, client, {
  traceOptions: {
    name: 'WalletTransactions',
    maxRetries: 5
  }
});

Bound to a trace:

const trace = client.trace({ name: 'CheckoutFlow' });
const provider = new MiradorProvider(window.ethereum, client, { trace });

Methods

request()

Send an RPC request through the provider. Implements the EIP-1193 request interface.

async request(args: { method: string; params?: unknown[] }): Promise<unknown>

Intercepted Methods

Method	Behavior
`eth_sendTransaction`	Captures tx hash, chain, input data, and errors
`eth_sendRawTransaction`	Captures tx hash and errors
All other methods	Passed through to the underlying provider unchanged

Parameters

Parameter	Type	Description
`args.method`	`string`	RPC method name
`args.params`	`unknown[]`	Method parameters

Returns

Promise<unknown> — the RPC response from the underlying provider

Examples

// Transaction — intercepted and captured
const txHash = await provider.request({
  method: 'eth_sendTransaction',
  params: [{
    from: '0xabc...',
    to: '0xdef...',
    data: '0xa9059cbb...',
    value: '0x0'
  }]
});

// eth_call — passed through unchanged
const result = await provider.request({
  method: 'eth_call',
  params: [{ to: '0xdef...', data: '0x...' }, 'latest']
});

Captured Data

On Successful Transaction

When eth_sendTransaction succeeds, the following is captured in the trace:

TxHint: transaction hash + chain + input data (calldata)
Event tx:sent: { txHash, method: 'eth_sendTransaction' }

On Failed Transaction

When a transaction fails (user rejection, revert, etc.), the following is captured:

Event tx:error: { message, code, data, method }

The original error is always re-thrown.

Next Steps

EIP-1193 Provider Guide

Detailed guide with library integration examples

Types

EIP1193Provider, MiradorProviderOptions

Classes

Web3

Types

Overview

Constructor

Parameters

MiradorProviderOptions

Examples

Methods

request()

Intercepted Methods

Parameters

Returns

Examples

Captured Data

On Successful Transaction

On Failed Transaction

Next Steps

EIP-1193 Provider Guide

Types

​Overview

​Constructor

​Parameters

​MiradorProviderOptions

​Examples

​Methods

​request()

​Intercepted Methods

​Parameters

​Returns

​Examples

​Captured Data

​On Successful Transaction

​On Failed Transaction

​Next Steps

EIP-1193 Provider Guide

Types

Overview

Constructor

Parameters

MiradorProviderOptions

Examples

Methods

request()

Intercepted Methods

Parameters

Returns

Examples

Captured Data

On Successful Transaction

On Failed Transaction

Next Steps