{
  "file": "docs/NATIVE_SOLANA_DECODER_MATRIX.json",
  "version": 1,
  "release": "0.4.2-pre.023",
  "surface_count": 18,
  "coverage_entry_count": 121,
  "registry_contract": "Exact equality with kb_program_ids::native_program_ids and SolanaCoreDecoder::surfaces",
  "completeness_contract": "Each surface has exact declared coverage count plus a dedicated official-enum or audited-wire completeness test",
  "surfaces": [
    {
      "surface_code": "solana_native_address_lookup_table",
      "program_id": "AddressLookupTab1e1111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 5,
      "source_contract": "solana-address-lookup-table-interface@3.1.x official instruction enum",
      "completeness_test": "address_lookup_table::tests::coverage_uses_official_encoder_discriminants"
    },
    {
      "surface_code": "solana_native_bpf_loader_deprecated",
      "program_id": "BPFLoader1111111111111111111111111111111111",
      "runtime_status": "historical",
      "expected_coverage_entries": 2,
      "source_contract": "solana-loader-v2-interface@3.0.0 immutable write/finalize layout",
      "completeness_test": "loaders::tests::coverage_declares_every_loader_entry"
    },
    {
      "surface_code": "solana_native_bpf_loader",
      "program_id": "BPFLoader2111111111111111111111111111111111",
      "runtime_status": "historical",
      "expected_coverage_entries": 2,
      "source_contract": "solana-loader-v2-interface@3.0.0 immutable write/finalize layout",
      "completeness_test": "loaders::tests::coverage_declares_every_loader_entry"
    },
    {
      "surface_code": "solana_native_bpf_loader_upgradeable",
      "program_id": "BPFLoaderUpgradeab1e11111111111111111111111",
      "runtime_status": "current_with_historical_variants",
      "expected_coverage_entries": 8,
      "source_contract": "solana-loader-v3-interface@8.0.1 with wincode exact wire layout",
      "completeness_test": "loaders::tests::coverage_declares_every_loader_entry"
    },
    {
      "surface_code": "solana_native_compute_budget",
      "program_id": "ComputeBudget111111111111111111111111111111",
      "runtime_status": "current_with_historical_variants",
      "expected_coverage_entries": 6,
      "source_contract": "solana-compute-budget-interface@3.0.0 plus historical RequestUnitsDeprecated",
      "completeness_test": "compute_budget::tests::coverage_declares_current_and_historical_entries"
    },
    {
      "surface_code": "solana_native_config",
      "program_id": "Config1111111111111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 1,
      "source_contract": "solana-config-interface@2.0.0 generic bounded store contract",
      "completeness_test": "config::tests::coverage_declares_one_generic_store_surface"
    },
    {
      "surface_code": "solana_native_ed25519",
      "program_id": "Ed25519SigVerify111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 1,
      "source_contract": "Agave Ed25519 precompile exact offset-table layout",
      "completeness_test": "precompiles::tests::coverage_declares_exactly_three_signature_precompile_surfaces"
    },
    {
      "surface_code": "solana_native_feature",
      "program_id": "Feature111111111111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 1,
      "source_contract": "solana-feature-gate-interface revoke-pending-activation instruction contract",
      "completeness_test": "feature::tests::coverage_declares_the_single_official_instruction"
    },
    {
      "surface_code": "solana_native_loader_v4",
      "program_id": "LoaderV411111111111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 7,
      "source_contract": "solana-loader-v4-interface@3.1.0 official instruction enum",
      "completeness_test": "loaders::tests::coverage_declares_every_loader_entry"
    },
    {
      "surface_code": "solana_native_loader",
      "program_id": "NativeLoader1111111111111111111111111111111",
      "runtime_status": "runtime_dispatch",
      "expected_coverage_entries": 1,
      "source_contract": "Agave native-loader runtime direct-invocation behavior",
      "completeness_test": "loaders::tests::coverage_declares_every_loader_entry"
    },
    {
      "surface_code": "solana_native_secp256k1",
      "program_id": "KeccakSecp256k11111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 1,
      "source_contract": "Agave secp256k1 precompile exact offset-table layout",
      "completeness_test": "precompiles::tests::coverage_declares_exactly_three_signature_precompile_surfaces"
    },
    {
      "surface_code": "solana_native_secp256r1",
      "program_id": "Secp256r1SigVerify1111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 1,
      "source_contract": "Agave secp256r1 precompile exact offset-table layout",
      "completeness_test": "precompiles::tests::coverage_declares_exactly_three_signature_precompile_surfaces"
    },
    {
      "surface_code": "solana_native_slashing",
      "program_id": "S1ashing11111111111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 2,
      "source_contract": "SIMD-0204 and Agave Slashing builtin instruction contract",
      "completeness_test": "slashing::tests::coverage_declares_exactly_two_official_instructions"
    },
    {
      "surface_code": "solana_native_stake",
      "program_id": "Stake11111111111111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 18,
      "source_contract": "solana-stake-interface@4.3.x official StakeInstruction variants",
      "completeness_test": "stake::tests::coverage_declares_every_official_stake_instruction"
    },
    {
      "surface_code": "solana_native_system",
      "program_id": "11111111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 14,
      "source_contract": "solana-system-interface@3.2.x official SystemInstruction variants",
      "completeness_test": "system::tests::coverage_declares_all_current_system_variants"
    },
    {
      "surface_code": "solana_native_vote",
      "program_id": "Vote111111111111111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 20,
      "source_contract": "solana-vote-interface@6.0.x official VoteInstruction variants",
      "completeness_test": "vote::tests::coverage_declares_every_official_vote_instruction"
    },
    {
      "surface_code": "solana_native_zk_elgamal_proof",
      "program_id": "ZkE1Gama1Proof11111111111111111111111111111",
      "runtime_status": "current",
      "expected_coverage_entries": 13,
      "source_contract": "solana-zk-elgamal-proof-interface official ProofInstruction variants",
      "completeness_test": "zk_elgamal::tests::coverage_declares_all_thirteen_official_instructions"
    },
    {
      "surface_code": "solana_native_zk_token_proof",
      "program_id": "ZkTokenProof1111111111111111111111111111111",
      "runtime_status": "historical_with_current_noop",
      "expected_coverage_entries": 18,
      "source_contract": "audited historical ZK Token Proof wire table plus current runtime no-op behavior",
      "completeness_test": "zk_token_proof::tests::coverage_declares_seventeen_historical_entries_and_current_noop_fallback"
    }
  ]
}