Build

Libraries and tools

The @neuraiproject packages on npm cover the whole path from words to a broadcast transaction, and all of them speak testnet. Everything the public services run is open source too.

Quick start

A testnet wallet in five lines

neurai-jswallet talks to https://rpc-testnet.neurai.org/rpc by default on testnet and checks the genesis before it scans any address.

JavaScript

import NeuraiWallet, { generateMnemonic } from "@neuraiproject/neurai-jswallet";

const wallet = await NeuraiWallet.createInstance({
  mnemonic: generateMnemonic(),
  network: "xna-ecdsa-test",          // tnq1r… addresses on testnet
});
console.log(await wallet.getReceiveAddress());
console.log(await wallet.getBalance());

Shell

npm install @neuraiproject/neurai-jswallet

Careful

Network labels differ between packages

The same label can mean a different address type in neurai-jswallet and in neurai-key 5. Pick the label from this table, not from habit.

Address	neurai-jswallet	neurai-key 5 and the builders
`t…`	`xna-test or xna-legacy-test`	`xna-legacy-test`
`tnq1r…`	`xna-ecdsa-test`	`xna-test`
`tpq1z…`	`xna-pq-strict-test`	`xna-pq-test`
`tnc1p…`	`xna-pq-test`	`xna-authscript-test`

npm

Packages

@neuraiproject/neurai-jswallet 0.17.1

Complete non-custodial wallet: keys, address discovery, UTXOs, signing, sends, assets and sweep.

Testnet: xna-test, xna-legacy-test, xna-ecdsa-test, xna-pq-strict-test, xna-pq-test

npm GitHub

@neuraiproject/neurai-key 5.0.3

BIP32/39/44 derivation of Legacy, ECDSA witness, post-quantum and AuthScript addresses.

Testnet: xna-test (tnq1r), xna-legacy-test (t), xna-pq-test (tpq1z), xna-authscript-test (tnc1p)

npm GitHub

@neuraiproject/neurai-rpc 0.7.0

JSON-RPC client for a node or the public proxy, including the DePIN commands.

Testnet: Exports TESTNET_GENESIS_HASH and assertRpcGenesis

npm GitHub

@neuraiproject/neurai-reader 0.2.0

Read-only chain queries: balances, transactions, assets.

Testnet: Reader.setTestnet(); checks the genesis

npm GitHub

@neuraiproject/neurai-create-transaction 0.9.2

Builds unsigned raw transactions: payments, asset issue, reissue, transfer, tags, freezes and DePIN.

Testnet: neurai-key labels such as xna-test and xna-authscript-test

npm GitHub

@neuraiproject/neurai-sign-transaction 3.1.0

Signs Legacy, AuthScript, post-quantum and ECDSA witness inputs, with opt-in sponsor signatures.

Testnet: Any -test label selects testnet keys

npm GitHub

@neuraiproject/neurai-scripts 0.9.2

Opcodes, ScriptBuilder, standard scripts and covenant templates such as partial-fill sell orders.

Testnet: The covenant opcodes are testnet-only; accepts xna-test

npm GitHub

@neuraiproject/neurai-message 0.11.0

Sign and verify messages with every address type that can sign.

Testnet: Chosen by address prefix

npm GitHub

@neuraiproject/neurai-assets 1.8.3

Non-custodial asset management: root, sub, unique, qualifier, restricted and DePIN tokens.

Testnet: network: "xna-test"

npm GitHub

@neuraiproject/neurai-depin-msg 3.1.3

Build, receive, verify and decrypt DePIN encrypted messages. Brings no network code of its own.

Testnet: network: "test"; derive keys with xna-legacy-test

npm GitHub

@neuraiproject/neurai-privacy 0.2.0

Private XNA payments: tnzk addresses from the wallet words, Groth16 proofs built on the device, pool scanner.

Testnet: network: "testnet"; testnet-only pool manifests

npm GitHub

@neuraiproject/neurai-history-list 1.2.9

Turns getaddressdeltas output into a readable list of incoming and outgoing transactions.

Testnet: Network-agnostic

npm GitHub

@neuraiproject/neurai-connect 0.0.2

Testnet: Network-agnostic relay

npm

@neuraiproject/neurai-sign-esp32 0.7.1

Create and sign PSBTs with an ESP32 hardware wallet over Web Serial.

Testnet: Testnet prefixes and tnc1p post-quantum

npm GitHub

Versions are the latest published when this page was built.

Self-host

Run the services yourself

The public testnet services are open source. Each repository ships a Docker setup.

neurai-rpc-proxy The JSON-RPC proxy behind rpc-testnet: method whitelist, failover and genesis check. rebel-xna-explorer The testnet block explorer and its REST API. Ships a testnet Docker stack. neurai-faucet The faucet: Astro front end, Redis rate limits, Turnstile or Neurai Connect. neurai-wallet-services WebSocket push service for wallets: address subscriptions, chain tip, broadcast. electrs-neurai Electrum server with asset extensions. Testnet Electrum port 60001.

After a testnet reset

Pin the genesis hash in your app (neurai-rpc exports TESTNET_GENESIS_HASH and assertRpcGenesis) and key every cache by network and genesis, so data from a previous testnet never leaks into the new one.