Skill: wpank/monitor-tokenjar (version 0.1.0)

--- name: monitor-tokenjar description: >- Monitor the Uniswap TokenJar with a real-time dashboard showing balances, accumulation rates, burn economics, and projected time to next profitable burn. Supports one-shot snapshot and streaming modes. Use when user asks "Watch the TokenJar", "Track fee accumulation", or "When is the next profitable burn?" model: opus allowed-tools: - Task(subagent_type:protocol-fee-seeker) - mcp__uniswap__get_tokenjar_balances - mcp__uniswap__get_firepit_state - mcp__uniswap__get_fee_accumulation_rate - mcp__uniswap__subscribe_tokenjar - mcp__uniswap__get_burn_history - mcp__uniswap__get_token_price --- # Monitor TokenJar ## Overview A monitoring dashboard for Uniswap's protocol fee system. The TokenJar accumulates fees from all Uniswap sources (V2, V3, V4, UniswapX, Unichain native fees). This skill provides a comprehensive view of what's in the jar, how fast it's growing, and when the next burn will be profitable -- the single most actionable question for protocol fee seekers. Two modes: **one-shot** (instant snapshot with analytics) and **streaming** (real-time deposit tracking with live updates). **Why this is 10x better than calling tools individually:** 1. **Actionable projection**: The key output is "estimated time to next profitable burn" -- a compound calculation that requires TokenJar balances, UNI price, gas estimates, and accumulation rates. No single tool provides this. Manually computing it requires calling 4-5 tools and doing the math yourself. 2. **Compound dashboard**: Instead of raw JSON from separate tools, you get a single formatted view combining balances, rates, burn economics, and history. The agent cross-references all data sources to produce insights none of them provide alone. 3. **Streaming mode with context**: Raw `subscribe_tokenjar` returns deposit events without context. This skill enriches each deposit with a running total, updated profitability estimate, and alert when the threshold is crossed -- turning raw events into actionable intelligence. 4. **Historical context**: The dashboard includes recent burn history and competitive intelligence, so you understand not just the current state but the dynamics of the system. ## When to Use Activate when the user says anything like: - "Watch the TokenJar" - "Monitor protocol fees" - "Track fee accumulation" - "When is the next profitable burn?" - "Show me TokenJar analytics" - "How fast are fees accumulating?" - "Alert me when a burn is profitable" - "TokenJar dashboard" - "What's the accumulation rate?" **Do NOT use** when the user wants to execute a burn (use `seek-protocol-fees` instead) or wants deep historical analysis of burn economics (use `analyze-burn-economics` instead). ## Parameters | Parameter | Required | Default | How to Extract | | ------------------- | -------- | -------- | ------------------------------------------------------------------- | | chain | No | ethereum | Always Ethereum mainnet for TokenJar | | streaming | No | false | "watch", "stream", "live", "real-time" implies true | | duration | No | 60 | Streaming duration in seconds (1-300). "Watch for 5 minutes" = 300 | | alert-threshold-usd | No | -- | "Alert me when jar hits $50K" extracts 50000 | | include-history | No | true | "Skip history" or "just current state" implies false | ## Workflow ### One-Shot Mode (default) 1. **Parallel data collection**: Make all MCP calls simultaneously for speed: - [REDACTED_SECRET] -- current jar contents - `mcp__uniswap__get_firepit_state` -- threshold, nonce, readiness - [REDACTED_SECRET] -- daily/weekly/monthly rates - `mcp__uniswap__get_burn_history` (if `include-history: true`) -- recent burns 2. **Compound analysis**: Delegate to `Task(subagent_type:protocol-fee-seeker)` in monitoring mode: ``` Produce a TokenJar monitoring dashboard. Current data: - TokenJar balances: {from parallel calls} - Firepit state: threshold={threshold}, nonce={nonce} - Accumulation rates: {from parallel calls} - Recent burn history: {from parallel calls} Tasks: 1. Price all TokenJar assets in USD using get_token_price. 2. Calculate total jar value. 3. Calculate current burn cost (threshold UNI * UNI price + gas estimate). 4. Determine current profitability: jar value vs. burn cost. 5. Using accumulation rates, project when the next burn will be profitable (if not already) or when ROI will exceed 10% (if already profitable). 6. Summarize recent burn history: last burn date, frequency, average profit. 7. Identify the top fee-generating tokens and any notable trends. Return a structured dashboard report. ``` 3. **Format and present**: Display the dashboard with all sections. ### Streaming Mode 1. **Initial snapshot**: Run the same one-shot workflow above to establish a baseline. 2. **Start streaming**: Call [REDACTED_SECRET] with the user's duration: - If `alert-threshold-usd` is set, include `minDepositUsd` filter. - Default duration: 60 seconds. 3. **Enrich deposits**: For each deposit event received: - Price the deposited token in USD. - Update the running jar total. - Recalculate profitability with the new total. - If the jar value crosses the burn cost threshold, alert: "Burn is now profitable!" 4. **Final summary**: After streaming ends, present an updated dashboard with: - Deposits observed during the session. - Updated jar total. - Updated profitability estimate. ## Output Format ### One-Shot Dashboard ```text TokenJar Dashboard (Ethereum) ══════════════════════════════════════ CURRENT BALANCES ══════════════════════════════════════ Token Balance USD Value Share WETH 7.20 $18,000 34.6% USDC 15,000 $15,000 28.8% USDT 8,500 $8,500 16.3% WBTC 0.08 $6,400 12.3% DAI 4,100 $4,100 7.9% ────────────────────────────────────── Total $52,000 100% ══════════════════════════════════════ ACCUMULATION RATES ══════════════════════════════════════ Daily: ~$7,400/day Weekly: ~$51,800/week Monthly: ~$222,000/month Top Contributors: WETH ~$2,800/day (37.8%) USDC ~$2,100/day (28.4%) USDT ~$1,200/day (16.2%) ══════════════════════════════════════ BURN ECONOMICS ══════════════════════════════════════ Burn Threshold: 4,000 UNI ($28,000) Gas Estimate: ~$45 Total Burn Cost: $28,045 Current Jar: $52,000 Net Profit: $23,955 ROI: 85.4% Status: PROFITABLE ══════════════════════════════════════ RECENT HISTORY ══════════════════════════════════════ Last Burn: 2026-02-03 (7 days ago) Burn Frequency: ~every 5.2 days (avg last 10 burns) Avg Profit: $18,400 per burn Nonce: 42 ══════════════════════════════════════ PROJECTION ══════════════════════════════════════ Next 10% ROI: Already exceeded (current: 85.4%) Next 100% ROI: ~0.5 days at current rate Competitor Risk: HIGH — avg burn interval is 5.2 days, currently at 7 days ``` ### Streaming Output ```text TokenJar Live Feed (streaming for 60s) Baseline: $52,000 across 5 assets [14:00:12] Deposit: 0.15 WETH ($375) | Running Total: $52,375 [14:00:28] Deposit: 500 USDC ($500) | Running Total: $52,875 [14:00:45] Deposit: 200 USDT ($200) | Running Total: $53,075 ────────────────────────────────────── Session Summary (60s) ────────────────────────────────────── Deposits: 3 events, $1,075 total Rate: ~$64,500/hour (this session) Updated Total: $53,075 Profitability: $25,030 net profit (89.3% ROI) Status: PROFITABLE — ready to burn ``` ### Alert Output (when threshold crossed) ```text ALERT: TokenJar value ($50,125) has crossed your alert threshold ($50,000). Current profitability: $22,080 net profit (78.7% ROI). Consider running: seek-protocol-fees ``` ## Important Notes - **Read-only skill.** This skill never executes transactions. It only reads data and produces analysis. To execute a burn, use `seek-protocol-fees`. - **Ethereum mainnet only.** The TokenJar and Firepit are mainnet contracts. - **Accumulation rates are estimates.** They are based on historical Transfer events over a lookback window (default ~7 days). Actual rates vary with protocol volume and fee settings. - **Streaming duration is capped at 300 seconds** (5 minutes) by the MCP tool. For longer monitoring, re-run the skill periodically. - **Competitor intelligence is approximate.** Burn frequency is derived from on-chain history, not mempool monitoring. Another searcher could burn at any time. - **UNI price volatility affects projections.** The "time to profitable burn" projection assumes stable UNI price. A UNI price spike could make a currently-profitable burn unprofitable. ## Error Handling | Error | User-Facing Message | Suggested Action | | ---------------------------- | ---------------------------------------------------------------------- | ----------------------------------------- | | TokenJar empty | "TokenJar is empty. No fees have accumulated yet." | Wait for protocol activity | | No accumulation data | "Insufficient data to calculate accumulation rates." | Try a larger lookback window | | No burn history | "No burn history found. This may be a new deployment." | Set include-history: false | | Streaming timeout | "Streaming session ended after {duration}s." | Re-run for another session | | No deposits during stream | "No deposits observed during the {duration}s streaming window." | Try a longer duration or check later | | Token price unavailable | "Could not price {token}. Dashboard values may be incomplete." | Token may be exotic or illiquid | | RPC connection failed | "Cannot connect to Ethereum RPC. Dashboard unavailable." | Check RPC configuration |

path: README.md
content: # Monitor TokenJar

Monitor the Uniswap TokenJar: balances, accumulation rates, burn economics, and projected time to next profitable burn.

→ **[SKILL.md](SKILL.md)** — Full skill specification and workflow.

## Installation

Install into Claude Code or Cursor with:

```bash
npx skills add https://github.com/wpank/Agentic-Uniswap/tree/main/.ai/skills/monitor-tokenjar
```

Or via Clawhub:

```bash
npx clawhub@latest install monitor-tokenjar
```

## When to use

Use this skill when:

- You want a **dashboard view of the TokenJar** and protocol fee accumulation.
- You need to know **current balances, accumulation rates, and burn economics**.
- You want a **projection for when the next profitable Firepit burn** is likely.

## Example prompts

- "Monitor the TokenJar and show current balances and estimated time to next profitable burn."
- "Give me a one-shot snapshot of TokenJar holdings and recent accumulation rates."
- "Set up a streaming view of TokenJar metrics for the next few minutes."


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)