Add alfredpay support

.gitignore

@@ -41,4 +41,8 @@ storybook-static
 
 
 CLAUDE.local.md
-.claude
+.claude
+
+# hardhat generated files in workspace contract projects
+contracts/*/artifacts
+contracts/*/cache

README.md

@@ -13,13 +13,16 @@ Vortex is a gateway for cross-border payments. It is built on top of the Pendulu
 
 ## Repository Structure
 
-This is a **Bun monorepo** containing multiple sub-projects organized into apps and packages:
+This is a **Bun monorepo** containing multiple sub-projects organized into apps, packages, and contracts:
 
 ### Apps
 
 - **[apps/api](apps/api)** - Backend API service providing signature services, on/off-ramping flows, quote generation, and transaction state management
 - **[apps/frontend](apps/frontend)** - React-based web application built with Vite for the Vortex user interface
 - **[apps/rebalancer](apps/rebalancer)** - Service for automated liquidity rebalancing across chains
+### Contracts
+
+- **[contracts/relayer](contracts/relayer)** - Hardhat project for relayer smart contracts and deployment scripts
 
 ### Packages
 
@@ -69,6 +72,11 @@ bun dev:backend
 bun dev:rebalancer
 ```
 
+**Relayer contract local node:**
+```bash
+bun dev:contracts:relayer
+```
+
 ### Building
 
 **Build all projects:**
@@ -91,6 +99,15 @@ bun build:sdk
 bun build:shared
 ```
 
+**Relayer contract:**
+```bash
+# Compile contracts
+bun compile:contracts:relayer
+
+# Run contract tests
+bun test:contracts:relayer
+```
+
 ## Sub-Project Specific Instructions
 
 ### Frontend (apps/frontend)

apps/api/.env.example

@@ -64,3 +64,8 @@ DELTA_D_BASIS_POINTS=0.3
 # RSA Keys for Webhook Signing
 # Only the private key is needed - public key is derived from it
 WEBHOOK_PRIVATE_KEY=your-webhook-private-key
+
+# AlfredPay
+ALFREDPAY_BASE_URL=your-alfredpay-base-url
+ALFREDPAY_API_KEY=your-alfredpay-api-key
+ALFREDPAY_API_SECRET=your-alfredpay-api-secret