A pre-built solution for verifying wallet balances

The Wallet Balance task type offers a convenient mechanism for verifying holders of a particular token using a pre-built solution. However, this solution is not universally applicable across all networks. See below to learn about this task type, its limitations, and how it can be set up.

<aside> <img src="https://prod-files-secure.s3.us-west-2.amazonaws.com/046d56bb-337c-428c-ba45-93717675a29f/44746536-e16d-4400-be7a-0e61592d1c40/Round_Gradient_Background_(1).png" alt="https://prod-files-secure.s3.us-west-2.amazonaws.com/046d56bb-337c-428c-ba45-93717675a29f/44746536-e16d-4400-be7a-0e61592d1c40/Round_Gradient_Background_(1).png" width="40px" />

Course Navigation

  1. Course Introduction
  2. Task verification on Galxe: How does it work?
  3. What kinds of onchain tasks can be verified on Galxe Quest?
  4. Onchain task types on Galxe Quest
    1. NFT Holder tasks
    2. Snapshot Vote tasks
    3. Wallet Balance tasks - Current Page
    4. Contract Query tasks
    5. Import Your Own Data tasks
      1. Import Your Own Data task set up requirements
      2. Setting up Import Your Own Data Tasks
  5. Strategy considerations for onchain tasks
  6. Troubleshooting and resolving common issues with onchain tasks
  7. Course Completion and Certification </aside>

The Wallet Balance task type - how it works

A tour of the Wallet Balance task type and its features

A tour of the Wallet Balance task type and its features

The Wallet Balance task type on Galxe Quest is a pre-built solution for verifying token balances held in a particular wallet. When a quest participant clicks the verify button of a Wallet Balance task, Galxe verifies the task by comparing two relevant data points. The first data point is the EVM wallet address bound to the user’s Galxe Account. The second point of comparison is wallet balance data pulled by querying the token’s Smart Contract: the current balance if the snapshot option is left unactivated in the task, and the balance at a certain time if the snapshot option in activated. If the returned balance meets the requirements set in the task, the task verification will succeed. If the balance does meet the task requirements, the task verification will fail.

Limitations of the Wallet Balance task type

The Wallet Balance task type currently supports task verification on Ethereum. If you would like to verify holders of tokens on other networks, it is recommended that you use either Contract Query or Import Your Own Data task types, covered in later sections of this course.

What is required to set up a Wallet Balance task

Wallet Balance task set up differs based on which token on Ethereum you would like to verify the balance of as a task in your quest.

For USDT or USDC tokens on Ethereum, the Wallet Balance task can be set up simply from pre-set options, without the need for any additional information.

For other tokens on Ethereum, you will need to input the token’s contract address. The token’s contract address can be found on Etherscan, Ethereum’s Block Explorer. For example, the contract address for $G on Ethereum can be found at this Etherscan page. For more information about how to find a token’s contract address, please refer to this guide from MetaMask.

Setting up a Wallet Balance task

Wallet Balance task set up on Galxe Quest

Wallet Balance task set up on Galxe Quest

You can set up a Wallet Balance task on Galxe Quest through the following steps (shown also in the video above):

  1. Navigate to step 3, Task Settings, in Galxe’s quest creation process
  2. Select the On-Chain task type category if it is not selected already
  3. Click Wallet Balance to generate the task set up fields
  4. Choose how you would like to provide the Token Info, either through Select (for USDT or USDC), or Paste the contract by clicking the corresponding radio button
  5. Input the necessary fields
    1. For USDC or USDT on Ethereum, select Ethereum from the Select chain dropdown menu and the desired token from the Please select token dropdown menu
    2. For other tokens, select Ethereum from the Select chain dropdown menu and input the contract address to the Paste contract address field