Built for Locus · Powered by Telegraf + OpenClaw

Budget-aware Telegram agent for Locus wrapped APIs

Every API call is pre-priced, human-approved, and paid through the Locus wallet. The bot explains the spend, enforces allowances, and leaves an auditable trail.

Launch the Telegram bot →

Why teams use Locus Budget Broker

Real approvals

The bot quotes the wrapped Email Reputation cost (~$0.006), enforces allowance + reserve buffers, and requires an inline Approve tap before spend.

Wallet-native proofs

Every call is charged to wallet 0xdf17…cdaf. Balance deltas and Locus tx IDs are mirrored into data/locus-audit-log.jsonl.

Drop-in architecture

Single `npm install`, `.env`, and `npm run dev`. Built with Telegraf + TypeScript + the Locus wrapped API client.

How the flow works

Plan → User runs /check email@example.com. Bot estimates the wrapped API cost and displays allowance, wallet balance, and approval buttons.

Guard → Bot pulls /api/pay/balance, enforces allowance + reserve buffers, and aborts if spend would break policy.

Execute → On approval, bot hits /api/wrapped/abstract-email-reputation/check, computes before/after balances, and echoes the risk report.

Audit → JSONL entry captures intent ID, wallet, email checked, cost, balance delta, and summarized risk fields.

Proof bundle

Wallet & funding

Wallet: 0xdf17b4c0394ef7f231e1db629018a1189ff9cdaf
Gift code redeem tx: 0x8fbf…95dfb

Spend log

data/locus-audit-log.jsonl captures the latest email check (balance 10 → 9.994 USDC).

Docs

Architecture, safety policy, and submission pack live in docs/ — ready for judges.

Get started in under 60 seconds

Clone the repo, copy .env.example, plug your Locus + Telegram secrets, and run npm run dev. The README walks through every step.

View GitHub Read the proof →