# Credential Images - Order of St John Seals

This directory contains the official seals for The Order's credential types, all featuring the Maltese Cross as the central element.

## Seal Designs

All seals follow a consistent design language:
- **Circular, double-ring design** (outer thick ring, inner thin ring)
- **Maltese Cross** as the dominant central symbol
- **OSJ (Order of St John)** references throughout
- **Consistent typography** and styling

## Available Seals

### 1. Digital Bank of International Settlements
**File**: `svg/digital-bank-seal.svg`

- **Outer Text**: "DIGITAL BANK OF INTERNATIONAL SETTLEMENTS" / "ORDER OF ST JOHN • OSJ"
- **Central Element**: Maltese Cross with globe/networking pattern
- **Top Element**: DB monogram in circle
- **Use Case**: Financial credentials, banking credentials

### 2. International Criminal Court of Commerce (ICCC)
**File**: `svg/iccc-seal.svg`

- **Outer Text**: "INTERNATIONAL CRIMINAL COURT OF COMMERCE" / "ICCC • ORDER OF ST JOHN"
- **Central Element**: Maltese Cross with scales of justice overlay
- **Top Element**: Courthouse pediment
- **Micro-text**: "LEX ET ORDO"
- **Use Case**: Judicial credentials, legal credentials

### 3. ICCC Provost Marshals
**File**: `svg/iccc-provost-marshals-seal.svg`

- **Outer Text**: "INTERNATIONAL CRIMINAL COURT OF COMMERCE" / "PROVOST MARSHALS • OSJ"
- **Central Element**: Shield charged with Maltese Cross
- **Overlay**: Upright sword (subtle)
- **Top Element**: Five-pointed star
- **Micro-text**: "VIGILIA ET IUSTITIA"
- **Use Case**: Enforcement credentials, marshal credentials

### 4. Provost Marshals Diplomatic Security Service
**File**: `svg/diplomatic-security-seal.svg`

- **Outer Text**: "PROVOST MARSHALS" / "DIPLOMATIC SECURITY SERVICE • OSJ"
- **Central Element**: Shield with Maltese Cross, globe at center
- **Overlay**: Key and olive branch crossed
- **Top Element**: Laurel wreath arc
- **Micro-text**: "ORDO S. IOANNIS"
- **Use Case**: Diplomatic credentials, security credentials

## Usage

### For Credential Images

1. **Convert to PNG** (for Entra VerifiedID compatibility):
   ```bash
   ./scripts/tools/convert-svg-to-png.sh svg/digital-bank-seal.svg png/digital-bank-seal.png 200 200
   ```

2. **Batch Convert All**:
   ```bash
   ./scripts/tools/prepare-credential-images.sh
   ```

3. **Upload to CDN**:
   - Upload PNG files to your CDN/storage
   - Ensure HTTPS and public access
   - Update manifest templates with URLs

### In Code

```typescript
import { EntraVerifiedIDClient } from '@the-order/auth';

const client = new EntraVerifiedIDClient({
  // ...
  logoUri: 'https://cdn.theorder.org/images/digital-bank-seal.png',
});
```

### In Manifest Templates

Update manifest templates in `manifests/entra/` with appropriate seal URLs:

```json
{
  "display": {
    "logo": {
      "uri": "https://cdn.theorder.org/images/digital-bank-seal.png",
      "description": "Digital Bank of International Settlements Seal"
    }
  }
}
```

## Design Specifications

### Common Elements

- **Maltese Cross**: Always 8-pointed, V-shaped arms, dominant position
- **Double Ring**: Outer ring (8px stroke), inner ring (2px stroke)
- **Typography**: Times New Roman serif, all-caps for outer text
- **Color**: Single-color design (#1a1a1a) for official documents
- **Size**: 400x400px SVG, optimized for 200x200px PNG output

### Color Variations

For different credential types, you can create color variations:
- **Default**: #1a1a1a (black)
- **Financial**: #1e3a8a (navy blue)
- **Judicial**: #7c2d12 (dark red)
- **Diplomatic**: #065f46 (dark green)
- **Security**: #581c87 (dark purple)

## File Structure

```
assets/credential-images/
├── svg/
│   ├── digital-bank-seal.svg
│   ├── iccc-seal.svg
│   ├── iccc-provost-marshals-seal.svg
│   └── diplomatic-security-seal.svg
├── png/
│   ├── digital-bank-seal.png (generated)
│   ├── iccc-seal.png (generated)
│   ├── iccc-provost-marshals-seal.png (generated)
│   └── diplomatic-security-seal.png (generated)
└── README.md (this file)
```

## Legal Notice

These seals are designed for use with The Order's verifiable credentials system. They represent private, ceremonial entities and should not be presented as official government or intergovernmental authorities. Use in accordance with applicable laws and regulations.

---

**Design Heritage**: Order of St John (OSJ)  
**Central Symbol**: Maltese Cross (8-pointed)  
**Last Updated**: [Current Date]

