# Twin3 Sovereign Agent Infrastructure: Standard Trading Card (TCG) Design Specification

**Specification Version**: `2.0.0-tcg-converged`  
**Target Ecosystem**: `xHuman.ID` (Personal Agent) & `xAgent.ID` (Business Agent)  
**Author**: Twin3 Architecture & Design Core  
**Status**: Canonical Standard (Adopted across twin3.ai, xhuman.id, and xagent.id)

---

## 1. Physical & Digital Dimension Standards

Both `xHuman.ID` and `xAgent.ID` cards are designed as physical-first collectible trading cards that seamlessly render as interactive 3D digital twins.

| Metric | Physical Standard (Print) | Digital Standard (Web / Embed) | Toploader / Sleeve Compatibility |
| :--- | :--- | :--- | :--- |
| **Width** | 2.50 inches (63.50 mm) | `340px` (Base unit) | Standard 2.5" × 3.5" |
| **Height** | 3.50 inches (88.90 mm) | `476px` (Base unit) | Standard 2.5" × 3.5" |
| **Aspect Ratio** | `5 : 7` (1 : 1.400) | `aspect-ratio: 2.5 / 3.5;` | Exact match |
| **Corner Radius** | `3.5 mm` (Die-cut curve) | `border-radius: 14px;` | Fits 35pt Toploaders & Dragon Shield sleeves |
| **Card Thickness / Border** | 35pt cardstock (approx. 0.89 mm) | `border: 1.5px solid rgba(255, 255, 255, 0.22);` | Double-sleeved clearance |
| **Holographic Foil** | Cold foil / rainbow sheen | CSS gradient overlay with specular highlight | Collector's Edition aesthetic |

---

## 2. Layout Convergence & Information Architecture (IA)

To eliminate visual fragmentation between Personal and Business agents, both cards adopt an identical 3-Zone structural grid:

```
+-----------------------------------------------------------+
| ZONE 1: TOP HUD (Height: 36px)                            |
| [Brand Lockup]                 [Series / Chain Badge]     |
+-----------------------------------------------------------+
| ZONE 2: VISUAL CORE & IDENTITY (Height: 330px)            |
|                                                           |
| [Front: Avatar/Emblem Frame]   [Back: Machine Interface]  |
| - Photo/Video Drag Surface     - DID String & Endpoints   |
| - Display Name & Handle        - llms.txt & agent-card    |
| - Tagline / Domain             - L4 Policy Boundaries     |
| - 256D Matrix / LEI Status     - L6 Settlement Escrow     |
|                                                           |
+-----------------------------------------------------------+
| ZONE 3: COLLECTOR FOOTER (Height: 50px)                   |
| [Micro QR Code]  [Serial № & Hash]   [Flip Control ⇄]     |
+-----------------------------------------------------------+
```

---

## 3. Front Face: Sovereign Human & Enterprise Presentation

### A. Personal Agent (`xHuman.ID · BNB Chain`)
1. **Header**: Acrylic badge with `xHuman ID`, series index (`SERIES 01`), and `BNB Chain` network indicator.
2. **Visual Window**: Full-bleed portrait/video surface with metallic rim and subtle 3D lighting gradient.
3. **Identity Overlay**:
   - Human Display Name (e.g., `sugar`, 22px bold).
   - Identity Handle (e.g., `sugar13w2842087103294128`, 11px monospace).
   - Personality / Mission Tagline (e.g., `糖果的甜你懂嗎`).
   - 256D Soul Vector & Human Score badge (0–255).
4. **Footer**:
   - Cryptographic Serial (e.g., `№ 3518`).
   - Scannable micro QR code pointing to canonical profile `https://xhuman.id/<handle>`.

### B. Business Agent (`xAgent.ID · Base Chain`)
1. **Header**: Acrylic badge with `xAgent ID`, series index (`SERIES 01`), and `Base Chain` network indicator.
2. **Visual Window**: Centered enterprise emblem / logo with high-contrast badge background.
3. **Identity Overlay**:
   - Enterprise Legal Name (e.g., `NVIDIA Corporation`, 22px bold).
   - Canonical Domain (e.g., `nvidia.com`, 11px monospace).
   - GLEIF Legal Entity Identifier (LEI) verification seal.
   - 6 Pillars Capability Profile (P1 Identity, P2 Offering, P3 Operations, P4 Commerce, P5 MCP Tools, P6 Growth).
4. **Footer**:
   - Cryptographic Registration Hash / Token ID.
   - Scannable micro QR code pointing to canonical agent page `https://xagent.id/<domain>`.

---

## 4. Back Face: Agent View (Machine-Readable Protocol Surface)

Both cards render an identical back-face layout optimized for autonomous AI agents, inspection tools, and verifiers:

1. **Header**: `AGENT VIEW (MACHINE READABLE)` + W3C DID string:
   - Human: `did:twin3:bnb:0x...`
   - Business: `did:twin3:base:0x...`
2. **Machine Endpoints Grid**:
   - `.well-known/agent-card.json` (A2A discovery contract)
   - `llms.txt` (Structured system prompt for LLMs)
   - `mcp-tools` (Exposed Model Context Protocol endpoints)
3. **Layer 4 Shield Policy Boundaries**:
   - `Public Intent / Inquiries`: **ALLOW** (Green)
   - `256D Intent Matching`: **ALLOW** (Green)
   - `Commercial Contracts / RFQs`: **ASK OWNER** (Amber)
   - `Unauthorized Model Scraping`: **DENY** (Red)
4. **Layer 6 Settlement Rails**:
   - Bounded HTTP 402 USDC Escrow parameters and fulfillment terms.
5. **Footer**:
   - Issuance date timestamp, verification attestation, and return flip trigger.

---

## 5. Embed Widget & Iframe Integration Contract

To avoid maintaining two disconnected codebases, `twin3.ai` consumes the standard embed widget served directly by `xhuman.id` and `xagent.id`:

- **Personal Embed URL**: `https://xhuman.id/embed/:handle` (or local fallback `embeds/xhuman/:handle.html`)
- **Business Embed URL**: `https://xagent.id/embed/:domain` (or local fallback `embeds/xagent.html?host=:domain`)
- **Container Styling**:
  ```css
  .product-embed {
    width: 100%;
    height: 580px;
    background: transparent;
    border: none;
    border-radius: 0;
  }
  ```
- **PostMessage Event Handlers**:
  ```javascript
  // Communicates flip and resize state with parent
  window.parent.postMessage({
    source: "twin3-card-embed",
    type: "flip",
    side: "front" | "back",
    height: 580
  }, "*");
  ```