
![treasure hunt](/images/blog/treasure-hunt-share.png)

Are you ready to join our brave hero, Spork, on their mission to collect all the prizes at ETHDenver? Spork needs your help to accomplish their quest, and your reward will be a plethora of treasures waiting at each of the five stops on the Treasure Hunt!

You'll help Spork traverse through the five different locations, each of which has its own unique challenge to overcome before being able to collect the prizes. This is no easy feat, but the rewards are worth it!

Along the way, Spork will meet new frens that will join them on their journey. These frens will provide guidance and support, sharing their knowledge and expertise so that Spork can complete the quests and claim their rewards. Are you up for the challenge? Ready to embark on this epic adventure? Join Spork today and become part of the ETHDenver Treasure Hunt!

**How to play**

- To start the Treasure Hunt, head to [https://ethdenver.unlock-protocol.com](https://ethdenver.unlock-protocol.com) and connect your wallet
- You’ll help Spork move through five quests
- At each quest, you’ll need a different secret password
- You’ll be able to find the passwords from various Discord servers or physical locations
- Once you have the password for that quest on the Treasure Hunt, you’ll use it to claim a free NFT on Polygon (there are five NFTs in all)
- After collecting all five NFTs, you’ll receive a prize at ETHDenver

Please don’t delay — Spork is counting on you!

[Start the Treasure Hunt](https://ethdenver.unlock-protocol.com)


Are you ready to join our brave hero, Spork, on their mission to collect all the prizes at ETHDenver?

Join Spork's ETHDenver Treasure Hunt with Unlock!

<img src="/images/blog/treasure-hunt-share.png" alt="treasure hunt">
Are you ready to join our brave hero, Spork, on their mission to collect all the prizes at ETHDenver? Spork needs your help to accomplish their quest, and your reward will be a plethora of treasures waiting at each of the five stops on the Treasure Hunt!
You'll help Spork traverse through the five different locations, each of which has its own unique challenge to overcome before being able to collect the prizes. This is no easy feat, but the rewards are worth it!
Along the way, Spork will meet new frens that will join them on their journey. These frens will provide guidance and support, sharing their knowledge and expertise so that Spork can complete the quests and claim their rewards. Are you up for the challenge? Ready to embark on this epic adventure? Join Spork today and become part of the ETHDenver Treasure Hunt!
How to play
<ul>
<li>To start the Treasure Hunt, head to <a href="https://ethdenver.unlock-protocol.com">https://ethdenver.unlock-protocol.com</a> and connect your wallet</li>
<li>You’ll help Spork move through five quests</li>
<li>At each quest, you’ll need a different secret password</li>
<li>You’ll be able to find the passwords from various Discord servers or physical locations</li>
<li>Once you have the password for that quest on the Treasure Hunt, you’ll use it to claim a free NFT on Polygon (there are five NFTs in all)</li>
<li>After collecting all five NFTs, you’ll receive a prize at ETHDenver</li>
</ul>
Please don’t delay — Spork is counting on you!
<a href="https://ethdenver.unlock-protocol.com">Start the Treasure Hunt</a>


Events and projects around the world have created their ticketing and membership infrastructure using Unlock Protocol.

Now, for events that want to get up and running rapidly, the Unlock Labs team has created a quickstart tool: **Events by Unlock**.

Events by Unlock is a free and easy way to create tickets and share an event details page for 10-10000+ person events. Setting up an event takes less than a minute, and it works for both free and paid events.

![events-share.png](/images/blog/events-by-unlock/events-share.png)

Using Unlock Protocol, event organizers have always been able to [create tickets for their events](https://unlock-protocol.com/guides/how-to-sell-nft-tickets-for-an-event/). After setting up ticketing, however, the next step is having a place where attendees can get their tickets! This new tool can help.

Events by Unlock was built by the Unlock Labs team using Unlock Protocol, and lets you set up your event on-chain in minutes. Fill in a few fields and deploy a smart contract for your event tickets with no code.

![event-configure.png](/images/blog/events-by-unlock/event-configure.png)

Then, once your contract is deployed, you can share your event landing page with the world!

![event-landing.png](/images/blog/events-by-unlock/event-landing.png)

You can check out **Events by Unlock** at [https://events.unlock-protocol.com](https://events.unlock-protocol.com)


Events by Unlock is a free and easy way to create tickets and share an event details page for 10-10000+ person events. Setting up an event takes less than a minute, and it works for both free and paid events.

Unlock Protocol Cordially Invites You to Events by Unlock

Events and projects around the world have created their ticketing and membership infrastructure using Unlock Protocol.
Now, for events that want to get up and running rapidly, the Unlock Labs team has created a quickstart tool: Events by Unlock.
Events by Unlock is a free and easy way to create tickets and share an event details page for 10-10000+ person events. Setting up an event takes less than a minute, and it works for both free and paid events.
<img src="/images/blog/events-by-unlock/events-share.png" alt="events-share.png">
Using Unlock Protocol, event organizers have always been able to <a href="https://unlock-protocol.com/guides/how-to-sell-nft-tickets-for-an-event/">create tickets for their events</a>. After setting up ticketing, however, the next step is having a place where attendees can get their tickets! This new tool can help.
Events by Unlock was built by the Unlock Labs team using Unlock Protocol, and lets you set up your event on-chain in minutes. Fill in a few fields and deploy a smart contract for your event tickets with no code.
<img src="/images/blog/events-by-unlock/event-configure.png" alt="event-configure.png">
Then, once your contract is deployed, you can share your event landing page with the world!
<img src="/images/blog/events-by-unlock/event-landing.png" alt="event-landing.png">
You can check out Events by Unlock at <a href="https://events.unlock-protocol.com">https://events.unlock-protocol.com</a>


You can now generate, view, and print receipts for every transaction that uses Unlock Protocol! We’ve had a large number of requests for this feature, which helps ease account and reporting, especially for cases where an individual is purchasing a ticket, membership, or subscription as part of their business duties and needs to file an expense report.

Both sellers (aka “suppliers”) and purchasers (”buyers”) can edit their details to get all their details onto their receipts. Here are the details.

## For Suppliers

Suppliers can find the section to update their details inside the `Payments` section on the settings page of the Unlock Dashboard.

The editable details are the following:

- Supplier Name
- VAT
- Address details
- Service performed

![Receipt details](/images/blog/transaction-receipts/receipt-section.png)

Only the supplier (Lock Manager) can update these details. Otherwise, the form will be disabled. These details will be part of the receipts for any purchase made on the same

## For Purchaser

Purchasers can access the receipt details from the `Keychain` page. A new `Show receipts` option is on the actions list, which redirects to the receipt details page.

![For purchaser](/images/blog/transaction-receipts/for-purchaser.png)

## Receipts detail page

Only the buyer or the seller can see the receipt details page. Others will see an error.

![Not allowed](/images/blog/transaction-receipts/add-purchaser-details.png)

This page will show all the details about the receipts. When the purchaser views page, they can click the `Add details` button to include additional information about the purchase.

![Receipt details overview](/images/blog/transaction-receipts/receipt-details-1.png)

**Add purchaser details**

The purchaser can update the following details:

- Full name
- Business name
- Address, City, State, Zip, Country
- Service performed

![Add receipt details](/images/blog/transaction-receipts/add-purchaser-details.png)

That's all there is! The receipts with all the details are ready to print! Just click on `Print PDF` to get your receipt will all the details!

![Receipt details overview](/images/blog/transaction-receipts/receipt-details-2.png)

We are committed to continuing to add easier and friendlier ways to deploy and manage every single part of your membership. If you have any suggestions, please tell us in Discord!

**What if I find an issue or bug?**

Please open an issue on Github or tell us in Discord and we'll fix it ASAP.


View and print receipts to ease record-keeping and accounting.

Unlock Unveils NFT Transaction Receipts

You can now generate, view, and print receipts for every transaction that uses Unlock Protocol! We’ve had a large number of requests for this feature, which helps ease account and reporting, especially for cases where an individual is purchasing a ticket, membership, or subscription as part of their business duties and needs to file an expense report.
Both sellers (aka “suppliers”) and purchasers (”buyers”) can edit their details to get all their details onto their receipts. Here are the details.
<h2>For Suppliers</h2>
Suppliers can find the section to update their details inside the <code>Payments</code> section on the settings page of the Unlock Dashboard.
The editable details are the following:
<ul>
<li>Supplier Name</li>
<li>VAT</li>
<li>Address details</li>
<li>Service performed</li>
</ul>
<img src="/images/blog/transaction-receipts/receipt-section.png" alt="Receipt details">
Only the supplier (Lock Manager) can update these details. Otherwise, the form will be disabled. These details will be part of the receipts for any purchase made on the same
<h2>For Purchaser</h2>
Purchasers can access the receipt details from the <code>Keychain</code> page. A new <code>Show receipts</code> option is on the actions list, which redirects to the receipt details page.
<img src="/images/blog/transaction-receipts/for-purchaser.png" alt="For purchaser">
<h2>Receipts detail page</h2>
Only the buyer or the seller can see the receipt details page. Others will see an error.
<img src="/images/blog/transaction-receipts/add-purchaser-details.png" alt="Not allowed">
This page will show all the details about the receipts. When the purchaser views page, they can click the <code>Add details</code> button to include additional information about the purchase.
<img src="/images/blog/transaction-receipts/receipt-details-1.png" alt="Receipt details overview">
Add purchaser details
The purchaser can update the following details:
<ul>
<li>Full name</li>
<li>Business name</li>
<li>Address, City, State, Zip, Country</li>
<li>Service performed</li>
</ul>
<img src="/images/blog/transaction-receipts/add-purchaser-details.png" alt="Add receipt details">
That's all there is! The receipts with all the details are ready to print! Just click on <code>Print PDF</code> to get your receipt will all the details!
<img src="/images/blog/transaction-receipts/receipt-details-2.png" alt="Receipt details overview">
We are committed to continuing to add easier and friendlier ways to deploy and manage every single part of your membership. If you have any suggestions, please tell us in Discord!
What if I find an issue or bug?
Please open an issue on Github or tell us in Discord and we'll fix it ASAP.


It's true! Unlock Protocol had over **200,000** membership NFTs claimed during December from our Advent calendar activation.

The key bits:

🚀 Over 200k NFTs claimed

🔶 Over 12k wallets

💜 Deployed on Polygon

🎲 Gamified experience

🚫 Gas-free mint ⛽️

Check out the details...more experiences like this coming soon...

![Advent infographic](/images/blog/advent-infographic/advent-infographic-v2a.png)

[PNG](/images/blog/advent-infographic/advent-infographic-v2a.png) [PDF](https://19942922.fs1.hubspotusercontent-na1.net/hubfs/19942922/Advent%20Infographic%20v2.pdf)


The details on why over 200,000 membership NFTs were claimed during December from Unlock's Advent calendar activation.

200,000 NFTs Claimed in Unlock Protocol's Holiday Campaign

It's true! Unlock Protocol had over 200,000 membership NFTs claimed during December from our Advent calendar activation.
The key bits:
🚀 Over 200k NFTs claimed
🔶 Over 12k wallets
💜 Deployed on Polygon
🎲 Gamified experience
🚫 Gas-free mint ⛽️
Check out the details...more experiences like this coming soon...
<img src="/images/blog/advent-infographic/advent-infographic-v2a.png" alt="Advent infographic">
<a href="/images/blog/advent-infographic/advent-infographic-v2a.png">PNG</a> <a href="https://19942922.fs1.hubspotusercontent-na1.net/hubfs/19942922/Advent%20Infographic%20v2.pdf">PDF</a>


We're excited to announce support for email recipients on airdrops and checkout! With this new feature, you no longer need a wallet address to airdrop or buy NFTs for someone else. Instead, you can _just use their email address_ to airdrop or send them an NFT. (If they want, they can transfer the NFT to their own wallet later while still being able to verify their ownership of the NFT using the QR code attached to email.)

To use email address as the recipient, you need to turn on "no wallet address?" option.
![Airdrops](/images/blog/email-recipient/airdrop.gif)

With this new feature, we aim to make the process of sending airdrops and buying NFTs more accessible to everyone, regardless of their experience or knowledge of cryptocurrency.

![Checkout](/images/blog/email-recipient/checkout.png)

### How does it work?

We are excited to introduce our new `KeyManager` contract, a game-changing contract that powers our email recipient approach in airdrops and checkout.

When a users enters a recipient’s email, we create a unique wallet address without a private key from it and drop the NFT to it while setting the manager of NFT to the KeyManager contract address. This gives the `KeyManager` contract rights to transfer the NFT on request.

A signed proof, in the form of a QR code, is generated and sent to the recipient's email. Recipients can verify their ownership of the NFT at events using this QR code, without transferring the NFT to their own wallet. Additionally, they can also transfer the NFT to their own wallet at any time by following the instructions and link to the transfer page in the email.

Recipients need to go to the transfer page and request a transfer code to their email. After entering the transfer code, they can transfer the NFT to their wallet. Transferring the NFT also transfers any associated data to the new owner.

![Transfer Page](/images/blog/email-recipient/transfer.png)

This new feature not only makes it easier for individuals who may not have been able to participate in airdrops before due to a lack of a wallet or technical know-how, but it also makes it easier for crypto-native users to quickly onboard their friends and family by buying a NFT to them.

At Unlock Protocol, we believe that this feature will greatly enhance the reach and accessibility of airdrops and we look forward to seeing the impact it has on the industry.


We're excited to announce support for email recipients on airdrops and checkout

Unlock Launches Support For Email Recipients on Airdrops and Checkout

Wallet-less airdrops!

We're excited to announce support for email recipients on airdrops and checkout! With this new feature, you no longer need a wallet address to airdrop or buy NFTs for someone else. Instead, you can just use their email address to airdrop or send them an NFT. (If they want, they can transfer the NFT to their own wallet later while still being able to verify their ownership of the NFT using the QR code attached to email.)
To use email address as the recipient, you need to turn on "no wallet address?" option.
<img src="/images/blog/email-recipient/airdrop.gif" alt="Airdrops">
With this new feature, we aim to make the process of sending airdrops and buying NFTs more accessible to everyone, regardless of their experience or knowledge of cryptocurrency.
<img src="/images/blog/email-recipient/checkout.png" alt="Checkout">
<h3>How does it work?</h3>
We are excited to introduce our new <code>KeyManager</code> contract, a game-changing contract that powers our email recipient approach in airdrops and checkout.
When a users enters a recipient’s email, we create a unique wallet address without a private key from it and drop the NFT to it while setting the manager of NFT to the KeyManager contract address. This gives the <code>KeyManager</code> contract rights to transfer the NFT on request.
A signed proof, in the form of a QR code, is generated and sent to the recipient's email. Recipients can verify their ownership of the NFT at events using this QR code, without transferring the NFT to their own wallet. Additionally, they can also transfer the NFT to their own wallet at any time by following the instructions and link to the transfer page in the email.
Recipients need to go to the transfer page and request a transfer code to their email. After entering the transfer code, they can transfer the NFT to their wallet. Transferring the NFT also transfers any associated data to the new owner.
<img src="/images/blog/email-recipient/transfer.png" alt="Transfer Page">
This new feature not only makes it easier for individuals who may not have been able to participate in airdrops before due to a lack of a wallet or technical know-how, but it also makes it easier for crypto-native users to quickly onboard their friends and family by buying a NFT to them.
At Unlock Protocol, we believe that this feature will greatly enhance the reach and accessibility of airdrops and we look forward to seeing the impact it has on the industry.


🐰 Happy Year of the Rabbit! You can now [open your Hongbao](https://red-packet.unlock-protocol.com/)!

Last week, we [launched a really fun experiment](https://unlock-protocol.com/blog/redpacket-rabbit) inspired by the traditional Chinese gift-giving practice to show appreciation or gratitude.

Today, I want to tell you more about how we built it! The code is [full open-source](https://github.com/unlock-protocol/red-packet-2023) and ready for you to inspect if you want to build similar experiments!

## Front-end

For the front-end, we used Next.js, which, as you probably know is a React-based application framework. We also use Tailwind for the CSS, as well as few common libraries. This is all written in Typescript.

We also used some custom hooks:

- [`useAuth`](https://github.com/unlock-protocol/red-packet-2023/blob/main/hooks/useAuth.tsx) which connects to Unlock's [Sign-In with Ethereum](https://docs.unlock-protocol.com/tools/sign-in-with-ethereum/) endpoint. We used it to identify the users.
- [`useLock`](https://github.com/unlock-protocol/red-packet-2023/blob/main/hooks/useLock.tsx) which queries the RPC endpoint to check if an address owns a valid NFT from the Hongbao contract. We used it to check if a given user already owns an NFT.
- [`useMetadata`](https://github.com/unlock-protocol/red-packet-2023/blob/main/hooks/useMetadata.tsx) which queries the RPC endpoint to retrive the `tokenURI` of a given token. Since the metadata is in fact generated on-chain (more below), this yields it in the form of base64 encoded JSON.

Finally, we also added an API function. When thinking about this experiment, we wanted people to be able to send red packets to _anyone_, even if that person did not previously use the Polygon chain, so that means we needed a mechanism to "claim" the potential prizes in a gasless way because these recipients would otherwise need MATIC tokens to pay for the gas to claim from the red pockets.

```javascript
export default async function handler(
  req: NextApiRequest,
  res: NextApiResponse
) {
  if (!process.env.PRIVATE_KEY) {
    return res.status(500).json('Missing private key')
  }
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.unlock-protocol.com/137'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY).connect(provider)
  const gasPrice: any = await provider.getGasPrice()
  const hook = new ethers.Contract(
    '0xc328ae7fc36f975be120aaa99f2d96c3e732e5b6', // Address of the RedPacket contract
    ABI, // ABI for the RedPacket contract
    signer
  )
  const { tokenId } = JSON.parse(req.body)
  const tx = await hook.claimPrize(tokenId, { gasPrice }) // call to claim the reward
  res.status(200).json({ hash: tx.hash })
}
```

We'll come back to it, but the function to withdraw can actually be called by anyone as it just sends the money in the envelope to its owner, so we just added a basic API call which can [call the claim function](https://github.com/unlock-protocol/red-packet-2023/blob/main/pages/api/claim.tsx) with a token id. We cover the gas for these calls.

## Smart Contracts

This part is really where the use of the Unlock Protocol shines. First of all, the NFT contract is obviously our `PublicLock`. You can inspect it [using a block explorer](https://polygonscan.com/address/0x01703c979220de3e7662ab90a696843225d31383). We set the price of its NFT to be 1 MATIC. However, we use another contract that we called `RedPacket.sol`. This contract [has also been verified](https://polygonscan.com/address/0xc328ae7fc36f975be120aaa99f2d96c3e732e5b6) and is used as hooks for 2 different functions inside of the PublicLock contract: `onKeyPurchaseHook` and `onTokenUriHook`. The first one is called when new NFTs are being purchased, and the latter when someone tries to retrieve the metadata for a given token.

The `RedPacket.sol` was initialized with a timestamp for the "reveal time", which was set to be midnight on January 22nd in Beijing, China. The purchase hook will prevent any new token from being minted _after_ the reveal.

Additionaly, on every purchase, the hook computes a "random" number. We know that pure randomless is really hard to compute on-chain. Here, we are computing a hash of the block's timestamp, token id and owner combined. This is sufficiently unguessable and hard to manipulate by miners. This random number is stored in the hook (to be used later), as well as used to "shuffle" an array of token by index, by inserting the newly minted token at a random location (this is a variation of the [Fisher-Yates shuffle](https://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle)).

```javascript
function onKeyPurchase(
  uint256 tokenId, /* tokenId */
  address from, /* from */
  address, /* recipient */
  address, /* referrer */
  bytes calldata, /* data */
  uint256, /* minKeyPrice */
  uint256 /* pricePaid */
) external {
  if (block.timestamp > revealTime) {
    revert TOO_LATE();
  }
  if (msg.sender != lock) {
    revert NOT_AUTHORIZED();
  }
  // We compute an offset for the final tally
  offset = uint256(keccak256(abi.encodePacked(block.timestamp + tokenId, from))) % 8888888; // Sets the offset!
  // We "randomize" an array that can help us compute winners!
  uint randomIndex = offset % tokenId; // Selects a random index
  if(ranks[randomIndex] > 0) {
    // If we already have a value, swap it
    ranks[tokenId - 1] = ranks[randomIndex]; // Push existing to last
    ranks[randomIndex] = tokenId;
  } else {
    ranks[randomIndex] = tokenId;
  }
}
```

The `tokenURI` function renders the metadata as a base64-encoded JSON string. This means that the NFT metadata is dynamic and generated by the smart contract. Before the reveal time, the metadata points to the `teaser.svg` file, [stored on IPFS](ipfs://QmZ36mis8daTmXWeBcTjfHCSSeQMyWcJH8mNvyB6i8KAXb/teaser.svg).

After reveal, the contract will first determine if a given token has a prize! To do this, we offset the randomized array based on the random number stored on every transaction and get the rank for the given token. This allows the contract to randomize the winning packets in a non-sequential order in a consistent way _after_ the reveal! The metadata then points to the right svg file (also stored on IPFS), and includes information about whether indeed the given token has a prize.

Finally the `RedPacket.sol` contract also includes a `claimPrize` function which can be called once for each token and that withdraws the corresponding amount from the lock for any token!

## Conclusion

Unlock is a protocol for memberships that leverages NFTs. It is also an incredibly versatile NFT contract that lets anyone build fun and unique experiences that would not be possible to build _without_ blockchains in a trustless way! In December, the Unlock Labs team released an Avent Calendar, last week we shipped a Hongbao application... and we will do a lot more of these activations over the next few months! Please stay tuned!


Let's explore how the Unlock Labs team built a fun experiment by leveraging some of the core characteristics of the PublicLock NFT contract!

Using the public lock contract for fun and profit!

How-to do NFT Red Packets

🐰 Happy Year of the Rabbit! You can now <a href="https://red-packet.unlock-protocol.com/">open your Hongbao</a>!
Last week, we <a href="https://unlock-protocol.com/blog/redpacket-rabbit">launched a really fun experiment</a> inspired by the traditional Chinese gift-giving practice to show appreciation or gratitude.
Today, I want to tell you more about how we built it! The code is <a href="https://github.com/unlock-protocol/red-packet-2023">full open-source</a> and ready for you to inspect if you want to build similar experiments!
<h2>Front-end</h2>
For the front-end, we used Next.js, which, as you probably know is a React-based application framework. We also use Tailwind for the CSS, as well as few common libraries. This is all written in Typescript.
We also used some custom hooks:
<ul>
<li><a href="https://github.com/unlock-protocol/red-packet-2023/blob/main/hooks/useAuth.tsx"><code>useAuth</code></a> which connects to Unlock's <a href="https://docs.unlock-protocol.com/tools/sign-in-with-ethereum/">Sign-In with Ethereum</a> endpoint. We used it to identify the users.</li>
<li><a href="https://github.com/unlock-protocol/red-packet-2023/blob/main/hooks/useLock.tsx"><code>useLock</code></a> which queries the RPC endpoint to check if an address owns a valid NFT from the Hongbao contract. We used it to check if a given user already owns an NFT.</li>
<li><a href="https://github.com/unlock-protocol/red-packet-2023/blob/main/hooks/useMetadata.tsx"><code>useMetadata</code></a> which queries the RPC endpoint to retrive the <code>tokenURI</code> of a given token. Since the metadata is in fact generated on-chain (more below), this yields it in the form of base64 encoded JSON.</li>
</ul>
Finally, we also added an API function. When thinking about this experiment, we wanted people to be able to send red packets to anyone, even if that person did not previously use the Polygon chain, so that means we needed a mechanism to "claim" the potential prizes in a gasless way because these recipients would otherwise need MATIC tokens to pay for the gas to claim from the red pockets.
<pre><code class="language-javascript">export default async function handler(
 req: NextApiRequest,
 res: NextApiResponse
) {
 if (!process.env.PRIVATE_KEY) {
 return res.status(500).json('Missing private key')
 }
 const provider = new ethers.providers.JsonRpcProvider(
 'https://rpc.unlock-protocol.com/137'
 )
 const signer = new ethers.Wallet(process.env.PRIVATE_KEY).connect(provider)
 const gasPrice: any = await provider.getGasPrice()
 const hook = new ethers.Contract(
 '0xc328ae7fc36f975be120aaa99f2d96c3e732e5b6', // Address of the RedPacket contract
 ABI, // ABI for the RedPacket contract
 signer
 )
 const { tokenId } = JSON.parse(req.body)
 const tx = await hook.claimPrize(tokenId, { gasPrice }) // call to claim the reward
 res.status(200).json({ hash: tx.hash })
}
</code></pre>
We'll come back to it, but the function to withdraw can actually be called by anyone as it just sends the money in the envelope to its owner, so we just added a basic API call which can <a href="https://github.com/unlock-protocol/red-packet-2023/blob/main/pages/api/claim.tsx">call the claim function</a> with a token id. We cover the gas for these calls.
<h2>Smart Contracts</h2>
This part is really where the use of the Unlock Protocol shines. First of all, the NFT contract is obviously our <code>PublicLock</code>. You can inspect it <a href="https://polygonscan.com/address/0x01703c979220de3e7662ab90a696843225d31383">using a block explorer</a>. We set the price of its NFT to be 1 MATIC. However, we use another contract that we called <code>RedPacket.sol</code>. This contract <a href="https://polygonscan.com/address/0xc328ae7fc36f975be120aaa99f2d96c3e732e5b6">has also been verified</a> and is used as hooks for 2 different functions inside of the PublicLock contract: <code>onKeyPurchaseHook</code> and <code>onTokenUriHook</code>. The first one is called when new NFTs are being purchased, and the latter when someone tries to retrieve the metadata for a given token.
The <code>RedPacket.sol</code> was initialized with a timestamp for the "reveal time", which was set to be midnight on January 22nd in Beijing, China. The purchase hook will prevent any new token from being minted after the reveal.
Additionaly, on every purchase, the hook computes a "random" number. We know that pure randomless is really hard to compute on-chain. Here, we are computing a hash of the block's timestamp, token id and owner combined. This is sufficiently unguessable and hard to manipulate by miners. This random number is stored in the hook (to be used later), as well as used to "shuffle" an array of token by index, by inserting the newly minted token at a random location (this is a variation of the <a href="https://en.wikipedia.org/wiki/Fisher%E2%80%93Yates_shuffle">Fisher-Yates shuffle</a>).
<pre><code class="language-javascript">function onKeyPurchase(
 uint256 tokenId, /* tokenId */
 address from, /* from */
 address, /* recipient */
 address, /* referrer */
 bytes calldata, /* data */
 uint256, /* minKeyPrice */
 uint256 /* pricePaid */
) external {
 if (block.timestamp > revealTime) {
 revert TOO_LATE();
 }
 if (msg.sender != lock) {
 revert NOT_AUTHORIZED();
 }
 // We compute an offset for the final tally
 offset = uint256(keccak256(abi.encodePacked(block.timestamp + tokenId, from))) % 8888888; // Sets the offset!
 // We "randomize" an array that can help us compute winners!
 uint randomIndex = offset % tokenId; // Selects a random index
 if(ranks[randomIndex] > 0) {
 // If we already have a value, swap it
 ranks[tokenId - 1] = ranks[randomIndex]; // Push existing to last
 ranks[randomIndex] = tokenId;
 } else {
 ranks[randomIndex] = tokenId;
 }
}
</code></pre>
The <code>tokenURI</code> function renders the metadata as a base64-encoded JSON string. This means that the NFT metadata is dynamic and generated by the smart contract. Before the reveal time, the metadata points to the <code>teaser.svg</code> file, <a href="ipfs://QmZ36mis8daTmXWeBcTjfHCSSeQMyWcJH8mNvyB6i8KAXb/teaser.svg">stored on IPFS</a>.
After reveal, the contract will first determine if a given token has a prize! To do this, we offset the randomized array based on the random number stored on every transaction and get the rank for the given token. This allows the contract to randomize the winning packets in a non-sequential order in a consistent way after the reveal! The metadata then points to the right svg file (also stored on IPFS), and includes information about whether indeed the given token has a prize.
Finally the <code>RedPacket.sol</code> contract also includes a <code>claimPrize</code> function which can be called once for each token and that withdraws the corresponding amount from the lock for any token!
<h2>Conclusion</h2>
Unlock is a protocol for memberships that leverages NFTs. It is also an incredibly versatile NFT contract that lets anyone build fun and unique experiences that would not be possible to build without blockchains in a trustless way! In December, the Unlock Labs team released an Avent Calendar, last week we shipped a Hongbao application... and we will do a lot more of these activations over the next few months! Please stay tuned!


![red packet](/images/blog/redpacket-rabbit/redpacket-rabbit.png)

The exchanging of [hongbao](https://en.wikipedia.org/wiki/Red_envelope) (also referred to as “red packet” or “red envelope”) is a traditional Chinese gift-giving practice that dates back centuries and is typically associated with holidays such as Chinese New Year and other special occasions. It is also [commonly used in business and professional settings](https://en.wikipedia.org/wiki/WeChat_red_envelope) to show appreciation or gratitude.

Hongbao is an important part of Chinese culture and is seen as a way to show respect and appreciation for another person. It is seen as a gesture of goodwill and generosity. It is also seen as a way to strengthen relationships and foster social harmony.

The monetary value of hongbao is typically small, and it is seen as a gesture, rather than an exchange of money. It is often accompanied by a written message or wish.

Our designer [Chiali](https://chialitsai.com/about/) brought up the idea of seeing if we’d be able to bring the gratitude of hongbao to web3, and the rest of the Unlock Protocol team leapt at her idea.

Chiali’s design and results are delightful.

![red packet rarities](/images/blog/redpacket-rabbit/redpacket-all-rarities.png)

In addition to Chiali’s fantastic art, which stands on its own, some of the packets may have a little something special inside them as well to help cheer in the Year of the Rabbit. 🧧

We will open a mint window on Wednesday, January 18, 2023, and you can mint and send a gift of hongbao to someone you appreciate.

The five hongbao designs with differing rarity traits will be revealed to holders on Sunday, January 22, 2023 (Lunar New Year).

Mint price to send a gift of hongbao is 1 MATIC (right around a dollar at today’s rates) and takes place on the Polygon Network. While you can mint multiple times to send to multiple recipients, there is a maximum of one hongbao gift per wallet.

**If you would like to gift a web3-powered red packet to someone this year, please visit: [https://red-packet.unlock-protocol.com](https://red-packet.unlock-protocol.com).**

_As always, if you have any questions, please let us know in the [Discord](https://discord.unlock-protocol.com)._


The exchanging of hongbao, also referred to as “red packet” or “red envelope,” is a traditional Chinese gift-giving practice to show appreciation or gratitude.

The Story Behind the Red Envelope

<img src="/images/blog/redpacket-rabbit/redpacket-rabbit.png" alt="red packet">
The exchanging of <a href="https://en.wikipedia.org/wiki/Red_envelope">hongbao</a> (also referred to as “red packet” or “red envelope”) is a traditional Chinese gift-giving practice that dates back centuries and is typically associated with holidays such as Chinese New Year and other special occasions. It is also <a href="https://en.wikipedia.org/wiki/WeChat_red_envelope">commonly used in business and professional settings</a> to show appreciation or gratitude.
Hongbao is an important part of Chinese culture and is seen as a way to show respect and appreciation for another person. It is seen as a gesture of goodwill and generosity. It is also seen as a way to strengthen relationships and foster social harmony.
The monetary value of hongbao is typically small, and it is seen as a gesture, rather than an exchange of money. It is often accompanied by a written message or wish.
Our designer <a href="https://chialitsai.com/about/">Chiali</a> brought up the idea of seeing if we’d be able to bring the gratitude of hongbao to web3, and the rest of the Unlock Protocol team leapt at her idea.
Chiali’s design and results are delightful.
<img src="/images/blog/redpacket-rabbit/redpacket-all-rarities.png" alt="red packet rarities">
In addition to Chiali’s fantastic art, which stands on its own, some of the packets may have a little something special inside them as well to help cheer in the Year of the Rabbit. 🧧
We will open a mint window on Wednesday, January 18, 2023, and you can mint and send a gift of hongbao to someone you appreciate.
The five hongbao designs with differing rarity traits will be revealed to holders on Sunday, January 22, 2023 (Lunar New Year).
Mint price to send a gift of hongbao is 1 MATIC (right around a dollar at today’s rates) and takes place on the Polygon Network. While you can mint multiple times to send to multiple recipients, there is a maximum of one hongbao gift per wallet.
If you would like to gift a web3-powered red packet to someone this year, please visit: <a href="https://red-packet.unlock-protocol.com">https://red-packet.unlock-protocol.com</a>.
As always, if you have any questions, please let us know in the <a href="https://discord.unlock-protocol.com">Discord</a>.


Today, we’re unveiling a cool new page on our static site: it’s called [“State of Unlock”](https://unlock-protocol.com/state) and it shows some important metrics for Unlock Protocol adoption!

Since we firmly believe in a world where creators will deploy their locks on multiple networks, we show both the aggregate data, as well as data on a per-network basis.

![State of Unlock](/images/blog/state-of-unlock/state-of-unlock.png)

Here are the 3 core metrics we care about:

- **Number of Locks deployed:** That’s the number of smart contracts deployed by creators, brands and teams who want to operate a membership program on chain.
- **Number of Keys sold:** That’s the number of membership NFTs sold. It provides a good indication of the penetration of Unlock!
- **Active Locks:** That’s the number of locks that have minted _at least_ one membership NFT in the previous 30 days.

Of course, we also measure the “Gross Network Product” which is the total revenue generated through Unlock on a given network. We can’t easily aggregate these because they are measured in each network's base currency (ETH on Ethereum mainnet, MATIC on Polygon, etc.).

As a member of the Unlock ecosystem, you are now able to get an overview of the protocol's reach and growth.


A single page where everyone can see the state of the networks: locks deployed, active and NFTs minted!

State of Unlock

Today, we’re unveiling a cool new page on our static site: it’s called <a href="https://unlock-protocol.com/state">“State of Unlock”</a> and it shows some important metrics for Unlock Protocol adoption!
Since we firmly believe in a world where creators will deploy their locks on multiple networks, we show both the aggregate data, as well as data on a per-network basis.
<img src="/images/blog/state-of-unlock/state-of-unlock.png" alt="State of Unlock">
Here are the 3 core metrics we care about:
<ul>
<li>Number of Locks deployed: That’s the number of smart contracts deployed by creators, brands and teams who want to operate a membership program on chain.</li>
<li>Number of Keys sold: That’s the number of membership NFTs sold. It provides a good indication of the penetration of Unlock!</li>
<li>Active Locks: That’s the number of locks that have minted at least one membership NFT in the previous 30 days.</li>
</ul>
Of course, we also measure the “Gross Network Product” which is the total revenue generated through Unlock on a given network. We can’t easily aggregate these because they are measured in each network's base currency (ETH on Ethereum mainnet, MATIC on Polygon, etc.).
As a member of the Unlock ecosystem, you are now able to get an overview of the protocol's reach and growth.


> We now have a [great UI for Promo Code management](/blog/discount-codes-capped)!

We're starting this year like we finished the previous one: 🚀 by shipping cool features. Today, we're introducing a new type of [purchase hook](https://docs.unlock-protocol.com/core-protocol/public-lock/hooks): the **discount hook**! Whether you are organizing events, selling subscriptions to your content, or running a knitting club, sometimes, you want to provide discounts to your most loyal customers.

Since an example is worth a thousand words, here is one. Here is a membership [that costs 0.01 Goerli Eth](https://app.unlock-protocol.com/checkout?paywallConfig=%7B%22locks%22%3A%7B%220x2490f447fdb7b259bc454871806b6b794de65944%22%3A%7B%22network%22%3A5%2C%22skipRecipient%22%3Atrue%2C%22name%22%3A%22%22%2C%22captcha%22%3Afalse%2C%22password%22%3Afalse%2C%22promo%22%3Atrue%2C%22emailRequired%22%3Afalse%2C%22maxRecipients%22%3Anull%2C%22dataBuilder%22%3A%22%22%7D%7D%2C%22pessimistic%22%3Atrue%2C%22skipRecipient%22%3Atrue%7D). If you go through the whole checkout, you will find a new screen that lets you enter a promo code! Try `FRIENDS` for a 50% discount, or `FAMILY` for a 100% discount!

![enter coupon](/images/blog/promo-codes/promo-screen.jpeg)

Of course, this is "safe" and evesdropping on the transaction from a block explorer will not let someone _guess_ promo codes. Like always, we published the [source code on Github](https://github.com/unlock-protocol/discount-hook) along with detailed explainations on how to set this up for your own lock contract.


Whether you are organizing events, selling subscriptions to your content, or running a knitting club, sometimes, you want to provide discounts to your most loyal customers. You can do that with your lock smart contract.

Apply promo codes and coupons to your memberships

Discount Codes

<blockquote>
We now have a <a href="/blog/discount-codes-capped">great UI for Promo Code management</a>!
</blockquote>
We're starting this year like we finished the previous one: 🚀 by shipping cool features. Today, we're introducing a new type of <a href="https://docs.unlock-protocol.com/core-protocol/public-lock/hooks">purchase hook</a>: the discount hook! Whether you are organizing events, selling subscriptions to your content, or running a knitting club, sometimes, you want to provide discounts to your most loyal customers.
Since an example is worth a thousand words, here is one. Here is a membership <a href="https://app.unlock-protocol.com/checkout?paywallConfig=%7B%22locks%22%3A%7B%220x2490f447fdb7b259bc454871806b6b794de65944%22%3A%7B%22network%22%3A5%2C%22skipRecipient%22%3Atrue%2C%22name%22%3A%22%22%2C%22captcha%22%3Afalse%2C%22password%22%3Afalse%2C%22promo%22%3Atrue%2C%22emailRequired%22%3Afalse%2C%22maxRecipients%22%3Anull%2C%22dataBuilder%22%3A%22%22%7D%7D%2C%22pessimistic%22%3Atrue%2C%22skipRecipient%22%3Atrue%7D">that costs 0.01 Goerli Eth</a>. If you go through the whole checkout, you will find a new screen that lets you enter a promo code! Try <code>FRIENDS</code> for a 50% discount, or <code>FAMILY</code> for a 100% discount!
<img src="/images/blog/promo-codes/promo-screen.jpeg" alt="enter coupon">
Of course, this is "safe" and evesdropping on the transaction from a block explorer will not let someone guess promo codes. Like always, we published the <a href="https://github.com/unlock-protocol/discount-hook">source code on Github</a> along with detailed explainations on how to set this up for your own lock contract.


2022 was an incredible year for the Unlock Protocol community! The number of smart contracts deployed using Unlock Protocol [skyrocketed](https://dune.com/ccarfi/Unlock-Protocol-Rankings) from where we were in 2021; there were incredible enhancements made to the underlying protocol itself; tools, docs, guides, and community were completely redesigned; and new projects were popping off like wildflowers. (And just for fun, [over 12,000 individual wallets claimed over 200,000(!) membership NFTs](https://tpan.substack.com/p/thoughts-152-unlock-protocols-advent) from our Advent calendar over the holiday season!)

Most importantly — ALL of this happened thanks to **you**! Thanks for being part of the community of Locksmiths who have made Unlock Protocol a fundamental part of web3 infrastructure.

Here are a few highlights from 2022, and some of the things that are on tap for 2023.

## Dozens of learning resources were delivered

![resources](/images/blog/unlock-2022-review/resources.png)

Across every medium — [developer docs](https://docs.unlock-protocol.com/), [creator guides](https://unlock-protocol.com/guides/), our [YouTube channel](https://www.youtube.com/unlockprotocol), [source and example repos](https://github.com/unlock-protocol) and more — every key aspect of learning about and developing with Unlock Protocol was revamped in 2022.

## Protocol and product updates were everywhere across the experience

![dashboard](/images/blog/unlock-2022-review/dashboard.png)

The Unlock Protocol project is rooted in envisioning and then *delivering* useful and usable implementations. To that end, the project knocked it out of the park in 2022, delivering an incredibly intuitive experience with the new [dashboard and no-code smart contract creation wizard](https://unlock-protocol.com/blog/dashboard-redesign), new monetization and incentive options for creators and developers by implementing the ability for projects to set [affiliate and referral incentives](https://unlock-protocol.com/blog/referral-fees), enabling recurring project revenue with [subscriptions](https://unlock-protocol.com/blog/recurring-subscription-nft), and a host of other improvements in the handling and experience of [metadata](https://unlock-protocol.com/blog/metadata-configurator), [airdrops](https://unlock-protocol.com/blog/email-airdrop-nft), [checkout](https://unlock-protocol.com/blog/redesigning-our-checkout), [lock settings](https://unlock-protocol.com/blog/settings-page), [credit card payment options](https://unlock-protocol.com/blog/support-for-google-and-apple-pay), and enabling new onchain capabilities with [hooks](https://docs.unlock-protocol.com/tutorials/smart-contracts/hooks/), [dynamic NFTs](https://unlock-protocol.com/blog/dynamic-nft), and [Sign In With Ethereum](https://unlock-protocol.com/blog/sign-in-with-ethereum).

You can see all the highlights here on the Unlock [blog](https://unlock-protocol.com/blog).

## Partners and projects launched and kept on launching

![showcase](/images/blog/unlock-2022-review/showcase.png)

2022 delivered an incredible array of projects and partnerships across the Unlock ecosystem — so many, we were having trouble keeping up with them all! To fix that, we created the [Unlock Showcase](https://showcase.unlock-protocol.com/), where you can explore all the latest projects and partnerships happening across the Unlock universe. We partnered with Polygon, thirdweb, Guild.xyz, web3 Academy, and many others, and innumerable projects were created across the ecosystem by community members.

## Community activity grew and grew

![leaderboard](/images/blog/unlock-2022-review/locksmith-leaderboard-oct-2022.png)

The Unlock community grew by leaps and bounds during 2022. One of the major initiatives launched in the second half of the year was the rollout of the [Locksmith Leaderboard](https://unlock.community/t/retroactive-funding-january-2023/409) — a monthly spotlight and recognition of the individuals in the community who are providing instrumental value to their peers. Through participating via design, development, helping others in the community, sharing the Unlock Protocol story, and many other ways, Locksmiths are the core of Unlock Protocol and help propel the project forward.

The most visible places where Locksmiths engage with the project and each other are on Github (adding issues, submitting pull requests), on Twitter (sharing and mentioning Unlock Protocol in their social media activities), and in the project Discord (responding to and answering question threads). The Leaderboard also attempts to capture longevity of participation in the community, as well as consistency of participation over time.

## Coming in 2023

![fireworks](/images/blog/unlock-2022-review/fireworks-notext.png)

The new year is underway, and Unlock is hitting the ground running! There are a number of exciting cross-chain initiatives already in flight, we'll be at all the big web3 events and hackathons starting with ETHDenver next month, and the core team is rested and ready to keep pushing things forward in 2023.

If you haven't swung by the [Discord](https://discord.unlock-protocol.com) in a while, might be a good time to check in. There are exciting projects and conversations happening every day. Won't you swing by?

That’s a wrap! Thanks for a great 2022, and looking forward to seeing you throughout 2023!


2022 was year filled with new resources, new code, new partners, and massive uptake.

2022 was year filled with new resources, new code, new partners, and massive uptake

Unlock Protocol Year in Review 2022

2022 was an incredible year for the Unlock Protocol community! The number of smart contracts deployed using Unlock Protocol <a href="https://dune.com/ccarfi/Unlock-Protocol-Rankings">skyrocketed</a> from where we were in 2021; there were incredible enhancements made to the underlying protocol itself; tools, docs, guides, and community were completely redesigned; and new projects were popping off like wildflowers. (And just for fun, <a href="https://tpan.substack.com/p/thoughts-152-unlock-protocols-advent">over 12,000 individual wallets claimed over 200,000(!) membership NFTs</a> from our Advent calendar over the holiday season!)
Most importantly — ALL of this happened thanks to you! Thanks for being part of the community of Locksmiths who have made Unlock Protocol a fundamental part of web3 infrastructure.
Here are a few highlights from 2022, and some of the things that are on tap for 2023.
<h2>Dozens of learning resources were delivered</h2>
<img src="/images/blog/unlock-2022-review/resources.png" alt="resources">
Across every medium — <a href="https://docs.unlock-protocol.com/">developer docs</a>, <a href="https://unlock-protocol.com/guides/">creator guides</a>, our <a href="https://www.youtube.com/unlockprotocol">YouTube channel</a>, <a href="https://github.com/unlock-protocol">source and example repos</a> and more — every key aspect of learning about and developing with Unlock Protocol was revamped in 2022.
<h2>Protocol and product updates were everywhere across the experience</h2>
<img src="/images/blog/unlock-2022-review/dashboard.png" alt="dashboard">
The Unlock Protocol project is rooted in envisioning and then delivering useful and usable implementations. To that end, the project knocked it out of the park in 2022, delivering an incredibly intuitive experience with the new <a href="https://unlock-protocol.com/blog/dashboard-redesign">dashboard and no-code smart contract creation wizard</a>, new monetization and incentive options for creators and developers by implementing the ability for projects to set <a href="https://unlock-protocol.com/blog/referral-fees">affiliate and referral incentives</a>, enabling recurring project revenue with <a href="https://unlock-protocol.com/blog/recurring-subscription-nft">subscriptions</a>, and a host of other improvements in the handling and experience of <a href="https://unlock-protocol.com/blog/metadata-configurator">metadata</a>, <a href="https://unlock-protocol.com/blog/email-airdrop-nft">airdrops</a>, <a href="https://unlock-protocol.com/blog/redesigning-our-checkout">checkout</a>, <a href="https://unlock-protocol.com/blog/settings-page">lock settings</a>, <a href="https://unlock-protocol.com/blog/support-for-google-and-apple-pay">credit card payment options</a>, and enabling new onchain capabilities with <a href="https://docs.unlock-protocol.com/tutorials/smart-contracts/hooks/">hooks</a>, <a href="https://unlock-protocol.com/blog/dynamic-nft">dynamic NFTs</a>, and <a href="https://unlock-protocol.com/blog/sign-in-with-ethereum">Sign In With Ethereum</a>.
You can see all the highlights here on the Unlock <a href="https://unlock-protocol.com/blog">blog</a>.
<h2>Partners and projects launched and kept on launching</h2>
<img src="/images/blog/unlock-2022-review/showcase.png" alt="showcase">
2022 delivered an incredible array of projects and partnerships across the Unlock ecosystem — so many, we were having trouble keeping up with them all! To fix that, we created the <a href="https://showcase.unlock-protocol.com/">Unlock Showcase</a>, where you can explore all the latest projects and partnerships happening across the Unlock universe. We partnered with Polygon, thirdweb, Guild.xyz, web3 Academy, and many others, and innumerable projects were created across the ecosystem by community members.
<h2>Community activity grew and grew</h2>
<img src="/images/blog/unlock-2022-review/locksmith-leaderboard-oct-2022.png" alt="leaderboard">
The Unlock community grew by leaps and bounds during 2022. One of the major initiatives launched in the second half of the year was the rollout of the <a href="https://unlock.community/t/retroactive-funding-january-2023/409">Locksmith Leaderboard</a> — a monthly spotlight and recognition of the individuals in the community who are providing instrumental value to their peers. Through participating via design, development, helping others in the community, sharing the Unlock Protocol story, and many other ways, Locksmiths are the core of Unlock Protocol and help propel the project forward.
The most visible places where Locksmiths engage with the project and each other are on Github (adding issues, submitting pull requests), on Twitter (sharing and mentioning Unlock Protocol in their social media activities), and in the project Discord (responding to and answering question threads). The Leaderboard also attempts to capture longevity of participation in the community, as well as consistency of participation over time.
<h2>Coming in 2023</h2>
<img src="/images/blog/unlock-2022-review/fireworks-notext.png" alt="fireworks">
The new year is underway, and Unlock is hitting the ground running! There are a number of exciting cross-chain initiatives already in flight, we'll be at all the big web3 events and hackathons starting with ETHDenver next month, and the core team is rested and ready to keep pushing things forward in 2023.
If you haven't swung by the <a href="https://discord.unlock-protocol.com">Discord</a> in a while, might be a good time to check in. There are exciting projects and conversations happening every day. Won't you swing by?
That’s a wrap! Thanks for a great 2022, and looking forward to seeing you throughout 2023!