adaptive-multi-protocol-gateway/docs/wownero-integration.md

Wownero Integration

Status: draft | Updated 2026-07-05 | Applies to: Wownero static site publishing

The Wownero integration exercises AMPG against a real public static site. The source is the existing wownero.org website checked out next to this repository as ../wownero.org-website.

Objective

Start with the existing clearnet site, preserve the rich web output, and generate transport-specific variants with defaults:

• clearnet: faithful static site output.
• Tor: privacy-hardened static HTML.
• I2P: privacy-hardened static HTML.
• Gemini: text-first .gmi pages.
• IPFS: static output tree for gateway or pinning workflows.
• Reticulum: compact Micron .mu pages.

Source Adapter

The Wownero site is a static HTML/CSS/JS tree:

• top-level pages such as index.html, mining.html, emission.html, and wownero-wallet-generator.html.
• local CSS, JavaScript, image, PDF, text, and icon assets.
• JavaScript-driven translation and UI behavior.
• an onion-location meta tag in index.html.

This makes static-html the right source adapter. Markdown migration is optional and must not be required for AMPG adoption.

Generated Outputs

/var/www/ampg/wownero/
  clearnet/
    index.html
    css/
    js/
    img/
  tor/
    index.html
    mining.html
    emission.html
  i2p/
    index.html
    mining.html
    emission.html
  gemini/
    index.gmi
    mining.gmi
    emission.gmi
  ipfs/
    index.html
    css/
    img/
  reticulum/
    index.mu
    mining.mu
    emission.mu

Renderer Behavior

Clearnet

Copy the source tree by default, excluding VCS/editor clutter, hidden private files, and backup artifacts.

Tor and I2P

Use privacy-html:

• remove JavaScript.
• remove inline event handlers.
• remove inline styles.
• keep local CSS only when configured.
• preserve local links to PDFs, text files, and reasonably sized images.
• preserve or generate onion/I2P location metadata only when configured.

Gemini

Use gemtext:

• extract page title, headings, paragraphs, lists, and links.
• emit links near the paragraph that referenced them.
• convert large media to plain download links.
• skip repeated navigation noise.

IPFS

Use clearnet static output for content-addressed publishing. AMPG emits route expectations for AMPB, but pinning and CID publication remain explicit operator actions.

Reticulum

Use micron:

• prioritize short informational pages.
• omit heavy images by default.
• generate compact navigation.
• treat downloadable files as links with size hints.

Daemon Policy

Recommended defaults:

[site.protocols.clearnet]
enabled = true
daemon_policy = "adopt"

[site.protocols.tor]
enabled = true
daemon_policy = "auto"

[site.protocols.i2p]
enabled = true
daemon_policy = "auto"

[site.protocols.gemini]
enabled = false
daemon_policy = "auto"

[site.protocols.ipfs]
enabled = false
renderer = "clearnet"
daemon_policy = "auto"

[site.protocols.reticulum]
enabled = false
daemon_policy = "auto"

Acceptance Criteria

• ampg plan identifies the Wownero source tree and selected protocols.
• ampg build creates clearnet, Tor, I2P, and Gemini output without requiring Markdown.
• ampg build writes a fixture manifest that AMPB can check.
• ampg preview manifest writes loopback fixture URLs that AMPB can check before live transport daemons are installed or adopted.
• ampg deploy apply --stage state, --stage supervisor, --stage start, and --stage addresses stage Wownero transport publication without mixing concerns.
• Tor output contains no <script> tags or inline event handlers.
• Generated Gemini output has readable headings, paragraphs, and links.
• Generated Micron output fits terminal-first browsing.
• ampg plan clearly says whether each selected daemon is adopted or managed.

Local Commands

python3 -m ampg --config gateway.toml init site wownero --domain wownero.org --source ../wownero.org-website --preset full
python3 -m ampg --config gateway.toml deploy plan --profile vps-full
python3 -m ampg --config gateway.toml dns plan --profile vps-full
python3 -m ampg --config gateway.toml dns plan --profile vps-full --free-domain-hints
python3 -m ampg --config examples/wownero.gateway.toml plan
python3 -m ampg --config examples/wownero.gateway.toml build
python3 -m ampg --config examples/wownero.gateway.toml manifest
python3 -m ampg --config examples/wownero.gateway.toml addresses list
python3 -m ampg --config examples/wownero.gateway.toml preview endpoints
python3 -m ampg --config examples/wownero.gateway.toml preview manifest
python3 -m ampg --config examples/wownero.gateway.toml install-plan --profile mobile-i2p --write-artifacts
python3 -m ampg --config examples/wownero.gateway.toml approvals list --profile mobile-i2p
python3 -m ampg --config examples/wownero.gateway.toml approvals approve --profile mobile-i2p --all
python3 -m ampg --config examples/wownero.gateway.toml deploy apply --stage state --dry-run --profile mobile-i2p
python3 -m ampg --config examples/wownero.gateway.toml deploy apply --stage supervisor --dry-run --profile mobile-i2p
python3 -m ampg --config examples/wownero.gateway.toml deploy apply --stage start --dry-run --profile mobile-i2p
python3 -m ampg --config examples/wownero.gateway.toml deploy apply --stage addresses --dry-run --profile mobile-i2p
python3 -m ampg --config examples/i2p-only.gateway.toml plan
python3 -m ampg --config examples/i2p-only.gateway.toml build

Reusable checklist

• Build from ../wownero.org-website using source.kind = "static-html".
• Preserve clearnet output first.
• Generate Tor privacy-html and verify active content is stripped.
• Add Gemini conversion fixtures.
• Add Reticulum/Micron conversion fixtures.
• Enable I2P and Reticulum daemon management only after static outputs are stable.
• Start only AMPG-owned Wownero transport services after reviewed files are applied.
• Capture Wownero transport addresses before published health checks.