d7379f108e
- 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.
55 lines
1.8 KiB
Markdown
55 lines
1.8 KiB
Markdown
# 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
|
|
|