dero-mcp-server 0.2.2 → 0.4.1

package/dist/tx-parse.js

@@ -0,0 +1,183 @@
+/**
+ * Minimal DERO transaction parser — extracts what the FORGE feature needs.
+ *
+ * Parses NORMAL, BURN_TX, and SC_TX transactions up through each payload's
+ * Statement (in particular, the `C[]` array of ring commitments). Does NOT
+ * parse the Bulletproof / sigma proofs at the end of the TX — they are large,
+ * complex, and irrelevant to forging a display-only payload proof.
+ *
+ * Wire format mirrors `transaction/transaction.go:Deserialize` (TX outer
+ * structure) and `cryptography/crypto/protocol_structures.go:Statement.Deserialize`
+ * (per-payload ring state).
+ *
+ * COINBASE / PREMINE / REGISTRATION transactions are rejected — they have no
+ * payloads, so there is nothing to forge a proof against.
+ */
+import { deroDecompress } from './bn254.js';
+export var TransactionType;
+(function (TransactionType) {
+    TransactionType[TransactionType["PREMINE"] = 0] = "PREMINE";
+    TransactionType[TransactionType["REGISTRATION"] = 1] = "REGISTRATION";
+    TransactionType[TransactionType["COINBASE"] = 2] = "COINBASE";
+    TransactionType[TransactionType["NORMAL"] = 3] = "NORMAL";
+    TransactionType[TransactionType["BURN_TX"] = 4] = "BURN_TX";
+    TransactionType[TransactionType["SC_TX"] = 5] = "SC_TX";
+})(TransactionType || (TransactionType = {}));
+const PAYLOAD_LIMIT = 145; // = 1 + 144, per transaction.go:62
+// ─────────────────────────────────────────────────────────────────────────────
+// Cursor — tracks read position through the TX byte stream.
+// ─────────────────────────────────────────────────────────────────────────────
+class Cursor {
+    bytes;
+    offset = 0;
+    constructor(bytes) {
+        this.bytes = bytes;
+    }
+    remaining() {
+        return this.bytes.length - this.offset;
+    }
+    readByte() {
+        if (this.offset >= this.bytes.length)
+            throw new Error('tx-parse: unexpected EOF');
+        return this.bytes[this.offset++];
+    }
+    readBytes(len) {
+        if (this.offset + len > this.bytes.length) {
+            throw new Error(`tx-parse: unexpected EOF (need ${len}, have ${this.remaining()})`);
+        }
+        const out = this.bytes.slice(this.offset, this.offset + len);
+        this.offset += len;
+        return out;
+    }
+    /** Go binary.Uvarint — little-endian base-128. */
+    readUvarint() {
+        let result = 0n;
+        let shift = 0n;
+        while (true) {
+            const b = this.readByte();
+            result |= BigInt(b & 0x7f) << shift;
+            if ((b & 0x80) === 0)
+                return result;
+            shift += 7n;
+            if (shift > 70n)
+                throw new Error('tx-parse: uvarint overflow');
+        }
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Parser
+// ─────────────────────────────────────────────────────────────────────────────
+function hexToBytes(hex) {
+    const clean = hex.startsWith('0x') ? hex.slice(2) : hex;
+    if (clean.length % 2 !== 0)
+        throw new Error(`tx-parse: odd hex length ${clean.length}`);
+    const out = new Uint8Array(clean.length / 2);
+    for (let i = 0; i < out.length; i++)
+        out[i] = parseInt(clean.slice(i * 2, i * 2 + 2), 16);
+    return out;
+}
+function bytesToHex(bytes) {
+    let hex = '';
+    for (const b of bytes)
+        hex += b.toString(16).padStart(2, '0');
+    return hex;
+}
+function parseStatement(cur) {
+    const power = cur.readByte();
+    if (power > 7)
+        throw new Error(`tx-parse: ring power ${power} exceeds 128 ring size`);
+    const ringSize = 1 << power;
+    const bytesPerPublickey = cur.readByte();
+    const fees = cur.readUvarint();
+    const dRaw = cur.readBytes(33);
+    const D = deroDecompress(dRaw);
+    const publickeyPointers = cur.readBytes(ringSize * bytesPerPublickey);
+    const C = [];
+    const C_hex = [];
+    for (let i = 0; i < ringSize; i++) {
+        const raw = cur.readBytes(33);
+        C.push(deroDecompress(raw));
+        C_hex.push(bytesToHex(raw));
+    }
+    const roothash = cur.readBytes(32);
+    return {
+        ring_size: ringSize,
+        bytes_per_publickey: bytesPerPublickey,
+        fees,
+        D,
+        D_hex: bytesToHex(dRaw),
+        publickey_pointers: publickeyPointers,
+        C,
+        C_hex,
+        roothash,
+    };
+}
+function parsePayload(cur) {
+    const burnValue = cur.readUvarint();
+    const scid = cur.readBytes(32);
+    const rpcType = cur.readByte();
+    const rpcPayload = cur.readBytes(PAYLOAD_LIMIT);
+    const statement = parseStatement(cur);
+    return {
+        burn_value: burnValue,
+        scid_hex: bytesToHex(scid),
+        rpc_type: rpcType,
+        rpc_payload: rpcPayload,
+        statement,
+    };
+}
+/**
+ * Parse a hex-encoded DERO transaction up through each payload's Statement.
+ * Proofs and SCDATA (after payloads) are intentionally skipped.
+ */
+export function parseTransaction(hex) {
+    const bytes = hexToBytes(hex);
+    const cur = new Cursor(bytes);
+    const version = cur.readUvarint();
+    if (version !== 1n)
+        throw new Error(`tx-parse: unsupported version ${version}`);
+    const sourceNetwork = cur.readUvarint();
+    const destNetwork = cur.readUvarint();
+    const txType = Number(cur.readUvarint());
+    if (txType !== TransactionType.NORMAL &&
+        txType !== TransactionType.BURN_TX &&
+        txType !== TransactionType.SC_TX) {
+        throw new Error(`tx-parse: unsupported transaction type ${TransactionType[txType] ?? txType} — only NORMAL, BURN_TX, and SC_TX carry payloads with C[] commitments`);
+    }
+    // SC_TX prefixes Value (gas).
+    if (txType === TransactionType.SC_TX) {
+        cur.readUvarint(); // gas — we don't need the value
+    }
+    const height = cur.readUvarint();
+    const blid = cur.readBytes(32);
+    const assetCount = cur.readUvarint();
+    if (assetCount < 1n)
+        throw new Error('tx-parse: asset_count < 1');
+    const payloads = [];
+    for (let i = 0n; i < assetCount; i++)
+        payloads.push(parsePayload(cur));
+    return {
+        version,
+        source_network: sourceNetwork,
+        dest_network: destNetwork,
+        type: txType,
+        height,
+        blid_hex: bytesToHex(blid),
+        payloads,
+        bytes_consumed: cur.offset,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Convenience: extract a single commitment.
+// ─────────────────────────────────────────────────────────────────────────────
+export function getRingCommitment(tx, ringSlot, payloadIndex = 0) {
+    if (payloadIndex < 0 || payloadIndex >= tx.payloads.length) {
+        throw new Error(`tx-parse: payload_index ${payloadIndex} out of range (have ${tx.payloads.length})`);
+    }
+    const stmt = tx.payloads[payloadIndex].statement;
+    if (ringSlot < 0 || ringSlot >= stmt.ring_size) {
+        throw new Error(`tx-parse: ring_slot ${ringSlot} out of range (ring size ${stmt.ring_size})`);
+    }
+    return stmt.C[ringSlot];
+}
+//# sourceMappingURL=tx-parse.js.map

package/dist/tx-parse.js.map

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

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "dero-mcp-server",
   "mcpName": "io.github.DHEBP/dero-mcp-server",
-  "version": "0.2.2",
+  "version": "0.4.1",
   "description": "Model Context Protocol (MCP) server exposing DERO Stargate daemon JSON-RPC and bundled documentation to Claude and other MCP clients",
   "type": "module",
   "license": "MIT",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "main": "./dist/index.js",
   "bin": {
@@ -16,6 +16,8 @@
     "dist",
     "data",
     "README.md",
+    "SKILL.md",
+    "POSITIONING.md",
     "LICENSE"
   ],
   "scripts": {
@@ -28,14 +30,21 @@
     "doctor": "./scripts/doctor.sh",
     "smoke:mcp": "npx tsx scripts/mcp-smoke-probes.ts",
     "smoke:docs": "npx tsx scripts/docs-smoke-probes.ts",
+    "smoke:http": "npm run build && npx tsx scripts/http-smoke-probes.ts",
     "test:flows": "npx tsx scripts/flow-test.ts",
     "test:composites": "npx tsx scripts/flow-composites.ts",
     "check:mcp-descriptions": "npx tsx scripts/check-mcp-descriptions.ts",
     "check:citations": "npx tsx scripts/check-citations.ts",
+    "check:curve-fixtures": "npx tsx scripts/check-curve-fixtures.ts",
+    "check:proof-roundtrip": "npx tsx scripts/check-proof-roundtrip.ts",
+    "check:tx-parse": "npx tsx scripts/check-tx-parse.ts",
+    "check:forge-demo": "npx tsx scripts/check-forge-demo.ts",
+    "check:server-json": "npx tsx scripts/check-server-json.ts",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "@noble/curves": "^2.2.0",
     "zod": "^3.25.0"
   },
   "devDependencies": {
@@ -45,10 +54,22 @@
   },
   "keywords": [
     "dero",
+    "dero-blockchain",
     "mcp",
     "model-context-protocol",
     "blockchain",
-    "json-rpc"
+    "json-rpc",
+    "privacy-blockchain",
+    "privacy-coin",
+    "private-smart-contracts",
+    "monero-alternative",
+    "private-ethereum",
+    "homomorphic-encryption",
+    "ring-signatures",
+    "bulletproofs",
+    "stargate",
+    "dvm-basic",
+    "tela"
   ],
   "repository": {
     "type": "git",