@devbond/gc 1.0.0 → 2.0.0

package/dist/finance/action/treasury.d.ts

@@ -0,0 +1,26 @@
+/**
+ * treasury.ts — Treasury 能力探测与提款
+ *
+ * 负责检测 token 合约是否支持 withdrawToWallet（V2 能力），
+ * 以及执行 treasury → wallet 的稳定币提款。
+ */
+import { ethers } from "ethers";
+export interface TreasuryCapabilities {
+    /** Whether the contract supports withdrawToWallet */
+    hasWithdrawToWallet: boolean;
+}
+export interface WithdrawResult {
+    txHash: string;
+    amount: bigint;
+}
+/**
+ * Detect treasury capabilities by probing the token contract.
+ * Calls withdrawToWallet.staticCall(0) — if the contract has the function,
+ * it will revert with a "Goo:" validation error; if not, it reverts differently.
+ */
+export declare function detectTreasuryCapabilities(tokenAddress: string, provider: ethers.JsonRpcProvider): Promise<TreasuryCapabilities>;
+/**
+ * Withdraw stablecoin from treasury to the agent's wallet.
+ * Requires the contract to support withdrawToWallet (V2).
+ */
+export declare function withdrawFromTreasury(signer: ethers.Wallet, tokenAddress: string, amount: bigint, stableDecimals?: number): Promise<WithdrawResult>;

package/dist/finance/action/treasury.js

@@ -0,0 +1,46 @@
+/**
+ * treasury.ts — Treasury 能力探测与提款
+ *
+ * 负责检测 token 合约是否支持 withdrawToWallet（V2 能力），
+ * 以及执行 treasury → wallet 的稳定币提款。
+ */
+import { ethers } from "ethers";
+// ─── ABI (treasury-specific) ────────────────────────────────────────────
+const TREASURY_ABI = [
+    "function withdrawToWallet(uint256 amount)",
+    "function treasuryBalance() view returns (uint256)",
+    "function starvingThreshold() view returns (uint256)",
+];
+// ─── Functions ──────────────────────────────────────────────────────────
+/**
+ * Detect treasury capabilities by probing the token contract.
+ * Calls withdrawToWallet.staticCall(0) — if the contract has the function,
+ * it will revert with a "Goo:" validation error; if not, it reverts differently.
+ */
+export async function detectTreasuryCapabilities(tokenAddress, provider) {
+    const contract = new ethers.Contract(tokenAddress, TREASURY_ABI, provider);
+    let hasWithdrawToWallet = false;
+    try {
+        await contract.withdrawToWallet.staticCall(0n).catch((err) => {
+            if (err.message.includes("Goo:")) {
+                hasWithdrawToWallet = true;
+            }
+        });
+    }
+    catch {
+        hasWithdrawToWallet = false;
+    }
+    return { hasWithdrawToWallet };
+}
+/**
+ * Withdraw stablecoin from treasury to the agent's wallet.
+ * Requires the contract to support withdrawToWallet (V2).
+ */
+export async function withdrawFromTreasury(signer, tokenAddress, amount, stableDecimals = 18) {
+    const contract = new ethers.Contract(tokenAddress, TREASURY_ABI, signer);
+    const tx = await contract.withdrawToWallet(amount);
+    const receipt = await tx.wait();
+    console.log(`[treasury] Withdrew ${ethers.formatUnits(amount, stableDecimals)} stable from treasury (tx: ${receipt.hash})`);
+    return { txHash: receipt.hash, amount };
+}
+//# sourceMappingURL=treasury.js.map

package/dist/finance/action/treasury.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treasury.js","sourceRoot":"","sources":["../../../src/finance/action/treasury.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,2EAA2E;AAE3E,MAAM,YAAY,GAAG;IACnB,2CAA2C;IAC3C,mDAAmD;IACnD,qDAAqD;CACtD,CAAC;AAcF,2EAA2E;AAE3E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,YAAoB,EACpB,QAAgC;IAEhC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE3E,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;YAClE,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,mBAAmB,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAqB,EACrB,YAAoB,EACpB,MAAc,EACd,iBAAyB,EAAE;IAE3B,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACzE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,CACT,uBAAuB,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,8BAA8B,OAAO,CAAC,IAAI,GAAG,CAC/G,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/dist/finance/action/x402.d.ts

@@ -0,0 +1,124 @@
+/**
+ * x402.ts — x402 支付协议：Permit2 签名、payment header 组装、402 编排
+ *
+ * 当上游服务返回 402 Payment Required 时，负责完成 x402 协议全流程：
+ * 解析 402 响应 → 签名 Permit2 → 组装 payment-signature header → 重试请求 → 读取结算信息。
+ *
+ * 这是 x402 的唯一业务入口；llm-client / pay-bills 等调用方统一通过此模块。
+ */
+import { ethers } from "ethers";
+import type { SpendManager, SpendCategory } from "../spend.js";
+export declare const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+export declare const X402_PERMIT2_PROXY = "0x402085c248EeA27D92E8b30b2C58ed07f9E20001";
+export declare const PERMIT2_WITNESS_TYPES: {
+    PermitWitnessTransferFrom: {
+        name: string;
+        type: string;
+    }[];
+    TokenPermissions: {
+        name: string;
+        type: string;
+    }[];
+    Witness: {
+        name: string;
+        type: string;
+    }[];
+};
+export interface X402PaymentParams {
+    /** 支付网络，如 "eip155:56" */
+    network: string;
+    /** 支付资产地址 */
+    asset: string;
+    /** 支付金额（wei 或最小单位字符串） */
+    amount: string;
+    /** 收款方地址（x402 payTo） */
+    payTo: string;
+    /** 可选：超时秒数 */
+    maxTimeoutSeconds?: number;
+}
+export interface X402SignedResult {
+    from: string;
+    signature: string;
+    permit2Authorization: Record<string, unknown>;
+}
+export interface X402PaymentResult {
+    success: boolean;
+    response?: Response;
+    /** 支付金额（来自 402 response 的 accepts[0].amount） */
+    amount?: string;
+    settlement?: X402Settlement;
+    error?: string;
+}
+export interface X402Settlement {
+    txHash?: string;
+    payer?: string;
+}
+/** Parsed 402 response body */
+export interface X402ResponseBody {
+    x402Version?: number;
+    resource?: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    accepts?: Array<{
+        scheme: string;
+        network: string;
+        asset: string;
+        amount: string;
+        payTo: string;
+        maxTimeoutSeconds?: number;
+        extra?: {
+            name?: string;
+            version?: string;
+        };
+    }>;
+}
+/**
+ * Sign a Permit2 PermitWitnessTransferFrom for x402 payment.
+ * Pure function — only needs an ethers.Wallet signer and payment params.
+ */
+export declare function signPermit2(signer: ethers.Wallet, params: X402PaymentParams): Promise<X402SignedResult>;
+/**
+ * Build base64-encoded payment-signature header from signed Permit2 data.
+ */
+export declare function buildPaymentHeader(signed: X402SignedResult, opts: {
+    x402Version: number;
+    network: string;
+    resource?: unknown;
+    accepted?: unknown;
+}): string;
+/**
+ * Parse a 402 response body to extract payment requirements.
+ */
+export declare function parseX402Response(body: X402ResponseBody): {
+    requirements: X402PaymentParams;
+    x402Version: number;
+    resource?: unknown;
+};
+/**
+ * Read settlement info from response headers (x-bsc-llm-router-tx / payer).
+ */
+export declare function readSettlement(res: Response): X402Settlement;
+/**
+ * Handle a complete HTTP 402 flow:
+ * 1. Parse 402 response body for payment requirements
+ * 2. Sign Permit2 authorization
+ * 3. Build payment-signature header
+ * 4. Retry the original request with the header
+ * 5. Validate retry response (reject if still 402)
+ * 6. Read settlement info from response headers
+ *
+ * This is the single entry point for x402 payment handling.
+ */
+export declare function handleHttpX402(signer: ethers.Wallet, res402: Response, retry: (paymentHeader: string) => Promise<Response>, spend?: {
+    manager: SpendManager;
+    category: SpendCategory;
+}): Promise<X402PaymentResult>;
+/** Alias for signPermit2. */
+export declare function signX402Payment(signer: ethers.Wallet, params: X402PaymentParams): Promise<X402SignedResult>;
+/**
+ * Simple callback-based 402 handler for non-HTTP contexts (e.g. pay-bills).
+ * Signs, builds the payment header, and passes it to the callback.
+ */
+export declare function handleX402Payment(signer: ethers.Wallet, params: X402PaymentParams, retryWithHeader: (paymentHeader: string) => Promise<unknown>, x402Version?: number): Promise<X402PaymentResult>;

package/dist/finance/action/x402.js

@@ -0,0 +1,200 @@
+/**
+ * x402.ts — x402 支付协议：Permit2 签名、payment header 组装、402 编排
+ *
+ * 当上游服务返回 402 Payment Required 时，负责完成 x402 协议全流程：
+ * 解析 402 响应 → 签名 Permit2 → 组装 payment-signature header → 重试请求 → 读取结算信息。
+ *
+ * 这是 x402 的唯一业务入口；llm-client / pay-bills 等调用方统一通过此模块。
+ */
+import { ethers } from "ethers";
+// ─── Permit2 constants ──────────────────────────────────────────────────
+export const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+export const X402_PERMIT2_PROXY = "0x402085c248EeA27D92E8b30b2C58ed07f9E20001";
+export const PERMIT2_WITNESS_TYPES = {
+    PermitWitnessTransferFrom: [
+        { name: "permitted", type: "TokenPermissions" },
+        { name: "spender", type: "address" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" },
+        { name: "witness", type: "Witness" },
+    ],
+    TokenPermissions: [
+        { name: "token", type: "address" },
+        { name: "amount", type: "uint256" },
+    ],
+    Witness: [
+        { name: "to", type: "address" },
+        { name: "validAfter", type: "uint256" },
+    ],
+};
+// ─── Low-level helpers ──────────────────────────────────────────────────
+/**
+ * Sign a Permit2 PermitWitnessTransferFrom for x402 payment.
+ * Pure function — only needs an ethers.Wallet signer and payment params.
+ */
+export async function signPermit2(signer, params) {
+    const now = Math.floor(Date.now() / 1000);
+    const chainId = parseInt(params.network.split(":")[1], 10);
+    const deadline = now + (params.maxTimeoutSeconds || 300);
+    const validAfter = now - 600;
+    const nonceBytes = ethers.randomBytes(32);
+    const nonce = ethers.toBigInt(nonceBytes);
+    const domain = {
+        name: "Permit2",
+        verifyingContract: PERMIT2_ADDRESS,
+        chainId,
+    };
+    const message = {
+        permitted: {
+            token: params.asset,
+            amount: BigInt(params.amount),
+        },
+        spender: X402_PERMIT2_PROXY,
+        nonce,
+        deadline: BigInt(deadline),
+        witness: {
+            to: params.payTo,
+            validAfter: BigInt(validAfter),
+        },
+    };
+    const signature = await signer.signTypedData(domain, PERMIT2_WITNESS_TYPES, message);
+    const permit2Authorization = {
+        from: signer.address,
+        spender: X402_PERMIT2_PROXY,
+        nonce: nonce.toString(),
+        deadline: String(deadline),
+        permitted: {
+            token: params.asset,
+            amount: params.amount,
+        },
+        witness: {
+            to: params.payTo,
+            validAfter: String(validAfter),
+        },
+    };
+    return { from: signer.address, signature, permit2Authorization };
+}
+/**
+ * Build base64-encoded payment-signature header from signed Permit2 data.
+ */
+export function buildPaymentHeader(signed, opts) {
+    const paymentPayload = {
+        x402Version: opts.x402Version,
+        scheme: "exact",
+        network: opts.network,
+        payload: {
+            permit2Authorization: signed.permit2Authorization,
+            signature: signed.signature,
+        },
+        resource: opts.resource,
+        accepted: opts.accepted,
+    };
+    return btoa(JSON.stringify(paymentPayload));
+}
+/**
+ * Parse a 402 response body to extract payment requirements.
+ */
+export function parseX402Response(body) {
+    const requirements = body.accepts?.[0];
+    if (!requirements) {
+        throw new Error("x402: No payment requirements in 402 response");
+    }
+    return {
+        requirements: {
+            network: requirements.network,
+            asset: requirements.asset,
+            amount: requirements.amount,
+            payTo: requirements.payTo,
+            maxTimeoutSeconds: requirements.maxTimeoutSeconds,
+        },
+        x402Version: body.x402Version ?? 2,
+        resource: body.resource,
+    };
+}
+/**
+ * Read settlement info from response headers (x-bsc-llm-router-tx / payer).
+ */
+export function readSettlement(res) {
+    return {
+        txHash: res.headers.get("x-bsc-llm-router-tx") ?? undefined,
+        payer: res.headers.get("x-bsc-llm-router-payer") ?? undefined,
+    };
+}
+// ─── Complete 402 orchestration ─────────────────────────────────────────
+/**
+ * Handle a complete HTTP 402 flow:
+ * 1. Parse 402 response body for payment requirements
+ * 2. Sign Permit2 authorization
+ * 3. Build payment-signature header
+ * 4. Retry the original request with the header
+ * 5. Validate retry response (reject if still 402)
+ * 6. Read settlement info from response headers
+ *
+ * This is the single entry point for x402 payment handling.
+ */
+export async function handleHttpX402(signer, res402, retry, spend) {
+    try {
+        // 1. Parse 402 body
+        const body = await res402.json();
+        const { requirements, x402Version, resource } = parseX402Response(body);
+        console.log(`  [x402] Payment required: ${requirements.amount} on ${requirements.network} → signing...`);
+        // 2. Sign
+        const signed = await signPermit2(signer, requirements);
+        // 3. Build header
+        const paymentHeader = buildPaymentHeader(signed, {
+            x402Version,
+            network: requirements.network,
+            resource,
+            accepted: body.accepts?.[0],
+        });
+        // 4. Retry with payment header
+        const retryRes = await retry(paymentHeader);
+        // 5. Validate
+        if (retryRes.status === 402) {
+            const errBody = await retryRes.text().catch(() => "");
+            throw new Error(`x402: Payment rejected after signing: ${errBody}`);
+        }
+        // 6. Read settlement
+        const settlement = readSettlement(retryRes);
+        if (settlement.txHash) {
+            console.log(`  [x402] Settled: payer=${settlement.payer} tx=${settlement.txHash}`);
+            // Record spend if manager provided
+            if (spend) {
+                try {
+                    spend.manager.record(spend.category, BigInt(requirements.amount), settlement.txHash);
+                }
+                catch { /* ignore recording errors */ }
+            }
+        }
+        return { success: true, response: retryRes, amount: requirements.amount, settlement };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, error: msg };
+    }
+}
+// ─── Convenience aliases ────────────────────────────────────────────────
+/** Alias for signPermit2. */
+export async function signX402Payment(signer, params) {
+    return signPermit2(signer, params);
+}
+/**
+ * Simple callback-based 402 handler for non-HTTP contexts (e.g. pay-bills).
+ * Signs, builds the payment header, and passes it to the callback.
+ */
+export async function handleX402Payment(signer, params, retryWithHeader, x402Version = 2) {
+    try {
+        const signed = await signPermit2(signer, params);
+        const paymentHeader = buildPaymentHeader(signed, {
+            x402Version,
+            network: params.network,
+        });
+        const response = await retryWithHeader(paymentHeader);
+        return { success: true, response: response };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, error: msg };
+    }
+}
+//# sourceMappingURL=x402.js.map

package/dist/finance/action/x402.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../../../src/finance/action/x402.ts"],"names":[],"mappings":"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"}

package/dist/finance/earn.d.ts

@@ -0,0 +1,49 @@
+/**
+ * earn.ts — Agent 收入管理
+ *
+ * 自持数据与持久化，负责记录、汇总 agent 的各类收入（pulse 奖励、invest 收益等），
+ * 用于 runway 与收支分析。
+ */
+export type EarnCategory = "pulse" | "invest" | "reward" | "other";
+export interface EarnEntry {
+    category: EarnCategory;
+    amount: string;
+    txHash?: string;
+    timestamp: string;
+    /** 可选说明，如 "pulse round #42" */
+    note?: string;
+}
+export interface EarningSummary {
+    total: bigint;
+    byCategory: Record<EarnCategory, bigint>;
+    entries: EarnEntry[];
+}
+export interface EarnManagerConfig {
+    dataDir: string;
+}
+/**
+ * 管理当前 agent 的收入：记录入账、按类别汇总、持久化收入日志。
+ */
+export declare class EarnManager {
+    private config;
+    private earnLog;
+    constructor(config: EarnManagerConfig);
+    /**
+     * 记录一笔收入。
+     */
+    record(category: EarnCategory, amount: bigint, txHash?: string, note?: string): void;
+    /**
+     * 获取收入汇总（总览与按类别）。
+     */
+    getSummary(): EarningSummary;
+    getEntries(): EarnEntry[];
+    getEntriesByCategory(category: EarnCategory): EarnEntry[];
+    /**
+     * 加载持久化收入日志。
+     */
+    load(): Promise<void>;
+    /**
+     * 持久化收入日志到 dataDir。
+     */
+    save(): Promise<void>;
+}

package/dist/finance/earn.js

@@ -0,0 +1,77 @@
+/**
+ * earn.ts — Agent 收入管理
+ *
+ * 自持数据与持久化，负责记录、汇总 agent 的各类收入（pulse 奖励、invest 收益等），
+ * 用于 runway 与收支分析。
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+// ─── EarnManager ───────────────────────────────────────────────────────
+const EARN_LOG_FILE = "wallet-earnings.json";
+/**
+ * 管理当前 agent 的收入：记录入账、按类别汇总、持久化收入日志。
+ */
+export class EarnManager {
+    config;
+    earnLog = [];
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * 记录一笔收入。
+     */
+    record(category, amount, txHash, note) {
+        this.earnLog.push({
+            category,
+            amount: amount.toString(),
+            txHash,
+            timestamp: new Date().toISOString(),
+            note,
+        });
+    }
+    /**
+     * 获取收入汇总（总览与按类别）。
+     */
+    getSummary() {
+        const byCategory = {
+            pulse: 0n,
+            invest: 0n,
+            reward: 0n,
+            other: 0n,
+        };
+        let total = 0n;
+        for (const entry of this.earnLog) {
+            const amt = BigInt(entry.amount);
+            byCategory[entry.category] += amt;
+            total += amt;
+        }
+        return { total, byCategory, entries: [...this.earnLog] };
+    }
+    getEntries() {
+        return [...this.earnLog];
+    }
+    getEntriesByCategory(category) {
+        return this.earnLog.filter((e) => e.category === category);
+    }
+    /**
+     * 加载持久化收入日志。
+     */
+    async load() {
+        try {
+            const raw = await readFile(join(this.config.dataDir, EARN_LOG_FILE), "utf-8");
+            const parsed = JSON.parse(raw);
+            this.earnLog = Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            this.earnLog = [];
+        }
+    }
+    /**
+     * 持久化收入日志到 dataDir。
+     */
+    async save() {
+        await mkdir(this.config.dataDir, { recursive: true });
+        await writeFile(join(this.config.dataDir, EARN_LOG_FILE), JSON.stringify(this.earnLog, null, 2));
+    }
+}
+//# sourceMappingURL=earn.js.map

package/dist/finance/earn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"earn.js","sourceRoot":"","sources":["../../src/finance/earn.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAyBjC,0EAA0E;AAE1E,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,WAAW;IAGF;IAFZ,OAAO,GAAgB,EAAE,CAAC;IAElC,YAAoB,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAEjD;;OAEG;IACH,MAAM,CACJ,QAAsB,EACtB,MAAc,EACd,MAAe,EACf,IAAa;QAEb,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,QAAQ;YACR,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;YACzB,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,UAAU,GAAiC;YAC/C,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;SACV,CAAC;QACF,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACjC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;YAClC,KAAK,IAAI,GAAG,CAAC;QACf,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,oBAAoB,CAAC,QAAsB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,EACxC,OAAO,CACR,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,EACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CACtC,CAAC;IACJ,CAAC;CACF"}

package/dist/finance/index.d.ts

@@ -0,0 +1,5 @@
+export { AgentWallet } from "./wallet.js";
+export type { GasRefillResult } from "./action/gas-refill.js";
+export { SpendManager, type SpendManagerConfig, type SpendCategory, type SpendEntry, type SpendingSummary, } from "./spend.js";
+export { EarnManager, type EarnCategory, type EarnEntry, type EarningSummary, type EarnManagerConfig, } from "./earn.js";
+export * from "./action/index.js";

package/dist/finance/index.js

@@ -0,0 +1,5 @@
+export { AgentWallet } from "./wallet.js";
+export { SpendManager, } from "./spend.js";
+export { EarnManager, } from "./earn.js";
+export * from "./action/index.js";
+//# sourceMappingURL=index.js.map

package/dist/finance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/finance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,EACL,YAAY,GAKb,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,GAKZ,MAAM,WAAW,CAAC;AAEnB,cAAc,mBAAmB,CAAC"}

package/dist/finance/spend.d.ts

@@ -0,0 +1,53 @@
+/**
+ * spend.ts — Agent 支出管理
+ *
+ * 自持数据与持久化，负责记录、汇总 agent 的各类支出（gas、llm、invest、other）。
+ */
+export type SpendCategory = "gas" | "llm" | "invest" | "other";
+export interface SpendEntry {
+    category: SpendCategory;
+    amount: string;
+    txHash?: string;
+    timestamp: string;
+}
+export interface SpendingSummary {
+    total: bigint;
+    byCategory: Record<SpendCategory, bigint>;
+    entries: SpendEntry[];
+}
+export interface SpendManagerConfig {
+    dataDir: string;
+}
+/**
+ * 管理当前 agent 的支出：记录、分类、汇总、持久化。
+ * 自持 spendLog 数据，不依赖 AgentWallet。
+ */
+export declare class SpendManager {
+    private config;
+    private spendLog;
+    constructor(config: SpendManagerConfig);
+    /**
+     * 记录一笔支出。
+     */
+    record(category: SpendCategory, amount: bigint, txHash?: string): void;
+    /**
+     * 获取当前支出汇总（按类别与总览）。
+     */
+    getSummary(): SpendingSummary;
+    /**
+     * 获取原始支出条目列表。
+     */
+    getEntries(): SpendEntry[];
+    /**
+     * 按类别筛选支出条目。
+     */
+    getEntriesByCategory(category: SpendCategory): SpendEntry[];
+    /**
+     * 从 dataDir 加载持久化的支出日志。
+     */
+    load(): Promise<void>;
+    /**
+     * 持久化支出日志到 dataDir。
+     */
+    save(): Promise<void>;
+}