feat: Implemented L2 Batch aggregator to submit L2 Txs to Main

.beads/.gitignore

@@ -0,0 +1,29 @@
+# SQLite databases
+*.db
+*.db?*
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Daemon runtime files
+daemon.lock
+daemon.log
+daemon.pid
+bd.sock
+
+# Legacy database files
+db.sqlite
+bd.db
+
+# Merge artifacts (temporary files from 3-way merge)
+beads.base.jsonl
+beads.base.meta.json
+beads.left.jsonl
+beads.left.meta.json
+beads.right.jsonl
+beads.right.meta.json
+
+# Keep JSONL exports and config (source of truth for git)
+!issues.jsonl
+!metadata.json
+!config.json

.beads/.local_version

@@ -0,0 +1 @@
+0.47.0

.beads/config.yaml

@@ -0,0 +1 @@
+sync-branch: beads-sync

.beads/metadata.json

@@ -0,0 +1,4 @@
+{
+  "database": "beads.db",
+  "jsonl_export": "beads.left.jsonl"
+}

.dockerignore

@@ -0,0 +1,15 @@
+# Exclude git directory
+.git
+
+# Exclude node_modules (installed fresh during build)
+node_modules
+
+# Exclude devnet runtime files
+devnet/identities
+devnet/.env
+devnet/demos_peerlist.json
+devnet/postgres-data
+
+# Exclude unnecessary files
+*.log
+.DS_Store

.env.example

@@ -6,3 +6,62 @@ GITHUB_TOKEN=
 
 DISCORD_API_URL=
 DISCORD_BOT_TOKEN=
+
+GITHUB_CLIENT_ID=
+GITHUB_CLIENT_SECRET=
+
+# ===========================================
+# L2PS (Layer 2 Private System) Configuration
+# ===========================================
+
+# Batch Aggregator Settings
+L2PS_AGGREGATION_INTERVAL_MS=10000
+L2PS_MIN_BATCH_SIZE=1
+L2PS_MAX_BATCH_SIZE=10
+L2PS_CLEANUP_AGE_MS=300000
+
+# ZK Proof Settings
+L2PS_ZK_ENABLED=true
+
+# Hash Service Settings
+L2PS_HASH_INTERVAL_MS=5000
+
+# ===========================================
+# OmniProtocol TCP Server Configuration
+# ===========================================
+OMNI_ENABLED=false
+OMNI_PORT=3001
+OMNI_MODE=OMNI_ONLY
+OMNI_FATAL=false
+
+# OmniProtocol TLS Encryption
+OMNI_TLS_ENABLED=false
+OMNI_TLS_MODE=self-signed
+OMNI_CERT_PATH=./certs/node-cert.pem
+OMNI_KEY_PATH=./certs/node-key.pem
+OMNI_CA_PATH=
+OMNI_TLS_MIN_VERSION=TLSv1.3
+
+# OmniProtocol Rate Limiting
+OMNI_RATE_LIMIT_ENABLED=true
+OMNI_MAX_CONNECTIONS_PER_IP=10
+OMNI_MAX_REQUESTS_PER_SECOND_PER_IP=100
+OMNI_MAX_REQUESTS_PER_SECOND_PER_IDENTITY=200
+
+# Prometheus Metrics (optional - enabled by default)
+# Exposes metrics at http://localhost:<METRICS_PORT>/metrics for Prometheus scraping
+# Note: This is the NODE's metrics endpoint, not the Prometheus server port.
+# The monitoring stack's Prometheus server runs on port 9091 (see monitoring/docker-compose.yml)
+METRICS_ENABLED=true
+METRICS_PORT=9090
+METRICS_HOST=0.0.0.0
+
+# ===========================================
+# TLSNotary HTTPS Attestation Configuration
+# ===========================================
+TLSNOTARY_ENABLED=false
+TLSNOTARY_PORT=7047
+TLSNOTARY_SIGNING_KEY=
+TLSNOTARY_PROXY_PORT=55688
+TLSNOTARY_MAX_SENT_DATA=16384
+TLSNOTARY_MAX_RECV_DATA=65536

.eslintrc.cjs

@@ -21,7 +21,9 @@ module.exports = {
         // "linebreak-style": ["error", "unix"],
         quotes: ["error", "double"],
         semi: ["error", "never"],
-        // "no-console": "warn",
+        // no-console: warn for all src/ files to encourage CategorizedLogger usage
+        // Excluded files are defined in overrides below
+        "no-console": ["warn", { allow: ["error"] }],
         // no-unused-vars is disabled
         "no-unused-vars": ["off"],
         "no-var": ["off"],
@@ -72,4 +74,57 @@ module.exports = {
             },
         ],
     },
+    // Override no-console for files where console.log is acceptable
+    overrides: [
+        {
+            // Standalone CLI tools and utilities where console output is intended
+            files: [
+                "src/benchmark.ts",
+                "src/client/**/*.ts",
+                // CLI utilities (both paths)
+                "src/utilities/keyMaker.ts",
+                "src/utilities/showPubkey.ts",
+                "src/utilities/backupAndRestore.ts",
+                "src/utilities/commandLine.ts",
+                "src/utilities/cli_libraries/**/*.ts",
+                "src/utilities/Diagnostic.ts",
+                "src/utilities/evmInfo.ts",
+                "src/libs/utils/keyMaker.ts",
+                "src/libs/utils/showPubkey.ts",
+                // TUI components need console access
+                "src/utilities/tui/**/*.ts",
+                "src/tests/**/*.ts",
+            ],
+            rules: {
+                "no-console": "off",
+            },
+        },
+        {
+            // Test files, PoC scripts, and fixture scripts where console output is expected
+            files: [
+                "tests/**/*.ts",
+                "src/tests/**/*.ts",
+                "**/test.ts",
+                "**/test/*.ts",
+                "**/*_test.ts",
+                "**/*Test.ts",
+                "**/PoC.ts",
+                "**/poc.ts",
+                "omniprotocol_fixtures_scripts/**/*.ts",
+                "local_tests/**/*.ts",
+                "aptos_tests/**/*.ts",
+            ],
+            rules: {
+                "no-console": "off",
+                "@typescript-eslint/naming-convention": "off",
+            },
+        },
+        {
+            // Main entry point startup/shutdown logs are acceptable
+            files: ["src/index.ts"],
+            rules: {
+                "no-console": "off",
+            },
+        },
+    ],
 }

.gitattributes

@@ -0,0 +1,3 @@
+
+# Use bd merge for beads JSONL files
+.beads/issues.jsonl merge=beads

.github/copilot-instructions.md

@@ -0,0 +1,71 @@
+# GitHub Copilot Instructions for Demos Network
+
+## Project Overview
+
+This project is the Demos Network node/RPC implementation. We use **bd (beads)** for all task tracking.
+
+**Key Features:**
+- Dependency-aware issue tracking
+- Auto-sync with Git via JSONL
+- AI-optimized CLI with JSON output
+
+## Tech Stack
+
+- **Runtime**: Bun (cross-platform)
+- **Language**: TypeScript
+- **Testing**: Bun test
+- **CI/CD**: GitHub Actions
+
+## Issue Tracking with bd
+
+**CRITICAL**: This project uses **bd** for ALL task tracking. Do NOT create markdown TODO lists.
+
+### Essential Commands
+
+```bash
+# Find work
+bd ready --json                    # Unblocked issues
+bd stale --days 30 --json          # Forgotten issues
+
+# Create and manage
+bd create "Title" -t bug|feature|task -p 0-4 --json
+bd update <id> --status in_progress --json
+bd close <id> --reason "Done" --json
+
+# Search
+bd list --status open --priority 1 --json
+bd show <id> --json
+
+# Sync (CRITICAL at end of session!)
+bd sync  # Force immediate export/commit/push
+```
+
+### Workflow
+
+1. **Check ready work**: `bd ready --json`
+2. **Claim task**: `bd update <id> --status in_progress`
+3. **Work on it**: Implement, test, document
+4. **Discover new work?** `bd create "Found bug" -p 1 --deps discovered-from:<parent-id> --json`
+5. **Complete**: `bd close <id> --reason "Done" --json`
+6. **Sync**: `bd sync` (flushes changes to git immediately)
+
+### Priorities
+
+- `0` - Critical (security, data loss, broken builds)
+- `1` - High (major features, important bugs)
+- `2` - Medium (default, nice-to-have)
+- `3` - Low (polish, optimization)
+- `4` - Backlog (future ideas)
+
+## Important Rules
+
+- Use bd for ALL task tracking
+- Always use `--json` flag for programmatic use
+- Link discovered work with `discovered-from` dependencies
+- Check `bd ready` before asking "what should I work on?"
+- Do NOT create markdown TODO lists
+- Do NOT commit `.beads/beads.db` (JSONL only)
+
+---
+
+**For detailed workflows and advanced features, see [AGENTS.md](../AGENTS.md)**

.github/workflows/fix-beads-conflicts.yml

@@ -0,0 +1,73 @@
+name: Preserve Branch-Specific Beads Files
+
+on:
+  push:
+    branches: ['**']
+
+jobs:
+  preserve-beads:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Check if this was a merge commit
+        id: check_merge
+        run: |
+          if git log -1 --pretty=format:"%P" | grep -q " "; then
+            echo "is_merge=true" >> $GITHUB_OUTPUT
+            echo "✅ Detected merge commit"
+          else
+            echo "is_merge=false" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+
+      - name: Check for .beads changes in merge
+        if: steps.check_merge.outputs.is_merge == 'true'
+        id: check_beads
+        run: |
+          if git log -1 --name-only | grep -qE "^\.beads/(issues\.jsonl|deletions\.jsonl|metadata\.json)$"; then
+            echo "beads_changed=true" >> $GITHUB_OUTPUT
+            echo "🚨 .beads files were modified in merge - will revert!"
+          else
+            echo "beads_changed=false" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+
+      - name: Revert .beads to pre-merge state
+        if: steps.check_merge.outputs.is_merge == 'true' && steps.check_beads.outputs.beads_changed == 'true'
+        run: |
+          CURRENT_BRANCH=$(git branch --show-current)
+          echo "🔄 Reverting .beads/ issue tracking files to pre-merge state on $CURRENT_BRANCH"
+
+          # Get the first parent (target branch before merge)
+          MERGE_BASE=$(git log -1 --pretty=format:"%P" | cut -d' ' -f1)
+
+          # Restore specific .beads files from the target branch's state before merge
+          git checkout $MERGE_BASE -- .beads/issues.jsonl 2>/dev/null || echo "No issues.jsonl in base commit"
+          git checkout $MERGE_BASE -- .beads/deletions.jsonl 2>/dev/null || echo "No deletions.jsonl in base commit"
+          git checkout $MERGE_BASE -- .beads/metadata.json 2>/dev/null || echo "No metadata.json in base commit"
+
+          # Configure git
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          # Commit the reversion
+          if git diff --staged --quiet; then
+            git add .beads/issues.jsonl .beads/deletions.jsonl .beads/metadata.json 2>/dev/null || true
+          fi
+
+          if ! git diff --cached --quiet; then
+            git commit -m "🔒 Preserve branch-specific .beads issue tracking files
+
+          Reverted .beads/ changes from merge to keep $CURRENT_BRANCH version intact.
+          [skip ci]"
+
+            git push origin $CURRENT_BRANCH
+            echo "✅ Successfully preserved $CURRENT_BRANCH .beads files"
+          else
+            echo "ℹ️ No changes to revert"
+          fi

.github/workflows/notify-beads-merging.yml

@@ -0,0 +1,37 @@
+name: Beads Merge Warning
+
+on:
+  pull_request:
+    branches: ['**']
+
+jobs:
+  beads-warning:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check for .beads changes
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Warn about .beads files
+        run: |
+          # Check if PR touches .beads issue tracking files
+          if git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -qE "^\.beads/(issues\.jsonl|deletions\.jsonl|metadata\.json)$"; then
+            echo "⚠️  This PR modifies .beads/ issue tracking files"
+            echo "🤖 After merge, these will be auto-reverted to preserve branch-specific issues"
+            echo ""
+            echo "Files affected:"
+            git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E "^\.beads/(issues\.jsonl|deletions\.jsonl|metadata\.json)$" | sed 's/^/  - /'
+
+            # Post comment on PR
+            gh pr comment ${{ github.event.number }} --body "⚠️ **Beads Issue Tracking Files Detected**
+
+            This PR modifies \`.beads/\` issue tracking files. After merge, these changes will be **automatically reverted** to preserve branch-specific issue tracking.
+
+            Files that will be reverted:
+            $(git diff --name-only origin/${{ github.base_ref }}...HEAD | grep -E '^\.beads/(issues\.jsonl|deletions\.jsonl|metadata\.json)$' | sed 's/^/- /')" || echo "Could not post comment"
+          else
+            echo "✅ No .beads issue tracking files affected"
+          fi
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}