Top-Up

What is Top-Up?

The Top Up feature is designed for owners of the KEYRING EZ Wallet. With this feature, EZ Wallet owners can utilize their wallet address to add ERC-20 and ERC-1155 tokens to the card-type wallets from KEYRING, which currently include KEYRING PiGET and KEYRING Hard Wallet.

This functionality enables card owners to seamlessly convert cash or other assets into tokens, specifically ERC-20 and ERC-1155 tokens, directly through their EZ Wallets.

Learn more about EZ Wallet here.

How to use

How to set up a Top-Up page?

To provide our users with flexibility, we've made it easy for them to customize options in the Top-Up feature settings.

Users can simply make direct edits to the URL of the page. Here's a detailed guide:

Since users can top up with two standard token types, ERC-20 and ERC-1155, we'll split the instructions into two parts:

ERC-20

For ERC-20 token standards, the Top-Up URL will follow this format:

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

Apart from the fixed part "ezwallet.keyring.app/sell", the rest: [chain ID]/[token address]/[top up option 1]/[top up option 2]/[top up option n] can all be edited based on the user's needs.

Here's a breakdown:

[chain ID]

This is the blockchain ID number corresponding to the token you currently own, used for topping up.

You can find the Blockchain IDs by using any search engine available, since this information is public and easy to find.

However, we love our users, so here are 5 blockchain networks we support, and here are their IDs:

  • Ethereum - 1

  • Binance Smart Chain (BNB) - 56

  • Avalanche - 43114

  • Polygon - 137

  • Optimism - 10

[token address]

This is the contract address of the token you want to use for top-up.

Remember, the same type of token but on different chains will have different contracts.

For example:

  • USDC token contract on Polygon is: 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359.

  • Whereas its contract on Ethereum is: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.

To find the correct token contract, we'll guide you through the following instructions.

[top up option 1]/[top up option 2]/[top up option n]

The numbers you fill in here will determine the options you want to set up for top-up.

A bit confusing? Let's look at a specific example:

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

This Top-Up URL demonstrates:

  • Chain ID: 137 - Selected blockchain is Polygon.

  • Token address: 0xc2132D05D31c914a87C6611C10748AEb04B58e8F. - This is the contract address of the USDT token on the Polygon network.

  • Top-up options: 0.01/0.02/0.05. - Meaning, when topping up for others, users will have 3 choices for each top-up: 0.01, 0.02, and 0.05.

ERC-1155

Setting up the Top-Up URL for ERC-1155 is quite similar to ERC-20, but with a few extra steps!

Firstly, let's take a look at the format of the Top-Up URL for ERC-1155:

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

You may notice that for ERC-1155, it is "sell1155/", but that's not the crucial part to focus on.

Regarding [chain ID]/[token address]/[NFT ID]/[top-up option 1]/[top-up option 2]/[top-up option n]:

  • [chain ID] and [top-up options] are entirely similar to what was introduced in the ERC-20 section.

  • [token address] is also similar, except for how you find the addresses of these NFT-1155, which is slightly different.

  • [NFT ID] may take a bit of time to explain in detail, but to put it briefly and simply, it's the identification number of that specific NFT.

Instructions on how to find [token address] and [NFT ID] will be provided in the "How to find contract address" guide below, with the assistance of the KEYRING NFT Viewer tool.

How to Top Up?

To initiate a top-up, please reach out to us to establish a link customized to display the top-up feature for a specific ERC-20 or ERC-1155 token, along with specifying quantity options for each transaction.

Furthermore, the seller (provider) should possess an EZ Wallet and ensure that the EZ Wallet Balance includes the requisite ERC-20, or ERC-1155 Tokens intended for top-ups on behalf of others.

ERC-20

Follow these steps to complete the Top-Up process:

  1. Access the customized EZ Wallet Top-Up link you've arranged.

  2. Connect the EZ Wallet's connection file containing the balance earmarked for top-ups.

  3. Select the desired top-up option.

  4. Confirm by clicking "Send."

  5. Prompt your customer/user to scan their card.

  6. Await completion of the transaction, and you're all set to proceed.

ERC-1155

Topping up ERC-1155 tokens operates similarly to ERC-20 tokens, with the main distinction being the contract used.

However, just like the process for ERC-20 tokens, you also need to register with us beforehand to receive the respective URL.

How to find the contract address?

ERC-20

Finding the contract address for ERC-20 tokens is actually pretty simple!

You can easily locate it on popular cryptocurrency websites like CoinMarketCap or CoinGecko. These sites are trusted by many and make it super easy to find the contract address you're looking for.

If you prefer using search engines like Google or Bing, it's just as easy. Just type in the name of the token and the blockchain it's on, and you'll have the contract address right at your fingertips.

ERC-1155

For ERC-1155 tokens, or simply put, NFT-1155, finding their contract addresses isn't difficult at all, thanks to the KEYRING NFT Viewer.

Through the KEYRING NFT Viewer website, you can quickly locate the contract of a specific NFT-1155 and even its ID.

One of the unique features of the KEYRING NFT Viewer is that you don't need to connect a wallet to view NFTs on a particular wallet address.

Here's how it works:

  1. Go to the KEYRING NFT Viewer website.

  2. Choose the blockchain and enter the wallet address where you want to view the NFT.

  3. Click the search icon.

  4. Select the NFT you want to view information about.

  5. Voilà! You can now see the NFT address, Token ID, and Token standard without any hassle.

What are the use cases?

  • Top Up:

Imagine you're shopping at a store, and you receive a discount if you own a certain amount of NFTs, but you don't have enough.

This Top Up feature will help you easily solve that problem.

  • Ticket Sales:

When you organize an event that requires tickets for entry, we can sell tickets through this method instead of physical tickets.

This will be even more convenient when combined with the Balance Checker feature.

What can I use to pay for the top up?

When you use the top-up feature, the payment options depend on what the seller accepts. Sellers can choose to receive different things like cash, tokens, or even physical items.

It's all about what they're comfortable with.

Last updated