How urriki1502/wam-security works
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: cli.py Audit CLI · findings.py Finding model · consensus_semantics.py Consensus semantics audit · supply_chain.py Supply-chain audit
Components 33
Audit workflow
- Audit CLI
src/wam_security/cli.py - Consensus audit
src/wam_security/audit/consensus.py - Consensus semantics audit
src/wam_security/audit/consensus_semantics.py - Money-path audit
src/wam_security/audit/money.py - Runtime audit
src/wam_security/audit/runtime.py - Source audit
src/wam_security/audit/source.py - Workflow audit
src/wam_security/audit/workflow.py - Supply-chain audit
src/wam_security/audit/supply_chain.py - Independent assurance
src/wam_security/audit/independent_assurance.py - Fabric audit
src/wam_security/audit/continuous_fabric.py - Finding model
src/wam_security/audit/findings.py - Security reports
src/wam_security/report.py
Security models
- Consensus models
src/wam_security/consensus/dgw.py - RandomX model
src/wam_security/consensus/randomx.py - Monetary reference
src/wam_security/model/monetary.py - Pre-sync model
src/wam_security/model/presync.py - Payment model
src/wam_security/model/payment.py - Formal checks
src/wam_security/formal/checker.py - Payout properties
src/wam_security/formal/payout.py - Release properties
src/wam_security/formal/release.py
Adversarial runtime
- Protocol guards
src/wam_security/adversarial/protocol.py - Resource budgets
src/wam_security/adversarial/resource.py - Adversarial corpus
src/wam_security/adversarial/fuzz.py - Failure scenarios
src/wam_security/adversarial/faults.py - Dependency watchdog
src/wam_security/adversarial/watchdog.py
Release assurance
- Dependency identities
src/wam_security/supplychain/identities.py - Provenance and SBOM
src/wam_security/supplychain/provenance.py - Reproducibility checks
src/wam_security/supplychain/repro.py
Continuous monitoring
- Fabric checks
src/wam_security/fabric/core.py - Status policy
src/wam_security/fabric/status.py - Live evidence
src/wam_security/fabric/live.py
Other components
- Security engineer
- WAM checkout
Connections 44
- Security engineer → Audit CLI: runs audit
src/wam_security/cli.py - WAM checkout → Audit CLI: audits checkout
src/wam_security/cli.py - Audit CLI → Consensus audit: runs
src/wam_security/cli.py - Audit CLI → Consensus semantics audit: runs
src/wam_security/cli.py - Audit CLI → Money-path audit: runs
src/wam_security/cli.py - Audit CLI → Runtime audit: runs
src/wam_security/cli.py - Audit CLI → Source audit: runs
src/wam_security/cli.py - Audit CLI → Workflow audit: runs
src/wam_security/cli.py - Audit CLI → Supply-chain audit: runs
src/wam_security/cli.py - Audit CLI → Independent assurance: runs
src/wam_security/cli.py - Audit CLI → Fabric audit: runs
src/wam_security/cli.py - Audit CLI → Security reports: writes reports
src/wam_security/cli.py - Consensus audit → Finding model: creates findings
src/wam_security/audit/consensus.py - Consensus semantics audit → Finding model: creates findings
src/wam_security/audit/consensus_semantics.py - Money-path audit → Finding model: creates findings
src/wam_security/audit/money.py - Runtime audit → Finding model: uses findings
src/wam_security/audit/runtime.py - Source audit → Finding model: uses findings
src/wam_security/audit/source.py - Workflow audit → Finding model: uses findings
src/wam_security/audit/workflow.py - Supply-chain audit → Finding model: creates findings
src/wam_security/audit/supply_chain.py - Independent assurance → Finding model: uses findings
src/wam_security/audit/independent_assurance.py - Fabric audit → Finding model: uses findings
src/wam_security/audit/continuous_fabric.py - Security reports → Finding model: serializes
src/wam_security/report.py - Consensus semantics audit → RandomX model: checks model
src/wam_security/audit/consensus_semantics.py - Consensus models → WAM checkout: models consensus
README.md - Monetary reference → WAM checkout: models money rules
README.md - Pre-sync model → WAM checkout: models pre-sync
README.md - Payment model → WAM checkout: models payout safety
README.md - Formal checks → WAM checkout: checks safety properties
README.md - Payout properties → WAM checkout: checks payout safety
README.md - Release properties → WAM checkout: checks release safety
README.md - Adversarial corpus → Protocol guards: validates inputs
src/wam_security/adversarial/fuzz.py - Adversarial corpus → Resource budgets: tests budgets
src/wam_security/adversarial/fuzz.py - Protocol guards → WAM checkout: models protocol guards
README.md - Resource budgets → WAM checkout: models runtime limits
README.md - Failure scenarios → WAM checkout: models payout failures
README.md - Dependency watchdog → WAM checkout: models dependency failures
README.md - Provenance and SBOM → Dependency identities: loads locked identities
src/wam_security/supplychain/provenance.py - Supply-chain audit → WAM checkout: audits release chain
README.md - Provenance and SBOM → WAM checkout: describes release artifacts
README.md - Reproducibility checks → WAM checkout: checks reproducibility
README.md - Status policy → Fabric checks: uses checks
src/wam_security/fabric/status.py - Live evidence → WAM checkout: collects live evidence
README.md - Fabric audit → Fabric checks: assesses fabric
src/wam_security/audit/continuous_fabric.py - Fabric checks → Security engineer: reports security status
README.md