Fix code mixup with arc-multichain-wallet. (#3)

Author: akelani-circle

.env.example

@@ -1,7 +1,13 @@
 # Supabase
-NEXT_PUBLIC_SUPABASE_URL=your-project-url
-NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=your-publishable-or-anon-key
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_PUBLISHABLE_OR_ANON_KEY=
+SUPABASE_SERVICE_ROLE_KEY=
 
 # Circle
-CIRCLE_API_KEY=your-circle-api-key
-CIRCLE_ENTITY_SECRET=your-circle-entity-secret
+CIRCLE_API_KEY=
+CIRCLE_ENTITY_SECRET=
+CIRCLE_BLOCKCHAIN=ARC-TESTNET
+CIRCLE_USDC_TOKEN_ID=
+
+# Misc
+ADMIN_EMAIL=admin@admin.com

.github/workflows/ci.yml

@@ -15,11 +15,8 @@ jobs:
       - name: Install Node
         uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
 
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-
       - name: Install dependencies
-        run: pnpm install
+        run: npm install
 
   scan:
     needs: lint-and-test

.gitignore

@@ -38,8 +38,9 @@ yarn-error.log*
 # vercel
 .vercel
 
+# supabase
+supabase/.temp/
+
 # typescript
 *.tsbuildinfo
 next-env.d.ts
-
-.vscode/

README.md

@@ -1,72 +1,85 @@
-# Circle Gateway Multichain USDC
+# Arc Commerce
 
-This sample app demonstrates how to integrate USDC as a payment method for purchasing credits on Arc.
+This project demonstrates how to integrate USDC as a payment method for purchasing credits on Arc.
 
-### Install dependencies
+## Table of Contents
 
-```bash
-# Install dependencies
-pnpm install
+- [Clone and Run Locally](#clone-and-run-locally)
+- [Environment Variables](#environment-variables)
 
-# Configure environment variables
-cp .env.example .env.local
-```
+## Clone and Run Locally
 
-Update `.env.local`:
+1. **Clone and install dependencies:**
 
-```ini
-# Supabase
-NEXT_PUBLIC_SUPABASE_URL=your-project-url
-NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=your-publishable-or-anon-key
+   ```bash
+   git clone git@github.com:circlefin/arc-commerce.git
+   cd top-up
+   npm install
+   ```
 
-# Circle
-CIRCLE_API_KEY=your-circle-api-key
-CIRCLE_ENTITY_SECRET=your-circle-entity-secret
-```
+2. **Set up environment variables:**
 
-### Start Supabase
+   ```bash
+   cp .env.example .env.local
+   ```
 
-```bash
-pnpx supabase start
-```
+   Then edit `.env.local` and fill in all required values (see [Environment Variables](#environment-variables) section below).
 
-### Run Development Server
+3. **Start Supabase locally** (requires Docker):
 
-```bash
-pnpm run dev
-```
+   ```bash
+   npx supabase start
+   npx supabase migration up
+   ```
 
-Visit [http://localhost:3000/wallet](http://localhost:3000/wallet)
+4. **Start the development server:**
 
-## How It Works
+   ```bash
+   npm run dev
+   ```
 
-### Unified Balance
+   The app will be available at [http://localhost:3000](http://localhost:3000/). The admin wallet will be automatically created on first startup.
 
-When you deposit USDC to the Gateway Wallet, it becomes part of your unified balance accessible from any supported chain. The Gateway Wallet uses the same address on all chains: `0x0077777d7EBA4688BDeF3E311b846F25870A19B9`
+5. **Set up Circle Webhooks:**
 
-### Deposit Flow
+   In a separate terminal, start ngrok to expose your local server:
 
-1. Approve Gateway Wallet to spend your USDC
-2. Call `deposit()` to transfer USDC to Gateway
-3. Balance becomes available across all chains after finalization
+   ```bash
+   ngrok http 3000
+   ```
 
-### Cross-Chain Transfer Flow
+   Copy the HTTPS URL from ngrok (e.g., `https://your-ngrok-url.ngrok.io`) and add it to your Circle Console webhooks section:
+   - Navigate to Circle Console → Webhooks
+   - Add a new webhook endpoint: `https://your-ngrok-url.ngrok.io/api/circle/webhook`
+   - Keep ngrok running while developing to receive webhook events
 
-1. Create and sign burn intent (EIP-712)
-2. Submit to Gateway API for attestation
-3. Call `gatewayMint()` on destination chain
-4. USDC minted on destination
+## Environment Variables
 
-## Security Notes
+Copy `.env.example` to `.env.local` and fill in the required values:
 
-- This is a **testnet demonstration** only
-- Private keys are processed server-side and never stored
-- Never use mainnet private keys with this application
-- Always use HTTPS in production
-- Consider hardware wallet integration for production use
+```bash
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_PUBLISHABLE_OR_ANON_KEY=
+SUPABASE_SERVICE_ROLE_KEY=
 
-## Resources
+# Circle
+CIRCLE_API_KEY=
+CIRCLE_ENTITY_SECRET=
+CIRCLE_BLOCKCHAIN=ARC-TESTNET
+CIRCLE_USDC_TOKEN_ID=
+
+# Misc
+ADMIN_EMAIL=admin@admin.com
+```
 
-- [Circle Gateway Documentation](https://developers.circle.com/gateway)
-- [Unified Balance Guide](https://developers.circle.com/gateway/howtos/create-unified-usdc-balance)
-- [Circle Faucet](https://faucet.circle.com/)
+| Variable                              | Scope       | Purpose                                                                  |
+| ------------------------------------- | ----------- | ------------------------------------------------------------------------ |
+| `NEXT_PUBLIC_SUPABASE_URL`            | Public      | Supabase project URL.                                                    |
+| `NEXT_PUBLIC_SUPABASE_PUBLISHABLE_OR_ANON_KEY` | Public | Supabase anonymous/public key.                                           |
+| `SUPABASE_SERVICE_ROLE_KEY`           | Server-side | Service role for privileged writes (e.g., transaction inserts).          |
+| `CIRCLE_API_KEY`                      | Server-side | Used to fetch Circle webhook public keys for signature verification.     |
+| `CIRCLE_ENTITY_SECRET`                | Server-side | Circle entity secret for wallet operations.                              |
+| `CIRCLE_BLOCKCHAIN`                   | Server-side | Blockchain network identifier (e.g., "ARC-TESTNET").                     |
+| `CIRCLE_USDC_TOKEN_ID`                | Server-side | USDC token ID for the specified blockchain.                              |
+| `ADMIN_EMAIL`                         | Server-side | Admin user email address.                                                |