# satelink-protocol/satelink_network architecture

> Architecture diagram of the GitHub repository satelink-protocol/satelink_network, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/satelink-protocol/satelink_network
- Repository: https://github.com/satelink-protocol/satelink_network

## Overview

Satelink is a pay-per-call Polygon RPC gateway and derived trading-intelligence service, sharing metered credits across both products. The main workflow is discover pricing or service details, make a request, satisfy an x402 challenge or fund credits by deposit, then receive an RPC or intelligence result. The map also includes workload discovery, persistence, and MCP access. Connections are limited to README statements and indexed or excerpted source references; several route-level implementations were not sampled, so those links are omitted.

Main entry points: [`server.js`](https://github.com/satelink-protocol/satelink_network/blob/main/server.js) (API startup), [`apps/api/src/intelligence/engine.js`](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/intelligence/engine.js) (Intelligence API), [`apps/api/src/services/deposit_listener.js`](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/services/deposit_listener.js) (USDT deposit watcher), [`core/routes.js`](https://github.com/satelink-protocol/satelink_network/blob/main/core/routes.js) (Legacy route assembly)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and products"]
  node_manifest["Service discovery<br/>[well_known_x402.js]"]
  node_rpc["RPC gateway<br/>[rpc.js]"]
  node_intelligence["Intelligence API<br/>[engine.js]"]
  node_compute["Metric computation<br/>[compute.js]"]
  node_connectors["Market connectors<br/>[connectors.js]"]
  node_mcp["MCP RPC tools<br/>[rpc.mjs]"]
end

subgraph group_billing["Payments and credits"]
  node_x402["x402 payments<br/>[settlement.js]"]
  node_facilitator["CDP facilitator"]
  node_deposit["USDT deposit watcher"]
  node_credits["Credit service<br/>[credit_service.mjs]"]
  node_polygon["Polygon network"]
end

subgraph group_workloads["Workload services"]
  node_acquisition["Workload acquisition"]
  node_buffer["Demand buffer<br/>[demand_buffer.js]"]
  node_operations["Operations engine"]
end

subgraph group_platform["Runtime and storage"]
  node_startup["API startup<br/>[server.js]"]
  node_migrations["Database migrations<br/>[migrate.js]"]
  node_pg["Postgres adapter<br/>[pg_adapter.js]"]
  node_database[("PostgreSQL")]
  node_legacyroutes["Legacy route assembly<br/>[routes.js]"]
  node_opsadapter["Operations adapter"]
  node_schema["Legacy schema<br/>[schema.js]"]
end

node_caller(("Machine or human"))

node_caller -->|"discovers service"| node_manifest
node_caller -->|"requests RPC"| node_rpc
node_caller -->|"requests metrics"| node_intelligence
node_caller -->|"uses MCP tools"| node_mcp
node_intelligence -->|"uses computation"| node_compute
node_intelligence -->|"uses connectors"| node_connectors
node_caller -->|"pays challenge"| node_x402
node_x402 -->|"settles through"| node_facilitator
node_caller -->|"deposits USDT"| node_polygon
node_polygon -->|"provides deposit events"| node_deposit
node_deposit -->|"credits account"| node_credits
node_acquisition -->|"enqueues workloads"| node_buffer
node_startup -->|"runs migrations"| node_migrations
node_startup -->|"starts watcher"| node_deposit
node_startup -->|"initializes database"| node_pg
node_pg -.->|"accesses"| node_database
node_legacyroutes -->|"creates engine"| node_opsadapter
node_opsadapter -->|"wraps engine"| node_operations
node_legacyroutes -.->|"uses schema"| node_schema

click node_manifest "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/routes/well_known_x402.js"
click node_rpc "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/gateway/routes/rpc.js"
click node_intelligence "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/intelligence/engine.js"
click node_compute "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/intelligence/compute.js"
click node_connectors "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/intelligence/connectors.js"
click node_mcp "https://github.com/satelink-protocol/satelink_network/blob/main/apps/mcp-server/src/rpc.mjs"
click node_x402 "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/payments/x402/settlement.js"
click node_deposit "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/services/deposit_listener.js"
click node_credits "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/billing/credit_service.mjs"
click node_acquisition "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/workloads/workload_acquisition_engine.js"
click node_buffer "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/queue/demand_buffer.js"
click node_operations "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/core/operations_engine.js"
click node_startup "https://github.com/satelink-protocol/satelink_network/blob/main/server.js"
click node_migrations "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/db/migrate.js"
click node_pg "https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/database/pg_adapter.js"
click node_legacyroutes "https://github.com/satelink-protocol/satelink_network/blob/main/core/routes.js"
click node_opsadapter "https://github.com/satelink-protocol/satelink_network/blob/main/core/ops_engine_adapter.js"
click node_schema "https://github.com/satelink-protocol/satelink_network/blob/main/core/schema.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_manifest,node_rpc,node_intelligence,node_compute,node_connectors,node_mcp toneBlue
class node_x402,node_facilitator,node_deposit,node_credits,node_polygon toneAmber
class node_acquisition,node_buffer,node_operations toneMint
class node_startup,node_migrations,node_pg,node_database,node_legacyroutes,node_opsadapter,node_schema toneRose
class node_caller toneIndigo
```

## Components

### Access and products

- [Service discovery](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/routes/well_known_x402.js): `apps/api/src/routes/well_known_x402.js`
- [RPC gateway](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/gateway/routes/rpc.js): `apps/api/src/gateway/routes/rpc.js`
- [Intelligence API](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/intelligence/engine.js): `apps/api/src/intelligence/engine.js`
- [Metric computation](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/intelligence/compute.js): `apps/api/src/intelligence/compute.js`
- [Market connectors](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/intelligence/connectors.js): `apps/api/src/intelligence/connectors.js`
- [MCP RPC tools](https://github.com/satelink-protocol/satelink_network/blob/main/apps/mcp-server/src/rpc.mjs): `apps/mcp-server/src/rpc.mjs`

### Payments and credits

- [x402 payments](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/payments/x402/settlement.js): `apps/api/src/payments/x402/settlement.js`
- **CDP facilitator**
- [USDT deposit watcher](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/services/deposit_listener.js): `apps/api/src/services/deposit_listener.js`
- [Credit service](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/billing/credit_service.mjs): `apps/api/src/billing/credit_service.mjs`
- **Polygon network**

### Workload services

- [Workload acquisition](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/workloads/workload_acquisition_engine.js): `apps/api/src/workloads/workload_acquisition_engine.js`
- [Demand buffer](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/queue/demand_buffer.js): `apps/api/src/queue/demand_buffer.js`
- [Operations engine](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/core/operations_engine.js): `apps/api/src/core/operations_engine.js`

### Runtime and storage

- [API startup](https://github.com/satelink-protocol/satelink_network/blob/main/server.js): `server.js`
- [Database migrations](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/db/migrate.js): `apps/api/src/db/migrate.js`
- [Postgres adapter](https://github.com/satelink-protocol/satelink_network/blob/main/apps/api/src/database/pg_adapter.js): `apps/api/src/database/pg_adapter.js`
- **PostgreSQL**
- [Legacy route assembly](https://github.com/satelink-protocol/satelink_network/blob/main/core/routes.js): `core/routes.js`
- [Operations adapter](https://github.com/satelink-protocol/satelink_network/blob/main/core/ops_engine_adapter.js): `core/ops_engine_adapter.js`
- [Legacy schema](https://github.com/satelink-protocol/satelink_network/blob/main/core/schema.js): `core/schema.js`

### Other components

- **Machine or human**

## Connections

- Machine or human → Service discovery: discovers service (evidence: `README.md`)
- Machine or human → RPC gateway: requests RPC (evidence: `README.md`)
- Machine or human → Intelligence API: requests metrics (evidence: `README.md`)
- Machine or human → MCP RPC tools: uses MCP tools (evidence: `README.md`)
- Intelligence API → Metric computation: uses computation (evidence: `apps/api/src/intelligence/engine.js`)
- Intelligence API → Market connectors: uses connectors (evidence: `apps/api/src/intelligence/engine.js`)
- Machine or human → x402 payments: pays challenge (evidence: `README.md`)
- x402 payments → CDP facilitator: settles through (evidence: `README.md`)
- Machine or human → Polygon network: deposits USDT (evidence: `README.md`)
- Polygon network → USDT deposit watcher: provides deposit events (evidence: `README.md`)
- USDT deposit watcher → Credit service: credits account (evidence: `apps/api/src/services/deposit_listener.js`)
- Workload acquisition → Demand buffer: enqueues workloads (evidence: `apps/api/src/workloads/workload_acquisition_engine.js`)
- API startup → Database migrations: runs migrations (evidence: `server.js`)
- API startup → USDT deposit watcher: starts watcher (evidence: `server.js`)
- API startup → Postgres adapter: initializes database (evidence: `server.js`)
- Postgres adapter → PostgreSQL: accesses (evidence: `apps/api/src/database/pg_adapter.js`)
- Legacy route assembly → Operations adapter: creates engine (evidence: `core/routes.js`)
- Operations adapter → Operations engine: wraps engine (evidence: `core/ops_engine_adapter.js`)
- Legacy route assembly → Legacy schema: uses schema (evidence: `core/routes.js`)
