dero-mcp-server 0.1.2 → 0.4.0

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

@@ -0,0 +1,217 @@
+/**
+ * `trace_transaction_with_context` — Phase C composite #5 (final).
+ *
+ * Wedge: `dero_get_transaction` returns the raw tx record (block,
+ * ring, signer, code, balances) but leaves the agent to figure out
+ * confirmation state, classify the tx kind, and separately fetch
+ * any SC context. This composite combines all of that in one call
+ * and stitches the right docs page as a citation.
+ *
+ * Design contract § 5. Sequencing rule: SHIP
+ * LAST — highest fan-out + failure-mode count of all Phase C
+ * composites.
+ *
+ * Implementation notes (recorded honestly so the design doc and
+ * shipped surface stay in sync):
+ *
+ *   - SC INSTALL detection works directly off the tx record: when
+ *     `tx.code` is non-empty the tx_hash itself IS the resulting
+ *     SCID and the embedded code is the deployed source. We run
+ *     `extractScSurface` on `tx.code` directly — no second
+ *     `DERO.GetSC` call is needed for installs.
+ *   - SC INVOCATION arg/entrypoint decoding requires walking the
+ *     binary tx blob (`txs_as_hex`) with DERO's tx codec. That
+ *     codec is not yet bundled in this MCP, so the composite does
+ *     NOT fabricate decoded args. It surfaces `raw_tx_hex_length`
+ *     so the agent knows the binary is available via
+ *     `dero_get_transaction` if a downstream wallet wants to
+ *     decode it.
+ *   - TX_NOT_FOUND is signalled by the daemon as an EMPTY record
+ *     (`block_height: 0, in_pool: false, code: ''`) — it does
+ *     not throw. The composite detects this and throws a
+ *     classifier-friendly message so `withStructuredErrors`
+ *     surfaces `_meta.error.code = TX_NOT_FOUND`.
+ *
+ * Failure model:
+ *   - `DERO.GetTransaction` throws → propagates via
+ *     `withStructuredErrors` (RPC_UNREACHABLE / RPC_INVALID_PARAMS
+ *     classifier branches handle the daemon-side cases).
+ *   - Daemon returns empty record for the hash → composite throws
+ *     `'DERO transaction not found: ...'` → classifier returns
+ *     `TX_NOT_FOUND` with a retry hint.
+ *   - Tx found but SC surface extraction degraded for the install
+ *     case → record the surface as-is (`has_code: false`,
+ *     `functions: []`) and let the narrative explain. Never abort.
+ */
+import { z } from 'zod';
+import { attachCitations, extractScSurface, runChain, stepLatencies, stepValue, } from './_shared.js';
+const HEX64_REGEX = /^[0-9a-fA-F]{64}$/;
+const NATIVE_DERO_SCID = '0000000000000000000000000000000000000000000000000000000000000000';
+export const traceTransactionWithContextInputSchema = {
+    tx_hash: z
+        .string()
+        .regex(HEX64_REGEX, 'Expected 64-character hex transaction hash')
+        .describe('64-char hex transaction hash'),
+    decode: z
+        .boolean()
+        .optional()
+        .describe('Pass decode_as_json=1 to the daemon. Default true. Decoded JSON view is informational; the raw hex always comes back.'),
+    include_sc_context: z
+        .boolean()
+        .optional()
+        .describe('When true (default), runs the SC-install surface extraction inline when the tx contains contract code. SC invocation arg decoding is NOT performed in either mode; see module docs.'),
+};
+function classifyConfirmation(tx) {
+    if (tx.in_pool === true)
+        return 'mempool';
+    if (typeof tx.block_height === 'number' && tx.block_height > 0)
+        return 'confirmed';
+    return 'unknown';
+}
+function classifyKind(tx) {
+    if (typeof tx.code === 'string' && tx.code.length > 0)
+        return 'sc_install';
+    if (typeof tx.reward === 'number' && tx.reward > 0 && (!tx.ring || tx.ring.length === 0)) {
+        return 'coinbase';
+    }
+    if (Array.isArray(tx.ring) && tx.ring.length > 0)
+        return 'transfer_or_invocation';
+    return 'unknown';
+}
+function ringStats(tx) {
+    if (!Array.isArray(tx.ring) || tx.ring.length === 0) {
+        return { groups: null, first_group_size: null };
+    }
+    const groups = tx.ring.length;
+    const first = tx.ring[0];
+    const firstSize = Array.isArray(first) ? first.length : null;
+    return { groups, first_group_size: firstSize };
+}
+function isEmptyTxRecord(tx) {
+    if (!tx)
+        return true;
+    const noBlock = !tx.block_height || tx.block_height === 0;
+    const noPool = tx.in_pool !== true;
+    const noCode = !tx.code || tx.code.length === 0;
+    const noRing = !Array.isArray(tx.ring) || tx.ring.length === 0;
+    return noBlock && noPool && noCode && noRing;
+}
+function buildNarrative(txHash, confirmation, kind, blockHeight, scInstallSurface, ringGroups, rawHexLen, scLookupFailed) {
+    const parts = [];
+    if (confirmation === 'mempool') {
+        parts.push(`Tx ${txHash} is in the mempool (not yet confirmed). It may still be reorganized or dropped; treat the result as provisional.`);
+    }
+    else if (confirmation === 'confirmed') {
+        parts.push(`Tx ${txHash} is confirmed at block height ${blockHeight ?? 'unknown'}.`);
+    }
+    else {
+        parts.push(`Tx ${txHash} confirmation status is unknown — the daemon returned a record but did not mark it confirmed or in mempool.`);
+    }
+    if (kind === 'sc_install') {
+        if (scInstallSurface && scInstallSurface.has_code) {
+            const fnCount = scInstallSurface.functions.length;
+            const sampleFns = scInstallSurface.functions
+                .slice(0, 4)
+                .map((f) => f.name)
+                .join(', ');
+            parts.push(`Tx is a smart-contract INSTALL: the tx_hash is the resulting SCID. The deployed source carries ${fnCount} function${fnCount === 1 ? '' : 's'}${sampleFns ? ` (${sampleFns}${fnCount > 4 ? ', …' : ''})` : ''}. The composite parsed the surface inline from the embedded code; no second dero_get_sc call was needed.`);
+        }
+        else if (scLookupFailed) {
+            parts.push('Tx is a smart-contract INSTALL but the surface extractor failed to parse the embedded code. Fall back to dero_get_sc with the tx_hash as SCID for the raw payload.');
+        }
+    }
+    else if (kind === 'coinbase') {
+        parts.push('Tx is a coinbase (mining reward) — no ring members, signer is the miner address.');
+    }
+    else if (kind === 'transfer_or_invocation') {
+        parts.push(`Tx is a transfer or SC invocation. ${ringGroups ? `${ringGroups} input ring group${ringGroups === 1 ? '' : 's'} present.` : ''} SC invocation arg decoding is not surfaced by the daemon's JSON response; the ${rawHexLen}-char raw hex blob is available via dero_get_transaction if a wallet-side decoder is needed.`);
+    }
+    return parts.join(' ');
+}
+export async function traceTransactionWithContext(rpc, args) {
+    const decode = args.decode !== false;
+    const includeScContext = args.include_sc_context !== false;
+    const params = {
+        txs_hashes: [args.tx_hash],
+        decode_as_json: decode ? 1 : 0,
+    };
+    const steps = [
+        {
+            name: 'get_transaction',
+            required: true,
+            fn: () => rpc('DERO.GetTransaction', params),
+        },
+    ];
+    const chain = await runChain(steps);
+    const txResult = stepValue(chain, 'get_transaction');
+    const tx = txResult?.txs?.[0];
+    const rawHexLen = (txResult?.txs_as_hex?.[0] ?? '').length;
+    if (!tx || isEmptyTxRecord(tx)) {
+        // Daemon does not error on unknown hashes — it returns an empty record.
+        // Throw a classifier-friendly message so withStructuredErrors emits
+        // TX_NOT_FOUND.
+        throw new Error(`DERO transaction not found: ${args.tx_hash}. The daemon returned an empty record (no block_height, no mempool entry, no code, no ring).`);
+    }
+    const confirmation = classifyConfirmation(tx);
+    const kind = classifyKind(tx);
+    const { groups: ringGroups, first_group_size: firstRingSize } = ringStats(tx);
+    let scInstallSurface = null;
+    let scLookupFailed = false;
+    if (includeScContext && kind === 'sc_install') {
+        try {
+            scInstallSurface = extractScSurface({ code: tx.code });
+        }
+        catch {
+            scLookupFailed = true;
+            scInstallSurface = null;
+        }
+    }
+    const narrative = buildNarrative(args.tx_hash, confirmation, kind, typeof tx.block_height === 'number' ? tx.block_height : null, scInstallSurface, ringGroups, rawHexLen, scLookupFailed);
+    return attachCitations({
+        tx_hash: args.tx_hash,
+        confirmation: {
+            status: confirmation,
+            block_height: typeof tx.block_height === 'number' ? tx.block_height : null,
+            valid_block: typeof tx.valid_block === 'string' && tx.valid_block.length > 0 ? tx.valid_block : null,
+            invalid_blocks: Array.isArray(tx.invalid_block) ? tx.invalid_block : [],
+            in_pool: tx.in_pool === true,
+        },
+        kind,
+        ring: {
+            groups: ringGroups,
+            first_group_size: firstRingSize,
+        },
+        reward: typeof tx.reward === 'number' ? tx.reward : null,
+        signer_visible: typeof tx.signer === 'string' && tx.signer.length > 0,
+        native_balance: {
+            scid: NATIVE_DERO_SCID,
+            at_tx: typeof tx.balance === 'number' ? tx.balance : null,
+            current: typeof tx.balancenow === 'number' ? tx.balancenow : null,
+        },
+        sc_install: scInstallSurface
+            ? {
+                scid: args.tx_hash,
+                surface: {
+                    functions: scInstallSurface.functions,
+                    stringkeys: scInstallSurface.stringkeys,
+                    uint64keys: scInstallSurface.uint64keys,
+                    balances: scInstallSurface.balances,
+                },
+                raw_code_length: scInstallSurface.raw_code_length,
+                has_code: scInstallSurface.has_code,
+            }
+            : null,
+        raw_tx_hex_length: rawHexLen,
+        narrative,
+        _diagnostics: {
+            step_latency_ms: stepLatencies(chain),
+            total_ms: chain.totalMs,
+            halted_at: chain.haltedAt,
+            decode_as_json: decode,
+            include_sc_context: includeScContext,
+            sc_install_surface_attempted: includeScContext && kind === 'sc_install',
+            sc_install_surface_failed: scLookupFailed,
+        },
+    }, 'trace_transaction_with_context');
+}
+//# sourceMappingURL=trace-transaction-with-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-transaction-with-context.js","sourceRoot":"","sources":["../../src/composites/trace-transaction-with-context.ts"],"names":[],"mappings":"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"}

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,CA4ErD"}