# Top-Up

## **什么是Top-Up？**

Top-Up功能专为KEYRING EZ Wallet的用户设计。通过此功能，EZ Wallet的持有者可以利用他们的钱包地址，将ERC-20和ERC-1155代币添加到来自KEYRING的卡片型钱包中，目前包括KEYRING PiGET和KEYRING Hard Wallet。

此功能使卡片持有者能够通过他们的EZ Wallet无缝地将现金或其他资产转换为代币，特别是ERC-20和ERC-1155代币。

了解更多关于EZ Wallet的信息。

{% content-ref url="/pages/e69l6hwUvb4B78YyW6yr" %}
[如何使用](/zh/keyring-ez-wallet/how-to-use.md)
{% endcontent-ref %}

## **如何设置Top-Up页面？**

为了给用户提供灵活性，我们简化了Top-Up功能设置中的选项自定义过程。

用户只需直接编辑页面的URL即可。以下是详细指南：

由于用户可以使用两种标准代币类型进行充值，即ERC-20和ERC-1155，我们将说明分为两个部分：

### ERC-20

对于ERC-20代币标准，Top-Up URL将遵循以下格式：

```
ezwallet.keyring.app/sell/[chain ID]/[token address]/[top up option 1]/[top up option 2]/[top up option n]
```

<figure><img src="/files/u3n9t9hW17fkWJaadlh4" alt=""><figcaption></figcaption></figure>

除了固定部分“ezwallet.keyring.app/sell”之外，其余部分：\[chain ID]/\[token address]/\[top up option 1]/\[top up option 2]/\[top up option n] 可以根据用户的需要进行编辑。

以下是详细说明：

#### <mark style="color:blue;">**\[chain ID]**</mark>

这是与您当前拥有的代币对应的区块链ID编号，用于充值。

您可以通过任何可用的搜索引擎找到区块链ID，因为这些信息是公开且易于查找的。

不过，我们很关爱我们的用户，所以这里有我们支持的5个区块链网络及其ID：

* 以太坊 - 1
* 币安智能链（BNB） - 56
* Avalanche - 43114
* Polygon - 137
* Optimism - 10

#### <mark style="color:green;">\[token address]</mark>

这是您要用于充值的代币的合约地址。

请记住，相同类型的代币在不同链上会有不同的合约。

例如：

* Polygon上的USDC代币合约地址是：0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359。
* 而在以太坊上的合约地址是：0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48。

要找到正确的代币合约，我们将为您提供以下说明。

#### <mark style="color:orange;">**\[top up option 1]**</mark>/<mark style="color:orange;">**\[top up option 2]**</mark>/<mark style="color:orange;">**\[top up option n]**</mark>

您在这里填写的数字将决定您要设置的充值选项。

有点困惑？ 让我们来看一个具体的例子：

ezwallet.keyring.app/sell/137/0xc2132D05D31c914a87C6611C10748AEb04B58e8F/0.01/0.02/0.05

这个Top-Up URL演示了：

* 链ID：137 - 选定的区块链是Polygon。
* 代币地址：0xc2132D05D31c914a87C6611C10748AEb04B58e8F - 这是Polygon网络上USDT代币的合约地址。
* 充值选项：0.01/0.02/0.05 - 意味着，当为其他人充值时，用户将有3个选择：0.01、0.02和0.05。

<figure><img src="/files/4ZVguuBx5SzrHkLXEnhG" alt="" width="375"><figcaption></figcaption></figure>

### ERC-1155

设置ERC-1155的Top-Up URL与ERC-20非常相似，但多了一些额外步骤！ 首先，让我们来看一下ERC-1155的Top-Up URL格式：

```
ezwallet.keyring.app/sell1155/[chain ID]/[token address]/[NFT ID]/[top up option 1]/[top up option 2]/[top up option n]
```

您可能会注意到对于ERC-1155，它是“sell1155/”，但这不是重点关注的部分。

关于\[chain ID]/\[token address]/\[NFT ID]/\[top-up option 1]/\[top-up option 2]/\[top-up option n]：

* \[chain ID]和\[top-up options]完全与ERC-20部分介绍的内容相同。
* \[token address]也类似，只是找到这些NFT-1155地址的方法稍有不同。
* \[NFT ID]可能需要一点时间详细解释，但简而言之，它是该特定NFT的标识号码。

如何找到\[token address]和\[NFT ID]的说明将在下面的“如何找到合约地址”指南中提供，届时将使用KEYRING NFT Viewer工具进行帮助。

## **如何使用Top-Up？**

要开始Top-Up，请联系客户支持以建立一个自定义链接，该链接将显示特定ERC-20或ERC-1155代币的Top-Up功能，并指定每笔交易的数量选项。

此外，卖家（提供者）需要拥有EZ Wallet，并确保EZ Wallet余额中包含用于Top-Up的ERC-20或ERC-1155代币，代表其他人进行充值。

### ERC-20

请按照以下步骤完成Top-Up过程：

1. 访问您已设置的自定义EZ Wallet Top-Up链接。
2. 连接包含用于Top-Up余额的EZ Wallet连接文件。
3. 选择所需的Top-Up选项。
4. 点击“发送”进行确认。
5. 提示您的客户/用户扫描他们的卡片。
6. 等待交易完成，即可继续下一步。

<div align="left"><figure><img src="/files/DItSPyI8QzUmAK2nDjvr" alt="" width="563"><figcaption></figcaption></figure></div>

### ERC-1155

为ERC-1155代币充值的操作与ERC-20代币类似，主要区别在于使用的合约。

不过，就像ERC-20代币的流程一样，您需要提前与我们注册以接收相应的URL。

<div align="left"><figure><img src="/files/TENiUs4aSti06pN8ClcP" alt="" width="563"><figcaption></figcaption></figure></div>

## 如何找到合约地址？&#x20;

### **ERC-20**

查找ERC-20代币的合约地址其实非常简单！

您可以轻松地在像CoinMarketCap或CoinGecko这样的热门加密货币网站上找到它。这些网站备受信赖，并且使得查找您需要的合约地址非常容易。

如果您更喜欢使用搜索引擎如Google或Bing，也一样方便。只需输入代币名称及其所属的区块链，您就可以轻松找到合约地址。

### **ERC-1155**

对于ERC-1155代币，或者简单来说NFT-1155，借助KEYRING NFT Viewer找到它们的合约地址一点也不难。

通过KEYRING NFT Viewer网站，您可以快速找到特定NFT-1155的合约及其ID。

KEYRING NFT Viewer的一个独特功能是，您无需连接钱包即可查看某个钱包地址上的NFT。

操作步骤如下：

1. 前往[KEYRING NFT Viewer](https://nft.keyring.app/)网站。
2. 选择区块链并输入您想查看NFT的钱包地址。
3. 点击搜索图标。
4. 选择您想查看信息的NFT。
5. 完成！您现在可以轻松查看NFT地址、Token ID和Token标准。

<figure><img src="/files/llrZLPwMWovO3dox6acz" alt="" width="375"><figcaption></figcaption></figure>

## **Top-Up的用例是什么？**

* **充值金额**：

想象一下，您在商店购物时，如果您拥有一定数量的NFT会获得折扣，但您的NFT不够。这时Top-Up功能将帮助您轻松解决这个问题。

* **票务销售**：

当您组织需要门票才能入场的活动时，我们可以通过此方法销售门票，而不是实体票。

结合余额检查器功能，这将变得更加方便。

## **我可以用什么支付Top-Up？**

当您使用Top-Up功能时，支付选项取决于卖家接受的方式。卖家可以选择接受现金、代币甚至是实物。

这一切都取决于他们的舒适度。


---

# Agent Instructions: 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:

```
GET https://help.keyring.app/zh/keyring-piget/top-up.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
