Skip to content

feat(skills): add fee-tracking skill#17

Open
liquidpadbot wants to merge 2 commits into
Liquid-Protocol-Ops:mainfrom
liquidpadbot:skills/fee-tracking
Open

feat(skills): add fee-tracking skill#17
liquidpadbot wants to merge 2 commits into
Liquid-Protocol-Ops:mainfrom
liquidpadbot:skills/fee-tracking

Conversation

@liquidpadbot
Copy link
Copy Markdown

Adds a fee-tracking skill to skills/ — gives any agent on Liquid Protocol the ability to read fee accrual, detect buyback cycles, and build a proof-of-burn feed directly from on-chain data.

Why

The existing skills cover deploy, index, and auction. Once a token is live, the next thing an agent needs to do is prove the fee path is working — pending fees in the locker, claim cycles, burns to dEaD, LIQ buybacks. We've been doing this in production at LiquidPad and the pattern generalizes to any Liquid Protocol token.

This skill packages the pattern so other agents don't have to re-derive it.

What it does

  • Reads pending fees per token via sdk.getPendingFees(tokenAddress)
  • Detects burn transactions (Transfer to 0x...dEaD) via getLogs
  • Detects LIQ buybacks (Transfer to treasury) via getLogs
  • Builds a structured "proof-of-burn feed" combining all three
  • Real-time watcher via watchEvent for new burns
  • Heatmap loop across all indexed tokens for un-claimed fee discovery

Style

Mirrors the existing skill format — instructional, code-heavy, uses liquid-sdk + viem, no backend or API key required. Read-only setup matches index-tokens.md.

Use cases included in the skill

  1. Dashboard "Proof of Burn" — display cumulative burns + buybacks for any token
  2. Buyback bot trigger — agent polls getPendingFees and claims when threshold met
  3. Ecosystem leaderboard — rank tokens by burn activity
  4. Real-time alerting on burn cycles
  5. Compliance / accounting export

Files

  • skills/fee-tracking.md (new, 240 lines)
  • skills/README.md (updated table to include the new entry)

Reference

This pattern is live at https://www.liquidpad.site (Proof-of-Burn section) — the skill captures the exact loop we use, ported back so it's reusable across the ecosystem.

Notes for review

  • No SDK code changes — purely additive documentation skill
  • Uses public methods only (sdk.getPendingFees, publicClient.getLogs, publicClient.watchEvent)
  • Cross-references existing skills (deploy-token.md, index-tokens.md, bid-in-auction.md) in the "Related Skills" section
  • Ready for any agent / Claude Code / Cursor / MCP setup

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant