EPWX Tasks

EPWX Blog

Telegram Group Owner Rewards: End-to-End Step-by-Step Flow

This guide explains exactly how Telegram Group Owner Rewards work in EPWX Task Hub, from group registration to admin payout and ledger tracking.

Reward rule: 10,000 EPWX is distributed to the Telegram group owner for each eligible group-attributed member daily claim.

1. Telegram Bot Commands

Use these commands in the EPWX Telegram bot to run the owner-reward and claim flows:

CommandPurpose
/miniappOpen EPWX Daily Claim Mini App.
/verifyLegacy Telegram verification flow (not required for Mini App claim path).
/registergroupGroup owner only: register current Telegram group for owner rewards.
/postdailyclaimbuttonGroup owner only: post the Daily Claim button in the group.
/startOpen base bot flow. Also supports deep-link params used by group registration and group claim campaigns.

2. Group owner registers a group

  • Group owner runs the registration command in Telegram.
  • Telegram bot opens the Mini App with group registration context.
  • Owner connects wallet and links it to Telegram account.
  • Backend verifies owner role in the Telegram group before activation.

3. Members claim from group context

  • Member opens Mini App from the group claim link.
  • Member links wallet and submits daily claim signature.
  • Backend validates membership and official Telegram requirements.
  • If eligible, a Telegram Group Owner Reward is recorded.

4. Reward status lifecycle

Pending

Created after a valid member claim with group context.

Paid

Marked paid by admin after successful on-chain transfer.

Blocked

Rejected by eligibility rules such as self-attribution checks.

5. Admin payout flow

  • Admin opens Telegram Group Rewards page and filters pending rewards.
  • Admin distributes 10,000 EPWX to owner wallet from connected admin wallet for each pending reward row.
  • Backend marks reward as paid with tx hash.
  • Reward ledger entry is written for audit trail.

6. Wallet compatibility notes

  • Telegram in-app browser can block some wallet flows.
  • Use external browser, Coinbase Wallet browser, or MetaMask browser when prompted.
  • Backend supports both normal signatures and smart-wallet signatures for wallet linking and daily claims.

7. Quick troubleshooting

  • If group title is missing in admin table, refresh after backend title backfill runs.
  • If signature fails, confirm connected wallet and linked wallet are the same.
  • If rewards do not appear, verify member claimed from group link and membership checks passed.