Feature/pnm

.gitignore

@@ -7,4 +7,5 @@ testnet/*/binary
 # Create cosmos app
 web/
 
-.env
+.env
+.DS_Store

push-node-manager/.gitignore

@@ -0,0 +1,35 @@
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Data directory
+data/
+
+# Backup directory
+backups/
+
+# Logs
+*.log
+logs/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+
+# Keys (never commit these!)
+*.key
+*.pem
+priv_validator_key.json
+node_key.json

push-node-manager/README.md

@@ -0,0 +1,116 @@
+# Push Node Manager
+
+**Push Chain validator management**
+
+## 🚀 Quick Start
+
+### Step 1: Install & Start
+```bash
+curl -fsSL https://get.push.network/node/install.sh | bash
+```
+This installs and starts your validator automatically.
+
+> **Note:** After installation, restart your terminal or run `source ~/.bashrc` (or `~/.zshrc`) to use the `push-node-manager` command from anywhere.
+
+### Step 2: Check Sync Status
+```bash
+push-node-manager status
+```
+Wait for: `✅ Catching Up: false` (fully synced)
+
+### Step 3: Become a Validator
+```bash
+push-node-manager register-validator
+```
+
+**Requirements:**
+- Node must be synced (catching_up: false)
+- Need 2+ PC tokens from [faucet](https://faucet.push.org)
+- Account must be funded first
+
+**That's it! You're now running a Push Chain validator! 🎉**
+
+## 📖 Commands
+
+### Essential Commands
+```bash
+push-node-manager start                # Setup + start node  
+push-node-manager stop                 # Stop node
+push-node-manager status               # Show sync status & validator info
+push-node-manager register-validator   # Become a validator
+push-node-manager logs                 # View live logs
+```
+
+### Additional Commands
+```bash
+push-node-manager restart         # Restart node
+push-node-manager sync            # Real-time sync monitor
+push-node-manager validators      # List all validators
+push-node-manager balance         # Check wallet balance
+push-node-manager reset           # Reset blockchain data
+push-node-manager help            # Show all commands
+```
+
+### Public Setup Commands (Optional)
+```bash
+push-node-manager setup-nginx <domain>  # Setup NGINX + SSL for public RPC
+push-node-manager setup-logs            # Configure log rotation
+push-node-manager backup                # Create node backup
+```
+
+## 📊 Network Info
+
+- **Chain ID**: `push_42101-1`
+- **Network**: Push Chain Testnet
+- **Min Stake**: 2 PC
+- **Faucet**: https://faucet.push.org
+- **Explorer**: https://donut.push.network
+
+## 🔧 File Locations
+
+- **Binary**: `./build/pchaind`
+- **Config**: `~/.pchain/config/`
+- **Data**: `~/.pchain/data/`
+- **Keys**: `~/.pchain/keyring-test/`
+- **Logs**: `~/.pchain/logs/pchaind.log`
+
+
+## 🌍 Public Setup (Optional)
+
+### Making Your Node Publicly Accessible
+
+By default, your validator runs locally. These optional commands help set up public HTTPS endpoints:
+
+#### Setup NGINX with SSL
+```bash
+push-node-manager setup-nginx yourdomain.com
+```
+**Creates:**
+- `https://yourdomain.com` - Cosmos RPC endpoint
+- `https://evm.yourdomain.com` - EVM RPC endpoint
+- Automatic SSL certificates via Let's Encrypt
+- Rate limiting and security headers
+
+**Requirements:**
+- Domain pointing to your server IP
+- Ports 80/443 open
+- Ubuntu/Debian system
+
+#### Setup Log Rotation
+```bash
+push-node-manager setup-logs
+```
+**Configures:**
+- Daily log rotation
+- 14-day retention
+- Automatic compression
+- System logrotate integration
+
+#### Create Backups  
+```bash
+push-node-manager backup
+```
+- Timestamped backup in `~/push-node-backups/`
+- Includes all config, keys, and blockchain data  
+- Compressed archive with integrity verification
+

push-node-manager/install.sh

@@ -0,0 +1,165 @@
+#!/usr/bin/env bash
+
+# Push Node Manager one-liner installer (source-build only, no CI required)
+# Usage examples:
+#   curl -fsSL https://get.push.network/pnm/install.sh | bash
+#   MONIKER=my-node GENESIS_DOMAIN=rpc-testnet-donut-node1.push.org KEYRING_BACKEND=os \
+#     curl -fsSL https://get.push.network/pnm/install.sh | bash
+#   curl -fsSL https://get.push.network/pnm/install.sh | bash -s -- --no-start
+
+set -euo pipefail
+IFS=$'\n\t'
+
+# Read env or defaults
+MONIKER="${MONIKER:-push-validator}"
+GENESIS_DOMAIN="${GENESIS_DOMAIN:-rpc-testnet-donut-node1.push.org}"
+KEYRING_BACKEND="${KEYRING_BACKEND:-test}"
+AUTO_START="yes"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --no-start) AUTO_START="no"; shift ;;
+    --start) AUTO_START="yes"; shift ;;
+    --moniker) MONIKER="$2"; shift 2 ;;
+    --genesis) GENESIS_DOMAIN="$2"; shift 2 ;;
+    --keyring) KEYRING_BACKEND="$2"; shift 2 ;;
+    *) echo "Unknown flag: $1" >&2; exit 1 ;;
+  esac
+done
+
+require_cmd() { command -v "$1" >/dev/null 2>&1 || { echo "Missing dependency: $1" >&2; exit 1; }; }
+for c in curl jq git tar; do require_cmd "$c"; done
+
+# Use XDG Base Directory or fallback to hidden directory
+if [[ -n "${XDG_DATA_HOME:-}" ]]; then
+    ROOT_DIR="$XDG_DATA_HOME/push-node-manager"
+else
+    ROOT_DIR="$HOME/.local/share/push-node-manager"
+fi
+REPO_DIR="$ROOT_DIR/repo"
+INSTALL_DIR="$ROOT_DIR/app"
+MANAGER_LINK="$HOME/.local/bin/push-node-manager"
+
+mkdir -p "$ROOT_DIR"
+mkdir -p "$HOME/.local/bin"
+cd "$ROOT_DIR"
+
+echo "Installing Push Node Manager into $ROOT_DIR"
+
+# Always clone fresh repository to ensure latest version
+echo "Cloning repository..."
+rm -rf "$REPO_DIR"
+git clone --depth 1 --branch feature/pnm https://github.com/pushchain/push-chain-node "$REPO_DIR"
+
+# Build native binary and ensure manager script
+echo "Building native binary and setting up manager..."
+
+# Copy manager to a stable install directory so we can delete the repo later
+rm -rf "$INSTALL_DIR"
+mkdir -p "$INSTALL_DIR"
+if [[ ! -d "$REPO_DIR/push-node-manager" ]]; then
+  echo "Error: missing source at $REPO_DIR/push-node-manager"
+  exit 1
+fi
+cp -a "$REPO_DIR/push-node-manager/." "$INSTALL_DIR/"
+
+cd "$INSTALL_DIR"
+bash scripts/setup-dependencies.sh
+
+# Ensure the push-node-manager script is executable
+chmod +x "$INSTALL_DIR/push-node-manager"
+
+# Create symlink for binary in expected location
+# The register-validator script expects ../build/pchaind relative to scripts/ directory
+mkdir -p "$INSTALL_DIR/build"
+cd "$INSTALL_DIR/build"
+ln -sf ../scripts/build/pchaind pchaind
+cd "$INSTALL_DIR"
+
+# Remove any existing symlink/script and install a small launcher script
+rm -f "$MANAGER_LINK"
+cat > "$MANAGER_LINK" <<EOF
+#!/usr/bin/env bash
+exec "$INSTALL_DIR/push-node-manager" "\$@"
+EOF
+chmod +x "$MANAGER_LINK"
+
+# Verify the script exists and is executable
+if [[ ! -f "$INSTALL_DIR/push-node-manager" ]]; then
+  echo "Error: push-node-manager script not found in $INSTALL_DIR"
+  exit 1
+fi
+
+if [[ ! -x "$INSTALL_DIR/push-node-manager" ]]; then
+  echo "Error: push-node-manager script is not executable"
+  exit 1
+fi
+
+# Add to PATH if not already there
+SHELL_CONFIG=""
+if [[ -f "$HOME/.zshrc" ]]; then
+    SHELL_CONFIG="$HOME/.zshrc"
+elif [[ -f "$HOME/.bashrc" ]]; then
+    SHELL_CONFIG="$HOME/.bashrc"
+elif [[ -f "$HOME/.bash_profile" ]]; then
+    SHELL_CONFIG="$HOME/.bash_profile"
+fi
+
+if [[ -n "$SHELL_CONFIG" ]]; then
+    if ! grep -q "push-node-manager" "$SHELL_CONFIG" 2>/dev/null; then
+        echo "" >> "$SHELL_CONFIG"
+        echo "# Push Node Manager" >> "$SHELL_CONFIG"
+        echo "export PATH=\"$HOME/.local/bin:\$PATH\"" >> "$SHELL_CONFIG"
+    fi
+fi
+
+# ALWAYS export PATH for current session, regardless of shell config
+export PATH="$HOME/.local/bin:$PATH"
+
+# Persist configuration
+ENV_FILE="$ROOT_DIR/.env"
+tmp="$ENV_FILE.tmp"; : > "$tmp"
+{ grep -v -e '^GENESIS_DOMAIN=' -e '^MONIKER=' -e '^KEYRING_BACKEND=' "$ENV_FILE" 2>/dev/null || true; } >> "$tmp"
+mv "$tmp" "$ENV_FILE"
+{
+  echo "GENESIS_DOMAIN=$GENESIS_DOMAIN"
+  echo "MONIKER=$MONIKER"
+  echo "KEYRING_BACKEND=$KEYRING_BACKEND"
+} >> "$ENV_FILE"
+
+echo "📁 Node data: $HOME/.pchain"
+echo
+echo "✅ Installation complete!"
+echo
+
+# Run auto-start before cleanup to ensure wrapper script is available
+if [[ "$AUTO_START" = "yes" ]]; then
+  "$MANAGER_LINK" start || true
+  echo
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo -e "\033[1;33m💡 Quick Commands:\033[0m"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo -e "  \033[1mpush-node-manager status\033[0m    📊 Check node status"
+  echo -e "  \033[1mpush-node-manager sync\033[0m      📈 Monitor sync progress"
+  echo -e "  \033[1mpush-node-manager help\033[0m      ❓ Show all commands"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+fi
+
+# ALWAYS show PATH instruction when running from pipe (curl | bash)
+if [ ! -t 0 ]; then
+  # Running from pipe - PATH won't persist after script exits
+  echo
+  echo -e "\033[1;33m⚠️  To use push-node-manager in this terminal, run:\033[0m"
+  echo -e "\033[1;32m    export PATH=\"\$HOME/.local/bin:\$PATH\"\033[0m"
+  echo
+  echo "Or open a new terminal window."
+fi
+
+# Optional: Clean up the cloned repository to save space (keep only push-node-manager)
+cd "$ROOT_DIR"
+if [[ -d "$REPO_DIR" ]]; then
+    # Remove the temporary clone
+    rm -rf "$REPO_DIR"
+fi
+
+