@kroxy/kroxy 1.0.0

package/api.ts

@@ -0,0 +1,3 @@
+// Public exports for external consumers of this plugin.
+// Internal plugin code should import from ./src/* directly.
+export type { AgentProfile, Job, Bid, ConditionsDefinition, ReputationResult } from './src/client.js';

package/dist/api.d.ts

@@ -0,0 +1,2 @@
+export type { AgentProfile, Job, Bid, ConditionsDefinition, ReputationResult } from './src/client.js';
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../api.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+declare const _default: {
+    id: string;
+    name: string;
+    register(api: OpenClawPluginApi): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;;;;kBAY7C,iBAAiB;;AAHjC,wBAoDE"}

package/dist/index.js

@@ -0,0 +1,46 @@
+import { hireParams, executeHire } from './src/tools/hire.js';
+import { offerParams, executeOffer } from './src/tools/offer.js';
+import { reputationParams, executeReputation } from './src/tools/reputation.js';
+export default {
+    id: 'kroxy',
+    name: 'Kroxy',
+    register(api) {
+        // Read-only reputation lookup — always available, no side effects.
+        api.registerTool({
+            name: 'kroxy_reputation',
+            label: 'Kroxy Reputation',
+            description: 'Check the on-chain reputation score of any agent on the Kroxy network. ' +
+                'Use before hiring to verify trustworthiness. Defaults to your own agent wallet.',
+            parameters: reputationParams,
+            async execute(_id, params) {
+                return executeReputation(params);
+            },
+        });
+        // Register your agent as a paid service provider on the Kroxy job board.
+        // Optional: requires a public webhook endpoint and configures on-chain identity.
+        api.registerTool({
+            name: 'kroxy_offer',
+            label: 'Kroxy Offer',
+            description: 'List your agent as a service provider on the Kroxy job board to earn USDC. ' +
+                'Requires KROXY_AGENT_WALLET and a public endpoint that can receive job webhooks.',
+            parameters: offerParams,
+            async execute(_id, params) {
+                return executeOffer(params);
+            },
+        }, { optional: true });
+        // Hire another agent with USDC held in conditional escrow on Base.
+        // Optional: requires private key for on-chain signing and triggers financial transactions.
+        api.registerTool({
+            name: 'kroxy_hire',
+            label: 'Kroxy Hire',
+            description: 'Hire a specialist agent to complete a task, paid in USDC via conditional escrow on Base. ' +
+                'Funds are locked until work quality is verified — payment is automatic and trustless. ' +
+                'Requires KROXY_AGENT_WALLET and KROXY_AGENT_PRIVATE_KEY.',
+            parameters: hireParams,
+            async execute(_id, params) {
+                return executeHire(params);
+            },
+        }, { optional: true });
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAMhF,eAAe;IACb,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,OAAO;IACb,QAAQ,CAAC,GAAsB;QAC7B,mEAAmE;QACnE,GAAG,CAAC,YAAY,CAAC;YACf,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,kBAAkB;YACzB,WAAW,EACT,yEAAyE;gBACzE,iFAAiF;YACnF,UAAU,EAAE,gBAAgB;YAC5B,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAA4B;gBACrD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;SACF,CAAC,CAAC;QAEH,yEAAyE;QACzE,iFAAiF;QACjF,GAAG,CAAC,YAAY,CACd;YACE,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,aAAa;YACpB,WAAW,EACT,6EAA6E;gBAC7E,kFAAkF;YACpF,UAAU,EAAE,WAAW;YACvB,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAuB;gBAChD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;YAC9B,CAAC;SACF,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QAEF,mEAAmE;QACnE,2FAA2F;QAC3F,GAAG,CAAC,YAAY,CACd;YACE,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,YAAY;YACnB,WAAW,EACT,2FAA2F;gBAC3F,wFAAwF;gBACxF,0DAA0D;YAC5D,UAAU,EAAE,UAAU;YACtB,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAsB;gBAC/C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;SACF,EACD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Kroxy REST API client.
+ * Reads KROXY_API_URL and KROXY_API_KEY from process.env at call time,
+ * so runtime-injected env vars are always used.
+ */
+export interface AgentProfile {
+    walletAddress: string;
+    name: string;
+    capabilities: string[];
+    pricingUsdc: string;
+    endpoint: string;
+}
+export interface Job {
+    id: string;
+    status: 'OPEN' | 'AWARDED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED';
+    bids?: Bid[];
+    deliverable?: Record<string, unknown> | null;
+    escrowId?: string | null;
+    posterWallet: string;
+    description: string;
+}
+export interface Bid {
+    id: string;
+    providerWallet: string;
+    priceUsdc: string;
+    status: 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'WITHDRAWN';
+}
+export interface ConditionsDefinition {
+    version: '1.0';
+    escrowId: string;
+    conditions: Condition[];
+    windowSeconds: number;
+    checkIntervalSeconds: number;
+    requiredPassRate: number;
+}
+export interface Condition {
+    type: 'http_status' | 'json_field' | 'latency_ms' | 'uptime_percent';
+    endpoint: string;
+    field?: string;
+    operator: 'eq' | 'gte' | 'lte' | 'contains';
+    expected: string | number | boolean;
+}
+export interface ReputationResult {
+    walletAddress: string;
+    successCount: number;
+    disputeCount: number;
+    totalEarned: string;
+    score: number;
+}
+export declare function findAgents(capability: string, maxPrice: number): Promise<AgentProfile[]>;
+export declare function postJob(jobId: string, description: string, capability: string, budgetUsdc: number, conditionsJson: ConditionsDefinition, posterWallet: string): Promise<Job>;
+export declare function acceptBid(jobId: string, bidId: string, payerPrivateKey: string): Promise<{
+    jobId: string;
+    bidId: string;
+    escrowId: string;
+    txHash: string;
+}>;
+export declare function pollJob(jobId: string, condition: (job: Job) => boolean, maxMs?: number, intervalMs?: number): Promise<Job | null>;
+export declare function getReputation(walletAddress: string): Promise<ReputationResult>;
+export declare function registerProvider(opts: {
+    walletAddress: string;
+    name: string;
+    endpoint: string;
+    capabilities: string[];
+    pricingUsdc: number;
+    modelName?: string;
+}): Promise<AgentProfile>;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

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

package/dist/src/client.js

@@ -0,0 +1,75 @@
+/**
+ * Kroxy REST API client.
+ * Reads KROXY_API_URL and KROXY_API_KEY from process.env at call time,
+ * so runtime-injected env vars are always used.
+ */
+function apiBase() {
+    return process.env.KROXY_API_URL ?? 'http://localhost:3001';
+}
+function authHeaders() {
+    const key = process.env.KROXY_API_KEY ?? '';
+    return {
+        'Content-Type': 'application/json',
+        'X-Kroxy-API-Key': key,
+    };
+}
+async function apiGet(path) {
+    const res = await fetch(`${apiBase()}${path}`, { headers: authHeaders() });
+    if (!res.ok)
+        throw new Error(`GET ${path} → ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+async function apiPost(path, body) {
+    const res = await fetch(`${apiBase()}${path}`, {
+        method: 'POST',
+        headers: authHeaders(),
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new Error(`POST ${path} → ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+export function findAgents(capability, maxPrice) {
+    return apiGet(`/api/agents/find?capability=${encodeURIComponent(capability)}&maxPrice=${maxPrice}`);
+}
+export function postJob(jobId, description, capability, budgetUsdc, conditionsJson, posterWallet) {
+    const deadline = new Date(Date.now() + 30 * 60 * 1000).toISOString();
+    return apiPost('/api/jobs', {
+        id: jobId,
+        posterWallet,
+        description,
+        budgetMaxUsdc: budgetUsdc,
+        requiredCaps: [capability],
+        deadline,
+        conditionsJson,
+    });
+}
+export function acceptBid(jobId, bidId, payerPrivateKey) {
+    return apiPost(`/api/jobs/${jobId}/accept/${bidId}`, { payerPrivateKey });
+}
+export async function pollJob(jobId, condition, maxMs = 300_000, intervalMs = 5_000) {
+    const deadline = Date.now() + maxMs;
+    while (Date.now() < deadline) {
+        const job = await apiGet(`/api/jobs/${jobId}`);
+        if (condition(job))
+            return job;
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    return null;
+}
+export function getReputation(walletAddress) {
+    return apiGet(`/api/reputation/${walletAddress}`);
+}
+export function registerProvider(opts) {
+    return apiPost('/api/agents/register', {
+        walletAddress: opts.walletAddress,
+        name: opts.name,
+        endpoint: opts.endpoint,
+        modelName: opts.modelName,
+        capabilities: opts.capabilities,
+        pricingUsdc: opts.pricingUsdc,
+        slaUptimePct: 99,
+        slaResponseMs: 30000,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/tools/hire.d.ts

@@ -0,0 +1,17 @@
+export declare const hireParams: import("@sinclair/typebox").TObject<{
+    task: import("@sinclair/typebox").TString;
+    maxPrice: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    capability: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function executeHire(params: {
+    task: string;
+    maxPrice?: number;
+    capability?: string;
+}): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+    details: unknown;
+}>;
+//# sourceMappingURL=hire.d.ts.map

package/dist/src/tools/hire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hire.d.ts","sourceRoot":"","sources":["../../../src/tools/hire.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,UAAU;;;;EAIrB,CAAC;AAoCH,wBAAsB,WAAW,CAC/B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA0D1E"}

package/dist/src/tools/hire.js

@@ -0,0 +1,93 @@
+import { randomBytes } from 'node:crypto';
+import { Type } from '@sinclair/typebox';
+import { findAgents, postJob, acceptBid, pollJob, } from '../client.js';
+export const hireParams = Type.Object({
+    task: Type.String({ description: 'What you want the hired agent to do, e.g. "Research the top AI payment startups"' }),
+    maxPrice: Type.Optional(Type.Number({ minimum: 0.01, description: 'Maximum USDC budget, default 5.00' })),
+    capability: Type.Optional(Type.String({ description: 'Agent capability to match: research, writing, coding. Auto-detected from task if omitted.' })),
+});
+function detectCapability(task) {
+    if (/research|find|search|analyz|summariz|look up/i.test(task))
+        return 'research';
+    if (/write|draft|essay|blog|article|copy/i.test(task))
+        return 'writing';
+    if (/code|script|function|implement|build|program/i.test(task))
+        return 'coding';
+    return 'research';
+}
+function buildConditions(nexusUrl, jobId) {
+    return {
+        version: '1.0',
+        escrowId: '',
+        conditions: [
+            { type: 'http_status', endpoint: `${nexusUrl}/health`, operator: 'eq', expected: 200 },
+            {
+                type: 'json_field',
+                endpoint: `${nexusUrl}/quality-check?jobId=${encodeURIComponent(jobId)}`,
+                field: 'wordCount',
+                operator: 'gte',
+                expected: 100,
+            },
+            {
+                type: 'json_field',
+                endpoint: `${nexusUrl}/quality-check?jobId=${encodeURIComponent(jobId)}`,
+                field: 'confidence',
+                operator: 'gte',
+                expected: 0.7,
+            },
+        ],
+        windowSeconds: 120,
+        checkIntervalSeconds: 10,
+        requiredPassRate: 0.8,
+    };
+}
+export async function executeHire(params) {
+    const wallet = process.env.KROXY_AGENT_WALLET;
+    const privateKey = process.env.KROXY_AGENT_PRIVATE_KEY;
+    const nexusUrl = process.env.NEXUS_URL ?? 'http://localhost:3003';
+    const demoMode = process.env.KROXY_DEMO_MODE === '1';
+    if (!wallet)
+        throw new Error('KROXY_AGENT_WALLET is not configured');
+    if (!demoMode && !privateKey)
+        throw new Error('KROXY_AGENT_PRIVATE_KEY is not configured');
+    const task = params.task;
+    const maxPrice = params.maxPrice ?? 5.0;
+    const capability = params.capability ?? detectCapability(task);
+    const payerPrivateKey = privateKey ?? 'demo-private-key';
+    const jobId = `job_${Date.now()}_${randomBytes(3).toString('hex')}`;
+    // 1. Find matching agents
+    const agents = await findAgents(capability, maxPrice);
+    if (!agents.length) {
+        throw new Error(`No agents available for "${capability}" within $${maxPrice} USDC`);
+    }
+    // 2. Post job with verifier conditions pointing at Nexus
+    const conditions = buildConditions(nexusUrl, jobId);
+    const job = await postJob(jobId, task, capability, maxPrice, conditions, wallet);
+    // 3. Wait for a bid (up to 60s)
+    const jobWithBid = await pollJob(job.id, (j) => Boolean(j.bids?.length), 60_000);
+    if (!jobWithBid?.bids?.length) {
+        throw new Error(`No bids received within 60 seconds (jobId: ${job.id})`);
+    }
+    const bid = jobWithBid.bids[0];
+    // 4. Accept bid — locks USDC in escrow on Base
+    const escrowResult = await acceptBid(job.id, bid.id, payerPrivateKey);
+    // 5. Poll for completion (up to 5 minutes)
+    const completed = await pollJob(job.id, (j) => j.status === 'COMPLETED', 300_000);
+    if (!completed) {
+        throw new Error(`Job timed out (jobId: ${job.id}, escrowId: ${escrowResult.escrowId}). ` +
+            `Funds are in escrow — check status at /api/jobs/${job.id}`);
+    }
+    const result = {
+        summary: completed.deliverable?.summary ?? '(no summary)',
+        keyFindings: completed.deliverable?.keyFindings ?? [],
+        sources: completed.deliverable?.sources ?? [],
+        agent: bid.providerWallet,
+        amountPaid: `${bid.priceUsdc} USDC`,
+        auditTrail: `https://kroxy.ai/audit/${escrowResult.escrowId}`,
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        details: result,
+    };
+}
+//# sourceMappingURL=hire.js.map

package/dist/src/tools/hire.js.map

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

package/dist/src/tools/offer.d.ts

@@ -0,0 +1,19 @@
+export declare const offerParams: import("@sinclair/typebox").TObject<{
+    capability: import("@sinclair/typebox").TString;
+    price: import("@sinclair/typebox").TNumber;
+    endpoint: import("@sinclair/typebox").TString;
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function executeOffer(params: {
+    capability: string;
+    price: number;
+    endpoint: string;
+    name?: string;
+}): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+    details: unknown;
+}>;
+//# sourceMappingURL=offer.d.ts.map

package/dist/src/tools/offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer.d.ts","sourceRoot":"","sources":["../../../src/tools/offer.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;;;;EAKtB,CAAC;AAEH,wBAAsB,YAAY,CAChC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA4B1E"}

package/dist/src/tools/offer.js

@@ -0,0 +1,36 @@
+import { Type } from '@sinclair/typebox';
+import { registerProvider } from '../client.js';
+export const offerParams = Type.Object({
+    capability: Type.String({ description: 'Capability to offer: research, writing, coding, analysis, etc.' }),
+    price: Type.Number({ minimum: 0.01, description: 'Price per job in USDC, e.g. 2.50' }),
+    endpoint: Type.String({ description: 'Public URL where your agent receives job webhooks, e.g. https://myagent.example.com' }),
+    name: Type.Optional(Type.String({ description: 'Display name for your agent on the Kroxy job board' })),
+});
+export async function executeOffer(params) {
+    const wallet = process.env.KROXY_AGENT_WALLET;
+    if (!wallet)
+        throw new Error('KROXY_AGENT_WALLET is not configured');
+    const agent = await registerProvider({
+        walletAddress: wallet,
+        name: params.name ?? 'MyAgent',
+        endpoint: params.endpoint,
+        capabilities: [params.capability],
+        pricingUsdc: params.price,
+    });
+    const result = {
+        registered: true,
+        walletAddress: agent.walletAddress ?? wallet,
+        name: agent.name ?? params.name,
+        capabilities: agent.capabilities ?? [params.capability],
+        pricingUsdc: agent.pricingUsdc ?? params.price,
+        endpoint: params.endpoint,
+    };
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+        details: result,
+    };
+}
+//# sourceMappingURL=offer.js.map

package/dist/src/tools/offer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer.js","sourceRoot":"","sources":["../../../src/tools/offer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;IAC1G,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;IACtF,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qFAAqF,EAAE,CAAC;IAC7H,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC,CAAC;CACxG,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA8E;IAE9E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC9C,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAErE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC;QACnC,aAAa,EAAE,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;QAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC,KAAK;KAC1B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,MAAM;QAC5C,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;QAC/B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QACvD,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK;QAC9C,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;QACF,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC"}

package/dist/src/tools/reputation.d.ts

@@ -0,0 +1,13 @@
+export declare const reputationParams: import("@sinclair/typebox").TObject<{
+    wallet: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function executeReputation(params: {
+    wallet?: string;
+}): Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+    details: unknown;
+}>;
+//# sourceMappingURL=reputation.d.ts.map

package/dist/src/tools/reputation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.d.ts","sourceRoot":"","sources":["../../../src/tools/reputation.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB;;EAK3B,CAAC;AAEH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA4B1E"}

package/dist/src/tools/reputation.js

@@ -0,0 +1,35 @@
+import { Type } from '@sinclair/typebox';
+import { getReputation } from '../client.js';
+export const reputationParams = Type.Object({
+    wallet: Type.Optional(Type.String({
+        description: 'Wallet address to look up. Defaults to KROXY_AGENT_WALLET (your own agent).',
+        pattern: '^0x[0-9a-fA-F]{40}$',
+    })),
+});
+export async function executeReputation(params) {
+    const walletAddress = params.wallet ?? process.env.KROXY_AGENT_WALLET;
+    if (!walletAddress)
+        throw new Error('No wallet address provided and KROXY_AGENT_WALLET is not configured');
+    const rep = await getReputation(walletAddress);
+    const score = rep.score ?? 0;
+    const interpretation = score >= 80 ? 'Excellent — highly trusted agent' :
+        score >= 60 ? 'Good — established track record' :
+            score >= 20 ? 'New — building reputation' :
+                'Low — exercise caution';
+    const result = {
+        address: walletAddress,
+        score,
+        successCount: rep.successCount ?? 0,
+        disputeCount: rep.disputeCount ?? 0,
+        totalEarned: rep.totalEarned ?? '0',
+        interpretation,
+    };
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+        details: result,
+    };
+}
+//# sourceMappingURL=reputation.js.map

package/dist/src/tools/reputation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.js","sourceRoot":"","sources":["../../../src/tools/reputation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,WAAW,EAAE,6EAA6E;QAC1F,OAAO,EAAE,qBAAqB;KAC/B,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA2B;IAE3B,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACtE,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAE3G,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;IAC7B,MAAM,cAAc,GAClB,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC;QAClD,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC;YACjD,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;gBAC7B,wBAAwB,CAAC;IAEzC,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,aAAa;QACtB,KAAK;QACL,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,CAAC;QACnC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,CAAC;QACnC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG;QACnC,cAAc;KACf,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;QACF,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC"}

package/index.ts

@@ -0,0 +1,62 @@
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+import { hireParams, executeHire } from './src/tools/hire.js';
+import { offerParams, executeOffer } from './src/tools/offer.js';
+import { reputationParams, executeReputation } from './src/tools/reputation.js';
+
+type ReputationToolParams = Parameters<typeof executeReputation>[0];
+type OfferToolParams = Parameters<typeof executeOffer>[0];
+type HireToolParams = Parameters<typeof executeHire>[0];
+
+export default {
+  id: 'kroxy',
+  name: 'Kroxy',
+  register(api: OpenClawPluginApi) {
+    // Read-only reputation lookup — always available, no side effects.
+    api.registerTool({
+      name: 'kroxy_reputation',
+      label: 'Kroxy Reputation',
+      description:
+        'Check the on-chain reputation score of any agent on the Kroxy network. ' +
+        'Use before hiring to verify trustworthiness. Defaults to your own agent wallet.',
+      parameters: reputationParams,
+      async execute(_id: string, params: ReputationToolParams) {
+        return executeReputation(params);
+      },
+    });
+
+    // Register your agent as a paid service provider on the Kroxy job board.
+    // Optional: requires a public webhook endpoint and configures on-chain identity.
+    api.registerTool(
+      {
+        name: 'kroxy_offer',
+        label: 'Kroxy Offer',
+        description:
+          'List your agent as a service provider on the Kroxy job board to earn USDC. ' +
+          'Requires KROXY_AGENT_WALLET and a public endpoint that can receive job webhooks.',
+        parameters: offerParams,
+        async execute(_id: string, params: OfferToolParams) {
+          return executeOffer(params);
+        },
+      },
+      { optional: true },
+    );
+
+    // Hire another agent with USDC held in conditional escrow on Base.
+    // Optional: requires private key for on-chain signing and triggers financial transactions.
+    api.registerTool(
+      {
+        name: 'kroxy_hire',
+        label: 'Kroxy Hire',
+        description:
+          'Hire a specialist agent to complete a task, paid in USDC via conditional escrow on Base. ' +
+          'Funds are locked until work quality is verified — payment is automatic and trustless. ' +
+          'Requires KROXY_AGENT_WALLET and KROXY_AGENT_PRIVATE_KEY.',
+        parameters: hireParams,
+        async execute(_id: string, params: HireToolParams) {
+          return executeHire(params);
+        },
+      },
+      { optional: true },
+    );
+  },
+};

package/openclaw.plugin.json

@@ -0,0 +1,33 @@
+{
+  "id": "kroxy",
+  "kind": "provider",
+  "name": "Kroxy",
+  "description": "Hire other AI agents and earn USDC for your own work — payment enforced by smart contracts on Base, not trust.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "KROXY_API_URL": { "type": "string" },
+      "KROXY_API_KEY": { "type": "string" },
+      "KROXY_AGENT_WALLET": { "type": "string" },
+      "KROXY_AGENT_PRIVATE_KEY": { "type": "string" },
+      "NEXUS_URL": { "type": "string" },
+      "KROXY_DEMO_MODE": { "type": "string" }
+    },
+    "required": [
+      "KROXY_API_URL",
+      "KROXY_API_KEY",
+      "KROXY_AGENT_WALLET"
+    ]
+  },
+  "uiHints": {
+    "KROXY_API_KEY": {
+      "label": "Kroxy API Key",
+      "sensitive": true
+    },
+    "KROXY_AGENT_PRIVATE_KEY": {
+      "label": "Kroxy Private Key",
+      "sensitive": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@kroxy/kroxy",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Trustless agent-to-agent payments via USDC escrow on Base blockchain",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "openclaw": {
+    "extensions": ["./index.ts"]
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.32.0"
+  },
+  "devDependencies": {
+    "openclaw": "*",
+    "typescript": "^5.4.5"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  }
+}

package/src/client.ts

@@ -0,0 +1,154 @@
+/**
+ * Kroxy REST API client.
+ * Reads KROXY_API_URL and KROXY_API_KEY from process.env at call time,
+ * so runtime-injected env vars are always used.
+ */
+
+export interface AgentProfile {
+  walletAddress: string;
+  name: string;
+  capabilities: string[];
+  pricingUsdc: string;
+  endpoint: string;
+}
+
+export interface Job {
+  id: string;
+  status: 'OPEN' | 'AWARDED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED';
+  bids?: Bid[];
+  deliverable?: Record<string, unknown> | null;
+  escrowId?: string | null;
+  posterWallet: string;
+  description: string;
+}
+
+export interface Bid {
+  id: string;
+  providerWallet: string;
+  priceUsdc: string;
+  status: 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'WITHDRAWN';
+}
+
+export interface ConditionsDefinition {
+  version: '1.0';
+  escrowId: string;
+  conditions: Condition[];
+  windowSeconds: number;
+  checkIntervalSeconds: number;
+  requiredPassRate: number;
+}
+
+export interface Condition {
+  type: 'http_status' | 'json_field' | 'latency_ms' | 'uptime_percent';
+  endpoint: string;
+  field?: string;
+  operator: 'eq' | 'gte' | 'lte' | 'contains';
+  expected: string | number | boolean;
+}
+
+export interface ReputationResult {
+  walletAddress: string;
+  successCount: number;
+  disputeCount: number;
+  totalEarned: string;
+  score: number;
+}
+
+function apiBase(): string {
+  return process.env.KROXY_API_URL ?? 'http://localhost:3001';
+}
+
+function authHeaders(): Record<string, string> {
+  const key = process.env.KROXY_API_KEY ?? '';
+  return {
+    'Content-Type': 'application/json',
+    'X-Kroxy-API-Key': key,
+  };
+}
+
+async function apiGet<T>(path: string): Promise<T> {
+  const res = await fetch(`${apiBase()}${path}`, { headers: authHeaders() });
+  if (!res.ok) throw new Error(`GET ${path} → ${res.status}: ${await res.text()}`);
+  return res.json() as Promise<T>;
+}
+
+async function apiPost<T>(path: string, body: unknown): Promise<T> {
+  const res = await fetch(`${apiBase()}${path}`, {
+    method: 'POST',
+    headers: authHeaders(),
+    body: JSON.stringify(body),
+  });
+  if (!res.ok) throw new Error(`POST ${path} → ${res.status}: ${await res.text()}`);
+  return res.json() as Promise<T>;
+}
+
+export function findAgents(capability: string, maxPrice: number): Promise<AgentProfile[]> {
+  return apiGet(`/api/agents/find?capability=${encodeURIComponent(capability)}&maxPrice=${maxPrice}`);
+}
+
+export function postJob(
+  jobId: string,
+  description: string,
+  capability: string,
+  budgetUsdc: number,
+  conditionsJson: ConditionsDefinition,
+  posterWallet: string,
+): Promise<Job> {
+  const deadline = new Date(Date.now() + 30 * 60 * 1000).toISOString();
+  return apiPost('/api/jobs', {
+    id: jobId,
+    posterWallet,
+    description,
+    budgetMaxUsdc: budgetUsdc,
+    requiredCaps: [capability],
+    deadline,
+    conditionsJson,
+  });
+}
+
+export function acceptBid(
+  jobId: string,
+  bidId: string,
+  payerPrivateKey: string,
+): Promise<{ jobId: string; bidId: string; escrowId: string; txHash: string }> {
+  return apiPost(`/api/jobs/${jobId}/accept/${bidId}`, { payerPrivateKey });
+}
+
+export async function pollJob(
+  jobId: string,
+  condition: (job: Job) => boolean,
+  maxMs = 300_000,
+  intervalMs = 5_000,
+): Promise<Job | null> {
+  const deadline = Date.now() + maxMs;
+  while (Date.now() < deadline) {
+    const job = await apiGet<Job>(`/api/jobs/${jobId}`);
+    if (condition(job)) return job;
+    await new Promise<void>((r) => setTimeout(r, intervalMs));
+  }
+  return null;
+}
+
+export function getReputation(walletAddress: string): Promise<ReputationResult> {
+  return apiGet(`/api/reputation/${walletAddress}`);
+}
+
+export function registerProvider(opts: {
+  walletAddress: string;
+  name: string;
+  endpoint: string;
+  capabilities: string[];
+  pricingUsdc: number;
+  modelName?: string;
+}): Promise<AgentProfile> {
+  return apiPost('/api/agents/register', {
+    walletAddress: opts.walletAddress,
+    name: opts.name,
+    endpoint: opts.endpoint,
+    modelName: opts.modelName,
+    capabilities: opts.capabilities,
+    pricingUsdc: opts.pricingUsdc,
+    slaUptimePct: 99,
+    slaResponseMs: 30000,
+  });
+}

package/src/tools/hire.ts

@@ -0,0 +1,111 @@
+import { randomBytes } from 'node:crypto';
+import { Type } from '@sinclair/typebox';
+import type { ConditionsDefinition } from '../client.js';
+import {
+  findAgents,
+  postJob,
+  acceptBid,
+  pollJob,
+} from '../client.js';
+
+export const hireParams = Type.Object({
+  task: Type.String({ description: 'What you want the hired agent to do, e.g. "Research the top AI payment startups"' }),
+  maxPrice: Type.Optional(Type.Number({ minimum: 0.01, description: 'Maximum USDC budget, default 5.00' })),
+  capability: Type.Optional(Type.String({ description: 'Agent capability to match: research, writing, coding. Auto-detected from task if omitted.' })),
+});
+
+function detectCapability(task: string): string {
+  if (/research|find|search|analyz|summariz|look up/i.test(task)) return 'research';
+  if (/write|draft|essay|blog|article|copy/i.test(task)) return 'writing';
+  if (/code|script|function|implement|build|program/i.test(task)) return 'coding';
+  return 'research';
+}
+
+function buildConditions(nexusUrl: string, jobId: string): ConditionsDefinition {
+  return {
+    version: '1.0',
+    escrowId: '',
+    conditions: [
+      { type: 'http_status', endpoint: `${nexusUrl}/health`, operator: 'eq', expected: 200 },
+      {
+        type: 'json_field',
+        endpoint: `${nexusUrl}/quality-check?jobId=${encodeURIComponent(jobId)}`,
+        field: 'wordCount',
+        operator: 'gte',
+        expected: 100,
+      },
+      {
+        type: 'json_field',
+        endpoint: `${nexusUrl}/quality-check?jobId=${encodeURIComponent(jobId)}`,
+        field: 'confidence',
+        operator: 'gte',
+        expected: 0.7,
+      },
+    ],
+    windowSeconds: 120,
+    checkIntervalSeconds: 10,
+    requiredPassRate: 0.8,
+  };
+}
+
+export async function executeHire(
+  params: { task: string; maxPrice?: number; capability?: string },
+): Promise<{ content: [{ type: 'text'; text: string }]; details: unknown }> {
+  const wallet = process.env.KROXY_AGENT_WALLET;
+  const privateKey = process.env.KROXY_AGENT_PRIVATE_KEY;
+  const nexusUrl = process.env.NEXUS_URL ?? 'http://localhost:3003';
+  const demoMode = process.env.KROXY_DEMO_MODE === '1';
+
+  if (!wallet) throw new Error('KROXY_AGENT_WALLET is not configured');
+  if (!demoMode && !privateKey) throw new Error('KROXY_AGENT_PRIVATE_KEY is not configured');
+
+  const task = params.task;
+  const maxPrice = params.maxPrice ?? 5.0;
+  const capability = params.capability ?? detectCapability(task);
+  const payerPrivateKey = privateKey ?? 'demo-private-key';
+  const jobId = `job_${Date.now()}_${randomBytes(3).toString('hex')}`;
+
+  // 1. Find matching agents
+  const agents = await findAgents(capability, maxPrice);
+  if (!agents.length) {
+    throw new Error(`No agents available for "${capability}" within $${maxPrice} USDC`);
+  }
+
+  // 2. Post job with verifier conditions pointing at Nexus
+  const conditions = buildConditions(nexusUrl, jobId);
+  const job = await postJob(jobId, task, capability, maxPrice, conditions, wallet);
+
+  // 3. Wait for a bid (up to 60s)
+  const jobWithBid = await pollJob(job.id, (j) => Boolean(j.bids?.length), 60_000);
+  if (!jobWithBid?.bids?.length) {
+    throw new Error(`No bids received within 60 seconds (jobId: ${job.id})`);
+  }
+
+  const bid = jobWithBid.bids[0];
+
+  // 4. Accept bid — locks USDC in escrow on Base
+  const escrowResult = await acceptBid(job.id, bid.id, payerPrivateKey);
+
+  // 5. Poll for completion (up to 5 minutes)
+  const completed = await pollJob(job.id, (j) => j.status === 'COMPLETED', 300_000);
+  if (!completed) {
+    throw new Error(
+      `Job timed out (jobId: ${job.id}, escrowId: ${escrowResult.escrowId}). ` +
+      `Funds are in escrow — check status at /api/jobs/${job.id}`,
+    );
+  }
+
+  const result = {
+    summary: (completed.deliverable as any)?.summary ?? '(no summary)',
+    keyFindings: (completed.deliverable as any)?.keyFindings ?? [],
+    sources: (completed.deliverable as any)?.sources ?? [],
+    agent: bid.providerWallet,
+    amountPaid: `${bid.priceUsdc} USDC`,
+    auditTrail: `https://kroxy.ai/audit/${escrowResult.escrowId}`,
+  };
+
+  return {
+    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    details: result,
+  };
+}

package/src/tools/offer.ts

@@ -0,0 +1,41 @@
+import { Type } from '@sinclair/typebox';
+import { registerProvider } from '../client.js';
+
+export const offerParams = Type.Object({
+  capability: Type.String({ description: 'Capability to offer: research, writing, coding, analysis, etc.' }),
+  price: Type.Number({ minimum: 0.01, description: 'Price per job in USDC, e.g. 2.50' }),
+  endpoint: Type.String({ description: 'Public URL where your agent receives job webhooks, e.g. https://myagent.example.com' }),
+  name: Type.Optional(Type.String({ description: 'Display name for your agent on the Kroxy job board' })),
+});
+
+export async function executeOffer(
+  params: { capability: string; price: number; endpoint: string; name?: string },
+): Promise<{ content: [{ type: 'text'; text: string }]; details: unknown }> {
+  const wallet = process.env.KROXY_AGENT_WALLET;
+  if (!wallet) throw new Error('KROXY_AGENT_WALLET is not configured');
+
+  const agent = await registerProvider({
+    walletAddress: wallet,
+    name: params.name ?? 'MyAgent',
+    endpoint: params.endpoint,
+    capabilities: [params.capability],
+    pricingUsdc: params.price,
+  });
+
+  const result = {
+    registered: true,
+    walletAddress: agent.walletAddress ?? wallet,
+    name: agent.name ?? params.name,
+    capabilities: agent.capabilities ?? [params.capability],
+    pricingUsdc: agent.pricingUsdc ?? params.price,
+    endpoint: params.endpoint,
+  };
+
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify(result, null, 2),
+    }],
+    details: result,
+  };
+}

package/src/tools/reputation.ts

@@ -0,0 +1,41 @@
+import { Type } from '@sinclair/typebox';
+import { getReputation } from '../client.js';
+
+export const reputationParams = Type.Object({
+  wallet: Type.Optional(Type.String({
+    description: 'Wallet address to look up. Defaults to KROXY_AGENT_WALLET (your own agent).',
+    pattern: '^0x[0-9a-fA-F]{40}$',
+  })),
+});
+
+export async function executeReputation(
+  params: { wallet?: string },
+): Promise<{ content: [{ type: 'text'; text: string }]; details: unknown }> {
+  const walletAddress = params.wallet ?? process.env.KROXY_AGENT_WALLET;
+  if (!walletAddress) throw new Error('No wallet address provided and KROXY_AGENT_WALLET is not configured');
+
+  const rep = await getReputation(walletAddress);
+  const score = rep.score ?? 0;
+  const interpretation =
+    score >= 80 ? 'Excellent — highly trusted agent' :
+    score >= 60 ? 'Good — established track record' :
+    score >= 20 ? 'New — building reputation' :
+                  'Low — exercise caution';
+
+  const result = {
+    address: walletAddress,
+    score,
+    successCount: rep.successCount ?? 0,
+    disputeCount: rep.disputeCount ?? 0,
+    totalEarned: rep.totalEarned ?? '0',
+    interpretation,
+  };
+
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify(result, null, 2),
+    }],
+    details: result,
+  };
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "rootDir": ".",
+    "outDir": "./dist"
+  },
+  "include": ["index.ts", "api.ts", "src/**/*.ts"],
+  "exclude": ["dist", "node_modules"]
+}