chore: move x402 examples to examples folder

Signed-off-by: Tomás Migone <tomas@edgeandnode.com>

Author: tmigone

…02/examples/typed-sdk/.graphclientrc.yml examples/client-x402/.graphclientrc.ymlpackages/x402/examples/typed-sdk/.graphclientrc.yml renamed to examples/client-x402/.graphclientrc.yml packages/x402/examples/typed-sdk/.graphclientrc.yml renamed to examples/client-x402/.graphclientrc.yml

@@ -1,4 +1,4 @@
-# Examples
+# x402 Examples
 
 ## Mode 1: CLI
 
@@ -7,7 +7,7 @@ See [`cli.sh`](./cli.sh) - query directly from the terminal.
 ```bash
 export X402_PRIVATE_KEY=0x...
 export X402_CHAIN=base-sepolia
-./cli.sh
+./cli.sh http://localhost:7700/api/x402/deployments/id/Qm... '{ indexers { id } }'
 ```
 
 ## Mode 2: Programmatic
@@ -17,18 +17,16 @@ See [`programmatic.ts`](./programmatic.ts) - use in scripts without a build step
 ```bash
 export X402_PRIVATE_KEY=0x...
 export X402_CHAIN=base-sepolia
-npx tsx programmatic.ts
+npx tsx programmatic.ts http://localhost:7700/api/x402/deployments/id/Qm... '{ indexers { id } }'
 ```
 
 ## Mode 3: Typed SDK
 
-See [`typed-sdk/`](./typed-sdk/) - full type safety with generated SDK.
+See [`index.ts`](./index.ts) + [`.graphclientrc.yml`](./.graphclientrc.yml) - full type safety with generated SDK.
 
 ```bash
-cd typed-sdk
 export X402_PRIVATE_KEY=0x...
 export X402_CHAIN=base-sepolia
 npx graphclient build
-rm .graphclient/package.json  # Required: mesh generates broken ESM exports
 npx tsx index.ts
 ```

packages/x402/examples/README.md examples/client-x402/README.mdpackages/x402/examples/README.md renamed to examples/client-x402/README.md

@@ -0,0 +1,34 @@
+#!/bin/bash
+# Example: Query a paid subgraph endpoint using the CLI
+#
+# Prerequisites:
+#   npm install -g @graphprotocol/client-x402
+#
+# Usage:
+#   export X402_PRIVATE_KEY=0x...
+#   export X402_CHAIN=base-sepolia
+#   ./cli.sh <endpoint> '<query>'
+#
+# Example:
+#   ./cli.sh http://localhost:7700/api/x402/deployments/id/Qm... '{ indexers { id } }'
+
+set -e
+
+if [ -z "$X402_PRIVATE_KEY" ]; then
+  echo "Error: X402_PRIVATE_KEY is required"
+  exit 1
+fi
+
+if [ -z "$X402_CHAIN" ]; then
+  echo "Error: X402_CHAIN is required (base or base-sepolia)"
+  exit 1
+fi
+
+if [ -z "$1" ] || [ -z "$2" ]; then
+  echo "Usage: ./cli.sh <endpoint> '<query>'"
+  exit 1
+fi
+
+graphclient-x402 "$2" \
+  --endpoint "$1" \
+  --chain "$X402_CHAIN"

examples/client-x402/cli.sh

@@ -10,7 +10,6 @@
  *   export X402_PRIVATE_KEY=0x...
  *   export X402_CHAIN=base-sepolia
  *   npx graphclient build
- *   rm .graphclient/package.json  # Required: mesh generates broken ESM exports
  *
  * Then run this file:
  *   npx tsx index.ts

packages/x402/examples/typed-sdk/index.ts examples/client-x402/index.tspackages/x402/examples/typed-sdk/index.ts renamed to examples/client-x402/index.ts

@@ -0,0 +1,15 @@
+{
+  "name": "client-x402-examples",
+  "version": "1.0.0",
+  "description": "See [`cli.sh`](./cli.sh) - query directly from the terminal.",
+  "license": "MIT",
+  "author": "Tomás Migone <tomas@edgeandnode.com>",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "@graphprotocol/client-x402": "^1.0.0"
+  }
+}

examples/client-x402/package.json

@@ -0,0 +1,44 @@
+/**
+ * Example: Programmatic usage with createGraphQuery
+ *
+ * For scripts, bots, or simple integrations. No build step, no types.
+ *
+ * Prerequisites:
+ *   npm install @graphprotocol/client-x402
+ *
+ * Usage:
+ *   export X402_PRIVATE_KEY=0x...
+ *   export X402_CHAIN=base-sepolia
+ *   npx tsx programmatic.ts <endpoint> '<query>'
+ *
+ * Example:
+ *   npx tsx programmatic.ts http://localhost:7700/api/x402/deployments/id/Qm... '{ indexers { id } }'
+ */
+
+import { createGraphQuery } from '@graphprotocol/client-x402'
+
+const endpoint = process.argv[2]
+const queryString = process.argv[3]
+
+if (!process.env.X402_PRIVATE_KEY) {
+  console.error('Error: X402_PRIVATE_KEY is required')
+  process.exit(1)
+}
+
+if (!process.env.X402_CHAIN) {
+  console.error('Error: X402_CHAIN is required (base or base-sepolia)')
+  process.exit(1)
+}
+
+if (!endpoint || !queryString) {
+  console.error("Usage: npx tsx programmatic.ts <endpoint> '<query>'")
+  process.exit(1)
+}
+
+const query = createGraphQuery({
+  endpoint,
+  chain: process.env.X402_CHAIN as 'base' | 'base-sepolia',
+})
+
+const result = await query(queryString)
+console.log(JSON.stringify(result.data, null, 2))