Sharing & History

A PvP session is a single live message. The list behind it — the 2-5 tokens you fought with — is a saved object you can run again, share with someone else, or delete. This page covers both halves: how shared deep links work, and how to find the lists you’ve already created.

The share button

Every active or stopped PvP session has a Share button under the leaderboard. Tap it and the bot DMs you a copyable link:

Share this link to let others clone the list:
https://t.me/PrysmBot?start=pvp_A7K2QMX9

The link is plain text inside a <code> block — copy it and paste wherever you want (a group chat, DM, Discord). Anyone who taps the link is sent into a DM with the bot.

The 8-character token at the end (A7K2QMX9 above) is randomly generated the first time you tap Share and stored on the list. Subsequent taps return the same token — the link is stable for the life of the list.

Note

The share token is attached to the list, not to the session that generated it. Spawn the same list five times, tap Share on any of them, and the link is the same.

What recipients see

When somebody opens a t.me/<bot>?start=pvp_<token> link, the bot’s /start handler routes it to a preview message:

⚔️ Top 5 Memes
4 tokens
Shared by @alice

[🚀 Spawn Live]  [💾 Save]

Two buttons:

• 🚀 Spawn Live — starts a new live session in the current chat using the shared list, exactly as if /pvp had been run on it. The 15-minute timer starts fresh; the original session keeps running independently.
• 💾 Save — clones the list into the recipient’s own saved lists (as Top 5 Memes (copy) if the name is taken). They can spawn it later via /pvp, edit it, or share their own copy.

If the recipient is the original owner — same user in DM, or same group — the bot replies This is your own list. Use /pvp to spawn it. instead of showing the preview, because cloning into yourself is a no-op.

If the list has been deleted (see below), the preview replies This shared PvP list is no longer available.

Tip

The recipient doesn’t need an existing relationship with the list. The share token is the only credential — anyone with the link can spawn or save.

Where saved lists live

Run /pvp with no arguments and the bot replies with help text plus a button per saved list:

PvP — Live Token Battle

Create a live leaderboard that pits 2-5 tokens against
each other and updates every minute.

Usage:
/pvp <name> <ca1>,<ca2>,...      — create a list and start a session
/pvp delete <name>               — delete a saved list
/pvp rename <old> <new>          — rename a saved list
/pvp stop <name>                 — stop the active session for a list

Your lists: tap to start

[Top 5 Memes]
[ETH Bluechips]
[Solana Plays]

In a group, the header reads This group's lists instead of Your lists. Lists are scoped to the chat they were created in — your DM lists never appear in a group, and a group’s lists never appear in your DM.

Tapping any list button calls pvpService.spawnSession and a fresh live leaderboard appears in the same chat. The list itself is unchanged — same name, same tokens, same starting market caps from when you first built it.

Caution

There’s no past-sessions browser. Once a session ends, its leaderboard message stays in the chat scrollback as a final snapshot, but the bot won’t re-render it or list it anywhere. The list is what persists; the session is just one run on it.

What ends a session

Three things end a live session:

Trigger	Status	What happens to the message
15-min timer hits zero (or 30-min hard cap)	EXPIRED	Final tick rendered, footer becomes ✓ Session ended, buttons swap to Start and Share
Creator taps Stop	STOPPED	Footer becomes ⏸ Paused, buttons swap to Start and Share
Underlying list is deleted	STOPPED	Same as manual stop

In every case the leaderboard message stays in the chat as the final snapshot. Tapping Start on a stopped or expired session restarts it — same list, fresh 15-minute window.

The creator can extend a running session with Extend +15m, up to the 30-minute hard cap. After that the Extend button disappears and the session can only end naturally or via Stop.

Note

Group-owned lists let any group member control the session (Stop, Extend, Start). Personal lists spawned in a group stay creator-only — only you can stop or extend a session you started.

Deleting a list

/pvp delete <name> removes a list from /pvp’s menu:

/pvp delete Top 5 Memes

Deleted PvP list 'Top 5 Memes'.

Two things happen:

1. The list is soft-deleted — it disappears from /pvp and from any future share-link preview, but the underlying row is kept.
2. Any active session on that list is stopped immediately. The leaderboard message in the chat is left untouched as a final snapshot.

Because deletes are soft, the share token is retained on the row — but a recipient who taps the link gets This shared PvP list is no longer available. and cannot spawn or save it. Effectively, deleting a list invalidates every share link that pointed at it.

There is no undelete from the bot side. To revive a deleted list, recreate it with /pvp <name> <addresses>.

Renaming and replacing

/pvp rename <old> <new> changes a list’s display name without affecting its share token, items, or active session. The new name shows up in /pvp, in the leaderboard title, and in the share preview.

Names are unique per owner — you can’t have two lists called Top 5 Memes in the same DM, and a group can’t have two lists with the same name either. The name uniqueness is enforced against non-deleted lists only, so deleting a list frees its name for reuse.

Quick reference

1. Make a session shareable — tap Share on any PvP message. The bot DMs you the t.me/<bot>?start=pvp_<token> link to copy.

2. Open someone else’s link — tap the link, get the preview, then 🚀 Spawn Live for a one-off run or 💾 Save to keep your own copy.

3. Find your saved lists — /pvp with no arguments. Tap a list button to start a fresh session on it.

4. Stop, extend, or restart — use the buttons on the live message. Stop and the message becomes a paused snapshot you can restart anytime.

5. Clean up — /pvp delete <name> removes a list from your menu and invalidates its share link.

Where to next

Create a Session Build a list from contract addresses and spawn a live battle.

PvP Mode Overview What a live token battle is and how the leaderboard ranks tokens.

Deep Links Every t.me?start=… payload Prysm understands, including pvp_.