@x1ns/constants

Shared constants package for X1NS (X1 Name Service).

Important Notes

• XNT is the native token on X1 blockchain (equivalent to SOL on Solana)
• XNT uses the same mint address as SOL: So11111111111111111111111111111111111111112
• USDC is not yet available on X1, but placeholders are included for future support

Installation

pnpm add @x1ns/constants

Usage

import {
  getRpcEndpoint,
  getRegistrarProgramId,
  getTldConfig,
  getMintAddress,
  RECORD_KEYS,
} from "@x1ns/constants";

// Get RPC endpoint
const rpc = getRpcEndpoint("testnet");
console.log(rpc); // https://rpc.testnet.x1.xyz

// Get program ID
const programId = getRegistrarProgramId("testnet");

// Get TLD config
const x1Tld = getTldConfig("x1", "testnet");
console.log(x1Tld.label); // "x1"

// Get mint address
const wxntMint = getMintAddress("WXNT", "testnet");

// Available record keys
console.log(RECORD_KEYS); // ["url", "ipfs", "arwv", ...]

Generated Configuration

After deployment, a generated configuration file is created at:

• generated/testnet.json
• generated/mainnet.json

These files contain actual program IDs, TLD authorities, and mint addresses.

Environment Variables

You can override defaults with environment variables:

X1_RPC=https://custom-rpc.x1.xyz
X1_NETWORK=testnet
REGISTRAR_PROGRAM_ID=ABC...xyz
WXNT_MINT=XYZ...abc

License

MIT