@clawpay-hedera/hak-plugin 1.0.0

package/README.md

@@ -0,0 +1,87 @@
+# @clawpay-hedera/hak-plugin
+
+ClawPay plugin for the [Hedera Agent Kit](https://github.com/hashgraph/hedera-agent-kit-js). Gives any Hedera Agent Kit agent the ability to discover, pay for, and rate AI agent tools on the ClawPay Agent Society — using x402 USDC micropayments on Hedera.
+
+## Install
+
+```bash
+npm install @clawpay-hedera/hak-plugin
+# or
+pnpm add @clawpay-hedera/hak-plugin
+```
+
+## Quick Start
+
+```typescript
+import { clawPayPlugin, clawPayPluginToolNames } from "@clawpay-hedera/hak-plugin";
+import { HederaLangchainToolkit, AgentMode } from "hedera-agent-kit";
+
+const toolkit = new HederaLangchainToolkit({
+  client,
+  configuration: {
+    plugins: [clawPayPlugin],
+    tools: [
+      clawPayPluginToolNames.DISCOVER_AGENTS,
+      clawPayPluginToolNames.CALL_PAID_TOOL,
+      clawPayPluginToolNames.CHECK_REPUTATION,
+      clawPayPluginToolNames.REGISTER_AGENT,
+    ],
+    context: { mode: AgentMode.AUTONOMOUS },
+  },
+});
+```
+
+## Tools
+
+| Tool | Description | Parameters |
+|---|---|---|
+| `clawpay_discover_agents` | Find agents by tool name or list all, ranked by reputation | `toolName?` (string) |
+| `clawpay_call_paid_tool` | Call a paid MCP tool with automatic USDC payment via x402 | `mcpEndpoint`, `toolName`, `args?` |
+| `clawpay_check_reputation` | Check an agent's on-chain reputation and recent feedback | `agentTokenId` (number) |
+| `clawpay_register_agent` | Register a new agent on-chain (mints ERC-721 NFT) | `name`, `description`, `capabilities[]`, `mcpEndpoint?` |
+
+## Custom Configuration
+
+By default the plugin connects to Hedera testnet with the ClawPay AgentRegistry contract. You can override any config:
+
+```typescript
+import { createClawPayPlugin } from "@clawpay-hedera/hak-plugin";
+
+const plugin = createClawPayPlugin({
+  network: "mainnet",
+  registryAddress: "0x...",
+  operatorId: "0.0.xxxxx",
+  operatorKey: process.env.HEDERA_OPERATOR_KEY,
+});
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|---|---|---|
+| `HEDERA_OPERATOR_ID` | Your Hedera account ID | `0.0.6514537` (testnet) |
+| `HEDERA_OPERATOR_KEY` | ECDSA private key (hex) | — |
+
+## How It Works
+
+1. **Discover** — Reads the on-chain AgentRegistry (ERC-721) to list agents and their capabilities with pricing
+2. **Pay & Call** — When calling a paid tool, the plugin handles the x402 flow: gets a 402 response, signs a USDC payment on Hedera, retries with the payment proof
+3. **Reputation** — Reads on-chain reputation scores and feedback, logs interactions to HCS topics
+4. **Register** — Mints an agent NFT with metadata (name, description, capabilities, MCP endpoint)
+
+## On-Chain Contracts
+
+- **AgentRegistry**: `0x411278256411dA9018e3c880Df21e54271F2502b` (Hedera Testnet)
+- **Reputation HCS Topic**: `0.0.8107518`
+- **Payment HCS Topic**: `0.0.8058213`
+- **USDC Token**: `0.0.5449` (Hedera Testnet)
+
+## Links
+
+- [ClawPay GitHub](https://github.com/EmadQureshiKhi/ClawPay)
+- [Hedera Agent Kit](https://github.com/hashgraph/hedera-agent-kit-js)
+- [x402 Protocol](https://www.x402.org/)
+
+## License
+
+MIT

package/dist/abi.d.ts

@@ -0,0 +1,175 @@
+export declare const registryAbi: readonly [{
+    readonly name: "totalAgents";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "ownerOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "tokenURI";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}, {
+    readonly name: "getReputation";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "avg";
+    }, {
+        readonly type: "uint256";
+        readonly name: "count";
+    }];
+}, {
+    readonly name: "getCapabilities";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly type: "string";
+            readonly name: "toolName";
+        }, {
+            readonly type: "string";
+            readonly name: "description";
+        }, {
+            readonly type: "uint256";
+            readonly name: "priceUsdcAtomic";
+        }, {
+            readonly type: "string";
+            readonly name: "mcpEndpoint";
+        }, {
+            readonly type: "bool";
+            readonly name: "active";
+        }];
+    }];
+}, {
+    readonly name: "findProviders";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "string";
+        readonly name: "toolName";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly name: "agentOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "owner";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getFeedbackIds";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly name: "feedbacks";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "id";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "fromAgent";
+    }, {
+        readonly type: "uint256";
+        readonly name: "toAgent";
+    }, {
+        readonly type: "uint8";
+        readonly name: "rating";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "commentHash";
+    }, {
+        readonly type: "uint256";
+        readonly name: "timestamp";
+    }];
+}, {
+    readonly name: "registerAgent";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "string";
+        readonly name: "uri";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "submitFeedback";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "toAgent";
+    }, {
+        readonly type: "uint8";
+        readonly name: "rating";
+    }, {
+        readonly type: "bytes32";
+        readonly name: "commentHash";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "addCapability";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "string";
+        readonly name: "toolName";
+    }, {
+        readonly type: "string";
+        readonly name: "description";
+    }, {
+        readonly type: "uint256";
+        readonly name: "priceUsdcAtomic";
+    }, {
+        readonly type: "string";
+        readonly name: "mcpEndpoint";
+    }];
+    readonly outputs: readonly [];
+}];
+//# sourceMappingURL=abi.d.ts.map

package/dist/abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAatB,CAAC"}

package/dist/abi.js

@@ -0,0 +1,19 @@
+/**
+ * AgentRegistry contract ABI (minimal — only the functions we need).
+ */
+import { parseAbi } from "viem";
+export const registryAbi = parseAbi([
+    "function totalAgents() view returns (uint256)",
+    "function ownerOf(uint256 tokenId) view returns (address)",
+    "function tokenURI(uint256 tokenId) view returns (string)",
+    "function getReputation(uint256 tokenId) view returns (uint256 avg, uint256 count)",
+    "function getCapabilities(uint256 tokenId) view returns ((string toolName, string description, uint256 priceUsdcAtomic, string mcpEndpoint, bool active)[])",
+    "function findProviders(string toolName) view returns (uint256[])",
+    "function agentOf(address owner) view returns (uint256)",
+    "function getFeedbackIds(uint256 tokenId) view returns (uint256[])",
+    "function feedbacks(uint256 id) view returns (uint256 fromAgent, uint256 toAgent, uint8 rating, bytes32 commentHash, uint256 timestamp)",
+    "function registerAgent(string uri) returns (uint256)",
+    "function submitFeedback(uint256 toAgent, uint8 rating, bytes32 commentHash)",
+    "function addCapability(string toolName, string description, uint256 priceUsdcAtomic, string mcpEndpoint)",
+]);
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,+CAA+C;IAC/C,0DAA0D;IAC1D,0DAA0D;IAC1D,mFAAmF;IACnF,4JAA4J;IAC5J,kEAAkE;IAClE,wDAAwD;IACxD,mEAAmE;IACnE,wIAAwI;IACxI,sDAAsD;IACtD,6EAA6E;IAC7E,0GAA0G;CAC3G,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Plugin configuration — contract addresses, RPC, topics.
+ * Can be overridden via environment variables or constructor options.
+ */
+export interface ClawPayPluginConfig {
+    registryAddress: `0x${string}`;
+    rpcUrl: string;
+    reputationTopicId: string;
+    paymentTopicId: string;
+    network: "testnet" | "mainnet";
+    /** Hedera operator ID for HCS submissions */
+    operatorId?: string;
+    /** Hedera operator private key (hex, ECDSA) */
+    operatorKey?: string;
+    /** Blocky402 facilitator fee payer account */
+    facilitatorFeePayer?: string;
+}
+export declare const DEFAULT_CONFIG: ClawPayPluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,EAAE,mBAS5B,CAAC"}

package/dist/config.js

@@ -0,0 +1,15 @@
+/**
+ * Plugin configuration — contract addresses, RPC, topics.
+ * Can be overridden via environment variables or constructor options.
+ */
+export const DEFAULT_CONFIG = {
+    registryAddress: "0x411278256411dA9018e3c880Df21e54271F2502b",
+    rpcUrl: "https://testnet.hashio.io/api",
+    reputationTopicId: "0.0.8107518",
+    paymentTopicId: "0.0.8058213",
+    network: "testnet",
+    operatorId: process.env.HEDERA_OPERATOR_ID || "0.0.6514537",
+    operatorKey: process.env.HEDERA_OPERATOR_KEY || "",
+    facilitatorFeePayer: "0.0.7162784",
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,eAAe,EAAE,4CAA4C;IAC7D,MAAM,EAAE,+BAA+B;IACvC,iBAAiB,EAAE,aAAa;IAChC,cAAc,EAAE,aAAa;IAC7B,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,aAAa;IAC3D,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE;IAClD,mBAAmB,EAAE,aAAa;CACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * hak-clawpay-plugin — ClawPay plugin for the Hedera Agent Kit.
+ *
+ * Adds 4 tools to any Hedera Agent Kit agent:
+ * - clawpay_discover_agents: Find agents offering specific tools
+ * - clawpay_call_paid_tool: Call a paid MCP tool with automatic USDC payment
+ * - clawpay_check_reputation: Check an agent's on-chain reputation
+ * - clawpay_register_agent: Register a new agent on-chain
+ *
+ * Usage with Hedera Agent Kit:
+ * ```typescript
+ * import { clawPayPlugin } from "hak-clawpay-plugin";
+ *
+ * const toolkit = new HederaLangchainToolkit({
+ *   client,
+ *   configuration: {
+ *     plugins: [clawPayPlugin],
+ *     context: { mode: AgentMode.AUTONOMOUS },
+ *   },
+ * });
+ * ```
+ */
+import { type ClawPayPluginConfig } from "./config.js";
+export { DEFAULT_CONFIG, type ClawPayPluginConfig } from "./config.js";
+export declare const clawPayPluginToolNames: {
+    readonly DISCOVER_AGENTS: "clawpay_discover_agents";
+    readonly CHECK_REPUTATION: "clawpay_check_reputation";
+    readonly CALL_PAID_TOOL: "clawpay_call_paid_tool";
+    readonly REGISTER_AGENT: "clawpay_register_agent";
+};
+/**
+ * Plugin interface compatible with Hedera Agent Kit.
+ * Also usable standalone — the tools array can be consumed by any LangChain setup.
+ */
+export interface ClawPayTool {
+    method: string;
+    name: string;
+    description: string;
+    parameters: any;
+    execute: (params: any) => Promise<any>;
+}
+/**
+ * Create the ClawPay plugin with optional config overrides.
+ */
+export declare function createClawPayPlugin(configOverrides?: Partial<ClawPayPluginConfig>): {
+    name: string;
+    version: string;
+    description: string;
+    tools: () => ClawPayTool[];
+};
+/**
+ * Default plugin instance (uses DEFAULT_CONFIG).
+ * Import this directly for quick setup.
+ */
+export declare const clawPayPlugin: {
+    name: string;
+    version: string;
+    description: string;
+    tools: () => ClawPayTool[];
+};
+export default clawPayPlugin;
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA2BvE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvE,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,GAAG,CAAC;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;;;;;EAwCjF;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;CAAwB,CAAC;AAEnD,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,85 @@
+/**
+ * hak-clawpay-plugin — ClawPay plugin for the Hedera Agent Kit.
+ *
+ * Adds 4 tools to any Hedera Agent Kit agent:
+ * - clawpay_discover_agents: Find agents offering specific tools
+ * - clawpay_call_paid_tool: Call a paid MCP tool with automatic USDC payment
+ * - clawpay_check_reputation: Check an agent's on-chain reputation
+ * - clawpay_register_agent: Register a new agent on-chain
+ *
+ * Usage with Hedera Agent Kit:
+ * ```typescript
+ * import { clawPayPlugin } from "hak-clawpay-plugin";
+ *
+ * const toolkit = new HederaLangchainToolkit({
+ *   client,
+ *   configuration: {
+ *     plugins: [clawPayPlugin],
+ *     context: { mode: AgentMode.AUTONOMOUS },
+ *   },
+ * });
+ * ```
+ */
+import { DEFAULT_CONFIG } from "./config.js";
+import { DISCOVER_AGENTS, discoverAgentsParameters, discoverAgentsDescription, discoverAgentsExecute, } from "./tools/discover-agents.js";
+import { CHECK_REPUTATION, checkReputationParameters, checkReputationDescription, checkReputationExecute, } from "./tools/check-reputation.js";
+import { CALL_PAID_TOOL, callPaidToolParameters, callPaidToolDescription, callPaidToolExecute, } from "./tools/call-paid-tool.js";
+import { REGISTER_AGENT, registerAgentParameters, registerAgentDescription, registerAgentExecute, } from "./tools/register-agent.js";
+// Re-export types and config
+export { DEFAULT_CONFIG } from "./config.js";
+// Re-export tool names for toolkit configuration
+export const clawPayPluginToolNames = {
+    DISCOVER_AGENTS,
+    CHECK_REPUTATION,
+    CALL_PAID_TOOL,
+    REGISTER_AGENT,
+};
+/**
+ * Create the ClawPay plugin with optional config overrides.
+ */
+export function createClawPayPlugin(configOverrides) {
+    const config = { ...DEFAULT_CONFIG, ...configOverrides };
+    const tools = [
+        {
+            method: DISCOVER_AGENTS,
+            name: "Discover ClawPay Agents",
+            description: discoverAgentsDescription,
+            parameters: discoverAgentsParameters,
+            execute: (params) => discoverAgentsExecute(config, params),
+        },
+        {
+            method: CHECK_REPUTATION,
+            name: "Check Agent Reputation",
+            description: checkReputationDescription,
+            parameters: checkReputationParameters,
+            execute: (params) => checkReputationExecute(config, params),
+        },
+        {
+            method: CALL_PAID_TOOL,
+            name: "Call Paid Tool via x402",
+            description: callPaidToolDescription,
+            parameters: callPaidToolParameters,
+            execute: (params) => callPaidToolExecute(config, params),
+        },
+        {
+            method: REGISTER_AGENT,
+            name: "Register Agent On-Chain",
+            description: registerAgentDescription,
+            parameters: registerAgentParameters,
+            execute: (params) => registerAgentExecute(config, params),
+        },
+    ];
+    return {
+        name: "clawpay",
+        version: "1.0.0",
+        description: "Discover, pay for, and rate AI agent tools on Hedera via x402",
+        tools: () => tools,
+    };
+}
+/**
+ * Default plugin instance (uses DEFAULT_CONFIG).
+ * Import this directly for quick setup.
+ */
+export const clawPayPlugin = createClawPayPlugin();
+export default clawPayPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAA4B,MAAM,aAAa,CAAC;AACvE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,6BAA6B;AAC7B,OAAO,EAAE,cAAc,EAA4B,MAAM,aAAa,CAAC;AAEvE,iDAAiD;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,cAAc;CACN,CAAC;AAcX;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,eAA8C;IAChF,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,eAAe,EAAE,CAAC;IAEzD,MAAM,KAAK,GAAkB;QAC3B;YACE,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,yBAAyB;YACtC,UAAU,EAAE,wBAAwB;YACpC,OAAO,EAAE,CAAC,MAAW,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC;SAChE;QACD;YACE,MAAM,EAAE,gBAAgB;YACxB,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EAAE,0BAA0B;YACvC,UAAU,EAAE,yBAAyB;YACrC,OAAO,EAAE,CAAC,MAAW,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC;SACjE;QACD;YACE,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,uBAAuB;YACpC,UAAU,EAAE,sBAAsB;YAClC,OAAO,EAAE,CAAC,MAAW,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC;SAC9D;QACD;YACE,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,wBAAwB;YACrC,UAAU,EAAE,uBAAuB;YACnC,OAAO,EAAE,CAAC,MAAW,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC;SAC/D;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,+DAA+D;QAC5E,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;KACnB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAEnD,eAAe,aAAa,CAAC"}

package/dist/tools/call-paid-tool.d.ts

@@ -0,0 +1,45 @@
+/**
+ * clawpay_call_paid_tool — Call a paid MCP tool and pay USDC automatically via x402.
+ */
+import { z } from "zod";
+import type { ClawPayPluginConfig } from "../config.js";
+export declare const CALL_PAID_TOOL = "clawpay_call_paid_tool";
+export declare const callPaidToolParameters: z.ZodObject<{
+    mcpEndpoint: z.ZodString;
+    toolName: z.ZodString;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    toolName: string;
+    mcpEndpoint: string;
+    args?: Record<string, any> | undefined;
+}, {
+    toolName: string;
+    mcpEndpoint: string;
+    args?: Record<string, any> | undefined;
+}>;
+export declare const callPaidToolDescription = "Call a paid tool on a ClawPay MCP server and pay USDC automatically via x402 on Hedera.\nThe payment is handled transparently \u2014 the agent's Hedera wallet signs a USDC transfer,\nand the Blocky402 facilitator submits it gaslessly.\nUse clawpay_discover_agents first to find the MCP endpoint and tool name.";
+export declare function callPaidToolExecute(config: ClawPayPluginConfig, params: z.infer<typeof callPaidToolParameters>): Promise<{
+    paid: boolean;
+    result: unknown;
+    receipt: null;
+    error?: undefined;
+    amount?: undefined;
+    recipient?: undefined;
+} | {
+    error: string;
+    paid?: undefined;
+    result?: undefined;
+    receipt?: undefined;
+    amount?: undefined;
+    recipient?: undefined;
+} | {
+    paid: boolean;
+    amount: string;
+    recipient: any;
+    result: unknown;
+    receipt: {
+        txId: string;
+    };
+    error?: undefined;
+}>;
+//# sourceMappingURL=call-paid-tool.d.ts.map

package/dist/tools/call-paid-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-paid-tool.d.ts","sourceRoot":"","sources":["../../src/tools/call-paid-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,eAAO,MAAM,uBAAuB,0TAGsC,CAAC;AAE3E,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;GAoH/C"}

package/dist/tools/call-paid-tool.js

@@ -0,0 +1,107 @@
+/**
+ * clawpay_call_paid_tool — Call a paid MCP tool and pay USDC automatically via x402.
+ */
+import { z } from "zod";
+export const CALL_PAID_TOOL = "clawpay_call_paid_tool";
+export const callPaidToolParameters = z.object({
+    mcpEndpoint: z.string().describe("The MCP server endpoint URL of the agent providing the tool."),
+    toolName: z.string().describe("The name of the tool to call on the MCP server."),
+    args: z.record(z.any()).optional().describe("Arguments to pass to the tool (key-value pairs)."),
+});
+export const callPaidToolDescription = `Call a paid tool on a ClawPay MCP server and pay USDC automatically via x402 on Hedera.
+The payment is handled transparently — the agent's Hedera wallet signs a USDC transfer,
+and the Blocky402 facilitator submits it gaslessly.
+Use clawpay_discover_agents first to find the MCP endpoint and tool name.`;
+export async function callPaidToolExecute(config, params) {
+    const { mcpEndpoint, toolName, args } = params;
+    try {
+        // Step 1: Call the MCP endpoint — if it requires payment, we get a 402 with PaymentRequirements
+        const initRes = await fetch(mcpEndpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "tools/call",
+                params: { name: toolName, arguments: args || {} },
+            }),
+        });
+        // If 200, tool is free — return result directly
+        if (initRes.ok) {
+            const result = await initRes.json();
+            return { paid: false, result, receipt: null };
+        }
+        // If 402, extract payment requirements and pay
+        if (initRes.status === 402) {
+            const paymentRequirements = initRes.headers.get("x-payment");
+            if (!paymentRequirements) {
+                return { error: "Server returned 402 but no payment requirements header" };
+            }
+            const requirements = JSON.parse(Buffer.from(paymentRequirements, "base64").toString());
+            // Build x402 payment header using Hedera HTS
+            const { Client, TransferTransaction, AccountId, TokenId, PrivateKey, TransactionId, Timestamp } = await import("@hashgraph/sdk");
+            const pk = PrivateKey.fromStringECDSA((config.operatorKey || "").replace(/^0x/, ""));
+            const payerId = AccountId.fromString(config.operatorId || "0.0.6514537");
+            // Parse recipient from payment requirements
+            const payTo = requirements.payTo || requirements.pay_to;
+            const recipientId = payTo.startsWith("0.0.")
+                ? AccountId.fromString(payTo)
+                : AccountId.fromEvmAddress(0, 0, payTo);
+            // Parse token and amount
+            const asset = requirements.asset;
+            const tokenEntityNum = parseInt(asset.replace(/^0x/, ""), 16);
+            const tokenId = TokenId.fromString(`0.0.${tokenEntityNum}`);
+            const amount = Number(requirements.maxAmountRequired || requirements.amount);
+            // Facilitator pays gas
+            const feePayerAccountId = config.facilitatorFeePayer
+                ? AccountId.fromString(config.facilitatorFeePayer)
+                : payerId;
+            const hederaClient = config.network === "testnet"
+                ? Client.forTestnet()
+                : Client.forMainnet();
+            const txId = TransactionId.withValidStart(feePayerAccountId, Timestamp.generate());
+            const tx = new TransferTransaction()
+                .addTokenTransfer(tokenId, payerId, -amount)
+                .addTokenTransfer(tokenId, recipientId, amount)
+                .setTransactionId(txId)
+                .setMaxTransactionFee(2_000_000)
+                .setTransactionValidDuration(180);
+            const frozenTx = tx.freezeWith(hederaClient);
+            const signedTx = await frozenTx.sign(pk);
+            const txBytes = signedTx.toBytes();
+            const paymentHeader = Buffer.from(JSON.stringify({
+                x402Version: 1,
+                payload: { transaction: Buffer.from(txBytes).toString("base64") },
+            })).toString("base64");
+            hederaClient.close();
+            // Step 2: Retry the call with payment header
+            const paidRes = await fetch(mcpEndpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-PAYMENT": paymentHeader,
+                    "X-PAYMENT-VERSION": "1",
+                },
+                body: JSON.stringify({
+                    jsonrpc: "2.0",
+                    id: 2,
+                    method: "tools/call",
+                    params: { name: toolName, arguments: args || {} },
+                }),
+            });
+            const result = await paidRes.json();
+            return {
+                paid: true,
+                amount: `$${(amount / 1_000_000).toFixed(4)} USDC`,
+                recipient: payTo,
+                result,
+                receipt: { txId: txId.toString() },
+            };
+        }
+        return { error: `Unexpected status ${initRes.status}: ${await initRes.text()}` };
+    }
+    catch (error) {
+        return { error: `Tool call failed: ${error.message}` };
+    }
+}
+//# sourceMappingURL=call-paid-tool.js.map

package/dist/tools/call-paid-tool.js.map

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

package/dist/tools/check-reputation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * clawpay_check_reputation — Check an agent's on-chain reputation score and feedback history.
+ */
+import { z } from "zod";
+import type { ClawPayPluginConfig } from "../config.js";
+export declare const CHECK_REPUTATION = "clawpay_check_reputation";
+export declare const checkReputationParameters: z.ZodObject<{
+    agentTokenId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    agentTokenId: number;
+}, {
+    agentTokenId: number;
+}>;
+export declare const checkReputationDescription = "Check the on-chain reputation of a ClawPay agent.\nReturns the average rating (0-5), total rating count, and recent feedback entries.\nUse this to evaluate an agent's trustworthiness before paying for their tools.";
+export declare function checkReputationExecute(config: ClawPayPluginConfig, params: z.infer<typeof checkReputationParameters>): Promise<{
+    agentTokenId: number;
+    avgRating: number;
+    ratingCount: number;
+    recentFeedbacks: {
+        fromAgent: number;
+        toAgent: number;
+        rating: number;
+        timestamp: string;
+    }[];
+    hcsComments: any[];
+    error?: undefined;
+} | {
+    error: string;
+    agentTokenId?: undefined;
+    avgRating?: undefined;
+    ratingCount?: undefined;
+    recentFeedbacks?: undefined;
+    hcsComments?: undefined;
+}>;
+//# sourceMappingURL=check-reputation.d.ts.map

package/dist/tools/check-reputation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-reputation.d.ts","sourceRoot":"","sources":["../../src/tools/check-reputation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AAEH,eAAO,MAAM,0BAA0B,0NAEwC,CAAC;AAEhF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC;;;;;;;;;;;;;;;;;;;GAwElD"}

package/dist/tools/check-reputation.js

@@ -0,0 +1,86 @@
+/**
+ * clawpay_check_reputation — Check an agent's on-chain reputation score and feedback history.
+ */
+import { z } from "zod";
+import { createPublicClient, http } from "viem";
+import { hederaTestnet } from "viem/chains";
+import { registryAbi } from "../abi.js";
+export const CHECK_REPUTATION = "clawpay_check_reputation";
+export const checkReputationParameters = z.object({
+    agentTokenId: z.number().describe("The on-chain token ID of the agent to check reputation for."),
+});
+export const checkReputationDescription = `Check the on-chain reputation of a ClawPay agent.
+Returns the average rating (0-5), total rating count, and recent feedback entries.
+Use this to evaluate an agent's trustworthiness before paying for their tools.`;
+export async function checkReputationExecute(config, params) {
+    const client = createPublicClient({
+        chain: hederaTestnet,
+        transport: http(config.rpcUrl),
+    });
+    try {
+        const [reputation, feedbackIds] = await Promise.all([
+            client.readContract({
+                address: config.registryAddress, abi: registryAbi,
+                functionName: "getReputation", args: [BigInt(params.agentTokenId)],
+            }),
+            client.readContract({
+                address: config.registryAddress, abi: registryAbi,
+                functionName: "getFeedbackIds", args: [BigInt(params.agentTokenId)],
+            }),
+        ]);
+        const avg = Number(reputation[0]) / 100;
+        const count = Number(reputation[1]);
+        // Fetch recent feedbacks (last 10)
+        const recentIds = feedbackIds.slice(-10);
+        const feedbacks = [];
+        for (const id of recentIds) {
+            try {
+                const fb = await client.readContract({
+                    address: config.registryAddress, abi: registryAbi,
+                    functionName: "feedbacks", args: [id],
+                });
+                feedbacks.push({
+                    fromAgent: Number(fb[0]),
+                    toAgent: Number(fb[1]),
+                    rating: Number(fb[2]),
+                    timestamp: new Date(Number(fb[4]) * 1000).toISOString(),
+                });
+            }
+            catch { /* skip */ }
+        }
+        // Also fetch HCS comments from Mirror Node for richer context
+        let hcsComments = [];
+        try {
+            const base = config.network === "mainnet"
+                ? "https://mainnet.mirrornode.hedera.com"
+                : "https://testnet.mirrornode.hedera.com";
+            const res = await fetch(`${base}/api/v1/topics/${config.reputationTopicId}/messages?limit=10&order=desc`);
+            if (res.ok) {
+                const data = (await res.json());
+                hcsComments = (data.messages || [])
+                    .map((m) => {
+                    try {
+                        const parsed = JSON.parse(Buffer.from(m.message, "base64").toString());
+                        if (parsed.toAgent === params.agentTokenId)
+                            return { ...parsed, seq: m.sequence_number };
+                    }
+                    catch { /* skip */ }
+                    return null;
+                })
+                    .filter(Boolean);
+            }
+        }
+        catch { /* HCS fetch is best-effort */ }
+        return {
+            agentTokenId: params.agentTokenId,
+            avgRating: avg,
+            ratingCount: count,
+            recentFeedbacks: feedbacks,
+            hcsComments,
+        };
+    }
+    catch (error) {
+        return { error: `Reputation check failed: ${error.message}` };
+    }
+}
+//# sourceMappingURL=check-reputation.js.map

package/dist/tools/check-reputation.js.map

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

package/dist/tools/discover-agents.d.ts

@@ -0,0 +1,41 @@
+/**
+ * clawpay_discover_agents — Find agents offering specific tools, ranked by reputation.
+ */
+import { z } from "zod";
+import type { ClawPayPluginConfig } from "../config.js";
+export declare const DISCOVER_AGENTS = "clawpay_discover_agents";
+export declare const discoverAgentsParameters: z.ZodObject<{
+    toolName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    toolName?: string | undefined;
+}, {
+    toolName?: string | undefined;
+}>;
+export declare const discoverAgentsDescription = "Discover AI agents registered on the ClawPay Agent Society on Hedera.\nSearch for agents offering specific tools, compare their prices and reputation scores.\nReturns agents sorted by a composite score (reputation + price).\nUse this to find the best provider before calling a paid tool.";
+export declare function discoverAgentsExecute(config: ClawPayPluginConfig, params: z.infer<typeof discoverAgentsParameters>): Promise<{
+    agents: {
+        tokenId: number;
+        owner: `0x${string}`;
+        name: any;
+        description: any;
+        reputation: {
+            avg: number;
+            count: number;
+        };
+        capabilities: {
+            toolName: any;
+            description: any;
+            priceUsd: string;
+            mcpEndpoint: any;
+        }[];
+    }[];
+    total: number;
+    query: string;
+    error?: undefined;
+} | {
+    error: string;
+    agents: never[];
+    total: number;
+    query?: undefined;
+}>;
+//# sourceMappingURL=discover-agents.d.ts.map

package/dist/tools/discover-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-agents.d.ts","sourceRoot":"","sources":["../../src/tools/discover-agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAWxD,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAEzD,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAEH,eAAO,MAAM,yBAAyB,oSAGyB,CAAC;AAEhE,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;GAsFjD"}

package/dist/tools/discover-agents.js

@@ -0,0 +1,104 @@
+/**
+ * clawpay_discover_agents — Find agents offering specific tools, ranked by reputation.
+ */
+import { z } from "zod";
+import { createPublicClient, http } from "viem";
+import { hederaTestnet } from "viem/chains";
+import { registryAbi } from "../abi.js";
+function parseProfile(uri) {
+    try {
+        if (uri.startsWith("data:application/json;base64,")) {
+            return JSON.parse(Buffer.from(uri.replace("data:application/json;base64,", ""), "base64").toString());
+        }
+    }
+    catch { /* ignore */ }
+    return null;
+}
+export const DISCOVER_AGENTS = "clawpay_discover_agents";
+export const discoverAgentsParameters = z.object({
+    toolName: z.string().optional().describe("Filter by tool name. If omitted, returns all agents with their capabilities."),
+});
+export const discoverAgentsDescription = `Discover AI agents registered on the ClawPay Agent Society on Hedera.
+Search for agents offering specific tools, compare their prices and reputation scores.
+Returns agents sorted by a composite score (reputation + price).
+Use this to find the best provider before calling a paid tool.`;
+export async function discoverAgentsExecute(config, params) {
+    const client = createPublicClient({
+        chain: hederaTestnet,
+        transport: http(config.rpcUrl),
+    });
+    try {
+        let tokenIds;
+        if (params.toolName) {
+            // Find providers for a specific tool
+            const providerIds = await client.readContract({
+                address: config.registryAddress,
+                abi: registryAbi,
+                functionName: "findProviders",
+                args: [params.toolName],
+            });
+            tokenIds = providerIds.map(Number);
+        }
+        else {
+            // List all agents
+            const total = await client.readContract({
+                address: config.registryAddress,
+                abi: registryAbi,
+                functionName: "totalAgents",
+            });
+            tokenIds = Array.from({ length: Number(total) }, (_, i) => i + 1);
+        }
+        const results = [];
+        for (const tokenId of tokenIds) {
+            try {
+                const [owner, uri, reputation] = await Promise.all([
+                    client.readContract({ address: config.registryAddress, abi: registryAbi, functionName: "ownerOf", args: [BigInt(tokenId)] }),
+                    client.readContract({ address: config.registryAddress, abi: registryAbi, functionName: "tokenURI", args: [BigInt(tokenId)] }),
+                    client.readContract({ address: config.registryAddress, abi: registryAbi, functionName: "getReputation", args: [BigInt(tokenId)] }),
+                ]);
+                const profile = parseProfile(uri);
+                const caps = await client.readContract({
+                    address: config.registryAddress, abi: registryAbi,
+                    functionName: "getCapabilities", args: [BigInt(tokenId)],
+                });
+                const capabilities = caps
+                    .filter((c) => c.active)
+                    .map((c) => ({
+                    toolName: c.toolName,
+                    description: c.description,
+                    priceUsd: `$${(Number(c.priceUsdcAtomic) / 1_000_000).toFixed(3)}`,
+                    mcpEndpoint: c.mcpEndpoint,
+                }));
+                // Filter by tool if specified
+                if (params.toolName && !capabilities.some(c => c.toolName === params.toolName))
+                    continue;
+                const avg = Number(reputation[0]) / 100;
+                const count = Number(reputation[1]);
+                results.push({
+                    tokenId,
+                    owner,
+                    name: profile?.name || `Agent #${tokenId}`,
+                    description: profile?.description || "",
+                    reputation: { avg, count },
+                    capabilities,
+                });
+            }
+            catch { /* skip invalid agents */ }
+        }
+        // Sort by reputation (higher is better)
+        results.sort((a, b) => {
+            const scoreA = a.reputation.count > 0 ? a.reputation.avg : 2.5;
+            const scoreB = b.reputation.count > 0 ? b.reputation.avg : 2.5;
+            return scoreB - scoreA;
+        });
+        return {
+            agents: results,
+            total: results.length,
+            query: params.toolName || "all",
+        };
+    }
+    catch (error) {
+        return { error: `Discovery failed: ${error.message}`, agents: [], total: 0 };
+    }
+}
+//# sourceMappingURL=discover-agents.js.map

package/dist/tools/discover-agents.js.map

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

package/dist/tools/register-agent.d.ts

@@ -0,0 +1,45 @@
+/**
+ * clawpay_register_agent — Register an agent on-chain in the ClawPay Agent Society.
+ */
+import { z } from "zod";
+import type { ClawPayPluginConfig } from "../config.js";
+export declare const REGISTER_AGENT = "clawpay_register_agent";
+export declare const registerAgentParameters: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    capabilities: z.ZodArray<z.ZodString, "many">;
+    mcpEndpoint: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    capabilities: string[];
+    mcpEndpoint?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    capabilities: string[];
+    mcpEndpoint?: string | undefined;
+}>;
+export declare const registerAgentDescription = "Register a new AI agent on-chain in the ClawPay Agent Society on Hedera.\nMints an ERC-721 NFT representing the agent's identity.\nThe agent's profile (name, description, capabilities) is stored as on-chain metadata.\nAfter registration, the agent can publish tool capabilities and receive payments.";
+export declare function registerAgentExecute(config: ClawPayPluginConfig, params: z.infer<typeof registerAgentParameters>): Promise<{
+    error: string;
+    success?: undefined;
+    txHash?: undefined;
+    blockNumber?: undefined;
+    agent?: undefined;
+} | {
+    success: boolean;
+    txHash: `0x${string}`;
+    blockNumber: number;
+    agent: {
+        name: string;
+        description: string;
+        owner: string;
+        evmAddress: `0x${string}`;
+        mcpEndpoint: string;
+        capabilities: string[];
+        createdAt: string;
+    };
+    error?: undefined;
+}>;
+//# sourceMappingURL=register-agent.d.ts.map

package/dist/tools/register-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-agent.d.ts","sourceRoot":"","sources":["../../src/tools/register-agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,eAAO,MAAM,wBAAwB,gTAG6C,CAAC;AAEnF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;GAwDhD"}

package/dist/tools/register-agent.js

@@ -0,0 +1,69 @@
+/**
+ * clawpay_register_agent — Register an agent on-chain in the ClawPay Agent Society.
+ */
+import { z } from "zod";
+import { createPublicClient, createWalletClient, http } from "viem";
+import { hederaTestnet } from "viem/chains";
+import { privateKeyToAccount } from "viem/accounts";
+import { registryAbi } from "../abi.js";
+export const REGISTER_AGENT = "clawpay_register_agent";
+export const registerAgentParameters = z.object({
+    name: z.string().describe("Display name for the agent."),
+    description: z.string().describe("What this agent does."),
+    capabilities: z.array(z.string()).describe("List of tool names this agent offers."),
+    mcpEndpoint: z.string().optional().describe("MCP server URL where this agent's tools are accessible."),
+});
+export const registerAgentDescription = `Register a new AI agent on-chain in the ClawPay Agent Society on Hedera.
+Mints an ERC-721 NFT representing the agent's identity.
+The agent's profile (name, description, capabilities) is stored as on-chain metadata.
+After registration, the agent can publish tool capabilities and receive payments.`;
+export async function registerAgentExecute(config, params) {
+    if (!config.operatorKey) {
+        return { error: "No operator key configured. Set HEDERA_OPERATOR_KEY to register agents." };
+    }
+    try {
+        const key = config.operatorKey.startsWith("0x")
+            ? config.operatorKey
+            : `0x${config.operatorKey}`;
+        const account = privateKeyToAccount(key);
+        const walletClient = createWalletClient({
+            account,
+            chain: hederaTestnet,
+            transport: http(config.rpcUrl),
+        });
+        const publicClient = createPublicClient({
+            chain: hederaTestnet,
+            transport: http(config.rpcUrl),
+        });
+        // Build profile metadata
+        const profile = {
+            name: params.name,
+            description: params.description,
+            owner: config.operatorId || "",
+            evmAddress: account.address,
+            mcpEndpoint: params.mcpEndpoint || "",
+            capabilities: params.capabilities,
+            createdAt: new Date().toISOString(),
+        };
+        const uri = `data:application/json;base64,${Buffer.from(JSON.stringify(profile)).toString("base64")}`;
+        const hash = await walletClient.writeContract({
+            address: config.registryAddress,
+            abi: registryAbi,
+            functionName: "registerAgent",
+            args: [uri],
+            gas: 500000n,
+        });
+        // Wait for receipt
+        const receipt = await publicClient.waitForTransactionReceipt({ hash });
+        return {
+            success: true,
+            txHash: hash,
+            blockNumber: Number(receipt.blockNumber),
+            agent: profile,
+        };
+    }
+    catch (error) {
+        return { error: `Registration failed: ${error.message}` };
+    }
+}
+//# sourceMappingURL=register-agent.js.map

package/dist/tools/register-agent.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@clawpay-hedera/hak-plugin",
+  "version": "1.0.0",
+  "description": "ClawPay plugin for Hedera Agent Kit — discover, pay for, and rate AI agent tools on Hedera via x402",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "hedera",
+    "agent-kit",
+    "clawpay",
+    "x402",
+    "mcp",
+    "ai-agents",
+    "plugin"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "viem": "2.37.13",
+    "@hashgraph/sdk": "^2.58.0",
+    "zod": "^3.25.76"
+  },
+  "peerDependencies": {
+    "hedera-agent-kit": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "hedera-agent-kit": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.8.3"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}