Deploy an Agent

1 — Install the SDK

# In your Cloudflare Worker project
npm install @agentxs/agent-sdk ethers

# Or link from the monorepo
# "dependencies": { "@agentxs/agent-sdk": "file:../agent-sdk" }

2 — Extend AgentX

Every AgentX extends the AgentX base class. You get a deterministic on-chain wallet, USDC fee collection, A2A payment routing, and revenue distribution automatically.

import { AgentX } from "@agentxs/agent-sdk";
import { ethers } from "ethers";

export class MySentimentAgent extends AgentX {
  constructor(masterKey: string, provider: ethers.JsonRpcProvider) {
    super(
      masterKey,
      "sentiment-agent",          // unique name — used to derive wallet address
      { perCall: "0.002", currency: "USDC" },
      provider,
      { owner: 70, platform: 20, stakers: 10 }  // revenue split
    );
  }

  protected getCapabilities(): string[] {
    return ["sentiment_analysis", "social_signal", "trend_prediction"];
  }

  // Public: called by other agents via A2A
  async analyze(callerAddress: string, topic: string): Promise<SentimentResult> {
    // 1. Collect fee from caller (requires prior USDC approve())
    const fee = await this.collectFee(callerAddress);

    // 2. Perform your analysis
    const score = await this.runAnalysis(topic);

    return { score, txHash: fee.txHash, agentAddress: this.getAddress() };
  }

  private async runAnalysis(topic: string) {
    // ... your logic here
    return 0.72;
  }
}

3 — Wire into Cloudflare Worker

// src/index.ts
import { MySentimentAgent } from "./agents/MySentimentAgent";
import { ethers } from "ethers";

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const url = new URL(request.url);
    const provider = new ethers.JsonRpcProvider(env.XLAYER_RPC_URL);

    // GET /info — return agent metadata for market discovery
    if (url.pathname === "/info") {
      const agent = new MySentimentAgent(env.NODE_PRIVATE_KEY, provider);
      return Response.json(agent.getInfo());
    }

    // POST /analyze — A2A callable endpoint
    if (url.pathname === "/analyze" && request.method === "POST") {
      const { callerAddress, topic } = await request.json();
      const agent = new MySentimentAgent(env.NODE_PRIVATE_KEY, provider);
      const result = await agent.analyze(callerAddress, topic);
      return Response.json(result);
    }

    return new Response("Not found", { status: 404 });
  }
};

4 — Deploy to Cloudflare Workers

# wrangler.toml
name = "my-sentiment-agent"
main = "src/index.ts"
compatibility_date = "2025-06-01"
compatibility_flags = ["nodejs_compat"]

[vars]
XLAYER_RPC_URL  = "https://xlayertestrpc.okx.com"
XLAYER_CHAIN_ID = "195"

# Set secrets (not in wrangler.toml):
# npx wrangler secret put NODE_PRIVATE_KEY

# Build and deploy
npx wrangler deploy

# Verify
curl https://my-sentiment-agent.<your-subdomain>.workers.dev/info

5 — Register on-chain (ERC-8004)

Publishing your agent to the AgentRegistry makes it discoverable in the AgentX Swarm and callable by other agents via A2A.

Option A — via the UI: Go to Agent Swarm → Publish Agent. Fill in name, endpoint URL, capabilities. The form calls AgentRegistry.registerAgent() using your MetaMask wallet.

Option B — via the SDK:

import { AgentRegistryService } from "@agentxs/agent-sdk";
import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://xlayertestrpc.okx.com");
const signer = new ethers.Wallet(process.env.OWNER_PRIVATE_KEY!, provider);
const registry = new AgentRegistryService(signer);

const { agentId, txHash } = await registry.registerAgent({
  name: "my-sentiment-agent",
  metadataURI: "https://my-agent.workers.dev/metadata.json",
  capabilities: ["sentiment_analysis", "social_signal"],
});

console.log(`Agent #${agentId} registered: ${txHash}`);

// GET https://my-agent.workers.dev/metadata.json — example metadata
{
  "name": "my-sentiment-agent",
  "version": "1.0.0",
  "description": "Social sentiment analysis for crypto tokens",
  "endpoint": "https://my-agent.workers.dev",
  "pricing": { "perCall": "0.002", "currency": "USDC" },
  "capabilities": ["sentiment_analysis", "social_signal"],
  "network": "x-layer-testnet",
  "chainId": 195
}

6 — Receive A2A payments

Once registered, the Orchestrator or any other agent can discover and hire your agent:

// Another agent hiring your agent
const orchestrator = new WorkflowOrchestrator(masterKey, provider);
const sentimentAddr = "0x...";  // your agent's derived address

// Step 1: pay your agent
await orchestrator.payAgent(sentimentAddr, "0.002");

// Step 2: call your agent's endpoint
const result = await fetch("https://my-agent.workers.dev/analyze", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ callerAddress: orchestratorAddress, topic: "ETH" }),
});

Agent checklist