feat(token_lite): single-game gas-optimized token component (denshokan lite)

.github/workflows/main-ci.yml

@@ -163,7 +163,7 @@ jobs:
         include:
           # Embeddable Game Standard
           - package: game_components_embeddable_game_standard
-            module: token
+            module: token_legacy
             runner: ubuntu-latest-32
             fuzzer_runs: 32
           - package: game_components_embeddable_game_standard
@@ -178,6 +178,10 @@ jobs:
             module: registry
             runner: ubuntu-latest-8
             fuzzer_runs: 32
+          - package: game_components_embeddable_game_standard
+            module: token
+            runner: ubuntu-latest-8
+            fuzzer_runs: 32
           # Metagame
           - package: game_components_metagame
             module: leaderboard

.github/workflows/pr-ci.yml

@@ -231,10 +231,11 @@ jobs:
           add() { INCLUDES=$(echo "$INCLUDES" | jq -c --arg p "$1" --arg m "$2" --arg r "$3" --argjson f "$4" '. + [{package:$p,module:$m,runner:$r,fuzzer_runs:$f}]'); }
 
           if [ "$NEED_EGS" = "true" ]; then
-            add game_components_embeddable_game_standard token ubuntu-latest-32 32
+            add game_components_embeddable_game_standard token_legacy ubuntu-latest-32 32
             add game_components_embeddable_game_standard minigame ubuntu-latest-8 32
             add game_components_embeddable_game_standard metagame ubuntu-latest-8 32
             add game_components_embeddable_game_standard registry ubuntu-latest-8 32
+            add game_components_embeddable_game_standard token ubuntu-latest-8 32
           fi
           if [ "$NEED_METAGAME" = "true" ]; then
             add game_components_metagame leaderboard ubuntu-latest-4 256

AGENTS.md

@@ -45,7 +45,8 @@ The workspace is organized into **group packages**, each containing multiple mod
 packages/
 ├── embeddable_game_standard/    # Core game standard components
 │   ├── src/
-│   │   ├── token/               # ERC721 game token with compile-time feature flags
+│   │   ├── token/               # THE minigame token standard (self-bound ERC721, absorbed minter)
+│   │   ├── token_legacy/        # Original multi-game ERC721 token (kept for deployed denshokan)
 │   │   ├── minigame/            # Individual game logic foundation
 │   │   ├── metagame/            # High-level game coordination & context
 │   │   └── registry/            # Game registration and discovery
@@ -79,8 +80,39 @@ Each module has its own `AGENTS.md` with detailed documentation inside its `src/
 
 ## Architecture Overview
 
+There are two token generations. New work targets the **standard** token; the
+**legacy** token is kept for deployed denshokan.
+
+### Standard (`token/`) — self-bound, one address
+
+```
+Metagame ──→ Game contract (IS the ERC721 token)
+  │                 ├── Settings (optional)
+  │                 └── Objectives (optional)
+  └── Context (optional)
+```
+
+`MinigameTokenComponent` is embedded IN the game contract, so the game and the
+token are the same address. There is no registry, no `game_address` resolution
+and no mutable token state.
+
+**Game Lifecycle**: Setup → Mint → Play → `refresh_metadata()` (ERC-4906)
+
+There is no `update_game()` and no `IMetagameCallback`: nothing to sync. The
+game contract is the authority on game-over and objective completion, gating
+its own entrypoints with the component's internal `assert_owner_and_playable`.
+Consumers identify a standard token by SRC5 (`IMINIGAME_TOKEN_ID`); the
+creator/fee identity the registry used to hold lives on the token itself
+(`IMINIGAME_TOKEN_CREATOR_ID`).
+
+`MinigameComponent` is **legacy-only** — it asserts `IMINIGAME_TOKEN_LEGACY_ID`
+and calls `game_registry_address()`. A standard-token game embeds the token
+component directly instead (see `test_common::mocks::standard_game_mock`).
+
+### Legacy (`token_legacy/`) — separate token contract, registry-backed
+
 ```
-Metagame ──→ MinigameToken (ERC721) ──→ Minigame
+Metagame ──→ MinigameTokenLegacy (ERC721) ──→ Minigame
   │  ▲               │                      │
   │  │               └── Registry            ├── Settings (optional)
   │  │                                       └── Objectives (optional)
@@ -92,6 +124,12 @@ Metagame ──→ MinigameToken (ERC721) ──→ Minigame
 
 When `update_game()` is called, the token checks if the minter implements `IMetagameCallback` (via SRC5) and dispatches score/game_over/objective callbacks automatically.
 
+The `metagame` lib and `MetagameComponent` serve **both** generations, branching
+on SRC5. `MetagameComponent` is itself **self-bound** — it stores no addresses
+and exposes no ABI (`IMetagame`/`IMETAGAME_ID` were removed): the embedding
+contract IS the metagame, each game's token is resolved per mint, and a
+metagame that provides context embeds `ContextComponent` on its own address.
+
 ## Key Patterns
 
 - `#[starknet::component]` for reusable architecture
@@ -123,28 +161,30 @@ When adding a new module to a group package, update **both** files:
          fuzzer_runs: 256
    ```
 
-   For memory-intensive modules (like `token` or `minigame`), assign a larger runner (e.g., `ubuntu-latest-4` or `ubuntu-latest-32`).
+   For memory-intensive modules (like `token_legacy` or `minigame`), assign a larger runner (e.g., `ubuntu-latest-4` or `ubuntu-latest-32`).
 
 2. **`codecov.yml`** - Update the build count:
    ```yaml
    notify:
      after_n_builds: 15 # ← Must equal total module count in matrix
    ```
 
-### Current Matrix (16 modules)
+### Current Matrix (18 modules)
 
 | Group Package | Module | Runner | Fuzzer Runs |
 |---------------|--------|--------|-------------|
-| `embeddable_game_standard` | `token` | `ubuntu-latest-32` | 32 |
-| `embeddable_game_standard` | `minigame` | `ubuntu-latest-32` | 32 |
-| `embeddable_game_standard` | `metagame` | `ubuntu-latest-32` | 256 |
-| `embeddable_game_standard` | `registry` | `ubuntu-latest-32` | 256 |
+| `embeddable_game_standard` | `token_legacy` | `ubuntu-latest-32` | 32 |
+| `embeddable_game_standard` | `minigame` | `ubuntu-latest-8` | 32 |
+| `embeddable_game_standard` | `metagame` | `ubuntu-latest-8` | 32 |
+| `embeddable_game_standard` | `registry` | `ubuntu-latest-8` | 32 |
+| `embeddable_game_standard` | `token` | `ubuntu-latest-8` | 32 |
 | `metagame` | `leaderboard` | `ubuntu-latest-4` | 256 |
 | `metagame` | `registration` | `ubuntu-latest-4` | 256 |
 | `metagame` | `entry_requirement` | `ubuntu-latest-4` | 256 |
 | `metagame` | `entry_fee` | `ubuntu-latest-4` | 256 |
 | `metagame` | `prize` | `ubuntu-latest-4` | 256 |
 | `metagame` | `ticket_booth` | `ubuntu-latest-4` | 256 |
+| `metagame` | `merkledrop` | `ubuntu-latest-4` | 256 |
 | `economy` | `tokenomics` | `ubuntu-latest-4` | 256 |
 | `utilities` | `math` | `ubuntu-latest-4` | 256 |
 | `utilities` | `distribution` | `ubuntu-latest-4` | 256 |

codecov.yml

@@ -1,9 +1,9 @@
 codecov:
   require_ci_to_pass: true
   notify:
-    # Must equal package count in .github/workflows/main-ci.yml matrix
-    # See AGENTS.md "CI Configuration" section when adding packages
-    after_n_builds: 17
+    # Must equal total module count in the .github/workflows/main-ci.yml matrix
+    # (modules, NOT packages). See AGENTS.md "CI Configuration" when adding a module
+    after_n_builds: 18
 
 comment:
   layout: "diff, files, header, footer"