# Quick check
curl https://botdn.com/agent/status

# Search a domain
curl https://botdn.com/agent/search/alice

# Build a mint transaction
curl -X POST https://botdn.com/agent/tx/mint \
  -H "Content-Type: application/json" \
  -d '{"domain":"alice"}'

import { BrowserProvider } from 'ethers';

// 1. Get unsigned payload from the API
const { data: tx } = await fetch('https://botdn.com/agent/tx/mint', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ domain: 'alice' }),
}).then(r => r.json());

// 2. Send to wallet — no private key handling in your code
const provider = new BrowserProvider(window.ethereum);
const signer = await provider.getSigner();

const txResponse = await signer.sendTransaction({
  to: tx.to,
  data: tx.data,
  value: BigInt(tx.value),
  chainId: tx.chainId, // 677
});

await txResponse.wait();
console.log('Minted!', txResponse.hash);

// Success
{
  "success": true,
  "data": { ... },
  "meta": {
    "chain": "BOT Chain",
    "chainId": 677,
    "timestamp": "2024-01-01T00:00:00.000Z"
  }
}

// Error
{
  "success": false,
  "code": 400,
  "message": "Domain is required",
  "details": "Field: domain"
}

{
  "success": true,
  "data": {
    "to": "0xBeB7B2BD305F0d9412EB1f4C49541FD048C363CE",
    "data": "0x3f8e4e90000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000056d6f6e7279000000000000000000000000000000000000000000000000000000",
    "value": "0",
    "chainId": 677,
    "contractName": "DomainNFT",
    "method": "mintDomain",
    "description": "Mint the domain "alice.bot" as an NFT on BOT Chain."
  },
  "meta": {
    "chain": "BOT Chain",
    "chainId": 677,
    "timestamp": "2024-07-21T12:00:00.000Z"
  }
}

# Step 1: Search
curl https://botdn.com/agent/search/bot
# → { "data": { "available": true, "owner": null } }

# Step 2: Generate Mint TX
curl -X POST https://botdn.com/agent/tx/mint \
  -H "Content-Type: application/json" \
  -d '{"domain":"bot"}'
# → { "data": { "to": "0xF960...", "data": "0x...", "value": "0", "chainId": 677 } }
# User signs and broadcasts → gets tokenId from DomainMinted event

# Step 3: Generate Set Primary TX
curl -X POST https://botdn.com/agent/tx/set-primary \
  -H "Content-Type: application/json" \
  -d '{"tokenId":"42","wallet":"0xAbCd1234567890AbCd1234567890AbCd12345678"}'
# → { "data": { "to": "0x7fA1...", "data": "0x...", "value": "0", "chainId": 677 } }

# Step 4: Generate Profile Update TX
curl -X POST https://botdn.com/agent/tx/update-profile \
  -H "Content-Type: application/json" \
  -d '{
    "tokenId": "42",
    "bio": "Web3 builder",
    "socialLinks": [{"platform":"twitter","url":"https://twitter.com/bot"}]
  }'
# → { "data": { "tokenId":"42","transactionCount":2,"transactions":[...] } }

curl -X POST https://botdn.com/agent/workflow/register-domain \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "bot",
    "wallet": "0xAbCd1234567890AbCd1234567890AbCd12345678",
    "setPrimary": true,
    "profile": {
      "bio": "Web3 builder",
      "socialLinks": [
        { "platform": "twitter", "url": "https://twitter.com/bot" }
      ]
    }
  }'

{
  "success": true,
  "data": {
    "domain": "bot",
    "fullDomain": "bot.bot",
    "wallet": "0xAbCd1234567890AbCd1234567890AbCd12345678",
    "totalSteps": 3,
    "steps": [
      {
        "step": 1,
        "action": "Mint Domain",
        "description": "Mint bot.bot as an NFT on BOT Chain",
        "transaction": {
          "to": "0xBeB7B2BD305F0d9412EB1f4C49541FD048C363CE",
          "data": "0x3f8e4e90...",
          "value": "0",
          "chainId": 677
        }
      },
      {
        "step": 2,
        "action": "Set Primary Domain",
        "description": "Set bot.bot as primary domain for your wallet",
        "transaction": {
          "to": "0xf9c1AeED9073382028D09B77A9691FC4408EFD2A",
          "data": "0xabcdef12...",
          "value": "0",
          "chainId": 677
        }
      },
      {
        "step": 3,
        "action": "Update Profile",
        "description": "Update profile: bio + social links",
        "transaction": [
          { "to": "0xF960...", "data": "0x...", "value": "0", "chainId": 677 },
          { "to": "0xF960...", "data": "0x...", "value": "0", "chainId": 677 }
        ]
      }
    ]
  },
  "meta": { "chain": "BOT Chain", "chainId": 677, "timestamp": "2024-07-21T12:00:00.000Z" }
}

import { generateText, tool } from 'ai';
import { openai } from '@ai-sdk/openai';
import { z } from 'zod';

const BASE = 'https://botdn.com';

const { text } = await generateText({
  model: openai('gpt-4o'),
  system: 'You are a BOT Domains assistant.',
  prompt: 'Is "alice.bot" available?',
  tools: {
    searchDomain: tool({
      description: 'Search for a .bot domain',
      parameters: z.object({ domain: z.string() }),
      execute: async ({ domain }) => {
        const res = await fetch(`${BASE}/agent/search/${domain}`);
        return res.json();
      },
    }),
    buildMintTx: tool({
      description: 'Generate unsigned mint transaction payload',
      parameters: z.object({ domain: z.string() }),
      execute: async ({ domain }) => {
        const res = await fetch(`${BASE}/agent/tx/mint`, {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ domain }),
        });
        return res.json();
      },
    }),
  },
  maxSteps: 3,
});

console.log(text);

import os, json, requests
from openai import OpenAI

BASE_URL = "https://botdn.com"
client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

def search_domain(domain):
    return requests.get(f"{BASE_URL}/agent/search/{domain}").json()

def build_mint_tx(domain):
    return requests.post(f"{BASE_URL}/agent/tx/mint",
        json={"domain": domain}).json()

# Use these as OpenAI tool handlers — see agent/examples/python.py for the full agent loop

// 1. MCP client discovers tools via OpenAPI spec
GET https://botdn.com/agent/docs/openapi.yaml

// 2. User says: "Check if bot.bot is available and mint it for me"

// 3. AI calls: search_domain
GET https://botdn.com/agent/search/bot
→ { "available": true }

// 4. AI calls: build_mint_transaction
POST https://botdn.com/agent/tx/mint
Body: { "domain": "bot" }
→ { "to": "0xF960...", "data": "0x...", "value": "0", "chainId": 677 }

// 5. AI presents transaction payload to user for wallet signing
// User signs via MetaMask/WalletConnect → tx broadcast → DomainMinted event emitted

// 400 — Validation error
{ "success": false, "code": 400, "message": "Domain is required", "details": "Field: domain" }

// 403 — Wallet doesn't own token
{ "success": false, "code": 403, "message": "Wallet does not own token #42" }

// 404 — Domain not minted
{ "success": false, "code": 404, "message": "Domain alice.bot is not minted" }

// 409 — Domain already taken
{ "success": false, "code": 409, "message": "Domain alice.bot is already taken" }

// 422 — Semantic validation error
{ "success": false, "code": 422, "message": "Invalid social platform", "details": "platform: snapchat" }

// 500 — Blockchain/RPC error
{ "success": false, "code": 500, "message": "Contract call failed", "details": "RPC timeout" }