Issuer trial

Issuer testnet PoC

Limited testnet path to register one route and settle without production File C and without production ADMIN_TOKEN. Trial keys still require an operator-minted sluzentrial_… invite. This is not open signup.

Buyer-only evaluate (no issuer key): /developers.

Back to Developers →

Mainnet gate

Why not production API alone

https://api.sluzen.network runs mainnet. Trial keys cannot sell there (403 trial_mainnet_forbidden). The PoC API must use a testnet XRPL_NODE (local stack below, or an operator-hosted testnet API if they give you one).

Path B (preferred for partners)

Operator-shared invite

If the operator already hosts a testnet API and mints a multi-claim invite:

  1. Open the invite URL they send (unlisted /trial?invite=).
  2. Claim → accept Terms → paste a testnet classic r… receive address → store the API key once.
  3. Console /app: create one active route (testnet create floor 0.001 XRP).
  4. Paid check from a funded testnet agent wallet against that API base URL (never against mainnet for sell tests).
export SLUZEN_API_URL=<operator-testnet-api>
export SLUZEN_HANDSHAKE_PATH=<your sourceRoute>
export XRPL_NODE=wss://s.altnet.rippletest.net:51233
export CLIENT_WALLET_SEED=<funded-testnet-seed>
npx --package=@sluzen/sdk sluzen-handshake pay

Ask the operator for: API base URL, web origin for /trial, and the invite. You never receive ADMIN_TOKEN.

Path A

Local isolated stack

Operators who already have the proxy monorepo can run a local testnet API: copy .env.example → .env, set a local ADMIN_TOKEN (≥32 chars), XRPL_NODE=wss://s.altnet.rippletest.net:51233, then npm install, npx prisma db push, npm run dev / npm run dev:web. Mint with npm run issuer:trial-invite. Never paste the production Oracle token into a local .env.

Shipped limits

Trial key rules

  • Network: testnet only; mainnet sell → trial_mainnet_forbidden
  • Routes: one active route per trial key
  • Platform take: off on testnet
  • Waiver / prepaid credits: not available on trial
  • Discovery: trial routes excluded
  • Key TTL: default 14 days from claim
  • Upgrade: File C via /app → production

Claim UI copy: "This key is for testing and does not allow sales on mainnet."

Network ids

CAIP-2 (x402-aligned)

Mainnet = xrpl:0. Testnet = xrpl:1. Confirm with GET {API}/health (environment + network). Same numerals as docs.x402.org / T54. SDK 2.0.0+ uses this mapping.

@sluzen/sdk on npm →

HTTP 402 guide →