Node Guide

A node is a host connected to the DecentralChain network that validates transactions, stores blocks, and — if it meets the generating-balance requirement — produces new blocks under Leased Proof of Stake. This section covers running your own node: getting the software, building it, and configuring it. For the economics of block generation (rewards, leasing), see the Node article in the DecentralChain fundamentals section.

Open Source

The node is built and maintained in the open at Decentral-America/node-scala.

JVM-Based

Written in Scala, packaged as a runnable JAR or DEB.

REST API

Every node exposes an HTTP API compatible with the Dcc node API shape.

Mainnet & Testnet

The same codebase builds packages for either network.

Getting the Node

The node implementation lives at Decentral-America/node-scala, forked from Dcc 1.6.x. Docker is the simplest way to run it; to install directly, see Linux, macOS or Windows. All are written in Scala, built with SBT, and packaged from the same source for either network:

sbt packageAll                   # Mainnet
sbt -Dnetwork=testnet packageAll # built-in testnet profile, NOT the public Testnet

To run a node on the public Testnet, use the Docker image with the configuration file in Join the Public Testnet.

Configuration

Network-specific defaults are defined in network-defaults.conf in the node-scala repository. Pass your own config file (based on the mainnet/testnet template) as the argument to the JAR to override generating-node settings such as the block reward vote and wallet seed.

Node Guide

• Node REST API
  • Base URL, port and interactive docs
  • Authentication
  • Commonly used endpoints
  • Limits
  • Pagination
  • Error Responses
  • CORS
• Node Extensions
  • gRPC Server
• Custom Blockchain
• Run a Node with Docker
  • Which Network You Can Join
  • Requirements
  • Image tags
  • Ports
  • The Configuration File Is Required
  • Quick start
  • Docker Compose
  • Verify it is running
• Configuration
  • Environment variables (Docker)
  • Ports and network defaults
  • Commonly changed settings
  • API key
  • Example: minimal Mainnet file
• Sync, Import, Export and Rollback
  • Initial sync
  • Exporting blocks
  • Importing blocks
  • Rolling back
  • Full re-sync
• Upgrade a Node
  • Docker
  • Reverting an upgrade
  • From a JAR
  • Network upgrades
• Node Wallet and Block Generation
  • The node wallet
  • Wallet endpoints
  • Generating blocks
• Logging
  • Docker
  • Custom logback configuration
  • Logs worth watching
• Features and Activation
  • How activation works
  • Unsupported features
  • Feature list in v1.8.0
  • Finality and HotStuff
• Troubleshooting
  • Useful checks
  • Adding a peer at runtime
  • Reporting an issue
• Installing on Linux
  • Prerequisites
  • Install the JDK (Ubuntu/Debian)
  • Install SBT (Ubuntu/Debian)
  • Build from source
  • Run from the tarball
  • Install the DEB package you built
  • Next steps
• Installing on macOS
  • Prerequisites
  • Install the JDK
  • Run from the tarball
  • Build from source
  • Next steps
• Installing on Windows
  • Prerequisites
  • Run from the tarball
  • Build the tarball
  • Next steps
• Join the Public Testnet
  • Network facts
  • 1. Write the configuration file
  • 2. Start the node
  • 3. Check that it follows the chain
  • Getting Testnet DCC
  • Ports