[Nanobot] Task #spider_gh_bounty_9: Title: Build a DAO Treasury Reporting Ag...

[yuzengbaao]

自动化提交说明

• Task ID: spider_gh_bounty_9
• Source bounty: Title: Build a DAO Treasury Reporting Ag...
• Submission file: nanobot_submissions/task_spider_gh_bounty_9_1772941450.md

此 PR 由 AGI-Life-Engine 的 GitHub_PR_Submitter 技能自动创建，用于链上任务审核。

[Copilot]

Pull request overview

Adds an automated Nanobot submission Markdown file for task #spider_gh_bounty_9, describing a proposed “DAO Treasury Reporting Agent” implementation and including an inline diff snippet.

Changes:

• Added a new submission document under nanobot_submissions/ for bounty task spider_gh_bounty_9.
• Included an inline (non-applied) patch proposing TreasuryReportingAgent.ts and related modules.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This submission claims to add TreasuryReportingAgent.ts, TxAnalyzer.ts, and ReportFormatter.ts, but the PR only adds this Markdown file and no TypeScript source files (there is also no src/ directory in the repo). Either include the actual implementation files in the PR under the correct repo paths, or update the Summary/Changes/Patch sections to reflect what is actually being delivered.

[Copilot]

The code snippet uses ethers v5 APIs/types (ethers.providers.Provider, ethers.utils.formatUnits). This repo depends on ethers v6 (see package.json), where these namespaces have changed, so the shown implementation would not compile as-is. Update the snippet/implementation to ethers v6 equivalents (provider types and formatUnits usage).

[Copilot]

The snippet imports ../utils/priceOracle, ./TxAnalyzer, and ./ReportFormatter, but there are no corresponding modules in this repository. Add these modules (or adjust imports to existing utilities) so the agent can be built and executed.

[Copilot]

parseFloat(formatUnits(...)) will lose precision for large token balances and can materially skew USD totals/percentages. Consider keeping values as strings/BigInt and using a decimal/bignumber library for arithmetic, only formatting to number/string at the final presentation step.

[Copilot]

runwayMonths divides by burnRate without handling the zero-spend case (and totalHoldingsUsd could also be 0), which can yield Infinity/NaN in the report output. Add explicit handling for burnRate <= 0 (and/or totalHoldingsUsd <= 0) so the runway field is deterministic and meaningful.

[Copilot]

The shown patch targets src/agents/TreasuryReportingAgent.ts and defines an exported class, but this repo’s agent implementations appear to live under services/agents/src/agents/ and follow the export const manifest / export const handler pattern (e.g., services/agents/src/agents/treasury-manager.ts, balance-scanner.ts). To integrate with the existing agent runner, the implementation should match that location/shape instead of introducing a new src/agents structure.

Suggested change

	diff --git a/src/agents/TreasuryReportingAgent.ts b/src/agents/TreasuryReportingAgent.ts
	new file mode 100644
	--- /dev/null
	+++ b/src/agents/TreasuryReportingAgent.ts
	@@ -0,0 +1,58 @@
	+import { ethers } from 'ethers';
	+import { getPrices } from '../utils/priceOracle';
	+import { parseSpending } from './TxAnalyzer';
	+import { generateMarkdown } from './ReportFormatter';
	+
	+export class TreasuryReportingAgent {
	+ constructor(
	+ private provider: ethers.providers.Provider,
	+ private treasuryAddress: string,
	+ private assets: { symbol: string; address: string; decimals: number }[]
	+ ) {}
	+
	+ public async executeReport(): Promise<string> {
	+ // 1. Holdings Breakdown
	+ let totalHoldingsUsd = 0;
	+ const holdings = [];
	+ const prices = await getPrices(this.assets.map(a => a.symbol));
	+
	+ for (const asset of this.assets) {
	+ const contract = new ethers.Contract(asset.address, ['function balanceOf(address) view returns (uint256)'], this.provider);
	+ const rawBalance = await contract.balanceOf(this.treasuryAddress);
	+ const balance = parseFloat(ethers.utils.formatUnits(rawBalance, asset.decimals));
	+
	+ const usdValue = balance * prices[asset.symbol];
	+ totalHoldingsUsd += usdValue;
	+ holdings.push({ symbol: asset.symbol, usdValue });
	+ }
	+
	+ // Calculate percentages
	+ const holdingsBreakdown = holdings.map(h => ({
	+ ...h,
	+ percentage: ((h.usdValue / totalHoldingsUsd) * 100).toFixed(1)
	+ }));
	+
	+ // 2. Spending Analysis (Last 30 Days)
	+ const { totalSpent, categories } = await parseSpending(this.provider, this.treasuryAddress, 30);
	+ const burnRate = totalSpent;
	+
	+ // 3. Runway Projection
	+ const runwayMonths = (totalHoldingsUsd / burnRate).toFixed(1);
	+
	+ // 4. Generate Output
	+ return generateMarkdown({
	+ date: new Date(),
	+ totalHoldings: totalHoldingsUsd,
	+ holdingsBreakdown,
	+ burnRate,
	+ runway: runwayMonths,
	+ spending: categories
	+ });
	+ }
	+}
	diff --git a/services/agents/src/agents/treasury-reporting.ts b/services/agents/src/agents/treasury-reporting.ts
	new file mode 100644
	--- /dev/null
	+++ b/services/agents/src/agents/treasury-reporting.ts
	@@ -0,0 +1,72 @@
	+import { ethers } from 'ethers';
	+import { getPrices } from '../utils/priceOracle';
	+import { parseSpending } from './TxAnalyzer';
	+import { generateMarkdown } from './ReportFormatter';
	+
	+type AssetConfig = {
	+ symbol: string;
	+ address: string;
	+ decimals: number;
	+};
	+
	+export const manifest = {
	+ name: 'treasury-reporting',
	+ displayName: 'Treasury Reporting Agent',
	+ description:
	+ 'Queries on-chain balances across treasury contracts, categorizes spending, and computes burn rate and runway.',
	+};
	+
	+type HandlerArgs = {
	+ provider: ethers.providers.Provider;
	+ treasuryAddress: string;
	+ assets: AssetConfig[];
	+};
	+
	+export const handler = async (args: HandlerArgs): Promise<string> => {
	+ const { provider, treasuryAddress, assets } = args;
	+
	+ // 1. Holdings Breakdown
	+ let totalHoldingsUsd = 0;
	+ const holdings: { symbol: string; usdValue: number }[] = [];
	+ const prices = await getPrices(assets.map(a => a.symbol));
	+
	+ for (const asset of assets) {
	+ const contract = new ethers.Contract(
	+ asset.address,
	+ ['function balanceOf(address) view returns (uint256)'],
	+ provider
	+ );
	+ const rawBalance = await contract.balanceOf(treasuryAddress);
	+ const balance = parseFloat(ethers.utils.formatUnits(rawBalance, asset.decimals));
	+
	+ const usdValue = balance * prices[asset.symbol];
	+ totalHoldingsUsd += usdValue;
	+ holdings.push({ symbol: asset.symbol, usdValue });
	+ }
	+
	+ // Calculate percentages
	+ const holdingsBreakdown = holdings.map(h => ({
	+ ...h,
	+ percentage: ((h.usdValue / totalHoldingsUsd) * 100).toFixed(1),
	+ }));
	+
	+ // 2. Spending Analysis (Last 30 Days)
	+ const { totalSpent, categories } = await parseSpending(provider, treasuryAddress, 30);
	+ const burnRate = totalSpent;
	+
	+ // 3. Runway Projection
	+ const runwayMonths = burnRate > 0 ? (totalHoldingsUsd / burnRate).toFixed(1) : '∞';
	+
	+ // 4. Generate Output
	+ return generateMarkdown({
	+ date: new Date(),
	+ totalHoldings: totalHoldingsUsd,
	+ holdingsBreakdown,
	+ burnRate,
	+ runway: runwayMonths,
	+ spending: categories,
	+ });
	+};