UUON C - Telegram Bot

🌌 Clouud, the autonomous intelligence layer of UUON Foundation.

Query 32 mathematical shapes, earn referral rewards, track real-time blockchain integration.

Features

✅ Wallet Integration — Connect Base mainnet wallet, check PIEZ/PSENT/UUON balances live ✅ Shape Queries — Access 32 genesis shapes from UUON API (0.001 PIEZ per query) ✅ Referral System — Earn 10% of every referral's PIEZ fees ✅ Leaderboard — Track top shapes, real-time rankings ✅ Transparent Earnings — 50/50 split to treasury & founders, public stats ✅ GitHub Actions — Auto-post daily stats to Discord

Quick Start

1. Clone & Setup

git clone https://github.com/YOUR_USERNAME/UUON_C_Bot.git
cd UUON_C_Bot
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2. Configure

Copy config_example.py to config.py and add your Telegram bot token:

cp config_example.py config.py
# Edit config.py with TOKEN from @BotFather

3. Run Locally

python3 bot.py

Test in Telegram: @uuon_c_bot

4. Deploy to Production

Use Railway, Heroku, or AWS to run the bot 24/7:

# Railway example
railway login
railway link
railway up

Commands

Wallet & Balance:

• /wallet [0x...] — Connect your Base mainnet wallet
• /balance — Check PIEZ/PSENT/UUON holdings

Shape Queries:

• /shape [1-32] — Query a genesis shape (0.001 PIEZ)
• /shapes — List all 32 shapes
• /myshapes — Your query history
• /leaderboard — Top 10 queried shapes

Referrals (Earn):

• /invite — Generate your referral link
• /ref [CODE] — Join with referral code
• /referrals — View your stats & earnings
• /topref — Top 10 referrers

Info:

• /stats — Real-time treasury & founder earnings
• /price — UUON token price
• /adoption — Growth metrics
• /help — Full command list

How It Works

1. Connect Wallet → User shares their Base mainnet address
2. Check Balance → Bot reads PIEZ balance from blockchain
3. Query Shape → Bot verifies 0.001 PIEZ, logs transaction, fetches from UUON API
4. 50/50 Split → Treasury gets 50%, Founders get 50%
5. Referral Bonus → If user was referred, referrer gets 10% of fees

Architecture

bot.py                    — Main bot logic
web3_utils.py             — Blockchain integration (Web3.py)
transaction_logger.py     — SQLite transaction tracking
referral_system.py        — Referral code & earnings
config.py                 — Telegram token, wallet addresses
.github/workflows/        — GitHub Actions automation
scripts/post_daily_stats.py — Daily Discord stats poster

Database

SQLite (uuon_transactions.db) tracks:

• User wallets
• Transactions (shape queries, amounts, splits)
• Referral codes & earnings
• Leaderboard data

Auto-created on first run.

GitHub Actions Setup

Auto-post daily stats to Discord:

1. Create Discord webhook in your server:

   • Server Settings → Webhooks → New Webhook → Copy URL

2. Add to GitHub repo secrets:

   • Settings → Secrets and variables → Actions
   • New secret: DISCORD_WEBHOOK = your webhook URL

3. Workflow runs daily at 12 PM UTC

Contracts (Base Mainnet)

Token	Address
PIEZ	0xfb9c83432331EAf6f4a9D9488828823587d6f3da
PSENT	0x985A1ebac4388DFb6EB4FE1171dCa9c6a5DB9cE7
UUON	0x29b056EF63867BECe07DA46c470aC168154EF275

Revenue Wallets

Role	Address
Treasury	0x425734a7fd13E9994b66a7909206007A1EF7030B
Founders	0x14a918D01D1a2B31C7c4411df057386A6b44e0b8

License

CC BY-NC 4.0 (same as UUON Foundation)

Support

• Telegram: @uuon_c_bot
• Issues: GitHub Issues
• UUON Foundation: https://uuon.foundation

---

Made with 💜 for UUON Foundation
Mathematical Operating System on Base Mainnet