Telegram Mini App Kripto Jokoaren Iturburu Kodea Osorik

Zure Telegram Mini App proiektua hasi gaur. Produktu hau osorik, produkzio prest iturburu kode paketea da Telegram joko batentzat.

Telegram joko kodea erosi nahi baduzu erabili ahal izateko prest dagoena, hau da aukera zuzena. Hau ez da oinarrizko txantiloi bat baizik. Aplikazio erabilgarri osoa da teknologia moderno eta eskalagarriarekin eraikia.

Jokoa "Watermelon estiloko" fisikari oinarritutako fusion jokoa da. Erabiltzaileak interesatuta mantentzeko diseinatua dago. Kodeak bi ordainketa sistema integratu ditu: Telegram Stars eta TON Blockchain diru-zorroak. Erreferente sistema sendoa, eguneroko bonuak eta lider taula globala ere baditu.

Garapen denbora aurreztea. Erosi Next.js Telegram mini app kodea eta zure proiektua berehala abiarazi.

🚀 Oinarrizko Ezaugarriak

Pakete honek ezaugarri guztiz inplementatuak ditu.

1. Ordainketa Sistema Bikoitza: Monetizazio Presta

Kode base honek bi ordainketa integrazio garrantzitsu ditu Telegram aplikazioentzat.

• 💎 Telegram Stars Integrazioa: Telegram-en diru natiboarekin, Starsekin, ordainketak onartu ditzakezu. Kodeak (app/api/points/buy/route.ts) fakturak sortzeko eta joko puntuak saltzeko logika kudeatzen du.
• 💰 TON Blockchain Ordainketak: Hau da behar duzun TON ordainketak integrazioa kodea.
• TON Connect: Kripto diru-zorroak konektatzeko osagaia (TonPaymentModal.tsx) barne hartzen du.
• Segurtasun Berrikuspena: Atzeko aldea (app/api/points/verify-ton/route.ts) blockchain-en transakzioak egiaztatzen ditu iruzurra saihesteko.
• Diru-zorro Kudeaketa: Sistema segurtasunez kudeatzen ditu diru-zorro konexioak.

2. Engranatutako Jokatzeko Motorra

Jokoak fisikari oinarritutako sistema erabiltzen du jokalariak interesatuta mantentzeko.

• Fisika Logika: components/game/SuikaGame.tsx fitxategiak joko logika osoa du Matter.js motorra erabiliz.
• Zerbitzari Aldeko Segurtasuna: Joko logika zerbitzarian exekutatzen da (app/api/game/). Honek saioak kudeatzen eta puntuak balioztatzen ditu.
• Anti-Trampa Sistema: Sistema zerbitzarian balioztatzen du puntuak trampak saihesteko. Joko bakoitzeko puntu maximoa mugatzen du.
• Jokoaren Atzerapena: 3 orduko denbora muga sartzen da erabiltzaileak egunero itzultzeko bultzatzeko.

3. Stack Oso Next.js 15 Arkitektura

Proiektu honek teknologi moderno eta errendimendu altua erabiltzen du.

• Next.js App Router: Proiektuak azken fitxategi oinarritutako bideraketa eta zerbitzari aldeko logika erabiltzen ditu.
• TypeScript & React: Kodea guztiz idatzia dago egonkortasun hobea eta mantentze errazagoa lortzeko.
• Tailwind CSS: Diseinua estandar utility klaseak erabiltzen ditu erantzun UI-a lortzeko.
• API Endpoints: Atzeko aldea REST API osoa app/api/ karpetan dago.

4. Erabiltzaileen Hazkunde Sistemak

Kode hau gehiago erabiltzaile lortzen laguntzeko diseinatua dago.

• Erreferente Sistema: Erabiltzaileek kode bakarra dute lagunak gonbidatzeko. Gonbidatzaileak eta erabiltzaile berriak bonus puntuak jasotzen dituzte. Honek erabiltzaileak aplikazioa partekatzera bultzatzen du.
• Eguneroko Bonua: 7 eguneko sarrera bonus sistema (app/api/points/claim-daily/route.ts) erabiltzaileak egunero aplikazioa irekitzeagatik saritzen ditu.
• Lider Taula Globala: Erabiltzaileak puntu altuenak lortzeko lehian daude zerrenda publikoan.

5. Seguru eta Eskalagarri Atzeko Aldea

Atzeko aldea errendimendu eta segurtasunerako eraikia dago.

• Seguru Telegram Auth: Sistema zerbitzarian balioztatzen du erabiltzaile datuak Telegram-etik segurtasuna ziurtatzeko.
• Drizzle ORM: Datu base eskema (lib/db/schema.ts) guztiz idatzia dago segurtasunagatik.
• Neon Serverless Postgres: Konfigurazioa prest dago Neon, eskala daitekeen Postgres datu basea.
• Rate Limiting: Kodeak zure API babesten du spam eta gehiegikeriak saihesteko Upstash Redis erabiliz.

6. Airdrop & Diru-zorro Ezaugarriak

Prestatu Web3 ezaugarrietarako eta TON ekosistemarako.

• Airdrop Diru-zorro Bilduma: Erabiltzaileek euren TON diru-zorro helbidea aurkeztu dezakete etorkizuneko token airdrop-entzat.
• TON Connect Provider: Aplikazioa provider batean bildua dago TON konektibitatea orri guztietan onartzeko.

---

💻 Teknologia Stack

• Framework: Next.js 15+ (App Router)
• Hizkuntza: TypeScript
• Frontend: React, Tailwind CSS
• Backend: Next.js API Routes
• Datu Basea: Neon (Serverless Postgres)
• ORM: Drizzle ORM
• Cache/Rate Limiting: Upstash (Serverless Redis)
• Joko Motorra: Matter.js
• Ordainketak: Telegram Stars, TON Blockchain
• Auth & SDK: Telegram Web App SDK, TON Connect

---

📦 Zer Jasotzen Duzu

• Iturburu Kode Osoa: Kripto joko proiektuaren kode osoa.
• 30+ TypeScript Fitxategiak: Frontend osagai guztiak, API routes, eta datu base eskematak barne hartzen ditu.
• Ezarri Gida: README.md fitxategia Telegram bot, datu base, eta Vercel-era ezartzeko argibideekin.
• Utility Scripts: Webhook ezarri eta token sortzeko tresnak.
• Konfigurazioa Fitxategiak: Oso package.json, drizzle.config.ts, eta tailwind.config.ts.
• Segurtasun Middleware: Produkzio prest API babesa.

---

🎁 BONUS: Telegram Developer Kit — Reference App

Erosi bakoitza Telegram Developer Kit-ra sarbidea ematen du. Hau erabilgarri dagoen reference aplikazioa da Telegram Mini App API adierazten dituena. Hau ikasteko edo zure proiekturako kodea kopiatzeko erabil dezakezu.

Zer dago Bonus-ean?

• 17+ Erantsi Demos: Telegram ezaugarrien zuzen adibideak botoiak, popup-ak, eta sensorrak.
• 50+ Kode Zatiak: Erabili ahal izateko prest dauden kode blokeak.
• Oso TypeScript Laguntza: Telegram WebApp API-entzat definizio motak.
• Modern Next.js 15 Kode: Azken arkitekturarekin eraikia.

API Estalitako Developer Kit-ean

Kategoria	Ezaugarriak
Authentication	Seguru zerbitzari aldeko datu balioztatzea
UI Components	Main Button, Back Button, Settings Button
Data & Storage	Cloud Storage and Clipboard API
Device Access	Sensors, Haptics, Orientation, Location
Security	Biometric authentication (Fingerprint & Face ID)
Media	QR Scanner, File Downloads
Monetization	Telegram Stars ordainketa fluxu adibideak
Game Features	Pantaila osoa modua eta orientazio blokeoak

Zergatik da Bonus hau Baliozkoa

Telegram Mini App garatzea hainbat API zehatz ulertu behar du. Kit honek ematen ditu:

• Reference Kode: Ikusi zehazki nola funtzionatzen duten ezaugarriak.
• Praktika Onak: Aplikazio errealetan erabiltzen diren kode egiturak.
• Testing Area: Probatu ezaugarriak zure jokora gehitu aurretik.

---

📈 Abiarazi Zure Joko Proiektua

Aplikazio bat ordainketekin, joko motor batekin, eta atzeko alde batekin eraikitzea denbora eta diru asko behar ditu.

Pakete honek amaitutako oinarria ematen dizu minutu batzuetan. Ere reference aplikazioa jasotzen duzu etorkizuneko ezaugarriak eraikitzeko laguntzeko.

Erosi 'Telegram Mini App Kripto Jokoaren Iturburu Kodea Osorik' gaur. Hau da kalitate altuko Next.js Telegram mini app kodea eta TON ordainketak integrazioa behar duzuna.

Erosi kodea. Ezarri zure jokoa. Hasi zure proiektua.