# worldliberty/usd1-smart-contracts architecture

> Architecture diagram of the GitHub repository worldliberty/usd1-smart-contracts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/worldliberty/usd1-smart-contracts
- Repository: https://github.com/worldliberty/usd1-smart-contracts

## Overview

The README describes an upgradeable, freeze-capable ERC-20 token with gas-less transactions, conforming to EIP-20, EIP-712 and EIP-2612; it also documents proxy deployment and independent contract verification. The supplied tree contains only vendored libraries and tooling, not the token contract or deployment script, so the product workflow is represented at the documented capability level rather than as inspected implementation calls.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_token["Token capabilities"]
  node_stablecoin["Stablecoin contract"]
  node_erc20["ERC-20 transfers"]
  node_freeze["Freeze controls"]
  node_gasless["Gas-less transactions"]
  node_eip712["Typed signatures"]
  node_eip2612["Permit approvals"]
end

subgraph group_chain["Chain deployment"]
  node_proxy["Transparent proxy"]
end

node_operator(("Token operator"))
node_holder(("Token holder"))
node_ethereum(("Ethereum-compatible chain"))
node_explorer(("Block explorer"))

node_holder -->|"transfers tokens"| node_erc20
node_erc20 -->|"implements EIP-20"| node_stablecoin
node_operator -->|"uses freeze capability"| node_freeze
node_freeze -->|"constrains token"| node_stablecoin
node_holder -->|"uses gas-less capability"| node_gasless
node_gasless -->|"uses typed signatures"| node_eip712
node_eip712 -->|"conforms to EIP-712"| node_stablecoin
node_eip2612 -->|"conforms to EIP-2612"| node_stablecoin
node_operator -->|"deploys sample token"| node_proxy
node_proxy -->|"proxies token"| node_stablecoin
node_proxy -->|"deploys on"| node_ethereum
node_operator -->|"verifies contract"| node_explorer

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_stablecoin,node_erc20,node_freeze,node_gasless,node_eip712,node_eip2612 toneBlue
class node_proxy toneAmber
class node_operator,node_holder,node_ethereum,node_explorer toneIndigo
```

## Components

### Token capabilities

- **Stablecoin contract**
- **ERC-20 transfers**
- **Freeze controls**
- **Gas-less transactions**
- **Typed signatures**
- **Permit approvals**

### Chain deployment

- **Transparent proxy**

### Other components

- **Token operator**
- **Token holder**
- **Ethereum-compatible chain**
- **Block explorer**

## Connections

- Token holder → ERC-20 transfers: transfers tokens
- ERC-20 transfers → Stablecoin contract: implements EIP-20
- Token operator → Freeze controls: uses freeze capability
- Freeze controls → Stablecoin contract: constrains token
- Token holder → Gas-less transactions: uses gas-less capability
- Gas-less transactions → Typed signatures: uses typed signatures
- Typed signatures → Stablecoin contract: conforms to EIP-712
- Permit approvals → Stablecoin contract: conforms to EIP-2612
- Token operator → Transparent proxy: deploys sample token
- Transparent proxy → Stablecoin contract: proxies token
- Transparent proxy → Ethereum-compatible chain: deploys on
- Token operator → Block explorer: verifies contract