@aixyz/erc-8004 0.20.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aixyz/erc-8004",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Payment-native SDK for AI Agent",
   "keywords": [
     "ai",

package/schemas/registration.test.ts

@@ -2,18 +2,17 @@ import { describe, expect, test } from "bun:test";
 import {
   ERC8004_REGISTRATION_TYPE,
   AgentRegistrationFileSchema,
-  StrictAgentRegistrationFileSchema,
   TrustMechanismSchema,
   ServiceSchema,
   RegistrationEntrySchema,
-  getServices,
-  hasX402Support,
 } from "./registration";
 
 const minimalValid = {
+  type: ERC8004_REGISTRATION_TYPE,
   name: "Agently Price Feed",
   description: "Real-time cryptocurrency price feed agent with x402 payment support",
   image: "ipfs://QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG",
+  services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/price-feed" }],
 };
 
 const fullValid = {
@@ -170,24 +169,9 @@ describe("RawAgentRegistrationFileSchema", () => {
     expect(result.did).toBe("did:pkh:eip155:11155111:0x1234567890abcdef1234567890abcdef12345678");
   });
 
-  test("type field is optional", () => {
-    const result = AgentRegistrationFileSchema.parse(minimalValid);
-    expect(result.type).toBeUndefined();
-  });
-
-  test("accepts endpoints as legacy field", () => {
-    const result = AgentRegistrationFileSchema.parse({
-      ...minimalValid,
-      endpoints: [{ name: "legacy-mcp", endpoint: "https://mcp.acme-agents.com/v0/translate" }],
-    });
-    expect(result.endpoints).toHaveLength(1);
-  });
-
-  test("accepts both x402support casings", () => {
-    const r1 = AgentRegistrationFileSchema.parse({ ...minimalValid, x402support: true });
-    const r2 = AgentRegistrationFileSchema.parse({ ...minimalValid, x402Support: true });
-    expect(r1.x402support).toBe(true);
-    expect(r2.x402Support).toBe(true);
+  test("accepts x402support", () => {
+    const result = AgentRegistrationFileSchema.parse({ ...minimalValid, x402support: true });
+    expect(result.x402support).toBe(true);
   });
 
   test("rejects missing name", () => {
@@ -209,58 +193,6 @@ describe("RawAgentRegistrationFileSchema", () => {
   });
 });
 
-describe("StrictAgentRegistrationFileSchema", () => {
-  const strictValid = {
-    ...minimalValid,
-    type: ERC8004_REGISTRATION_TYPE,
-    services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/price-feed" }],
-  };
-
-  test("accepts valid strict file", () => {
-    const result = StrictAgentRegistrationFileSchema.parse(strictValid);
-    expect(result.type).toBe(ERC8004_REGISTRATION_TYPE);
-    expect(result.services).toHaveLength(1);
-  });
-
-  test("rejects missing type", () => {
-    expect(() =>
-      StrictAgentRegistrationFileSchema.parse({
-        ...minimalValid,
-        services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/price-feed" }],
-      }),
-    ).toThrow();
-  });
-
-  test("rejects wrong type literal", () => {
-    expect(() =>
-      StrictAgentRegistrationFileSchema.parse({
-        ...minimalValid,
-        type: "wrong-type",
-        services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/price-feed" }],
-      }),
-    ).toThrow();
-  });
-
-  test("rejects empty services array", () => {
-    expect(() =>
-      StrictAgentRegistrationFileSchema.parse({
-        ...minimalValid,
-        type: ERC8004_REGISTRATION_TYPE,
-        services: [],
-      }),
-    ).toThrow();
-  });
-
-  test("rejects missing services", () => {
-    expect(() =>
-      StrictAgentRegistrationFileSchema.parse({
-        ...minimalValid,
-        type: ERC8004_REGISTRATION_TYPE,
-      }),
-    ).toThrow();
-  });
-});
-
 describe("AgentRegistrationFileSchema.safeParse", () => {
   test("returns success for valid data", () => {
     const result = AgentRegistrationFileSchema.safeParse(minimalValid);
@@ -277,80 +209,3 @@ describe("AgentRegistrationFileSchema.safeParse", () => {
     expect(result.success).toBe(false);
   });
 });
-
-describe("StrictAgentRegistrationFileSchema.safeParse", () => {
-  test("returns success for strict-valid data", () => {
-    const result = StrictAgentRegistrationFileSchema.safeParse({
-      ...minimalValid,
-      type: ERC8004_REGISTRATION_TYPE,
-      services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/price-feed" }],
-    });
-    expect(result.success).toBe(true);
-  });
-
-  test("returns failure when type is missing", () => {
-    const result = StrictAgentRegistrationFileSchema.safeParse({
-      ...minimalValid,
-      services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/price-feed" }],
-    });
-    expect(result.success).toBe(false);
-  });
-
-  test("returns failure when services is empty", () => {
-    const result = StrictAgentRegistrationFileSchema.safeParse({
-      ...minimalValid,
-      type: ERC8004_REGISTRATION_TYPE,
-      services: [],
-    });
-    expect(result.success).toBe(false);
-  });
-});
-
-describe("getServices", () => {
-  test("returns services when present", () => {
-    const file = {
-      ...minimalValid,
-      services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/translate" }],
-    };
-    expect(getServices(file)).toEqual([{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/translate" }]);
-  });
-
-  test("falls back to endpoints", () => {
-    const file = {
-      ...minimalValid,
-      endpoints: [{ name: "legacy-mcp", endpoint: "https://mcp.acme-agents.com/v0/translate" }],
-    };
-    expect(getServices(file)).toEqual([{ name: "legacy-mcp", endpoint: "https://mcp.acme-agents.com/v0/translate" }]);
-  });
-
-  test("prefers services over endpoints", () => {
-    const file = {
-      ...minimalValid,
-      services: [{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/translate" }],
-      endpoints: [{ name: "legacy-mcp", endpoint: "https://mcp.acme-agents.com/v0/translate" }],
-    };
-    expect(getServices(file)).toEqual([{ name: "mcp-server", endpoint: "https://mcp.acme-agents.com/v1/translate" }]);
-  });
-
-  test("returns empty array when neither present", () => {
-    expect(getServices(minimalValid as any)).toEqual([]);
-  });
-});
-
-describe("hasX402Support", () => {
-  test("returns true for x402support: true", () => {
-    expect(hasX402Support({ ...minimalValid, x402support: true })).toBe(true);
-  });
-
-  test("returns true for x402Support: true", () => {
-    expect(hasX402Support({ ...minimalValid, x402Support: true })).toBe(true);
-  });
-
-  test("returns false when both are false", () => {
-    expect(hasX402Support({ ...minimalValid, x402support: false, x402Support: false })).toBe(false);
-  });
-
-  test("returns false when neither is set", () => {
-    expect(hasX402Support(minimalValid as any)).toBe(false);
-  });
-});

package/schemas/registration.ts

@@ -1,12 +1,5 @@
 import { z } from "zod";
 
-/**
- * ERC-8004 Raw Agent Registration File Schema
- * For parsing raw registration files fetched from IPFS/URIs
- *
- * Based on: https://github.com/erc-8004/erc-8004-contracts/blob/093d7b91eb9c22048d411896ed397d695742a5f8/ERC8004SPEC.md#agent-uri-and-agent-registration-file
- */
-
 export const ERC8004_REGISTRATION_TYPE = "https://eips.ethereum.org/EIPS/eip-8004#registration-v1";
 
 /**
@@ -50,12 +43,14 @@ export const RegistrationEntrySchema = z.object({
 });
 
 /**
- * Raw Agent Registration File Schema
- * For parsing registration files fetched from IPFS/URIs
+ * ERC-8004 Raw Agent Registration File Schema
+ * For parsing raw registration files fetched from IPFS/URIs
+ *
+ * Based on: https://github.com/erc-8004/erc-8004-contracts/blob/093d7b91eb9c22048d411896ed397d695742a5f8/ERC8004SPEC.md#agent-uri-and-agent-registration-file
  */
 export const AgentRegistrationFileSchema = z.object({
   // Schema identifiers
-  type: z.string().optional(),
+  type: z.literal(ERC8004_REGISTRATION_TYPE),
   $schema: z.string().optional(),
 
   // ERC-721 metadata compatibility (required)
@@ -64,13 +59,11 @@ export const AgentRegistrationFileSchema = z.object({
   image: z.string(),
 
   // Service endpoints
-  services: z.array(ServiceSchema).optional(),
-  endpoints: z.array(ServiceSchema).optional(), // Legacy field name
+  services: z.array(ServiceSchema).min(1, "at least one service endpoint is required"),
 
   // Agent configuration
   active: z.boolean().optional(),
   x402support: z.boolean().optional(),
-  x402Support: z.boolean().optional(), // Alternative casing
 
   // Cross-chain & identity
   registrations: z.array(RegistrationEntrySchema).optional(),
@@ -79,35 +72,7 @@ export const AgentRegistrationFileSchema = z.object({
   did: z.string().optional(),
 });
 
-/**
- * Strict Schema - for creating new registration files
- * Requires correct type literal and at least one service
- */
-export const StrictAgentRegistrationFileSchema = AgentRegistrationFileSchema.extend({
-  type: z.literal(ERC8004_REGISTRATION_TYPE),
-  services: z.array(ServiceSchema).min(1, "At least one service endpoint is required"),
-});
-
 export type TrustMechanism = z.infer<typeof TrustMechanismSchema>;
 export type Service = z.infer<typeof ServiceSchema>;
 export type RegistrationEntry = z.infer<typeof RegistrationEntrySchema>;
 export type AgentRegistrationFile = z.infer<typeof AgentRegistrationFileSchema>;
-export type StrictAgentRegistrationFile = z.infer<typeof StrictAgentRegistrationFileSchema>;
-
-/**
- * Get services from a registration file
- * Handles both `services` (new) and `endpoints` (legacy) field names
- * @default TODO: parse and merge both fields
- */
-export function getServices(file: AgentRegistrationFile | StrictAgentRegistrationFile): Service[] {
-  return file.services ?? file.endpoints ?? [];
-}
-
-/**
- * Check if agent supports x402 payment protocol
- * Handles both `x402support` and `x402Support` casing variants
- * @deprecated TODO: parse and merge both fields
- */
-export function hasX402Support(file: AgentRegistrationFile | StrictAgentRegistrationFile): boolean {
-  return file.x402support === true || file.x402Support === true;
-}