passive-income-monitor

Version: 1.0.0
Author: mariusfit
Category: finance, crypto, automation, passive-income
Tags: passive income, crypto, grass, storj, mysterium, defi, staking, yield, monitoring, alerts

What This Does

Monitors multiple passive income streams from a single command. Tracks bandwidth monetization nodes (Grass.io, Mysterium Network), decentralized storage earnings (Storj), DeFi yield positions, and crypto staking rewards. Provides unified dashboard, earnings summaries, and configurable alerts when earnings drop or nodes go offline.

Zero API keys required for basic mode. Optional API keys unlock richer data.

Use Cases

• Track all passive income sources in one place
• Get alerted when a node goes offline or earnings drop
• Calculate daily/weekly/monthly earnings projections
• Compare actual vs expected yields across DeFi protocols
• Log earnings history for tax/accounting purposes

Commands

monitor check — Quick status of all configured streams

bash passive-income-monitor.sh check

Output: Status table (stream name, status, last earned, 24h total)

monitor earnings — Detailed earnings report

bash passive-income-monitor.sh earnings [--days 7] [--format json|table|csv]

monitor add <type> <name> <config> — Add income stream

bash passive-income-monitor.sh add grass "node1" --wallet 0xABC...
bash passive-income-monitor.sh add storj "storage1" --api-key KEY --node-id NODE_ID
bash passive-income-monitor.sh add mysterium "node1" --rpc http://localhost:4449
bash passive-income-monitor.sh add defi "aave-usdc" --protocol aave --address 0xABC... --chain ethereum
bash passive-income-monitor.sh add staking "eth-validator" --address 0xABC... --chain ethereum

monitor remove <name> — Remove income stream

bash passive-income-monitor.sh remove "node1"

monitor alert <threshold> — Set alert thresholds

bash passive-income-monitor.sh alert --min-daily 5.00 --notify-offline --email user@example.com

monitor export — Export earnings history

bash passive-income-monitor.sh export --format csv --output earnings-2026.csv

monitor dashboard — Live terminal dashboard (ncurses-style)

bash passive-income-monitor.sh dashboard

Supported Platforms

Platform	Type	API	Notes
Grass.io	Bandwidth	Public API	Wallet address required
Mysterium Network	Bandwidth	Local RPC	Node must be running
Storj	Storage	API Key	DCS node API
Aave v3	DeFi Lending	Public on-chain	No key needed
Compound v3	DeFi Lending	Public on-chain	No key needed
Lido	ETH Staking	Public API	Staking address
Ethereum Staking	Validator	Beaconcha.in API	Validator pubkey
Helium	IoT Network	Public API	Wallet address

Configuration

Config stored in ~/.config/passive-income-monitor/config.json:

{
  "streams": [
    {
      "name": "grass-node1",
      "type": "grass",
      "wallet": "0xABC...",
      "enabled": true
    },
    {
      "name": "mysterium-node",
      "type": "mysterium",
      "rpc": "http://localhost:4449",
      "enabled": true
    }
  ],
  "alerts": {
    "min_daily_usd": 5.00,
    "notify_offline": true,
    "notify_method": "file"
  },
  "currency": "USD"
}

Alert Methods

• file — Write alerts to ~/.config/passive-income-monitor/alerts.log
• stdout — Print to terminal
• webhook — POST to configured URL (Discord, Slack, custom)
• OpenClaw integration: alerts appear as agent notifications

Output Examples

╔═══════════════════════════════════════════════════════════════╗
║          PASSIVE INCOME MONITOR — 2026-02-24                  ║
╠═══════════════════════════╦═══════════╦══════════╦═══════════╣
║ Stream                    ║ Status    ║ 24h      ║ 7d Total  ║
╠═══════════════════════════╬═══════════╬══════════╬═══════════╣
║ grass-node1               ║ ✅ Online  ║ $0.34    ║ $2.18     ║
║ mysterium-residential     ║ ✅ Online  ║ $0.12    ║ $0.84     ║
║ storj-node                ║ ⚠️ Offline ║ $0.00    ║ $1.92     ║
║ aave-usdc-pos             ║ ✅ Earning ║ $0.28    ║ $1.96     ║
║ lido-staking              ║ ✅ Active  ║ $0.45    ║ $3.15     ║
╠═══════════════════════════╬═══════════╬══════════╬═══════════╣
║ TOTAL                     ║           ║ $1.19    ║ $10.05    ║
╚═══════════════════════════╩═══════════╩══════════╩═══════════╝

⚠️  ALERT: storj-node has been offline >2h. Check node health.
📈 Projected monthly: $35.70 (based on 7d average)

Requirements

• bash 4.0+
• curl (for API calls)
• jq (for JSON parsing)
• bc (for math)
• Optional: node.js (for on-chain data via ethers.js)

Installation

# Via OpenClaw
clawhub install passive-income-monitor

# Manual
bash install.sh

Notes

• All data cached locally; no external tracking or telemetry
• Earnings data stored in CSV for privacy and portability
• OpenClaw agent can call this tool proactively during heartbeats
• Works offline for cached data; requires internet for fresh API calls