alice53211/arc-fintech-app

This repository is a sample application that demonstrates how to manage money across multiple blockchains from one dashboard, built with Next.js and Supabase. It uses Circle's Developer Controlled Wallets service to handle wallets across chains, Circle Gateway to show a single combined USDC balance no matter which chain the funds sit on, and a bridging tool from Circle to move assets between supported chains. The README describes it as a demonstration project rather than a finished product. The dashboard updates itself automatically as money moves. When a transaction happens, Circle sends a webhook notification that updates a row in the Supabase database, and Supabase's real time feature then pushes that change straight to the browser without needing a page refresh. Because Circle needs to reach the app over the public internet to deliver these webhooks, local development requires a tunneling tool such as ngrok pointed at the local server. An optional Redis connection can speed up balance lookups, since checking a balance normally means calling out to several services and blockchain nodes at once. With Redis, those responses are cached briefly and instantly cleared whenever a webhook reports that funds actually moved, and duplicate webhook deliveries are filtered out quickly before they reach the database. If Redis is not configured, the app still works, just without this caching layer. To run the project, someone needs Node.js version 22 or newer, the Supabase command line tool, Docker Desktop if running Supabase locally, and a Circle API key with an entity secret from Circle's developer console. Setup involves copying an example environment file and filling in values for Supabase, Circle, the webhook endpoint URL, and optionally Redis. On first visit, any email and password can be used to create an account. The README states plainly that this sample application assumes testnet use only, stores secrets through environment variables, and is not meant for production use without further changes.