🏆Buy Competition

This is an early iteration. Bugs and unexpected behavior may occur.

🛒 BUY COMPETITION (Telegram Group Chats) — MVP

Admins can now launch Buy Events tied to a specific ERC-20 token. These events allow users to compete by purchasing tokens and climbing a leaderboard.

VIVI only tracks purchases made via VIVI in the group chat during the competition. Selling is disabled within the chat. Participants may sell externally and are not required to hold to win.

Rationale: This setup encourages transaction volume. Allowing external sells helps prevent a post-competition dump, while enabling strategic selling for point farming keeps the game competitive and fair.

---

🧙 Buy Event Wizard — /createbuyevent

Group admins can start an interactive flow to launch a Buy Event:

• Set the event name

• Upload a banner (1280x360 required)

• Input and validate the token address

• Preview event summary before launch

• Confirm via inline interaction

---

📊 Leaderboard System — /leaderboard, /myeventstat

• Displays Top 10 buyers by ETH spent and buy count

• Highlights:

  • 🥇 Biggest Buy

  • 🔁 Most Buys

• Supports custom leaderboard banners for enhanced visual context

---

👥 User Commands Summary

Command	Access	Description
/createbuyevent	Group Admin	Starts the wizard to launch a new buy event
/closebuyevent	Group Admin	Manually closes an active buy event
/leaderboard	All Users	Shows the current or most recent leaderboard
/myeventstat	All Users	Displays user’s rank, ETH spent, and buy count

---

BOBR Comp Example