donation-tracker

Track donation transactions and retrieve donor histories on GaiaLink blockchain integrations.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/Gaia-Link/GaiaLink --skill donation-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: donation-tracker
Source: https://github.com/Gaia-Link/GaiaLink/tree/main/python_agent/gaia_link/skills/donation-tracker
Command: npx skills add https://github.com/Gaia-Link/GaiaLink --skill donation-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gaia_link.config, gaia_link.services.blockchain.gaia_proposal, and includes scripts (resource) components.

What problem does it solve?

這個技能讓捐款交易的狀態可追蹤與歷史查詢,提升透明度與審計能力。

Core Features & Use Cases

  • 交易追蹤:提供交易狀態、區塊確認數,並給出區塊瀏覽器連結。
  • 捐款歷史查詢:根據錢包地址列出捐款記錄、支援時間範圍過濾與總額統計。
  • 兼容 GaiaLink 的區塊鏈服務:在服務可用時查詢,服務不可用時回退至模擬資料。

Quick Start

Provide a transaction hash to track a donation, e.g. {"tx_hash": "0x..."} or provide a wallet address to fetch history, e.g. {"wallet_address": "0x..."}.

Frequently Asked Questions about donation-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track an Ethereum donation transaction on-chain?

To track an Ethereum donation transaction, provide a valid transaction hash like {"tx_hash": "0x..."}. The tool validates the hash and retrieves on-chain status, block confirmations, and a block explorer link for that specific donation.

Can I query donation history for a specific wallet address?

Yes, you can query donation history for a wallet address by providing {"wallet_address": "0x..."}. It retrieves donor records for fundraising campaigns, validates the Ethereum address, supports optional time-range filtering, and calculates donation totals.

What happens if the GaiaLink blockchain service is unavailable?

If the GaiaLink blockchain service is unavailable, the donation tracker gracefully falls back to mock data. It attempts to use the GaiaProposal service for live on-chain queries first, ensuring continuous functionality during service interruptions.

Does the donation tracker support time-range filtering for transaction history?

Yes, the donation tracker supports optional time-range filtering when querying wallet-wide donation histories. This allows you to narrow down fundraising campaign records and calculate totals for specific periods using validated Ethereum addresses.

Do I need the GaiaProposal service to retrieve on-chain donation status?

No, the GaiaProposal service is optional. The donation tracker uses GaiaProposal when available to fetch live on-chain status and confirmations, but automatically falls back to mock data if the dependency is missing or unavailable.

What is the best way to audit donation totals for a fundraising campaign?

The best way to audit donation totals is to query by wallet address using {"wallet_address": "0x..."}. This retrieves the full donation history, validates Ethereum addresses, applies time-range filtering, and aggregates totals for transparent campaign auditing.