From 408121f61f7f8fe56934c5f8856af0c4581519a5 Mon Sep 17 00:00:00 2001
From: planadecu <planadecu@gmail.com>
Date: Wed, 15 Jul 2026 21:42:35 +0200
Subject: [PATCH] chore(examples): prefix example files with ex.*; update
 README references

Renames the free-API example scripts to the ex.* convention (matching
ex.x402.active-addresses.ts) and updates the run commands / references in
README.md and examples/README.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011Cf2DgwfRTWWuKtEhUeuZq
---
 README.md                                              |  2 +-
 examples/README.md                                     | 10 +++++-----
 examples/{bulk.market-cap.ts => ex.bulk.market-cap.ts} |  0
 ...etadata.validation.ts => ex.metadata.validation.ts} |  0
 examples/{metric.dump.ts => ex.metric.dump.ts}         |  0
 5 files changed, 6 insertions(+), 6 deletions(-)
 rename examples/{bulk.market-cap.ts => ex.bulk.market-cap.ts} (100%)
 rename examples/{metadata.validation.ts => ex.metadata.validation.ts} (100%)
 rename examples/{metric.dump.ts => ex.metric.dump.ts} (100%)

diff --git a/README.md b/README.md
index 2783125..ab4ff1f 100644
--- a/README.md
+++ b/README.md
@@ -240,7 +240,7 @@ See the [examples directory](./examples/README.md) for detailed usage patterns.
 ```bash
 cd examples
 cp .env.example .env  # add your API key
-pnpm dlx ts-node metadata.validation.ts
+pnpm dlx ts-node ex.metadata.validation.ts
 ```
 
 ## Development
diff --git a/examples/README.md b/examples/README.md
index 4cefd22..7e93da0 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -18,7 +18,7 @@ Before running the examples:
 
 ## Available Examples
 
-### Metadata Validation (`metadata.validation.ts`)
+### Metadata Validation (`ex.metadata.validation.ts`)
 
 Demonstrates how to:
 
@@ -30,10 +30,10 @@ Demonstrates how to:
 Run with:
 
 ```bash
-npx ts-node metadata.validation.ts
+npx ts-node ex.metadata.validation.ts
 ```
 
-### Metric Dumping (`metric.dump.ts`)
+### Metric Dumping (`ex.metric.dump.ts`)
 
 Shows how to:
 
@@ -45,7 +45,7 @@ Shows how to:
 Run with:
 
 ```bash
-npx ts-node metric.dump.ts
+npx ts-node ex.metric.dump.ts
 ```
 
 ### x402 Paid Calls — Active Addresses (`ex.x402.active-addresses.ts`)
@@ -84,7 +84,7 @@ The examples use:
 
 - `dotenv` - For loading environment variables
 - `ts-node` - For running TypeScript files directly
-- `zod` - For schema validation (used in metadata.validation.ts)
+- `zod` - For schema validation (used in ex.metadata.validation.ts)
 - `@x402/fetch`, `@x402/evm`, `viem` - For the x402 paid-API example (payment signing on Base)
 
 ## Adding New Examples
diff --git a/examples/bulk.market-cap.ts b/examples/ex.bulk.market-cap.ts
similarity index 100%
rename from examples/bulk.market-cap.ts
rename to examples/ex.bulk.market-cap.ts
diff --git a/examples/metadata.validation.ts b/examples/ex.metadata.validation.ts
similarity index 100%
rename from examples/metadata.validation.ts
rename to examples/ex.metadata.validation.ts
diff --git a/examples/metric.dump.ts b/examples/ex.metric.dump.ts
similarity index 100%
rename from examples/metric.dump.ts
rename to examples/ex.metric.dump.ts