CAMPAIGN KITby MIKODES
  • From $1,490 one-time
  • Full source code
  • Self-hosted

CAMPAIGN KIT · Source code

Bill token projects for Telegram campaigns. Run every client from one install.

Each client gets a branded Mini App with its own bot, a bot-filtered player list, a read-only report link and a TON airdrop claim. Stars cosmetics, sponsored quests and rewarded ads add in-app revenue on top of the fees you invoice.

Screens show a local demo campaign, "Nova (demo)", with demo players. There is no public demo yet.

Campaign Kit admin overview for the demo campaign Nova: players, daily active, retention, Stars revenue, activation funnel, live activity and a client report card
Mini App Play screen: points balance, the star mascot, energy bar, a live double-tap event, streak and season pass progress
Mini App Airdrop screen: allocation not calculated yet, fair score 100 and the list of eligibility checks

one-time price

$1,490

full source code

  • Full source code
  • Telegram Mini App · Web admin
  • 30-day refund
6
revenue lines in the code
9
explainable anti-bot signals
30
admin pages
321
automated tests, incl. a full airdrop run

Inside the package

  • Telegram Mini App
  • Telegram Stars
  • Bot API webhooks
  • TON Connect
  • ton_proof
  • Tact contract
  • Merkle claim
  • Adsgram
  • toncenter
  • PostgreSQL 16
  • Hono
  • React 19
  • Docker Compose

Product system

Five pieces. All wired together.

One API serves every campaign. Each campaign has its own bot, brand, token and anti-bot thresholds; the claim contract is deployed from your client's wallet.

  • Inside Telegram

    Player Mini App

    Play, quests, squads, season pass, Fairness Center, cosmetics shop.

  • Operator console

    Agency admin

    Campaigns, clients, anti-bot review, links, reports, sponsors, revenue.

  • One per campaign

    Telegram bots

    Webhook, menu button, Stars payments, channel checks, broadcasts.

  • TON · Tact

    Airdrop claim

    Merkle distributor deployed and funded from the client's wallet. The server holds no keys.

  • Hono · PostgreSQL 16

    Your API

    Multi-campaign, server-authoritative, audited. Runs on your server with Docker.

How you earn

Six revenue lines are in the code. You set them up in the admin.

The main line is the fee you charge a token project for running its campaign. The kit records it and hands the client a report. In-app lines come on top.

  • Revenue line 01

    Campaign fees you invoice

    Record setup fees, retainers, campaign fees and sponsor invoices per client and campaign. Totals appear on the revenue page next to in-app income. These are records; you invoice your client yourself.

    Admin → Revenue → Record income (owner only)
  • Revenue line 02

    Client report links

    A read-only, white-label report page per campaign or sponsor: players, growth, retention, funnel, anti-bot. Sell it as a service or include it in a retainer.

    Admin → Campaign → Reports
  • Revenue line 03

    Sponsored quests

    Sell quest slots to other projects at a price per verified completion. The quest stops by itself when the sponsor's budget is spent; export the invoice as CSV.

    Admin → Campaign → Sponsors · Quests
  • Revenue line 04

    Telegram Stars cosmetics

    Players buy skins, themes and frames with Stars. Telegram pays the bot owner about $0.013 per Star.

    Admin → Campaign → Shop · Purchases
  • Revenue line 05

    Season pass

    A premium track per season, paid once in Stars, that unlocks cosmetics and badges. You set the price per season; 0 turns it off.

    Admin → Campaign → Seasons → Premium pass
  • Revenue line 06

    Rewarded ads

    Adsgram rewarded ads with a server-to-server reward callback and a daily cap. Pricing is Adsgram's auction; the revenue page estimates only when you enter an eCPM.

    Admin → Campaign → Economy → Ads

Stars payments, rewarded ads and the channel quest need a live bot and are not yet tested with real money. Stars buy cosmetics only: never points, energy or airdrop allocation. MIKODES takes no share.

Earnings

Examples, not results

Arithmetic on made-up counts, to show how each in-app line adds up. Your numbers depend on your players, your clients and Telegram.

Example = count per day × rate × 30 days
ExampleCount per dayRatePer dayPer month (30 days)
Example Stars cosmetics: 2,000 Stars a day at $0.013 each is $26/day, $780/month.2,000 Stars$0.013 each$26$780
Example Season pass at 250 Stars: 10 passes a day at $3.25 each is $32.50/day, $975/month.10 passes$3.25 each$32.50$975
Example Sponsored quest at $0.25 per completion: 400 completions a day at $0.25 each is $100/day, $3,000/month.400 completions$0.25 each$100$3,000

Fees you charge clients for running a campaign are set and invoiced by you; the included business model guide lists public benchmarks. Telegram may hold Stars for up to 21 days before withdrawal.

How it works

From source code to the first client report.

  1. 01

    Host it

    Run the API and PostgreSQL with Docker Compose on a small server, and the Mini App and admin on static hosting, all over https.

  2. 02

    Create a campaign

    Paste the client's bot token from BotFather. The launch wizard sets the webhook and the menu button.

  3. 03

    Brand and configure

    Theme, token, economy, quests, season, events and sponsored quests, with a live phone preview.

  4. 04

    Grow and filter

    Share tracked links, watch cost per real player, review flagged accounts and send the client a report link.

  5. 05

    Snapshot and claim

    Publish the allocation; the client deploys and funds the claim contract from their own wallet and players claim.

Screens

Real screens. Demo campaign, demo players.

Captured from a local install with the demo campaign "Nova (demo)". Nothing on these screens is a real client or a real result.

PlayServer-checked taps, energy, live events.
QuestsSeason pass, daily reward, puzzle.
SquadSquads with a season leaderboard.
Fairness CenterPlayers see every check before the snapshot.
Season passPremium track unlocks cosmetics only.
Stars shopNever affects points or the airdrop.
OverviewReal players, funnel and live activity per campaign.
Season builderEdit the season with a live phone preview.
Tracked linksCost per real, non-bot player.
Client reportA read-only link you hand to the client.
QuestsChannel joins checked by the bot.
SponsorsBudget cap and invoice CSV.
SquadsModerate squads and see standings.

Features

What is in the code. Each item has tests behind it.

Everything below exists in the source today. Parts that still need a live bot are marked.

  • Many campaigns, one install

    Each campaign has its own bot token (encrypted at rest), webhook secret, theme, token, economy and anti-bot thresholds. Clone a campaign's setup for the next client.

    Clones copy configuration only, never players, links, reports or secrets.

  • Fairness Center

    Published rules with a change log, a fair score, re-verification and appeals, visible to every player.

  • Anti-bot scoring you can explain

    Nine signals such as tap cadence, referral bursts, shared IP or device, fresh or shared-funder wallets. A review queue with bulk decisions and appeals.

    In the end-to-end test a 20-account bot farm is excluded and organic players stay clean.

  • Non-custodial TON claim

    Merkle distributor in Tact: claim by the listed wallet only, double claims rejected, deadline and withdraw.

    Tested in a sandbox. A third-party audit is recommended before real value.

  • Tracked links with QR

    Spend and cost per real player for every KOL post, ad or channel link.

  • Analytics clients understand

    Daily active players, D1/D7/D30 retention, weekly cohorts, activation funnel and live activity.

  • Seasons, events, squads, puzzles

    Seasonal waves, live multipliers, squads of up to 100, a daily puzzle and 12 achievements.

  • Server decides every point

    Tap rate is capped per window and every point change is a ledger row. Auto-clickers cannot inflate scores.

  • Team roles and audit log

    Owner, manager and viewer roles, redaction by default, audited reveals and session revocation.

  • Bot broadcasts to segments

    Preview the count, schedule, send at up to 25 messages a second, resume after a restart.

    Tested against a mocked Bot API; not yet sent to real chats.

Admin

An agency workspace. Not a single-game panel.

Every client, campaign and sponsor in one place, with what each one brings in.

  • ClientsGroup campaigns by client and record what each one pays.
  • Launch wizardBot token, webhook, menu button, branding and go live.
  • Anti-bot reviewQueue, overrides and appeals, all audited.
  • Links and reportsCost per real player and read-only client reports.
  • SponsorsPrice per completion, budget cap, invoice CSV.
  • RevenueStars, sponsored income, ads estimate and recorded fees.
Revenue page for the demo campaign before any income is recorded: Stars, sponsored and ads totals at zero
Live events calendar with a double-tap weekend event

Pricing

One-time licence. You host it, you keep what it earns.

Prices are the planned launch prices. Talk to us on Telegram before buying.

Project licence

$1,490one-time

Your own campaigns under one brand.

  • Full source: API, Mini App, admin, airdrop library, TON claim contract
  • Docker Compose setup and .env template
  • Business model guide and contract notes
  • 321 automated tests, including a full airdrop run
  • 30-day refund
Talk on Telegram
hey@mikodes.com

Agency licence

$3,900

Run unlimited campaigns for your clients, fully white-label, with client report links.

  • Unlimited client campaigns
  • White-label reports
  • Clients and campaign cloning
Ask for a quote

Installation

Quote

We set it up on your server and connect the first bot.

  • Server and https setup
  • First campaign and bot
  • Hand-over call in writing
Ask for a quote

You bring

  • Hosting, domain and https
  • A Telegram bot per campaign (BotFather)
  • The token, its liquidity and TON network fees
  • An Adsgram account for rewarded ads
  • A toncenter API key (optional)
  • A contract audit and legal advice for your market
  • Players and marketing

Documentation

Written for a first install. From BotFather to the airdrop claim.

Every command, every setting and a go-live checklist. Search with /.

  • Getting started
  • Requirements
  • Installation
  • Configuration
  • Deployment
  • Running a campaign
  • Growth
  • Fairness Center
  • Airdrop
  • Monetization
  • Admin panel
  • Security
  • Troubleshooting
  • Changelog
Read the docs

FAQ

Questions buyers ask. Before they buy.

Is there a live demo?

Not yet. A demo bot is being prepared. The screens on this page come from a local install running a demo campaign with demo players. Ask on Telegram for a walkthrough.

Who is it for?

Crypto marketing agencies that run launch campaigns for token projects, and TON projects that want to run their own pre-launch campaign and airdrop.

Can players buy points or allocation with Stars?

No. Stars buy cosmetics and the season pass track only. Points, energy, boosts and allocation cannot be bought, and there is no paid randomness. This is enforced in the API and tested.

Who holds the keys for the airdrop?

Nobody on the server. The client deploys and funds the claim contract from their own wallet through TON Connect, and each player claims with their own wallet.

Is the claim contract audited?

No. It has 27 contract tests in a sandbox and a full end-to-end run. We recommend a third-party audit before it holds meaningful value.

What do I need to run it?

A small server with Docker for the API and PostgreSQL, static hosting for the Mini App and the admin, https, and a bot from BotFather for each campaign.

Which ad networks are supported?

Adsgram, with a server-side reward callback. Monetag is not supported.

How much will I make?

That depends on your clients, your players and Telegram. The kit gives you the revenue lines and the numbers; the examples on this page are arithmetic, not results.

Support

Talk to the people who wrote it. In writing, in English.

Pre-sale questions, installation or custom work.

Telegram · fastest

t.me/mistrba
Talk on Telegram

Email

hey@mikodes.com

Written support in English.

See the screens