Guides
Prerequisites

Prerequisites

Before using DeroPay or DeroAuth, you need a running DERO wallet and a Node.js environment.

Requirements

  • Node.js >= 20.0.0
  • DERO wallet — Engram (desktop) or DERO CLI wallet
  • DERO daemon — synced to mainnet or testnet

DERO Wallet Setup

Engram is the official desktop wallet for DERO with built-in XSWD support.

  1. Download from dero.io (opens in a new tab)
  2. Create or restore a wallet
  3. XSWD is enabled automatically on ws://localhost:44326

Engram is recommended for development — it provides the best XSWD experience for both auth and payments.

DERO Daemon

The daemon must be running and synced for payment monitoring:

# Mainnet
derod --rpc-bind=127.0.0.1:10102
 
# Testnet
derod --rpc-bind=127.0.0.1:40402 --testnet

Default Ports

ServiceMainnetTestnet
Wallet RPC127.0.0.1:10103127.0.0.1:40403
Daemon RPC127.0.0.1:10102127.0.0.1:40402
Engram XSWDws://localhost:44326ws://localhost:44326

Install the SDKs

# Payments
bun add dero-pay
 
# Authentication
bun add dero-auth
 
# Both
bun add dero-pay dero-auth
⚠️

Both packages are ESM-only ("type": "module"). Make sure your project supports ES modules.

Next Steps

Gateway Server