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