Skip to main content
Version: Next

Build System

The relayer uses esbuild for fast bundling. There are two independent build targets: the IIFE bundle (for script-tag injection) and the MV3 extension.

IIFE bundle (script tag / Tampermonkey)​

npm run build

Output:

dist/
├── relayer.iife.js      ← injectable bundle
└── relayer.iife.js.map  ← source map

Config highlights​

// build.mjs
await esbuild.build({
  entryPoints: ['src/index.ts'],
  bundle: true,
  format: 'iife',       // Self-executing — no module system required
  platform: 'browser',
  target: ['es2020'],
  outfile: 'dist/relayer.iife.js',
  sourcemap: true,
  alias: {
    events: 'eventemitter3',
    crypto: './src/polyfills/crypto.js',
  },
  define: {
    global: 'globalThis',
    'process.env.NODE_ENV': '"production"',
  },
});

MV3 Extension​

npm run build:ext

Output:

extension/dist/
├── injected.js    ← window.ethereum (world: MAIN)
├── content.js     ← session bridge (world: ISOLATED)
├── background.js  ← service worker
└── popup.js       ← popup UI

Each entry point is bundled as an ES module (format: 'esm') since MV3 supports native ES modules in service workers.

Development mode (auto-reload)​

npm run dev:ext    # launches Chromium with the extension pre-loaded via web-ext

Type-checking​

npm run typecheck      # checks src/
npm run typecheck:ext  # checks extension/src/