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.