Minty

Autonomous cryptocurrency tipping for Rumble creators — powered by Tether WDK and AI.

Minty is a Chrome Extension (Manifest V3) that watches your Rumble sessions and automatically sends on-chain crypto tips to creators based on rules you define. Set it once, and Minty handles everything: detecting creators, tracking watch time, running AI-powered decisions, and broadcasting real blockchain transactions — no clicks required.

Features

Autonomous tipping — no interaction needed after setup; tips fire automatically when watch time thresholds are met
Rule engine — per-creator or wildcard rules with configurable rate/min, min watch time, max tip, token, and network
AI reasoning — optional LLM layer (OpenAI, Anthropic, Gemini, Ollama) that adjusts tip amounts and can veto low-confidence decisions
Real on-chain transactions — uses the official Tether WDK; no mocking
Multi-network — Ethereum (Sepolia), Polygon (Amoy), Arbitrum Sepolia, Bitcoin testnet
Multi-token — USDT, USAT (Alloy Dollar), XAUT (Tether Gold), BTC
Budget guards — daily spending cap + per-session cap with midnight resets
Companion website — full analytics dashboard, leaderboard, and streamer profiles bundled inside the extension

Architecture Overview

┌──────────────────────────────────────────────────────────────┐
│  rumble.com (any video page)                                  │
│                                                               │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │  content.js  (content script, injected by manifest)     │ │
│  │                                                         │ │
│  │  1. Detects video element & creator name                │ │
│  │  2. Extracts creator wallet via silent 3-step HTMX fetch│ │
│  │  3. Tracks real watch time (play/pause/seek events)     │ │
│  │  4. Reports to background every 30 seconds              │ │
│  │  5. Shows "Minty Active" badge overlay on player        │ │
│  │  6. Displays tip notification when a tip fires          │ │
│  └──────────────────────┬──────────────────────────────────┘ │
└─────────────────────────┼────────────────────────────────────┘
                          │  chrome.runtime.sendMessage
                          │  WATCH_UPDATE / VIDEO_ENDED / CREATOR_DETECTED
                          ▼
┌──────────────────────────────────────────────────────────────┐
│  background.js  (service worker — persistent orchestrator)    │
│                                                               │
│  handleWatchUpdate()                                          │
│    │                                                          │
│    ├──► agent.shouldTip()  ──────────────────────────────┐   │
│    │         (7-step decision pipeline)                   │   │
│    │                                                      │   │
│    └──► executeTip()  ◄────────── decision: shouldTip    │   │
│              │                                            │   │
│              ├──► wallet.sendTip()   (Tether WDK)         │   │
│              ├──► storage.addTipRecord()                  │   │
│              ├──► storage.addDailySpending()              │   │
│              ├──► chrome.tabs.sendMessage(TIP_SENT)       │   │
│              └──► chrome.action.setBadgeText()            │   │
│                                                           │   │
│  agent.js ─────────────────────────────────────────────── ┘   │
│    │  Rule Engine + AI Reasoning + Spending Guardian           │
│    └──► Optional LLM call (OpenAI / Anthropic / Gemini /       │
│         Ollama) for confidence scoring & amount adjustment      │
│                                                               │
│  wallet.js                                                    │
│    └──► Tether WDK (WalletManagerEvm / WalletManagerBtc)      │
│         Real BIP-39 HD wallet. Real on-chain transfers.        │
│                                                               │
│  storage.js                                                   │
│    └──► chrome.storage.local                                  │
│         settings / tipHistory / watchSessions /               │
│         dailySpending / tipRules / creatorCache               │
└──────────────────────────────────────────────────────────────┘
                          ▲
                          │  chrome.runtime.sendMessage
                          │  GET_STATS / CREATE_RULE / INIT_WALLET / ...
┌──────────────────────────────────────────────────────────────┐
│  popup/  (extension popup UI, 380×580px)                      │
│    popup.html / popup.css / popup.js                          │
│    4 tabs: Dashboard · Rules · History · Settings             │
└──────────────────────────────────────────────────────────────┘
                          │  chrome.tabs.create
                          ▼
┌──────────────────────────────────────────────────────────────┐
│  website/  (companion web app, bundled in extension package)  │
│    index.html       — landing page (works standalone)         │
│    dashboard.html   — personal analytics + charts             │
│    leaderboard.html — creator ranking from tip history        │
│    streamer.html    — per-creator profile search              │
│    css/ js/         — vanilla JS, canvas charts, no framework │
└──────────────────────────────────────────────────────────────┘

Auto-Tip Decision Pipeline

Every 30 seconds while video plays:
┌─────────────────────────────────────────┐
│  WATCH_UPDATE received                  │
│  watchMinutes = watchSeconds / 60       │
└────────────────┬────────────────────────┘
                 │
                 ▼
         ┌───────────────┐
         │ Already tipped │──YES──► skip (quiet)
         │  this session? │
         └───────┬───────┘
                 │ NO
                 ▼
         ┌───────────────┐
         │ Creator address│──NO───► skip (quiet)
         │   detected?   │
         └───────┬───────┘
                 │ YES
                 ▼
         ┌───────────────┐
         │ Matching rule  │──NO───► skip
         │    exists?    │
         └───────┬───────┘
                 │ YES
                 ▼
         ┌───────────────────────────────┐
         │ watchMin ≥ minWatchMinutes?    │──NO──► skip (quiet)
         └───────┬───────────────────────┘
                 │ YES
                 ▼
         ┌────────────────────────────────────────────┐
         │ amount = min(watchMin × rate, maxTipAmount) │
         └───────┬────────────────────────────────────┘
                 │
                 ▼
         ┌──────────────────────────────────────┐
         │ todaySpent + amount ≤ maxDailySpend?  │──NO──► skip (logs budget info)
         └───────┬──────────────────────────────┘
                 │ YES
                 ▼
         ┌────────────────────────┐
         │  AI enabled?           │──NO──────────────────────────┐
         └───────┬────────────────┘                              │
                 │ YES                                           │
                 ▼                                               │
         ┌──────────────────────────────────────────────┐       │
         │  LLM call → { shouldTip, confidence,         │       │
         │    adjustedAmount, reasoning, sentiment }     │       │
         │                                               │       │
         │  confidence < 0.3 AND shouldTip=false?       │       │
         │  └──► veto                                    │       │
         │                                               │       │
         │  LLM failure? → non-blocking fallback         │       │
         └───────┬───────────────────────────────────────┘       │
                 │                                               │
                 └────────────────────┬──────────────────────────┘
                                      │
                                      ▼
                    ┌─────────────────────────────────────┐
                    │  executeTip()                        │
                    │                                      │
                    │  1. Double-check daily budget        │
                    │  2. wallet.sendTip() → Tether WDK   │
                    │  3. storage.addTipRecord()           │
                    │  4. storage.addDailySpending()       │
                    │  5. TIP_SENT → badge on video page   │
                    │  6. Badge text = total tip count     │
                    └─────────────────────────────────────┘

Creator Wallet Extraction

Rumble uses HTMX — wallet addresses only appear inside dynamically-fetched HTML fragments. Minty extracts them silently via a 3-step fetch chain without opening any UI or modifying the DOM.

DOM: button[hx-get*="qr-modal"]
       │
       │ Step 1: htmxFetch(hx-get, hx-vals)
       ▼
   Tip modal HTML
   ├── Check hx-vals for address → found? ✓ DONE
   └── Find button[hx-get*="qr-address"]
              │
              │ Step 2: htmxFetch(hx-get, hx-vals)
              ▼
         Crypto network tabs HTML
         └── querySelectorAll('button[hx-vals*="address"]')
                    │
                    │ Step 3: Parse hx-vals JSON from each button
                    ▼
              Address priority:
              1st: blockchain=polygon + currency=usdt
              2nd: blockchain=polygon (any currency)
              3rd: any address found
              Fallback: regex scan (0x... or bc1...) in raw HTML

This chain depends on Rumble's current HTMX DOM structure. If wallet extraction breaks, start debugging at Step 1 by checking whether button[hx-get*="qr-modal"] still exists on video pages.

AI Agent

The AI layer is fully optional. If no credentials are configured, the agent runs in pure rule-based mode with no external calls.

How to enable:

Open the popup → Dashboard → AI Agent section
Select your provider and enter credentials
Optionally specify a model override (blank = provider default)
Click Connect AI Agent

What the AI does:

Receives watch context: creator, watch duration, base amount, rule parameters, daily budget, recent tip history
Returns a confidence score (0.0–1.0) and can adjust the tip amount (bounded by rule.maxTipAmount)
Vetoes the tip if confidence < 0.3 and shouldTip = false
AI failures are non-blocking — any error falls back to rule-based logic

Provider quick reference:

Provider	Default model	Credential needed
OpenAI	`gpt-4o-mini`	API key from platform.openai.com
Anthropic	`claude-haiku-4-5-20251001`	API key from console.anthropic.com
Gemini	`gemini-2.5-flash-lite`	API key from aistudio.google.com
Ollama	`llama3.2`	Local server URL (default: `http://localhost:11434`)

Supported Networks & Tokens

All networks are configured for testnet by default. Mainnet values are in .env.example.

Network	Testnet	RPC
Ethereum	Sepolia	`https://1rpc.io/sepolia`
Polygon	Amoy	`https://rpc-amoy.polygon.technology`
Arbitrum	Sepolia	`https://sepolia-rollup.arbitrum.io/rpc`
Bitcoin	Testnet	ElectrumWs

Token	Full name	Networks
USDT	USD₮ (Tether Dollar)	Ethereum, Polygon, Arbitrum
USAT	USA₮ (Alloy Dollar)	Ethereum
XAUT	XAU₮ (Tether Gold)	Ethereum
BTC	Bitcoin	Bitcoin

Getting Started

1. Clone and install

git clone https://github.com/charlesms1246/minty
cd minty
npm install

2. Build

npm run build

3. Load in Chrome

Navigate to chrome://extensions
Enable Developer mode (top-right toggle)
Click Load unpacked
Select the project root (the folder that contains manifest.json and extension/)

4. Set up your wallet

Click the Minty icon in the toolbar → Settings → Wallet
Click Generate New for a fresh wallet, or paste an existing seed phrase
Click Initialize Wallet

Save your seed phrase — it is the only way to recover your wallet.

5. Fund your testnet wallet

Polygon Amoy USDT — Polygon Faucet
Ethereum Sepolia ETH — Sepolia Google Faucet
Arbitrum Sepolia — bridge from Sepolia or use Arbitrum Faucet

6. Create your first rule

Rules tab → fill in the form
Recommended starting values: All Creators · $0.02/min · USDT · Polygon · 3 min min · $5 max
Click Create Rule

7. Watch a Rumble video

Navigate to any video on rumble.com. The "Minty Active" badge appears in the top-right corner of the player. After the minimum watch time, a tip fires automatically.

8. (Optional) Connect an AI agent

Dashboard → AI Agent → select provider → enter API key → Connect AI Agent.

Mainnet Upgrade Guide

The extension ships in testnet mode. To switch to mainnet:

src/wallet.js — replace RPC_PROVIDERS and TOKEN_CONTRACTS with the mainnet values documented in .env.example
popup/popup.js — update getExplorerUrl() to mainnet explorers (polygonscan.com, etherscan.io, arbiscan.io, blockstream.info)
wallet.js — update ElectrumWs endpoint to a mainnet Bitcoin Electrum server
Security — implement proper seed phrase encryption before any mainnet use (see TODO in wallet.js)

Built for the Tether WDK Hackathon · Powered by Tether WDK

Name		Name	Last commit message	Last commit date
Latest commit History 44 Commits
extension		extension
icons		icons
openclaw-skill		openclaw-skill
popup		popup
src		src
website		website
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
manifest.json		manifest.json
package.json		package.json
vercel.json		vercel.json
webpack.config.js		webpack.config.js

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Minty

Features

Architecture Overview

Auto-Tip Decision Pipeline

Creator Wallet Extraction

AI Agent

Supported Networks & Tokens

Getting Started

1. Clone and install

2. Build

3. Load in Chrome

4. Set up your wallet

5. Fund your testnet wallet

6. Create your first rule

7. Watch a Rumble video

8. (Optional) Connect an AI agent

Mainnet Upgrade Guide

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Minty

Features

Architecture Overview

Auto-Tip Decision Pipeline

Creator Wallet Extraction

AI Agent

Supported Networks & Tokens

Getting Started

1. Clone and install

2. Build

3. Load in Chrome

4. Set up your wallet

5. Fund your testnet wallet

6. Create your first rule

7. Watch a Rumble video

8. (Optional) Connect an AI agent

Mainnet Upgrade Guide

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages