NodeMasterX is a Serverless Web3 Gateway built by Neural Inverse that provides developers instant access to blockchain networks (Polygon, Bitcoin) through a standard JSON-RPC 2.0 API. It serves as a drop-in replacement for Alchemy, Infura, or QuickNode.

Philosophy: No UI. No Lock-in. Better B2D (Business-to-Developer).

┌──────────────────────────────────────────────────────────────────────────────┐
│ CLIENT (Developer App) │
└─────────────────────────────────┬────────────────────────────────────────────┘
 │
 ▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ AWS API Gateway (HTTP API) │
│ https://nodemasterx.com │
└────┬──────────┬──────────┬──────────┬──────────┬──────────┬─────────────────┘
 │ │ │ │ │ │
 ▼ ▼ ▼ ▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ Status │ │ OAuth │ │ RPC │ │ V2 RPC │ │Interface│ │ Billing │
│Endpoint │ │Callback │ │Endpoint │ │ Handler │ │ APIs │ │ APIs │
└────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘
 │ │ │ │ │ │
 └──────────┴──────────┴────┬─────┴──────────┴──────────┘
 │
 ┌───────────┴───────────┐
 ▼ ▼
 ┌──────────────┐ ┌──────────────────┐
 │ Shared │ │ External │
 │ Modules │ │ Services │
 │ │ │ │
 │ • Validator │ │ • GitHub API │
 │ • Billing │ │ • AWS Blockchain │
 │ Service │ │ • Azure OpenAI │
 │ │ │ • Stripe │
 └──────┬───────┘ └──────────────────┘
 │
 ▼
 ┌──────────────────────────────────────────┐
 │ DynamoDB │
 │ • nodemasterx-users │
 │ • nodemasterx-token-cache │
 │ • nodemasterx-interface-profiles │
 └──────────────────────────────────────────┘

• Route: GET /
• Purpose: Public health check and service info
• Auth: None required
• Response: Product info, supported networks, getting started guide

• Route: GET /callback
• Purpose: Handle GitHub OAuth flow, register new users
• Flow: GitHub OAuth code → Exchange for access token → Create user record in DynamoDB

• Type: Shared middleware (imported by other functions)
• Purpose: Validate GitHub Personal Access Tokens (PAT)
• Key Functions:
  • validateToken(token, requestId) - Main validation entry point
  • getCachedToken(tokenHash) - DynamoDB cache lookup
  • storeCachedToken() - Cache new tokens
  • extendTokenTTL() - Sliding window cache extension
• Security Features:
  • SHA-256 token hashing (never stores raw tokens)
  • Sliding window cache: 15min initial → extends up to 1hr on activity
  • Force revalidation after 5 hours of inactivity
  • User must exist in nodemasterx-users table (OAuth registration required)

• Route: POST /v1/{network}
• Purpose: Forward JSON-RPC requests to blockchain
• Networks: polygon-mainnet, bitcoin-mainnet, bitcoin-testnet
• Key Functions:
  • handler() - Main Lambda handler
  • forwardToBlockchain() - AWS SigV4 signed requests to AMB
  • validateJsonRpcRequest() - JSON-RPC 2.0 validation
  • dispatchUsageEvent() - Send usage to SQS for billing

• Route: POST /v1/batch/{network}
• Purpose: Handle batched JSON-RPC requests (array of requests)

The V2 API adds Programmable AI Middleware that allows developers to inject "intelligence" into the RPC stream.

1. Interface Manifest - A JSON schema defining AI behavior, stored in nodemasterx-interface-profiles
2. Dynamic Compiler - Builds AI system prompts at runtime from the Manifest
3. Execution Gate - Enforces block, flag, or shadow_mode strategies based on AI analysis

• Route: POST /v2/interface/create
• Purpose: Register a new Interface Manifest
• Billing: Deducts 0ドル.10 creation fee from prepaid balance
• Manifest Schema:

{
 "interface_metadata": { "version": "...", "tier": "...", "label": "..." },
 "intelligence_config": { "model": "...", "logic_mode": "..." },
 "active_constraints": {
 "heuristic_rules": ["..."],
 "thresholds": {},
 "fail_strategy": "block|flag|shadow_mode"
 }
}

• Route: GET /v2/interface/list
• Purpose: View user's registered interfaces

• Route: POST /v2/interface/delete
• Purpose: Soft-delete an interface (stops recurring billing)
• Security: IDOR check ensures user owns the interface

• Type: Internal module (not exposed as endpoint)
• Purpose: Core AI evaluation logic
• Key Functions:
  • evaluateTransaction(rpcRequest, interfaceId, context) - Main evaluation
  • buildDynamicPrompt(rpcRequest, profile, enrichment) - Compile AI prompt
  • executeDecisionGate(inferenceResult, constraints) - Enforce block/flag/shadow
  • callAzureOpenAI() - Azure OpenAI API integration

• Route: POST /v2/{network} with header X-NMX-Interface-ID
• Purpose: Execute transactions through the Intelligence Layer
• Flow:
  1. Validate token
  2. Parse JSON-RPC request
  3. Call evaluateTransaction() from interface-engine
  4. If allowed, forward to blockchain
  5. If blocked, return custom error

• Type: Shared module
• Purpose: Core billing logic and Stripe integration
• Key Functions:
  • createOrGetCustomer() - Stripe customer management
  • createPortalSession() - Generate Stripe billing portal URL
  • deductPrepaidBalance() - Synchronous credit deduction
  • checkPrepaidBalance() - Check if user has credits
  • calculateChargeThreshold() - Determine next auto-charge amount
  • attemptCharge() - Charge Stripe payment method
  • shouldThrottle() - Determine if user should be rate-limited

• Route: GET /v1/account/billing
• Purpose: User billing dashboard endpoint
• Response: Account status, usage stats, prepaid balance, portal link

• Trigger: SQS (Usage Queue)
• Purpose: Async processing of usage events
• Flow:
  1. Receive usage event from SQS
  2. Calculate cost
  3. Deduct from prepaid credits OR increment unpaid balance
  4. Auto-charge when threshold reached
  5. Throttle user if charge fails

• Trigger: EventBridge (Daily schedule)
• Purpose: Deduct recurring storage fees for active interfaces
• Flow:
  1. Scan all active interfaces
  2. Aggregate by user
  3. Deduct daily rate from prepaid balance
  4. Mark insufficient funds (TODO: freeze interface logic)

• Primary Key: github_user_id (Number)
• GSI: StripeCustomerIdIndex on stripe_customer_id
• Contains: User profile, OAuth data, billing state, usage counters

• Primary Key: token_hash (String, SHA-256)
• TTL: expires_at (automatic cleanup)
• Contains: Cached token validation, user snapshot, timestamps

• Primary Key: interface_id (String, UUID)
• Contains: Interface manifest, owner, status, timestamps

Defines all resources:

• 3 DynamoDB Tables (Users, Token Cache, Interface Profiles)
• 10+ Lambda Functions
• 1 SQS Queue (Usage processing)
• 1 HTTP API (API Gateway)
• IAM Policies (DynamoDB, SQS, Managed Blockchain)

Alternative CloudFormation template with similar resources.

cp .env.example .env
npm install

npm run test:status # Status endpoint
npm run test:auth # OAuth callback
npm run test:validator # Token validator
npm run test:rpc # RPC endpoint
npm run test:batch # Batch endpoint
npm run test:all # All tests
npm run dev # Watch mode

• v2.1.0-alpha (Current)

  • V2 Intelligence Layer with Azure OpenAI
  • Prepaid credit billing system
  • Interface creation/deletion with billing

• Future (v2.2.0)

  • WebSocket support
  • Additional networks (Ethereum, Solana)
  • Usage analytics dashboard

• Future (v3.0.0)

  • GraphQL API
  • SDK libraries (JS, Python, Go)
  • Enterprise features

Built with ❤️ by Neural Inverse

No UI. No Lock-in. Better B2D.