Files
gru_emoney_token-factory/api/services/mapping-service/README.md
defiQUG d7379f108e Enhance mapping and orchestrator services with new features and improvements
- Updated `mapping-service` to include WEB3-ETH-IBAN support, health check endpoint, and improved error handling for account-wallet linking.
- Added new provider connection and status endpoints in `mapping-service`.
- Enhanced `orchestrator` service with health check, trigger management endpoints, and improved error handling for trigger validation and submission.
- Updated dependencies in `package.json` for both services, including `axios`, `uuid`, and type definitions.
- Improved packet service with additional validation and error handling for packet generation and dispatching.
- Introduced webhook service enhancements, including delivery retries, dead letter queue management, and webhook management endpoints.
2025-12-12 13:53:30 -08:00

1.8 KiB

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