Unlock Guides

Back

How to do “POAPs” with Unlock

A POAP is a type of Non-Fungible Token (NFT) and is used as a mechanism to prove that the person holding the NFT attended a specific community event or participated in a community in some other way at a particular time and/or place.

Introduction

If you’re not yet familiar with NFTs, we suggest the following resources as a prerequisites to following this guide.

  • Unlock Tutorial: What is an NFT?
  • Have a crypto wallet. Need help? See this Unlock Tutorial: What is a crypto wallet?
  • Account with Piñata.cloud (paid Professional plan)
  • Unlock Tutorial: How to choose the blockchain that’s right for your project. (coming soon…)

If you’re not familiar with POAPs, we’ll explain them further in the next section of this guide.

In this guide, you’ll learn:

  1. What the letters in “POAP” (pronounced pō’-ap) stand for and what the term “POAP” means.
  2. How to create a POAP, customize its art, and distribute it to members of your community.
  3. How to instruct your community members to access their POAP.

 

At the end of this guide, you will have the knowledge and tools to create a new POAP NFT and airdrop it to your community members’ crypto wallets.

What is a POAP?

“POAP” stands for Proof of Attendance Protocol.

A POAP is a type of Non-Fungible Token (NFT) and is used as a mechanism to prove that the person holding the NFT attended a specific community event or participated in a community in some other way at a particular time and/or place.

All POAPs are NFTs, but not all NFTs are POAPs.

You may have heard of a web3 project called POAP.xyz — this is where most folks go to create and distribute POAPs for their communities. POAP.xyz is an awesome service; but that’s not exactly what we’re doing in this Guide…

In this Guide, we’re sharing a way to create NFTs that, for all intents and purposes, act and serve as POAPs; but because they are minted as ERC721 tokens and not from the POAP smart contract, they aren’t technically POAPs by definition.

If you’re ok with those technicalities, this Guide is for you! We’ve written it from the perspective of a community manager who want to reward members for their participation with a collectible piece of digital art that lives on the blockchain and can be accessed from a member’s crypto wallet.

If you’d prefer to the “real deal” POAP, you may want to ask POAP.xyz to create and distribute POAPs for you.

The primary advantage of doing “POAPs” yourself with Unlock is timeliness. POAPs are rising in popularity and in high demand from POAP.xyz, often resulting in long wait times between request and distribution. You could think of doing POAPs with Unlock is a truer to the ethos of decentralization while still achieving our goal: to celebrate and reward community members for their presence and participation.

To honor the distinction between POAPs and Unlock NFTs as POAPs, we’ll use “POAP-like” or “POAP” (in quotes) when referring to the assets we’re creating in this guide.

Now that we’ve covered the fine print, let’s jump into the fun stuff — creating!

How to create a POAP-like NFT with Unlock?

  1. Go to the Unlock Dashboard at https://app.unlock-protocol.com
    Or, if you’re on the Unlock website at https://unlock-protocol.com, click “Dashboard” in the upper right corner.
  2. Connect your wallet (the wallet you intend be the Lock manager)
    You’ll need to pay* transaction fees on the network where you’ll deploy your Lock, so make sure you have enough of the cryptocurrency associated with your chosen blockchain/network in your wallet.*If you’re in testing mode (before production), you can use the Rinkeby test network and use a Rinkeby faucet like this one to deposit “play money” into your wallet.
  3. Click the “Create a Lock” button on the Unlock Dashboard
    1. Configure your Lock
      Give it a name/title
      eg, Earth Day 2022 POAP
    2. Set your Key Duration
      in my example, we’ll use infinity, because the utility of this token will be unique to attending this event and is intended to last as long as the holder remains a member of the community
    3. Set the Key Quantity
      in my example, we had 20 people at the event, so I’m going to create 20 Keys
    4. Set the Price
      since we are going to airdrop this NFT/Key as a free POAP, we set the price to 0 MATIC
    5. Click “Submit” to save and create the Lock

When you’re done, you should see something like this:

How to customize the image of your "POAP"

If your artwork is under 1MB file size, you can simply upload it from you computer.

  1. In your Unlock Dashboard, click the default Unlock logo image to the left of your POAP. Note: before this step, ensure the lock has been fully created. You’ll know it’s been fully created when the Unlock Dashboard shows a version number next to the network name (e.g. “v10 Polygon”) — if it only says “v Polygon” without a version number, then lock creation is still in progress.
  2. From the pop-up window, select the image from your device (computer) to upload and replace the default image
  3. Click Save
  4. You’re done! When you return to your Dashboard, the new image should show up. If it doesn’t, try refreshing your browser window and/or giving it a minute.

 

If your artwork is larger than 1MB file size, you’ll need to host your image in the cloud. In this guide, we’ll use a cloud service called Piñata.

Create Piñata account and upload your file

  1. Go to Pinata.cloud and create a free account.
  2. Upload your custom art image to your Piñata account

Create IPFS gateway

Piñata’s Professional Plan is required to create a Gateway:

    1. Click “Gateway” in top nav bar in your Piñata account
    2. You’ll notice big words that say “Piñata Gateways are only available on the Professional Plan
    3. Click the “Upgrade Today!” button
    4. Complete the upgrade process
    5. Create a Gateway to IPFS : Follow these Docs from Pinata’s website on “How To Set Up A Dedicated IPFS Gateway”

Copy the link to your file

  1. In your Piñata account, click on “Files” in the top nav bar.
  2. Click “More” to the right of your the file you’re going to use for your NFT
  3. Click “Share” (see screenshot below)
  4. When your link appears in a modal window, click on the link to copy it to your clipboard. (see screenshot below)

How to customize your NFT image

  1.  Back in your Unlock Dashboard, click the Unlock logo image to the left of your POAP/NFT
  2. In the “Customize the NFT” modal window, paste the link that you copied from your file in Pinata in the field labeled “or, Enter a URL”
  3. Click “Save”

How to Distribute (airdrop) “POAPs” to your members’ crypto wallets

What does “airdrop” mean?

“Airdrop” refers to the act of sending (or “dropping”) an NFT into another person’s crypto wallet. Due to the nature of the blockchain, anyone can airdrop an NFT to any public address on a blockchain without the approval of the wallet owner (similar to how we can send an email to any email address; except there are no spam filters on the public blockchains).

As you can imagine, an airdrop of a special NFT offers a fun way to “surprise and delight” community members.

Now that we understand “airdrops”, let’s make one happen.

  1. In your Unlock Dashboard, click the “Members” icon (looks like two little people)
  2. When prompted by your crypto wallet to “Sign”, sign the transaction
  3. Click “Airdrop keys” (button)
  4. Paste the first recipient’s wallet address in the “Recipient” field
  5. Click “Add Recipient” button below
  6. You can grant the key by clicking the “Grant 1 Key” button below. Or, if you have additional recipients (which is typical for POAPs), you can enter additional addresses before granting all of them at once.

How to instruct your members to view their POAP via Unlock dashboard

  1. Go to the Unlock Dashboard on the web at https://app.unlock-protocol.com/
  2. Connect your wallet
  3. Select “Polygon” in the dropdown menu where you select your blockchain network (it will be set to “Ethereum” by default)
  4. Click the Key 🔑  icon at the top (it will say “Keychain” when you hover your mouse over it)
  5. Voilà, there’s your POAP! 🎉

View a POAP via OpenSea

 Option A:

  1. From your Unlock Dashboard, on the Member Keychain page, click on the OpenSea icon on your POAP (it reads “Open on OpenSea” when you hover your mouse over it).
  2. View your POAP! 👀

Option B:

  1. Go to OpenSea.io
  2. Connect your wallet
  3. Go to your OpenSea profile
  4. Go to the “Hidden” tab
  5. Find your POAP! 👀

How to Unhide your POAP on OpenSea

  1. Click “Unhide” from the pop-up menu options
  2. Click the “Unhide” button in the bottom right-hand corner
  3. Now you can go back to your “Collected” tab, and your POAP will show up there on your public OpenSea profile and NFT collection.
  4. From the “Hidden” tab, click on the three dots in the bottom left-hand corner of your POAP.

Continue Learning

When viewing your NFT / POAP on OpenSea, you’ll notice that some of the metadata is set to the default values (eg, the name of the NFT will read “Unlock Key”)

You can customize how your NFT / POAP shows up on OpenSea, too — it’s a slightly more technical process and involves writing and running code, but you can do it! And one of our awesome community members, Croissant.eth, wrote this tutorial to show you how…

Was this article helpful?
YesNo
  • Unlock Tutorial: What is an NFT?
  • Have a crypto wallet.What is a crypto wallet?
  • Account with Piñata.cloud (paid Professional plan)
  • Unlock Tutorial: How to choose the blockchain that’s right for your project. (coming soon…)

Table of Contents