budget-oracle

Multi-skill budget system for expense tracking, budget guardrails, and Pharos onchain financial logs. Use when a user or agent needs to record personal or business expenses, enforce spending limits, summarize weekly or monthly budgets, issue machine-readable warnings, or create a verifiable audit trail on Pharos Network. Includes expense-tracker, budget-guardian, and onchain-ledger sub-skills that can run independently or be chained.

Logs expense and income records as immutable onchain events on Pharos mainnet or Atlantic testnet. Creates a verifiable audit trail for businesses, DAOs, freelancers, and AI agent treasuries. Use when a user or agent needs to record a financial event on Pharos, verify a past transaction, retrieve an onchain expense summary, or set an onchain budget configuration. Requires PHAROS_PRIVATE_KEY in environment for live mode; falls back to simulated mode if not set.

Enforces budget limits and emits structured warnings when spending approaches or exceeds defined thresholds. Use when an agent needs to check whether a new expense is safe to add, audit current budget health, or route warning messages to a user or downstream alert system. Returns machine-readable warning codes that other skills can act on.

Tracks individual income and expenses for a given weekly or monthly period. Adds, removes, edits, and lists expense entries with live running totals and category breakdowns. Use when a user or agent needs to record a purchase, log an income source, view spending history, or get a categorized breakdown of expenses. Works offline with no wallet required.