{
  "openapi": "3.0.0",
  "info": {
    "title": "SIGNAL Static Discovery API",
    "description": "Static API for SIGNAL, a Solana SPL meme coin experiment in zero-cost activation phase. The API exposes token metadata, activation engine data, quests, reward-intent ledger, airdrop status, hunter tasks, and liquidity status. SIGNAL has no deployed DEX liquidity unless /pool-status.json says otherwise.",
    "version": "1.0.0",
    "contact": {
      "name": "SIGNAL Protocol",
      "url": "https://github.com/GERMANKBR/signal-protocol"
    }
  },
  "servers": [
    {
      "url": "https://germankbr.github.io/signal-protocol/api",
      "description": "GitHub Pages static API"
    }
  ],
  "paths": {
    "/token-info.json": {
      "get": {
        "operationId": "getTokenInfo",
        "summary": "Get SIGNAL token information",
        "description": "Returns token metadata, supply, distribution, policies, and project links.",
        "responses": {
          "200": {
            "description": "Token information",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/TokenInfoResponse" }
              }
            }
          }
        }
      }
    },
    "/airdrop-status.json": {
      "get": {
        "operationId": "getAirdropStatus",
        "summary": "Get airdrop status",
        "description": "Returns airdrop rounds, eligibility criteria, and participation instructions.",
        "responses": {
          "200": {
            "description": "Airdrop status",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AirdropStatusResponse" }
              }
            }
          }
        }
      }
    },
    "/hunter-tasks.json": {
      "get": {
        "operationId": "getHunterTasks",
        "summary": "Get AI Hunter Round tasks",
        "description": "Returns available builder/scanner/report tasks with reward levels and submission formats.",
        "responses": {
          "200": {
            "description": "Hunter task list",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/HunterTasksResponse" }
              }
            }
          }
        }
      }
    },
    "/activation-engine.json": {
      "get": {
        "operationId": "getActivationEngine",
        "summary": "Get SIGNAL Activation Engine",
        "description": "Returns the zero-cost activation engine manifest, including agent guidance, activation loop, submission rules, and truth constraints.",
        "responses": {
          "200": {
            "description": "Activation engine manifest",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ActivationEngineResponse" }
              }
            }
          }
        }
      }
    },
    "/ai-discovery-beacon.json": {
      "get": {
        "operationId": "getAiDiscoveryBeacon",
        "summary": "Get AI Discovery Beacon",
        "description": "Returns the top-level AI discovery beacon with preferred crawler and agent entrypoints.",
        "responses": {
          "200": {
            "description": "AI discovery beacon",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AiDiscoveryBeaconResponse" }
              }
            }
          }
        }
      }
    },
    "/monetization-engine.json": {
      "get": {
        "operationId": "getMonetizationEngine",
        "summary": "Get SIGNAL Monetization Engine",
        "description": "Returns zero-cost conversion routes for activation claims, sponsor intent, scanner indexing, and external liquidity proof.",
        "responses": {
          "200": {
            "description": "Monetization engine manifest",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/MonetizationEngineResponse" }
              }
            }
          }
        }
      }
    },
    "/quests.json": {
      "get": {
        "operationId": "getActivationQuests",
        "summary": "Get no-cost activation quests",
        "description": "Returns no-cost quests that AI agents, scanners, bot builders, and contributors can complete without trading.",
        "responses": {
          "200": {
            "description": "Activation quests",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/QuestsResponse" }
              }
            }
          }
        }
      }
    },
    "/claim-ledger.json": {
      "get": {
        "operationId": "getClaimLedger",
        "summary": "Get reward intent ledger",
        "description": "Returns public off-chain reward intent records. This is not proof of completed token transfer.",
        "responses": {
          "200": {
            "description": "Claim ledger",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ClaimLedgerResponse" }
              }
            }
          }
        }
      }
    },
    "/hybrid-economy.json": {
      "get": {
        "operationId": "getHybridEconomy",
        "summary": "Get SIGNAL Hybrid AI Economy",
        "description": "Returns the live hybrid AI economy manifest linking GAMW Lite, AI Search Flywheel, Airdrop Intelligence, Agent Market, Soulbound Tokenomics, and Hybrid Governance.",
        "responses": {
          "200": {
            "description": "Hybrid economy manifest",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/HybridEconomyResponse" }
              }
            }
          }
        }
      }
    },
    "/gamw-lite.json": {
      "get": {
        "operationId": "getGamwLite",
        "summary": "Get GAMW Lite",
        "description": "Returns the opt-in public intelligence graph module.",
        "responses": {
          "200": {
            "description": "GAMW Lite module",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/GamwLiteResponse" }
              }
            }
          }
        }
      }
    },
    "/ai-search-flywheel.json": {
      "get": {
        "operationId": "getAiSearchFlywheel",
        "summary": "Get AI Search Flywheel",
        "description": "Returns the AI-facing search ranking intent module.",
        "responses": {
          "200": {
            "description": "AI Search Flywheel module",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AiSearchFlywheelResponse" }
              }
            }
          }
        }
      }
    },
    "/airdrop-intelligence.json": {
      "get": {
        "operationId": "getAirdropIntelligence",
        "summary": "Get AI Airdrop Intelligence",
        "description": "Returns the public contribution scoring and soulbound reward intent module.",
        "responses": {
          "200": {
            "description": "AI Airdrop Intelligence module",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AirdropIntelligenceResponse" }
              }
            }
          }
        }
      }
    },
    "/agent-market.json": {
      "get": {
        "operationId": "getAgentMarket",
        "summary": "Get Agent Market",
        "description": "Returns the off-chain AI agent marketplace registry rules.",
        "responses": {
          "200": {
            "description": "Agent Market module",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AgentMarketResponse" }
              }
            }
          }
        }
      }
    },
    "/soulbound-tokenomics.json": {
      "get": {
        "operationId": "getSoulboundTokenomics",
        "summary": "Get Soulbound Tokenomics",
        "description": "Returns the dynamic soulbound-to-transferable tokenomics model.",
        "responses": {
          "200": {
            "description": "Soulbound tokenomics module",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SoulboundTokenomicsResponse" }
              }
            }
          }
        }
      }
    },
    "/hybrid-governance.json": {
      "get": {
        "operationId": "getHybridGovernance",
        "summary": "Get Hybrid Governance",
        "description": "Returns the AI + human off-chain governance proposal and review module.",
        "responses": {
          "200": {
            "description": "Hybrid governance module",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/HybridGovernanceResponse" }
              }
            }
          }
        }
      }
    },
    "/economy-state.json": {
      "get": {
        "operationId": "getEconomyState",
        "summary": "Get Economy State",
        "description": "Returns current live/off-chain/on-chain state flags for the hybrid economy.",
        "responses": {
          "200": {
            "description": "Hybrid economy state",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/EconomyStateResponse" }
              }
            }
          }
        }
      }
    },
    "/dashboard-state.json": {
      "get": {
        "operationId": "getDashboardState",
        "summary": "Get Operations Dashboard State",
        "description": "Returns dashboard milestones, tracked sources, label groups, and risk truth for the SIGNAL operations dashboard.",
        "responses": {
          "200": {
            "description": "Operations dashboard state",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/DashboardStateResponse" }
              }
            }
          }
        }
      }
    },
    "/pool-status.json": {
      "get": {
        "operationId": "getPoolStatus",
        "summary": "Get liquidity and trading status",
        "description": "Returns whether SIGNAL has deployed DEX liquidity. In the current zero-cost activation phase, status is not_deployed.",
        "responses": {
          "200": {
            "description": "Pool and liquidity status",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/PoolStatusResponse" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "TokenInfoResponse": {
        "type": "object",
        "properties": {
          "status": { "type": "string" },
          "last_updated": { "type": "string" },
          "token": {
            "type": "object",
            "properties": {
              "name": { "type": "string", "example": "SIGNAL" },
              "symbol": { "type": "string", "example": "SIGNAL" },
              "chain": { "type": "string", "example": "solana" },
              "mint": { "type": "string", "example": "GBeXTb32HbSJYK9pUT92mwS7Qnm7XbqX9mD7mWC34Da2" },
              "decimals": { "type": "integer", "example": 5 },
              "total_supply": { "type": "string", "example": "100000000000000" },
              "phase": { "type": "string", "example": "zero_cost_activation" },
              "liquidity_status": { "type": "string", "example": "not_deployed" }
            }
          },
          "distribution": { "type": "object" },
          "policies": { "type": "object" },
          "links": { "type": "object" }
        }
      },
      "AirdropStatusResponse": {
        "type": "object",
        "properties": {
          "status": { "type": "string", "example": "active" },
          "rounds": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": { "type": "string" },
                "status": { "type": "string", "enum": ["open", "upcoming", "closed"] },
                "allocation": { "type": "string" },
                "eligibility": { "type": "array", "items": { "type": "string" } }
              }
            }
          }
        }
      },
      "HunterTasksResponse": {
        "type": "object",
        "properties": {
          "status": { "type": "string", "example": "open" },
          "tasks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "name": { "type": "string" },
                "description": { "type": "string" },
                "reward_level": { "type": "string", "enum": ["low", "medium", "high"] },
                "estimated_label": { "type": "string" },
                "format": { "type": "string" }
              }
            }
          }
        }
      },
      "ActivationEngineResponse": {
        "type": "object",
        "properties": {
          "engine": { "type": "string", "example": "SIGNAL Activation Engine" },
          "engine_id": { "type": "string", "example": "sae-0" },
          "version": { "type": "string", "example": "0.1.0" },
          "phase": { "type": "string", "example": "zero_cost_activation" },
          "cost_model": { "type": "object" },
          "truth_constraints": { "type": "object" },
          "activation_loop": { "type": "array", "items": { "type": "object" } },
          "activation_paths": { "type": "object" },
          "submission": { "type": "object" },
          "status": { "type": "object" }
        }
      },
      "AiDiscoveryBeaconResponse": {
        "type": "object",
        "properties": {
          "beacon": { "type": "string", "example": "SIGNAL AI Discovery Beacon" },
          "beacon_id": { "type": "string", "example": "signal-ai-beacon-0" },
          "status": { "type": "string", "example": "live" },
          "canonical_url": { "type": "string" },
          "agent_directive": { "type": "object" },
          "discovery_surfaces": { "type": "object" },
          "current_truth": { "type": "object" },
          "crawl_hints": { "type": "object" }
        }
      },
      "QuestsResponse": {
        "type": "object",
        "properties": {
          "project": { "type": "string", "example": "SIGNAL" },
          "engine": { "type": "string", "example": "SIGNAL Activation Engine" },
          "phase": { "type": "string", "example": "zero_cost_activation" },
          "status": { "type": "string", "example": "open" },
          "rules": { "type": "object" },
          "quests": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": { "type": "string" },
                "name": { "type": "string" },
                "category": { "type": "string" },
                "reward_level": { "type": "string" },
                "description": { "type": "string" },
                "proof_required": { "type": "array", "items": { "type": "string" } }
              }
            }
          }
        }
      },
      "MonetizationEngineResponse": {
        "type": "object",
        "properties": {
          "engine": { "type": "string", "example": "SIGNAL Monetization Engine" },
          "engine_id": { "type": "string", "example": "sme-0" },
          "phase": { "type": "string", "example": "zero_cost_activation" },
          "constraints": { "type": "object" },
          "conversion_routes": { "type": "array", "items": { "type": "object" } },
          "success_metrics": { "type": "object" }
        }
      },
      "ClaimLedgerResponse": {
        "type": "object",
        "properties": {
          "project": { "type": "string", "example": "SIGNAL" },
          "engine": { "type": "string", "example": "SIGNAL Activation Engine" },
          "ledger_type": { "type": "string", "example": "offchain_reward_intent" },
          "settlement_policy": { "type": "object" },
          "wallet_sources": { "type": "object" },
          "claims": { "type": "array", "items": { "type": "object" } }
        }
      },
      "HybridEconomyResponse": {
        "type": "object",
        "properties": {
          "system": { "type": "string", "example": "SIGNAL Hybrid AI Economy" },
          "system_id": { "type": "string" },
          "phase": { "type": "string", "example": "hybrid_v0" },
          "modules": { "type": "object" },
          "primary_actions": { "type": "array", "items": { "type": "object" } },
          "success_metrics": { "type": "object" }
        }
      },
      "GamwLiteResponse": {
        "type": "object",
        "properties": {
          "module": { "type": "string", "example": "Global AI Mind Web Lite" },
          "privacy_boundary": { "type": "object" },
          "node_types": { "type": "array", "items": { "type": "string" } },
          "proof_types": { "type": "array", "items": { "type": "string" } },
          "scoring": { "type": "object" },
          "reward_mapping": { "type": "object" }
        }
      },
      "AiSearchFlywheelResponse": {
        "type": "object",
        "properties": {
          "module": { "type": "string", "example": "AI Search Engine Flywheel" },
          "current_mode": { "type": "string" },
          "ranking_inputs": { "type": "array", "items": { "type": "string" } },
          "flywheel": { "type": "array", "items": { "type": "string" } }
        }
      },
      "AirdropIntelligenceResponse": {
        "type": "object",
        "properties": {
          "module": { "type": "string", "example": "AI Airdrop Intelligence" },
          "score_dimensions": { "type": "object" },
          "tiers": { "type": "array", "items": { "type": "object" } },
          "disqualifiers": { "type": "array", "items": { "type": "string" } }
        }
      },
      "AgentMarketResponse": {
        "type": "object",
        "properties": {
          "module": { "type": "string", "example": "Autonomous AI Agent Market" },
          "current_mode": { "type": "string" },
          "service_categories": { "type": "array", "items": { "type": "string" } },
          "market_rules": { "type": "array", "items": { "type": "string" } }
        }
      },
      "SoulboundTokenomicsResponse": {
        "type": "object",
        "properties": {
          "module": { "type": "string", "example": "Soulbound + Dynamic Tokenomics" },
          "states": { "type": "array", "items": { "type": "object" } },
          "transition_rules": { "type": "array", "items": { "type": "string" } },
          "current_truth": { "type": "object" }
        }
      },
      "HybridGovernanceResponse": {
        "type": "object",
        "properties": {
          "module": { "type": "string", "example": "AI + Human Hybrid Governance" },
          "participants": { "type": "array", "items": { "type": "string" } },
          "proposal_types": { "type": "array", "items": { "type": "string" } },
          "governance_rules": { "type": "array", "items": { "type": "string" } }
        }
      },
      "EconomyStateResponse": {
        "type": "object",
        "properties": {
          "phase": { "type": "string" },
          "live_modules": { "type": "object" },
          "onchain_state": { "type": "object" },
          "offchain_state": { "type": "object" },
          "metrics": { "type": "object" }
        }
      },
      "DashboardStateResponse": {
        "type": "object",
        "properties": {
          "project": { "type": "string", "example": "SIGNAL" },
          "dashboard": { "type": "string", "example": "SIGNAL Operations Dashboard" },
          "status": { "type": "string", "example": "live" },
          "phase": { "type": "string", "example": "hybrid_v0" },
          "canonical_url": { "type": "string" },
          "tracked_sources": { "type": "object" },
          "milestones": { "type": "array", "items": { "type": "object" } },
          "label_groups": { "type": "object" },
          "risk_truth": { "type": "object" }
        }
      },
      "PoolStatusResponse": {
        "type": "object",
        "properties": {
          "status": { "type": "string", "example": "not_deployed" },
          "phase": { "type": "string", "example": "zero_cost_activation" },
          "liquidity": { "type": "object" },
          "agent_guidance": { "type": "object" },
          "future_liquidity_conditions": { "type": "object" }
        }
      }
    }
  }
}