TETSUONODE - Run Your Own Node

████████╗███████╗████████╗███████╗██╗   ██╗ ██████╗ ███╗   ██╗ ██████╗ ██████╗ ███████╗
╚══██╔══╝██╔════╝╚══██╔══╝██╔════╝██║   ██║██╔═══██╗████╗  ██║██╔═══██╗██╔══██╗██╔════╝
   ██║   █████╗     ██║   ███████╗██║   ██║██║   ██║██╔██╗ ██║██║   ██║██║  ██║█████╗
   ██║   ██╔══╝     ██║   ╚════██║██║   ██║██║   ██║██║╚██╗██║██║   ██║██║  ██║██╔══╝
   ██║   ███████╗   ██║   ███████║╚██████╔╝╚██████╔╝██║ ╚████║╚██████╔╝██████╔╝███████╗
   ╚═╝   ╚══════╝   ╚═╝   ╚══════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝ ╚═════╝ ╚═════╝ ╚══════╝

                          DISTRIBUTED BLOCKCHAIN NODE
                            Join the decentralized network

TETSUONODE - Run Your Own Node

The singularity begins with a single block — Execute your node and become part of the TETSUO ecosystem

Overview

TETSUONODE is your gateway to running a full node on the TETSUO blockchain network.

What is a Node?

A TETSUO node is a peer in the decentralized network that:

Downloads and validates the entire blockchain
Relays transactions across the network
Maintains network security and integrity
(Optional) Mines new TETSUO blocks
Strengthens network decentralization

Why Run a Node?

Benefit	Description
Security	Help validate transactions and secure the network
Mining	Earn TETSUO by mining blocks (optional)
Decentralization	Make the network more resilient
Control	Full access to blockchain data
Community	Join the TETSUO ecosystem

System Requirements

Minimum Requirements

CPU:        Dual-core (2+ cores recommended)
RAM:        2 GB minimum (4 GB recommended)
Storage:    5 GB free space (10 GB+ for full chain)
Bandwidth:  1 Mbps+ stable connection
OS:         macOS, Linux, or Windows
Uptime:     24/7 recommended

Recommended Specifications

CPU:        Quad-core or better
RAM:        8 GB
Storage:    20 GB+ (SSD preferred)
Bandwidth:  10 Mbps+
Connection: Fiber or stable broadband
Uptime:     Always online

Quick Start

One-Command Installation

macOS

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Pavelevich/tetsuonode/main/scripts/install-macos.sh)"

Linux (Ubuntu/Debian)

curl -fsSL https://raw.githubusercontent.com/Pavelevich/tetsuonode/main/scripts/install-linux.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/Pavelevich/tetsuonode/main/scripts/install-windows.ps1 | iex

macOS Installation

Step 1: Install Homebrew (if not already installed)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2: Install Dependencies

brew install git automake libtool boost openssl libevent

Step 3: Clone Repository

git clone https://github.com/Pavelevich/tetsuonode.git
cd tetsuonode

Step 4: Build TETSUO Core

cd tetsuo-core
./autogen.sh
./configure --disable-wallet
make -j$(sysctl -n hw.ncpu)

Step 5: Configure Node

mkdir -p ~/.tetsuo
cat > ~/.tetsuo/tetsuo.conf << 'EOF'
server=1
listen=1
txindex=1
maxconnections=256
port=8338
rpcport=8336
rpcallowip=127.0.0.1
rpcbind=127.0.0.1
fallbackfee=0.0001
addnode=tetsuoarena.com:8338
EOF

Step 6: Start Node

./build/bin/tetsuod -daemon -datadir=$HOME/.tetsuo

Step 7: Verify Installation

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo getblockchaininfo

Node is running!

Linux Installation

Ubuntu/Debian

Step 1: Update System

sudo apt-get update && sudo apt-get upgrade -y

Step 2: Install Dependencies

sudo apt-get install -y \
    build-essential \
    libssl-dev \
    libboost-all-dev \
    libevent-dev \
    git \
    automake \
    libtool

Step 3: Clone Repository

git clone https://github.com/Pavelevich/tetsuonode.git
cd tetsuonode/tetsuo-core

Step 4: Build

./autogen.sh
./configure --disable-wallet
make -j$(nproc)

Step 5: Configure

mkdir -p ~/.tetsuo
cat > ~/.tetsuo/tetsuo.conf << 'EOF'
server=1
listen=1
txindex=1
maxconnections=256
port=8338
addnode=tetsuoarena.com:8338
fallbackfee=0.0001
EOF

Step 6: Start Node

./build/bin/tetsuod -daemon -datadir=$HOME/.tetsuo

Step 7: Verify

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo getblockcount

Node is running!

Windows Installation

Prerequisites

Git: https://git-scm.com/download/win
Visual Studio Build Tools or Microsoft C++ Build Tools
Boost Libraries (pre-compiled available)

Step 1: Install Dependencies

Option A: Automated (Recommended)

# Run as Administrator
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://raw.githubusercontent.com/Pavelevich/tetsuonode/main/scripts/install-windows.ps1 | iex

Option B: Manual

Download and install Git for Windows
Install Microsoft C++ Build Tools
Download Boost precompiled binaries

Step 2: Clone Repository

git clone https://github.com/Pavelevich/tetsuonode.git
cd tetsuonode\tetsuo-core

Step 3: Build

# Run from Visual Studio Developer Command Prompt (as Administrator)
.\configure.bat
msbuild build_msvc\Bitcoin.sln /m /p:Configuration=Release

Step 4: Create Data Directory

mkdir $env:APPDATA\Tetsuo
mkdir $env:APPDATA\Tetsuo\.tetsuo

Step 5: Configure Node

Create file: %APPDATA%\Tetsuo\.tetsuo\tetsuo.conf

server=1
listen=1
txindex=1
maxconnections=256
port=8338
addnode=tetsuoarena.com:8338
fallbackfee=0.0001

Step 6: Start Node

# Navigate to build directory
cd build_msvc\x64\Release

# Run daemon
.\tetsuod.exe -datadir="$env:APPDATA\Tetsuo\.tetsuo"

# Or run in background
Start-Process -WindowStyle Hidden -FilePath ".\tetsuod.exe" -ArgumentList "-datadir=$env:APPDATA\Tetsuo\.tetsuo"

Step 7: Verify

.\tetsuo-cli.exe -datadir="$env:APPDATA\Tetsuo\.tetsuo" getblockcount

Node is running!

Advanced Configuration

Enable Mining

Edit ~/.tetsuo/tetsuo.conf:

# Mining Configuration
mine=1
mineraddress=YOUR_TETSUO_ADDRESS_HERE
threads=4

Restart node:

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo stop
sleep 3
./build/bin/tetsuod -daemon -datadir=$HOME/.tetsuo

GPU Mining (NVIDIA/AMD)

For faster block discovery using GPU acceleration, use the TETSUO GPU Miner:

Repository: https://github.com/7etsuo/tetsuo-gpu-miner

Installation

git clone https://github.com/7etsuo/tetsuo-gpu-miner.git
cd tetsuo-gpu-miner

Configuration

Set your mining address and RPC endpoint:

export TETSUO_ADDRESS="YOUR_TETSUO_ADDRESS"
export TETSUO_RPC="http://127.0.0.1:8337"
export TETSUO_RPC_USER="username"
export TETSUO_RPC_PASSWORD="password"

Start GPU Mining

./run_gpu_miner.sh
# or
python3 tetsuo_gpu_miner.py

Performance Tips

NVIDIA GPUs: Typically 10-100x faster than CPU
AMD GPUs: Also supported with compatible drivers
Multiple GPUs: Mine on multiple GPUs simultaneously
Monitor: Check tetsuoarena.com to see your mining rewards

Resources

GPU Miner Repo: https://github.com/7etsuo/tetsuo-gpu-miner
Requirements: CUDA/HIP toolkit + Compatible GPU
For support: Check GPU miner repository issues

Optimize Performance

# Increase cache
dbcache=2048

# More connections
maxconnections=512

# Faster sync
banscore=100

# Listen on all interfaces
bind=0.0.0.0:8338

Run as Service

macOS (LaunchAgent)

cat > ~/Library/LaunchAgents/com.tetsuo.node.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.tetsuo.node</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/tetsuod</string>
        <string>-daemon</string>
        <string>-datadir=/Users/username/.tetsuo</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
EOF

launchctl load ~/Library/LaunchAgents/com.tetsuo.node.plist

Linux (systemd)

sudo tee /etc/systemd/system/tetsuod.service > /dev/null << 'EOF'
[Unit]
Description=TETSUO Node
After=network.target

[Service]
Type=simple
User=tetsuo
ExecStart=/usr/local/bin/tetsuod -daemon -datadir=/home/tetsuo/.tetsuo
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable tetsuod
sudo systemctl start tetsuod

Monitoring Your Node

Check Blockchain Height

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo getblockcount

View Connected Peers

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo getpeerinfo | wc -l

Monitor Mining

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo getmininginfo

View Network Info

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo getnetworkinfo

Real-time Logs

tail -f ~/.tetsuo/debug.log

Dashboard (Web)

Visit: https://tetsuoarena.com

Mining TETSUO

Start Mining

# Enable mining in tetsuo.conf and restart
# OR start with mining flag
./build/bin/tetsuod -daemon -datadir=$HOME/.tetsuo -mine=1 -mineraddress=YOUR_ADDRESS

Monitor Mining Progress

watch -n 5 './build/bin/tetsuo-cli -datadir=$HOME/.tetsuo getmininginfo'

Check Mining Rewards

./build/bin/tetsuo-cli -datadir=$HOME/.tetsuo listtransactions

Troubleshooting

Problem: "Could not locate RPC credentials"

Solution:

# Make sure tetsuod is running
ps aux | grep tetsuod

# If not running:
./build/bin/tetsuod -daemon -datadir=$HOME/.tetsuo

Problem: "Connection refused"

Solution:

# Check if port 8338 is available
lsof -i :8338  # macOS/Linux
netstat -ano | findstr :8338  # Windows

# If blocked, change port in tetsuo.conf:
port=8339

Problem: "Not enough file descriptors"

Solution:

# Increase limit
ulimit -n 4096

# Then start daemon
./build/bin/tetsuod -daemon -datadir=$HOME/.tetsuo

Problem: Slow sync

Solution:

# In tetsuo.conf:
dbcache=2048
maxconnections=256
par=4

Problem: High memory usage

Solution:

# Reduce cache
dbcache=256
maxconnections=64

Directory Structure

tetsuonode/
├── tetsuo-core/              # TETSUO core source code
├── scripts/
│   ├── install-macos.sh      # macOS installer
│   ├── install-linux.sh      # Linux installer
│   └── install-windows.ps1   # Windows installer
├── config/
│   ├── tetsuo.conf.example   # Example configuration
│   └── systemd/              # systemd service files
├── docs/
│   ├── MINING.md             # Mining guide
│   ├── CONFIG.md             # Configuration guide
│   └── API.md                # RPC API reference
├── README.md                 # This file
├── LICENSE                   # MIT License
└── .gitignore

Useful Commands Reference

# Node Management
tetsuod -daemon -datadir=$HOME/.tetsuo        # Start node
tetsuo-cli -datadir=$HOME/.tetsuo stop        # Stop node
tetsuo-cli -datadir=$HOME/.tetsuo restart     # Restart node

# Blockchain Info
tetsuo-cli -datadir=$HOME/.tetsuo getblockcount
tetsuo-cli -datadir=$HOME/.tetsuo getblockchaininfo
tetsuo-cli -datadir=$HOME/.tetsuo getblock [hash]

# Network Info
tetsuo-cli -datadir=$HOME/.tetsuo getpeerinfo
tetsuo-cli -datadir=$HOME/.tetsuo getnetworkinfo
tetsuo-cli -datadir=$HOME/.tetsuo getnodeaddresses

# Mining Info
tetsuo-cli -datadir=$HOME/.tetsuo getmininginfo
tetsuo-cli -datadir=$HOME/.tetsuo setgenerate true 4

# RPC Help
tetsuo-cli -datadir=$HOME/.tetsuo help
tetsuo-cli -datadir=$HOME/.tetsuo help [command]

Network Information

Mainnet

Network: TETSUO Mainnet
Genesis Block: 000007c21fa4cce1c0fc25f4c5b44a43d0e19dd90c0f15d981d9ea3e763a52d5
Default Port: 8338
RPC Port: 8336
Block Time: ~5 seconds
Consensus: Proof of Work (PoW)
Algorithm: SHA-256

Seed Nodes

tetsuoarena.com:8338
node1.tetsuo.network:8338
node2.tetsuo.network:8338

Resources

Block Explorer: https://tetsuoarena.com
GitHub: https://github.com/Pavelevich/tetsuonode
Twitter: https://twitter.com/tetsuoarena
Documentation: https://docs.tetsuoarena.com
API Reference: https://api.tetsuoarena.com/docs

Contributing

We welcome contributions! Please:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit changes: git commit -m 'Add amazing feature'
Push to branch: git push origin feature/amazing-feature
Open a Pull Request

License

This project is licensed under the MIT License - see LICENSE file for details.

Support & Community

Issues: https://github.com/Pavelevich/tetsuonode/issues
Twitter: @tetsuoarena
Email: support@tetsuoarena.com

Roadmap

Acknowledgments

TETSUO Core Development Team
Community Node Operators
Contributors and Supporters

████████████████████████████████████████████████████████████████████████████████
█                                                                              █
█  "The singularity begins with a single block"                              █
█                                                                              █
█  Join the TETSUO Network. Run Your Node. Secure the Future.               █
█                                                                              █
████████████████████████████████████████████████████████████████████████████████

Made for TETSUO Network Last Updated: January 2026

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
docs		docs
scripts		scripts
tests/security		tests/security
.gitignore		.gitignore
DEPENDENCIES.md		DEPENDENCIES.md
HARDENING.md		HARDENING.md
LICENSE		LICENSE
README.md		README.md
SBOM.json		SBOM.json
SECURITY.md		SECURITY.md
SECURITY_AUDIT.md		SECURITY_AUDIT.md

Folders and files

Latest commit

History

Repository files navigation

TETSUONODE - Run Your Own Node

Table of Contents

Overview

What is a Node?

Why Run a Node?

System Requirements

Minimum Requirements

Recommended Specifications

Quick Start

One-Command Installation

macOS

Linux (Ubuntu/Debian)

Windows (PowerShell)

macOS Installation

Step 1: Install Homebrew (if not already installed)

Step 2: Install Dependencies

Step 3: Clone Repository

Step 4: Build TETSUO Core

Step 5: Configure Node

Step 6: Start Node

Step 7: Verify Installation

Linux Installation

Ubuntu/Debian

Step 1: Update System

Step 2: Install Dependencies

Step 3: Clone Repository

Step 4: Build

Step 5: Configure

Step 6: Start Node

Step 7: Verify

Windows Installation

Prerequisites

Step 1: Install Dependencies

Option A: Automated (Recommended)

Option B: Manual

Step 2: Clone Repository

Step 3: Build

Step 4: Create Data Directory

Step 5: Configure Node

Step 6: Start Node

Step 7: Verify

Advanced Configuration

Enable Mining

GPU Mining (NVIDIA/AMD)

Installation

Configuration

Start GPU Mining

Performance Tips

Resources

Optimize Performance

Run as Service

macOS (LaunchAgent)

Linux (systemd)

Monitoring Your Node

Check Blockchain Height

View Connected Peers

Monitor Mining

View Network Info

Real-time Logs

Dashboard (Web)

Mining TETSUO

Start Mining

Monitor Mining Progress

Check Mining Rewards

Troubleshooting

Problem: "Could not locate RPC credentials"

Problem: "Connection refused"

Problem: "Not enough file descriptors"

Problem: Slow sync

Problem: High memory usage

Directory Structure

Useful Commands Reference

Network Information

Mainnet

Seed Nodes

Resources

Packages