feat: On-Chain Airdrop checker [WIP]

[notJoon]

Description

Implements a basic airdrop checker functionality. The implementation follows a "Reader-only realm" pattern and provides simple APIs for checking token balances and total supply.

WIP

Key Changes

• Add TotalSupply() method to get total supply of a specific denomination
• Add AddressBalance() method to get balance of an address for a specific denomination

[Gno2D2]

🛠 PR Checks Summary

All Automated Checks passed. ✅

Manual Checks (for Reviewers):

• IGNORE the bot requirements for this PR (force green CI check)

Read More

🤖 This bot helps streamline PR reviews by verifying automated checks and providing guidance for contributors and reviewers.

✅ Automated Checks (for Contributors):

🟢 Maintainers must be able to edit this pull request (more info)
🟢 Pending initial approval by a review team member, or review from tech-staff

☑️ Contributor Actions:

1. Fix any issues flagged by automated checks.
2. Follow the Contributor Checklist to ensure your PR is ready for review.
   • Add new tests, or document why they are unnecessary.
   • Provide clear examples/screenshots, if necessary.
   • Update documentation, if required.
   • Ensure no breaking changes, or include BREAKING CHANGE notes.
   • Link related issues/PRs, where applicable.

☑️ Reviewer Actions:

1. Complete manual checks for the PR, including the guidelines and additional checks if applicable.

📚 Resources:

• Report a bug with the bot.
• View the bot’s configuration file.

Debug

Automated Checks

Maintainers must be able to edit this pull request (more info)

If

🟢 Condition met
└── 🟢 And
    ├── 🟢 The base branch matches this pattern: ^master$
    └── 🟢 The pull request was created from a fork (head branch repo: notJoon/gno-core)

Then

🟢 Requirement satisfied
└── 🟢 Maintainer can modify this pull request

Pending initial approval by a review team member, or review from tech-staff

If

🟢 Condition met
└── 🟢 And
    ├── 🟢 The base branch matches this pattern: ^master$
    └── 🟢 Not (🔴 Pull request author is a member of the team: tech-staff)

Then

🟢 Requirement satisfied
└── 🟢 If
    ├── 🟢 Condition
    │   └── 🟢 Or
    │       ├── 🔴 At least 1 user(s) of the organization reviewed the pull request (with state "APPROVED")
    │       ├── 🟢 At least 1 user(s) of the team tech-staff reviewed pull request
    │       └── 🟢 This pull request is a draft
    └── 🟢 Then
        └── 🟢 Not (🔴 This label is applied to pull request: review/triage-pending)

Manual Checks

**IGNORE** the bot requirements for this PR (force green CI check)

If

🟢 Condition met
└── 🟢 On every pull request

Can be checked by

• Any user with comment edit permission

[codecov]

Codecov Report

Attention: Patch coverage is 80.00000% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
gno.land/pkg/sdk/vm/builtins.go	80.00%	1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

[leohhhn]

If you add TotalSupply in this PR, just linking this PR as well for the docs: #2661

[moul]

can we stop using the term "airdrop" for this feature (PR title, and a unit test having the term in the title); this PR isn't an airdrop checker, but a balance checker.

[moul]

can we have this API instead, and always use a readonly banker?

Suggested change

	func TotalSupply(banker std.Banker, denom string) int64 {
	func TotalSupply(denom string) int64 {

[moul]

homepage should give some information, and provide default links so that we can try the features with just a few clicks.

[moul]

back is already available in the navigation breadcrumb.

[moul]

remove this, we should use the navigation breadcrumb for this.

[moul]

why do we need to initialize a banker from this realm?

(if there is a good reason, why not a readonly one?)

[moul]

Not scalable. We need to find a more efficient solution, or we should refrain from offering this feature for now.

[moul]

check comments.