# urriki1502/wam-security architecture

> Architecture diagram of the GitHub repository urriki1502/wam-security, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/urriki1502/wam-security
- Repository: https://github.com/urriki1502/wam-security

## Overview

WAM Security is an independent, executable assurance framework for WAM Coin. Its principal workflow is to inspect a WAM source checkout, run the CLI’s consensus, money, runtime, source, workflow, supply-chain, independent-assurance and continuous-fabric audits, then write machine-readable JSON and Markdown findings. Separate models and formal checks cover consensus, payout safety and release properties; adversarial components model hostile inputs and resource pressure. The README documents additional release-integrity, live-monitoring and integration-security capabilities. Edges reflect the CLI’s explicit calls, indexed imports or README statements; unsampled subsystem internals are represented conservatively.

Main entry points: [`src/wam_security/cli.py`](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/cli.py) (Audit CLI), [`src/wam_security/audit/findings.py`](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/findings.py) (Finding model), [`src/wam_security/audit/consensus_semantics.py`](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/consensus_semantics.py) (Consensus semantics audit), [`src/wam_security/audit/supply_chain.py`](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/supply_chain.py) (Supply-chain audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audit["Audit workflow"]
  node_cli["Audit CLI<br/>[cli.py]"]
  node_cons_audit["Consensus audit<br/>[consensus.py]"]
  node_sem_audit["Consensus semantics audit"]
  node_money_audit["Money-path audit<br/>[money.py]"]
  node_runtime_audit["Runtime audit<br/>[runtime.py]"]
  node_source_audit["Source audit<br/>[source.py]"]
  node_workflow_audit["Workflow audit<br/>[workflow.py]"]
  node_supply_audit["Supply-chain audit<br/>[supply_chain.py]"]
  node_assurance_audit["Independent assurance"]
  node_fabric_audit["Fabric audit"]
  node_finding["Finding model<br/>[findings.py]"]
  node_report["Security reports<br/>[report.py]"]
end

subgraph group_models["Security models"]
  node_cons_model["Consensus models<br/>[dgw.py]"]
  node_randomx["RandomX model<br/>[randomx.py]"]
  node_monetary["Monetary reference<br/>[monetary.py]"]
  node_presync["Pre-sync model<br/>[presync.py]"]
  node_payment["Payment model<br/>[payment.py]"]
  node_formal["Formal checks<br/>[checker.py]"]
  node_payout_formal["Payout properties<br/>[payout.py]"]
  node_release_formal["Release properties<br/>[release.py]"]
end

subgraph group_runtime["Adversarial runtime"]
  node_protocol["Protocol guards<br/>[protocol.py]"]
  node_resources["Resource budgets<br/>[resource.py]"]
  node_fuzz["Adversarial corpus<br/>[fuzz.py]"]
  node_faults["Failure scenarios<br/>[faults.py]"]
  node_watchdog["Dependency watchdog<br/>[watchdog.py]"]
end

subgraph group_release["Release assurance"]
  node_identities["Dependency identities<br/>[identities.py]"]
  node_provenance["Provenance and SBOM<br/>[provenance.py]"]
  node_repro["Reproducibility checks<br/>[repro.py]"]
end

subgraph group_fabric["Continuous monitoring"]
  node_fabric_core["Fabric checks<br/>[core.py]"]
  node_fabric_status["Status policy<br/>[status.py]"]
  node_fabric_live["Live evidence<br/>[live.py]"]
end

node_maintainer(("Security engineer"))
node_wamcheckout["WAM checkout"]

node_maintainer -->|"runs audit"| node_cli
node_wamcheckout -->|"audits checkout"| node_cli
node_cli -->|"runs"| node_cons_audit
node_cli -->|"runs"| node_sem_audit
node_cli -->|"runs"| node_money_audit
node_cli -->|"runs"| node_runtime_audit
node_cli -->|"runs"| node_source_audit
node_cli -->|"runs"| node_workflow_audit
node_cli -->|"runs"| node_supply_audit
node_cli -->|"runs"| node_assurance_audit
node_cli -->|"runs"| node_fabric_audit
node_cli -->|"writes reports"| node_report
node_cons_audit -->|"creates findings"| node_finding
node_sem_audit -->|"creates findings"| node_finding
node_money_audit -->|"creates findings"| node_finding
node_runtime_audit -->|"uses findings"| node_finding
node_source_audit -->|"uses findings"| node_finding
node_workflow_audit -->|"uses findings"| node_finding
node_supply_audit -->|"creates findings"| node_finding
node_assurance_audit -->|"uses findings"| node_finding
node_fabric_audit -->|"uses findings"| node_finding
node_report -->|"serializes"| node_finding
node_sem_audit -->|"checks model"| node_randomx
node_cons_model -->|"models consensus"| node_wamcheckout
node_monetary -->|"models money rules"| node_wamcheckout
node_presync -->|"models pre-sync"| node_wamcheckout
node_payment -->|"models payout safety"| node_wamcheckout
node_formal -->|"checks safety properties"| node_wamcheckout
node_payout_formal -->|"checks payout safety"| node_wamcheckout
node_release_formal -->|"checks release safety"| node_wamcheckout
node_fuzz -->|"validates inputs"| node_protocol
node_fuzz -->|"tests budgets"| node_resources
node_protocol -->|"models protocol guards"| node_wamcheckout
node_resources -->|"models runtime limits"| node_wamcheckout
node_faults -->|"models payout failures"| node_wamcheckout
node_watchdog -->|"models dependency failures"| node_wamcheckout
node_provenance -->|"loads locked identities"| node_identities
node_supply_audit -->|"audits release chain"| node_wamcheckout
node_provenance -->|"describes release artifacts"| node_wamcheckout
node_repro -->|"checks reproducibility"| node_wamcheckout
node_fabric_status -->|"uses checks"| node_fabric_core
node_fabric_live -->|"collects live evidence"| node_wamcheckout
node_fabric_audit -->|"assesses fabric"| node_fabric_core
node_fabric_core -->|"reports security status"| node_maintainer

click node_cli "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/cli.py"
click node_cons_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/consensus.py"
click node_sem_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/consensus_semantics.py"
click node_money_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/money.py"
click node_runtime_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/runtime.py"
click node_source_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/source.py"
click node_workflow_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/workflow.py"
click node_supply_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/supply_chain.py"
click node_assurance_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/independent_assurance.py"
click node_fabric_audit "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/continuous_fabric.py"
click node_finding "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/findings.py"
click node_report "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/report.py"
click node_cons_model "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/consensus/dgw.py"
click node_randomx "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/consensus/randomx.py"
click node_monetary "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/model/monetary.py"
click node_presync "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/model/presync.py"
click node_payment "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/model/payment.py"
click node_formal "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/formal/checker.py"
click node_payout_formal "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/formal/payout.py"
click node_release_formal "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/formal/release.py"
click node_protocol "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/protocol.py"
click node_resources "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/resource.py"
click node_fuzz "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/fuzz.py"
click node_faults "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/faults.py"
click node_watchdog "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/watchdog.py"
click node_identities "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/supplychain/identities.py"
click node_provenance "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/supplychain/provenance.py"
click node_repro "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/supplychain/repro.py"
click node_fabric_core "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/fabric/core.py"
click node_fabric_status "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/fabric/status.py"
click node_fabric_live "https://github.com/urriki1502/wam-security/blob/main/src/wam_security/fabric/live.py"

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_cli,node_cons_audit,node_sem_audit,node_money_audit,node_runtime_audit,node_source_audit,node_workflow_audit,node_supply_audit,node_assurance_audit,node_fabric_audit,node_finding,node_report toneBlue
class node_cons_model,node_randomx,node_monetary,node_presync,node_payment,node_formal,node_payout_formal,node_release_formal toneAmber
class node_protocol,node_resources,node_fuzz,node_faults,node_watchdog toneMint
class node_identities,node_provenance,node_repro toneRose
class node_fabric_core,node_fabric_status,node_fabric_live,node_maintainer,node_wamcheckout toneIndigo
```

## Components

### Audit workflow

- [Audit CLI](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/cli.py): `src/wam_security/cli.py`
- [Consensus audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/consensus.py): `src/wam_security/audit/consensus.py`
- [Consensus semantics audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/consensus_semantics.py): `src/wam_security/audit/consensus_semantics.py`
- [Money-path audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/money.py): `src/wam_security/audit/money.py`
- [Runtime audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/runtime.py): `src/wam_security/audit/runtime.py`
- [Source audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/source.py): `src/wam_security/audit/source.py`
- [Workflow audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/workflow.py): `src/wam_security/audit/workflow.py`
- [Supply-chain audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/supply_chain.py): `src/wam_security/audit/supply_chain.py`
- [Independent assurance](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/independent_assurance.py): `src/wam_security/audit/independent_assurance.py`
- [Fabric audit](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/continuous_fabric.py): `src/wam_security/audit/continuous_fabric.py`
- [Finding model](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/audit/findings.py): `src/wam_security/audit/findings.py`
- [Security reports](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/report.py): `src/wam_security/report.py`

### Security models

- [Consensus models](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/consensus/dgw.py): `src/wam_security/consensus/dgw.py`
- [RandomX model](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/consensus/randomx.py): `src/wam_security/consensus/randomx.py`
- [Monetary reference](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/model/monetary.py): `src/wam_security/model/monetary.py`
- [Pre-sync model](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/model/presync.py): `src/wam_security/model/presync.py`
- [Payment model](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/model/payment.py): `src/wam_security/model/payment.py`
- [Formal checks](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/formal/checker.py): `src/wam_security/formal/checker.py`
- [Payout properties](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/formal/payout.py): `src/wam_security/formal/payout.py`
- [Release properties](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/formal/release.py): `src/wam_security/formal/release.py`

### Adversarial runtime

- [Protocol guards](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/protocol.py): `src/wam_security/adversarial/protocol.py`
- [Resource budgets](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/resource.py): `src/wam_security/adversarial/resource.py`
- [Adversarial corpus](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/fuzz.py): `src/wam_security/adversarial/fuzz.py`
- [Failure scenarios](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/faults.py): `src/wam_security/adversarial/faults.py`
- [Dependency watchdog](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/adversarial/watchdog.py): `src/wam_security/adversarial/watchdog.py`

### Release assurance

- [Dependency identities](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/supplychain/identities.py): `src/wam_security/supplychain/identities.py`
- [Provenance and SBOM](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/supplychain/provenance.py): `src/wam_security/supplychain/provenance.py`
- [Reproducibility checks](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/supplychain/repro.py): `src/wam_security/supplychain/repro.py`

### Continuous monitoring

- [Fabric checks](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/fabric/core.py): `src/wam_security/fabric/core.py`
- [Status policy](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/fabric/status.py): `src/wam_security/fabric/status.py`
- [Live evidence](https://github.com/urriki1502/wam-security/blob/main/src/wam_security/fabric/live.py): `src/wam_security/fabric/live.py`

### Other components

- **Security engineer**
- **WAM checkout**

## Connections

- Security engineer → Audit CLI: runs audit (evidence: `src/wam_security/cli.py`)
- WAM checkout → Audit CLI: audits checkout (evidence: `src/wam_security/cli.py`)
- Audit CLI → Consensus audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Consensus semantics audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Money-path audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Runtime audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Source audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Workflow audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Supply-chain audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Independent assurance: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Fabric audit: runs (evidence: `src/wam_security/cli.py`)
- Audit CLI → Security reports: writes reports (evidence: `src/wam_security/cli.py`)
- Consensus audit → Finding model: creates findings (evidence: `src/wam_security/audit/consensus.py`)
- Consensus semantics audit → Finding model: creates findings (evidence: `src/wam_security/audit/consensus_semantics.py`)
- Money-path audit → Finding model: creates findings (evidence: `src/wam_security/audit/money.py`)
- Runtime audit → Finding model: uses findings (evidence: `src/wam_security/audit/runtime.py`)
- Source audit → Finding model: uses findings (evidence: `src/wam_security/audit/source.py`)
- Workflow audit → Finding model: uses findings (evidence: `src/wam_security/audit/workflow.py`)
- Supply-chain audit → Finding model: creates findings (evidence: `src/wam_security/audit/supply_chain.py`)
- Independent assurance → Finding model: uses findings (evidence: `src/wam_security/audit/independent_assurance.py`)
- Fabric audit → Finding model: uses findings (evidence: `src/wam_security/audit/continuous_fabric.py`)
- Security reports → Finding model: serializes (evidence: `src/wam_security/report.py`)
- Consensus semantics audit → RandomX model: checks model (evidence: `src/wam_security/audit/consensus_semantics.py`)
- Consensus models → WAM checkout: models consensus (evidence: `README.md`)
- Monetary reference → WAM checkout: models money rules (evidence: `README.md`)
- Pre-sync model → WAM checkout: models pre-sync (evidence: `README.md`)
- Payment model → WAM checkout: models payout safety (evidence: `README.md`)
- Formal checks → WAM checkout: checks safety properties (evidence: `README.md`)
- Payout properties → WAM checkout: checks payout safety (evidence: `README.md`)
- Release properties → WAM checkout: checks release safety (evidence: `README.md`)
- Adversarial corpus → Protocol guards: validates inputs (evidence: `src/wam_security/adversarial/fuzz.py`)
- Adversarial corpus → Resource budgets: tests budgets (evidence: `src/wam_security/adversarial/fuzz.py`)
- Protocol guards → WAM checkout: models protocol guards (evidence: `README.md`)
- Resource budgets → WAM checkout: models runtime limits (evidence: `README.md`)
- Failure scenarios → WAM checkout: models payout failures (evidence: `README.md`)
- Dependency watchdog → WAM checkout: models dependency failures (evidence: `README.md`)
- Provenance and SBOM → Dependency identities: loads locked identities (evidence: `src/wam_security/supplychain/provenance.py`)
- Supply-chain audit → WAM checkout: audits release chain (evidence: `README.md`)
- Provenance and SBOM → WAM checkout: describes release artifacts (evidence: `README.md`)
- Reproducibility checks → WAM checkout: checks reproducibility (evidence: `README.md`)
- Status policy → Fabric checks: uses checks (evidence: `src/wam_security/fabric/status.py`)
- Live evidence → WAM checkout: collects live evidence (evidence: `README.md`)
- Fabric audit → Fabric checks: assesses fabric (evidence: `src/wam_security/audit/continuous_fabric.py`)
- Fabric checks → Security engineer: reports security status (evidence: `README.md`)
