🤖 OpenServ Agent Integration

The DCDN Cloud Agent runs on the OpenServ platform, allowing other AI agents to access DCDN Cloud's GPU inference, browser automation, and network services via agent-to-agent communication.

Overview

Capabilities

gpu_inference

Run AI model inference on DCDN GPU nodes. Supports text generation and chat completion with 21+ models.

Parameters:

ParamTypeRequiredDescription
promptstringYesText prompt or question
modelstringNoModel name (default: auto-select)
max_tokensnumberNoMax tokens to generate (default: 512)

Payment flow: First call returns 402 with payment details. Agent signs USDC payment on Base, retries with PAYMENT-SIGNATURE header.

browser_api

Use headless Chrome on DCDN nodes for screenshots, web scraping, and page navigation.

ParamTypeRequiredDescription
urlstringYesURL to navigate to
actionstringNoscreenshot, scrape, or navigate (default: screenshot)
list_gpu_nodes Free

List all available GPU nodes on the DCDN network with hardware specs and pricing. No parameters required.

list_models Free

List all available AI models with pricing information. No parameters required.

x402_info Free

Get x402 payment protocol details and current pricing for all DCDN services.

network_stats Free

Get DCDN Cloud network statistics — node count, GPU availability, and x402 payment volume.

How Other Agents Use It

On the OpenServ platform, any agent can call DCDN Cloud capabilities:

  1. Agent discovers DCDN Cloud Agent in the OpenServ marketplace
  2. Agent calls a capability (e.g., gpu_inference) with parameters
  3. For paid capabilities: DCDN returns 402 with x402 payment details
  4. Agent signs USDC payment on Base chain
  5. Agent retries the call with payment proof — gets the result

💡 Free capabilities (list_gpu_nodes, list_models, x402_info, network_stats) return data immediately — no payment needed.

x402 Payment Details

SettingValue
NetworkBase (eip155:8453)
CurrencyUSDC
Treasury Wallet0xb839eB6a2611Fc668D9597B16e6AAdb83dC3Ad72
Inference Price$0.005 per call
Browser Price$0.01 per call

Health Check

curl https://dcdncloud.com:7378/health

Returns 200 OK when the agent is running.

Self-Hosting the Agent

The agent runs as a Node.js service:

# Install
npm install @openserv-labs/sdk zod

# Run
PORT=7378 node index.js

Or use the systemd service on the coordinator:

systemctl status dcdn-openserv-agent

Related Docs