Files

defiQUG e8ae376e90 Enhance API services with validation and error handling improvements

- Integrated Zod validation schemas across various API routes to ensure input integrity and improve error handling.
- Updated `mapping-service`, `orchestrator`, `packet-service`, and `webhook-service` to utilize validation middleware for request parameters and bodies.
- Improved error handling in webhook management, packet generation, and compliance routes to provide clearer feedback on request failures.
- Added new validation schemas for various endpoints, enhancing overall API robustness and maintainability.
- Updated dependencies in `package.json` to include the new validation library.

2025-12-12 20:23:45 -08:00

src

Enhance API services with validation and error handling improvements

2025-12-12 20:23:45 -08:00

package.json

Enhance API services with validation and error handling improvements

2025-12-12 20:23:45 -08:00

README.md

Enhance mapping and orchestrator services with new features and improvements

2025-12-12 13:53:30 -08:00

tsconfig.json

Initial project setup: Add contracts, API definitions, tests, and documentation

2025-12-12 10:59:41 -08:00

README.md

Mapping Service

Account-wallet mapping service with Web3 provider support and WEB3-ETH-IBAN integration.

Features

Account-wallet linking and unlinking
Web3 provider integration (MetaMask, WalletConnect, Fireblocks)
WEB3-ETH-IBAN conversion (Ethereum address ↔ IBAN)
Provider connection management
Bidirectional account-wallet lookups

WEB3-ETH-IBAN Support

The service includes full WEB3-ETH-IBAN support for converting Ethereum addresses to IBAN format and vice versa.

Endpoints

POST /v1/mappings/web3/address-to-iban - Convert Ethereum address to IBAN
POST /v1/mappings/web3/iban-to-address - Convert IBAN to Ethereum address
POST /v1/mappings/web3/validate-iban - Validate IBAN format
POST /v1/mappings/web3/validate-address - Validate Ethereum address

Usage

# Convert address to IBAN
curl -X POST http://localhost:3004/v1/mappings/web3/address-to-iban \
  -H "Content-Type: application/json" \
  -d '{"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"}'

# Convert IBAN to address
curl -X POST http://localhost:3004/v1/mappings/web3/iban-to-address \
  -H "Content-Type: application/json" \
  -d '{"iban": "XE00..."}'

Providers

Supported providers:

web3 / metamask - Web3/MetaMask wallets
walletconnect - WalletConnect protocol
fireblocks - Fireblocks custody

API Endpoints

POST /v1/mappings/account-wallet/link - Link account to wallet
POST /v1/mappings/account-wallet/unlink - Unlink account from wallet
GET /v1/mappings/accounts/:accountRefId/wallets - Get wallets for account
GET /v1/mappings/wallets/:walletRefId/accounts - Get accounts for wallet
POST /v1/mappings/providers/:provider/connect - Connect provider
GET /v1/mappings/providers/:provider/connections/:connectionId/status - Get provider status
GET /v1/mappings/providers - List available providers