@helm-protocol/ttt-mcp 0.1.2 → 0.1.4

package/README.md

@@ -1,5 +1,7 @@
 # @helm-protocol/ttt-mcp
 
+> Reference implementation of [draft-helmprotocol-tttps-00](https://datatracker.ietf.org/doc/draft-helmprotocol-tttps/) (IETF Experimental)
+
 **MCP Server for OpenTTT — Proof of Time tools for AI agents**
 
 > AI Agent A and Agent B both trigger a payment at the same time.
@@ -39,6 +41,55 @@ That's it. Your AI agent now has access to 5 Proof of Time tools.
 | `pot_stats` | Get turbo/full mode statistics for a time period |
 | `pot_health` | Check system health: time sources, subgraph sync, uptime |
 
+## Tool Parameters
+
+### pot_generate
+
+Generate a Proof of Time for a transaction. Returns potHash, timestamp, stratum, and GRG integrity shards.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| txHash | string | Yes | Transaction hash (hex with 0x prefix) |
+| chainId | number | Yes | Chain ID (e.g. 8453 for Base, 84532 for Base Sepolia) |
+| poolAddress | string | Yes | DEX pool contract address |
+
+### pot_verify
+
+Verify a Proof of Time using its hash and GRG shards. Returns validity, mode (turbo/full), and timestamp.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| potHash | string | Yes | PoT hash to verify (hex with 0x prefix) |
+| grgShards | string[] | Yes | Array of hex-encoded GRG integrity shards |
+| chainId | number | Yes | EVM chain ID (e.g. 84532 for Base Sepolia) |
+| poolAddress | string | Yes | Uniswap V4 pool address (0x-prefixed) |
+
+### pot_query
+
+Query Proof of Time history from local log and on-chain subgraph.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| startTime | number | No | Start time (unix ms). Default: 24h ago |
+| endTime | number | No | End time (unix ms). Default: now |
+| limit | number | No | Max entries to return. Default: 100, max: 1000 |
+
+### pot_stats
+
+Get PoT statistics: total swaps, turbo/full counts, and turbo ratio for a given period.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| period | `"day"` \| `"week"` \| `"month"` | Yes | Time period for statistics |
+
+### pot_health
+
+Check PoT system health: time source status, subgraph sync, server uptime, and current mode.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| *(none)* | — | — | This tool takes no parameters |
+
 ## Example: Generate and Verify a PoT
 
 ```typescript
@@ -64,7 +115,7 @@ const verification = await pot_verify({
 ## How It Works
 
 1. **Time Synthesis** — Queries multiple independent time sources (NIST, Google, Cloudflare) via HTTPS/NTP and synthesizes a median timestamp with uncertainty bounds
-2. **GRG Pipeline** — Encodes transaction data through a Golomb-Rice + Reed-Solomon + Golay(24,12) integrity pipeline, producing verifiable shards
+2. **GRG Pipeline** — Encodes transaction data through a multi-layer integrity pipeline, producing verifiable shards
 3. **Ed25519 Signing** — Signs the PoT hash for non-repudiation
 4. **Adaptive Mode** — Honest builders get `turbo` mode (fast, profitable); tampered sequences get `full` mode (slow, costly) — natural economic selection
 

package/dist/index.js

@@ -35,6 +35,8 @@ server.tool("pot_generate", "Generate a Proof of Time for a transaction. Returns
 server.tool("pot_verify", "Verify a Proof of Time using its hash and GRG shards. Returns validity, mode (turbo/full), and timestamp.", {
     potHash: zod_1.z.string().describe("PoT hash to verify (hex with 0x prefix)"),
     grgShards: zod_1.z.array(zod_1.z.string()).describe("Array of hex-encoded GRG integrity shards"),
+    chainId: zod_1.z.number().describe("EVM chain ID (e.g. 84532 for Base Sepolia)"),
+    poolAddress: zod_1.z.string().describe("Uniswap V4 pool address (0x-prefixed)"),
 }, async (args) => {
     try {
         const result = await (0, tools_1.potVerify)(args);

package/dist/tools.d.ts

@@ -6,6 +6,8 @@ export declare function potGenerate(args: {
 export declare function potVerify(args: {
     potHash: string;
     grgShards: string[];
+    chainId: number;
+    poolAddress: string;
 }): Promise<unknown>;
 export declare function potQuery(args: {
     startTime?: number;

package/dist/tools.js

@@ -33,7 +33,7 @@ async function potGenerate(args) {
     const potHash = openttt_1.TimeSynthesis.getOnChainHash(pot);
     // 2. GRG pipeline — encode tx data into integrity shards (black box)
     const txData = new TextEncoder().encode(args.txHash);
-    const grgShards = openttt_1.GrgPipeline.processForward(txData);
+    const grgShards = openttt_1.GrgPipeline.processForward(txData, args.chainId, args.poolAddress);
     // 3. Ed25519 sign the PoT hash for non-repudiation
     const signature = potSigner.signPot(potHash);
     // 4. Log the anchor
@@ -73,7 +73,7 @@ async function potVerify(args) {
     let valid = false;
     let reconstructedSize = 0;
     try {
-        const recovered = openttt_1.GrgPipeline.processInverse(shards, 0);
+        const recovered = openttt_1.GrgPipeline.processInverse(shards, 0, args.chainId, args.poolAddress);
         valid = recovered.length > 0;
         reconstructedSize = recovered.length;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helm-protocol/ttt-mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "MCP Server for OpenTTT — Proof of Time tools for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,8 +29,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Helm-Protocol/OpenTTT"
+    "url": "https://github.com/Helm-Protocol/OpenTTT",
+    "directory": "mcp"
   },
+  "homepage": "https://github.com/Helm-Protocol/OpenTTT/tree/main/mcp#readme",
   "engines": {
     "node": ">=18"
   },
@@ -41,5 +43,6 @@
   "devDependencies": {
     "@types/node": "^20.11.19",
     "typescript": "^5.3.3"
-  }
+  },
+  "mcpName": "io.github.Helm-Protocol/openttt-mcp"
 }