# Phoenix Wallet Registry

**Category**: WALLET_SERVICES  
**Publisher**: Phoenix Cloud Services  
**Status**: PUBLISHED  
**Version**: 1.0.0

## Overview

Phoenix Wallet Registry manages wallet mapping, chain support, policy engine, and recovery. Supports MPC (preferred for production custody), HSM-backed keys for service wallets, and passkeys + account abstraction for end-users.

## Key Features

- **Wallet mapping**: User/org ↔ wallet addresses
- **Multi-chain support**: Support matrix for all major chains
- **MPC custody**: Multi-party computation for secure custody
- **HSM-backed keys**: Hardware security module integration
- **Transaction simulation**: Preflight simulation for on-chain calls
- **ERC-4337 support**: Smart account abstraction
- **Policy engine**: Signing limits, approvals, recovery policies
- **Transaction builder**: Deterministic encoding

## API Endpoints

### Register Wallet

```http
POST /wallets/register
Content-Type: application/json

{
  "userId": "user_123",
  "address": "0x...",
  "chainId": 1,
  "custodyType": "SHARED",
  "orgId": "org_123"
}
```

### Build Transaction

```http
POST /wallets/tx/build
Content-Type: application/json

{
  "from": "0x...",
  "to": "0x...",
  "value": "1000000000000000000",
  "data": "0x...",
  "chainId": 1
}
```

### Simulate Transaction

```http
POST /wallets/tx/simulate
Content-Type: application/json

{
  "from": "0x...",
  "to": "0x...",
  "value": "1000000000000000000",
  "data": "0x...",
  "chainId": 1
}
```

### Submit Transaction

```http
POST /wallets/tx/submit
Content-Type: application/json

{
  "transaction": "0x...",
  "chainId": 1
}
```

## Pricing

- **Model**: Hybrid (subscription + usage)
- **Base Price**: $199/month
- **Per Wallet**: $5.00/month
- **Per Transaction**: $0.01

## Compliance

- SOC 2 Type II
- ISO 27001

## SLA

- **Uptime**: 99.9%
- **Latency**: <200ms p95

## Architecture

- MPC service for shared custody
- HSM integration for service wallets
- Transaction builder with deterministic encoding
- Policy engine for signing rules
