dero-mcp-server 0.2.2 → 0.4.1

package/dist/composites/forge-demo-proof.js

@@ -0,0 +1,204 @@
+/**
+ * `dero_forge_demo_proof` — composite #7.
+ *
+ * Builds a `deroproof…` display object for a chosen transaction, ring slot,
+ * and amount. The string is constructed locally from public chain data — no
+ * wallet, no keys, no broadcast. On an unpatched explorer it shows
+ * **Verified ✓** for the chosen amount; on the chain, nothing changes.
+ *
+ * Purpose: defensive demonstration of the integrity-page Part 3 forge math
+ * (`docs/integrity/inflation-claim`, Part 3). When an AI agent is asked
+ * "does this deroproof string prove the chain minted coins?", the agent can
+ * forge an equivalent string here and show, on real chain inputs, that
+ * **Verified** is a display-layer fact about the pasted object — not a
+ * consensus statement about coins moving.
+ *
+ * Math (same equation `proof.Prove()` checks at `proof/proof.go:88-95`):
+ *
+ *   blinder = C[slot] − amount × G
+ *   forged_string = bech32("deroproof", version || blinder_compressed || CBOR({HH: 0…0, VU: amount}))
+ *
+ * Self-check: amount × G + blinder == C[slot]. If this fails, the encoded
+ * string would not verify and we never return it.
+ *
+ * Read-only invariant: this tool computes a string and returns it. It does
+ * NOT touch a wallet, broadcast a transaction, or mutate any chain state.
+ * Annotation `readOnlyHint: true` is preserved.
+ */
+import { z } from 'zod';
+import { G, add, deroCompressHex, negate, pointsEqual, scalarMult, uint64ToSignedScalar, } from '../bn254.js';
+import { enrichWithFlaggedArtifacts, relatedDocsFor, } from '../citations.js';
+import { encodeForgeProofString } from '../proof-decode.js';
+import { getRingCommitment, parseTransaction } from '../tx-parse.js';
+import { runChain, stepLatencies, stepValue, } from './_shared.js';
+const ATOMIC = 100000n;
+const UINT64_MOD = 1n << 64n;
+export const forgeDemoProofInputSchema = {
+    tx_hash: z
+        .string()
+        .regex(/^[0-9a-fA-F]{64}$/, 'tx_hash must be 64 hex characters')
+        .optional()
+        .describe('TX hash to forge against. Daemon fetches the TX hex + ring members. Mutually exclusive with tx_hex.'),
+    tx_hex: z
+        .string()
+        .min(2)
+        .optional()
+        .describe('Raw TX bytes as hex (skip the daemon round-trip). Mutually exclusive with tx_hash. When provided, ring_receiver_address is omitted from the response (the hex carries publickey pointers, not full addresses).'),
+    ring_slot: z
+        .number()
+        .int()
+        .nonnegative()
+        .default(0)
+        .describe('Which ring slot 0..ring_size-1 the forged proof should resolve to. Defaults to 0.'),
+    amount_dero: z
+        .string()
+        .regex(/^-?\d+(\.\d{1,5})?$/, 'amount_dero must be a signed decimal with at most 5 fractional digits (e.g. "-1", "1000000", "-2200000.00181")')
+        .default('-1')
+        .describe('Target display amount in signed DERO (5 fractional digits = atomic precision). Negative values demonstrate the uint64 wraparound. Default "-1".'),
+};
+/**
+ * Parse a signed-decimal DERO string (e.g. "-2200000.00181") into:
+ *   - signed atoms (bigint, may be negative)
+ *   - uint64 (atoms mod 2^64)
+ */
+function parseAmount(amountDero) {
+    const negative = amountDero.startsWith('-');
+    const unsigned = negative ? amountDero.slice(1) : amountDero;
+    const dot = unsigned.indexOf('.');
+    const wholeStr = dot === -1 ? unsigned : unsigned.slice(0, dot);
+    const fracStr = dot === -1 ? '' : unsigned.slice(dot + 1);
+    const fracPadded = (fracStr + '00000').slice(0, 5);
+    const whole = BigInt(wholeStr.length === 0 ? '0' : wholeStr);
+    const frac = BigInt(fracPadded);
+    const absAtoms = whole * ATOMIC + frac;
+    const signedAtoms = negative ? -absAtoms : absAtoms;
+    const uint64 = ((signedAtoms % UINT64_MOD) + UINT64_MOD) % UINT64_MOD;
+    // Normalize the input echo so callers see the canonical form (5 fractional digits).
+    const normalized = `${negative && absAtoms > 0n ? '-' : ''}${whole.toString()}.${fracPadded}`;
+    return { signedAtoms, uint64, signedDeroNormalized: normalized };
+}
+/** Format a uint64 as the unpatched-explorer display amount (whole.fractional with 5 digits). */
+function formatExplorerDisplay(uint64) {
+    const whole = uint64 / ATOMIC;
+    const frac = uint64 % ATOMIC;
+    // Group thousands in the whole-part for readability.
+    const wholeStr = whole.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    return `${wholeStr}.${frac.toString().padStart(5, '0')} DERO`;
+}
+/**
+ * Execute the forge. Composes:
+ *   1. (optional) daemon fetch of TX hex + ring members
+ *   2. parse TX → extract C[ring_slot]
+ *   3. compute blinder = C[slot] − amount × G
+ *   4. self-check: amount × G + blinder == C[slot]
+ *   5. encode forged proof string + assemble narrative + citations
+ */
+export async function forgeDemoProof(rpc, input) {
+    if (input.tx_hash && input.tx_hex) {
+        throw new Error('INVALID_INPUT: provide exactly one of tx_hash or tx_hex (not both)');
+    }
+    if (!input.tx_hash && !input.tx_hex) {
+        throw new Error('INVALID_INPUT: provide either tx_hash or tx_hex');
+    }
+    const ringSlot = input.ring_slot ?? 0;
+    const amountDero = input.amount_dero ?? '-1';
+    // ─── 1. Fetch TX (optional daemon round-trip) ─────────────────────────────
+    let txHex;
+    let receiverAddress = null;
+    const txSource = input.tx_hash ? 'tx_hash' : 'tx_hex';
+    const steps = [];
+    if (input.tx_hash) {
+        const hash = input.tx_hash;
+        steps.push({
+            name: 'get_transaction',
+            required: true,
+            fn: () => rpc('DERO.GetTransaction', {
+                txs_hashes: [hash],
+                decode_as_json: 1,
+            }),
+        });
+    }
+    const chain = await runChain(steps);
+    if (input.tx_hash) {
+        const txResult = stepValue(chain, 'get_transaction');
+        if (!txResult || !txResult.txs_as_hex || txResult.txs_as_hex.length === 0) {
+            throw new Error(`daemon did not return TX hex for ${input.tx_hash} (chain halted at ${chain.haltedAt ?? '?'})`);
+        }
+        txHex = txResult.txs_as_hex[0];
+        const ring = txResult.txs?.[0]?.ring?.[0];
+        if (ring && ringSlot >= 0 && ringSlot < ring.length) {
+            receiverAddress = ring[ringSlot];
+        }
+    }
+    else {
+        txHex = input.tx_hex;
+    }
+    // ─── 2. Parse TX → extract C[ring_slot] ──────────────────────────────────
+    let tx;
+    try {
+        tx = parseTransaction(txHex);
+    }
+    catch (err) {
+        throw new Error(`tx-parse failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const stmt = tx.payloads[0].statement;
+    if (ringSlot >= stmt.ring_size) {
+        throw new Error(`INVALID_INPUT: ring_slot ${ringSlot} >= ring_size ${stmt.ring_size}`);
+    }
+    const Cslot = getRingCommitment(tx, ringSlot);
+    // ─── 3. Forge math ────────────────────────────────────────────────────────
+    const { signedAtoms, uint64, signedDeroNormalized } = parseAmount(amountDero);
+    const amountG = scalarMult(G, uint64ToSignedScalar(uint64));
+    const blinder = add(Cslot, negate(amountG));
+    // ─── 4. Self-check (mirror of proof.Prove() inner loop) ──────────────────
+    const reconstructed = add(amountG, blinder);
+    const verified = pointsEqual(reconstructed, Cslot);
+    if (!verified) {
+        // Should be impossible by construction — bail loud rather than emit a string
+        // that would fail an explorer check.
+        throw new Error('self-check FAILED: amount × G + blinder != C[slot] — bn254 math regression');
+    }
+    // ─── 5. Encode forged proof string ────────────────────────────────────────
+    const blinderHex = deroCompressHex(blinder);
+    const blinderBytes = new Uint8Array(33);
+    for (let i = 0; i < 33; i++)
+        blinderBytes[i] = parseInt(blinderHex.slice(i * 2, i * 2 + 2), 16);
+    const forgedString = encodeForgeProofString(blinderBytes, uint64);
+    // ─── 6. Citations + context_note enrichment ───────────────────────────────
+    const enrichment = enrichWithFlaggedArtifacts({
+        ...(input.tx_hash ? { tx_hash: input.tx_hash } : {}),
+    }, relatedDocsFor('dero_forge_demo_proof'));
+    const related_docs = enrichment?.related_docs ?? relatedDocsFor('dero_forge_demo_proof') ?? [];
+    const context_note = enrichment?.context_note ??
+        'This is a forged display object built locally from public chain data — no wallet, no keys, no broadcast. On unpatched explorers it shows Verified ✓ for the chosen amount; on the chain, nothing changed. See related_docs for the technical rebuttal.';
+    return {
+        forged_proof_string: forgedString,
+        target_amount: {
+            dero: signedDeroNormalized,
+            atoms_signed: signedAtoms.toString(),
+            atoms_uint64: uint64.toString(),
+        },
+        ring_slot: ringSlot,
+        ring_size: stmt.ring_size,
+        ring_receiver_address: receiverAddress,
+        math: {
+            C_slot_hex: stmt.C_hex[ringSlot],
+            amount_x_G_hex: deroCompressHex(amountG),
+            blinder_hex: blinderHex,
+        },
+        self_check: {
+            verified: true,
+            method: 'Reconstructed amount × G + blinder and confirmed equal to C[slot] — same equation proof.Prove() uses (proof/proof.go:88-95).',
+        },
+        explorer_display_amount: formatExplorerDisplay(uint64),
+        context_note,
+        related_docs,
+        _diagnostics: {
+            step_latencies: stepLatencies(chain),
+            halted_at: chain.haltedAt,
+            total_ms: chain.totalMs,
+            tx_source: txSource,
+        },
+    };
+}
+//# sourceMappingURL=forge-demo-proof.js.map

package/dist/composites/forge-demo-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-demo-proof.js","sourceRoot":"","sources":["../../src/composites/forge-demo-proof.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EACL,CAAC,EACD,GAAG,EACH,eAAe,EAEf,MAAM,EACN,WAAW,EACX,UAAU,EACV,oBAAoB,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,0BAA0B,EAC1B,cAAc,GAEf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAA0B,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EACL,QAAQ,EACR,aAAa,EACb,SAAS,GAGV,MAAM,cAAc,CAAA;AAErB,MAAM,MAAM,GAAG,OAAQ,CAAA;AACvB,MAAM,UAAU,GAAG,EAAE,IAAI,GAAG,CAAA;AAE5B,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,mBAAmB,EAAE,mCAAmC,CAAC;SAC/D,QAAQ,EAAE;SACV,QAAQ,CACP,qGAAqG,CACtG;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,gNAAgN,CACjN;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,mFAAmF,CAAC;IAChG,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,KAAK,CACJ,qBAAqB,EACrB,gHAAgH,CACjH;SACA,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,iJAAiJ,CAClJ;CACK,CAAA;AAgDV;;;;GAIG;AACH,SAAS,WAAW,CAAC,UAAkB;IAKrC,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;IAC5D,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC/D,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;IACzD,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAA;IACtC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;IAEnD,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC,GAAG,UAAU,CAAA;IAErE,oFAAoF;IACpF,MAAM,UAAU,GAAG,GAAG,QAAQ,IAAI,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,UAAU,EAAE,CAAA;IAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAA;AAClE,CAAC;AAED,iGAAiG;AACjG,SAAS,qBAAqB,CAAC,MAAc;IAC3C,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;IAC7B,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC5B,qDAAqD;IACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAA;IACvE,OAAO,GAAG,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAkB,EAClB,KAA0B;IAE1B,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACvF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAA;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAA;IAE5C,6EAA6E;IAC7E,IAAI,KAAa,CAAA;IACjB,IAAI,eAAe,GAAkB,IAAI,CAAA;IACzC,MAAM,QAAQ,GAAyB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE3E,MAAM,KAAK,GAAgB,EAAE,CAAA;IAC7B,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAA;QAC1B,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,IAAI;YACd,EAAE,EAAE,GAAG,EAAE,CACP,GAAG,CAAoB,qBAAqB,EAAE;gBAC5C,UAAU,EAAE,CAAC,IAAI,CAAC;gBAClB,cAAc,EAAE,CAAC;aAClB,CAAC;SACL,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEnC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,SAAS,CAAoB,KAAK,EAAE,iBAAiB,CAAC,CAAA;QACvE,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CACb,oCAAoC,KAAK,CAAC,OAAO,qBAAqB,KAAK,CAAC,QAAQ,IAAI,GAAG,GAAG,CAC/F,CAAA;QACH,CAAC;QACD,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACzC,IAAI,IAAI,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACpD,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;QAClC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,KAAK,CAAC,MAAgB,CAAA;IAChC,CAAC;IAED,4EAA4E;IAC5E,IAAI,EAAqB,CAAA;IACzB,IAAI,CAAC;QACH,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oBAAoB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACvE,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACrC,IAAI,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,4BAA4B,QAAQ,iBAAiB,IAAI,CAAC,SAAS,EAAE,CACtE,CAAA;IACH,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE7C,6EAA6E;IAC7E,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;IAC7E,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAE3C,4EAA4E;IAC5E,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,6EAA6E;QAC7E,qCAAqC;QACrC,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAA;IACH,CAAC;IAED,6EAA6E;IAC7E,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IAC3C,MAAM,YAAY,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,YAAY,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC/F,MAAM,YAAY,GAAG,sBAAsB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IAEjE,6EAA6E;IAC7E,MAAM,UAAU,GAAG,0BAA0B,CAC3C;QACE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,EACD,cAAc,CAAC,uBAAuB,CAAC,CACxC,CAAA;IACD,MAAM,YAAY,GAChB,UAAU,EAAE,YAAY,IAAI,cAAc,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAA;IAC3E,MAAM,YAAY,GAChB,UAAU,EAAE,YAAY;QACxB,wPAAwP,CAAA;IAE1P,OAAO;QACL,mBAAmB,EAAE,YAAY;QACjC,aAAa,EAAE;YACb,IAAI,EAAE,oBAAoB;YAC1B,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE;YACpC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE;SAChC;QACD,SAAS,EAAE,QAAQ;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,qBAAqB,EAAE,eAAe;QACtC,IAAI,EAAE;YACJ,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAChC,cAAc,EAAE,eAAe,CAAC,OAAO,CAAC;YACxC,WAAW,EAAE,UAAU;SACxB;QACD,UAAU,EAAE;YACV,QAAQ,EAAE,IAAI;YACd,MAAM,EACJ,8HAA8H;SACjI;QACD,uBAAuB,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACtD,YAAY;QACZ,YAAY;QACZ,YAAY,EAAE;YACZ,cAAc,EAAE,aAAa,CAAC,KAAK,CAAC;YACpC,SAAS,EAAE,KAAK,CAAC,QAAQ;YACzB,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,SAAS,EAAE,QAAQ;SACpB;KACF,CAAA;AACH,CAAC"}

package/dist/composites/recommend-docs-path.d.ts

@@ -13,7 +13,7 @@
  * that guess: one call, one ranked answer, with citations the agent
  * can drop straight into a response.
  *
- * Design contract: `docs/composites.md` § 3. Sequencing rule: SHIP
+ * Design contract § 3. Sequencing rule: SHIP
  * THIRD. Pure docs composition — no chain reads. Proves the
  * "docs-only composite" pattern that future docs-heavy tools can
  * reuse.

package/dist/composites/recommend-docs-path.js

@@ -13,7 +13,7 @@
  * that guess: one call, one ranked answer, with citations the agent
  * can drop straight into a response.
  *
- * Design contract: `docs/composites.md` § 3. Sequencing rule: SHIP
+ * Design contract § 3. Sequencing rule: SHIP
  * THIRD. Pure docs composition — no chain reads. Proves the
  * "docs-only composite" pattern that future docs-heavy tools can
  * reuse.

package/dist/composites/trace-transaction-with-context.d.ts

@@ -7,7 +7,7 @@
  * any SC context. This composite combines all of that in one call
  * and stitches the right docs page as a citation.
  *
- * Design contract: `docs/composites.md` § 5. Sequencing rule: SHIP
+ * Design contract § 5. Sequencing rule: SHIP
  * LAST — highest fan-out + failure-mode count of all Phase C
  * composites.
  *

package/dist/composites/trace-transaction-with-context.js

@@ -7,7 +7,7 @@
  * any SC context. This composite combines all of that in one call
  * and stitches the right docs page as a citation.
  *
- * Design contract: `docs/composites.md` § 5. Sequencing rule: SHIP
+ * Design contract § 5. Sequencing rule: SHIP
  * LAST — highest fan-out + failure-mode count of all Phase C
  * composites.
  *

package/dist/daemon-base.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Baked-in third-party public mainnet daemon. Last-resort fallback so the
+ * server works with zero setup, but it is someone else's node — prefer a
+ * local derod for privacy and trust.
+ */
+export declare const PUBLIC_DAEMON_BASE = "http://82.65.143.182:10102";
+/** A derod running locally on its default RPC bind — the preferred source. */
+export declare const LOCAL_DAEMON_BASE = "http://127.0.0.1:10102";
+export type DaemonSource = 'env' | 'local' | 'public';
+export type DaemonResolution = {
+    base: string;
+    source: DaemonSource;
+};
+/**
+ * Resolve which DERO daemon the server should talk to, local-first:
+ *
+ *   1. DERO_DAEMON_URL set  → honor it verbatim (hosted deploys, custom nodes).
+ *   2. else local node up   → http://127.0.0.1:10102 (private, no third party).
+ *   3. else                 → baked-in public fallback (works with zero setup).
+ *
+ * Resolved once at startup. stdio hosts spawn a fresh process per session, so
+ * a node started later is picked up on the next launch; a long-running HTTP
+ * server re-resolves on restart.
+ */
+export declare function resolveDaemonBase(): Promise<DaemonResolution>;
+/** One-line, human-readable description of a resolution for startup logs. */
+export declare function describeDaemonResolution({ base, source }: DaemonResolution): string;
+//# sourceMappingURL=daemon-base.d.ts.map

package/dist/daemon-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-base.d.ts","sourceRoot":"","sources":["../src/daemon-base.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,+BAA+B,CAAA;AAE9D,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,2BAA2B,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAErD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,CAAA;CACrB,CAAA;AA+BD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAQnE;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,MAAM,CASnF"}

package/dist/daemon-base.js

@@ -0,0 +1,62 @@
+import { deroJsonRpc, jsonRpcEndpoint } from './rpc.js';
+/**
+ * Baked-in third-party public mainnet daemon. Last-resort fallback so the
+ * server works with zero setup, but it is someone else's node — prefer a
+ * local derod for privacy and trust.
+ */
+export const PUBLIC_DAEMON_BASE = 'http://82.65.143.182:10102';
+/** A derod running locally on its default RPC bind — the preferred source. */
+export const LOCAL_DAEMON_BASE = 'http://127.0.0.1:10102';
+function stripJsonRpc(url) {
+    return url.replace(/\/json_rpc\/?$/, '').replace(/\/+$/, '');
+}
+/**
+ * Probe a base URL to confirm a real DERO daemon answers there. Calls
+ * DERO.GetInfo rather than a bare TCP connect, so an unrelated service
+ * squatting on the port is not mistaken for a daemon. A refused connection
+ * on localhost rejects almost immediately, so this adds no meaningful
+ * startup latency when no node is running.
+ */
+async function isDeroDaemon(base, timeoutMs = 1500) {
+    try {
+        const info = await deroJsonRpc(jsonRpcEndpoint(base), 'DERO.GetInfo', undefined, { timeoutMs });
+        return (!!info &&
+            typeof info === 'object' &&
+            (typeof info.height === 'number' || typeof info.topoheight === 'number'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve which DERO daemon the server should talk to, local-first:
+ *
+ *   1. DERO_DAEMON_URL set  → honor it verbatim (hosted deploys, custom nodes).
+ *   2. else local node up   → http://127.0.0.1:10102 (private, no third party).
+ *   3. else                 → baked-in public fallback (works with zero setup).
+ *
+ * Resolved once at startup. stdio hosts spawn a fresh process per session, so
+ * a node started later is picked up on the next launch; a long-running HTTP
+ * server re-resolves on restart.
+ */
+export async function resolveDaemonBase() {
+    const fromEnv = process.env.DERO_DAEMON_URL?.trim();
+    if (fromEnv)
+        return { base: stripJsonRpc(fromEnv), source: 'env' };
+    if (await isDeroDaemon(LOCAL_DAEMON_BASE)) {
+        return { base: LOCAL_DAEMON_BASE, source: 'local' };
+    }
+    return { base: PUBLIC_DAEMON_BASE, source: 'public' };
+}
+/** One-line, human-readable description of a resolution for startup logs. */
+export function describeDaemonResolution({ base, source }) {
+    switch (source) {
+        case 'env':
+            return `daemon: ${base} (from DERO_DAEMON_URL)`;
+        case 'local':
+            return `daemon: ${base} (local node detected)`;
+        case 'public':
+            return `daemon: ${base} (no local node found — public fallback; run your own derod for privacy)`;
+    }
+}
+//# sourceMappingURL=daemon-base.js.map

package/dist/daemon-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-base.js","sourceRoot":"","sources":["../src/daemon-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,4BAA4B,CAAA;AAE9D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAA;AASzD,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,SAAS,GAAG,IAAI;IACxD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAC5B,eAAe,CAAC,IAAI,CAAC,EACrB,cAAc,EACd,SAAS,EACT,EAAE,SAAS,EAAE,CACd,CAAA;QACD,OAAO,CACL,CAAC,CAAC,IAAI;YACN,OAAO,IAAI,KAAK,QAAQ;YACxB,CAAC,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CACzE,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAA;IACnD,IAAI,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAElE,IAAI,MAAM,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;IACrD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AACvD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,wBAAwB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAoB;IACzE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,WAAW,IAAI,yBAAyB,CAAA;QACjD,KAAK,OAAO;YACV,OAAO,WAAW,IAAI,wBAAwB,CAAA;QAChD,KAAK,QAAQ;YACX,OAAO,WAAW,IAAI,0EAA0E,CAAA;IACpG,CAAC;AACH,CAAC"}

package/dist/dero-curve.d.ts

@@ -0,0 +1,79 @@
+/**
+ * DERO bn256 (alt_bn128 / bn254) constants and helpers.
+ *
+ * DERO uses the Pedersen base point `G = HashToPoint(HashtoNumber("DEROG"))`
+ * (`cryptography/crypto/algebra_pedersen.go:36`). It is NOT the standard bn254
+ * generator. Extracted once from a Go scratch program against the DEROHE
+ * Release 142 checkout — see `scripts/extract-g.go` (kept out-of-tree, regen
+ * instructions below) — and pinned here so this server does not need to
+ * reimplement HashToPoint.
+ *
+ * Wire format for compressed points (33 bytes, mirrors
+ * `cryptography/bn256/changes.go:19-35`):
+ *
+ *   bytes[0..32]  X coordinate, big-endian (32 bytes)
+ *   bytes[32]     sign byte:
+ *                   0x00 if the original Y is the smaller of the two
+ *                        square roots of x^3 + 3 mod P (i.e. Y < P - Y)
+ *                   0x01 if Y is the larger one
+ *
+ * To re-extract after a DEROHE update, drop this into
+ * `<derohe>/cmd/extract_g/main.go` and `go run ./cmd/extract_g/`:
+ *
+ *   package main
+ *   import (
+ *     "fmt"; "math/big"
+ *     "github.com/deroproject/derohe/cryptography/bn256"
+ *     "github.com/deroproject/derohe/cryptography/crypto"
+ *   )
+ *   func main() {
+ *     dump := func(l string, p *bn256.G1) { fmt.Printf("%s: %x\n", l, p.EncodeCompressed()) }
+ *     dump("G", crypto.G)
+ *     two := new(bn256.G1).Add(crypto.G, crypto.G); dump("2G", two)
+ *     dump("-G", new(bn256.G1).Neg(crypto.G))
+ *     dump("G*100000", new(bn256.G1).ScalarMult(crypto.G, new(big.Int).SetUint64(100_000)))
+ *   }
+ */
+/** Pedersen base point G, 33-byte compressed hex (DERO format). */
+export declare const DERO_G_COMPRESSED_HEX = "02eacfbf92b94015c9b0b3d901dae37ec68f74dea7e4484c76d505aade4ad7c001";
+/** bn254 prime field modulus. */
+export declare const BN254_P = 21888242871839275222246405745257275088696311157297823662689037894645226208583n;
+/** bn254 curve order (subgroup order r). */
+export declare const BN254_R = 21888242871839275222246405745257275088548364400416034343698204186575808495617n;
+/** Curve equation constant: y^2 = x^3 + B. */
+export declare const BN254_B = 3n;
+/**
+ * Cross-implementation verification fixtures — produced by the Go scratch
+ * program above and used by the TS bn254 wrapper's self-tests. If the TS
+ * implementation cannot reproduce these compressed bytes from the underlying
+ * scalar operations, the noble-curves wiring or the DERO compression format
+ * is wrong — bail before forging anything.
+ */
+export declare const CURVE_FIXTURES: {
+    /** G itself. */
+    readonly G: "02eacfbf92b94015c9b0b3d901dae37ec68f74dea7e4484c76d505aade4ad7c001";
+    /** 2G = G + G. */
+    readonly twoG: "1723c9b5c0c573e9d202fea0243d5ffa5ca5e1adcfd50d0c0d53c48e1f190e0b00";
+    /** 3G = 2G + G. */
+    readonly threeG: "187768b7ba4478fd947490d31d6f10ce393c7429e1166f42a5bbc1d9a487a33600";
+    /** -G (negation). */
+    readonly negG: "02eacfbf92b94015c9b0b3d901dae37ec68f74dea7e4484c76d505aade4ad7c000";
+    /** G * 100_000 (= 1 DERO in atomic units — the smallest "real" forge scalar). */
+    readonly gMul1Dero: "1d03a5cf6ceb36e69d4e312d9f3d8413dd463f5f3498a31468bf9b46abbdd2e001";
+    /**
+     * G * int64(uint64(18446744073709451616)) = G * -100000 — the proof.go:89
+     * scalar for the docs-page demo's -1 DERO forge. Verifies the TS
+     * uint64→signed-scalar reduction matches Go's int64 cast.
+     */
+    readonly gMulNeg1DeroAtoms: "1d03a5cf6ceb36e69d4e312d9f3d8413dd463f5f3498a31468bf9b46abbdd2e000";
+    /**
+     * G * int64(uint64(18446743853709551435)) = G * -220000000181 — the scalar
+     * proof.Prove() actually uses for the cited 2022 inflation-claim proof's V.
+     * Verifies the TS path reproduces the on-the-wire scalar for the
+     * real-world adversarial input.
+     */
+    readonly gMulCited2022V: "0a5d16be695e5ca24f8f83e6a2f39a1bafe5251b69e182efbb90d41801782d1b00";
+};
+/** Atomic units per DERO. */
+export declare const DERO_ATOMIC = 100000n;
+//# sourceMappingURL=dero-curve.d.ts.map

package/dist/dero-curve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dero-curve.d.ts","sourceRoot":"","sources":["../src/dero-curve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,uEACoC,CAAA;AAEtE,iCAAiC;AACjC,eAAO,MAAM,OAAO,iFACiD,CAAA;AAErE,4CAA4C;AAC5C,eAAO,MAAM,OAAO,iFACiD,CAAA;AAErE,8CAA8C;AAC9C,eAAO,MAAM,OAAO,KAAK,CAAA;AAEzB;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;IACzB,gBAAgB;;IAEhB,kBAAkB;;IAElB,mBAAmB;;IAEnB,qBAAqB;;IAErB,iFAAiF;;IAEjF;;;;OAIG;;IAGH;;;;;OAKG;;CAEK,CAAA;AAEV,6BAA6B;AAC7B,eAAO,MAAM,WAAW,UAAW,CAAA"}

package/dist/dero-curve.js

@@ -0,0 +1,79 @@
+/**
+ * DERO bn256 (alt_bn128 / bn254) constants and helpers.
+ *
+ * DERO uses the Pedersen base point `G = HashToPoint(HashtoNumber("DEROG"))`
+ * (`cryptography/crypto/algebra_pedersen.go:36`). It is NOT the standard bn254
+ * generator. Extracted once from a Go scratch program against the DEROHE
+ * Release 142 checkout — see `scripts/extract-g.go` (kept out-of-tree, regen
+ * instructions below) — and pinned here so this server does not need to
+ * reimplement HashToPoint.
+ *
+ * Wire format for compressed points (33 bytes, mirrors
+ * `cryptography/bn256/changes.go:19-35`):
+ *
+ *   bytes[0..32]  X coordinate, big-endian (32 bytes)
+ *   bytes[32]     sign byte:
+ *                   0x00 if the original Y is the smaller of the two
+ *                        square roots of x^3 + 3 mod P (i.e. Y < P - Y)
+ *                   0x01 if Y is the larger one
+ *
+ * To re-extract after a DEROHE update, drop this into
+ * `<derohe>/cmd/extract_g/main.go` and `go run ./cmd/extract_g/`:
+ *
+ *   package main
+ *   import (
+ *     "fmt"; "math/big"
+ *     "github.com/deroproject/derohe/cryptography/bn256"
+ *     "github.com/deroproject/derohe/cryptography/crypto"
+ *   )
+ *   func main() {
+ *     dump := func(l string, p *bn256.G1) { fmt.Printf("%s: %x\n", l, p.EncodeCompressed()) }
+ *     dump("G", crypto.G)
+ *     two := new(bn256.G1).Add(crypto.G, crypto.G); dump("2G", two)
+ *     dump("-G", new(bn256.G1).Neg(crypto.G))
+ *     dump("G*100000", new(bn256.G1).ScalarMult(crypto.G, new(big.Int).SetUint64(100_000)))
+ *   }
+ */
+/** Pedersen base point G, 33-byte compressed hex (DERO format). */
+export const DERO_G_COMPRESSED_HEX = '02eacfbf92b94015c9b0b3d901dae37ec68f74dea7e4484c76d505aade4ad7c001';
+/** bn254 prime field modulus. */
+export const BN254_P = 0x30644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47n;
+/** bn254 curve order (subgroup order r). */
+export const BN254_R = 0x30644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001n;
+/** Curve equation constant: y^2 = x^3 + B. */
+export const BN254_B = 3n;
+/**
+ * Cross-implementation verification fixtures — produced by the Go scratch
+ * program above and used by the TS bn254 wrapper's self-tests. If the TS
+ * implementation cannot reproduce these compressed bytes from the underlying
+ * scalar operations, the noble-curves wiring or the DERO compression format
+ * is wrong — bail before forging anything.
+ */
+export const CURVE_FIXTURES = {
+    /** G itself. */
+    G: '02eacfbf92b94015c9b0b3d901dae37ec68f74dea7e4484c76d505aade4ad7c001',
+    /** 2G = G + G. */
+    twoG: '1723c9b5c0c573e9d202fea0243d5ffa5ca5e1adcfd50d0c0d53c48e1f190e0b00',
+    /** 3G = 2G + G. */
+    threeG: '187768b7ba4478fd947490d31d6f10ce393c7429e1166f42a5bbc1d9a487a33600',
+    /** -G (negation). */
+    negG: '02eacfbf92b94015c9b0b3d901dae37ec68f74dea7e4484c76d505aade4ad7c000',
+    /** G * 100_000 (= 1 DERO in atomic units — the smallest "real" forge scalar). */
+    gMul1Dero: '1d03a5cf6ceb36e69d4e312d9f3d8413dd463f5f3498a31468bf9b46abbdd2e001',
+    /**
+     * G * int64(uint64(18446744073709451616)) = G * -100000 — the proof.go:89
+     * scalar for the docs-page demo's -1 DERO forge. Verifies the TS
+     * uint64→signed-scalar reduction matches Go's int64 cast.
+     */
+    gMulNeg1DeroAtoms: '1d03a5cf6ceb36e69d4e312d9f3d8413dd463f5f3498a31468bf9b46abbdd2e000',
+    /**
+     * G * int64(uint64(18446743853709551435)) = G * -220000000181 — the scalar
+     * proof.Prove() actually uses for the cited 2022 inflation-claim proof's V.
+     * Verifies the TS path reproduces the on-the-wire scalar for the
+     * real-world adversarial input.
+     */
+    gMulCited2022V: '0a5d16be695e5ca24f8f83e6a2f39a1bafe5251b69e182efbb90d41801782d1b00',
+};
+/** Atomic units per DERO. */
+export const DERO_ATOMIC = 100000n;
+//# sourceMappingURL=dero-curve.js.map

package/dist/dero-curve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dero-curve.js","sourceRoot":"","sources":["../src/dero-curve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAChC,oEAAoE,CAAA;AAEtE,iCAAiC;AACjC,MAAM,CAAC,MAAM,OAAO,GAClB,mEAAmE,CAAA;AAErE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,OAAO,GAClB,mEAAmE,CAAA;AAErE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,gBAAgB;IAChB,CAAC,EAAE,oEAAoE;IACvE,kBAAkB;IAClB,IAAI,EAAE,oEAAoE;IAC1E,mBAAmB;IACnB,MAAM,EAAE,oEAAoE;IAC5E,qBAAqB;IACrB,IAAI,EAAE,oEAAoE;IAC1E,iFAAiF;IACjF,SAAS,EAAE,oEAAoE;IAC/E;;;;OAIG;IACH,iBAAiB,EACf,oEAAoE;IACtE;;;;;OAKG;IACH,cAAc,EAAE,oEAAoE;CAC5E,CAAA;AAEV,6BAA6B;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,OAAQ,CAAA"}

package/dist/docs-parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-parse.d.ts","sourceRoot":"","sources":["../src/docs-parse.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,mDAAoD,CAAA;AAClF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKxD,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKxD,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,CAAC,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB,CAAA;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAYD,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWpE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWlD;AAyBD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAqC7E;AAED,wBAAsB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBrF"}
+{"version":3,"file":"docs-parse.d.ts","sourceRoot":"","sources":["../src/docs-parse.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,mDAAoD,CAAA;AAClF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKxD,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKxD,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,CAAC,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB,CAAA;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAYD,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWpE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWlD;AAyCD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAqC7E;AAED,wBAAsB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBrF"}

package/dist/docs-parse.js

@@ -90,7 +90,23 @@ async function walkMdxFiles(dir) {
 function buildCanonicalUrl(product, slug) {
     if (!slug)
         return `${DOC_BASE_URLS[product]}/`;
-    return `${DOC_BASE_URLS[product]}/${slug}`;
+    // .md mirror suffix points agents at the LLM-canonical Markdown surface.
+    // All four ecosystem sites (derod, tela, hologram, deropay) ship the App
+    // Router .md mirror route as of 0.2.4.
+    return `${DOC_BASE_URLS[product]}/${slug}.md`;
+}
+/**
+ * Normalize a frontmatter-supplied canonical URL so it carries the same
+ * `.md` suffix as builder-generated URLs. Without this, any MDX page that
+ * declared its own `canonicalUrl` in frontmatter would bypass the suffix
+ * and point agents at the HTML version.
+ */
+function applyMdSuffix(_product, url) {
+    // Don't double-suffix; preserve query/anchor if present.
+    const [base, rest = ''] = url.split(/(?=[?#])/);
+    if (/\.md$/.test(base) || /\.[a-z0-9]{2,5}$/i.test(base))
+        return url;
+    return `${base}.md${rest}`;
 }
 export async function indexDocsFromRoot(root) {
     const pages = [];
@@ -112,7 +128,7 @@ export async function indexDocsFromRoot(root) {
                 slug,
                 title: frontmatter.title || safeTitleFromSlug(slug),
                 description: frontmatter.description || null,
-                canonicalUrl: frontmatter.canonicalUrl || buildCanonicalUrl(product, slug),
+                canonicalUrl: applyMdSuffix(product, frontmatter.canonicalUrl || buildCanonicalUrl(product, slug)),
                 sourcePath: path.relative(root, filePath).replace(/\\/g, '/'),
                 headings,
                 plainText: mdxToPlainText(content),

package/dist/docs-parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs-parse.js","sourceRoot":"","sources":["../src/docs-parse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs-parse.js","sourceRoot":"","sources":["../src/docs-parse.ts"],"names":[],"mappings":"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"}

package/dist/http-server.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Streamable HTTP transport entry for dero-mcp-server.
+ *
+ * Same factory (`createDeroMcpServer`) as the stdio entry — just a
+ * different transport on top. Enable via `dero-mcp-server --http`
+ * or `DERO_MCP_HTTP=1` (see index.ts dispatcher).
+ *
+ * Stateless by design: each request is independent. No session
+ * tracking, no in-memory state across requests, no logs of query
+ * payloads. Pairs cleanly with read-only semantics and the
+ * privacy-first brand.
+ *
+ * Environment:
+ *   DERO_DAEMON_URL       — JSON-RPC base. If unset, resolves local-first:
+ *                           a local derod (127.0.0.1:10102) if reachable,
+ *                           else the baked-in public fallback.
+ *   DERO_MCP_HTTP_PORT    — listen port (default: 8787)
+ *   DERO_MCP_HTTP_HOST    — listen address (default: 127.0.0.1)
+ *   DERO_MCP_AUTH_TOKEN   — if set, require `Authorization: Bearer <token>`
+ *                           on /mcp. Constant-time compared. Recommended
+ *                           when binding to a public address; required
+ *                           if behind a reverse proxy without its own auth.
+ *
+ * Routes:
+ *   POST /mcp     — MCP streamable HTTP endpoint
+ *   GET  /mcp     — same (SSE compat for older clients)
+ *   GET  /health  — health check {status, version, daemon_url, daemon_source}
+ *   anything else → 404
+ *
+ * Reverse-proxy expectations:
+ *   - TLS handled upstream (Caddy / Cloudflare / etc.) — this server is
+ *     plain HTTP.
+ *   - Original client IP can be passed via X-Forwarded-For for logging;
+ *     we don't log IPs by default but the middleware reads it if present.
+ */
+export declare function startHttpServer(): Promise<void>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAsCH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAoFrD"}