# 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

```bash
# 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