Installation

Prerequisites

• Node.js 20+
• npm 10+
• Temple Wallet browser extension
• Tezos X Testnet configured in Temple (RPC URL: https://demo.txpark.nomadic-labs.com/rpc/tezlink)

---

Method 1 — Chrome Extension (recommended)

The Chrome/Brave/Firefox MV3 extension is the easiest way to use the relayer. It automatically injects window.ethereum on every page — no manual setup required.

Build the extension

git clone https://gitlab.com/tezos-infra/techrel/support-xdev-qa/tezosx-relayer.git
cd tezosx-relayer
npm install
npm run build:ext    # → extension/dist/

Load in Chrome or Brave

1. Open chrome://extensions (or brave://extensions)
2. Enable Developer mode (top-right toggle)
3. Click Load unpacked
4. Select the extension/ folder

Brave only: go to brave://settings/web3 → Default wallet → select None or Extensions to avoid conflict with Brave Wallet.

Load in Firefox

Firefox supports MV3 since Firefox 109.

1. Go to about:debugging → This Firefox
2. Click Load Temporary Add-on
3. Select extension/manifest.json

Development mode (auto-reload)

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

---

Method 2 — Script tag (own dApp)

If you control the page, add the IIFE bundle before any other scripts:

npm run build    # → dist/relayer.iife.js

<script src="/dist/relayer.iife.js"></script>

---

Method 3 — Tampermonkey userscript (testing only)

For quick testing on third-party sites without installing the extension.

1. Install Tampermonkey
2. Build the relayer: npm run build
3. Create a new Tampermonkey script and paste the content of dist/relayer.iife.js inline (see Injection Methods for the full template)

warning

Do not load the bundle via GM_xmlhttpRequest — inline it. Async loading breaks EIP-6963 timing.

---

Playground

Run the Next.js playground to test the relayer locally:

cd playground
npm install
npm run dev
# → http://localhost:3000

The playground lets you connect Temple, check your balance, send transfers, and interact with the Counter contract.