vtimestamp-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vtimestamp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# vtimestamp-mcp
+
+MCP server for verifying and querying [vtimestamp](https://vtimestamp.com) proofs on the Verus blockchain.
+
+Enables AI agents (Claude Desktop, VS Code, etc.) to verify document timestamps and list all timestamps on a VerusID — directly from the blockchain.
+
+## Installation
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "vtimestamp": {
+      "command": "npx",
+      "args": ["-y", "vtimestamp-mcp"]
+    }
+  }
+}
+```
+
+Using yarn:
+
+```json
+{
+  "mcpServers": {
+    "vtimestamp": {
+      "command": "yarn",
+      "args": ["dlx", "vtimestamp-mcp"]
+    }
+  }
+}
+```
+
+Using pnpm:
+
+```json
+{
+  "mcpServers": {
+    "vtimestamp": {
+      "command": "pnpm",
+      "args": ["dlx", "vtimestamp-mcp"]
+    }
+  }
+}
+```
+
+### VS Code
+
+Add to your VS Code MCP settings:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "vtimestamp": {
+        "command": "npx",
+        "args": ["-y", "vtimestamp-mcp"]
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### `vtimestamp_verify`
+
+Verify whether a document hash has been timestamped on a VerusID.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `identity` | string | Yes | VerusID name (e.g., `alice@`) |
+| `hash` | string | Yes | SHA-256 hash (64-character hex string) |
+| `network` | string | No | `mainnet` (default) or `testnet` |
+
+**Example:** "Can you check if my document has been timestamped? My VerusID is alice@ and the hash is a7f3b2c1..."
+
+### `vtimestamp_list`
+
+List all timestamps recorded on a VerusID.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `identity` | string | Yes | VerusID name (e.g., `alice@`) |
+| `network` | string | No | `mainnet` (default) or `testnet` |
+
+**Example:** "What documents has alice@ timestamped?"
+
+### `vtimestamp_info`
+
+Get information about the vtimestamp service.
+
+No parameters.
+
+**Example:** "What is vtimestamp?"
+
+## How It Works
+
+The server queries the public Verus RPC endpoints to read on-chain data. No wallet interaction, no API keys, no authentication required.
+
+```
+AI Agent (Claude Desktop, VS Code, etc.)
+    │ stdio (JSON-RPC)
+    ▼
+vtimestamp-mcp (local)
+    │ HTTPS (JSON-RPC 1.0)
+    ▼
+Verus Public RPC
+    ├── mainnet: api.verus.services
+    └── testnet: api.verustest.net
+```
+
+## Requirements
+
+- Node.js 18+
+
+## License
+
+MIT

package/build/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * vtimestamp MCP Server
+ *
+ * Enables AI agents to verify and query vtimestamp proofs on the Verus blockchain.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/build/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * vtimestamp MCP Server
+ *
+ * Enables AI agents to verify and query vtimestamp proofs on the Verus blockchain.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerTools } from './tools.js';
+const server = new McpServer({
+    name: 'vtimestamp-mcp',
+    version: '1.0.0',
+});
+registerTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.on('SIGINT', async () => {
+    await server.close();
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Tool Registrations
+ *
+ * Registers vtimestamp_verify, vtimestamp_list, and vtimestamp_info tools.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/build/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8PrD"}

package/build/tools.js

@@ -0,0 +1,210 @@
+/**
+ * MCP Tool Registrations
+ *
+ * Registers vtimestamp_verify, vtimestamp_list, and vtimestamp_info tools.
+ */
+import { z } from 'zod';
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { getVdxfKeys, findTimestampByHash, parseAllTimestamps, isValidSha256, isValidIdentity } from './vdxf.js';
+import { getIdentityHistory, getBlock, VerusRpcError, RPC_ERROR_CODES } from './verus-rpc.js';
+export function registerTools(server) {
+    // ==========================================================================
+    // vtimestamp_verify
+    // ==========================================================================
+    server.tool('vtimestamp_verify', 'Verify whether a document hash has been timestamped on a VerusID. Returns blockchain proof details if found.', {
+        identity: z.string().describe('VerusID name (e.g., "alice@")'),
+        hash: z.string().describe('SHA-256 hash of the document (64-character hex string)'),
+        network: z.enum(['mainnet', 'testnet']).default('mainnet').describe('Verus network to query'),
+    }, async ({ identity, hash, network }) => {
+        if (!isValidIdentity(identity)) {
+            throw new McpError(ErrorCode.InvalidParams, 'Invalid identity format — must be a VerusID name ending with @ (e.g., "alice@")');
+        }
+        if (!isValidSha256(hash)) {
+            throw new McpError(ErrorCode.InvalidParams, 'Invalid hash format — must be a 64-character hex string');
+        }
+        try {
+            const keys = getVdxfKeys(network);
+            const historyResponse = await getIdentityHistory(identity, network);
+            const timestamp = findTimestampByHash(historyResponse.history, hash, keys);
+            if (!timestamp) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                verified: false,
+                                identity: historyResponse.fullyqualifiedname,
+                                hash,
+                                message: `No timestamp matching this hash was found on identity ${historyResponse.fullyqualifiedname}`,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            let blocktime;
+            try {
+                const block = await getBlock(timestamp.blockhash, network);
+                blocktime = block.time;
+            }
+            catch {
+                // Block time is optional
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            verified: true,
+                            identity: historyResponse.fullyqualifiedname,
+                            hash: timestamp.data.sha256,
+                            title: timestamp.data.title,
+                            description: timestamp.data.description ?? null,
+                            filename: timestamp.data.filename ?? null,
+                            filesize: timestamp.data.filesize ?? null,
+                            block_height: timestamp.blockheight,
+                            block_time: blocktime
+                                ? new Date(blocktime * 1000).toISOString()
+                                : null,
+                            block_hash: timestamp.blockhash,
+                            transaction_id: timestamp.txid,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (err instanceof VerusRpcError && err.code === RPC_ERROR_CODES.IDENTITY_NOT_FOUND) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: `Identity '${identity}' not found on ${network}`,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (err instanceof McpError)
+                throw err;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Failed to verify timestamp: ${err instanceof Error ? err.message : 'Unknown error'}`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ==========================================================================
+    // vtimestamp_list
+    // ==========================================================================
+    server.tool('vtimestamp_list', 'List all timestamps recorded on a VerusID. Returns an array of timestamps with hash, title, metadata, and blockchain proof details.', {
+        identity: z.string().describe('VerusID name (e.g., "alice@")'),
+        network: z.enum(['mainnet', 'testnet']).default('mainnet').describe('Verus network to query'),
+    }, async ({ identity, network }) => {
+        if (!isValidIdentity(identity)) {
+            throw new McpError(ErrorCode.InvalidParams, 'Invalid identity format — must be a VerusID name ending with @ (e.g., "alice@")');
+        }
+        try {
+            const keys = getVdxfKeys(network);
+            const historyResponse = await getIdentityHistory(identity, network);
+            const timestamps = parseAllTimestamps(historyResponse.history, keys);
+            // Fetch block times for all timestamps
+            const results = await Promise.all(timestamps.map(async (ts) => {
+                let blocktime;
+                try {
+                    const block = await getBlock(ts.blockhash, network);
+                    blocktime = block.time;
+                }
+                catch {
+                    // Block time is optional
+                }
+                return {
+                    hash: ts.data.sha256,
+                    title: ts.data.title,
+                    description: ts.data.description ?? null,
+                    filename: ts.data.filename ?? null,
+                    filesize: ts.data.filesize ?? null,
+                    block_height: ts.blockheight,
+                    block_time: blocktime
+                        ? new Date(blocktime * 1000).toISOString()
+                        : null,
+                    transaction_id: ts.txid,
+                };
+            }));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            identity: historyResponse.fullyqualifiedname,
+                            timestamp_count: results.length,
+                            timestamps: results,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (err instanceof VerusRpcError && err.code === RPC_ERROR_CODES.IDENTITY_NOT_FOUND) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: `Identity '${identity}' not found on ${network}`,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Failed to list timestamps: ${err instanceof Error ? err.message : 'Unknown error'}`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ==========================================================================
+    // vtimestamp_info
+    // ==========================================================================
+    server.tool('vtimestamp_info', 'Get information about the vtimestamp service — what it is, how it works, and supported features.', {}, async () => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        name: 'vtimestamp',
+                        description: 'Decentralized document timestamping on the Verus blockchain. Creates cryptographic proof that a document existed at a specific point in time. Documents never leave the user\'s device — only a SHA-256 hash is stored on-chain, tied to the user\'s VerusID (a self-sovereign blockchain identity). Anyone can verify a timestamp without an account.',
+                        website: 'https://vtimestamp.com',
+                        github: 'https://github.com/vdappdev2/vtimestamp',
+                        verification_url: 'https://vtimestamp.com/verify',
+                        features: [
+                            'Privacy-first: only hash stored, document never uploaded',
+                            'Self-sovereign: timestamps stored on user\'s own VerusID',
+                            'Permissionless verification: anyone can verify, no account needed',
+                            'Structured metadata: title, description, filename stored on-chain',
+                            'Identity-bound: proof answers both \'when\' and \'who\'',
+                            'Immutable: blockchain timestamp cannot be changed or backdated',
+                        ],
+                        supported_networks: ['mainnet', 'testnet'],
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=tools.js.map

package/build/tools.js.map

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

package/build/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * TypeScript interfaces for vtimestamp-mcp
+ */
+export interface DataDescriptor {
+    version: number;
+    flags: number;
+    objectdata: {
+        message: string;
+    } | number | null;
+    label?: string;
+    mimetype?: string;
+}
+export interface DataDescriptorWrapper {
+    [wrapperKey: string]: DataDescriptor;
+}
+export interface ContentMultiMap {
+    [outerKey: string]: DataDescriptorWrapper[];
+}
+export interface IdentityData {
+    version: number;
+    flags: number;
+    name: string;
+    identityaddress: string;
+    parent: string;
+    contentmultimap?: ContentMultiMap;
+}
+export interface IdentityHistoryEntry {
+    identity: IdentityData;
+    blockhash: string;
+    height: number;
+    output: {
+        txid: string;
+        voutnum: number;
+    };
+}
+export interface IdentityHistoryResponse {
+    fullyqualifiedname: string;
+    status: string;
+    history: IdentityHistoryEntry[];
+}
+export interface BlockData {
+    hash: string;
+    height: number;
+    time: number;
+}
+export interface TimestampData {
+    sha256: string;
+    title: string;
+    description?: string;
+    filename?: string;
+    filesize?: number;
+}
+export interface TimestampRecord {
+    data: TimestampData;
+    blockhash: string;
+    blockheight: number;
+    blocktime?: number;
+    txid: string;
+}
+export type Network = 'mainnet' | 'testnet';
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC"}

package/build/types.js

@@ -0,0 +1,5 @@
+/**
+ * TypeScript interfaces for vtimestamp-mcp
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/build/vdxf.d.ts

@@ -0,0 +1,44 @@
+/**
+ * VDXF Key Constants and Parsing Helpers
+ *
+ * Adapted from vtimestamp/src/lib/config.ts and vtimestamp/src/lib/vdxf.ts
+ */
+import type { Network, DataDescriptorWrapper, IdentityHistoryEntry, TimestampData, TimestampRecord } from './types.js';
+interface VdxfKeys {
+    proofBasic: string;
+    dataDescriptor: string;
+    labels: {
+        sha256: string;
+        title: string;
+        description: string;
+        filename: string;
+        filesize: string;
+    };
+}
+export declare function getVdxfKeys(network: Network): VdxfKeys;
+/**
+ * Parse timestamp data from a contentmultimap entry
+ */
+export declare function parseTimestampData(entries: DataDescriptorWrapper[], keys: VdxfKeys): TimestampData | null;
+/**
+ * Parse a single history entry into a TimestampRecord
+ */
+export declare function parseHistoryEntry(entry: IdentityHistoryEntry, keys: VdxfKeys): TimestampRecord | null;
+/**
+ * Parse all timestamps from identity history
+ */
+export declare function parseAllTimestamps(history: IdentityHistoryEntry[], keys: VdxfKeys): TimestampRecord[];
+/**
+ * Find a timestamp by its SHA-256 hash
+ */
+export declare function findTimestampByHash(history: IdentityHistoryEntry[], sha256: string, keys: VdxfKeys): TimestampRecord | null;
+/**
+ * Validate a SHA-256 hash string
+ */
+export declare function isValidSha256(hash: string): boolean;
+/**
+ * Validate a VerusID name (basic format check)
+ */
+export declare function isValidIdentity(identity: string): boolean;
+export {};
+//# sourceMappingURL=vdxf.d.ts.map

package/build/vdxf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vdxf.d.ts","sourceRoot":"","sources":["../src/vdxf.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EAEP,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AASpB,UAAU,QAAQ;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA0BD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAEtD;AAmCD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,qBAAqB,EAAE,EAChC,IAAI,EAAE,QAAQ,GACb,aAAa,GAAG,IAAI,CA4BtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,QAAQ,GACb,eAAe,GAAG,IAAI,CAgBxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,IAAI,EAAE,QAAQ,GACb,eAAe,EAAE,CAYnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GACb,eAAe,GAAG,IAAI,CAWxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/build/vdxf.js

@@ -0,0 +1,158 @@
+/**
+ * VDXF Key Constants and Parsing Helpers
+ *
+ * Adapted from vtimestamp/src/lib/config.ts and vtimestamp/src/lib/vdxf.ts
+ */
+// ============================================================================
+// VDXF Key Constants
+// ============================================================================
+/** DataDescriptor wrapper key (same for testnet and mainnet) */
+const DATA_DESCRIPTOR_KEY = 'i4GC1YGEVD21afWudGoFJVdnfjJ5XWnCQv';
+const TESTNET_VDXF = {
+    proofBasic: 'i6UD4js3jqyjz9Mttmbk2Sh4eCuwLKPLyQ',
+    dataDescriptor: DATA_DESCRIPTOR_KEY,
+    labels: {
+        sha256: 'iBCkvv7KC18xd3P164Cvw1pxpLo5FyGEtm',
+        title: 'iHXGu1nW4jQoeooBHPGE58qQGf9wMakEtj',
+        description: 'iP1PCTTHPpktP26xTEu1BuwENWMHQaia4D',
+        filename: 'i4xgBqX9btMX8tnAjsyVFrgSLnigxPwBw5',
+        filesize: 'iRz2tyZZEwmrxRPSrwN8UTAC8g5KyVkBiE',
+    },
+};
+const MAINNET_VDXF = {
+    proofBasic: 'iJvkQ3uTKmRoFiE3rtP8YJxryLBKu8enmX',
+    dataDescriptor: DATA_DESCRIPTOR_KEY,
+    labels: {
+        sha256: 'iPRekBwQwFxNHf6mE68n8i2iXEnVdk1hw8',
+        title: 'iJx4aJf4SRByyNAi4Z93FC7QNaysyU5mdP',
+        description: 'iS8HnXSHWPL7GLkxYS4SpC7QW2Bnyp93T2',
+        filename: 'iBTcwxUDgvqGXGMC26U52522HrsXC8ggoC',
+        filesize: 'iHBnDKDyKbXeizg322cxLUps7Uodc1udF4',
+    },
+};
+export function getVdxfKeys(network) {
+    return network === 'testnet' ? TESTNET_VDXF : MAINNET_VDXF;
+}
+// ============================================================================
+// Parsing Helpers
+// ============================================================================
+/** VDXF flag indicating a deleted/cleared entry */
+const FLAG_DELETED = 32;
+function isDeleted(descriptor) {
+    return descriptor.objectdata === null || descriptor.flags === FLAG_DELETED;
+}
+function extractStringValue(descriptor) {
+    if (descriptor.objectdata === null)
+        return undefined;
+    if (typeof descriptor.objectdata === 'object' && 'message' in descriptor.objectdata) {
+        return descriptor.objectdata.message;
+    }
+    return undefined;
+}
+function extractNumberValue(descriptor) {
+    if (typeof descriptor.objectdata === 'number') {
+        return descriptor.objectdata;
+    }
+    if (typeof descriptor.objectdata === 'object' && descriptor.objectdata !== null) {
+        const msg = descriptor.objectdata.message;
+        if (typeof msg === 'string') {
+            const num = parseInt(msg, 10);
+            if (!isNaN(num))
+                return num;
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse timestamp data from a contentmultimap entry
+ */
+export function parseTimestampData(entries, keys) {
+    const data = {};
+    for (const wrapper of entries) {
+        const descriptor = wrapper[keys.dataDescriptor];
+        if (!descriptor || isDeleted(descriptor))
+            continue;
+        const label = descriptor.label;
+        if (!label)
+            continue;
+        if (label === keys.labels.sha256) {
+            data.sha256 = extractStringValue(descriptor);
+        }
+        else if (label === keys.labels.title) {
+            data.title = extractStringValue(descriptor);
+        }
+        else if (label === keys.labels.description) {
+            data.description = extractStringValue(descriptor);
+        }
+        else if (label === keys.labels.filename) {
+            data.filename = extractStringValue(descriptor);
+        }
+        else if (label === keys.labels.filesize) {
+            data.filesize = extractNumberValue(descriptor);
+        }
+    }
+    if (!data.sha256 || !data.title) {
+        return null;
+    }
+    return data;
+}
+/**
+ * Parse a single history entry into a TimestampRecord
+ */
+export function parseHistoryEntry(entry, keys) {
+    const contentmultimap = entry.identity.contentmultimap;
+    if (!contentmultimap)
+        return null;
+    const entries = contentmultimap[keys.proofBasic];
+    if (!entries || entries.length === 0)
+        return null;
+    const data = parseTimestampData(entries, keys);
+    if (!data)
+        return null;
+    return {
+        data,
+        blockhash: entry.blockhash,
+        blockheight: entry.height,
+        txid: entry.output.txid,
+    };
+}
+/**
+ * Parse all timestamps from identity history
+ */
+export function parseAllTimestamps(history, keys) {
+    const timestamps = [];
+    for (const entry of history) {
+        const record = parseHistoryEntry(entry, keys);
+        if (record) {
+            timestamps.push(record);
+        }
+    }
+    timestamps.sort((a, b) => b.blockheight - a.blockheight);
+    return timestamps;
+}
+/**
+ * Find a timestamp by its SHA-256 hash
+ */
+export function findTimestampByHash(history, sha256, keys) {
+    const normalizedHash = sha256.toLowerCase();
+    for (const entry of history) {
+        const record = parseHistoryEntry(entry, keys);
+        if (record && record.data.sha256.toLowerCase() === normalizedHash) {
+            return record;
+        }
+    }
+    return null;
+}
+/**
+ * Validate a SHA-256 hash string
+ */
+export function isValidSha256(hash) {
+    return /^[a-fA-F0-9]{64}$/.test(hash);
+}
+/**
+ * Validate a VerusID name (basic format check)
+ */
+export function isValidIdentity(identity) {
+    return identity.endsWith('@') && identity.length >= 2;
+}
+//# sourceMappingURL=vdxf.js.map

package/build/vdxf.js.map

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

package/build/verus-rpc.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Verus RPC Client
+ *
+ * Fetch-based JSON-RPC 1.0 client with automatic fallback endpoints.
+ * Adapted from vtimestamp/src/lib/server/verus.ts
+ */
+import type { Network, IdentityHistoryResponse, BlockData } from './types.js';
+export declare class VerusRpcError extends Error {
+    code: number;
+    constructor(code: number, message: string);
+}
+export declare const RPC_ERROR_CODES: {
+    readonly IDENTITY_NOT_FOUND: -5;
+};
+export declare function getIdentityHistory(identity: string, network: Network): Promise<IdentityHistoryResponse>;
+export declare function getBlock(blockhash: string, network: Network): Promise<BlockData>;
+//# sourceMappingURL=verus-rpc.d.ts.map

package/build/verus-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verus-rpc.d.ts","sourceRoot":"","sources":["../src/verus-rpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAuB9E,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,eAAO,MAAM,eAAe;;CAElB,CAAC;AA4EX,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,SAAS,CAAC,CAEpB"}

package/build/verus-rpc.js

@@ -0,0 +1,88 @@
+/**
+ * Verus RPC Client
+ *
+ * Fetch-based JSON-RPC 1.0 client with automatic fallback endpoints.
+ * Adapted from vtimestamp/src/lib/server/verus.ts
+ */
+// ============================================================================
+// Configuration
+// ============================================================================
+const RPC_ENDPOINTS = {
+    mainnet: {
+        primary: 'https://api.verus.services',
+        fallback: 'https://rpc.vrsc.syncproof.net',
+    },
+    testnet: {
+        primary: 'https://api.verustest.net',
+        fallback: null,
+    },
+};
+const RPC_TIMEOUT = 30_000;
+// ============================================================================
+// Error Class
+// ============================================================================
+export class VerusRpcError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'VerusRpcError';
+        this.code = code;
+    }
+}
+export const RPC_ERROR_CODES = {
+    IDENTITY_NOT_FOUND: -5,
+};
+async function rpcCallToEndpoint(endpoint, method, params = []) {
+    const request = {
+        jsonrpc: '1.0',
+        id: `vtimestamp-mcp-${Date.now()}`,
+        method,
+        params,
+    };
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: { 'Content-Type': 'text/plain' },
+        body: JSON.stringify(request),
+        signal: AbortSignal.timeout(RPC_TIMEOUT),
+    });
+    if (!response.ok) {
+        throw new Error(`RPC HTTP error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (data.error) {
+        throw new VerusRpcError(data.error.code, data.error.message);
+    }
+    if (data.result === null) {
+        throw new Error(`RPC returned null result for method ${method}`);
+    }
+    return data.result;
+}
+/**
+ * Make an RPC call with automatic fallback on network errors.
+ * RPC errors (like identity not found) are NOT retried on fallback.
+ */
+async function rpcCall(network, method, params = []) {
+    const endpoints = RPC_ENDPOINTS[network];
+    try {
+        return await rpcCallToEndpoint(endpoints.primary, method, params);
+    }
+    catch (error) {
+        if (error instanceof VerusRpcError) {
+            throw error;
+        }
+        if (!endpoints.fallback) {
+            throw error;
+        }
+        return await rpcCallToEndpoint(endpoints.fallback, method, params);
+    }
+}
+// ============================================================================
+// RPC Methods
+// ============================================================================
+export async function getIdentityHistory(identity, network) {
+    return rpcCall(network, 'getidentityhistory', [identity]);
+}
+export async function getBlock(blockhash, network) {
+    return rpcCall(network, 'getblock', [blockhash]);
+}
+//# sourceMappingURL=verus-rpc.js.map

package/build/verus-rpc.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "vtimestamp-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for verifying and querying vtimestamp proofs on the Verus blockchain",
+  "type": "module",
+  "bin": {
+    "vtimestamp-mcp": "./build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "verus",
+    "timestamp",
+    "blockchain",
+    "proof-of-existence",
+    "verification"
+  ],
+  "author": "vtimestamp",
+  "license": "MIT",
+  "homepage": "https://vtimestamp.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vdappdev2/vtimestamp-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vdappdev2/vtimestamp-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}