Hugging Face's logo

Spaces:
SZLHOLDINGS
/
amaru-platform
Running

App Files Community
amaru-platform / index.html
betterwithage's picture
betterwithage
Add amaru deep-dive: index.html
0e53b51 verified
raw
history blame contribute delete
38 kB
<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8"/>
 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
 <title>amaru β€” Memory &amp; Attestation, Cardano-Anchored Β· SZL Holdings</title>
 <meta name="description" content="Deep-dive showcase for amaru: Cardano-anchored governance receipt minting, Shor-encoded provenance, 7-chakra serpentine scheduler. Not a token."/>
 <meta property="og:title" content="amaru β€” Memory &amp; Attestation, Cardano-Anchored"/>
 <meta property="og:description" content="7-chakra serpentine scheduler with DSSE-wrapped receipts anchored to Cardano L1. Honest architecture deep-dive by SZL Holdings."/>
 <meta property="og:image" content="assets/hero_amaru.png"/>
 <meta property="og:type" content="website"/>
 <link rel="stylesheet" href="style.css"/>
 <link rel="preconnect" href="https://fonts.googleapis.com"/>
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin/>
 <link href="https://fonts.googleapis.com/css2?family=Cinzel:wght@400;600;700&family=Inter:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet"/>
</head>
<body>
<a href="#main" class="skip">Skip to main content</a>
<!-- ======================================================
 NAV
 ====================================================== -->
<nav aria-label="Main navigation">
 <div class="nav-inner">
 <div class="nav-logo">
 <!-- amaru serpent logo -->
 <svg width="26" height="26" viewBox="0 0 26 26" fill="none" aria-hidden="true" xmlns="http://www.w3.org/2000/svg">
 <circle cx="13" cy="13" r="12" stroke="#d4af37" stroke-width="1.2"/>
 <path d="M7 13 Q9 7 13 7 Q17 7 19 13 Q17 19 13 19 Q9 19 7 13Z" stroke="#d4af37" stroke-width="1.2" fill="none"/>
 <circle cx="18" cy="9" r="1.5" fill="#d4af37"/>
 </svg>
 amaru
 </div>
 <nav class="nav-links" aria-label="Page sections">
 <a href="#what-amaru">What it is</a>
 <a href="#chakras">Scheduler</a>
 <a href="#flow">Flow</a>
 <a href="#cardano">Cardano</a>
 <a href="#live">Live</a>
 <a href="#compare">Compare</a>
 <a href="#not-this">Not this</a>
 <a href="#citations">Citations</a>
 </nav>
 </div>
</nav>
<!-- ======================================================
 HERO
 ====================================================== -->
<main id="main">
<section id="hero" aria-labelledby="hero-heading">
 <div class="container">
 <div class="hero-inner">
<div class="hero-text">
 <div class="hero-eyebrow">SZL Holdings Β· szl-holdings/amaru</div>
<div class="disclaimer-pill" role="note">
 Not a token Β· Not a blockchain L1 Β· Not custodial
 </div>
<h1 id="hero-heading">amaru</h1>
 <p class="hero-tagline">Memory + attestation, Cardano-anchored</p>
<p>
 Cardano-anchored governance receipt minting with Shor-9 encoded
 provenance. Every agent memory operation emits a DSSE-wrapped
 SHA-256 receipt, chained and optionally checkpointed to the
 Cardano L1. Audit your AI's memory β€” cryptographically.
 </p>
<div class="hero-ctas">
 <a class="btn-primary" href="https://huggingface.co/spaces/SZLHOLDINGS/amaru-memory-attestation" target="_blank" rel="noopener">
 β–Ά Live Demo
 </a>
 <a class="btn-secondary" href="https://github.com/szl-holdings/amaru" target="_blank" rel="noopener">
 GitHub β†’
 </a>
 <a class="btn-secondary" href="https://doi.org/10.5281/zenodo.20434276" target="_blank" rel="noopener">
 Zenodo DOI β†’
 </a>
 </div>
 </div>
<div class="hero-images">
 <div class="hero-img-wrap">
 <img
 src="assets/hero_amaru.png"
 alt="amaru β€” the Andean ouroboros, brand image"
 class="hero-amaru-img"
 loading="eager"
 />
 </div>
 <div class="hero-connector"></div>
 <div class="hero-img-wrap">
 <img
 src="assets/brain_amaru_organ.png"
 alt="Brain organ β€” memory and cognition"
 class="hero-brain-img"
 loading="eager"
 />
 </div>
 </div>
</div>
 </div>
</section>
<!-- ======================================================
 WHAT AMARU IS
 ====================================================== -->
<section id="what-amaru" aria-labelledby="what-heading">
 <div class="container">
 <div class="section-label">Architecture</div>
 <h2 id="what-heading">What amaru is</h2>
 <div class="gold-bar"></div>
<p>
 amaru is a <strong>memory attestation runtime</strong> for AI agents.
 It wraps every memory read and write in a cryptographic receipt chain,
 optionally anchoring checkpoint hashes to the
 <a href="https://cardano.org/what-is-ada/" target="_blank" rel="noopener">Cardano</a>
 Layer 1 blockchain for tamper-evident provenance. The name comes from
 the Andean cosmic serpent β€” an ouroboros that loops, converges, and
 preserves. amaru is built on three interlocking primitives:
 </p>
<div class="info-grid">
 <div class="info-card">
 <div class="icon">πŸ”—</div>
 <h3>Governance Receipts</h3>
 <p>
 COSE_Sign1-wrapped receipts (RFC 9052) minted per memory
 operation. Each receipt carries a Ξ› score, Shor-9 encoded
 provenance hash, Lamport timestamp, and optional Cardano Tx
 reference. Source:
 <a href="https://github.com/szl-holdings/amaru/blob/main/README.md" target="_blank" rel="noopener">amaru README</a>.
 </p>
 </div>
 <div class="info-card">
 <div class="icon">🐍</div>
 <h3>7-Chakra Scheduler</h3>
 <p>
 A single-thread serpentine pipeline: ASCEND (propose) then
 DESCEND (commit). No branching mid-tick. The scheduler
 fires all 7 chakras sequentially β€” each emits a receipt
 trace entry. Source:
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/amaru_scheduler.py" target="_blank" rel="noopener">amaru_scheduler.py:8</a>.
 </p>
 </div>
 <div class="info-card">
 <div class="icon">βš›</div>
 <h3>Shor-9 Provenance</h3>
 <p>
 Provenance hashes are Shor-9-qubit-encoded before Cardano
 anchoring, providing single-qubit error correction on the
 immutable receipt chain. Mathematical basis:
 <a href="https://doi.org/10.1103/PhysRevA.52.R2493" target="_blank" rel="noopener">Shor 1995</a>.
 </p>
 </div>
 <div class="info-card">
 <div class="icon">🌐</div>
 <h3>Cardano L1 Anchor</h3>
 <p>
 Checkpoint hashes are anchored to the Cardano blockchain as
 transaction metadata β€” hash anchoring only, no new token.
 Provides public, permissionless auditability for any
 downstream verifier.
 </p>
 </div>
 </div>
 </div>
</section>
<!-- ======================================================
 7-CHAKRA SCHEDULER
 ====================================================== -->
<section id="chakras" aria-labelledby="chakra-heading">
 <div class="container">
 <div class="section-label">Source-cited</div>
 <h2 id="chakra-heading">7-Chakra Serpentine Scheduler</h2>
 <div class="gold-bar"></div>
<p>
 The scheduler (<a href="https://github.com/szl-holdings/amaru/blob/main/src/amaru_scheduler.py" target="_blank" rel="noopener"><code>src/amaru_scheduler.py</code></a>)
 fires 7 named chakras in fixed serpentine order. Each chakra has its own kernel (≀10 SLOC).
 The <code>ASCEND</code> list at line 8 defines the sequence:
 <code>["KALLPA", "YACHAY", "RIMAY", "YUYAY", "RUWAY", "NAWI", "HATUN"]</code>.
 Below are all seven chakras, with source citations to the exact function definition.
 </p>
<div class="chakra-grid">
<!-- 1: KALLPA -->
 <div class="chakra-card" aria-label="Chakra 1: KALLPA">
 <div class="chakra-number">CHAKRA 1 Β· root Β· ascend-1</div>
 <div class="chakra-name">KALLPA</div>
 <div class="chakra-fn">dispatch(state, world, seed)</div>
 <p class="chakra-desc">
 Energy-budget dispatcher. Uses Butler-Volmer electrochemical
 kinetics (NINA) to score each compute path β€” CPU, GPU,
 QUANTIZED, MoE β€” and route to the minimum-cost option.
 Seeds all downstream randomness via a deterministic RNG.
 </p>
 <div class="chakra-cite">
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_1_root/kernel.py#L6" target="_blank" rel="noopener">
 chakra_1_root/kernel.py:6 β€” def dispatch(…)
 </a>
 </div>
 </div>
<!-- 2: YACHAY -->
 <div class="chakra-card" aria-label="Chakra 2: YACHAY">
 <div class="chakra-number">CHAKRA 2 Β· sacral Β· ascend-2</div>
 <div class="chakra-name">YACHAY</div>
 <div class="chakra-fn">yachay(query, codex_store, pirwa_store, k, seed)</div>
 <p class="chakra-desc">
 Retrieve-and-codex kernel. Scores feature store (pirwa)
 and codex store with cosine similarity via NumPy, returning
 top-k features and top-8 codex priors to feed the proposal
 stage. No external API call β€” fully deterministic.
 </p>
 <div class="chakra-cite">
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_2_sacral/kernel.py#L2" target="_blank" rel="noopener">
 chakra_2_sacral/kernel.py:2 β€” def yachay(…)
 </a>
 </div>
 </div>
<!-- 3: RIMAY -->
 <div class="chakra-card" aria-label="Chakra 3: RIMAY">
 <div class="chakra-number">CHAKRA 3 Β· solar plexus Β· ascend-3</div>
 <div class="chakra-name">RIMAY</div>
 <div class="chakra-fn">propose(state, world, features, priors, seed)</div>
 <p class="chakra-desc">
 Proposal kernel. Distilled from vllm's multinomial sampler β€”
 blends retrieved priors with feature logits, applies softmax,
 and draws a discrete action via a seeded torch generator.
 Produces the candidate action for downstream critique.
 </p>
 <div class="chakra-cite">
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_3_solar/kernel.py#L7" target="_blank" rel="noopener">
 chakra_3_solar/kernel.py:7 β€” def propose(…)
 </a>
 </div>
 </div>
<!-- 4: YUYAY -->
 <div class="chakra-card" aria-label="Chakra 4: YUYAY">
 <div class="chakra-number">CHAKRA 4 Β· heart Β· ascend-4</div>
 <div class="chakra-name">YUYAY</div>
 <div class="chakra-fn">yuyay(proposal, axes, seed)</div>
 <p class="chakra-desc">
 9-axis critique gate. Scores the proposal across axes:
 cleanliness, horizon, resonance, frustum, gaussClosure,
 invariance, moralGrounding, ontologicalGrounding,
 measurabilityHonesty β€” with elevated thresholds on the
 two moral axes. Gate blocks commit if any axis fails.
 </p>
 <div class="chakra-cite">
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_4_heart/kernel.py#L5" target="_blank" rel="noopener">
 chakra_4_heart/kernel.py:5 β€” def yuyay(…)
 </a>
 </div>
 </div>
<!-- 5: RUWAY -->
 <div class="chakra-card" aria-label="Chakra 5: RUWAY">
 <div class="chakra-number">CHAKRA 5 Β· throat Β· ascend-5</div>
 <div class="chakra-name">RUWAY</div>
 <div class="chakra-fn">ruway(state, proposal, gate_pass, yawar_bus)</div>
 <p class="chakra-desc">
 Commit kernel. If the gate passed (YUYAY), hashes the merged
 (state, proposal, critic) triple with SHA-256, embeds the
 receipt in the new state under <code>__receipt</code>, and
 appends it to the yawar bus. If gate failed, state is frozen β€”
 no-op commit.
 </p>
 <div class="chakra-cite">
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_5_throat/kernel.py#L8" target="_blank" rel="noopener">
 chakra_5_throat/kernel.py:8 β€” def ruway(…)
 </a>
 </div>
 </div>
<!-- 6: NAWI -->
 <div class="chakra-card" aria-label="Chakra 6: NAWI">
 <div class="chakra-number">CHAKRA 6 Β· third-eye Β· ascend-6</div>
 <div class="chakra-name">NAWI</div>
 <div class="chakra-fn">tinkuy(intent, tools, seed, invoke)</div>
 <p class="chakra-desc">
 Toolcall boundary kernel. Ranks available tools by intent
 string matching, selects the highest-scored tool, constructs
 a typed argument map, and dispatches. HATUN (crown) must
 authorise which external reads NAWI may open before the call
 proceeds.
 </p>
 <div class="chakra-cite">
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_6_third_eye/kernel.py#L4" target="_blank" rel="noopener">
 chakra_6_third_eye/kernel.py:4 β€” def tinkuy(…)
 </a>
 </div>
 </div>
<!-- 7: HATUN -->
 <div class="chakra-card" aria-label="Chakra 7: HATUN">
 <div class="chakra-number">CHAKRA 7 Β· crown Β· ascend-7</div>
 <div class="chakra-name">HATUN</div>
 <div class="chakra-fn">hatun(state, proposal, critic_result, prev_hash, tripwires, timestamp)</div>
 <p class="chakra-desc">
 Crown sovereignty kernel. Chains SHA-256 over
 (prev_hash, state, proposal, critic_result, timestamp) β€”
 the continuum hash. Checks all 10 HUKLLA tripwires (T01–T10).
 Any tripwire firing freezes allegiance and halts the chain.
 Hash seeds the next tick's energy budget via KALLPA.
 </p>
 <div class="chakra-cite">
 <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_7_crown/kernel.py#L6" target="_blank" rel="noopener">
 chakra_7_crown/kernel.py:6 β€” def hatun(…)
 </a>
 </div>
 </div>
</div><!-- end chakra-grid -->
<!-- Inline SVG diagram -->
 <div class="flow-wrap" style="margin-top: 3rem;">
 <h3 style="margin-bottom: 1.5rem; font-size: 0.85rem; text-transform: uppercase; letter-spacing: 0.08em; color: var(--text-muted);">Serpentine firing order β€” ASCEND then crown loops back</h3>
 <div class="flow-svg-container">
 <img src="assets/arch_7chakra.svg" alt="7-chakra serpentine scheduler diagram" style="width:100%; border-radius: 8px;"/>
 </div>
 </div>
</div>
</section>
<!-- ======================================================
 MEMORY ATTESTATION FLOW
 ====================================================== -->
<section id="flow" aria-labelledby="flow-heading">
 <div class="container">
 <div class="section-label">Protocol</div>
 <h2 id="flow-heading">Memory Attestation Flow</h2>
 <div class="gold-bar"></div>
<p>
 The attestation pipeline is deterministic and reproducible.
 The DSSE (Dead Simple Signing Envelope) PAE v1 format wraps
 receipts before Cardano anchoring. A caller-supplied ISO-8601
 timestamp enables 5Γ— byte-identical replay for any audit.
 </p>
<div class="flow-wrap">
 <!-- Inline SVG flow diagram -->
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 120" role="img"
 aria-label="Memory attestation flow: agent input through 7-chakra schedule to Cardano anchor"
 style="width:100%; min-width:700px; display:block;">
 <title>Memory Attestation Flow</title>
 <defs>
 <marker id="arr2" markerWidth="7" markerHeight="6" refX="6" refY="3" orient="auto">
 <polygon points="0 0, 7 3, 0 6" fill="#d4af37"/>
 </marker>
 </defs>
<!-- Nodes -->
 <!-- Agent Input -->
 <rect x="10" y="40" width="120" height="40" rx="8" fill="#2d1b5e" stroke="#d4af37" stroke-width="1.2"/>
 <text x="70" y="57" text-anchor="middle" font-family="Inter,sans-serif" font-size="9" fill="#d4af37" font-weight="600">Agent Input</text>
 <text x="70" y="70" text-anchor="middle" font-family="monospace" font-size="7.5" fill="#a090c0">memory op</text>
<!-- Arrow -->
 <line x1="131" y1="60" x2="163" y2="60" stroke="#d4af37" stroke-width="1.2" marker-end="url(#arr2)"/>
<!-- 7-Chakra Schedule -->
 <rect x="165" y="30" width="150" height="60" rx="8" fill="#1a0f2e" stroke="#d4af37" stroke-width="1.5"/>
 <text x="240" y="54" text-anchor="middle" font-family="Georgia,serif" font-size="9.5" fill="#d4af37" font-weight="bold">7-Chakra</text>
 <text x="240" y="66" text-anchor="middle" font-family="Georgia,serif" font-size="9.5" fill="#d4af37" font-weight="bold">Scheduler</text>
 <text x="240" y="79" text-anchor="middle" font-family="monospace" font-size="7" fill="#7060a0">amaru_scheduler.py</text>
<!-- Arrow -->
 <line x1="316" y1="60" x2="348" y2="60" stroke="#d4af37" stroke-width="1.2" marker-end="url(#arr2)"/>
<!-- Receipt Chain -->
 <rect x="350" y="40" width="130" height="40" rx="8" fill="#2d1b5e" stroke="#d4af37" stroke-width="1.2"/>
 <text x="415" y="57" text-anchor="middle" font-family="Inter,sans-serif" font-size="9" fill="#d4af37" font-weight="600">Receipt Chain</text>
 <text x="415" y="70" text-anchor="middle" font-family="monospace" font-size="7.5" fill="#a090c0">SHA-256 per tick</text>
<!-- Arrow -->
 <line x1="481" y1="60" x2="513" y2="60" stroke="#d4af37" stroke-width="1.2" marker-end="url(#arr2)"/>
<!-- DSSE Wrap -->
 <rect x="515" y="40" width="120" height="40" rx="8" fill="#2d1b5e" stroke="#d4af37" stroke-width="1.2"/>
 <text x="575" y="57" text-anchor="middle" font-family="Inter,sans-serif" font-size="9" fill="#d4af37" font-weight="600">DSSE Wrap</text>
 <text x="575" y="70" text-anchor="middle" font-family="monospace" font-size="7.5" fill="#a090c0">PAE v1 envelope</text>
<!-- Arrow -->
 <line x1="636" y1="60" x2="668" y2="60" stroke="#d4af37" stroke-width="1.2" marker-end="url(#arr2)"/>
<!-- Cardano Anchor -->
 <rect x="670" y="30" width="150" height="60" rx="8" fill="#1a0f2e" stroke="rgba(212,175,55,0.6)" stroke-width="1.8" stroke-dasharray="4,3"/>
 <text x="745" y="54" text-anchor="middle" font-family="Georgia,serif" font-size="9" fill="#d4af37" font-weight="bold">Cardano</text>
 <text x="745" y="66" text-anchor="middle" font-family="Georgia,serif" font-size="9" fill="#d4af37" font-weight="bold">Anchor</text>
 <text x="745" y="79" text-anchor="middle" font-family="monospace" font-size="7" fill="#7060a0">optional checkpoint</text>
<!-- Labels under -->
 <text x="70" y="100" text-anchor="middle" font-family="monospace" font-size="7" fill="#5040a0">step 0</text>
 <text x="240" y="102" text-anchor="middle" font-family="monospace" font-size="7" fill="#5040a0">steps 1–7</text>
 <text x="415" y="100" text-anchor="middle" font-family="monospace" font-size="7" fill="#5040a0">step 8</text>
 <text x="575" y="100" text-anchor="middle" font-family="monospace" font-size="7" fill="#5040a0">step 9</text>
 <text x="745" y="100" text-anchor="middle" font-family="monospace" font-size="7" fill="#5040a0">step 10 (periodic)</text>
 </svg>
 </div>
<p style="margin-top: 1.5rem; font-size: 0.87rem; color: var(--text-muted);">
 <strong>Replay guarantee:</strong> caller supplies an ISO-8601 timestamp string;
 all downstream SHA-256 inputs are deterministic. Any receipt can be
 replayed 5Γ— and produce byte-identical output for audit verification.
 Source: <a href="https://github.com/szl-holdings/amaru/blob/main/src/chakras/chakra_7_crown/kernel.py#L5" target="_blank" rel="noopener">chakra_7_crown/kernel.py:5</a>.
 </p>
 </div>
</section>
<!-- ======================================================
 CARDANO ANCHORING
 ====================================================== -->
<section id="cardano" aria-labelledby="cardano-heading">
 <div class="container">
 <div class="section-label">Infrastructure</div>
 <h2 id="cardano-heading">Cardano Anchoring</h2>
 <div class="gold-bar"></div>
<p>
 <strong>Cardano is the L1 of choice for hash anchoring β€” this is not a token,
 smart contract, or new blockchain.</strong> amaru writes a checkpoint hash
 as transaction metadata on the Cardano public chain.
 Any party with a Cardano node can verify the hash against the local receipt chain.
 </p>
<div class="info-grid">
 <div class="info-card">
 <div class="icon">πŸ”</div>
 <h3>What is anchored</h3>
 <p>
 The SHA-256 continuum hash output of HATUN (crown chakra).
 Written as Cardano transaction metadata β€” a standard, low-cost
 on-chain operation requiring no custom smart contract.
 See <a href="https://docs.cardano.org/developer-resources/transaction-metadata/" target="_blank" rel="noopener">Cardano transaction metadata docs</a>.
 </p>
 </div>
 <div class="info-card">
 <div class="icon">⏱</div>
 <h3>Checkpoint cadence</h3>
 <p>
 Anchoring is <em>optional and periodic</em> β€” not every tick.
 A typical deployment checkpoints every N receipts (configurable).
 Between checkpoints, the local SHA-256 chain is auditable without
 any on-chain interaction.
 </p>
 </div>
 <div class="info-card">
 <div class="icon">🌍</div>
 <h3>Why Cardano</h3>
 <p>
 Cardano's eUTxO model provides deterministic Tx fees and
 native metadata support without EVM execution overhead.
 See <a href="https://cardano.org/what-is-ada/" target="_blank" rel="noopener">cardano.org</a>
 for the base protocol. amaru uses no ADA-specific token or
 smart contract β€” only the metadata slot.
 </p>
 </div>
 <div class="info-card">
 <div class="icon">βœ…</div>
 <h3>Verification path</h3>
 <p>
 A verifier fetches the Cardano Tx by hash, reads metadata field
 674 (community standard), and compares against the local receipt
 chain's HATUN hash. No trust in SZL Holdings required β€”
 the chain speaks for itself.
 </p>
 </div>
 </div>
<p style="margin-top:2rem; padding: 1.2rem 1.5rem; background: rgba(212,175,55,0.06); border: 1px solid var(--border); border-radius: 10px; font-size: 0.87rem;">
 <strong>Honest disclosure:</strong> amaru does not issue, sell, or hold any
 cryptocurrency or token. Cardano anchoring requires standard ADA transaction
 fees (fractions of a cent per checkpoint at current rates). SZL Holdings has
 no financial interest in ADA or Cardano ecosystem tokens.
 </p>
 </div>
</section>
<!-- ======================================================
 LIVE RECEIPT CHAIN
 ====================================================== -->
<section id="live" aria-labelledby="live-heading">
 <div class="container">
 <div class="section-label">Interactive Β· Live Space</div>
 <h2 id="live-heading">Live Receipt Chain</h2>
 <div class="gold-bar"></div>
<p>
 The live
 <a href="https://huggingface.co/spaces/SZLHOLDINGS/amaru-memory-attestation" target="_blank" rel="noopener">amaru-memory-attestation</a>
 Space runs the full 7-chakra scheduler in your browser. Submit a memory
 event, view the DSSE-wrapped receipt JSON, and inspect the growing
 Plotly receipt chain graph on the "View Chain" tab.
 </p>
<div class="iframe-container">
 <div class="iframe-header" aria-live="polite">
 <div class="live-dot" aria-hidden="true"></div>
 amaru-memory-attestation Β· SZLHOLDINGS Β· Gradio Β· Running
 <span style="margin-left:auto; opacity:0.6;">huggingface.co/spaces/SZLHOLDINGS/amaru-memory-attestation</span>
 </div>
 <iframe
 src="https://szlholdings-amaru-memory-attestation.hf.space"
 title="amaru memory attestation live demo"
 allow="accelerometer; camera; microphone; clipboard-write"
 sandbox="allow-scripts allow-same-origin allow-forms allow-popups"
 loading="lazy"
 ></iframe>
 </div>
<!-- Fallback screenshot -->
 <details style="margin-top: 1rem;">
 <summary style="cursor:pointer; color:var(--text-muted); font-size:0.85rem; padding:0.4rem 0;">
 Can't load iframe? See static screenshot
 </summary>
 <img src="assets/chart_receipt_chain.png" alt="Screenshot of amaru-memory-attestation Space showing the receipt form and DSSE envelope panel" class="screenshot-img"/>
 </details>
 </div>
</section>
<!-- ======================================================
 COMPARISON TABLE
 ====================================================== -->
<section id="compare" aria-labelledby="compare-heading">
 <div class="container">
 <div class="section-label">Honest comparison</div>
 <h2 id="compare-heading">amaru vs Memory Architectures</h2>
 <div class="gold-bar"></div>
<p>
 This table compares amaru against three mainstream agent-memory approaches
 on cryptographic auditability dimensions. Sources cited in table footer.
 </p>
<div class="table-wrap" role="region" aria-label="Comparison table">
 <table>
 <thead>
 <tr>
 <th scope="col">Feature</th>
 <th scope="col">LangChain Memory</th>
 <th scope="col">OpenAI Threads</th>
 <th scope="col">Anthropic MCP</th>
 <th scope="col">amaru</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td>Cryptographic receipt per memory op</td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-partial" aria-label="Partial">~ partial (tool-call provenance only)</span></td>
 <td class="row-amaru"><span class="check-yes" aria-label="Yes">βœ“</span> SHA-256 per tick</td>
 </tr>
 <tr>
 <td>7-step audit checkpoint pipeline</td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td class="row-amaru"><span class="check-yes" aria-label="Yes">βœ“</span> KALLPAβ†’HATUN</td>
 </tr>
 <tr>
 <td>L1 blockchain anchor (hash only)</td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td class="row-amaru"><span class="check-yes" aria-label="Yes">βœ“</span> Cardano metadata</td>
 </tr>
 <tr>
 <td>Plotly receipt chain visualization (built-in)</td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td class="row-amaru"><span class="check-yes" aria-label="Yes">βœ“</span> <a href="https://huggingface.co/spaces/SZLHOLDINGS/amaru-memory-attestation" target="_blank" rel="noopener">live Space</a></td>
 </tr>
 <tr>
 <td>5Γ— byte-identical replay</td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td><span class="check-no" aria-label="No">βœ—</span></td>
 <td class="row-amaru"><span class="check-yes" aria-label="Yes">βœ“</span> timestamp-seeded</td>
 </tr>
 <tr>
 <td>Open source (Apache 2.0)</td>
 <td><span class="check-yes" aria-label="Yes">βœ“</span></td>
 <td><span class="check-no" aria-label="No">βœ— proprietary</span></td>
 <td><span class="check-partial" aria-label="Partial">~ spec open, impl mixed</span></td>
 <td class="row-amaru"><span class="check-yes" aria-label="Yes">βœ“</span></td>
 </tr>
 <tr>
 <td>Works with any LLM / agent runtime</td>
 <td><span class="check-yes" aria-label="Yes">βœ“</span></td>
 <td><span class="check-no" aria-label="No">βœ— OpenAI only</span></td>
 <td><span class="check-yes" aria-label="Yes">βœ“</span></td>
 <td class="row-amaru"><span class="check-yes" aria-label="Yes">βœ“</span></td>
 </tr>
 </tbody>
 </table>
 </div>
<p style="font-size:0.78rem; color:var(--text-dim); margin-top:1rem;">
 Sources:
 <a href="https://python.langchain.com/docs/concepts/memory/" target="_blank" rel="noopener">LangChain Memory docs</a> Β·
 <a href="https://platform.openai.com/docs/api-reference/threads" target="_blank" rel="noopener">OpenAI Threads API</a> Β·
 <a href="https://modelcontextprotocol.io/specification" target="_blank" rel="noopener">Anthropic MCP Specification</a> Β·
 <a href="https://github.com/szl-holdings/amaru" target="_blank" rel="noopener">amaru source (szl-holdings/amaru)</a>
 </p>
 </div>
</section>
<!-- ======================================================
 WHAT THIS IS NOT
 ====================================================== -->
<section id="not-this" aria-labelledby="not-heading">
 <div class="container">
 <div class="section-label">Doctrine v6 β€” explicit scope</div>
 <h2 id="not-heading">What amaru is NOT</h2>
 <div class="gold-bar"></div>
<p>
 Precision matters. amaru has a specific, bounded scope. These are
 explicit non-claims, in alignment with SZL Holdings Doctrine v6.
 </p>
<div class="not-this-grid">
 <div class="not-this-card">
 <h3>Not a token</h3>
 <p>
 amaru does not issue, mint, sell, or require any cryptocurrency
 token. Cardano anchoring uses only standard ADA metadata
 transactions. No financial instrument is created.
 </p>
 </div>
 <div class="not-this-card">
 <h3>Not a blockchain L1</h3>
 <p>
 amaru is application software that <em>uses</em> Cardano.
 It does not operate its own consensus, node network,
 or distributed ledger. It is a receipt-minting library.
 </p>
 </div>
 <div class="not-this-card">
 <h3>Not custodial</h3>
 <p>
 SZL Holdings holds no user keys, funds, or data.
 All receipt chains run in the operator's environment.
 Cardano transactions are signed by the operator's own keys.
 </p>
 </div>
 <div class="not-this-card">
 <h3>Not a vector database</h3>
 <p>
 amaru provides attestation infrastructure. It does not
 replace or replicate vector search, semantic memory, or
 embedding stores. It layers on top of them β€” orthogonal concerns.
 </p>
 </div>
 <div class="not-this-card">
 <h3>Not a complete agent framework</h3>
 <p>
 amaru is one component in a larger stack. It handles
 memory attestation, not LLM inference, routing, or
 tool orchestration β€” see the
 <a href="https://github.com/szl-holdings/ouroboros-thesis" target="_blank" rel="noopener">ouroboros thesis</a>
 for the full picture.
 </p>
 </div>
 <div class="not-this-card">
 <h3>Not production-hardened alone</h3>
 <p>
 amaru is research-grade software (Apache 2.0). Production
 deployments should add monitoring, key management, and
 their own security review. See
 <a href="https://github.com/szl-holdings/amaru/blob/main/SECURITY.md" target="_blank" rel="noopener">SECURITY.md</a>.
 </p>
 </div>
 </div>
 </div>
</section>
<!-- ======================================================
 CITATIONS
 ====================================================== -->
<section id="citations" aria-labelledby="cite-heading">
 <div class="container">
 <div class="section-label">Sources &amp; provenance</div>
 <h2 id="cite-heading">Citations</h2>
 <div class="gold-bar"></div>
<ul class="citations-list">
 <li>
 <span class="cite-label">[1]</span>
 <strong>Cardano Protocol</strong> β€” <a href="https://cardano.org/what-is-ada/" target="_blank" rel="noopener">cardano.org/what-is-ada/</a>.
 L1 blockchain used for hash anchoring only. No endorsement implied.
 </li>
 <li>
 <span class="cite-label">[2]</span>
 <strong>Cardano Transaction Metadata</strong> β€” <a href="https://docs.cardano.org/developer-resources/transaction-metadata/" target="_blank" rel="noopener">docs.cardano.org/developer-resources/transaction-metadata/</a>.
 Used for checkpoint hash storage in field 674.
 </li>
 <li>
 <span class="cite-label">[3]</span>
 <strong>DSSE β€” Dead Simple Signing Envelope</strong> β€” Provenance-aware envelope format, PAE v1.
 <a href="https://github.com/secure-systems-lab/dsse" target="_blank" rel="noopener">github.com/secure-systems-lab/dsse</a>.
 </li>
 <li>
 <span class="cite-label">[4]</span>
 <strong>Shor, P.W. (1995)</strong> β€” "Scheme for reducing decoherence in quantum computer memory."
 <em>Phys. Rev. A</em> 52, R2493. DOI:
 <a href="https://doi.org/10.1103/PhysRevA.52.R2493" target="_blank" rel="noopener">10.1103/PhysRevA.52.R2493</a>.
 Shor-9 qubit encoding used for provenance hashes.
 </li>
 <li>
 <span class="cite-label">[5]</span>
 <strong>Lamport, L. (1978)</strong> β€” "Time, clocks, and the ordering of events in a distributed system."
 <em>CACM</em> 21(7). DOI:
 <a href="https://doi.org/10.1145/359545.359563" target="_blank" rel="noopener">10.1145/359545.359563</a>.
 Lamport timestamps used for causal ordering across distributed anchor nodes.
 </li>
 <li>
 <span class="cite-label">[6]</span>
 <strong>amaru Zenodo DOI (v1)</strong> β€” Lutar, S.P. (2026). amaru β€” Cardano-anchored governance receipt minting.
 <a href="https://doi.org/10.5281/zenodo.20434276" target="_blank" rel="noopener">doi.org/10.5281/zenodo.20434276</a>.
 </li>
 <li>
 <span class="cite-label">[7]</span>
 <strong>Ouroboros Thesis v18.0</strong> β€” Lutar, S.P. (2026). SZL Holdings v18.0 Master Thesis.
 DOI: <a href="https://doi.org/10.5281/zenodo.20434276" target="_blank" rel="noopener">10.5281/zenodo.20434276</a>.
 Mathematical foundations for amaru's convergence proofs.
 </li>
 <li>
 <span class="cite-label">[8]</span>
 <strong>RFC 9052 β€” COSE Structures and Serialization</strong> β€”
 <a href="https://www.rfc-editor.org/rfc/rfc9052" target="_blank" rel="noopener">rfc-editor.org/rfc/rfc9052</a>.
 COSE_Sign1 used for governance receipt envelope format.
 </li>
 <li>
 <span class="cite-label">[9]</span>
 <strong>LangChain Memory concepts</strong> β€”
 <a href="https://python.langchain.com/docs/concepts/memory/" target="_blank" rel="noopener">python.langchain.com/docs/concepts/memory/</a>.
 Referenced for comparison table.
 </li>
 <li>
 <span class="cite-label">[10]</span>
 <strong>OpenAI Threads API reference</strong> β€”
 <a href="https://platform.openai.com/docs/api-reference/threads" target="_blank" rel="noopener">platform.openai.com/docs/api-reference/threads</a>.
 Referenced for comparison table.
 </li>
 <li>
 <span class="cite-label">[11]</span>
 <strong>Anthropic MCP Specification</strong> β€”
 <a href="https://modelcontextprotocol.io/specification" target="_blank" rel="noopener">modelcontextprotocol.io/specification</a>.
 Referenced for comparison table.
 </li>
 </ul>
 </div>
</section>
</main><!-- end #main -->
<!-- ======================================================
 FOOTER
 ====================================================== -->
<footer>
 <div class="footer-inner">
 <div>
 <div class="footer-brand">SZL Holdings Β· amaru</div>
 <div class="footer-tagline">Memory attestation infrastructure. Not a token.</div>
 </div>
 <nav class="footer-links" aria-label="Footer links">
 <a href="https://github.com/szl-holdings/amaru" target="_blank" rel="noopener">GitHub</a>
 <a href="https://huggingface.co/SZLHOLDINGS" target="_blank" rel="noopener">Hugging Face</a>
 <a href="https://doi.org/10.5281/zenodo.20434276" target="_blank" rel="noopener">Zenodo</a>
 <a href="https://huggingface.co/spaces/SZLHOLDINGS/amaru-memory-attestation" target="_blank" rel="noopener">Live Demo</a>
 <a href="https://cardano.org" target="_blank" rel="noopener">Cardano</a>
 </nav>
 </div>
 <div class="footer-bottom">
 <span>Β© 2026 SZL Holdings Β· Apache 2.0</span>
 <span>
 Not a token Β· Not a blockchain Β· Not custodial Β·
 <a href="https://github.com/szl-holdings/amaru/blob/main/LICENSE" target="_blank" rel="noopener">License</a>
 </span>
 </div>
</footer>
</body>
</html>