crazywriter1/arcvault

ArcVault is an autonomous AI assistant designed to manage a small business's stablecoin treasury on Arc Network, a blockchain network, using plain natural language commands instead of technical interfaces. Instead of clicking through a complicated dashboard, a business owner could type something like "transfer 50 USDC from Treasury to Savings" and the assistant carries out the action. The system is built from a frontend built with Next.js that provides a dashboard, a chat window, and a rule builder, and a backend built with Express that handles the actual work. The backend talks to Circle's API to manage programmable wallets, reads blockchain data through the Arc testnet, and uses either Google's Gemini or Groq's hosted AI models to understand the natural language commands. A rule engine and scheduler, running on a cron style timer, allow the assistant to watch for conditions and act automatically, for example sending an alert if a treasury balance drops below a certain amount, or moving funds automatically according to a set schedule. Setup requires creating API keys for Circle and for either Gemini or Groq, then running separate install and startup commands for the backend and frontend. The project includes a step to register an Entity Secret with Circle and create the treasury and savings wallets before first use, plus a way to fund those wallets using a public testnet faucet. Example commands a user could type include checking wallet balances, transferring funds between wallets, setting up balance alerts, scheduling recurring transfers, and generating cashflow reports. For security, the project stores no bearer tokens in the browser, restricts which web addresses can talk to the backend, and automatically holds any transfer over 1000 USDC or EURC for manual approval rather than executing it right away. The rule engine is currently limited to test API keys only, and the README asks users to review all automated thresholds carefully before switching to a real, production key. Planned future work includes a bridge for moving funds from Ethereum's Sepolia test network, a Telegram bot for alerts, and support for multiple separate businesses.