> For the complete documentation index, see [llms.txt](https://docs.pancakeswap.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pancakeswap.finance/chinese/jiao-yi-gong-ju/pancake-gifts.md).

# 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（不可领取）”
     * 发送方须手动取消该礼物以取回资金，接收方则需另行索取新的礼物码。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pancakeswap.finance/chinese/jiao-yi-gong-ju/pancake-gifts.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
