Mine diamonds template

mine-diamonds/.env.example

@@ -0,0 +1,76 @@
+## CHAIN DATA
+# Example: "https://rpc-devnet-cardano-evm.c1.milkomeda.com"
+CHAIN_URI="http://localhost:8545"
+# Example: "https://explorer-devnet-cardano-evm.c1.milkomeda.com"
+CHAIN_EXPLORER_URI=""
+# Example: "Milkomeda C1 Testnet"
+CHAIN_NAME="Hardhat"
+# Example: "200101"
+CHAIN_ID="31337"
+# Example: "Milkomeda Test Ada"
+CHAIN_CURRENCY_NAME="Test Hardhat Tokens"
+# Note: The shorthand currency name/sybol shown in the user's wallet
+# Example: "mtADA"
+CHAIN_CURRENCY_SYMBOL="TEST"
+# Note: The number of decimals of the native/gas asset of the chain
+# Example: "18"
+CHAIN_CURRENCY_DECIMALS="18"
+# Note: This is in seconds as a float
+# Example: "2.0"
+BLOCK_TIME="2"
+
+## CONTRACT DEPLOYMENT
+# Example: "0xA02F7744868945A346Ee6994068F54D039683445"
+CONTRACT_ADDRESS="0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512" # fill with result of npm run chain:deploy
+# Note: This is the block height to start syncing from; usually the contract deployment block height
+# Example: "9000000"
+START_BLOCKHEIGHT="0"
+
+
+## Middleware
+# Note: This is the URL which your middleware will use to interact with your game node webserver
+# Example: "http://localhost:3333"
+BACKEND_URI="http://localhost:3333"
+
+
+## MISC
+# Note: This is the port your game node webserver will use
+# Example: "3333"
+WEBSERVER_PORT="3333"
+# Note: This enables running your game node with just the webserver running, meaning no new blocks will be synced.
+# This is primarily useful for development, devops, or testing other edge cases where you want to interact with
+# the game node but not have the game state progress forward.
+SERVER_ONLY_MODE="false"
+
+## DATABASE
+DB_NAME="postgres"
+DB_USER="postgres"
+DB_PW="postgres"
+DB_HOST="localhost"
+DB_PORT="5432"
+
+## Batcher setup
+# BATCHER DB connection:
+BATCHER_DB_HOST="paima-batcher-db"
+BATCHER_DB_USER="postgres"
+BATCHER_DB_PW="postgres"
+BATCHER_DB_NAME="postgres"
+BATCHER_DB_PORT="5532"
+
+# Batcher Contract:
+DEFAULT_FEE="10000000000000000"
+
+# Batcher Webserver:
+BATCHER_PORT="3340"
+
+# Batcher Validation parameters:
+GAME_NODE_URI="http://localhost:3333"
+DEFAULT_VALIDATION_ACTIVE="false"
+GAME_INPUT_VALIDATOR_PERIOD="1000"
+BATCHED_TRANSACTION_POSTER_PERIOD="3000"
+BATCHED_MESSAGE_SIZE_LIMIT="100000"
+MAX_USER_INPUTS_PER_MINUTE="10"
+MAX_USER_INPUTS_PER_DAY="500"
+
+# Batcher wallet
+BATCHER_PRIVATE_KEY="0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80" # hardhat local node key

mine-diamonds/.eslintrc.js

@@ -0,0 +1,34 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  extends: ['prettier', 'plugin:@typescript-eslint/recommended', 'plugin:prettier/recommended'],
+  parserOptions: {
+    ecmaVersion: 2019,
+    sourceType: 'module',
+  },
+  rules: {
+    '@typescript-eslint/explicit-member-accessibility': 0,
+    '@typescript-eslint/explicit-function-return-type': 0,
+    '@typescript-eslint/no-parameter-properties': 0,
+    '@typescript-eslint/interface-name-prefix': 0,
+    '@typescript-eslint/explicit-module-boundary-types': 0,
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/ban-types': 'off',
+    '@typescript-eslint/no-var-requires': 'off',
+    '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+    '@typescript-eslint/naming-convention': [
+      'error',
+      {
+        selector: 'default',
+        format: null,
+        leadingUnderscore: 'allow',
+      },
+      {
+        selector: 'typeLike',
+        format: ['PascalCase'],
+        leadingUnderscore: 'allow',
+      },
+    ],
+    '@typescript-eslint/consistent-type-imports': 'error',
+    'spaced-comment': 'warn',
+  },
+};

mine-diamonds/.gitignore

@@ -0,0 +1,44 @@
+jestSetup.d.ts
+jestSetup.js
+db/src/pgPool.js
+
+node_modules
+*.tsbuildinfo
+
+build
+lib
+dist
+dist-ssr
+
+# Editor directories and files
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+snapshots
+
+*.local
+
+.env
+.env.testnet
+.env.mainnet
+
+# Frontend
+build.zip
+WebGL
+frontend/paimaMiddleware.js
+
+# recompiled code for standalone purposes
+packaged/*

mine-diamonds/.npmrc

@@ -0,0 +1 @@
+engine-strict=true

mine-diamonds/.nvmrc

@@ -0,0 +1 @@
+lts/iron

mine-diamonds/.prettierignore

@@ -0,0 +1,4 @@
+db/src/*.queries.ts
+api/src/tsoa/routes.ts
+build
+middleware/packaged/*

mine-diamonds/.prettierrc

@@ -0,0 +1,15 @@
+{
+  "overrides": [
+    {
+      "files": ["*.js", "*.ts", "*.jsx", "*.tsx", "*.css", "*.json"],
+      "options": {
+        "trailingComma": "es5",
+        "tabWidth": 2,
+        "semi": true,
+        "singleQuote": true,
+        "printWidth": 100,
+        "arrowParens": "avoid"
+      }
+    }
+  ]
+}

mine-diamonds/.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "files.associations": {
+    ".env.*": "properties"
+  },
+  "[sql]": {
+    "editor.formatOnSave": false
+  },
+  "[json][jsonc][json5]": {
+    "editor.formatOnSave": true
+  }
+}

mine-diamonds/README.md

@@ -0,0 +1,128 @@
+# MineDiamonds Game Node Template
+
+This documentation provides a basic overview of the template. Each module has its own `README` file with more detailed information.
+
+## Installation
+
+To install dependencies and perform initial setup, run the following command:
+
+```
+npm run initialize
+```
+
+This does the following:
+
+- install dependencies of this template
+- copies `.env.example` as `.env.localhost` to the parent folder
+
+### MacOS specific
+
+If you're using Mac and run into installation issues you can add `--target=esbuild-darwin-arm64` as a workaround to `npm install`. This installs the correct version of a problematic package. For example:
+
+```
+npm install --save-dev esbuild@latest --target=esbuild-darwin-arm64
+```
+
+## Building
+
+To compile the Game Node into `endpoints` and `gameCode` entrypoints used by Paima Engine, use the following command:
+
+```
+npm run pack
+```
+
+To compile the JavaScript Bundle of the middleware for the game frontend, run the command:
+
+```
+npm run pack:middleware
+```
+
+## Prerequisites
+
+Ensure that the `paima-engine-{linux|mac}` executable is located in the parent directory of this project. The directory structure should be as follows:
+
+```
+this-template
+../paima-engine-linux
+../.env
+```
+
+## Environment Setup
+
+Config file `.env.localhost` is created during `npm run initialize` in the parent folder, based on `.env.example` in this project. This is an empty file that you need to fill in with your specific values, before running Paima Engine.
+
+Feel free to use examples written in the file for initial testing.
+
+## Contracts
+
+1. Start a local network using `npm run chain:start`
+2. `npm run chain:deploy`
+
+## Development
+
+To reflect changes in the `API`, use the following command to regenerate all `tsoa` routes:
+
+```
+npm run compile:api
+```
+
+If there are any changes to the DB schema or queries, start the `pgtyped` watcher process using the following command. It will regenerate all the DB types used in the project:
+
+```
+npm run compile:db
+```
+
+To speed up the development cycle you can at any time completely reset the database and start syncing from the latest blockheight. Run this command, that will modify your `.env.localhost` and `docker-compose.yml` files:
+
+```
+npm run database:reset
+```
+
+## Production
+
+To start the database, run the command:
+
+```
+npm run database:up
+```
+
+To run the Game Node, follow these steps:
+
+1. Change to the parent directory where the packaged folder was generated:
+
+```
+cd ..
+```
+
+2. Execute the following command:
+
+```
+./paima-engine-linux run
+```
+
+You can set the `NETWORK` variable if you want to load a custom config for your Game Node. For example to load `.env.localhost` use:
+
+```
+NETWORK=localhost ./paima-engine-linux run
+```
+
+## Front-end
+
+Navigate to the `frontend` folder and run:
+
+```
+npm i
+npm run start
+```
+
+Then visit `http://127.0.0.1:8000`
+
+## Documentation
+
+If you've got this far you're probably already familiar with our documentation. But if you need to refresh your knowledge you can copy the documentation files to your file system by using the standalone CLI command:
+
+```
+./paima-engine-linux docs
+```
+
+Or you can visit our [Paima Documentation Website](docs.paimastudios.com) at any time.