Campaign Kit docs
v1.0.0
Get help
● Help · Versions

Changelog
what changed in each release.

Releases of the Campaign Kit, newest first. The API health endpoint reports the installed version.

011.0.0 · first marketplace release

Current 321 automated tests.

  • Many campaigns from one install, each with its own Telegram bot, brand, token and Mini App; clone a campaign as a template.
  • Player Mini App: tap and farm, upgrades, daily streak with savers, quests, two-tier referrals, squads, daily puzzle, 12 achievements, Story and chat sharing, Telegram fullscreen, home-screen and emoji-status hooks.
  • Seasons with a cosmetic-only Stars season pass and live events (tap and farm multipliers).
  • Stars cosmetics shop with refunds; Adsgram rewarded ads with a server-side reward callback.
  • Anti-bot with evidence, review queue, appeals and the Fairness Center: public versioned rules, fair score and checks, re-verification window, reduced reward instead of a ban.
  • Airdrop: fair multipliers, snapshot, Merkle root and rules frozen at publish, TON distributor deployed and funded from your wallet, player claim.
  • Operator admin: analytics (D1/D7/D30, cohorts, funnel, live activity, referral tree), tracked links with cost per real player, clients, white-label report links, segmented bot broadcasts, sponsors and sponsored quests with budgets and invoice CSV, revenue page, roles, redaction and audit log.
  • Docker Compose for the API and PostgreSQL.

Known limitations

  • Monetag is not implemented (Adsgram only).
  • No /paysupport bot command yet; add one before selling for Stars (Telegram expects it for payments).
  • The distributor contract has not been independently audited.