Documentation

Everything to fully run and customize the Elytherion promo bot.

This documentation covers end-to-end setup, command usage, operational flow, and customization options pulled from the live bot implementation.

Discord slash commands Crypto TX verification Auto ticket + transcript flow Timed promo channel cleanup

Quick Start

Create the bot app in Discord Developer Portal and enable guild install.
Invite the bot with channel management, send messages, embed links, and slash command permissions.
Run `/set wallet` for payout chains, then `/set panel` to publish checkout UI.
Create plans with `/createplan`, then let buyers use `/buy` and `/submittxids`.

Server Setup Checklist

Set payout wallets per chain with `/set wallet` for each seller account.
Set purchase log destination with `/set purchaselogs`.
Set ticket category with `/set ticketcategory` (optional but recommended).
Create the purchase panel with `/set panel`.
Create one or more plans using `/createplan`.
Verify everything by using `/plans` and then creating a test order with `/buy`.

Owner-only controls

`/set fee`, `/set rate`, and `/set feewallet` are restricted to the configured bot owner id.

Buyer Flow

Buyer opens panel and clicks Open Purchase Ticket or runs `/buy` directly.
Buyer chooses a plan id and chain via `/buy planid: chain:`.
Bot shows a modal asking for project name, link, pitch, ping text, and extra details.
Bot computes owner amount + fee amount, then returns payment instructions.
Buyer submits payment hashes with `/submittxids`.
Bot verifies transfers on-chain and advances status to paid/live.
If auto-channel is enabled, bot posts promo and schedules cleanup by plan days.

Command Reference

Command	Purpose	Who Uses It
`/set wallet chain address`	Save payout wallet for a chain.	Seller / server owner
`/mywallets`	View your saved chain wallets.	Any user
`/createplan title details priceusd days makechannel category?`	Create a purchasable promo plan.	Owner or manager
`/plans`	List active server plans.	Any user in server
`/myplans`	List plans you manage for current server.	Owner or manager
`/set purchaselogs channel?`	Set or clear purchase log channel.	Owner or manager
`/set ticketcategory category?`	Set or clear ticket category.	Owner or manager
`/set panel channel`	Post purchase panel with action buttons.	Owner or manager
`/buy planid chain`	Start guided promo order modal.	Buyer
`/submittxids orderid buyertxid feetxid?`	Submit payment hashes for verification.	Buyer (or bot owner)
`/myorders`	Show buyer's orders and statuses.	Buyer
`/sales`	Show orders for server owner in current guild.	Owner or manager
`/fulfill orderid`	Mark paid/live order as fulfilled.	Server owner or bot owner
`/closeticket`	Close ticket and write transcript file.	Server owner or bot owner
`/set fee percent`	Set platform fee percent.	Bot owner only
`/set rate chain usdpercoin`	Set USD conversion rate per chain.	Bot owner only
`/set feewallet chain address`	Set fee wallet destination per chain.	Bot owner only
`/settings`	Show fee percent + chain rates + fee wallets.	Any user

Share Kit (Send Anywhere)

Use these templates to promote Elytherion across Discord, Telegram, X/Twitter, and other channels.

Discord (Webhook Embed JSON)

{
  "content": "Elytherion is live.",
  "embeds": [
    {
      "title": "Elytherion | Discord Promo Automation",
      "description": "Sell promo slots with a cleaner flow: guided tickets, crypto TXID verification, auto logs, and timed promo cleanup.",
      "color": 9561343,
      "fields": [
        { "name": "Chains", "value": "BTC, LTC, ETH, SOL", "inline": true },
        { "name": "Flow", "value": "Plan → Form → Pay → Verify → Live", "inline": true },
        { "name": "Contact", "value": "https://t.me/Elytherion", "inline": false }
      ]
    }
  ]
}

Telegram

Paid promo automation for Discord servers.

Elytherion handles:
- Guided purchase tickets
- Crypto TXID verification (BTC/LTC/ETH/SOL)
- Purchase logs + transcripts
- Timed promo channel cleanup

Docs: https://elytherion.xyz/docs.html
Discord: https://discord.gg/nwQwBzZpvP
Contact: https://t.me/Elytherion

X / Twitter

Elytherion helps Discord communities automate paid promos.

Plan -> guided form -> crypto payment verification -> promo live -> auto cleanup.

BTC/LTC/ETH/SOL supported.
Docs: https://elytherion.xyz/docs.html
Discord: https://discord.gg/nwQwBzZpvP
Contact: https://t.me/Elytherion

Short Universal Blurb

Elytherion is a Discord promo automation bot that handles guided buying, crypto TX verification, purchase logs, tickets, and timed cleanup in one clean flow.

Customization Guide

Use this order whenever you are onboarding a new server:

/set wallet chain:Bitcoin address:bc1...
/set wallet chain:Ethereum address:0x...
/set purchaselogs channel:#purchase-logs
/set ticketcategory category:Purchase Tickets
/set panel channel:#buy-promo

/createplan \
  title:"24 Hour Slot" \
  details:"One post, pinned for 24h" \
  priceusd:"35" \
  days:1 \
  makechannel:false

/createplan \
  title:"3 Day Auto Channel" \
  details:"Dedicated promo channel, auto cleanup" \
  priceusd:"120" \
  days:3 \
  makechannel:true \
  category:Promotions

Embed theme color

Embeds are now standardized to your site accent color for consistent branding across logs, ticket messages, and order cards.

Order Status Lifecycle

awaiting payment: owner payment txid missing or not valid.
awaiting fee txid: owner payment valid, fee txid missing.
checking txids: txids submitted, verification running.
paid: payment checks passed.
live: promo channel/post created and active.
fulfilled: seller manually marked complete.
expired: auto-channel reached expiry and was cleaned up.

Troubleshooting

No commands visible: verify bot has applications.commands scope and command sync completed.
Order fails on buy: server owner likely missing a chain wallet via `/set wallet`.
Tx check fails: verify correct chain and full tx hash; Solana requires valid Solscan API key.
No logs: ensure `/set purchaselogs` points to a text channel the bot can post in.
Ticket did not create: check category permissions and bot manage channels permission.