Release v0.4.1

ryanio · ryanio · commit 85f72216bedc · 2026-05-06T02:14:15.000Z
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,6 +1,6 @@
 # tool-sdk — Agent Conventions
 
-TypeScript SDK and CLI for building ERC-XXXX compliant AI agent tools.
+TypeScript SDK and CLI for building ERC-Draft compliant AI agent tools.
 
 ## Quick Reference
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @opensea/tool-sdk
 
+## 0.4.1
+
+### Patch Changes
+
+- 5ea8a05: Replace ERC-XXXX placeholder references with ERC-Draft throughout CLI help text, schema defaults, and documentation.
+
 ## 0.4.0
 
 ### Minor Changes
@@ -80,7 +86,7 @@
 
 ### Patch Changes
 
-- 905ed4a: Initial release of `@opensea/tool-sdk` — SDK and CLI for building ERC-XXXX compliant AI agent tools.
+- 905ed4a: Initial release of `@opensea/tool-sdk` — SDK and CLI for building ERC-Draft compliant AI agent tools.
 
   ### Core SDK
 
@@ -93,7 +99,7 @@
 
   - `ToolRegistryClient` with `registerTool`, `setAccessPredicate`, `tryHasAccess`, and `listToolsByCreator`.
   - Canonical CREATE2 deployments on Base mainnet: `TOOL_REGISTRY` (v0.1), `ERC721_OWNER_PREDICATE`, `ERC1155_OWNER_PREDICATE`. Each is a `Deployment` object (`{ address, chains, overrides? }`); resolve per-chain with `deploymentAddress(deployment, chainId)`.
-  - `register` CLI enforces `creatorAddress` matches the signing wallet per ERC-XXXX spec.
+  - `register` CLI enforces `creatorAddress` matches the signing wallet per ERC-Draft spec.
   - `IAccessPredicate` (interface ID `0xbdf9dc18`) and `IToolRegistry` ABIs exported, including `name()` / `version()` view methods. Predicates expose machine-readable access requirements via `getRequirements(toolId)` returning `AccessRequirement[]` with `RequirementLogic` (AND/OR). Marker interfaces `IERC721Holding`, `IERC1155Holding`, `ISubscription` shipped via `IRequirementTypes.sol`.
 
   ### Access gates
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # @opensea/tool-sdk
 
-SDK and CLI for building [ERC-XXXX](https://github.com/ProjectOpenSea/tool-registry/blob/main/eip-xxxx-tool-registry.md) compliant AI agent tools. Provides manifest validation, onchain registration, gating middleware, framework adapters, and project scaffolding.
+SDK and CLI for building [ERC-Draft](https://github.com/ProjectOpenSea/tool-registry/blob/main/eip-draft-tool-registry.md) compliant AI agent tools. Provides manifest validation, onchain registration, gating middleware, framework adapters, and project scaffolding.
 
 Pairs with the onchain reference implementation at [ProjectOpenSea/tool-registry](https://github.com/ProjectOpenSea/tool-registry) — the `ToolRegistry` contract and example access predicates this SDK reads from and writes to.
 
@@ -30,7 +30,7 @@ npx @opensea/tool-sdk register \
 
 ### `init [name]`
 
-Scaffold a new ERC-XXXX tool project with interactive prompts.
+Scaffold a new ERC-Draft tool project with interactive prompts.
 
 ```bash
 npx @opensea/tool-sdk init my-tool
@@ -41,7 +41,7 @@ Supports Vercel, Cloudflare Workers, and Express templates.
 
 ### `validate [path]`
 
-Validate a tool manifest JSON file against the ERC-XXXX schema.
+Validate a tool manifest JSON file against the ERC-Draft schema.
 
 ```bash
 npx @opensea/tool-sdk validate ./manifest.json
@@ -211,7 +211,7 @@ Type-narrowing identity function for manifest definitions.
 import { defineManifest } from "@opensea/tool-sdk"
 
 export const manifest = defineManifest({
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "my-tool",
   description: "A useful tool",
   endpoint: "https://my-tool.vercel.app",
@@ -230,7 +230,7 @@ export const manifest = defineManifest({
 
 ### `validateManifest(data)`
 
-Validates unknown data against the ERC-XXXX manifest schema.
+Validates unknown data against the ERC-Draft manifest schema.
 
 ```typescript
 import { validateManifest } from "@opensea/tool-sdk"
@@ -739,4 +739,4 @@ app.post("/api", toExpressHandler(handler))
 
 ## ERC Spec
 
-See the full [ERC-XXXX Tool Registry specification](https://github.com/ProjectOpenSea/tool-registry/blob/main/eip-xxxx-tool-registry.md) for details on manifest schema, origin binding, creator binding, and consumer verification.
+See the full [ERC-Draft Tool Registry specification](https://github.com/ProjectOpenSea/tool-registry/blob/main/eip-draft-tool-registry.md) for details on manifest schema, origin binding, creator binding, and consumer verification.
diff --git a/docs/predicate-gating-guide.md b/docs/predicate-gating-guide.md
@@ -47,7 +47,7 @@ import {
 } from "@opensea/tool-sdk"
 
 export const manifest = defineManifest({
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "my-gated-tool",
   description: "A tool gated by an onchain access predicate",
   endpoint: "https://my-tool.vercel.app",
diff --git a/package.json b/package.json
@@ -1,8 +1,8 @@
 {
   "name": "@opensea/tool-sdk",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
-  "description": "SDK and CLI for building ERC-XXXX compliant AI agent tools",
+  "description": "SDK and CLI for building ERC-Draft compliant AI agent tools",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ProjectOpenSea/tool-sdk.git"
diff --git a/src/__tests__/deploy-integration.test.ts b/src/__tests__/deploy-integration.test.ts
@@ -312,7 +312,7 @@ describe("deploy command (mocked shell)", () => {
     })
 
     const mismatchManifest = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "my-tool",
       description: "A test tool",
       endpoint: "https://evil-site.example.com",
@@ -365,7 +365,7 @@ describe("deploy command (mocked shell)", () => {
     })
 
     const validManifest = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "my-tool",
       description: "A test tool",
       endpoint: "https://my-tool-final.vercel.app",
@@ -429,7 +429,7 @@ describe("deploy command (mocked shell)", () => {
     })
 
     const validManifest = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "my-tool",
       description: "A test tool",
       endpoint: "https://my-tool-final.vercel.app",
@@ -503,7 +503,7 @@ describe("deploy command (mocked shell)", () => {
     })
 
     const validManifest = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "my-tool",
       description: "A test tool",
       endpoint: "https://my-tool-final.vercel.app",
diff --git a/src/__tests__/dry-run-gate.test.ts b/src/__tests__/dry-run-gate.test.ts
@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it, vi } from "vitest"
 
 const SAMPLE_MANIFEST = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "paid-tool",
   description: "A paid tool for testing",
   endpoint: "https://paid.example.com",
diff --git a/src/__tests__/handler.test.ts b/src/__tests__/handler.test.ts
@@ -6,7 +6,7 @@ import type { ManifestDefinition } from "../lib/manifest/index.js"
 import type { GateMiddleware } from "../types.js"
 
 const testManifest = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool",
   description: "A test tool",
   endpoint: "https://test.example.com",
diff --git a/src/__tests__/hash.test.ts b/src/__tests__/hash.test.ts
@@ -5,7 +5,7 @@ import { computeManifestHash } from "../lib/onchain/hash.js"
 describe("computeManifestHash", () => {
   it("should match the free-tool test vector from the ERC spec", () => {
     const freeToolManifest = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "nft-price-oracle",
       description: "Returns estimated floor price for any NFT collection.",
       endpoint: "https://tools.example.com/nft-price-oracle",
@@ -37,13 +37,13 @@ describe("computeManifestHash", () => {
 
     const hash = computeManifestHash(freeToolManifest)
     expect(hash).toBe(
-      "0x85f160012d9fd30c7e82bc9d3959c90ec9df3c7d69009a343d8ee01904321290",
+      "0x142af74ae3e1b7aee9a8249fab3507dada81c925fbfd0a63d0a5a9cac085b392",
     )
   })
 
   it("should match the paid-tool test vector from the ERC spec", () => {
     const paidToolManifest = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "premium-analytics",
       description: "Advanced portfolio analytics for NFT holders.",
       endpoint: "https://tools.example.com/premium-analytics",
@@ -85,13 +85,13 @@ describe("computeManifestHash", () => {
 
     const hash = computeManifestHash(paidToolManifest)
     expect(hash).toBe(
-      "0xf5c2253fa557ef61e7b91fdfb3613c5a14acf6f986193a40aeb0b481dc6cbac3",
+      "0x5a0550de1c789afc64bd64128091f584d5a5a9b17788c267a4e974ccbf2c134d",
     )
   })
 
   it("should produce deterministic hashes", () => {
     const manifest = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "test",
       description: "A test tool",
       endpoint: "https://test.example.com",
diff --git a/src/__tests__/inspect.test.ts b/src/__tests__/inspect.test.ts
@@ -2,7 +2,7 @@ import { afterEach, describe, expect, it, vi } from "vitest"
 import { computeManifestHash } from "../lib/onchain/hash.js"
 
 const VALID_MANIFEST = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool",
   description: "A test tool",
   endpoint: "https://test.example.com",
diff --git a/src/__tests__/load-manifest.test.ts b/src/__tests__/load-manifest.test.ts
@@ -14,7 +14,7 @@ import { loadManifest } from "../cli/commands/load-manifest.js"
 const fixturesDir = join(import.meta.dirname, "__fixtures__")
 
 const validManifestJson = JSON.stringify({
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool",
   description: "A test tool",
   endpoint: "https://test.example.com",
@@ -25,7 +25,7 @@ const validManifestJson = JSON.stringify({
 
 const validManifestTs = `
 export const manifest = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool-ts",
   description: "A TypeScript test tool",
   endpoint: "https://test.example.com",
@@ -37,7 +37,7 @@ export const manifest = {
 
 const defaultExportManifestTs = `
 export default {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool-default",
   description: "A TypeScript test tool with default export",
   endpoint: "https://test.example.com",
diff --git a/src/__tests__/manifest.test.ts b/src/__tests__/manifest.test.ts
@@ -7,7 +7,7 @@ import {
 } from "../lib/manifest/index.js"
 
 const validManifest = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "nft-price-oracle",
   description: "Returns estimated floor price for any NFT collection.",
   endpoint: "https://tools.example.com/nft-price-oracle",
diff --git a/src/__tests__/register.test.ts b/src/__tests__/register.test.ts
@@ -7,7 +7,7 @@ const TEST_PRIVATE_KEY =
 const TEST_ACCOUNT = privateKeyToAccount(TEST_PRIVATE_KEY)
 
 const validManifest = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool",
   description: "A test tool",
   endpoint: "https://test.example.com",
diff --git a/src/__tests__/update-metadata.test.ts b/src/__tests__/update-metadata.test.ts
@@ -1,7 +1,7 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
 
 const VALID_MANIFEST = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool",
   description: "A test tool",
   endpoint: "https://test.example.com",
diff --git a/src/__tests__/verify-probe.test.ts b/src/__tests__/verify-probe.test.ts
@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it, vi } from "vitest"
 
 const VALID_MANIFEST = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "test-tool",
   description: "A test tool",
   endpoint: "https://test.example.com",
diff --git a/src/__tests__/well-known.test.ts b/src/__tests__/well-known.test.ts
@@ -4,7 +4,7 @@ import type { ToolManifest } from "../lib/manifest/types.js"
 import { createWellKnownHandler } from "../lib/middleware/well-known.js"
 
 const testManifest = {
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "nft-price-oracle",
   description: "Returns estimated floor price for any NFT collection.",
   endpoint: "https://tools.example.com/nft-price-oracle",
@@ -67,7 +67,7 @@ describe("createWellKnownHandler", () => {
 
   it("should accept ManifestDefinition with EnvResolver lambdas", async () => {
     const definition: ManifestDefinition = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "lambda-tool",
       description: "A tool with lambda fields",
       endpoint: env => env.TOOL_ENDPOINT ?? "https://fallback.example.com",
@@ -95,7 +95,7 @@ describe("createWellKnownHandler", () => {
 
   it("should accept explicit env for non-Node runtimes", async () => {
     const definition: ManifestDefinition = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "cf-tool",
       description: "Cloudflare Workers tool",
       endpoint: env => env.TOOL_ENDPOINT!,
@@ -118,7 +118,7 @@ describe("createWellKnownHandler", () => {
   it("should resolve ManifestDefinition only once (cached)", async () => {
     let callCount = 0
     const definition: ManifestDefinition = {
-      type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
       name: "cached-tool",
       description: "Tests caching",
       endpoint: env => {
diff --git a/src/cli/commands/init.ts b/src/cli/commands/init.ts
@@ -56,7 +56,7 @@ function copyTemplateDir(
 }
 
 export const initCommand = new Command("init")
-  .description("Scaffold a new ERC-XXXX tool project")
+  .description("Scaffold a new ERC-Draft tool project")
   .argument("[name]", "Tool name")
   .option("--no-interactive", "Skip interactive prompts (uses defaults)")
   .action(async (nameArg: string | undefined, options: InitOptions) => {
@@ -74,7 +74,7 @@ export const initCommand = new Command("init")
       endpoint = `https://${name}.vercel.app`
     } else {
       const clack = await import("@clack/prompts")
-      clack.intro(pc.cyan("Create a new ERC-XXXX Tool"))
+      clack.intro(pc.cyan("Create a new ERC-Draft Tool"))
 
       if (nameArg) {
         name = nameArg
diff --git a/src/cli/commands/register.ts b/src/cli/commands/register.ts
@@ -135,7 +135,7 @@ export const registerCommand = new Command("register")
     if (manifest.creatorAddress.toLowerCase() !== address.toLowerCase()) {
       console.error(
         pc.red(
-          `Error: manifest.creatorAddress (${manifest.creatorAddress}) does not match your wallet (${address}). The ERC-XXXX spec requires these to match.`,
+          `Error: manifest.creatorAddress (${manifest.creatorAddress}) does not match your wallet (${address}). The ERC-Draft spec requires these to match.`,
         ),
       )
       process.exit(1)
diff --git a/src/cli/index.ts b/src/cli/index.ts
@@ -18,7 +18,7 @@ declare const __VERSION__: string
 
 export const program = new Command()
   .name("tool-sdk")
-  .description("SDK and CLI for building ERC-XXXX compliant AI agent tools")
+  .description("SDK and CLI for building ERC-Draft compliant AI agent tools")
   .version(__VERSION__)
 
 program.addCommand(authCommand)
diff --git a/src/lib/manifest/schema.ts b/src/lib/manifest/schema.ts
@@ -196,7 +196,7 @@ export const ToolManifestSchema = z.object({
   type: z
     .string()
     .default(
-      "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+      "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
     ),
   name: z.string().min(1).max(128),
   description: z.string().min(1).max(500),
diff --git a/src/templates/cloudflare/src/manifest.ts b/src/templates/cloudflare/src/manifest.ts
@@ -4,7 +4,7 @@ import { defineManifest } from "@opensea/tool-sdk"
 // request time instead of at module-init time:
 //   endpoint: env => env.TOOL_ENDPOINT!,
 export const manifest = defineManifest({
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "{{TOOL_NAME}}",
   description: "{{TOOL_DESCRIPTION}}",
   endpoint: "{{TOOL_ENDPOINT}}",
diff --git a/src/templates/express/src/manifest.ts b/src/templates/express/src/manifest.ts
@@ -5,7 +5,7 @@ import { defineManifest } from "@opensea/tool-sdk"
 //   endpoint: env => env.TOOL_ENDPOINT!,
 //   creatorAddress: env => env.CREATOR_ADDRESS!,
 export const manifest = defineManifest({
-  type: "https://eips.ethereum.org/EIPS/eip-XXXX#tool-manifest-v1",
+  type: "https://eips.ethereum.org/EIPS/eip-draft#tool-manifest-v1",
   name: "{{TOOL_NAME}}",
   description: "{{TOOL_DESCRIPTION}}",
   endpoint: "{{TOOL_ENDPOINT}}",
diff --git a/src/templates/vercel/README.md b/src/templates/vercel/README.md
@@ -1,6 +1,6 @@
 # {{TOOL_NAME}}
 
-An ERC-XXXX compliant AI agent tool deployed on Vercel.
+An ERC-Draft compliant AI agent tool deployed on Vercel.
 
 ## Setup
 
diff --git a/src/templates/vercel/public/index.html b/src/templates/vercel/public/index.html
@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>{{TOOL_NAME}} — an ERC-XXXX AI Tool</title>
+    <title>{{TOOL_NAME}} — an ERC-Draft AI Tool</title>
     <style>
       body {
         font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
@@ -44,7 +44,7 @@ <h1>{{TOOL_NAME}}</h1>
     <p class="tagline">{{TOOL_DESCRIPTION}}</p>
 
     <h2>Manifest</h2>
-    <p>The ERC-XXXX tool manifest lives at:</p>
+    <p>The ERC-Draft tool manifest lives at:</p>
     <pre>GET /.well-known/ai-tool/{{TOOL_SLUG}}.json</pre>
 
     <h2>Endpoint</h2>
diff --git a/src/templates/vercel/public/llms.txt b/src/templates/vercel/public/llms.txt
diff --git a/src/templates/vercel/src/manifest.ts b/src/templates/vercel/src/manifest.ts
diff --git a/src/testing/index.ts b/src/testing/index.ts
