Add batcher and local wallet, do NFT indexing ourselves (#122)

- Remove external indexer dependencies in favor of Paima primitives
  - Add Hardhat configuration for AnnotatedMintNft contract, like Tarochi for Genesis Trainers
  - Use `Tarochi Genesis Trainer` entry in `extensions.$ENV.yml` to track NFT ownership
  - Track per-NFT win/lose stats in a new table, according to what NFT was selected when a lobby was created or joined
  - Fulfill relevant API routes:
    - `/account-nfts`
      - Includes all linked wallets
    - `/historical-owner` (currently ignores passed-in contract address and block height)
    - `/title-image` (currently ignores passed-in contract address)
    - `/nft-score` (currently ignores passed-in contract address)
- Add LocalWallet and wallet delegation handling
  - Add batcher startup configuration
  - Old middleware method `userWalletLogin` returns as soon as LocalWallet is ready
  - LocalWallet and batcher are used for most game transactions instead of requiring signing each time
  - New middleware method `externalWalletConnect` follows full delegation procedure and posts `&wd|` message to batcher
  - All API routes use "main wallet" when sensible
- Update a few more misc NPM packages

Future work:
- Test NFT-less play in non-debug builds
- Test/refine "main wallet" handling in API for corner cases, such as playing some NFT-less games then connecting a wallet

Depends on: PaimaStudios/paima-engine#439

Author: SpaceManiac

.editorconfig

@@ -0,0 +1,5 @@
+root = true
+
+[*.{js,ts}]
+indent_size = 2
+indent_style = space

.env.devnet

@@ -25,7 +25,6 @@ STOP_BLOCKHEIGHT=
 SERVER_ONLY_MODE="false"
 
 # STF checkpoints
-LOBBY_AUTOPLAY_BLOCKHEIGHT="14076947"
 
 # DATABASE
 DB_NAME="postgres"
@@ -41,4 +40,4 @@ WEBSERVER_PORT="3333"
 # CONFIG IDS
 SHORT_CONFIG="FWJv579eJfdg0P"
 MEDIUM_CONFIG="S6BZo8biAtrDp1"
-LONG_CONFIG="sEyGPliPidNUzx"
+LONG_CONFIG="sEyGPliPidNUzx"

.env.mainnet

@@ -25,7 +25,6 @@ STOP_BLOCKHEIGHT=
 SERVER_ONLY_MODE="false"
 
 #STF checkpoints
-LOBBY_AUTOPLAY_BLOCKHEIGHT="12731234"
 
 # DATABASE
 DB_NAME="postgres"

.env.test

@@ -25,7 +25,6 @@ STOP_BLOCKHEIGHT=
 SERVER_ONLY_MODE="false"
 
 # STF checkpoints
-LOBBY_AUTOPLAY_BLOCKHEIGHT="14076947"
 
 # DATABASE
 DB_NAME="postgres"

.vscode/settings.json

@@ -2,7 +2,7 @@
   //formatting is done by prettier ran by eslint
   "editor.formatOnSave": false,
   "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": true
+    "source.fixAll.eslint": "explicit"
   },
   "files.associations": {
     ".env.*": "properties"

api/package.json

@@ -12,11 +12,13 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
+    "@paima/utils-backend": "^5.0.0",
     "@tower-defense/db": "../db",
     "@tower-defense/game-logic": "../game-logic",
     "@tower-defense/utils": "../utils",
     "fp-ts": "^2.12.3",
     "io-ts": "^2.2.18",
-    "tsoa": "^6.4.0"
+    "tsoa": "^6.4.0",
+    "viem": "^2.21.32"
   }
 }

api/src/controllers/accountNfts.ts

@@ -0,0 +1,62 @@
+import { getOwnedNfts } from '@paima/utils-backend';
+import { requirePool } from '@tower-defense/db';
+import { Controller, Get, Query, Route } from 'tsoa';
+import { cdeName, getContractAddress, getNftMetadata } from '@tower-defense/utils';
+import { getMainAddress, getRelatedWallets } from '@paima/db';
+
+interface AccountNftsResult {
+  metadata: {
+    name: string;
+    image: string;
+  };
+  contract: string;
+  tokenId: number;
+}
+
+interface AccountNftsData {
+  pages: number;
+  totalItems: number;
+  result: AccountNftsResult[];
+}
+
+@Route('account-nfts')
+export class AccountNftsController extends Controller {
+  @Get()
+  public async get(
+    @Query() account: string,
+    @Query() page: number,
+    @Query() size: number
+  ): Promise<{ response: AccountNftsData }> {
+    console.log('account-nfts', account, page, size);
+
+    const pool = requirePool();
+    account = (await getMainAddress(account, pool)).address;
+
+    const related = await getRelatedWallets(account, pool);
+    const allAddresses = [
+      ...related.from.map(x => x.to_address),
+      account,
+      ...related.to.map(x => x.from_address),
+    ];
+
+    let tokenIds = (await Promise.all(allAddresses.map(x => getOwnedNfts(pool, cdeName, x))))
+      .flat()
+      .sort();
+
+    const totalItems = tokenIds.length,
+      pages = Math.ceil(totalItems / size);
+    tokenIds = tokenIds.slice(page * size, (page + 1) * size);
+
+    return {
+      response: {
+        pages,
+        totalItems,
+        result: tokenIds.map(id => ({
+          metadata: getNftMetadata(id),
+          contract: getContractAddress(),
+          tokenId: Number(id),
+        })),
+      },
+    };
+  }
+}

api/src/controllers/allConfigs.ts

@@ -2,6 +2,7 @@ import { Controller, Get, Query, Route } from 'tsoa';
 import type { IGetUserConfigsResult } from '@tower-defense/db';
 import { getUserConfigs } from '@tower-defense/db';
 import { requirePool } from '@tower-defense/db';
+import { getMainAddress } from '@paima/db';
 
 interface UserConfigsResponse {
   configs: IGetUserConfigsResult[];
@@ -12,6 +13,7 @@ export class userConfigsController extends Controller {
   @Get()
   public async get(@Query() creator: string): Promise<UserConfigsResponse> {
     const pool = requirePool();
+    creator = (await getMainAddress(creator, pool)).address;
     const configs = await getUserConfigs.run({ creator }, pool);
     return { configs };
   }

api/src/controllers/historicalOwner.ts

@@ -0,0 +1,37 @@
+import { Controller, Get, Query, Route } from 'tsoa';
+import { getNftOwner } from '@paima/utils-backend';
+import { requirePool } from '@tower-defense/db';
+import { cdeName } from '@tower-defense/utils';
+
+type HistoricalOwner =
+  | {
+      success: true;
+      result: string;
+    }
+  | { success: false };
+
+@Route('historical-owner')
+export class HistoricalOwnerController extends Controller {
+  @Get()
+  public async get(
+    @Query() contract: string,
+    @Query() tokenId: number,
+    @Query() blockHeight: number
+  ): Promise<HistoricalOwner> {
+    console.log('historical-owner', contract, tokenId, blockHeight);
+
+    // NOTE: This is not a REAL historical owner endpoint! Block height is ignored!
+    // This is fine for now because the frontend only asks about the current state anyways.
+    // TODO: It also currently ignores the contract address.
+
+    const pool = requirePool();
+    const value = await getNftOwner(pool, cdeName, BigInt(tokenId));
+
+    return value
+      ? {
+          success: true,
+          result: value,
+        }
+      : { success: false };
+  }
+}

api/src/controllers/nftScore.ts

@@ -0,0 +1,41 @@
+import { getNftScore, requirePool } from '@tower-defense/db';
+import { Controller, Get, Query, Route } from 'tsoa';
+import { cdeName } from '@tower-defense/utils';
+
+interface NftScore {
+  data: {
+    nft_contract: string;
+    token_id: number;
+    total_games: number;
+    wins: number;
+    draws: number;
+    losses: number;
+    score: number;
+  };
+}
+
+@Route('nft-score')
+export class NftScoreController extends Controller {
+  @Get()
+  public async get(@Query() nft_contract: string, @Query() token_id: number): Promise<NftScore> {
+    console.log('nft-score', nft_contract, token_id);
+
+    const pool = requirePool();
+    const rows = await getNftScore.run({ cde_name: cdeName, token_id: String(token_id) }, pool);
+    const { wins, losses } = rows.length > 0 ? rows[0] : { wins: 0, losses: 0 };
+
+    return {
+      data: {
+        nft_contract,
+        token_id,
+        wins,
+        losses,
+        // These are not shown in the frontend, except for a sanity check that
+        // totalGames must be equal to wins + losses + draws.
+        total_games: wins + losses,
+        draws: 0,
+        score: wins,
+      },
+    };
+  }
+}