Skip to Content
Overview

TxNod documentation

Test your integration in seconds with sandbox; ship to mainnet when ready.

TxNod is a non-custodial crypto payment gateway. It accepts fifteen assets across seven chains — BTC; ETH + ERC-20 USDT/USDC; POL + Polygon USDT/USDC on Polygon PoS; BNB + BEP-20 USDT/USDC on BNB Smart Chain; TRX + TRC-20 USDT on TRON; ADA on Cardano; and TON + jetton USDT — via provider-backed chain adapters, and no local signing material ever touches the system. Partners integrate via the REST API and the @txnod/sdk TypeScript client (zero runtime and peer dependencies — types fully expanded inside the published tarball, no zod or @txnod/shared install required); the SDK runs in any server-side Node ≥ 20 framework (Express, Fastify, Hono, Koa, NestJS, plain node:http, Next.js App Router or Pages, Nuxt, SvelteKit, Remix, Astro, etc.). Invoice state changes surface as HMAC-signed webhooks. Sandbox, mainnet, and testnet are all supported end-to-end.

Start here

  • New to TxNod? → Quickstart (sandbox-first) — zero to a verified sandbox invoice in 5 minutes; mainnet flow follows in Track 2.
  • Want safety analysis? → Sandbox safety — per-chain truth table + seven-layer defense + the recommended CI assertion.
  • API Reference — every endpoint, every schema, every error code.
  • SDK — TxnodClient, verifyWebhookSignature, the full typed-error hierarchy.
  • Webhooks — seven event types and the reorg-safety contract; envelope’s mode: 'production' | 'testnet' | 'sandbox' discriminator.
  • MCP — Connect Claude Code, Claude Desktop, or Cursor to the TxNod MCP server. The 14 sandbox MCP tools (per sandbox:simulate scope) and the 7 read-only tools surface invoices, projects, webhook history, and FX-rate quotes to AI agents.
  • Day-two guides — API keys, Wallets, Configuring partner webhooks, Invoices.

For AI agents

Every page is also served as raw Markdown at the same URL with a .md suffix (e.g. /api/invoices → https://docs.txnod.com/api/invoices.md ). The master index an agent can walk from a single URL is https://docs.txnod.com/llms.txt  — it lists every page with both the rendered and .md URLs.

If the project you are integrating has already installed @txnod/sdk, prefer the bundled SDK documentation at node_modules/@txnod/sdk/docs/ and the agent entry point at node_modules/@txnod/sdk/AGENTS.md — it is the same content as the SDK section of this site, frozen at the installed SDK version, and it needs no network access.

Quickstart