dubs-server 1.0.0

package/postman/Dubs-API-v1.postman_collection.json

@@ -0,0 +1,205 @@
+{
+	"info": {
+		"name": "Dubs API v1",
+		"description": "Production-ready wager game API with clean test/prod separation",
+		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
+		"version": "1.0.0"
+	},
+	"variable": [
+		{
+			"key": "baseUrl",
+			"value": "http://localhost:3001",
+			"type": "string"
+		},
+		{
+			"key": "gameId",
+			"value": "",
+			"type": "string"
+		}
+	],
+	"item": [
+		{
+			"name": "Health",
+			"request": {
+				"method": "GET",
+				"header": [],
+				"url": "{{baseUrl}}/health"
+			}
+		},
+		{
+			"name": "Production API",
+			"item": [
+				{
+					"name": "Get Game Info",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": "{{baseUrl}}/api/v1/prod/game/{{gameId}}",
+						"description": "View any game by UUID"
+					}
+				},
+				{
+					"name": "Build Create Game Transaction",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"creatorAddress\": \"YOUR_PHANTOM_WALLET_ADDRESS\",\n  \"buyIn\": 0.5,\n  \"maxPlayers\": 4,\n  \"operatorFee\": 10,\n  \"operatorAddress\": \"OPERATOR_WALLET_ADDRESS_OR_LEAVE_BLANK\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/prod/transaction/build/create",
+						"description": "Returns unsigned transaction. Sign with your wallet."
+					}
+				},
+				{
+					"name": "Build Join Game Transaction",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"playerAddress\": \"YOUR_PHANTOM_WALLET_ADDRESS\",\n  \"gameId\": \"{{gameId}}\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/prod/transaction/build/join"
+					}
+				},
+				{
+					"name": "Build Distribute Transaction",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"creatorAddress\": \"CREATOR_WALLET_ADDRESS\",\n  \"gameId\": \"{{gameId}}\",\n  \"winners\": [\"WINNER1_ADDRESS\", \"WINNER2_ADDRESS\"]\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/prod/transaction/build/distribute"
+					}
+				},
+				{
+					"name": "Submit Signed Transaction",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"signedTransaction\": \"BASE64_ENCODED_SIGNED_TRANSACTION\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/prod/transaction/submit",
+						"description": "Submit transaction after signing with wallet"
+					}
+				}
+			],
+			"description": "For real users with Phantom/Solflare wallets"
+		},
+		{
+			"name": "Demo/Test API",
+			"item": [
+				{
+					"name": "List Demo Wallets",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": "{{baseUrl}}/api/v1/demo/wallets",
+						"description": "See all test wallets and balances"
+					}
+				},
+				{
+					"name": "Create Game (Auto UUID)",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"player\": \"creator\",\n  \"buyIn\": 0.5,\n  \"maxPlayers\": 4,\n  \"operatorFee\": 10,\n  \"operatorPlayer\": \"jelli\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/game/create",
+						"description": "Server signs. Save gameId from response!"
+					},
+					"event": [
+						{
+							"listen": "test",
+							"script": {
+								"exec": [
+									"const response = pm.response.json();",
+									"if (response.gameId) {",
+									"    pm.collectionVariables.set('gameId', response.gameId);",
+									"    console.log('Game ID saved:', response.gameId);",
+									"}"
+								],
+								"type": "text/javascript"
+							}
+						}
+					]
+				},
+				{
+					"name": "Get Game Info",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": "{{baseUrl}}/api/v1/demo/game/{{gameId}}",
+						"description": "View game created in previous step"
+					}
+				},
+				{
+					"name": "Alice Joins",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"player\": \"alice\",\n  \"gameId\": \"{{gameId}}\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/game/join"
+					}
+				},
+				{
+					"name": "Bob Joins",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"player\": \"bob\",\n  \"gameId\": \"{{gameId}}\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/game/join"
+					}
+				},
+				{
+					"name": "Distribute Winnings",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"gameId\": \"{{gameId}}\",\n  \"winners\": [\"PASTE_ALICE_ADDRESS\", \"PASTE_BOB_ADDRESS\"]\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/game/distribute",
+						"description": "Get addresses from 'Get Game Info' response. Paste here."
+					}
+				},
+				{
+					"name": "Check Balances (Jelli Got Paid!)",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": "{{baseUrl}}/api/v1/demo/wallets"
+					}
+				},
+				{
+					"name": "Airdrop to Player",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"player\": \"charlie\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/airdrop"
+					}
+				}
+			],
+			"description": "For testing with server-managed wallets"
+		}
+	]
+}
+