Skip to main content
Version: 0.2.1

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.