dubs-server 1.0.0

package/postman/Dubs_Developer_API.postman_collection.json

@@ -0,0 +1,662 @@
+{
+  "info": {
+    "name": "Dubs Developer API",
+    "description": "Dubs Developer API — third-party integration for sports & esports betting on Solana.\n\nTwo sections:\n1. **Portal** (`/api/developer`) — JWT auth, developer account/app/key management\n2. **Public API** (`/api/developer/v1`) — API key auth (`X-API-Key` header), game lifecycle & event data",
+    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+  },
+  "variable": [
+    {
+      "key": "baseUrl",
+      "value": "http://localhost:3001",
+      "type": "string"
+    },
+    {
+      "key": "apiKey",
+      "value": "dubs_test_REPLACE_ME",
+      "type": "string"
+    },
+    {
+      "key": "jwtToken",
+      "value": "REPLACE_ME",
+      "type": "string"
+    },
+    {
+      "key": "appId",
+      "value": "1",
+      "type": "string"
+    },
+    {
+      "key": "webhookId",
+      "value": "1",
+      "type": "string"
+    },
+    {
+      "key": "keyId",
+      "value": "1",
+      "type": "string"
+    },
+    {
+      "key": "gameId",
+      "value": "REPLACE_ME",
+      "type": "string"
+    },
+    {
+      "key": "playerWallet",
+      "value": "REPLACE_ME",
+      "type": "string"
+    }
+  ],
+  "item": [
+    {
+      "name": "Portal (JWT Auth)",
+      "description": "Developer portal management routes. Requires JWT auth via `Authorization: Bearer <token>`. Mounted at `/api/developer`.",
+      "item": [
+        {
+          "name": "Account",
+          "item": [
+            {
+              "name": "Create / Get Account",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"displayName\": \"My Studio\",\n  \"email\": \"dev@example.com\",\n  \"commissionWallet\": \"{{playerWallet}}\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/account",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "account"]
+                },
+                "description": "Create or retrieve developer account (upsert on wallet address). Called on first portal login."
+              }
+            },
+            {
+              "name": "Get Account",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/account",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "account"]
+                },
+                "description": "Get current developer account details."
+              }
+            },
+            {
+              "name": "Update Account",
+              "request": {
+                "method": "PATCH",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"displayName\": \"Updated Name\",\n  \"email\": \"new@example.com\",\n  \"commissionWallet\": null\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/account",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "account"]
+                },
+                "description": "Update developer account fields. All fields optional (COALESCE — null preserves existing)."
+              }
+            }
+          ]
+        },
+        {
+          "name": "Apps",
+          "item": [
+            {
+              "name": "Create App",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"appName\": \"My Betting App\",\n  \"description\": \"A sports betting app powered by Dubs\",\n  \"websiteUrl\": \"https://myapp.com\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps"]
+                },
+                "description": "Create a new developer app. Returns the app record with its ID."
+              }
+            },
+            {
+              "name": "List Apps",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps"]
+                },
+                "description": "List all apps for the current developer (excludes soft-deleted)."
+              }
+            },
+            {
+              "name": "Get App",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps/{{appId}}",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps", "{{appId}}"]
+                },
+                "description": "Get a single app with its API keys (hints only, never full keys)."
+              }
+            },
+            {
+              "name": "Update App",
+              "request": {
+                "method": "PATCH",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"appName\": \"Updated App Name\",\n  \"description\": \"Updated description\",\n  \"websiteUrl\": \"https://newsite.com\",\n  \"networkMode\": \"open\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps/{{appId}}",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps", "{{appId}}"]
+                },
+                "description": "Update app details. `networkMode` can be `\"open\"` or `\"private\"`. All fields optional."
+              }
+            },
+            {
+              "name": "Delete App",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps/{{appId}}",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps", "{{appId}}"]
+                },
+                "description": "Soft-delete an app. Deactivates all API keys and sets status to 'deleted'."
+              }
+            }
+          ]
+        },
+        {
+          "name": "API Keys",
+          "item": [
+            {
+              "name": "Generate API Key",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"environment\": \"sandbox\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps/{{appId}}/keys",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps", "{{appId}}", "keys"]
+                },
+                "description": "Generate a new API key. Returns the full key **once** — save it immediately.\n\n`environment`: `\"sandbox\"` (prefix `dubs_test_`) or `\"production\"` (prefix `dubs_live_`)."
+              }
+            },
+            {
+              "name": "Revoke API Key",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/keys/{{keyId}}",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "keys", "{{keyId}}"]
+                },
+                "description": "Revoke (deactivate) an API key."
+              }
+            }
+          ]
+        },
+        {
+          "name": "Analytics",
+          "item": [
+            {
+              "name": "Get Developer Stats",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/stats",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "stats"]
+                },
+                "description": "Get aggregate developer stats: total games, total API calls, total apps."
+              }
+            },
+            {
+              "name": "Get App Usage",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps/{{appId}}/usage",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps", "{{appId}}", "usage"]
+                },
+                "description": "Get API usage stats for an app (last 30 days). Daily call counts with avg response time."
+              }
+            }
+          ]
+        },
+        {
+          "name": "Webhooks",
+          "item": [
+            {
+              "name": "Create Webhook",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"url\": \"https://myapp.com/webhooks/dubs\",\n  \"events\": [\"game.created\", \"game.joined\"],\n  \"description\": \"Main production webhook\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps/{{appId}}/webhooks",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps", "{{appId}}", "webhooks"]
+                },
+                "description": "Register a new webhook. Returns signing secret **once** — save it.\n\nAllowed events: `game.created`, `game.joined`.\n\nURL must be HTTPS (localhost allowed for dev)."
+              }
+            },
+            {
+              "name": "List Webhooks",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/apps/{{appId}}/webhooks",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "apps", "{{appId}}", "webhooks"]
+                },
+                "description": "List all webhooks for an app. Secret shown as hint only (`••••xxxx`)."
+              }
+            },
+            {
+              "name": "Update Webhook",
+              "request": {
+                "method": "PATCH",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"url\": \"https://myapp.com/webhooks/dubs-v2\",\n  \"events\": [\"game.created\"],\n  \"isActive\": true,\n  \"description\": \"Updated webhook\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/webhooks/{{webhookId}}",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "webhooks", "{{webhookId}}"]
+                },
+                "description": "Update webhook URL, events, active status, or description."
+              }
+            },
+            {
+              "name": "Delete Webhook",
+              "request": {
+                "method": "DELETE",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/webhooks/{{webhookId}}",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "webhooks", "{{webhookId}}"]
+                },
+                "description": "Delete a webhook and all its delivery logs."
+              }
+            },
+            {
+              "name": "Get Webhook Logs",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "Authorization", "value": "Bearer {{jwtToken}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/webhooks/{{webhookId}}/logs",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "webhooks", "{{webhookId}}", "logs"]
+                },
+                "description": "Recent delivery logs for a webhook (last 50). Shows status code, attempts, success/error."
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Public API (API Key Auth)",
+      "description": "Third-party developer API. Requires `X-API-Key` header. Mounted at `/api/developer/v1`.",
+      "item": [
+        {
+          "name": "Events",
+          "description": "Browse upcoming bettable events from sports and esports.",
+          "item": [
+            {
+              "name": "Get Upcoming Events (Unified)",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/events/upcoming?type=sports&page=1&per_page=20",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "events", "upcoming"],
+                  "query": [
+                    { "key": "type", "value": "sports", "description": "\"sports\" or \"esports\". Omit for both." },
+                    { "key": "game", "value": "", "description": "Filter: nba, nhl, mlb, nfl, epl, ufc, ncaab, ncaaf, cs-go, valorant", "disabled": true },
+                    { "key": "page", "value": "1", "description": "Page number (default: 1)" },
+                    { "key": "per_page", "value": "20", "description": "Items per page (default: 20, max: 100)" }
+                  ]
+                },
+                "description": "Unified paginated endpoint for ALL upcoming bettable events (sports + esports).\n\nReturns `UnifiedEvent[]` with consistent shape across both types.\n\nFilters: `type` (sports/esports), `game` (specific league/videogame)."
+              }
+            },
+            {
+              "name": "Get Sports Events by League",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/sports/events/NBA",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "sports", "events", "NBA"]
+                },
+                "description": "Upcoming sports events for a single league.\n\nValid leagues: `NBA`, `NHL`, `MLB`, `NFL`, `EPL`, `UFC`, `NCAAF`, `NCAAB`."
+              }
+            },
+            {
+              "name": "Get Esports Matches",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/esports/matches/upcoming?videogame=cs-go",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "esports", "matches", "upcoming"],
+                  "query": [
+                    { "key": "videogame", "value": "cs-go", "description": "Filter: cs-go, valorant. Omit for all." }
+                  ]
+                },
+                "description": "Upcoming esports matches (normalized UnifiedEvent shape).\n\nOptional `videogame` filter: `cs-go`, `valorant`."
+              }
+            },
+            {
+              "name": "Get Esports Match Detail",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/esports/matches/1353988",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "esports", "matches", "1353988"]
+                },
+                "description": "Detailed esports match info (EsportsMatchDetail shape — richer than unified).\n\nIncludes opponents, results, winnerId, serie, tournament, tier."
+              }
+            }
+          ]
+        },
+        {
+          "name": "Game Lifecycle",
+          "description": "Create, join, confirm, and claim bets.",
+          "item": [
+            {
+              "name": "Validate Event",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"id\": \"sports:NBA:espn-nba-401584793\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/games/validate",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "games", "validate"]
+                },
+                "description": "Check if an event is bettable. Lightweight yes/no.\n\nID format:\n- Sports: `sports:LEAGUE:EVENT_ID` (e.g. `sports:UFC:espn-ufc-600057329`)\n- Esports: `esports:MATCH_ID` (e.g. `esports:1353988`)\n\nReturns: `bettable`, `gameMode`, `lockTimestamp`, `startTime`, `status`."
+              }
+            },
+            {
+              "name": "Create Game",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"id\": \"sports:NBA:espn-nba-401584793\",\n  \"playerWallet\": \"{{playerWallet}}\",\n  \"teamChoice\": \"home\",\n  \"wagerAmount\": 0.1\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/games/create",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "games", "create"]
+                },
+                "description": "Resolve event, validate, and build an unsigned create+join transaction.\n\nThe `transaction` field is a base64-encoded unsigned Solana Transaction. Have the user sign it with their wallet, then send the signature to `/games/confirm`.\n\n`teamChoice`: `home`, `away`, or `draw`.\n`wagerAmount`: SOL amount."
+              }
+            },
+            {
+              "name": "Join Game",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"playerWallet\": \"{{playerWallet}}\",\n  \"gameId\": \"{{gameId}}\",\n  \"teamChoice\": \"away\",\n  \"amount\": 0.1\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/games/join",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "games", "join"]
+                },
+                "description": "Build an unsigned join transaction for an existing game.\n\nIncludes network mode visibility check — private apps can only join their own games.\n\nSign the returned `transaction` and confirm via `/games/confirm`."
+              }
+            },
+            {
+              "name": "Confirm Game",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"gameId\": \"{{gameId}}\",\n  \"playerWallet\": \"{{playerWallet}}\",\n  \"signature\": \"SOLANA_TX_SIGNATURE\",\n  \"teamChoice\": \"home\",\n  \"wagerAmount\": 0.1,\n  \"role\": \"creator\",\n  \"gameAddress\": \"GAME_PDA_ADDRESS\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/games/confirm",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "games", "confirm"]
+                },
+                "description": "Confirm a signed transaction and persist the game to DB.\n\n`role`: `\"creator\"` (after /create) or `\"joiner\"` (after /join).\n\nFor creators, retrieves stashed event data server-side (from /create step). Stash expires after 10 minutes.\n\nCreates developer attribution record. Fires webhooks (`game.created` or `game.joined`)."
+              }
+            },
+            {
+              "name": "Build Claim Transaction",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"playerWallet\": \"{{playerWallet}}\",\n  \"gameId\": \"{{gameId}}\"\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/transactions/build/claim",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "transactions", "build", "claim"]
+                },
+                "description": "Build an unsigned claim transaction for a resolved game.\n\nHave the user sign the returned `transaction` to claim their winnings."
+              }
+            }
+          ]
+        },
+        {
+          "name": "Games",
+          "description": "Query existing games.",
+          "item": [
+            {
+              "name": "Get Game Detail",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/games/{{gameId}}",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "games", "{{gameId}}"]
+                },
+                "description": "Get full game detail: players, pools, status, sportsEvent, media."
+              }
+            },
+            {
+              "name": "List Games",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/games?status=open&limit=20&offset=0",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "games"],
+                  "query": [
+                    { "key": "wallet", "value": "", "description": "Filter by player wallet address", "disabled": true },
+                    { "key": "status", "value": "open", "description": "open | locked | resolved" },
+                    { "key": "limit", "value": "20", "description": "Max results (default: 20)" },
+                    { "key": "offset", "value": "0", "description": "Pagination offset (default: 0)" }
+                  ]
+                },
+                "description": "List games visible to your app.\n\n- **Private apps**: Only see games created through your app.\n- **Open apps**: See games from other open apps + unattributed (main Dubs) + own games.\n\n`status=open` excludes games past their lock time."
+              }
+            },
+            {
+              "name": "List Network Games",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/network/games?limit=20&offset=0",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "network", "games"],
+                  "query": [
+                    { "key": "league", "value": "", "description": "Filter: NBA, NHL, MLB, NFL, EPL, UFC, NCAAB, NCAAF", "disabled": true },
+                    { "key": "limit", "value": "20", "description": "Max results (default: 20)" },
+                    { "key": "offset", "value": "0", "description": "Pagination offset (default: 0)" }
+                  ]
+                },
+                "description": "Fetch joinable open games from the Dubs network.\n\n**Requires open network mode** — returns 403 for private apps.\n\nFilters: sports games only (game_mode=4), pending, not locked, not resolved, lock time in future.\n\nOptional `league` filter maps abbreviations to DB values (e.g. EPL → English Premier League).\n\nIncludes pagination with total count."
+              }
+            }
+          ]
+        },
+        {
+          "name": "Errors",
+          "description": "Solana program error parsing utilities.",
+          "item": [
+            {
+              "name": "Parse Solana Error",
+              "request": {
+                "method": "POST",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" },
+                  { "key": "Content-Type", "value": "application/json" }
+                ],
+                "body": {
+                  "mode": "raw",
+                  "raw": "{\n  \"error\": {\n    \"InstructionError\": [0, { \"Custom\": 6004 }]\n  }\n}"
+                },
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/errors/parse",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "errors", "parse"]
+                },
+                "description": "Decode a raw Solana transaction error into a human-readable `{ code, message }`.\n\nHandles custom program errors (6000-6049), built-in instruction errors, and string errors."
+              }
+            },
+            {
+              "name": "Get Error Codes",
+              "request": {
+                "method": "GET",
+                "header": [
+                  { "key": "X-API-Key", "value": "{{apiKey}}" }
+                ],
+                "url": {
+                  "raw": "{{baseUrl}}/api/developer/v1/errors/codes",
+                  "host": ["{{baseUrl}}"],
+                  "path": ["api", "developer", "v1", "errors", "codes"]
+                },
+                "description": "Return the full map of Solana program error codes (6000-6049) for client-side use.\n\nUseful for building local error parsers without API calls."
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}