โโโ โโโโโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโ โโโ โโโโโโโ โโโโโโโโโโ โโโโโโ โโโ
โโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ
โโโโโโโ โโโโโโ โโโโโโโ โโโโโโ โโโ โโโโโโ โโโโโโโโโ โโโโโโ โโโ โโโโโโโโโโโ
โโโโโโโ โโโโโโ โโโโโ โโโโโโ โโโ โโโโโโ โโโโโโโโโโโโโโโโ โโโ โโโโโโโโโโโ
โโโ โโโโโโโโโโโ โโโ โโโ โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโ โโโโโโ
โโโ โโโโโโโโโโโ โโโ โโโ โโโโโโโ โโโโโโโ โโโ โโโโโโโโโโโโ โโโ โโโโโโ
๐ง Not just a bot. A context-aware AI observer that watches, thinks, and speaks at exactly the right moment.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฌ TELEGRAM โ ๐ค AI ENGINE โ โ๏ธ BLOCKCHAIN โ ๐ INSIGHT โ
โ โ
โ Gemini 2.0 Flash ร Bitcoin Tooling ร Chat Intelligence โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
| # | Section | Quick Jump |
|---|---|---|
| 01 | What is KEYFOUND AI? | โ Jump |
| 02 | Feature Arsenal | โ Jump |
| 03 | System Architecture | โ Jump |
| 04 | AI Brain Deep-Dive | โ Jump |
| 05 | Chat Intelligence System | โ Jump |
| 06 | Bitcoin Tooling Engine | โ Jump |
| 07 | Complete Command Reference | โ Jump |
| 08 | Internal Workflow Diagrams | โ Jump |
| 09 | Memory & State System | โ Jump |
| 10 | Setup & Deployment | โ Jump |
| 11 | Security & Production Grade | โ Jump |
| 12 | Roadmap | โ Jump |
| 13 | Team & Community | โ Jump |
KEYFOUND AI is a next-generation Telegram bot that fuses the power of Gemini 2.0 Flash AI with a battle-hardened Bitcoin cryptography engine โ creating a system that doesn't just respond to commands, it observes, thinks, and participates in conversations like an actual team member.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ TRADITIONAL BOT VS KEYFOUND AI โ
โ โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโ โ
โ "Waits for command" "Watches the room" โ
โ "Responds literally" "Understands context" โ
โ "Forgets after session" "Remembers everything" โ
โ "One trick at a time" "AI + Crypto + Chat unified" โ
โ "Needs to be tagged" "Joins when it matters" โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
KEYFOUND AI is built on 3 pillars:
๐ง INTELLIGENCE โ๏ธ CRYPTO POWER ๐ฅ SOCIAL AWARENESS
โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโ
Gemini 2.0 Flash Full BTC Tooling Chat Monitoring
Google Search RT Cryptographic Math Auto-Participation
GitHub Scanning Batch Processing Memory per User
Memory-Aware Live Price Feeds Context Summaries
| ๐ง Command / Trigger | ๐ Category | โก Action | ๐ฏ Output |
|---|---|---|---|
/start |
System | Bot init + welcome | Command list + community links |
/chatai <question> |
AI | Direct Gemini Q&A | Instant AI response |
/luck -g <n> |
Crypto | Random key gen | Generated wallet keys |
/luck -p <n> |
Crypto | Puzzle key gen | Puzzle-range keys |
/luck -k <n> |
Crypto | Hex key gen | Hex format keys |
/price <TOKEN> |
Market | Live price fetch | Real-time USD price |
/bal |
Blockchain | Balance check | BTC balance + TX count |
/derive |
Crypto | Full cryptographic derivation | RIPEMD160, SHA256, PubKey, X/Y coords |
/list |
Batch | Bulk address processing | outputs.txt with all results |
/alert |
News | RSS crypto news | Latest unseen articles |
/alert news |
News | Saved news log | news.log file |
/prog |
Utility | Send program file | program.txt delivered |
/git |
Dev | GitHub repos | All core repo links |
/trade |
Links | Trading platforms | Exchange URLs |
/database |
Links | Blockchain DBs | DB dump links |
/blockchain |
Links | Block explorers | Explorer URLs |
/mail |
Support | Contact info | Email addresses |
/stop |
System | Unregister user | Removed from USERS.log |
hey {question} |
AI Auto | Regex pattern trigger | Immediate AI answer |
hey shub / keyfound / bot / AI |
AI Trigger | Keyword engagement | Q&A button prompt |
| Chat volume โฅ 40 msgs | Monitor | Soft invite | "Can I join?" prompt |
| Chat volume โฅ 70 msgs | Monitor | Auto-intervention | Full AI summary paragraph |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ KEYFOUND AI โ SYSTEM OVERVIEW โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ [ TELEGRAM API ] โโโpollingโโโ [ BOT CORE ENGINE ] โ
โ โ โ โ
โ โผ โผ โ
โ Message Ingestion โโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ TRIGGER ROUTER โ โ
โ โผ โ โข /commands โ โ
โ ChatMonitor.record() โ โข Keywords โ โ
โ โ โ โข Regex patterns โ โ
โ โผ โ โข Reply context โ โ
โ Volume Threshold Check โ โข Chat volume โ โ
โ โ โโโโโโโโโโโโฌโโโโโโโโโโโโ โ
โ 40+ โ 70+ โ โ
โ โ โ โโโโโโโโโโโโดโโโโโโโโโโโโ โ
โ Invite Full-Mode โ โ โ
โ โ โโโโโโโโโโดโโโโโโโโโ โโโโโโโโโโโโดโโโโโโโโโ โ
โ โผ โ AI ENGINE โ โ BITCOIN ENGINE โ โ
โ Gemini 2.0 Flash โ Gemini Flash โ โ Blockchain APIs โ โ
โ + Google Search โ Google Search โ โ wallet.py โ โ
โ + GitHub Scanner โ GitHub Scanner โ โ price-index.py โ โ
โ + Memory Load โ Memory Load โ โ Batch Processor โ โ
โ โ โโโโโโโโโโฌโโโโโโโโโ โโโโโโโโโโโโฌโโโโโโโโโ โ
โ โผ โ โ โ
โ Response Generator โโโโโโโโโโโโฌโโโโโโโโโโโโ โ
โ โ โผ โ
โ โผ Response Formatter โ
โ short โ send text (Text / Markdown / .txt file) โ
โ long โ send .txt file โ โ
โ โ โผ โ
โ โโโโโโโโโโโโโโโโโโโโ Memory & Log Storage โ
โ (user.history.log / search.log) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Layer 1 โ INPUT LAYER
โโ Telegram polling โ raw update object
Layer 2 โ ROUTING LAYER
โโ Command handlers + regex matchers + keyword filters
Layer 3 โ MONITOR LAYER
โโ ChatMonitor sliding window (220s) + threshold logic
Layer 4 โ INTELLIGENCE LAYER
โโ Gemini AI + Google Search + GitHub Scanner + Memory
Layer 5 โ PROCESSING LAYER
โโ Bitcoin tooling + Blockchain APIs + Subprocess execution
Layer 6 โ RESPONSE LAYER
โโ Formatter โ text/file split โ Telegram send
Layer 7 โ PERSISTENCE LAYER
โโ User logs + global logs + chat window + cleanup
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ GEMINI AI PROCESSING PIPELINE โ
โ โ
โ User Input โ
โ โ โ
โ โผ โ
โ Load user.history.log โ
โ โ โ
โ โผ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ SMART PROMPT BUILDER โ โ
โ โ [MEMORY] โ past conversations โ โ
โ โ [ROLE] โ Bitcoin/ECC expert โ โ
โ โ [CONTEXT] โ chat window if needed โ โ
โ โ [QUESTION] โ user input โ โ
โ โ [TOOLS] โ Google Search enabled โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โผ โ
โ Domain Detection โ
โ โโโ Crypto/BTC topic? โ GitHub scan (25+ profiles) โ
โ โโโ Blockchain topic? โ Blockchair / Bitinfocharts โ
โ โโโ General topic? โ Reasoning + Google Search โ
โ โ โ
โ โผ โ
โ Gemini 2.0 Flash API (dynamic_threshold=0.6) โ
โ โ โ
โ โผ โ
โ Response โ
โ โโโ โค687 words โ Send as Telegram message โ
โ โโโ >687 words โ Save .txt โ Send file โ Delete file โ
โ โ โ
โ โผ โ
โ Save to user.history.log + search.log โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
The AI automatically scans these profiles to build crypto knowledge:
| ๐จโ๐ป Profile | ๐ง Specialty |
|---|---|
Mizogg |
Bitcoin hunting tools, scanners |
Dookoo2 |
Key derivation, BTC utilities |
Iceland2k14 |
Puzzle solvers, ECC tools |
JeanLucPons |
ECDSA, Kangaroo algorithm |
albertobsd |
secp256k1 mathematics |
25+ more |
All major Bitcoin dev repos |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ CHAT MONITOR โ SLIDING WINDOW ENGINE โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ Time Window: 220 seconds (rolling) โ
โ Storage: deque() โ auto-evicts old messages โ
โ Persistence: 10minchat.txt โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ MSG 1 MSG 2 MSG 3 .... MSG 39 MSG 40 โ โ
โ โ โ โ โ โ โ INVITE โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ MSG 1 .... MSG 40 .... MSG 69 MSG 70 โ โ
โ โ โ โ โ โโ FULL! โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ THRESHOLD โ BEHAVIOR โ RESULT โ
โ โโโโโโโโโ โ โโโโโโโโโโโโโ โ โโโโโโ โ
โ < 40 msgs โ Silent observer โ Bot stays quiet โ
โ โฅ 40 msgs โ Polite invite โ [Yes/No] buttons โ
โ โฅ 70 msgs โ Full AI summary โ Auto paragraph sent โ
โ Post-send โ Reset counter โ Clean slate โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
When the bot enters Full Mode (70+ messages), it doesn't just summarize โ it does it with personality:
- ๐คฃ Joke mode: Cracks context-aware jokes about the convo
- ๐ค Friendly abuse: Good-natured ribbing at participants
- ๐ Smart summary: Pulls key discussion points
- ๐ท๏ธ @-tags users: Mentions active participants by username
- ๐ Auto-reset: Clears window after responding
Input: Bitcoin Address
โ
โผ
โโโโโโโโโโโโโโโโโโโโ
โ Base58Check โ โ Decode & validate checksum
โ Decode โ
โโโโโโโโฌโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโ
โ Extract โ โ Pull RIPEMD160 hash
โ RIPEMD160 โ
โโโโโโโโฌโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโ
โ Compute โ โ SHA256 of public key
โ SHA256 โ
โโโโโโโโฌโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโ
โ Fetch Public โ โ API lookup
โ Key (API) โ
โโโโโโโโฌโโโโโโโโโโโโ
โ
โโโโโโดโโโโโโโโโโโโโโโโโ
โ โ
Compressed? Uncompressed?
โ โ
โผ โผ
Convert โโโโโโโโโโโโ Extract
โ
โผ
X Coordinate
Y Coordinate
โ
โผ
Fetch Balance + TX Count
โ
โผ
Output: 2-Message Markdown
โโโ Message 1: Raw cryptographic data
โโโ Message 2: Advanced technical explanation
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ BATCH PROCESSOR WORKFLOW โ
โ โ
โ User sends file or text block โ
โ โ โ
โ Regex extracts ALL Bitcoin addresses โ
โ โ โ
โ Deduplication (set() operation) โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ BATCHING ENGINE (size=50) โ โ
โ โ [addr1..50] โ API call โ โ
โ โ [addr51..100] โ API call โ โ
โ โ [addr101..150] โ API call โ โ
โ โ ... continues for ALL addresses โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ PROGRESS TRACKER (live update) โ โ
โ โ Total: 500 / Fetched: 250 / Left: 250 โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ Merge all batch results โ
โ โ โ
โ Write โ outputs.txt โ
โ โ โ
โ Send file to user โ
โ โ โ
โ ๐๏ธ Delete file from server โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
/bal command
โ
โผ
"Send me a Bitcoin address"
โ
โผ [User sends address]
โ
Regex Validation
โโโ Invalid โ "Try again"
โโโ Valid โ API Call (blockchain.info)
โ
โผ
Extract:
โข Balance (BTC)
โข Transaction Count
โ
โผ
Formatted Response
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ EVERY MESSAGE โ DECISION TREE โ
โ โ
โ Incoming Message โ
โ โ โ
โ โโโโ ChatMonitor.record(user, text) โ
โ โ โโโโ Append to deque + 10minchat.txt โ
โ โ โ
โ โโโโ Is it a reply to bot? โ
โ โ โโโ YES โ process_single_reply() โ Gemini โ respond โ
โ โ โ
โ โโโโ Matches `hey {question}` pattern? โ
โ โ โโโ YES โ extract question โ Gemini โ respond โ
โ โ โ
โ โโโโ User state == "awaiting"? โ
โ โ โโโ YES โ treat as AI question โ Gemini โ respond โ
โ โ โ
โ โโโโ Contains keyword? (hey/bot/shub/AI/admin) โ
โ โ โโโ YES โ show [Ask Q&A] [Cancel] buttons โ
โ โ โ
โ โโโโ Chat volume check โ
โ โโโ โฅ 70 โ handle_full() โ AI summary โ reset โ
โ โโโ โฅ 40 โ handle_invite() โ [Yes/No] buttons โ
โ โโโ < 40 โ silent (bot observes only) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
โ TRIGGER 1 โ TRIGGER 2 โ TRIGGER 3 โ TRIGGER 4 โ
โ Direct CMD โ Reply Chain โ Hey Pattern โ Keywords โ
โโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโค
โ /chatai โ User replies โ hey bot why โ "AI" โ
โ what is BTC โ to bot msg โ is BTC slow? โ "shub" โ
โ โ โ โ "keyfound" โ
โโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโค
โ Immediate โ Context- โ Regex match โ Button โ
โ AI response โ aware reply โ โ extract Q โ prompt shown โ
โโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโค
โ โก Fastest โ ๐งต Threaded โ ๐ฏ Pattern โ ๐ Soft UX โ
โโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโ
User: /luck -g 100
โ
โผ
Validate args
โโโ Exceeds limit? โ "Max is 2000" โ stop
โโโ Valid โ continue
โ
โผ
spawn: python wallet.py -g 100
โ
โโโโ Stream stdout live
โ
โผ
Capture all output
โ
โโโโ Text response to chat
โโโโ Generated key files โ send each โ delete each
โโโโ Timeout after 180s if stuck
history/
โโโ user123.history.log โ Per-user Q&A memory
โโโ user456.history.log โ Another user's history
โโโ bot.log โ System-level debug log
โโโ search.log โ Global search across all users
root/
โโโ USERS.log โ Active user registry
โโโ lastonline.log โ Last seen timestamps
โโโ 10minchat.txt โ Sliding chat window
โโโ news.log โ Sent news archive
โโโ outputs.txt โ Batch results (temp)
โโโ scanned_keys.log โ Scan statistics
โโโ [generated key files] โ Created by wallet.py (temp)
Before Every AI Call:
โโโโโโโโโโโโโโโโโโโโโ
Load: user.history.log
โ
โผ
Format as:
[MEMORY]
2024-01-01 | Q: What is secp256k1? | A: It's the elliptic curve...
2024-01-02 | Q: How does ECDSA work? | A: ...
After Every AI Call:
โโโโโโโโโโโโโโโโโโโโโโ
Append: [timestamp] Q: {question} | A: {response}
โ user.history.log (user memory)
โ search.log (global log)
ENTRY
โ
โผ
[idle / silent]
โ
โ Keyword detected
โผ
[buttons shown]
โโโโโโโโดโโโโโโโ
โ โ
Yes No / Cancel
โ โ
โผ โผ
[awaiting_input] [idle]
โ
โ User sends message
โผ
[processing]
โ
โผ
[response sent]
โ
โผ
[idle] โ cleared
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ /chatai <question> โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โข Directly queries Gemini 2.0 Flash โ
โ โข Supports replying to a specific message for context โ
โ โข Automatically loads your conversation history โ
โ โข Smart domain routing (crypto vs general) โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ hey {question} โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โข Hidden activation pattern (regex-matched) โ
โ โข Works silently without any command prefix โ
โ โข E.g.: "hey what is secp256k1?" โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ Keywords: hey / bot / shub / keyfound / AI / admin โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โข Triggers interactive button menu โ
โ โข [Ask Q&A] โ enters awaiting state โ
โ โข [Cancel] โ returns to silent mode โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ /luck [FLAGS] โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ -g <n> Random keys (max: 2000) โ
โ -p <n> Puzzle keys (max: 68) โ
โ -k <n> Hex keys (max: 10000) โ
โ --count <n> How many (combine with -p) โ
โ โ
โ Example: /luck -p 68 --count 1000 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ /price <TOKEN> โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โข Runs price-index.py via subprocess โ
โ โข Supports all coins in coins_pretty.txt โ
โ โข Falls back to full coin list if unknown token โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ /bal โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โข Multi-step conversation flow โ
โ โข Validates address via regex + Base58Check โ
โ โข Returns: balance (BTC) + transaction count โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ /derive โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โข Full cryptographic breakdown โ
โ โข Output: RIPEMD160, SHA256, compressed/uncompressed key โ
โ โข X and Y elliptic curve coordinates โ
โ โข Delivered as 2 Markdown messages โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ /list โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โข Send file OR paste raw text โ
โ โข Extracts thousands of BTC addresses โ
โ โข Live progress tracker in-chat โ
โ โข Returns outputs.txt โ auto-deleted after send โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ /alert Fetch latest RSS crypto news โ
โ /alert news Send saved news.log file โ
โ /prog Send program.txt to user โ
โ /git List all core GitHub repos โ
โ /trade Trading platform links โ
โ /database Blockchain DB dump sources โ
โ /blockchain Block explorer links โ
โ /mail Support email addresses โ
โ /start Welcome + full command list โ
โ /stop Remove from active users โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ SECURITY LAYERS โ
โ โ
โ Layer 1: INPUT VALIDATION โ
โ โโ Regex-based address verification โ
โ โโ Base58Check checksum validation โ
โ โโ Argument limit enforcement (/luck) โ
โ โ
โ Layer 2: TIMEOUT ENFORCEMENT โ
โ โโ 20 seconds โ standard commands โ
โ โโ 180 seconds โ heavy batch operations โ
โ โโ Auto-cancel + notify on breach โ
โ โ
โ Layer 3: RETRY & BACKOFF โ
โ โโ Attempt 1 โ fail โ wait 2^1s โ
โ โโ Attempt 2 โ fail โ wait 2^2s โ
โ โโ Attempt 3 โ fail โ abort gracefully โ
โ โ
โ Layer 4: FILE LIFECYCLE CONTROL โ
โ โโ outputs.txt: created โ sent โ deleted โ
โ โโ news.log: created โ sent โ deleted โ
โ โโ Key files: created โ sent โ deleted โ
โ โ
โ Layer 5: ANTI-SPAM CONTROLS โ
โ โโ last_ai_prompted flag โ
โ โโ Invite deduplication โ
โ โโ Chat monitor auto-reset โ
โ โ
โ Layer 6: GRACEFUL SHUTDOWN โ
โ โโ SIGINT/SIGTERM signal handlers โ
โ โโ Active task cleanup โ
โ โโ Safe exit sequence โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
| Feature | Implementation | Benefit |
|---|---|---|
| Core runtime | asyncio |
Non-blocking I/O |
| File operations | aiofiles |
Async read/write |
| API calls | aiohttp |
Concurrent requests |
| Retry logic | backoff |
Exponential backoff |
| Batch loop | Async iteration | No thread blocking |
| Response split | Auto-detect | Seamless UX |
| Process spawn | asyncio.subprocess |
Non-blocking execution |
Python 3.10+
Telegram Bot Token (from @BotFather)
Gemini API Key (from Google AI Studio)# Step 1: Install dependencies
pip install python-telegram-bot==20.9 google-genai aiofiles backoff aiohttp
# Step 2: Prepare your directory structure
mkdir history
# Place these files in root:
# โโโ keyfound_ai_bot.py
# โโโ wallet.py
# โโโ price-index.py
# โโโ program.txt
# โโโ coins_pretty.txt
# Step 3: Configure tokens (in bot file or .env)
TELEGRAM_TOKEN = "your-telegram-bot-token"
GEMINI_API_KEY = "your-gemini-api-key"
# Step 4: Run
python keyfound_ai_bot.pyproject-root/
โโโ keyfound_ai_bot.py โ Main bot (merged v2.0)
โโโ wallet.py โ Key generation engine
โโโ price-index.py โ Live price fetcher
โโโ program.txt โ Bot program info doc
โโโ coins_pretty.txt โ Supported coin list
โโโ history/ โ Auto-created on first run
โ โโโ bot.log
โ โโโ search.log
โ โโโ [user].history.log
โโโ USERS.log โ Auto-created
โโโ lastonline.log โ Auto-created
โโโ 10minchat.txt โ Auto-created
PHASE 1 โ IN PROGRESS โโโโโโโโโโโโ 80%
โโโ โ
Gemini 2.0 Flash integration
โโโ โ
Chat monitoring system
โโโ โ
Memory-aware responses
โโโ โ
Batch processing engine
โโโ ๐ Extended GitHub scanner coverage
PHASE 2 โ PLANNED โโโโโโโโโโโโ 30%
โโโ ๐ Multi-crypto support (ETH, SOL, LTC)
โโโ ๐ Voice replies (text-to-speech via ElevenLabs)
โโโ ๐ BTC Parser deep-dive module
โโโ ๐ Puzzle solver integration
PHASE 3 โ FUTURE โโโโโโโโโโโโ 0%
โโโ ๐ฎ Web dashboard for scan statistics
โโโ ๐ฎ Encrypted user memory vaults
โโโ ๐ฎ Scheduled automated alerts
โโโ ๐ฎ Multi-language AI response support
PHASE 4 โ VISION โโโโโโโโโโโโ 0%
โโโ ๐ก Group-specific AI personality modes
โโโ ๐ก On-chain tx monitoring & alerts
โโโ ๐ก Wallet fingerprinting module
โโโ ๐ก AI-assisted Bitcoin puzzle solver (69-puzzle)
| ๐งฉ Module | ๐ Role | ๐ง Key Functions |
|---|---|---|
MemoryManager |
User + global memory | load/save .history.log, append to search.log |
ChatMonitor |
Sliding window tracker | record(), get_count(), get_window(), reset() |
AIEngine |
Gemini 2.0 Flash bridge | prompt builder, domain router, response handler |
Config |
Central configuration | tokens, limits, paths, regex patterns |
TriggerRouter |
Message routing | keyword match, regex detect, reply context |
BatchProcessor |
Bulk address handling | chunk, fetch, merge, write, send, delete |
SubprocessRunner |
External script executor | wallet.py, price-index.py with timeout |
ResponseFormatter |
Output normalizer | text split, file creation, Markdown formatting |
| Platform | Link |
|---|---|
| ๐ค Telegram Bot | @devfam_bot |
| ๐ฌ Community Group | t.me/privatekeydirectorygroup |
| ๐ข Channel | t.me/privatekeydirectory |
| ๐ป GitHub (Main) | github.com/Dookoo2 |
| ๐ Website | mizogg.co.uk |
| ๐ง Email 1 | keyfoundhunt4ever@gmail.com |
| ๐ง Email 2 | shubshaini@blythexweb.de |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ KEYFOUND AI โ BUILT BY THE BEST โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ ๐ง Shub โ AI Architecture & Bot Core โ
โ โ๏ธ Mizogg โ Bitcoin Tooling & Scanning โ
โ ๐ Dookoo2 โ Key Derivation & GitHub Ops โ
โ โก Blythex โ Infrastructure & Deployment โ
โ ๐งฎ Iceland2k14 โ Puzzle Tools & ECC Mathematics โ
โ ๐ฅ Code Crusaders โ Testing, Ideas & Community โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ โ๏ธ KEYFOUND AI ร Gemini 2.0 ร Bitcoin โ๏ธ โ
โ โ
โ The bot that watches, thinks, and strikes. โ
โ โ
โ Made with โค๏ธ by the KEYFOUND Team โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
v2.0 โ March 2026 | Merged AI + Bitcoin Codebase
This README documents the full merged architecture of both the AI conversation engine and the Bitcoin cryptographic tooling engine.