# 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="../keyring-ez-wallet/how-to-use" %}
[how-to-use](https://help.keyring.app/zh/keyring-ez-wallet/how-to-use)
{% 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="https://content.gitbook.com/content/rLTrjxiNFKKaqCmNTDEB/blobs/u0VrLTHPLcCU6CcRmU9o/Gi%E1%BA%A3i%20th%C3%ADch%20link%20top%20up%20ERC-20.png" 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="https://content.gitbook.com/content/rLTrjxiNFKKaqCmNTDEB/blobs/S10Q8ANDuKxYlZG7pPhH/Top%20up%20page%20set%20up%20ENG.png" 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="https://content.gitbook.com/content/rLTrjxiNFKKaqCmNTDEB/blobs/5oP3Mza0TGg8N2bB0VWI/Top-up-ERC-20-gif.gif" alt="" width="563"><figcaption></figcaption></figure></div>

### ERC-1155

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

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

<div align="left"><figure><img src="https://content.gitbook.com/content/rLTrjxiNFKKaqCmNTDEB/blobs/459A50cvxh5VFGPRURUN/Top-up-ERC-1155.gif" 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="https://content.gitbook.com/content/rLTrjxiNFKKaqCmNTDEB/blobs/PmRuMSCU8xBKR3YxQhFr/Get-nft-contract.gif" alt="" width="375"><figcaption></figcaption></figure>

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

* **充值金额**：

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

* **票务销售**：

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

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

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

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

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