🎁Pancake Gifts

🎯 什么是 Pancake Gifts？

Pancake Gifts 让任何人都可以只用一个链接或二维码，向朋友、用户或社区发送代币（可选附带 gas）。对接收方而言，这是一种简单、安全且免 gas 的体验。

它的设计目标是让进入加密世界像发一条消息一样简单——无需为钱包充值、无需跨链桥接、无需预付费用。

🤝 我们为何打造 Pancake Gifts

进入 Web3 的过程仍然充满摩擦。新用户常常还没真正开始就放弃了，原因包括：

• 钱包里没有 gas → 无法执行任何链上操作

• 正确链上没有资金 → 使用 dApp 前需要先跨链

• 必须先购买加密货币才能开始 → 需要注册中心化交易所（CEX）或使用法币入金通道

Pancake Gifts 通过以下方式消除这些障碍：

• ✅ 在礼物中包含原生 gas 代币，让接收方可以即时交互

• ✅ 预先赞助 gas 费用（由发送方支付一笔小额费用）

• ✅ 通过简单的链接或二维码即可领取——无需复杂的上手流程

它同时适用于：

• 刚开始进行链上操作的新用户

• 希望以更友好的方式推动用户采用、奖励用户或开展活动的 Web3 原生社区

---

⚙️ 功能概览

功能	说明
支持的链	BNB Chain（首发）
礼物码类型	链接或二维码
一次性使用	每个礼物码只能被领取一次
代币支持	最多 2 种代币：1 种 BEP-20（必选），1 种原生 gas 代币（可选）
自定义金额	可为每种代币设置不同的数值
礼物领取 Gas 费	发送方预付 gas（约合 ~$0.05 的 BNB）
礼物历史	用户可查看所有已发送礼物、领取状态及过期情况
安全检查	不支持转账收费（fee-on-transfer）及含复杂逻辑的代币

🚫 限制

1. 每个礼物码对应一份礼物——暂不支持批量赠送。

2. 礼物无法恢复——一旦取消或过期，便无法再次使用。

3. 不支持的代币会被拦截——含转账费用或特殊逻辑的代币在创建时会显示错误。

4. 领取失败会自动重试——后端会重试若干次。若仍然失败，该礼物会被标记为不可领取，需手动取消以取回资金。

5. 礼物必须在同一条链上领取——例如 ETH 礼物必须在 Ethereum 上领取。暂不支持跨链领取。

---

🕒 取消与过期逻辑

礼物会根据状态和时间遵循既定的生命周期：

手动取消

• 创建者可以取消任何仍处于未领取且在有效期内的礼物。

• 代币（扣除最初的礼物领取 Gas 费后）将退还给发送方。

• 已取消的礼物无法重新激活或再次使用。

自动过期

• 礼物会在用户设定的期限后（默认：7 天）自动过期。

• 未领取的代币将自动退还至发送方的钱包。

• 已过期的礼物同样无法再次使用。

---

🔄 礼物状态及其含义

状态	说明
Pending	礼物已创建，等待领取
Claimed	礼物已被接收方成功领取
Cancelled	礼物已被发送方手动取消
Expired	礼物超过有效期仍未被领取
Unclaimable	重试次数已超限；需取消该礼物以取回资金

---

⚠️ 错误处理与边界情况

1. 不支持的代币

   • 含转账费用或特殊逻辑的代币将无法创建礼物。

2. Gas 不匹配

   • 如果实际领取 gas 成本 ≥ 发送方预付的费用，领取将自动失败，以防止过度消耗。待 gas 费水平回到合理范围后将自动重试。

3. 领取失败

   • 首次领取失败时将自动重试。

   • 若仍然失败：

     • 接收方会看到“Unclaimable（不可领取）”

     • 发送方须手动取消该礼物以取回资金，接收方则需另行索取新的礼物码。