🎁Pancake Gifts

🎯 What is Pancake Gifts?

Pancake Gifts lets anyone send tokens — including optional gas — to friends, users, or communities using just a link or QR code. It’s a simple, secure, and gasless experience for the recipient.

It’s built to make onboarding into crypto as easy as sending a message — no wallet funding, no bridging, no upfront fees.

🤝 Why We Built Pancake Gifts

Onboarding to Web3 is still full of friction. New users often give up before they even get started due to:

• No gas in wallet → Can’t perform any onchain action

• No funds on the correct chain → Bridging is required before using dApps

• Need to buy crypto just to get started → Requires CEX signup or fiat on-ramp

Pancake Gifts eliminates these blockers by:

• ✅ Including native gas tokens in the gift so recipients can interact instantly

• ✅ Sponsoring the gas fee upfront (sender pays a small fee)

• ✅ Enabling claim via a simple link or QR — no complex onboarding

It’s a tool for both:

• New users getting started onchain

• Web3-native communities looking to boost adoption, reward users, or run campaigns in a friendlier way

---

⚙️ Feature Summary

Feature	Description
Chain Support	BNB Chain (initial launch)
Gift Code Types	Link or QR Code
One-time Use	Each code can only be claimed once
Token Support	Max 2 tokens: 1 BEP-20 (required), 1 native gas token (optional)
Custom Amounts	Set different values per token
Gift Claim Gas Fee	Sender prepays gas (~$0.05 in BNB)
Gift History	Users can view all sent gifts, claim status, expiry
Security Checks	Fee-on-transfer and complex logic tokens are disallowed

🚫 Limitations

1. One gift per code — Mass gifting is not yet supported.

2. Gifts cannot be reinstated — Once cancelled or expired, they cannot be reused.

3. Unsupported tokens are blocked — Tokens with transfer fees or special logic will show an error on creation.

4. Unsuccessful claims are retried — Backend retries a few times. If still failed, the gift is marked unclaimable and must be cancelled manually to retrieve funds.

5. Gift must be claimed on the same chain — e.g. ETH gift must be claimed on Ethereum. Cross-chain claiming is not supported yet.

---

🕒 Cancel & Expiry Logic

Gifts follow a defined lifecycle based on status and time:

Manual Cancel

• The creator can cancel any gift that is still unclaimed and within the expiry window.

• Tokens (minus the initial Gift Claim Gas Fee) will be returned to the sender.

• Cancelled gifts cannot be reactivated or reused.

Auto Expiry

• Gifts automatically expire after a user-defined period (default: 7 days).

• Unclaimed tokens will be auto-returned to the sender’s wallet.

• Expired gifts are also non-reusable.

---

🔄 Gift Statuses & What They Mean

Status	Description
Pending	Gift has been created and is awaiting claim
Claimed	Gift was successfully claimed by a recipient
Cancelled	Gift was manually cancelled by the sender
Expired	Gift passed the expiry time without being claimed
Unclaimable	Number of retries exceeded; gift needs to be cancelled to retrieve funds

---

⚠️ Error Handling & Edge Cases

1. Unsupported Token

   • Gift creation is blocked for tokens with transfer fees or special logic.

2. Gas Mismatch

   • If actual claim gas cost ≥ the sender’s prepaid fee, the claim fails automatically to prevent overuse. This will be retried once gas fee levels are within range.

3. Failed Claim Attempts

   • Retries will be attempted upon first unsuccessful claim.

   • If still unsuccessful:

     • Recipient sees “Unclaimable”

     • Sender must manually cancel the gift to retrieve funds and receipient will have to request or a new gift code.