dubs-server 1.0.0

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "dubs-server",
+  "version": "1.0.0",
+  "description": "Dubs wager game API server",
+  "main": "server.js",
+  "engines": {
+    "node": "20.x",
+    "npm": "10.x"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "nodemon server.js",
+    "cli": "node dubs-cli.js",
+    "test:voting": "node dubs-cli.js",
+    "oracle:start": "node cron/oracleMonitor.js",
+    "oracle:dev": "nodemon cron/oracleMonitor.js",
+    "oracle:setup": "bash setup-oracle.sh",
+    "arcade:test": "bash test-arcade-match.sh",
+    "arcade:test:devnet": "bash test-arcade-devnet.sh"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.936.0",
+    "@aws-sdk/s3-request-presigner": "^3.936.0",
+    "@dubsdotapp/node": "^0.2.2",
+    "@solana/web3.js": "^1.95.8",
+    "axios": "^1.6.0",
+    "bs58": "^6.0.0",
+    "canvas": "^3.2.0",
+    "cookie": "^0.6.0",
+    "cookie-parser": "^1.4.6",
+    "cors": "^2.8.5",
+    "dotenv": "^16.3.1",
+    "expo-server-sdk": "^6.0.0",
+    "express": "^4.18.2",
+    "ioredis": "^5.4.1",
+    "jsonwebtoken": "^9.0.2",
+    "multer": "^2.0.2",
+    "pg": "^8.16.3",
+    "sharp": "^0.33.5",
+    "socket.io": "^4.8.1",
+    "thesportsdb": "^0.0.2",
+    "tweetnacl": "^1.0.3",
+    "uuid": "^10.0.0",
+    "web-push": "^3.6.7"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.1"
+  }
+}

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

@@ -0,0 +1,555 @@
+{
+	"info": {
+		"name": "Dubs API v1 - Democratic Voting Edition",
+		"description": "Complete Dubs wager game API with democratic voting, majority rules, and trustless distribution. Includes all production and demo endpoints.",
+		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
+		"version": "1.1.0"
+	},
+	"variable": [
+		{
+			"key": "baseUrl",
+			"value": "https://dubs-server-dev-55d1fba09a97.herokuapp.com",
+			"type": "string"
+		},
+		{
+			"key": "gameId",
+			"value": "",
+			"type": "string"
+		},
+		{
+			"key": "walletAddress",
+			"value": "YOUR_WALLET_ADDRESS_HERE",
+			"type": "string"
+		}
+	],
+	"item": [
+		{
+			"name": "Health Check",
+			"request": {
+				"method": "GET",
+				"header": [],
+				"url": "{{baseUrl}}/health",
+				"description": "Check if server is running"
+			}
+		},
+		{
+			"name": "Production API (Real Wallets)",
+			"item": [
+				{
+					"name": "1. Game Management",
+					"item": [
+						{
+							"name": "Get Game Info",
+							"request": {
+								"method": "GET",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/game/{{gameId}}",
+								"description": "Fetch game details from blockchain including players, pot, votes, and voting status"
+							}
+						}
+					]
+				},
+				{
+					"name": "2. Game Creation",
+					"item": [
+						{
+							"name": "Build Create Game Transaction",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"buyIn\": 0.5,\n  \"maxPlayers\": 4,\n  \"operatorFee\": 10,\n  \"operatorAddress\": \"OPTIONAL_OPERATOR_ADDRESS\",\n  \"votingEnabled\": true\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/create",
+								"description": "Build unsigned transaction for creating a game. NEW: votingEnabled parameter for democratic voting!"
+							},
+							"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);",
+											"    console.log('📋 Game Address:', response.gameAddress);",
+											"}"
+										],
+										"type": "text/javascript"
+									}
+								}
+							]
+						},
+						{
+							"name": "Build Create Game (Voting Disabled)",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"buyIn\": 1.0,\n  \"maxPlayers\": 2,\n  \"operatorFee\": 5,\n  \"votingEnabled\": false\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/create",
+								"description": "Create game without voting (creator chooses winners manually)"
+							}
+						}
+					]
+				},
+				{
+					"name": "3. Join Game",
+					"item": [
+						{
+							"name": "Build Join Game Transaction",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"playerAddress\": \"{{walletAddress}}\",\n  \"gameId\": \"{{gameId}}\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/join",
+								"description": "Build unsigned transaction for joining a game"
+							}
+						}
+					]
+				},
+				{
+					"name": "4. Democratic Voting (NEW!)",
+					"item": [
+						{
+							"name": "Build Cast Vote Transaction",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"voterAddress\": \"{{walletAddress}}\",\n  \"gameId\": \"{{gameId}}\",\n  \"votedFor\": \"PLAYER_ADDRESS_TO_VOTE_FOR\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/cast-vote",
+								"description": "Build unsigned transaction for casting a vote. Each player can vote for any player in the game. Can change vote before majority is reached."
+							}
+						},
+						{
+							"name": "Build Distribute by Vote Transaction",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"gameId\": \"{{gameId}}\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/distribute-by-vote",
+								"description": "Build unsigned transaction for distributing winnings based on votes. MAJORITY RULES: Requires 50%+ of players to vote. Tallies votes automatically, handles ties by equal split."
+							}
+						}
+					]
+				},
+				{
+					"name": "5. Manual Distribution",
+					"item": [
+						{
+							"name": "Build Distribute Transaction (Manual)",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"gameId\": \"{{gameId}}\",\n  \"winners\": [\"WINNER1_ADDRESS\", \"WINNER2_ADDRESS\"]\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/distribute",
+								"description": "Manually specify winners (creator chooses). Use this for non-voting games or to override voting."
+							}
+						}
+					]
+				},
+				{
+					"name": "6. Transaction Submission",
+					"item": [
+						{
+							"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 any signed transaction to the blockchain. Returns transaction signature and confirmation."
+							}
+						}
+					]
+				}
+			],
+			"description": "🎮 Production endpoints for real wallets (Phantom, Solflare, Jelli, etc.)"
+		},
+		{
+			"name": "Demo/Test API (Server-Managed Wallets)",
+			"item": [
+				{
+					"name": "List Demo Wallets",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": "{{baseUrl}}/api/v1/demo/wallets",
+						"description": "See all test wallets and their balances"
+					}
+				},
+				{
+					"name": "Create Game (Server Signs)",
+					"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": "Create game with server-managed wallet"
+					},
+					"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 state"
+					}
+				},
+				{
+					"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": "Charlie Joins",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"player\": \"charlie\",\n  \"gameId\": \"{{gameId}}\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/game/join"
+					}
+				},
+				{
+					"name": "Distribute Winnings (Manual)",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"gameId\": \"{{gameId}}\",\n  \"winners\": [\"PASTE_WINNER_ADDRESSES_FROM_GET_GAME_INFO\"]\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/game/distribute",
+						"description": "Manually distribute to specified winners"
+					}
+				},
+				{
+					"name": "Airdrop SOL to Player",
+					"request": {
+						"method": "POST",
+						"header": [{"key": "Content-Type", "value": "application/json"}],
+						"body": {
+							"mode": "raw",
+							"raw": "{\n  \"player\": \"alice\"\n}"
+						},
+						"url": "{{baseUrl}}/api/v1/demo/airdrop",
+						"description": "Airdrop 2 SOL to a demo wallet"
+					}
+				},
+				{
+					"name": "Check Final Balances",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": "{{baseUrl}}/api/v1/demo/wallets",
+						"description": "Verify winnings were distributed correctly"
+					}
+				}
+			],
+			"description": "🧪 Demo endpoints for testing with server-managed wallets"
+		},
+		{
+			"name": "Complete Workflows",
+			"item": [
+				{
+					"name": "🎮 Standard Game Flow (No Voting)",
+					"item": [
+						{
+							"name": "1️⃣ Build Create Game",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"buyIn\": 0.5,\n  \"maxPlayers\": 4,\n  \"operatorFee\": 10,\n  \"votingEnabled\": false\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/create"
+							},
+							"event": [
+								{
+									"listen": "test",
+									"script": {
+										"exec": [
+											"const response = pm.response.json();",
+											"if (response.gameId) {",
+											"    pm.collectionVariables.set('gameId', response.gameId);",
+											"    console.log('✅ Game created:', response.gameId);",
+											"}"
+										],
+										"type": "text/javascript"
+									}
+								}
+							]
+						},
+						{
+							"name": "2️⃣ Player Joins",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"playerAddress\": \"FRIEND_WALLET_ADDRESS\",\n  \"gameId\": \"{{gameId}}\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/join"
+							}
+						},
+						{
+							"name": "3️⃣ Check Game Status",
+							"request": {
+								"method": "GET",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/game/{{gameId}}"
+							}
+						},
+						{
+							"name": "4️⃣ Distribute to Winners",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"gameId\": \"{{gameId}}\",\n  \"winners\": [\"WINNER1_ADDRESS\", \"WINNER2_ADDRESS\"]\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/distribute"
+							}
+						}
+					],
+					"description": "Traditional flow: Creator chooses winners manually"
+				},
+				{
+					"name": "🗳️ Democratic Game Flow (With Voting)",
+					"item": [
+						{
+							"name": "1️⃣ Build Create Game (Voting ON)",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"buyIn\": 0.5,\n  \"maxPlayers\": 3,\n  \"operatorFee\": 10,\n  \"votingEnabled\": true\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/create",
+								"description": "Create game with democratic voting enabled"
+							},
+							"event": [
+								{
+									"listen": "test",
+									"script": {
+										"exec": [
+											"const response = pm.response.json();",
+											"if (response.gameId) {",
+											"    pm.collectionVariables.set('gameId', response.gameId);",
+											"    console.log('✅ Game created with voting:', response.gameId);",
+											"}"
+										],
+										"type": "text/javascript"
+									}
+								}
+							]
+						},
+						{
+							"name": "2️⃣ Player 1 Joins",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"playerAddress\": \"PLAYER1_ADDRESS\",\n  \"gameId\": \"{{gameId}}\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/join"
+							}
+						},
+						{
+							"name": "3️⃣ Player 2 Joins",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"playerAddress\": \"PLAYER2_ADDRESS\",\n  \"gameId\": \"{{gameId}}\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/join"
+							}
+						},
+						{
+							"name": "4️⃣ Check Game (See Players)",
+							"request": {
+								"method": "GET",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/game/{{gameId}}",
+								"description": "Verify all players joined. Copy player addresses for voting."
+							}
+						},
+						{
+							"name": "5️⃣ Player 1 Votes",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"voterAddress\": \"PLAYER1_ADDRESS\",\n  \"gameId\": \"{{gameId}}\",\n  \"votedFor\": \"PLAYER2_ADDRESS\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/cast-vote",
+								"description": "Player 1 votes for Player 2"
+							}
+						},
+						{
+							"name": "6️⃣ Player 2 Votes",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"voterAddress\": \"PLAYER2_ADDRESS\",\n  \"gameId\": \"{{gameId}}\",\n  \"votedFor\": \"PLAYER1_ADDRESS\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/cast-vote",
+								"description": "Player 2 votes for Player 1"
+							}
+						},
+						{
+							"name": "7️⃣ Check Voting Progress",
+							"request": {
+								"method": "GET",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/game/{{gameId}}",
+								"description": "Check votes array and votingEnabled status. For 3 players, need 2 votes for majority."
+							}
+						},
+						{
+							"name": "8️⃣ Distribute by Vote (Majority Reached)",
+							"request": {
+								"method": "POST",
+								"header": [{"key": "Content-Type", "value": "application/json"}],
+								"body": {
+									"mode": "raw",
+									"raw": "{\n  \"creatorAddress\": \"{{walletAddress}}\",\n  \"gameId\": \"{{gameId}}\"\n}"
+								},
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/distribute-by-vote",
+								"description": "Distribute prize pool based on votes. Response includes winners and vote counts."
+							}
+						},
+						{
+							"name": "9️⃣ Final Game State",
+							"request": {
+								"method": "GET",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/game/{{gameId}}",
+								"description": "Verify game is closed and pot is empty"
+							}
+						}
+					],
+					"description": "🗳️ Complete democratic voting workflow from creation to distribution"
+				}
+			],
+			"description": "📋 Complete end-to-end workflows for testing"
+		},
+		{
+			"name": "Examples & Documentation",
+			"item": [
+				{
+					"name": "📖 API Overview",
+					"request": {
+						"method": "GET",
+						"header": [],
+						"url": "{{baseUrl}}/",
+						"description": "Get API information and available endpoints"
+					}
+				},
+				{
+					"name": "Example Responses",
+					"item": [
+						{
+							"name": "Game Info Response (No Voting)",
+							"request": {
+								"method": "GET",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/game/example-id",
+								"description": "Example response:\n{\n  \"exists\": true,\n  \"game\": {\n    \"gameId\": 12345,\n    \"authority\": \"CreatorAddress...\",\n    \"buyIn\": 0.5,\n    \"maxPlayers\": 4,\n    \"operatorWallet\": \"OperatorAddress...\",\n    \"operatorFeePercentage\": 10,\n    \"players\": [\"Player1...\", \"Player2...\"],\n    \"totalPot\": 1.0,\n    \"isActive\": true,\n    \"votes\": [],\n    \"votingEnabled\": false\n  },\n  \"calculated\": {\n    \"operatorFeeAmount\": \"0.1000\",\n    \"prizePool\": \"0.9000\"\n  }\n}"
+							}
+						},
+						{
+							"name": "Game Info Response (With Voting)",
+							"request": {
+								"method": "GET",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/game/example-id",
+								"description": "Example response with votes:\n{\n  \"exists\": true,\n  \"game\": {\n    \"gameId\": 12345,\n    \"authority\": \"Creator...\",\n    \"buyIn\": 0.5,\n    \"maxPlayers\": 3,\n    \"players\": [\"Player1...\", \"Player2...\", \"Player3...\"],\n    \"totalPot\": 1.5,\n    \"isActive\": true,\n    \"votes\": [\n      {\"voter\": \"Player1...\", \"votedFor\": \"Player2...\"},\n      {\"voter\": \"Player2...\", \"votedFor\": \"Player2...\"}\n    ],\n    \"votingEnabled\": true\n  },\n  \"calculated\": {\n    \"operatorFeeAmount\": \"0.1500\",\n    \"prizePool\": \"1.3500\"\n  }\n}"
+							}
+						},
+						{
+							"name": "Distribute by Vote Response",
+							"request": {
+								"method": "POST",
+								"header": [],
+								"url": "{{baseUrl}}/api/v1/prod/transaction/build/distribute-by-vote",
+								"description": "Example response:\n{\n  \"success\": true,\n  \"transaction\": \"BASE64_UNSIGNED_TX...\",\n  \"winners\": [\"Player2Address...\"],\n  \"voteCounts\": {\n    \"Player1Address\": 1,\n    \"Player2Address\": 2\n  },\n  \"instructions\": \"Sign and submit...\"\n}"
+							}
+						}
+					],
+					"description": "Example API responses for reference"
+				}
+			],
+			"description": "📚 Documentation and examples"
+		}
+	]
+}
+