Store the agent's TON wallet identity (from @ton/mcp) for this session so buy tools can target it. Call this once before buying.

Set a referral link/short-name/wallet (e.g. 'hoton.tg/jeribond') so subsequent purchases credit that referrer 35% of the fee. Only set this if the user named a referrer. The house link (hoton.tg/hoton) or none means no commission.

Look up a Telegram @username before buying, to confirm the right person (returns display name + photo). For premium, pass months. Optional — buy tools also resolve usernames themselves.

Build an order to send Stars to one Telegram user. Returns messages[] to sign with @ton/mcp. Extract a referrer from the user's prompt if they named one.

Build ONE order sending the same star amount to 1–10 Telegram users. Returns messages[] (one per recipient) to sign with @ton/mcp in a single transaction.

Build an order to gift Telegram Premium (3, 6 or 12 months) to one user. Returns messages[] to sign with @ton/mcp.

Build ONE order gifting the same Premium duration to 1–10 users. Returns messages[] (one per recipient) to sign with @ton/mcp.

Build an order to top up one Telegram account with GRAM (the native chain coin). Returns messages[] to sign with @ton/mcp. GRAM only.

Build ONE order topping up 1–10 Telegram accounts with the same GRAM (native chain coin) amount each. Returns messages[] to sign with @ton/mcp. GRAM only.

Call after @ton/mcp send_raw_transaction signs the order. I poll the TON chain for the settled transaction, return whether it's delivered + a tonviewer link, and record it in Hoton's history + referral. Pass expectedAmount from the buy result so I can pinpoint the exact transaction. The purchase settles on-chain when signed, so a failure here never means you should re-buy — just retry confirm.

Returns whether Hoton/Fragment is healthy right now. Call before buying if unsure; if unhealthy, tell the user to try later instead of buying.