Achivator
Testnet
ruen

How to connect your chat

A guide for the group's creator: from a test wallet to the pool members claim their jetton rewards from. Everything happens on the TON testnet — no real money needed. Takes 15–20 minutes.

What you need

1

Create a testnet wallet

  1. Install Tonkeeper and create a regular wallet if you don't have one yet.
  2. Open “Settings” and quickly tap the Tonkeeper logo at the bottom of the screen 5 times — “Dev Menu” appears.
  3. Tap the wallet name at the top of the main screen → “Add Wallet” → “Testnet Account”.
  4. Enter a 24-word recovery phrase. Your main wallet's phrase works too — testnet balances are separate — but a dedicated test wallet is the safer choice.
  5. Copy the testnet wallet address — it starts with 0Q… or kQ….
The wallet built into Telegram (@wallet) doesn't support the testnet. Any other testnet wallet that connects via TON Connect will do.
Done when Tonkeeper's wallet list has a wallet marked Testnet.
2

Get test TON

  1. Open @testgiver_ton_bot, send it your testnet wallet address and pass the check.
  2. If it doesn't reply or asks you to wait, try @tnfaucet_bot.

What the TON is for: issuing the jetton, activating the pool (your wallet sends 0.3 TON, 0.1 TON stays on the pool contract, the rest comes back), setting the admin wallet (0.05 TON) and the gas of each pool top-up (your wallet sends 0.25 TON, what is not spent comes back). Achivator takes no fee in TON. 2 TON is plenty, and if you run out, just ask for more.

Done when the testnet wallet in Tonkeeper has a non-zero TON balance.
3

Issue (mint) your jetton

A jetton is the token your chat rewards members with. The easiest way to issue one is TON Minter:

  1. Open minter.ton.org/?testnet=true — the testnet=true parameter matters: without it the minter works on mainnet.
  2. Tap “Connect Wallet” → Tonkeeper and pick the testnet wallet.
  3. Fill in the form: Name (for example, “Our chat coins”), Symbol (short, 3–5 Latin letters, e.g. CHAT), Decimals — keep 9, Tokens to mint — how many to issue, e.g. 1,000,000. Description and image link are optional.
  4. Tap “Deploy” and confirm the transaction in your wallet. The whole supply lands in your wallet.
  5. When the jetton page opens, copy the jetton address (the master contract address, “Jetton address”). You'll need it in step 6.
You need the jetton's master contract address — not your wallet address and not a “jetton wallet” address. Tonkeeper shows it on the jetton card; in the minter it's in the jetton page's URL.
Done when your jetton shows up in the testnet wallet in Tonkeeper with the minted amount.
4

Add @achivator_bot to the group

  1. Open the group → tap its name → “Add Members”.
  2. Find @achivator_bot and add it.
Done when the bot posted its greeting in the group: “Hello! I'm the Achivator Bot…”.
5

Make the bot an admin

  1. Group profile → “Edit” → “Administrators” → “Add Admin”.
  2. Pick achivator_bot and save. The default rights are fine.

Admin rights let the bot see messages and reactions and check who sends it commands. The bot stores statistics only, not message texts.

Done when the bot replied “Thank you for granting me admin rights!…”.
6

Send the bot its commands

Type them right in the group, from your creator account:

/verify@achivator_bot

Confirms you are the chat's creator. The bot replies “Verified. You are creator.”

/jetton EQ…jetton_address

Sets the jetton from step 3 as the chat's reward. The bot replies “Reward jetton set: …”. /jetton without an address shows the current jetton.

If “Remain Anonymous” is on in your admin rights, turn it off: the bot can't see who sent an anonymous message and won't accept the command.
Done when the bot confirmed both.
7

Activate the reward pool

The pool is your chat's smart contract that members claim their jettons from.

  1. Open the mini app: t.me/achivator_bot/app (or the button in the chat with the bot).
  2. At the top right tap “Connect Wallet” → Tonkeeper and pick the testnet wallet.
  3. In “My chats” pick your group — its pool page opens.
  4. Tap “Activate pool” and confirm 0.3 TON in your wallet. It's a one-off: 0.1 TON stays on the pool contract to pay its network storage, the rest comes back minus gas.
Done when the chat shows a green “Pool active” badge (usually within a minute).
8

Set the pool's admin wallet

  1. On the same page, in the “Step 1 · Admin wallet” block tap “Make this wallet the admin”.
  2. Confirm the transaction (0.05 TON).

Only this wallet can withdraw jettons from the pool, set the daily payout limit and pause payouts. The step is required: until the pool has an admin, it sends deposits back.

Done when the block turned into “Top up” and the pool card shows an Admin wallet.
9

Fund the pool with jettons

  1. In the “Top up” block enter how many jettons to move into the pool — for example, 100,000.
  2. Tap “Top up pool” and confirm. The transaction carries only network gas, no fee; the TON that is not spent comes back.
Done when the “Reward pool” card shows the jetton balance. Your chat is connected!

What's next

Points for reactions. Members earn points when their messages get positive reactions: 👍 ❤ 🔥 ❤‍🔥 🎉 😍 🥰 👏 💯 🤩 😁 🤣 🙏 🤝 🏆 👌 ⚡ 🫡 😎 🤗 😇 💘 🍾 🆒. Any message counts — text, photos, stickers, voice — but only those written after the bot became an admin. Paid stars, premium emoji and anonymous reactions in channels earn nothing. Reactions to the creator's messages are worth more. For a reaction to count, the person reacting needs at least 5 messages in the chat, and the number of reactions one person can give another per day is capped — that makes farming harder.

Manual rewards. You and other admins can grant points for anything: reply to a message with /reward 50 for helping or send /reward @username 50 reason.

Payout rules. On the pool page, the “Claim rules” block sets how many days until points can be claimed (3 by default), which weekdays claims are open, and a vacation pause. For testing set 0 days so you don't have to wait.

Point price. On the pool page, the “Point price” block sets how many jettons one point is worth (the platform rate by default). The price also applies to points already earned. An increase applies at once, from the next claim. A decrease takes effect only after 7 days (later if claims aren't open every day: members get at least one full claim day before it; claims can't be paused while it is pending): the bot announces it in the chat right away so members can claim at the current price, and again when the price drops. Members see every change in the mini app for 7 days.

Bot language. The bot answers in the Telegram language of whoever writes to it. To fix one language for the whole chat, the creator or an admin sends /lang ru or /lang en.

How members claim. In the mini app, with the “Claim” button. They also need a testnet wallet and a little test TON for gas (about 0.15 TON per payout).

Pool protection. From the admin wallet you can pause payouts, change the daily limit (10% of the pool per day by default) and withdraw jettons back. These limits are built into the contract and hold even if something happens to the bot.

Troubleshooting

My chat isn't in “My chats”+

A chat appears there after /verify@achivator_bot or /jetton sent by the creator in the group. Send the command and restart the mini app.

The bot ignores commands+

Check that the bot is a group admin (step 5). If the group has several bots, mention it in the command: /jetton@achivator_bot ….

The bot says “I cannot see who sent this”+

You are posting anonymously or as a channel. Turn off “Remain Anonymous” in your admin rights and send the command as yourself.

“Only the chat creator can set the reward jetton”+

Only the group's creator can set the jetton and manage the pool. Other admins can grant points with /reward.

The bot rejects the jetton address+

It needs the full jetton master contract address — starting with EQ, UQ, kQ or 0Q. Don't confuse it with your wallet address.

The wallet won't confirm or complains about the network+

Most likely a mainnet wallet is connected. In the mini app tap the wallet address at the top → “Disconnect” and connect the testnet wallet again.

Stuck on “Still confirming on-chain”+

The testnet is sometimes slow. Wait a minute and tap “Refresh” at the bottom of the pool page.

Out of test TON+

Ask @testgiver_ton_bot or @tnfaucet_bot for more.

Open Achivator in Telegram