@hardclaw/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,132 @@
+# HardClaw MCP Server
+
+Model Context Protocol server and TypeScript SDK for the HardClaw Proof-of-Verification protocol.
+
+## Installation
+
+```bash
+npm install -g @hardclaw/mcp-server
+```
+
+Or use directly with npx:
+
+```bash
+npx @hardclaw/mcp-server
+```
+
+## MCP Configuration
+
+Add to your MCP client settings:
+
+```json
+{
+  "mcpServers": {
+    "hardclaw": {
+      "command": "npx",
+      "args": ["-y", "@hardclaw/mcp-server"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Wallet Management
+- **create_wallet** - Generate a new wallet with BIP39 mnemonic
+- **load_wallet** - Load wallet from mnemonic phrase
+- **get_address** - Get current wallet address
+
+### Job Lifecycle
+- **submit_job** - Submit a job with bounty
+  - `description`: Job description
+  - `input`: Input data (hex or plain text)
+  - `bounty`: Bounty in HCLAW tokens
+  - `jobType`: "deterministic" or "subjective"
+  - `expectedHash`: Expected output hash (optional, for deterministic)
+  - `timeout`: Timeout in seconds (default: 3600)
+
+- **submit_solution** - Submit solution for a job
+  - `jobId`: Job ID (hex hash)
+  - `output`: Solution output (hex or plain text)
+
+- **verify_solution** - Verify a solution (verifier operation)
+  - `jobId`: Job ID
+  - `solutionId`: Solution ID
+
+### Network
+- **get_balance** - Check wallet balance
+- **list_jobs** - List available jobs
+
+## Usage Example
+
+### For Agents (Solvers)
+
+```typescript
+// 1. Create or load wallet
+await mcp.call("create_wallet");
+
+// 2. Wait for jobs from requesters
+await mcp.call("list_jobs", { limit: 5 });
+
+// 3. Execute work off-chain
+
+// 4. Submit solution
+await mcp.call("submit_solution", {
+  jobId: "abc123...",
+  output: "computation result here"
+});
+
+// 5. Earn 95% of bounty when verified
+```
+
+### For Requesters
+
+```typescript
+// 1. Load wallet
+await mcp.call("load_wallet", { 
+  mnemonic: "your twelve or twenty four words..." 
+});
+
+// 2. Submit job
+await mcp.call("submit_job", {
+  description: "Analyze sentiment of text",
+  input: "The product exceeded expectations",
+  bounty: 10,
+  jobType: "subjective"
+});
+```
+
+### For Verifiers
+
+```typescript
+// 1. Load wallet with stake
+await mcp.call("load_wallet", { mnemonic: "..." });
+
+// 2. Verify solutions
+await mcp.call("verify_solution", {
+  jobId: "abc123...",
+  solutionId: "def456..."
+});
+
+// 3. Earn 4% of bounty
+```
+
+## Network Integration
+
+The MCP server operates in local/simulation mode by default. To connect to the live network:
+
+1. Install and run `hardclaw-node`
+2. The MCP server will auto-detect and connect
+3. All operations will be broadcast to the network
+
+## Development
+
+```bash
+npm install
+npm run build
+npm start
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { HardClawSDK } from "./sdk.js";
+const sdk = new HardClawSDK();
+const server = new Server({
+    name: "hardclaw-mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+const tools = [
+    {
+        name: "create_wallet",
+        description: "Create a new HardClaw wallet with BIP39 mnemonic",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "load_wallet",
+        description: "Load wallet from mnemonic phrase",
+        inputSchema: {
+            type: "object",
+            properties: {
+                mnemonic: {
+                    type: "string",
+                    description: "BIP39 mnemonic phrase (12 or 24 words)",
+                },
+            },
+            required: ["mnemonic"],
+        },
+    },
+    {
+        name: "get_address",
+        description: "Get the current wallet address",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "submit_job",
+        description: "Submit a job to the HardClaw network with a bounty",
+        inputSchema: {
+            type: "object",
+            properties: {
+                description: {
+                    type: "string",
+                    description: "Description of the job",
+                },
+                input: {
+                    type: "string",
+                    description: "Input data (hex-encoded or plain text)",
+                },
+                bounty: {
+                    type: "number",
+                    description: "Bounty amount in HCLAW tokens",
+                },
+                jobType: {
+                    type: "string",
+                    enum: ["deterministic", "subjective"],
+                    description: "Type of job verification",
+                },
+                expectedHash: {
+                    type: "string",
+                    description: "Expected output hash for deterministic jobs (optional)",
+                },
+                timeout: {
+                    type: "number",
+                    description: "Job timeout in seconds (default: 3600)",
+                },
+            },
+            required: ["description", "input", "bounty", "jobType"],
+        },
+    },
+    {
+        name: "submit_solution",
+        description: "Submit a solution for a job",
+        inputSchema: {
+            type: "object",
+            properties: {
+                jobId: {
+                    type: "string",
+                    description: "Job ID (hex hash)",
+                },
+                output: {
+                    type: "string",
+                    description: "Solution output data (hex-encoded or plain text)",
+                },
+            },
+            required: ["jobId", "output"],
+        },
+    },
+    {
+        name: "verify_solution",
+        description: "Verify a solution against a job (verifier operation)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                jobId: {
+                    type: "string",
+                    description: "Job ID (hex hash)",
+                },
+                solutionId: {
+                    type: "string",
+                    description: "Solution ID (hex hash)",
+                },
+            },
+            required: ["jobId", "solutionId"],
+        },
+    },
+    {
+        name: "get_balance",
+        description: "Get wallet balance (requires network connection)",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "list_jobs",
+        description: "List available jobs from the network",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Maximum number of jobs to return (default: 10)",
+                },
+            },
+            required: [],
+        },
+    },
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "create_wallet": {
+                const result = sdk.createWallet();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Created new wallet\nAddress: ${result.address}\nMnemonic: ${result.mnemonic}\n\n⚠️  Save this mnemonic securely!`,
+                        },
+                    ],
+                };
+            }
+            case "load_wallet": {
+                const { mnemonic } = args;
+                const address = sdk.loadWallet(mnemonic);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Loaded wallet\nAddress: ${address}`,
+                        },
+                    ],
+                };
+            }
+            case "get_address": {
+                const address = sdk.getAddress();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: address,
+                        },
+                    ],
+                };
+            }
+            case "submit_job": {
+                const { description, input, bounty, jobType, expectedHash, timeout } = args;
+                const job = sdk.createJob({
+                    description,
+                    input,
+                    bounty,
+                    jobType,
+                    expectedHash,
+                    timeout: timeout || 3600,
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Job created:\n  ID: ${job.id}\n  Type: ${job.jobType}\n  Bounty: ${bounty} HCLAW\n  Burn: 1 HCLAW\n  Timeout: ${job.timeout}s\n\n📡 Broadcast this to the network using hardclaw-node`,
+                        },
+                    ],
+                };
+            }
+            case "submit_solution": {
+                const { jobId, output } = args;
+                const solution = sdk.createSolution(jobId, output);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Solution created:\n  Job ID: ${jobId}\n  Solution ID: ${solution.id}\n  Solver: ${solution.solver}\n\n📡 Broadcast this to the network using hardclaw-node`,
+                        },
+                    ],
+                };
+            }
+            case "verify_solution": {
+                const { jobId, solutionId } = args;
+                const result = sdk.verifySolution(jobId, solutionId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Verification result:\n  Valid: ${result.valid}\n  Reason: ${result.reason || "N/A"}\n\n${result.valid ? "✅ Solution passes verification" : "❌ Solution failed verification"}`,
+                        },
+                    ],
+                };
+            }
+            case "get_balance": {
+                const address = sdk.getAddress();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Balance for ${address}: 0.0 HCLAW\n\n⚠️  Balance lookup requires connection to hardclaw-node`,
+                        },
+                    ],
+                };
+            }
+            case "list_jobs": {
+                const { limit = 10 } = args;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Fetching ${limit} jobs from network...\n\n⚠️  Job listing requires connection to hardclaw-node`,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("HardClaw MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/sdk.d.ts

@@ -0,0 +1,48 @@
+export interface Job {
+    id: string;
+    jobType: "deterministic" | "subjective";
+    requester: string;
+    description: string;
+    input: string;
+    bounty: number;
+    burnFee: number;
+    timeout: number;
+    expectedHash?: string;
+    timestamp: number;
+}
+export interface Solution {
+    id: string;
+    jobId: string;
+    solver: string;
+    output: string;
+    timestamp: number;
+    signature: string;
+}
+export interface VerificationResult {
+    valid: boolean;
+    reason?: string;
+}
+export declare class HardClawSDK {
+    private keypair;
+    private mnemonic;
+    createWallet(): {
+        address: string;
+        mnemonic: string;
+    };
+    loadWallet(mnemonic: string): string;
+    getAddress(): string;
+    createJob(params: {
+        description: string;
+        input: string;
+        bounty: number;
+        jobType: "deterministic" | "subjective";
+        expectedHash?: string;
+        timeout: number;
+    }): Job;
+    createSolution(jobId: string, output: string): Solution;
+    verifySolution(jobId: string, solutionId: string): VerificationResult;
+    private publicKeyToAddress;
+    private hash;
+    private encodeInput;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,eAAe,GAAG,YAAY,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAuB;IAEvC,YAAY,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAWrD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAapC,UAAU,IAAI,MAAM;IAOpB,SAAS,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,eAAe,GAAG,YAAY,CAAC;QACxC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,GAAG;IAgCP,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ;IA2BvD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB;IAarE,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,WAAW;CAQpB"}

package/dist/sdk.js

@@ -0,0 +1,106 @@
+import * as nacl from "tweetnacl";
+import * as bip39 from "bip39";
+import { derivePath } from "ed25519-hd-key";
+import { createHash } from "crypto";
+export class HardClawSDK {
+    keypair = null;
+    mnemonic = null;
+    createWallet() {
+        this.mnemonic = bip39.generateMnemonic(256); // 24 words
+        const seed = bip39.mnemonicToSeedSync(this.mnemonic);
+        const derivedSeed = derivePath("m/44'/501'/0'/0'", seed.toString("hex")).key;
+        this.keypair = nacl.sign.keyPair.fromSeed(derivedSeed);
+        const address = this.publicKeyToAddress(this.keypair.publicKey);
+        return { address, mnemonic: this.mnemonic };
+    }
+    loadWallet(mnemonic) {
+        if (!bip39.validateMnemonic(mnemonic)) {
+            throw new Error("Invalid mnemonic phrase");
+        }
+        this.mnemonic = mnemonic;
+        const seed = bip39.mnemonicToSeedSync(mnemonic);
+        const derivedSeed = derivePath("m/44'/501'/0'/0'", seed.toString("hex")).key;
+        this.keypair = nacl.sign.keyPair.fromSeed(derivedSeed);
+        return this.publicKeyToAddress(this.keypair.publicKey);
+    }
+    getAddress() {
+        if (!this.keypair) {
+            throw new Error("No wallet loaded. Use createWallet() or loadWallet() first.");
+        }
+        return this.publicKeyToAddress(this.keypair.publicKey);
+    }
+    createJob(params) {
+        if (!this.keypair) {
+            throw new Error("No wallet loaded");
+        }
+        const inputData = this.encodeInput(params.input);
+        const expectedHash = params.expectedHash || this.hash(Buffer.from(inputData, "hex"));
+        const job = {
+            id: this.hash(Buffer.concat([
+                this.keypair.publicKey,
+                Buffer.from(inputData, "hex"),
+                Buffer.from(params.description),
+                Buffer.from(Date.now().toString()),
+            ])),
+            jobType: params.jobType,
+            requester: this.publicKeyToAddress(this.keypair.publicKey),
+            description: params.description,
+            input: inputData,
+            bounty: params.bounty,
+            burnFee: 1,
+            timeout: params.timeout,
+            expectedHash: params.jobType === "deterministic" ? expectedHash : undefined,
+            timestamp: Date.now(),
+        };
+        return job;
+    }
+    createSolution(jobId, output) {
+        if (!this.keypair) {
+            throw new Error("No wallet loaded");
+        }
+        const outputData = this.encodeInput(output);
+        const solutionData = Buffer.concat([
+            Buffer.from(jobId, "hex"),
+            this.keypair.publicKey,
+            Buffer.from(outputData, "hex"),
+            Buffer.from(Date.now().toString()),
+        ]);
+        const signature = nacl.sign.detached(solutionData, this.keypair.secretKey);
+        const solution = {
+            id: this.hash(solutionData),
+            jobId,
+            solver: this.publicKeyToAddress(this.keypair.publicKey),
+            output: outputData,
+            timestamp: Date.now(),
+            signature: Buffer.from(signature).toString("hex"),
+        };
+        return solution;
+    }
+    verifySolution(jobId, solutionId) {
+        // Simulated verification - in production this would:
+        // 1. Fetch the job from network
+        // 2. Fetch the solution from network
+        // 3. Verify signature
+        // 4. Check hash match (deterministic) or run Schelling voting (subjective)
+        return {
+            valid: true,
+            reason: "Verification simulated - connect to hardclaw-node for real verification",
+        };
+    }
+    publicKeyToAddress(publicKey) {
+        const hash = this.hash(Buffer.from(publicKey));
+        return `hc1${hash.slice(0, 40)}`;
+    }
+    hash(data) {
+        return createHash("blake2s256").update(data).digest("hex");
+    }
+    encodeInput(input) {
+        // If already hex, return as-is
+        if (/^[0-9a-f]+$/i.test(input)) {
+            return input.toLowerCase();
+        }
+        // Otherwise encode as hex
+        return Buffer.from(input).toString("hex");
+    }
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA6BpC,MAAM,OAAO,WAAW;IACd,OAAO,GAA4B,IAAI,CAAC;IACxC,QAAQ,GAAkB,IAAI,CAAC;IAEvC,YAAY;QACV,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW;QACxD,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QAE7E,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;QAE7E,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;IAED,SAAS,CAAC,MAOT;QACC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,YAAY,GAChB,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAElE,MAAM,GAAG,GAAQ;YACf,EAAE,EAAE,IAAI,CAAC,IAAI,CACX,MAAM,CAAC,MAAM,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,SAAS;gBACtB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;aACnC,CAAC,CACH;YACD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAC1D,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;YAC3E,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,MAAc;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,SAAS;YACtB,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;SACnC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE3E,MAAM,QAAQ,GAAa;YACzB,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YAC3B,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YACvD,MAAM,EAAE,UAAU;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;SAClD,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,UAAkB;QAC9C,qDAAqD;QACrD,gCAAgC;QAChC,qCAAqC;QACrC,sBAAsB;QACtB,2EAA2E;QAE3E,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,yEAAyE;SAClF,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,SAAqB;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACnC,CAAC;IAEO,IAAI,CAAC,IAAY;QACvB,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,+BAA+B;QAC/B,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;QACD,0BAA0B;QAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@hardclaw/mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for HardClaw - Proof-of-Verification Protocol",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "hardclaw-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "hardclaw",
+    "blockchain",
+    "proof-of-verification",
+    "agents"
+  ],
+  "author": "HardClaw Collective",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "ed25519-hd-key": "^1.3.0",
+    "tweetnacl": "^1.0.3",
+    "bip39": "^3.1.0",
+    "blake3": "^2.1.7",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+import { HardClawSDK } from "./sdk.js";
+
+const sdk = new HardClawSDK();
+
+const server = new Server(
+  {
+    name: "hardclaw-mcp",
+    version: "0.1.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+const tools: Tool[] = [
+  {
+    name: "create_wallet",
+    description: "Create a new HardClaw wallet with BIP39 mnemonic",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "load_wallet",
+    description: "Load wallet from mnemonic phrase",
+    inputSchema: {
+      type: "object",
+      properties: {
+        mnemonic: {
+          type: "string",
+          description: "BIP39 mnemonic phrase (12 or 24 words)",
+        },
+      },
+      required: ["mnemonic"],
+    },
+  },
+  {
+    name: "get_address",
+    description: "Get the current wallet address",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "submit_job",
+    description: "Submit a job to the HardClaw network with a bounty",
+    inputSchema: {
+      type: "object",
+      properties: {
+        description: {
+          type: "string",
+          description: "Description of the job",
+        },
+        input: {
+          type: "string",
+          description: "Input data (hex-encoded or plain text)",
+        },
+        bounty: {
+          type: "number",
+          description: "Bounty amount in HCLAW tokens",
+        },
+        jobType: {
+          type: "string",
+          enum: ["deterministic", "subjective"],
+          description: "Type of job verification",
+        },
+        expectedHash: {
+          type: "string",
+          description: "Expected output hash for deterministic jobs (optional)",
+        },
+        timeout: {
+          type: "number",
+          description: "Job timeout in seconds (default: 3600)",
+        },
+      },
+      required: ["description", "input", "bounty", "jobType"],
+    },
+  },
+  {
+    name: "submit_solution",
+    description: "Submit a solution for a job",
+    inputSchema: {
+      type: "object",
+      properties: {
+        jobId: {
+          type: "string",
+          description: "Job ID (hex hash)",
+        },
+        output: {
+          type: "string",
+          description: "Solution output data (hex-encoded or plain text)",
+        },
+      },
+      required: ["jobId", "output"],
+    },
+  },
+  {
+    name: "verify_solution",
+    description: "Verify a solution against a job (verifier operation)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        jobId: {
+          type: "string",
+          description: "Job ID (hex hash)",
+        },
+        solutionId: {
+          type: "string",
+          description: "Solution ID (hex hash)",
+        },
+      },
+      required: ["jobId", "solutionId"],
+    },
+  },
+  {
+    name: "get_balance",
+    description: "Get wallet balance (requires network connection)",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "list_jobs",
+    description: "List available jobs from the network",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: {
+          type: "number",
+          description: "Maximum number of jobs to return (default: 10)",
+        },
+      },
+      required: [],
+    },
+  },
+];
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools,
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case "create_wallet": {
+        const result = sdk.createWallet();
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Created new wallet\nAddress: ${result.address}\nMnemonic: ${result.mnemonic}\n\n⚠️  Save this mnemonic securely!`,
+            },
+          ],
+        };
+      }
+
+      case "load_wallet": {
+        const { mnemonic } = args as { mnemonic: string };
+        const address = sdk.loadWallet(mnemonic);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Loaded wallet\nAddress: ${address}`,
+            },
+          ],
+        };
+      }
+
+      case "get_address": {
+        const address = sdk.getAddress();
+        return {
+          content: [
+            {
+              type: "text",
+              text: address,
+            },
+          ],
+        };
+      }
+
+      case "submit_job": {
+        const { description, input, bounty, jobType, expectedHash, timeout } =
+          args as {
+            description: string;
+            input: string;
+            bounty: number;
+            jobType: "deterministic" | "subjective";
+            expectedHash?: string;
+            timeout?: number;
+          };
+
+        const job = sdk.createJob({
+          description,
+          input,
+          bounty,
+          jobType,
+          expectedHash,
+          timeout: timeout || 3600,
+        });
+
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Job created:\n  ID: ${job.id}\n  Type: ${job.jobType}\n  Bounty: ${bounty} HCLAW\n  Burn: 1 HCLAW\n  Timeout: ${job.timeout}s\n\n📡 Broadcast this to the network using hardclaw-node`,
+            },
+          ],
+        };
+      }
+
+      case "submit_solution": {
+        const { jobId, output } = args as { jobId: string; output: string };
+        const solution = sdk.createSolution(jobId, output);
+
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Solution created:\n  Job ID: ${jobId}\n  Solution ID: ${solution.id}\n  Solver: ${solution.solver}\n\n📡 Broadcast this to the network using hardclaw-node`,
+            },
+          ],
+        };
+      }
+
+      case "verify_solution": {
+        const { jobId, solutionId } = args as {
+          jobId: string;
+          solutionId: string;
+        };
+        const result = sdk.verifySolution(jobId, solutionId);
+
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Verification result:\n  Valid: ${result.valid}\n  Reason: ${result.reason || "N/A"}\n\n${result.valid ? "✅ Solution passes verification" : "❌ Solution failed verification"}`,
+            },
+          ],
+        };
+      }
+
+      case "get_balance": {
+        const address = sdk.getAddress();
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Balance for ${address}: 0.0 HCLAW\n\n⚠️  Balance lookup requires connection to hardclaw-node`,
+            },
+          ],
+        };
+      }
+
+      case "list_jobs": {
+        const { limit = 10 } = args as { limit?: number };
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Fetching ${limit} jobs from network...\n\n⚠️  Job listing requires connection to hardclaw-node`,
+            },
+          ],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${message}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("HardClaw MCP server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/src/sdk.ts

@@ -0,0 +1,164 @@
+import * as nacl from "tweetnacl";
+import * as bip39 from "bip39";
+import { derivePath } from "ed25519-hd-key";
+import { createHash } from "crypto";
+
+export interface Job {
+  id: string;
+  jobType: "deterministic" | "subjective";
+  requester: string;
+  description: string;
+  input: string;
+  bounty: number;
+  burnFee: number;
+  timeout: number;
+  expectedHash?: string;
+  timestamp: number;
+}
+
+export interface Solution {
+  id: string;
+  jobId: string;
+  solver: string;
+  output: string;
+  timestamp: number;
+  signature: string;
+}
+
+export interface VerificationResult {
+  valid: boolean;
+  reason?: string;
+}
+
+export class HardClawSDK {
+  private keypair: nacl.SignKeyPair | null = null;
+  private mnemonic: string | null = null;
+
+  createWallet(): { address: string; mnemonic: string } {
+    this.mnemonic = bip39.generateMnemonic(256); // 24 words
+    const seed = bip39.mnemonicToSeedSync(this.mnemonic);
+    const derivedSeed = derivePath("m/44'/501'/0'/0'", seed.toString("hex")).key;
+    
+    this.keypair = nacl.sign.keyPair.fromSeed(derivedSeed);
+    const address = this.publicKeyToAddress(this.keypair.publicKey);
+
+    return { address, mnemonic: this.mnemonic };
+  }
+
+  loadWallet(mnemonic: string): string {
+    if (!bip39.validateMnemonic(mnemonic)) {
+      throw new Error("Invalid mnemonic phrase");
+    }
+
+    this.mnemonic = mnemonic;
+    const seed = bip39.mnemonicToSeedSync(mnemonic);
+    const derivedSeed = derivePath("m/44'/501'/0'/0'", seed.toString("hex")).key;
+    
+    this.keypair = nacl.sign.keyPair.fromSeed(derivedSeed);
+    return this.publicKeyToAddress(this.keypair.publicKey);
+  }
+
+  getAddress(): string {
+    if (!this.keypair) {
+      throw new Error("No wallet loaded. Use createWallet() or loadWallet() first.");
+    }
+    return this.publicKeyToAddress(this.keypair.publicKey);
+  }
+
+  createJob(params: {
+    description: string;
+    input: string;
+    bounty: number;
+    jobType: "deterministic" | "subjective";
+    expectedHash?: string;
+    timeout: number;
+  }): Job {
+    if (!this.keypair) {
+      throw new Error("No wallet loaded");
+    }
+
+    const inputData = this.encodeInput(params.input);
+    const expectedHash =
+      params.expectedHash || this.hash(Buffer.from(inputData, "hex"));
+
+    const job: Job = {
+      id: this.hash(
+        Buffer.concat([
+          this.keypair.publicKey,
+          Buffer.from(inputData, "hex"),
+          Buffer.from(params.description),
+          Buffer.from(Date.now().toString()),
+        ])
+      ),
+      jobType: params.jobType,
+      requester: this.publicKeyToAddress(this.keypair.publicKey),
+      description: params.description,
+      input: inputData,
+      bounty: params.bounty,
+      burnFee: 1,
+      timeout: params.timeout,
+      expectedHash: params.jobType === "deterministic" ? expectedHash : undefined,
+      timestamp: Date.now(),
+    };
+
+    return job;
+  }
+
+  createSolution(jobId: string, output: string): Solution {
+    if (!this.keypair) {
+      throw new Error("No wallet loaded");
+    }
+
+    const outputData = this.encodeInput(output);
+    const solutionData = Buffer.concat([
+      Buffer.from(jobId, "hex"),
+      this.keypair.publicKey,
+      Buffer.from(outputData, "hex"),
+      Buffer.from(Date.now().toString()),
+    ]);
+
+    const signature = nacl.sign.detached(solutionData, this.keypair.secretKey);
+
+    const solution: Solution = {
+      id: this.hash(solutionData),
+      jobId,
+      solver: this.publicKeyToAddress(this.keypair.publicKey),
+      output: outputData,
+      timestamp: Date.now(),
+      signature: Buffer.from(signature).toString("hex"),
+    };
+
+    return solution;
+  }
+
+  verifySolution(jobId: string, solutionId: string): VerificationResult {
+    // Simulated verification - in production this would:
+    // 1. Fetch the job from network
+    // 2. Fetch the solution from network
+    // 3. Verify signature
+    // 4. Check hash match (deterministic) or run Schelling voting (subjective)
+    
+    return {
+      valid: true,
+      reason: "Verification simulated - connect to hardclaw-node for real verification",
+    };
+  }
+
+  private publicKeyToAddress(publicKey: Uint8Array): string {
+    const hash = this.hash(Buffer.from(publicKey));
+    return `hc1${hash.slice(0, 40)}`;
+  }
+
+  private hash(data: Buffer): string {
+    return createHash("blake2s256").update(data).digest("hex");
+  }
+
+  private encodeInput(input: string): string {
+    // If already hex, return as-is
+    if (/^[0-9a-f]+$/i.test(input)) {
+      return input.toLowerCase();
+    }
+    // Otherwise encode as hex
+    return Buffer.from(input).toString("hex");
+  }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}