gitwtfhub

wtf is network-gateway-service?

subquery/network-gateway-service — explained in plain English

Analysis updated 2026-08-14 · repo last pushed 2024-04-24

TypeScriptAudience · developerComplexity · 4/5DormantSetup · moderate

TL;DR

A gateway server that sits between your app and blockchain data providers, handling authentication and routing queries to the right indexer based on your service agreement.

Mindmap

mindmap
  root((repo))
    What it does
      Authenticates users
      Routes queries to indexers
      Checks service agreements
    Tech stack
      TypeScript
      Swagger docs
      Stats dashboard
    Use cases
      Blockchain dashboards
      Analytics tools
      Smart contract queries
    Audience
      App developers
      Data teams
    Setup
      Local server
      Private key config
      VPN for dashboards

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Build a blockchain dashboard that pulls transaction history through a single authenticated gateway.

REASON 2

Create an analytics tool that queries smart contract events via your negotiated indexer agreements.

REASON 3

Monitor service agreement status and data availability across multiple blockchain networks.

What's in the stack?

TypeScriptSwaggerSwagger-Stats

How it stacks up

subquery/network-gateway-service000madz000/rfid-attendance0xdevalias/sparkle
LanguageTypeScriptTypeScriptTypeScript
Last pushed2024-04-242024-07-222022-06-29
MaintenanceDormantDormantDormant
Setup difficultymoderateeasymoderate
Complexity4/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a private key, consumer address, chain ID, and VPN access for dev and production stats dashboards.

No license information is provided in the README, so usage rights are unclear.

Wtf does this do

The Subquery Network Auth Service acts as a gateway between people who need blockchain data and the servers that index and organize it. Instead of wrangling direct connections to data providers, users get a single entry point that handles authentication, checks what they're entitled to, and routes their queries accordingly. At a high level, the service runs as a local server you configure with a private key, a consumer address, a chain ID, and a network selection (testnet or a production environment called Kepler). Once running, it exposes a set of API endpoints. Some let you retrieve metadata about service agreements, check whether a specific blockchain's data is available, or list all active agreements tied to a particular chain. It also ships with Swagger documentation and a stats dashboard so you can inspect and monitor what's happening. The people who'd reach for this are teams building apps that rely on indexed blockchain data, say, a dashboard pulling transaction history from a specific chain, or an analytics tool querying smart contract events. If you've negotiated a service agreement or a pay-as-you-go plan with indexers, this service is the plumbing that makes those agreements actionable. You prove who you are, the service validates your plan, and your queries flow through to the right indexer without you managing that relationship manually. The README doesn't go into much detail on tradeoffs or architectural decisions beyond an architecture diagram. What's visible is a fairly straightforward TypeScript service with environment-based configuration, a few legacy API endpoints, and built-in observability through Swagger and Swagger-Stats. The reliance on VPN access for dev and production stats dashboards suggests it's designed for internal or controlled deployment rather than public exposure out of the box.

Yoink these prompts

Prompt 1
Set up the Subquery Network Gateway Service locally with my private key, consumer address, and chain ID configured for testnet. Walk me through each environment variable.
Prompt 2
Show me how to call the API endpoints to list all active service agreements for a specific chain using the Subquery Network Gateway Service.
Prompt 3
Help me integrate the Subquery Network Gateway Service into my Node.js app so that all blockchain data queries route through it with automatic authentication.
Prompt 4
Set up the Swagger and Swagger-Stats dashboards for the Subquery Network Gateway Service and explain what metrics I should monitor.

Frequently asked questions

wtf is network-gateway-service?

A gateway server that sits between your app and blockchain data providers, handling authentication and routing queries to the right indexer based on your service agreement.

What language is network-gateway-service written in?

Mainly TypeScript. The stack also includes TypeScript, Swagger, Swagger-Stats.

Is network-gateway-service actively maintained?

Dormant — no commits in 2+ years (last push 2024-04-24).

What license does network-gateway-service use?

No license information is provided in the README, so usage rights are unclear.

How hard is network-gateway-service to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is network-gateway-service for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.