feat(sdk): export ERC-8004 validation, rename Endpoint to ServiceDefinition

- Export Zod schemas (RegistrationFileSchema, ServiceDefinitionSchema, etc.)
- Add validateRegistrationFile(), parseRegistrationFile(), normalizeRegistrationFile()
- Add CAIP validation helpers (isValidAgentRegistry, isSatiAgentRegistry)
- Add network-aware buildSatiRegistrationEntry() with devnet support
- Add ERC8004_TYPE, VALID_TRUST_MODELS, SATI_CHAIN_IDS constants
- Add strict mode to fetchRegistrationFile()
- Rename Endpoint -> ServiceDefinition (deprecated re-export kept)
- Rename setEndpoint/removeEndpoint -> setService/removeService on builder
- Harden sati-agent0-sdk adapters with optional chaining and validation guards
- Update dashboard to use ServiceDefinition, SATI_CHAIN_IDS, strict fetch
- Add ERC-8004 best practices reference docs (spec, registration, reputation)

Author: tenequm

apps/dashboard/src/react-app/lib/sati.ts

@@ -483,7 +483,7 @@ export type AgentMetadata = RegistrationFile;
  * - Returns null on network errors or invalid URIs (never throws)
  */
 export async function fetchAgentMetadata(uri: string): Promise<AgentMetadata | null> {
-  return fetchRegistrationFile(uri);
+  return fetchRegistrationFile(uri, { strict: true });
 }
 
 /**

apps/dashboard/src/react-app/lib/x402.ts

@@ -18,21 +18,18 @@ import { x402Client, wrapFetchWithPayment, type SelectPaymentRequirements } from
 import { ExactSvmScheme } from "@x402/svm/exact/client";
 import { ExactSvmSchemeV1 } from "@x402/svm/exact/v1/client";
 import { getChain, type SolanaChain } from "./network";
-
-// CAIP-2 network identifiers used by x402 (based on genesis hash)
-const SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
-const SOLANA_DEVNET_CAIP2 = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+import { SATI_CHAIN_IDS } from "@cascade-fyi/sati-sdk";
 
 /**
  * Maps our app's chain identifier to x402's CAIP-2 network identifier.
  */
 function chainToCaip2(chain: SolanaChain): string {
   switch (chain) {
     case "solana:mainnet":
-      return SOLANA_MAINNET_CAIP2;
+      return SATI_CHAIN_IDS.mainnet;
     default:
       // devnet, testnet, localnet all use devnet CAIP-2
-      return SOLANA_DEVNET_CAIP2;
+      return SATI_CHAIN_IDS.devnet;
   }
 }
 

apps/dashboard/src/worker/identity-api.ts

@@ -23,9 +23,10 @@ import {
   Outcome as OutcomeEnum,
   type FeedbackData,
   SATI_PROGRAM_ADDRESS,
+  SATI_CHAIN_IDS,
   type AgentIdentity,
 } from "@cascade-fyi/sati-sdk";
-import type { Endpoint, TrustMechanism } from "@cascade-fyi/sati-sdk";
+import type { ServiceDefinition, TrustMechanism } from "@cascade-fyi/sati-sdk";
 import bs58 from "bs58";
 import type { Env } from "../env";
 
@@ -104,11 +105,8 @@ interface FeedbackRequest {
   feedbackHash?: string;
 }
 
-// CAIP-2 chain identifiers
-const CAIP2_CHAINS = {
-  mainnet: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
-  devnet: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
-} as const;
+// CAIP-2 chain identifiers (from SDK)
+const CAIP2_CHAINS = SATI_CHAIN_IDS;
 
 // =============================================================================
 // Helpers
@@ -199,7 +197,7 @@ export function createIdentityApi(env: Env) {
         description: body.description.trim(),
         image: body.image.trim(),
         externalUrl: body.externalUrl,
-        services: body.services as Endpoint[],
+        services: body.services as ServiceDefinition[],
         supportedTrust: body.supportedTrust as TrustMechanism[],
         active: body.active ?? true,
         x402Support: body.x402Support,
@@ -276,7 +274,7 @@ export function createIdentityApi(env: Env) {
       for (const agent of agents) {
         if (results.length >= limit) break;
 
-        const regFile = await fetchRegistrationFile(agent.uri);
+        const regFile = await fetchRegistrationFile(agent.uri, { strict: true });
 
         if (nameFilter) {
           const agentName = (regFile?.name ?? agent.name).toLowerCase();
@@ -326,7 +324,7 @@ export function createIdentityApi(env: Env) {
         return c.json({ error: "Agent not found" }, 404);
       }
 
-      const regFile = await fetchRegistrationFile(agent.uri);
+      const regFile = await fetchRegistrationFile(agent.uri, { strict: true });
 
       // Fetch reputation summary
       const networkConfig = getNetworkConfig(sati);

apps/dashboard/src/worker/index.ts

@@ -21,6 +21,7 @@ import {
   ContentType,
   type ParsedAttestation,
   type ParsedValidationAttestation,
+  SATI_CHAIN_IDS,
 } from "@cascade-fyi/sati-sdk";
 import bs58 from "bs58";
 import { paymentMiddleware, x402ResourceServer } from "@x402/hono";
@@ -90,8 +91,8 @@ const FACILITATOR_URL_MAINNET = "https://x402.dexter.cash";
 // const FACILITATOR_URL_MAINNET = "https://pay.openfacilitator.io";
 
 // Solana CAIP-2 network identifiers (used for x402 payments)
-const SOLANA_DEVNET_NETWORK = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1" as const;
-const SOLANA_MAINNET_NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" as const;
+const SOLANA_DEVNET_NETWORK = SATI_CHAIN_IDS.devnet;
+const SOLANA_MAINNET_NETWORK = SATI_CHAIN_IDS.mainnet;
 
 // Helper to get deployed config for a network
 function getNetworkConfig(network: "devnet" | "mainnet") {

docs/.vitepress/config.ts

@@ -59,6 +59,15 @@ export default defineConfig({
           { text: 'sati-sdk', link: '/reference/sati-sdk' },
         ]
       },
+      {
+        text: 'ERC-8004 Reference',
+        collapsed: true,
+        items: [
+          { text: 'Specification', link: '/reference/erc-8004/spec' },
+          { text: 'Registration Guide', link: '/reference/erc-8004/registration' },
+          { text: 'Reputation Guide', link: '/reference/erc-8004/reputation' },
+        ]
+      },
       {
         text: 'Deep Dive',
         items: [