From 69b847145607b17e523453566d8b83334c0bbf6f Mon Sep 17 00:00:00 2001
From: Ben Troutner <ben.troutner.ai@gmail.com>
Date: Mon, 23 Mar 2026 12:04:26 -0700
Subject: [PATCH] Add code examples link to AI discovery files

- Add psf-js-examples repository link to llms.txt
- Add externalDocs reference to openapi.json
- Make code examples prominent for AI agents and developers

The psf-js-examples repo contains working JavaScript code for:
- Querying balances and UTXOs
- Broadcasting transactions
- Working with SLP tokens
- Handling x402 payments
---
 public/llms.txt     | 12 ++++++++++++
 public/openapi.json |  4 ++++
 2 files changed, 16 insertions(+)

diff --git a/public/llms.txt b/public/llms.txt
index 0d4c3d3..09288c5 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -68,7 +68,19 @@ For more information on x402:
 
 Full API specification available at: `/openapi.json`
 
+## Code Examples
+
+Complete working examples for interacting with this API:
+- **JavaScript Examples:** https://github.com/Permissionless-Software-Foundation/psf-js-examples
+
+Includes examples for:
+- Querying balances and UTXOs
+- Broadcasting transactions
+- Working with SLP tokens
+- Handling x402 payments
+
 ## Support
 
 - GitHub: https://github.com/Permissionless-Software-Foundation/psf-bch-api
 - FullStack.cash: https://fullstack.cash
+- Code Examples: https://github.com/Permissionless-Software-Foundation/psf-js-examples
diff --git a/public/openapi.json b/public/openapi.json
index fb7fa14..7f1161f 100644
--- a/public/openapi.json
+++ b/public/openapi.json
@@ -7,6 +7,10 @@
     "contact": {
       "name": "FullStack.cash",
       "url": "https://fullstack.cash"
+    },
+    "externalDocs": {
+      "description": "JavaScript Code Examples",
+      "url": "https://github.com/Permissionless-Software-Foundation/psf-js-examples"
     }
   },
   "servers": [