{
  "openapi": "3.1.0",
  "info": {
    "title": "Main.net Reference API",
    "version": "v1",
    "summary": "Static source-cited mainnet chain metadata API.",
    "description": "Main.net API v1 is a static, source-cited reference API generated at build time. The API does not publish live uptime, latency, block lag, price, TVL, or investment advice. Public RPC endpoints are convenience references and should be verified against linked sources before production use."
  },
  "servers": [
    {
      "url": "https://main.net",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/v1/chains.json": {
      "get": {
        "summary": "Source-cited chain metadata, RPC URLs, explorers, review dates, and safety notes.",
        "operationId": "chains",
        "tags": [
          "chains"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/launches.json": {
      "get": {
        "summary": "Source-cited launch records with primary source links.",
        "operationId": "launches",
        "tags": [
          "launches"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/categories.json": {
      "get": {
        "summary": "Network category records and the chain IDs grouped under each category.",
        "operationId": "network_categories",
        "tags": [
          "network-categories"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/glossary.json": {
      "get": {
        "summary": "Short mainnet, RPC endpoint, and chain ID definitions with related guide URLs.",
        "operationId": "glossary",
        "tags": [
          "glossary"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/gas-tokens.json": {
      "get": {
        "summary": "Gas token groups derived from reviewed chain metadata.",
        "operationId": "gas_tokens",
        "tags": [
          "gas-tokens"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/explorers.json": {
      "get": {
        "summary": "Block explorer hostnames and chain contexts from reviewed chain metadata.",
        "operationId": "explorers",
        "tags": [
          "explorers"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/search-index.json": {
      "get": {
        "summary": "Static discovery index for chain, RPC, guide, launch, glossary, explorer, and gas-token pages.",
        "operationId": "search_index",
        "tags": [
          "search-index"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/review-queue.json": {
      "get": {
        "summary": "Operator-facing freshness queue for monthly chain metadata reviews.",
        "operationId": "review_queue",
        "tags": [
          "review-queue"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/sources.json": {
      "get": {
        "summary": "Deduplicated public source registry with chain and launch page contexts.",
        "operationId": "sources",
        "tags": [
          "sources"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/source-hashes.json": {
      "get": {
        "summary": "Operator-generated source URL hash snapshot for deterministic change detection.",
        "operationId": "source_hashes",
        "tags": [
          "source-hashes"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/source-changes.json": {
      "get": {
        "summary": "Operator-generated source URL changes compared with the previous hash artifact.",
        "operationId": "source_changes",
        "tags": [
          "source-changes"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/rpc-probes.json": {
      "get": {
        "summary": "Operator-generated eth_chainId probe snapshot for EVM-style public RPC endpoints.",
        "operationId": "rpc_probes",
        "tags": [
          "rpc-probes"
        ],
        "responses": {
          "200": {
            "description": "Static source-cited JSON response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "chains",
      "description": "Source-cited chain metadata, RPC URLs, explorers, review dates, and safety notes."
    },
    {
      "name": "launches",
      "description": "Source-cited launch records with primary source links."
    },
    {
      "name": "network-categories",
      "description": "Network category records and the chain IDs grouped under each category."
    },
    {
      "name": "glossary",
      "description": "Short mainnet, RPC endpoint, and chain ID definitions with related guide URLs."
    },
    {
      "name": "gas-tokens",
      "description": "Gas token groups derived from reviewed chain metadata."
    },
    {
      "name": "explorers",
      "description": "Block explorer hostnames and chain contexts from reviewed chain metadata."
    },
    {
      "name": "search-index",
      "description": "Static discovery index for chain, RPC, guide, launch, glossary, explorer, and gas-token pages."
    },
    {
      "name": "review-queue",
      "description": "Operator-facing freshness queue for monthly chain metadata reviews."
    },
    {
      "name": "sources",
      "description": "Deduplicated public source registry with chain and launch page contexts."
    },
    {
      "name": "source-hashes",
      "description": "Operator-generated source URL hash snapshot for deterministic change detection."
    },
    {
      "name": "source-changes",
      "description": "Operator-generated source URL changes compared with the previous hash artifact."
    },
    {
      "name": "rpc-probes",
      "description": "Operator-generated eth_chainId probe snapshot for EVM-style public RPC endpoints."
    }
  ],
  "x-mainnet": {
    "mode": "static-source-cited",
    "schema_version": "1.0.0",
    "updated": "April 30, 2026",
    "boundaries": [
      "No custody",
      "No swaps",
      "No bridge execution",
      "No token sales",
      "No investment advice",
      "No live uptime or latency claims"
    ]
  }
}