Distribute POAPs

Step by step guide on distributing POAPs

Overview

DEGEN has several options on distributing POAPs to many people. Some of these options are carried over from the legacy versions of DEGEN. They provide an ever expanding feature set of methods for users to get their respective POAPs.

Previously, DEGEN returned a csv file containing a collection of Discord User IDs of all of the participants in an event. Discord Developer Policy dictates that applications must not expose PII as this can be considered sensitive to users. DEGEN 3.0 and onwards does not return any IDs from any users. If you are looking to collect participant information, please see previous versions of DEGEN on github.

Distribution should occur after the event has ended.

The methods DEGEN can deliver POAPs include:

• All users on a Discord Server

• Past events from the organizer

• By specific roles

• By ID

links.txt

A links.txt file is required as part of the distribution of POAPs among users. This file consists of claimable URLs in the format of

http://poap.xyz/*

http://poap.xyz/123
http://poap.xyz/321
http://poap.xyz/231

This file can be obtained using the Mint Command on DEGEN or by visiting the POAP Back Office. After submitting the required details to mint, the links.txt file will get emailed to you in about 24 or so hours. The time to receive the links.txt file depends on many factors.

Please make sure to mint POAPs at least 48 hours before the event.

Announcement Channel

This is completely optional and only available to Community Servers

After distribution is complete, a distribution message gets posted publicly. This helps users of a discord server community see when POAPs are ready to be claimed.

Distribution Announcement Message

Command

/poap distribute

You must hold the "Authorized degens" role to execute this command.

Parameter	Required	Type	Example	Notes
event		Text	Cool Event 2022	The name of the event that participants will see.
type		Option	Past Events	Selecting from the list of options will specify which distribution flow to proceed.
platform		Option	Discord	Default: Discord The platform on where participants should claim their POAPs.

Distribution Types

The type parameter defines which distribution flow to conduct. The number of types is likely to change and increase in the future.

All Users

Not yet available.

This distribution will assign POAPs to everyone on a discord server. This is a great way to award all of the users on a discord community with a special one-time POAP.

Distribute to Members in a Community

Past Events

Up to a maximum of 1 from the last 3 past events can be selected. This distribution allows organizers to redistribute POAPs for an event that has ended. This is especially important if the links.txt file is not yet ready before the event has started. A typically flow might be, start event tracking, hold the event, end event tracking, followed by running POAP distribute command to distribute when the links.txt file arrives.

By Roles

Not yet available.

This distribution allows POAPs to be assigned to certain discord users who hold the given roles. DEGEN should prompt the organizer with a message asking them for which roles to distribute. Simply send a message with all of the roles including the @ symbol and DEGEN will parse the message.

Distribute to Specific Roles

By ID

This distribution requires a participants.csv file. In previous versions of DEGEN a .csv file with all of the attendees along with their ID, tag, and duration was returned after an event had ended. On DEGEN 3.0 and onwards, this file will not be returned. We take user information seriously and will take all efforts possible to protect this data.

The participants.csv file is structured as

discordUserId,durationInMinutes,discordUserTag
159014522542096384,11.23,Slinkypotato#1092

where user discordUserTag is optional.

More details coming soon...