Sync production with main

.github/workflows/claude-review.yml

@@ -0,0 +1,28 @@
+name: Claude Code Review
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+
+jobs:
+  claude-review:
+    runs-on: ubuntu-latest
+    if: |
+      (github.event_name == 'issue_comment' && github.event.issue.pull_request && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude'))
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+        with:
+          fetch-depth: 1
+      - uses: anthropics/claude-code-action@df37d2f0760a4b5683a6e617c9325bc1a36443f6 # v1.0.75
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          claude_args: |
+            --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"

CLAUDE.md

@@ -27,8 +27,11 @@ Yarn 4.2.2 monorepo with workspaces in `apps/`, `packages/`, and `submodules/`.
 # Install dependencies
 yarn install
 
-# Initialize git submodules (required first time)
+# Initialize git submodules (required first time, and in each new worktree)
 make init-submodules
+# ⚠️ Worktrees do NOT inherit initialized submodules from the main repo.
+# If `yarn install` fails with "Workspace not found (@auto-files/rpc-apis)",
+# run `git submodule update --init --recursive` or `make init-submodules`.
 
 # Build everything (submodules + models + ui + s3 + frontend + backend)
 make all

apps/backend/.env.sample

@@ -4,5 +4,60 @@ FILES_GATEWAY_URL=http://changeme.com # change to your own (or it'll fail when f
 FILES_GATEWAY_TOKEN=changeme # change to your own (or it'll fail when fetching archived files)
 AUTH_SERVICE_API_KEY=1234567890 # change to your own if updated in auth
 RABBITMQ_URL=amqp://guest:guest@localhost:5672
-EVM_CHAIN_ENDPOINT=http://localhost:8545 # update it you want to simulate/test buy credits feature
-EVM_CHAIN_CONTRACT_ADDRESS=0x0000000000000000000000000000000000000000 # update it you want to simulate/test buy credits feature
+
+# ---------------------------------------------------------------------------
+# Pay-with-AI3 / purchased credits feature
+# ---------------------------------------------------------------------------
+
+# Feature flags — set BUY_CREDITS_ACTIVE=true to enable the purchase flow.
+# BUY_CREDITS_STAFF_ONLY=true restricts it to admin/staff accounts only,
+# useful for a staged rollout before opening to all users.
+BUY_CREDITS_ACTIVE=false
+BUY_CREDITS_STAFF_ONLY=false
+
+# EVM endpoint for the AutoDriveCreditsReceiver contract.
+# Point this at the Auto-EVM RPC for the target network (mainnet or Taurus
+# testnet).  The payment manager watches this chain for deposit events.
+EVM_CHAIN_ENDPOINT=http://localhost:8545
+
+# Address of the deployed AutoDriveCreditsReceiver contract.
+# Must match the chain pointed to by EVM_CHAIN_ENDPOINT.
+EVM_CHAIN_CONTRACT_ADDRESS=0x0000000000000000000000000000000000000000
+
+# Number of block confirmations to wait before treating a payment as final.
+# Higher values reduce the risk of processing a payment that is later
+# reversed by a chain reorganisation. Default: 6.
+EVM_CHAIN_CONFIRMATIONS=6
+
+# How often (in milliseconds) the payment manager polls for CONFIRMED intents
+# that have not yet had credits applied. This is a fallback for cases where
+# the event watcher misses a log. Default: 30000 (30 seconds).
+EVM_CHAIN_CHECK_INTERVAL=30000
+
+# Price multiplier applied on top of the raw Autonomys consensus fee to
+# determine the AI3 cost per byte. A value of 5.0 means users pay 5× the
+# current on-chain transaction byte fee. Default: 5.00.
+CREDITS_PRICE_MULTIPLIER=5.00
+
+# ---------------------------------------------------------------------------
+# Credit lifecycle
+# ---------------------------------------------------------------------------
+
+# Number of days after purchase before a credit batch expires.
+# Users see this value on the purchase confirmation screen and in their credit
+# history. Default: 90.
+CREDIT_EXPIRY_DAYS=90
+
+# Maximum total purchased upload bytes allowed per user across all active
+# (non-expired) credit rows. Attempts to purchase beyond this cap result in
+# an OVER_CAP intent requiring admin review. Default: 107374182400 (100 GiB).
+MAX_CREDITS_PER_USER=107374182400
+
+# How often (in milliseconds) the background job runs to mark expired credit
+# rows and clean up stale PENDING intents. Default: 3600000 (1 hour).
+CREDIT_EXPIRY_CHECK_INTERVAL=3600000
+
+# How many minutes a PENDING intent remains valid before it is treated as
+# expired. Users must submit their on-chain transaction within this window
+# after creating an intent. Default: 10.
+INTENT_EXPIRY_MINUTES=10

apps/backend/__tests__/unit/useCases/accounts.spec.ts

@@ -273,7 +273,8 @@ describe('AccountsUseCases', () => {
           accountId: 'acc123',
           intentId: 'intent-xyz',
           uploadBytesOriginal: BigInt(500),
-          downloadBytesOriginal: BigInt(500),
+          // Download credits are not allocated on purchase
+          downloadBytesOriginal: 0n,
         }),
         expect.anything(),
       )