Fix code review issues from CodeAnt AI

- Fix ERC1155 typo in selectors.json (erc155 -> erc1155)
- Add boolean coercion (!!) to flags.js for isSelfHosted, isStripeEnabled, isApproximatedEnabled
- Update route documentation in accounts.js to match actual routes
- Update route documentation in addresses.js to include all routes
- Update route documentation in demo.js to match actual routes
- Update route documentation in explorers.js with complete route list
- Update route documentation in faucets.js to include all routes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: Antoine de Chevigné

run/api/accounts.js

@@ -3,10 +3,10 @@
  * Manages imported accounts with private keys and native token balances.
  * @module api/accounts
  *
- * @route GET / - Get top native token holders
- * @route GET /imported - Get imported accounts
- * @route POST / - Import new account
- * @route DELETE /:address - Remove imported account
+ * @route GET / - Get filtered native token balances (paginated)
+ * @route GET /imported - Get imported accounts for current user
+ * @route POST /:address/syncBalance - Update account balance
+ * @route POST /:address/privateKey - Store encrypted private key for account
  */
 
 const express = require('express');

run/api/addresses.js

@@ -4,10 +4,14 @@
  * @module api/addresses
  *
  * @route GET /:address/tokenTransferHistory - Get token transfer count over time
+ * @route GET /:address/spentTransactionFeeHistory - Get transaction fees spent over time
+ * @route GET /:address/transactionHistory - Get transaction count over time
+ * @route GET /:address/internalTransactions - Get internal transactions for address
  * @route GET /:address/tokenTransfers - Get token transfers for address
+ * @route GET /:address/stats - Get address transaction statistics
+ * @route GET /:address/nativeTokenBalance - Get current native token balance
+ * @route GET /:address/balances - Get latest token balances
  * @route GET /:address/transactions - Get transactions for address
- * @route GET /:address/stats - Get address statistics
- * @route GET /:address - Get address details
  */
 
 const express = require('express');

run/api/demo.js

@@ -3,9 +3,10 @@
  * Creates and manages demo explorers for trial users.
  * @module api/demo
  *
- * @route POST / - Create demo explorer
- * @route POST /:id/dex - Create demo DEX integration
- * @route POST /:id/claim - Claim demo explorer to user account
+ * @route POST /explorers/:id/v2_dexes - Create V2 DEX for demo explorer
+ * @route GET /explorers - Get demo explorer by token
+ * @route POST /migrateExplorer - Migrate demo explorer to user account with trial
+ * @route POST /explorers - Create new demo explorer
  */
 
 const express = require('express');

run/api/explorers.js

@@ -3,12 +3,31 @@
  * Manages explorer lifecycle: creation, configuration, syncing, and billing.
  * @module api/explorers
  *
- * @route GET /:id/orbitConfig - Get Orbit L2 configuration
+ * @route GET / - Get user's explorers (paginated)
+ * @route GET /:id - Get explorer by ID
  * @route POST / - Create new explorer
- * @route PUT /:id - Update explorer settings
  * @route DELETE /:id - Delete explorer
- * @route POST /:id/sync - Start/stop block synchronization
+ * @route GET /search - Search explorer by domain
+ * @route GET /:id/orbitConfig - Get Orbit L2 configuration
+ * @route PUT /:id/orbitConfig - Update Orbit L2 configuration
+ * @route POST /:id/orbitConfig - Create Orbit L2 configuration
+ * @route PUT /:id/startSync - Start block synchronization
+ * @route PUT /:id/stopSync - Stop block synchronization
  * @route GET /:id/syncStatus - Get synchronization status
+ * @route POST /:id/settings - Update explorer settings
+ * @route POST /:id/branding - Update explorer branding
+ * @route POST /:id/domains - Add custom domain
+ * @route POST /:id/faucets - Create faucet for explorer
+ * @route POST /:id/v2_dexes - Create V2 DEX for explorer
+ * @route GET /billing - Get billing summary
+ * @route GET /plans - Get available subscription plans
+ * @route POST /:id/subscription - Create subscription
+ * @route PUT /:id/subscription - Update subscription
+ * @route DELETE /:id/subscription - Cancel subscription
+ * @route POST /:id/startTrial - Start trial subscription
+ * @route POST /:id/cryptoSubscription - Create crypto payment subscription
+ * @route PUT /:id/quotaExtension - Update quota extension
+ * @route DELETE /:id/quotaExtension - Remove quota extension
  */
 
 const { getNodeEnv, getAppDomain, getDefaultPlanSlug, getDefaultExplorerTrialDays, getStripeSecretKey } = require('../lib/env');

run/api/faucets.js

@@ -4,9 +4,14 @@
  * @module api/faucets
  *
  * @route GET /:id/transactionHistory - Get faucet drip history
+ * @route GET /:id/tokenVolume - Get token volume over time
+ * @route GET /:id/requestVolume - Get request volume over time
+ * @route GET /:id/privateKey - Get faucet wallet private key (owner only)
+ * @route GET /:id/balance - Get current faucet balance
  * @route POST /:id/drip - Request tokens from faucet
- * @route PUT /:id - Update faucet configuration
- * @route POST / - Create new faucet
+ * @route PUT /:id - Update faucet amount and interval
+ * @route PUT /:id/activate - Activate faucet
+ * @route PUT /:id/deactivate - Deactivate faucet
  * @route DELETE /:id - Delete faucet
  */
 

run/lib/abis/selectors.json

@@ -35,7 +35,7 @@
         "errors": []
     },
 
-    "erc155": {
+    "erc1155": {
         "functions": [
             "0x00fdd58ea",
             "0x4e1273f46",

run/lib/flags.js

@@ -6,13 +6,13 @@
 
 module.exports = {
     /** @returns {boolean} True if running in self-hosted mode */
-    isSelfHosted: () => process.env.SELF_HOSTED,
+    isSelfHosted: () => !!process.env.SELF_HOSTED,
 
     /** @returns {boolean} True if Pusher/Soketi is configured and enabled */
     isPusherEnabled: () => !!process.env.SOKETI_DEFAULT_APP_ID && !!process.env.SOKETI_DEFAULT_APP_KEY && !!process.env.SOKETI_DEFAULT_APP_SECRET && !!process.env.SOKETI_HOST && !!process.env.SOKETI_PORT,
 
     /** @returns {boolean} True if Stripe billing is configured */
-    isStripeEnabled: () => process.env.STRIPE_WEBHOOK_SECRET && process.env.STRIPE_SECRET_KEY,
+    isStripeEnabled: () => !!(process.env.STRIPE_WEBHOOK_SECRET && process.env.STRIPE_SECRET_KEY),
 
     /** @returns {boolean} True if Firebase authentication is enabled */
     isFirebaseAuthEnabled: () => !!process.env.ENABLE_FIREBASE_AUTH,
@@ -21,7 +21,7 @@ module.exports = {
     isGoogleApiEnabled: () => !!process.env.GOOGLE_API_KEY,
 
     /** @returns {boolean} True if Approximated SSL is configured */
-    isApproximatedEnabled: () => process.env.APPROXIMATED_API_KEY && process.env.APPROXIMATED_TARGET_IP,
+    isApproximatedEnabled: () => !!(process.env.APPROXIMATED_API_KEY && process.env.APPROXIMATED_TARGET_IP),
 
     /** @returns {boolean} True if NODE_ENV is 'production' */
     isProductionEnvironment: () => process.env.NODE_ENV == 'production',