Get started

Installation


npm install @nymproject/mix-fetch

ESM only, with the worker and WASM inlined via mix-tunnel; no bundler config needed.

Quick start


import { setupMixTunnel, mixFetch, disconnectMixTunnel } from '@nymproject/mix-fetch';
 
// Bring the shared mixnet tunnel up. Same call works from mix-dns and mix-websocket.
await setupMixTunnel();
 
// Drop-in fetch. The Response is the real DOM Response, not a wrapper.
const res = await mixFetch('https://example.com');
console.log(res.status, await res.text());
 
// Tear down. The WASM is unusable after this until page reload.
await disconnectMixTunnel();

For one-shot use without an explicit setup step, the createMixFetch helper combines setup and fetch:


import { createMixFetch } from '@nymproject/mix-fetch';
 
const mixFetch = await createMixFetch({ disableCoverTraffic: true });
const res = await mixFetch('https://example.com');

Call createMixFetch once and reuse the function it returns. It calls setupMixTunnel internally, so calling createMixFetch a second time rejects with tunnel already initialised; the tunnel is one-shot per page.

Run mixFetch live in the mixnet playground, with a tunnel-vs-clearnet comparison.