Neo Smart ChainJoin the launch

USD Neo (USDN)

Developer integration guide

How wallets, exchanges and applications can integrate USDN on Neo Smart Chain.

Version
0.1
Last updated
November 17, 2026
Status
Draft
Download PDF

1.Overview

USDN is a fungible token on Neo Smart Chain. Because the network is EVM-compatible, it can be used with standard JSON-RPC endpoints and common libraries such as ethers, viem and web3.js.

2.Network and token details

ItemValue
Network nameNeo Smart Chain
RPC URL[JSON-RPC endpoint]
Chain ID[chain ID]
Native gas asset[symbol]
Block explorer[explorer URL]
Token name and symbolUSD Neo, USDN
Decimals[confirm: 6 or 18]
Contract address[Neo Smart Chain contract address]

3.Read a balance

import { Contract, JsonRpcProvider, formatUnits } from 'ethers'

const provider = new JsonRpcProvider(process.env.NEO_SMART_CHAIN_RPC_URL)
const abi = [
  'function balanceOf(address) view returns (uint256)',
  'function decimals() view returns (uint8)',
]

const usdn = new Contract(process.env.USDN_ADDRESS!, abi, provider)
const [raw, decimals] = await Promise.all([
  usdn.balanceOf('0xYourAddress'),
  usdn.decimals(),
])

console.log(formatUnits(raw, decimals) + ' USDN')

4.Transfer USDN

import { Contract, JsonRpcProvider, Wallet, parseUnits } from 'ethers'

const provider = new JsonRpcProvider(process.env.NEO_SMART_CHAIN_RPC_URL)
const signer = new Wallet(process.env.PRIVATE_KEY!, provider)
const abi = ['function transfer(address to, uint256 amount) returns (bool)']

const usdn = new Contract(process.env.USDN_ADDRESS!, abi, signer)
const tx = await usdn.transfer('0xRecipient', parseUnits('25', 6))
await tx.wait()

5.Integration checklist for exchanges and wallets

  • Confirm the contract address against neosmartchain.com/tokens/usdn.
  • Read decimals from the contract instead of hard-coding them.
  • Wait for the number of confirmations you require before crediting deposits.
  • Handle the pause and address-restriction controls described in the whitepaper: transfers can fail while they are active.
  • Subscribe to the Transfer event to track deposits and withdrawals.
  • Never display or rely on a contract address that is not published on this site.

6.Other blockchains

Each additional blockchain has its own contract address, listed on the token page. Do not reuse an address across networks. Cross-chain transfers use [confirm: bridge mechanism] and are documented in the chain-specific guide when available.

This document is for information only and is not financial, legal or tax advice. Highlighted items in square brackets are still to be confirmed by the issuer. The latest version is always on this page, and a PDF copy is available above.