Tezos X — free-route SDK demo dApp

Warning

Not production-ready. This app only demonstrates how to integrate the @baking-bad/free-route-tezos-x SDK — it is not audited or hardened. Running it against mainnet is entirely at your own risk.

Note

Not affiliated with objkt. This demo is not affiliated with, sponsored, or endorsed by objkt.com. "objkt" refers to the objkt marketplace contract interface (ask / fulfill_ask) the demo integrates with; on previewnet it talks to a self-deployed copy of that contract, not to objkt.com.

Live demo: 3route-tezos-x-sdk-demo.vercel.app

A Next.js reference integration of the @baking-bad/free-route-tezos-x SDK (consumed as an npm package), on Tezos X previewnet. It drives every flow from both wallet sides — Temple (a single-signature Michelson op-group) and MetaMask (an EVM tx batch):

• Buyer (/) — pay any ERC20 for an XTZ-priced NFT on the objkt-style marketplace (swap → fulfill, composed atomically). Optional NFT recipient (proxy_for).
• Bridge (/bridge) — swap any token ↔ any token. Optional 0x receiver for the output.
• Seller (/seller) — mint + list test NFTs as XTZ-priced asks on the objkt-style marketplace contract.
• My NFTs (/owned) — tokens owned by the connected wallet's Michelson holder (your tz1, or the account's KT1 alias on MetaMask).

Signing is client-side (Temple/Beacon · MetaMask/EIP-6963). The free-route API key stays server-side — reads are proxied through /api/free-route/* (the BFF), so the key never reaches the browser. Michelson op-groups are sized on the node with the SDK's estimateMichelsonOperation right before the wallet prompt (lib/opsMichelson.ts sendWalletGroup) — the call_evm ops need a margin over a bare wallet estimate.

For the full architecture, the server/client key split, and copy-paste SDK examples per flow, see the Docs page (source: app/docs/page.tsx). The SDK's own README has the API reference.

Run

npm install
npm run dev          # http://localhost:3001

Connect Temple (or MetaMask) on Tezos X previewnet — the Bridge page links to the faucet for test XTZ. Working previewnet defaults live in lib/config.ts; override via .env.local (FREE_ROUTE_API / FREE_ROUTE_API_KEY are server-only).