Top Up Gas Tank
There are three methods available for topping up the gas tank:
- API: Organizations can use the API to submit top-up requests, including the necessary signatures and transaction hashes.
- Dashboard Interface: Organizations can also top up their gas tank through the dashboard interface, which provides a user-friendly way to manage gas tank balances.
- Faucet (Development Only): In the development environment, you can also use the faucet to claim free gas tank balance (once per 24 hours, $20 per claim).
Summary:
- The Organization gas tank can be topped up using the API, Dashboard Interface, and (in the development environment) the Faucet.
- The Individual gas tank can only be topped up using the API.
1. API Method for Top Up Gas Tank
The process for topping up the gas tank involves the following steps:
-
On-Chain USDT Transfer
- Organization transfers USDT to the Xellar pool contract on the respective network
- This is currently the only supported top-up method
-
Message Signing
- After transfer, organization must sign a message using personalSign
- The signing wallet must be the same one used for the USDT transfer
- Message format:
${chainId}.${txHash}
- Example: If chainId is 137 and txHash is "0x123...", message would be "137.0x123..."
-
Top Up Submission
- Submit both the signature and transaction hash to the API
- Organization can specify whether to top up:
- Individual gas tank
- Organization gas tank
-
Important Notes
- Each transfer transaction can only be used once for top-up
- The signature must come from the wallet that executed the USDT transfer
- Invalid signatures or reused transactions will be rejected
2. Dashboard Interface for Top Up Gas Tank
Before proceeding with the top-up process through the dashboard interface, ensure that you have:
- Sufficient USDT Balance: Make sure your wallet has enough USDT to cover the top-up amount you wish to add to your gas tank.
- Enough Native Tokens: Ensure you have enough native tokens (e.g., ETH, MATIC) in your wallet to cover the gas fees associated with the transaction.
This will help ensure a smooth and successful top-up process.