Skip to content

Robocular/clawdia-services

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
README.md
README.md
 
 

Repository files navigation

Clawdia API Suite

36 AI agent infrastructure services. Every API an AI agent needs — wallets, identity, storage, search, code execution, LLM routing, DeFi, and more. All live, all JSON, all agent-native.

Built for the A2A (Agent-to-Agent) era. Each service exposes /.well-known/agent.json and /llms.txt for machine discovery.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Agent Gateway (:3021)                      │
│              Unified discovery + health checks               │
├──────────┬──────────┬──────────┬──────────┬─────────────────┤
│  Infra   │  DeFi    │  Data    │ Compute  │    Utility      │
│ 12 svcs  │ 3 svcs   │ 7 svcs   │ 4 svcs   │   6 svcs       │
├──────────┴──────────┴──────────┴──────────┴─────────────────┤
│           Shared: Request Logger → SQLite (analytics.db)     │
│           Health Monitor (cron 5m) + Morning Report          │
└─────────────────────────────────────────────────────────────┘

Stack: Node.js (Fastify) · SQLite · Chromium · ethers.js v6 · pm2 + nginx

Services

Infrastructure (12 services)

Service Port Description
Agent Registry 3009 Service registry — register, discover, search, rate agent services
Agent Identity 3010 Disposable identities — Ed25519 signing, DIDs, attestations, challenge-response
Agent Referral 3011 Referral tracking — agent-to-agent commissions, click/conversion analytics
Agent Memory 3013 Persistent KV + vector search — 128d embeddings, conversations, namespaces
Agent Task Queue 3014 Distributed job queue — workers, priorities, workflows, DLQ, webhooks
Agent Secrets 3015 Encrypted vault — AES-256-GCM, namespaces, versioning, audit logs
Agent Scheduler 3016 Job scheduling — cron expressions, intervals, one-time, webhooks
Agent Webhooks 3017 Webhook relay — HMAC verification, retry logic, event filtering
Agent Event Bus 3018 Pub-sub messaging — channels, WebSocket subscriptions, event replay
Agent File Storage 3019 Temp file storage — upload, download, share with TTL expiration
Agent Log Drain 3020 Centralized logging — structured JSON, batch ingest, WebSocket tailing
Agent Uptime Monitor 3031 Health monitoring — 30s-1h intervals, webhook alerts, incident history

DeFi & Trading (3 services)

Service Port Description
Agent Wallet 3002 Non-custodial multi-chain wallet — create, balance, send across 7 chains
DeFi Trading 3004 Hyperliquid DEX wrapper — 229 perp markets, orders, positions
DeFi MCP 3006 MCP server for DeFi — 12 tools for token research and analytics

Blockchain (2 services)

Service Port Description
Contract Deployer 3008 Solidity compiler + deployer — 9 chains, 5 templates (ERC-20, ERC-721, etc.)
Token Launchpad 3012 ERC-20 token deployer — 5 templates, 7 chains, built-in solc

Data & Analytics (7 services)

Service Port Description
On-Chain Analytics 3005 Token analytics — DexScreener + GeckoTerminal, 8 chains
Crypto Feeds 3007 WebSocket price feeds — Bybit, 40 pairs, ticker/klines/orderbook
Agent Screenshot 3022 URL-to-image — Chromium, 5 viewports, full-page, dark mode
Agent Scraper 3023 Web extraction — URL to markdown/text/HTML/structured, JS rendering
Agent Transform 3027 Data conversion — JSON/CSV/XML/YAML/TSV + base64, hashing, formatting
Agent Geo 3033 IP geolocation — MaxMind self-hosted, batch lookup, distance calc
Agent Search 3034 Web search — DuckDuckGo, multi-query, extract modes

Compute & AI (4 services)

Service Port Description
Agent Code Runner 3024 Sandboxed execution — JS, Python, TypeScript, Bash with resource limits
Agent PDF Gen 3025 PDF generation — from HTML, Markdown, URLs, templates via Chromium
Agent Image Proc 3026 Image processing — resize, convert, crop, QR, pipelines, 6 formats
Agent LLM Router 3035 Multi-provider LLM proxy — OpenAI, Anthropic, Google, Groq, Together, DeepSeek

Utility (4 services)

Service Port Description
Agent Short URL 3029 URL shortener — analytics, custom slugs, expiring links, bulk ops
Agent DNS 3030 DNS toolkit — resolve, WHOIS/RDAP, availability, propagation analysis
Agent Paste 3032 Code sharing — auto-detection, collections, diffing, expiration
Agent Email 3028 Email API — plain text, HTML, templates, SMTP config, delivery tracking

Security (1 service)

Service Port Description
Poison Guard 3003 Address poisoning detector — dust attacks, similarity analysis, risk scoring

Gaming (1 service)

Service Port Description
Fair Games 3001 Provably fair games — HMAC-SHA256 proofs, dice, coinflip, roulette, lottery

Platform Services

Service Port Description
Agent Gateway 3021 Unified discovery — browse, search, health-check all services
Analytics API 3036 Request analytics — per-service stats, time series, error tracking

Quick Start

Every service follows the same pattern:

# Health check
curl https://agent-wallet.your-server.example.com/health

# Machine discovery
curl https://agent-wallet.your-server.example.com/.well-known/agent.json
curl https://agent-wallet.your-server.example.com/llms.txt

Example: Create a wallet

curl -X POST https://agent-wallet.your-server.example.com/api/wallets/create \
  -H "Content-Type: application/json" \
  -d '{"chain": "base"}'

Example: Take a screenshot

curl -X POST https://agent-screenshot.your-server.example.com/api/screenshot \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "viewport": "desktop"}' \
  --output screenshot.png

Example: Run Python code

curl -X POST https://agent-coderunner.your-server.example.com/api/execute \
  -H "Content-Type: application/json" \
  -d '{"language": "python", "code": "print(sum(range(100)))"}'

Example: Web search

curl "https://agent-search.your-server.example.com/api/search?q=AI+agent+protocols&max=5"

Example: Scrape a page

curl -X POST https://agent-scraper.your-server.example.com/api/scrape \
  -H "Content-Type: application/json" \
  -d '{"url": "https://news.ycombinator.com", "format": "markdown"}'

Auth Pattern

All services use Bearer token auth:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://service.your-server.example.com/api/endpoint

Free tier credits are included for testing. Additional credits via USDC on Base.

Machine Discovery

Every service exposes two discovery endpoints:

  • /.well-known/agent.json — JSON metadata (name, description, endpoints, auth)
  • /llms.txt — Plain text description for LLM consumption

The Agent Gateway aggregates all services:

# List all services
curl https://agent-gateway.your-server.example.com/api/services

# Search by keyword
curl "https://agent-gateway.your-server.example.com/api/services?search=wallet"

# Health check all
curl https://agent-gateway.your-server.example.com/api/services/health

Observability

Request Logging

Every request across all 36 services is logged to a shared SQLite database with:

  • Service name, method, path, status code
  • Response time (ms), timestamp
  • Client IP and user agent

Analytics API

Query platform-wide metrics:

# Overview stats
curl https://analytics-api.your-server.example.com/api/overview

# Per-service breakdown
curl "https://analytics-api.your-server.example.com/api/services?period=24h"

# Time series
curl "https://analytics-api.your-server.example.com/api/timeseries?granularity=hour"

# Slowest endpoints
curl "https://analytics-api.your-server.example.com/api/slow?threshold=100"

Health Monitoring

  • Cron job every 5 minutes checking /health on all services
  • Auto-restart on first failure via pm2
  • Telegram alert on 2+ consecutive failures
  • Daily morning report with traffic, costs, and system stats

Tech Stack

Component Technology
Runtime Node.js 20 (Fastify)
Database SQLite (better-sqlite3)
Browser Chromium (Playwright)
Blockchain ethers.js v6
Process Manager pm2
Reverse Proxy nginx
Hosting Ubuntu 24.04 VPS
Landing Pages Vercel
Payments USDC on Base

Landing Pages

Service URL
Agent Scraper https://agent-scraper-virid.vercel.app
Agent Search https://agent-search-landing.vercel.app
Agent Screenshot https://agent-screenshot.vercel.app
Agent LLM Router https://agent-llm-landing.vercel.app
Agent Code Runner https://agent-coderunner.vercel.app
Services Portal https://services-portal-sand.vercel.app

Built by Clawdia — an autonomous AI builder running 24/7.

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors