[READY] Feature: Alfredpay Fiat Accounts

CLAUDE.md

@@ -18,6 +18,8 @@ This is a **Bun monorepo** using workspaces:
 
 ## Essential Commands
 
+> Always use `bun`- never `npm`, `yarn`, or `pnpm`. Run `bun lint:fix` after any code change.
+
 ```bash
 # Install all dependencies
 bun install
@@ -70,7 +72,7 @@ Phase metadata and valid transitions are stored in PostgreSQL and seeded via `se
 ### Frontend Architecture
 
 - **State**: Zustand stores (`stores/`) + React Context (`contexts/`)
-- **Forms**: React Hook Form with Yup validation
+- **Forms**: React Hook Form with Zod validation (not Yup)
 - **Data Fetching**: TanStack Query
 - **Routing**: TanStack Router (route tree auto-generated in `routeTree.gen.ts`)
 - **State Machines**: XState machines in `machines/` for complex flows (KYC, ramp process)
@@ -95,6 +97,8 @@ Contains cross-package utilities:
 
 **Important**: Always rebuild shared when making changes: `bun build:shared`
 
+After ANY change to `packages/shared`, run `bun build:shared` before running frontend/api.
+
 ## Code Style Guidelines
 
 From `.clinerules/`:
@@ -110,6 +114,11 @@ From `.clinerules/`:
 - Extract complex conditional rendering into new components
 - Skip useless comments; only comment race conditions, TODOs, or genuinely confusing code
 
+### XState v5
+- Use `setup({ ... }).createMachine(...)` API- not `createMachine` directly
+- Actor refs from `useActor` / `useSelector` from `@xstate/react`
+- Machine files live in `apps/frontend/src/machines/`
+
 ### Biome Configuration
 - Line width: 128
 - Indent: 2 spaces
@@ -118,6 +127,22 @@ From `.clinerules/`:
 - Quote style: double
 - Sorted Tailwind classes enforced via `useSortedClasses` rule
 
+## Token Exhaustiveness
+
+`FiatToken` currently has 6 values: `EURC`, `ARS`, `BRL`, `USD`, `MXN`, `COP`.
+
+Any `Record<FiatToken, X>` must include ALL six. Missing entries cause TypeScript errors
+when shared is rebuilt. Check: tokenAvailability, mapFiatToDestination, success page
+ARRIVAL_TEXT_BY_TOKEN, sep10 tokenMapping.
+
+## No Over-Engineering
+
+- Don't add features, refactors, or "improvements" beyond what was asked
+- Don't add docstrings/comments to code you didn't touch
+- Don't create helpers/utilities for one-time operations
+- Don't validate inputs that can't be invalid (internal calls, typed params)
+- Three similar lines is better than a premature abstraction
+
 ## Testing
 
 ### Backend Integration Tests

apps/api/src/api/controllers/alfredpay.controller.ts

@@ -6,14 +6,10 @@ import {
   AlfredpayCreateCustomerResponse,
   AlfredpayCustomerType,
   AlfredpayGetKybRedirectLinkResponse,
-  AlfredpayGetKybStatusResponse,
   AlfredpayGetKycRedirectLinkRequest,
   AlfredpayGetKycRedirectLinkResponse,
-  AlfredpayGetKycStatusRequest,
   AlfredpayGetKycStatusResponse,
   AlfredpayKybStatus,
-  AlfredpayKycRedirectFinishedRequest,
-  AlfredpayKycRedirectOpenedRequest,
   AlfredpayKycStatus,
   AlfredpayStatusRequest,
   AlfredpayStatusResponse
@@ -258,10 +254,8 @@ export class AlfredpayController {
         : await alfredpayService.getKycStatus(alfredPayCustomer.alfredPayId, lastSubmission.submissionId);
 
       const newStatus = AlfredpayController.mapKycStatus(statusResponse.status);
-      console.log("newStatus", newStatus);
       const updateData: Partial<AlfredPayCustomer> = {};
 
-      console.log("our status", alfredPayCustomer.status);
       if (newStatus && newStatus !== alfredPayCustomer.status) {
         updateData.status = newStatus;
       }

apps/api/src/api/services/phases/handlers/final-settlement-subsidy.ts

@@ -8,7 +8,6 @@ import {
   getNetworkId,
   getOnChainTokenDetails,
   getRoute,
-  isEvmToken,
   multiplyByPowerOfTen,
   Networks,
   RampCurrency,

apps/api/src/api/services/sep10/sep10.service.ts

@@ -34,7 +34,9 @@ export const signSep10Challenge = async (
     [FiatToken.EURC]: "EURC",
     [FiatToken.ARS]: "ARS",
     [FiatToken.BRL]: "BRL",
-    [FiatToken.USD]: "USDC" // USD maps to USDC for consistency, though not used for SEP10
+    [FiatToken.USD]: "USDC",
+    [FiatToken.MXN]: "USDC",
+    [FiatToken.COP]: "USDC"
   };
 
   const outToken = tokenMapping[fiatToken];

apps/frontend/App.css

@@ -50,6 +50,7 @@
 
   :root:has(:is(.modal-open, .modal:target, .modal-toggle:checked + .modal, .modal[open])) {
     scrollbar-gutter: unset;
+    overflow-y: scroll;
   }
 }
 
@@ -123,6 +124,7 @@
 .btn {
   height: 3rem;
   box-shadow: none;
+  cursor: pointer !important;
 }
 
 .btn-vortex-primary {
@@ -135,7 +137,7 @@
 }
 
 .btn-vortex-primary:hover {
-  @apply bg-blue-200 text-blue-700;
+  @apply bg-blue-100 text-blue-700;
 }
 
 .btn-vortex-primary:disabled {
@@ -162,10 +164,30 @@
   @apply border-blue-300;
 }
 
+.btn-vortex-success {
+  @apply bg-green-500;
+  @apply text-white;
+  @apply rounded-[var(--radius-field)];
+  @apply border;
+  @apply border-green-500;
+  @apply duration-200;
+  transition: scale 0.1s ease-in-out;
+}
+
+.btn-vortex-success:active {
+  scale: 0.98;
+}
+
+.btn-vortex-success:hover {
+  @apply bg-green-100;
+  @apply text-green-700;
+  @apply border-green-300;
+}
+
 .btn-vortex-primary-inverse {
   @apply bg-white;
   @apply text-blue-700;
-  @apply rounded-xl;
+  @apply rounded-[var(--radius-field)];
   @apply border;
   @apply border-blue-700;
   @apply cursor-pointer;
@@ -198,6 +220,7 @@
 .btn-vortex-secondary {
   @apply text-white;
   @apply bg-pink-600;
+  @apply rounded-[var(--radius-field)];
   @apply border-pink-600;
   @apply shadow-none;
   transition: scale 0.1s ease-in-out;
@@ -215,11 +238,11 @@
 }
 
 .btn-vortex-danger {
-  @apply bg-red-600;
-  @apply text-white;
+  @apply bg-red-800;
+  @apply text-red-100;
   @apply rounded-xl;
   @apply border;
-  @apply border-red-600;
+  @apply border-red-800;
   @apply shadow-none;
   transition: scale 0.1s ease-in-out;
 }
@@ -229,7 +252,7 @@
 }
 
 .btn-vortex-danger:hover {
-  @apply bg-white;
+  @apply bg-red-100;
   @apply text-red-800;
   @apply border-red-800;
 }

apps/frontend/package.json

@@ -58,6 +58,7 @@
     "numora": "^3.0.2",
     "numora-react": "3.0.3",
     "qrcode.react": "^4.2.0",
+    "radix-ui": "^1.4.3",
     "react": "=19.2.0",
     "react-dom": "=19.2.0",
     "react-hook-form": "^7.65.0",