SLH Ecosystem Guide

סקירה כללית

SLH Spark הוא אקוסיסטם דיגיטלי ישראלי המבוסס על 25+ בוטי טלגרם, FastAPI backend על Railway, PostgreSQL + Redis, GitHub Pages frontend ב-slh-nft.com, וטוקן SLH על BSC (BEP-20).

המערכת מוכנה לרמה מוסדית: audit log עם hash chain בלתי-שביר, CEX integrations (Bybit+Binance), AES-GCM encryption, ו-proof of reserves תשתיתי.

ארכיטקטורה

שכבות המערכת

עמודי האתר (20+ pages)

Public

Launch & DEX

Admin & Internal

API Endpoints (60+ total)

Base URL: https://slh-api-production.up.railway.app

🩺 Health & Stats

• GET /api/health — basic health check
• GET /api/stats — public stats (users, staked, deposits)
• GET /api/admin/dashboard — aggregated admin stats
• GET /api/admin/activity?limit=15 — recent activity feed

🔐 Auth & Users

• POST /api/auth/telegram — Telegram Login Widget auth
• POST /api/user/ensure — idempotent user creation (manual login)
• POST /api/auth/bot-sync — bot syncs user to DB (with secret)
• GET /api/user/{telegram_id} — user profile + balances
• GET /api/user/full/{telegram_id} — everything in one call

🏛 Institutional (Audit + CEX)

• GET /api/audit/verify-chain — SHA-256 hash chain integrity
• GET /api/audit/recent?limit=100&action_filter=...&user_id=...
• POST /api/cex/add-key — link CEX API key (encrypted AES-GCM)
• GET /api/cex/keys/{user_id} — list user's CEX keys
• POST /api/cex/sync/{key_id} — fetch balances from exchange
• GET /api/cex/portfolio/{user_id} — consolidated portfolio
• DEL /api/cex/keys/{key_id}?user_id=...

💎 Tokenomics

• GET /api/tokenomics/stats — supply, burned, staked, reserves
• POST /api/tokenomics/internal-transfer — FREE MNH/ZVK/SLH
• POST /api/tokenomics/burn — record burn (admin)
• POST /api/tokenomics/reserves/add — add backing reserves

📊 Strategy Engine

• GET /api/strategy/list — 3 backtested strategies
• GET /api/strategy/{id} — strategy details
• GET /api/strategy/backtest/{id}?months=12 — simulated returns

🚀 Genesis Launch

• POST /api/launch/contribute — record contribution
• POST /api/launch/verify/{id}?admin_key=... — verify + issue rewards
• GET /api/launch/status — live progress + contributors

📣 Broadcast & Shares

• POST /api/broadcast/send — send Telegram DM to all users
• GET /api/broadcast/history — recent broadcasts
• POST /api/shares/track — log share event
• GET /api/shares/stats?days=30 — share analytics

🎨 OG Images

• GET /api/og/{slug}.png — dynamic 1200×630 PNG for social shares
• Slugs: index, network, dashboard, wallet, bots, trade, earn, community, blockchain, roadmap, admin, launch-event, dex-launch, daily-blog, guides, referral

🌐 Network & Blockchain

• GET /api/network/slh-holders?limit=100 — BSC holders (BitQuery/Etherscan)
• GET /api/external-wallets/{user_id}
• POST /api/external-wallets/add

🎁 Genesis 49 + Cashback

• GET /api/beta/status — coupon remaining
• GET /api/cashback/{user_id} — tier status
• POST /api/cashback/process/{user_id}

בוטים (25 total)

Financial

• LIVE @SLH_AIR_bot — Main investment hub (staking, portfolio, 10-gen referrals)
• LIVE @SLH_Wallet_bot — Multi-currency wallet
• LIVE @TON_MNH_bot — ILS-pegged stablecoin
• LIVE @SLH_Ledger_bot — Transaction ledger

Community & Education

• LIVE @NFTY_madness_bot — Tamagotchi virtual pet
• BETA @SLH_Academia_bot — Educational platform
• BETA @SLH_community_bot — Community hub

See full list at /bots.html

Multi-Token Economy

Value Mechanisms

• Buyback-and-burn: 50% of platform revenue → buy SLH → burn (deflationary)
• Staking lock-up: Users lock SLH for yield (supply shock)
• Utility demand: VIP features require SLH holdings
• Backing reserves: SLH backed by $X USDT in company wallet
• Liquidity mining: LP providers earn ZVK rewards
• Anti-fraud (ZUZ): Guardian bot assigns ZUZ to scammers — 100 ZUZ = auto-ban across all groups, cross-group intelligence

Institutional Grade

Compliance Controls

Genesis Launch Workflow

1. Partner is invited via /partner-launch-invite.html?partner=NAME
2. Partner sends BNB to company wallet: 0xd061de73B06d5E91bfA46b35EfB7B08b16903da4
3. Partner reports TX via the form on /launch-event.html
4. Admin verifies: POST /api/launch/verify/{id}?admin_key=...
5. Pool created on PancakeSwap using collected BNB + treasury SLH
6. LP locked in Mudra Locker for 6 months
7. Contributor receives: Genesis NFT + 500 ZVK + co-founder credit in audit log

Key User Flows

New User Onboarding

1. User visits slh-nft.com
2. Clicks "Try Dashboard"
3. Dashboard: login via Telegram Widget OR manual ID entry
4. Manual ID → POST /api/user/ensure (creates in web_users)
5. If not registered → Registration panel (22.221 ILS or GENESIS49 coupon)
6. Registered → Full dashboard access

CEX Portfolio Connection

1. /wallet.html → "תיק CEX מלא"
2. Click "🔑 חבר API Key חדש"
3. Follow 11-step tutorial for Bybit (Read-Only!)
4. POST /api/cex/add-key with encrypted secrets
5. Auto-sync: POST /api/cex/sync/{key_id}
6. View: GET /api/cex/portfolio/{user_id}

Environment Variables (Railway)

Troubleshooting

מילון מונחים

• Genesis 49 — 49 המשתמשים הראשונים שקיבלו NFT + 10 ZVK חינם דרך קוד GENESIS49
• AMM — Automated Market Maker. PancakeSwap משתמש ב-x*y=k constant product.
• Slippage — הפרש בין המחיר הצפוי למחיר הביצוע בעסקה ב-DEX, גדל ככל שה-pool רדוד.
• LP — Liquidity Provider. מי שמפקיד את שני הטוקנים ב-pool ומקבל LP tokens בתמורה.
• Rug pull — כשיוצר ה-pool מושך את כל הנזילות ובורח. ה-Mudra Lock מונע את זה.
• TDZ — Temporal Dead Zone. באג JS שקרה ב-admin.html (תוקן).
• Hash chain — שרשרת SHA-256 בה כל רשומה מכילה hash של הקודמת, ובכך יוצרת יומן בלתי-שביר.
• KYC — Know Your Customer, תהליך אימות זהות של משתמשים.
• MPC — Multi-Party Computation. טכנולוגיית custody מתקדמת (Gnosis Safe, Fireblocks, Zengo).