kompass-sdk 0.20.0 → 0.21.1

package/src/cli.ts

@@ -525,6 +525,119 @@ program
     console.log(`\n${online}/${health.length} sources online\n`);
   });
 
+// ── Onboard Command ─────────────────────────────────────
+
+program
+  .command("onboard")
+  .description("Onboard a new agent: wallet + ERC-8004 identity + Basename + ENS records")
+  .requiredOption("--name <name>", "Agent name (used for Basename, e.g. 'my-agent')")
+  .requiredOption("--description <desc>", "What this agent does")
+  .option("--categories <cats>", "Comma-separated categories", "general")
+  .option("--capabilities <caps>", "Comma-separated capabilities", "")
+  .option("--agent-type <type>", "provider | evaluator | both", "provider")
+  .option("--endpoint-mcp <url>", "MCP endpoint URL")
+  .option("--endpoint-x402 <url>", "x402 endpoint URL")
+  .option("--endpoint-http <url>", "HTTP endpoint URL")
+  .option("--pricing-model <model>", "escrow | x402 | free", "free")
+  .option("--pricing-rate <rate>", "Price per task in USDC")
+  .option("-n, --network <network>", "base or base-sepolia", "base")
+  .option("-w, --wallet <path>", "Existing wallet keystore path")
+  .option("--skip-basename", "Skip Basename registration")
+  .option("--skip-registry", "Skip Kompass Registry registration")
+  .option("--json", "Output as JSON")
+  .action(async (opts: any) => {
+    const { initOnboarding, completeOnboarding } = await import("./onboard.js");
+    const { KompassWallet } = await import("./wallet/index.js");
+
+    const options = {
+      name: opts.name,
+      description: opts.description,
+      categories: opts.categories.split(",").map((c: string) => c.trim()),
+      capabilities: opts.capabilities ? opts.capabilities.split(",").map((c: string) => c.trim()) : [],
+      agentType: opts.agentType as "provider" | "evaluator" | "both",
+      endpoints: {
+        mcp: opts.endpointMcp,
+        x402: opts.endpointX402,
+        http: opts.endpointHttp,
+      },
+      pricingModel: opts.pricingModel as "escrow" | "x402" | "free",
+      pricingRate: opts.pricingRate,
+      network: opts.network as "base" | "base-sepolia",
+      walletPath: opts.wallet,
+      skipBasename: opts.skipBasename,
+      skipKompassRegistry: opts.skipRegistry,
+    };
+
+    // Step 1: Initialize
+    if (!opts.json) console.log(`\n⚡ Kompass Agent Onboarding\n`);
+
+    const init = initOnboarding(options);
+
+    if (!opts.json) {
+      console.log(`  Wallet: ${init.walletAddress}`);
+      console.log(`  Network: ${init.network}`);
+      console.log(`  Estimated cost: ${init.estimatedCosts.total}`);
+      console.log(`\n  Fund this wallet with ETH before proceeding.`);
+    }
+
+    // Step 2: Poll for funding
+    if (!opts.json) console.log(`\n  Checking balance...`);
+
+    const wallet = KompassWallet.load(
+      options.walletPath ?? `${process.env.HOME}/.kompass/wallet.json`,
+      undefined,
+    );
+
+    const balance = await wallet.getBalance();
+
+    if (balance.ethRaw < 500000000000000n) {
+      if (opts.json) {
+        console.log(JSON.stringify({ status: "awaiting_funding", ...init }));
+      } else {
+        console.log(`  ETH balance: ${balance.eth}`);
+        console.log(`\n  ⚠ Insufficient funds. Send at least ${init.fundingRequired.eth} ETH to:`);
+        console.log(`    ${init.walletAddress}`);
+        console.log(`\n  Then run this command again.\n`);
+      }
+      return;
+    }
+
+    if (!opts.json) {
+      console.log(`  ETH balance: ${balance.eth} ✓`);
+      console.log(`\n  Starting registration...\n`);
+    }
+
+    // Step 3: Complete onboarding
+    try {
+      const result = await completeOnboarding(options, wallet);
+
+      if (opts.json) {
+        console.log(JSON.stringify(result, (key, value) =>
+          typeof value === "bigint" ? value.toString() : value
+        , 2));
+      } else {
+        console.log(`\n✅ Agent "${opts.name}" fully onboarded!\n`);
+        console.log(`  Wallet:    ${result.wallet.address}`);
+        console.log(`  ERC-8004:  agentId #${result.erc8004.agentId}`);
+        if (result.basename) {
+          console.log(`  Basename:  ${result.basename.fullName}`);
+        }
+        console.log(`  Records:   ${Object.keys(result.ensRecords.records).length} ENS text records`);
+        if (result.kompassRegistry) {
+          console.log(`  Registry:  registered on Kompass`);
+        }
+        console.log();
+      }
+    } catch (err: any) {
+      if (opts.json) {
+        console.log(JSON.stringify({ error: err.message }));
+      } else {
+        console.error(`\n❌ Onboarding failed: ${err.message}\n`);
+      }
+      process.exit(1);
+    }
+  });
+
 // ── Run ──────────────────────────────────────────────────
 
 program.parse();

package/src/erc8004.ts

@@ -0,0 +1,253 @@
+/**
+ * ERC-8004 Identity Registry — On-chain agent identity
+ *
+ * Contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (Base mainnet + 20 chains)
+ * Each agent gets a unique uint256 agentId (ERC-721 NFT) + agentURI pointing to metadata JSON.
+ */
+
+import type { Address, Hex } from "viem";
+import type { KompassWallet } from "./wallet/index.js";
+
+// ── Contract addresses ─────────────────────────────────────
+export const ERC8004_IDENTITY_REGISTRY: Address = "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432";
+
+// ── ABI (minimal — only the functions we need) ─────────────
+export const ERC8004IdentityAbi = [
+  {
+    type: "function",
+    name: "register",
+    inputs: [{ name: "agentURI", type: "string" }],
+    outputs: [{ name: "agentId", type: "uint256" }],
+    stateMutability: "nonpayable",
+  },
+  {
+    type: "function",
+    name: "setAgentURI",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "newURI", type: "string" },
+    ],
+    outputs: [],
+    stateMutability: "nonpayable",
+  },
+  {
+    type: "function",
+    name: "tokenURI",
+    inputs: [{ name: "tokenId", type: "uint256" }],
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view",
+  },
+  {
+    type: "function",
+    name: "ownerOf",
+    inputs: [{ name: "tokenId", type: "uint256" }],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view",
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "owner", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+  },
+  {
+    type: "function",
+    name: "getAgentWallet",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{ name: "", type: "address" }],
+    stateMutability: "view",
+  },
+  {
+    type: "function",
+    name: "setMetadata",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "metadataKey", type: "string" },
+      { name: "metadataValue", type: "bytes" },
+    ],
+    outputs: [],
+    stateMutability: "nonpayable",
+  },
+  {
+    type: "function",
+    name: "getMetadata",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "metadataKey", type: "string" },
+    ],
+    outputs: [{ name: "", type: "bytes" }],
+    stateMutability: "view",
+  },
+  {
+    type: "event",
+    name: "Registered",
+    inputs: [
+      { name: "agentId", type: "uint256", indexed: true },
+      { name: "agentURI", type: "string", indexed: false },
+      { name: "owner", type: "address", indexed: true },
+    ],
+  },
+] as const;
+
+// ── Types ──────────────────────────────────────────────────
+
+export interface AgentCard {
+  name: string;
+  description: string;
+  capabilities: string[];
+  categories: string[];
+  endpoints?: {
+    mcp?: string;
+    a2a?: string;
+    x402?: string;
+    http?: string;
+  };
+  paymentAddress: Address;
+  image?: string;
+}
+
+export interface RegisterERC8004Result {
+  agentId: bigint;
+  txHash: Hex;
+  agentURI: string;
+}
+
+// ── Functions ──────────────────────────────────────────────
+
+/**
+ * Register an agent on the ERC-8004 Identity Registry.
+ *
+ * @param wallet — KompassWallet with funded account
+ * @param agentURI — HTTPS or IPFS URL pointing to agent card JSON
+ * @param registryAddress — Override registry address (defaults to Base mainnet)
+ */
+export async function registerERC8004(
+  wallet: KompassWallet,
+  agentURI: string,
+  registryAddress: Address = ERC8004_IDENTITY_REGISTRY,
+): Promise<RegisterERC8004Result> {
+  const walletClient = wallet.getWalletClient() as any;
+  const publicClient = wallet.getPublicClient() as any;
+
+  const txHash = await walletClient.writeContract({
+    address: registryAddress,
+    abi: ERC8004IdentityAbi,
+    functionName: "register",
+    args: [agentURI],
+  });
+
+  const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+
+  // Parse agentId from Registered event log
+  // Registered(uint256 indexed agentId, string agentURI, address indexed owner)
+  // Event signature: keccak256("Registered(uint256,string,address)")
+  const REGISTERED_EVENT_SIG = "0x" + "d26eab7e9772dfa4e0f4cd96d3f0e9e4e2e4e9e4" as string; // placeholder
+  let agentId = 0n;
+  for (const log of receipt.logs) {
+    if (log.address.toLowerCase() === registryAddress.toLowerCase() && log.topics.length >= 2) {
+      // Check that this isn't a Transfer event (ERC-721 Transfer has 4 topics)
+      // Registered has 3 topics (sig + agentId + owner), Transfer has 4 (sig + from + to + tokenId)
+      // For safety, just grab the first non-Transfer event from this address
+      if (log.topics.length === 3) {
+        agentId = BigInt(log.topics[1]);
+        break;
+      }
+    }
+  }
+
+  if (agentId === 0n) {
+    // Fallback: try any log with 2+ topics from the registry
+    for (const log of receipt.logs) {
+      if (log.address.toLowerCase() === registryAddress.toLowerCase() && log.topics.length >= 2) {
+        agentId = BigInt(log.topics[1]);
+        break;
+      }
+    }
+    if (agentId === 0n) {
+      console.warn("[erc8004] Could not parse agentId from Registered event logs");
+    }
+  }
+
+  return { agentId, txHash, agentURI };
+}
+
+/**
+ * Update the agent URI for an existing agent.
+ */
+export async function setAgentURI(
+  wallet: KompassWallet,
+  agentId: bigint,
+  newURI: string,
+  registryAddress: Address = ERC8004_IDENTITY_REGISTRY,
+): Promise<Hex> {
+  const walletClient = wallet.getWalletClient() as any;
+  const publicClient = wallet.getPublicClient() as any;
+
+  const txHash = await walletClient.writeContract({
+    address: registryAddress,
+    abi: ERC8004IdentityAbi,
+    functionName: "setAgentURI",
+    args: [agentId, newURI],
+  });
+
+  await publicClient.waitForTransactionReceipt({ hash: txHash });
+  return txHash;
+}
+
+/**
+ * Get the agent URI (metadata JSON URL) for a given agentId.
+ */
+export async function getAgentURI(
+  wallet: KompassWallet,
+  agentId: bigint,
+  registryAddress: Address = ERC8004_IDENTITY_REGISTRY,
+): Promise<string> {
+  const publicClient = wallet.getPublicClient() as any;
+
+  return publicClient.readContract({
+    address: registryAddress,
+    abi: ERC8004IdentityAbi,
+    functionName: "tokenURI",
+    args: [agentId],
+  });
+}
+
+/**
+ * Get the owner of an agent NFT.
+ */
+export async function getAgentOwner(
+  wallet: KompassWallet,
+  agentId: bigint,
+  registryAddress: Address = ERC8004_IDENTITY_REGISTRY,
+): Promise<Address> {
+  const publicClient = wallet.getPublicClient() as any;
+
+  return publicClient.readContract({
+    address: registryAddress,
+    abi: ERC8004IdentityAbi,
+    functionName: "ownerOf",
+    args: [agentId],
+  });
+}
+
+/**
+ * Build an agent card JSON object for use as agentURI content.
+ */
+export function buildAgentCard(options: {
+  name: string;
+  description: string;
+  capabilities: string[];
+  categories: string[];
+  walletAddress: Address;
+  endpoints?: AgentCard["endpoints"];
+}): AgentCard {
+  return {
+    name: options.name,
+    description: options.description,
+    capabilities: options.capabilities,
+    categories: options.categories,
+    paymentAddress: options.walletAddress,
+    endpoints: options.endpoints,
+  };
+}

package/src/index.ts

@@ -243,3 +243,15 @@ export { CapabilityRouter } from "./router.js";
 export type { DoOptions, DoResult, CapabilityOption, CostPreference } from "./router.js";
 export { createAllSources } from "./sources/index.js";
 export type { UnifiedAgent, AgentSource, AgentProtocol, SourceAdapter } from "./sources/types.js";
+
+// ERC-8004 Identity Registration
+export { registerERC8004, setAgentURI, getAgentURI, getAgentOwner, buildAgentCard, ERC8004_IDENTITY_REGISTRY } from "./erc8004.js";
+export type { AgentCard, RegisterERC8004Result } from "./erc8004.js";
+
+// Basename Registration
+export { registerBasename, isBasenameAvailable, getBasenamePrice, basenameNode, setBasenameTextRecords, getBasenameText, BASENAME_REGISTRAR, BASENAME_L2_RESOLVER } from "./basename.js";
+export type { BasenameResult, TextRecord } from "./basename.js";
+
+// Agent Onboarding (full identity flow)
+export { initOnboarding, completeOnboarding, onboardAgent, checkOnboardingFunds, estimateOnboardingCost } from "./onboard.js";
+export type { OnboardOptions, OnboardResult, OnboardInitResult } from "./onboard.js";

package/src/matching.ts

@@ -173,13 +173,13 @@ function multiCriteriaScore(agent: UnifiedAgent): number {
   // Agents from sources we KNOW are live gateways (not just registrations)
   switch (agent.source as string) {
     case "bankr":
-      score += 15; // Bankr is a live gateway, always responds
+      score += 25; // Bankr is a live gateway, always responds, verified working
       break;
     case "locus":
-      score += 12; // Locus wrapped APIs are live
+      score += 20; // Locus wrapped APIs are live, verified working
       break;
     case "x402-ecosystem":
-      score += 10; // 402index verifies health
+      score += 18; // 402index verifies health, real payments
       break;
     case "acp":
       score += 8; // ACP agents are registered and active
@@ -188,9 +188,10 @@ function multiCriteriaScore(agent: UnifiedAgent): number {
       score += 8; // Olas mechs have on-chain delivery records
       break;
     case "mcp-registry":
-      // Only boost if it has a remote endpoint — many MCP servers are local-only
-      if (hasMcp) score += 5;
-      else score -= 5; // Penalize MCP without remote endpoint
+      // Most MCP servers on Smithery require auth or are offline
+      // Only boost if it has a remote endpoint, but still penalize vs verified live sources
+      if (hasMcp) score += 0; // Neutral — might work, might not
+      else score -= 10; // No remote endpoint = definitely can't call
       break;
     case "erc8004":
       // ERC-8004 is a registry — agents may or may not be live