# Alpen networks
#
# Source of truth for every network Alpen runs (testnet, mainnet).
# Consumed by:
#   - /llms.txt (this site, agent-facing summary)
#   - /networks.yaml (public endpoint, fetched by alpen-mcp and partners)
#   - any future on-site docs page that lists current network details
#
# To update active network: flip the `active: true` field. Only one network
# should be active at a time. Keep historical entries with `status: sunset`
# so docs links remain consistent.
#
# Schema version. Bump on breaking changes.
schema_version: 1

networks:
  - id: alpen-testnet
    name: Alpen Testnet
    status: live              # live | upcoming | sunset
    active: true              # the current canonical testnet
    spec: prague              # EVM hardfork
    chain_id: 8150
    currency:
      name: Signet BTC
      symbol: sBTC
      decimals: 18
    underlying_l1: bitcoin-signet  # custom Alpen-operated signet
    rpc:
      http: https://rpc.testnet.alpenlabs.io
    bundler:
      # ERC-4337 bundler (account abstraction)
      http: https://bundler.testnet.alpenlabs.io
    explorers:
      alpen_l2: https://explorer.testnet.alpenlabs.io
      bitcoin_signet: https://bitcoin.testnet.alpenlabs.io
      checkpoints: https://checkpoints.testnet.alpenlabs.io
    faucet:
      web: https://faucet.testnet.alpenlabs.io
      api: https://faucet-api.testnet.alpenlabs.io
    status_dashboard: https://status.testnet.alpenlabs.io
    contracts:
      # ERC-4337 EntryPoint (account abstraction)
      entry_point_v0_6: "0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789"
      entry_point_v0_7: "0x0000000071727De22E5E9d8BAf0edAc6f37da032"
      # Bridge contract address: TODO when published
      bridge: null
    block_time_seconds: null   # TODO confirm
    notes: >
      Active Alpen testnet on the Prague EVM hardfork. Underlying chain is a
      custom Bitcoin signet operated by Alpen Labs (10 minute block time,
      single miner). EVM-compatible: any EVM wallet that supports custom
      networks works. ERC-4337 account abstraction is supported.

  - id: alpen-testnet-shanghai
    name: Alpen Testnet (Shanghai)
    status: sunset
    active: false
    spec: shanghai
    chain_id: 2892
    sunset_date: 2025-12-22
    notes: >
      Previous Alpen testnet on the Shanghai EVM hardfork. Sunset on
      2025-12-22 via network regenesis. All state, accounts, and contracts
      were reset when migrating to the Prague-spec testnet (chain 8150).
      Listed here so historical references remain resolvable.

  - id: alpen-mainnet
    name: Alpen Mainnet
    status: upcoming
    active: false
    notes: >
      Mainnet is not live. No dates committed. Details (chain ID, RPC,
      bridge contracts) will be filled in here when launch is confirmed.
