khadhroony-bot3/migration/khadhroony-bot2-reference/docs/SURFACE_CRATE_MATRIX.md

<!-- file: docs/SURFACE_CRATE_MATRIX.md -->
<!-- version: 4 -->

# Matrice des crates réservés

Ce document liste les crates actuellement présents dans le workspace. Un crate réservé ne signifie pas que le décodage, la matérialisation ou l’exécution est validé.

## Principes

- Les surfaces non classifiées ne doivent pas avoir de crate.
- Les décodeurs et exécuteurs sont réservés par surface canonique lorsque la surface est classifiée.
- Les détails de validation restent dans `registry/program_registry_seed.toml` et les docs spécialisées.

## Solana

| Surface       | Décodeur                 | Exécuteur                 |
|---------------|--------------------------|---------------------------|
| `solana_core` | `kb_decoder_solana_core` | `kb_executor_solana_core` |

## Spl

| Surface                        | Décodeur                                  | Exécuteur                                  |
|--------------------------------|-------------------------------------------|--------------------------------------------|
| `spl_account_compression`      | `kb_decoder_spl_account_compression`      | `kb_executor_spl_account_compression`      |
| `spl_associated_token_account` | `kb_decoder_spl_associated_token_account` | `kb_executor_spl_associated_token_account` |
| `spl_memo`                     | `kb_decoder_spl_memo`                     | `kb_executor_spl_memo`                     |
| `spl_name_service`             | `kb_decoder_metadata_spl_name_service`    | `kb_executor_metadata_spl_name_service`    |
| `spl_noop`                     | `kb_decoder_spl_noop`                     | `kb_executor_spl_noop`                     |
| `spl_single_pool`              | `kb_decoder_spl_single_pool`              | `kb_executor_spl_single_pool`              |
| `spl_stake_pool`               | `kb_decoder_spl_stake_pool`               | `kb_executor_spl_stake_pool`               |
| `spl_token`                    | `kb_decoder_spl_token`                    | `kb_executor_spl_token`                    |
| `spl_token_2022`               | `kb_decoder_spl_token_2022`               | `kb_executor_spl_token_2022`               |


## Amm

| Surface                    | Décodeur                              | Exécuteur                              |
|----------------------------|---------------------------------------|----------------------------------------|
| `amm_aldrin_v1`            | `kb_decoder_amm_aldrin_v1`            | `kb_executor_amm_aldrin_v1`            |
| `amm_aldrin_v2`            | `kb_decoder_amm_aldrin_v2`            | `kb_executor_amm_aldrin_v2`            |
| `amm_alphaq`               | `kb_decoder_amm_alphaq`               | `kb_executor_amm_alphaq`               |
| `amm_believe`              | `kb_decoder_amm_believe`              | `kb_executor_amm_believe`              |
| `amm_bonk_swap`            | `kb_decoder_amm_bonk_swap`            | `kb_executor_amm_bonk_swap`            |
| `amm_fluxbeam`             | `kb_decoder_amm_fluxbeam`             | `kb_executor_amm_fluxbeam`             |
| `amm_goon_fi`              | `kb_decoder_amm_goon_fi`              | `kb_executor_amm_goon_fi`              |
| `amm_goosefx_gamma`        | `kb_decoder_amm_goosefx_gamma`        | `kb_executor_amm_goosefx_gamma`        |
| `amm_goosefx_v2`           | `kb_decoder_amm_goosefx_v2`           | `kb_executor_amm_goosefx_v2`           |
| `amm_guac_swap`            | `kb_decoder_amm_guac_swap`            | `kb_executor_amm_guac_swap`            |
| `amm_lifinity_swap_v2`     | `kb_decoder_amm_lifinity_swap_v2`     | `kb_executor_amm_lifinity_swap_v2`     |
| `amm_metadao_futarchy_amm` | `kb_decoder_amm_metadao_futarchy_amm` | `kb_executor_amm_metadao_futarchy_amm` |
| `amm_metadao_v0_5`         | `kb_decoder_amm_metadao_v0_5`         | `kb_executor_amm_metadao_v0_5`         |
| `amm_meteora_damm_v1`      | `kb_decoder_amm_meteora_damm_v1`      | `kb_executor_amm_meteora_damm_v1`      |
| `amm_meteora_damm_v2`      | `kb_decoder_amm_meteora_damm_v2`      | `kb_executor_amm_meteora_damm_v2`      |
| `amm_obric_v2`             | `kb_decoder_amm_obric_v2`             | `kb_executor_amm_obric_v2`             |
| `amm_one_dex`              | `kb_decoder_amm_one_dex`              | `kb_executor_amm_one_dex`              |
| `amm_pump_swap`            | `kb_decoder_amm_pump_swap`            | `kb_executor_amm_pump_swap`            |
| `amm_raydium_lp_v4`        | `kb_decoder_amm_raydium_lp_v4`        | `kb_executor_amm_raydium_lp_v4`        |
| `amm_solfi`                | `kb_decoder_amm_solfi`                | `kb_executor_amm_solfi`                |
| `amm_solfi_v2`             | `kb_decoder_amm_solfi_v2`             | `kb_executor_amm_solfi_v2`             |
| `amm_vertigo`              | `kb_decoder_amm_vertigo`              | `kb_executor_amm_vertigo`              |
| `amm_virtuals`             | `kb_decoder_amm_virtuals`             | `kb_executor_amm_virtuals`             |
| `amm_woofi`                | `kb_decoder_amm_woofi`                | `kb_executor_amm_woofi`                |
| `amm_zero_fi`              | `kb_decoder_amm_zero_fi`              | `kb_executor_amm_zero_fi`              |
| `amm_zora`                 | `kb_decoder_amm_zora`                 | `kb_executor_amm_zora`                 |

## Cpmm

| Surface        | Décodeur                  | Exécuteur                  |
|----------------|---------------------------|----------------------------|
| `cpmm_raydium` | `kb_decoder_cpmm_raydium` | `kb_executor_cpmm_raydium` |

## Clmm

| Surface               | Décodeur                         | Exécuteur                         |
|-----------------------|----------------------------------|-----------------------------------|
| `clmm_byreal`         | `kb_decoder_clmm_byreal`         | `kb_executor_clmm_byreal`         |
| `clmm_fusion`         | `kb_decoder_clmm_fusion`         | `kb_executor_clmm_fusion`         |
| `clmm_orca_whirlpool` | `kb_decoder_clmm_orca_whirlpool` | `kb_executor_clmm_orca_whirlpool` |
| `clmm_pancake_swap`   | `kb_decoder_clmm_pancake_swap`   | `kb_executor_clmm_pancake_swap`   |
| `clmm_raydium`        | `kb_decoder_clmm_raydium`        | `kb_executor_clmm_raydium`        |
| `clmm_stabble`        | `kb_decoder_clmm_stabble`        | `kb_executor_clmm_stabble`        |

## Dlmm

| Surface        | Décodeur                  | Exécuteur                  |
|----------------|---------------------------|----------------------------|
| `dlmm_meteora` | `kb_decoder_dlmm_meteora` | `kb_executor_dlmm_meteora` |

## Stable Swap

| Surface                      | Décodeur                                | Exécuteur                                |
|------------------------------|-----------------------------------------|------------------------------------------|
| `stable_swap_hylo_exchange`  | `kb_decoder_stable_swap_hylo_exchange`  | `kb_executor_stable_swap_hylo_exchange`  |
| `stable_swap_jupiter_stable` | `kb_decoder_stable_swap_jupiter_stable` | `kb_executor_stable_swap_jupiter_stable` |
| `stable_swap_numeraire`      | `kb_decoder_stable_swap_numeraire`      | `kb_executor_stable_swap_numeraire`      |
| `stable_swap_stabble`        | `kb_decoder_stable_swap_stabble`        | `kb_executor_stable_swap_stabble`        |

## Weighted Swap

| Surface                 | Décodeur                           | Exécuteur                           |
|-------------------------|------------------------------------|-------------------------------------|
| `weighted_swap_stabble` | `kb_decoder_weighted_swap_stabble` | `kb_executor_weighted_swap_stabble` |

## Launchpad

| Surface                       | Décodeur                                 | Exécuteur                                 |
|-------------------------------|------------------------------------------|-------------------------------------------|
| `launchpad_boop_fun`          | `kb_decoder_launchpad_boop_fun`          | `kb_executor_launchpad_boop_fun`          |
| `launchpad_metadao_ico`       | `kb_decoder_launchpad_metadao_ico`       | `kb_executor_launchpad_metadao_ico`       |
| `launchpad_meteora_dbc`       | `kb_decoder_launchpad_meteora_dbc`       | `kb_executor_launchpad_meteora_dbc`       |
| `launchpad_moonit`            | `kb_decoder_launchpad_moonit`            | `kb_executor_launchpad_moonit`            |
| `launchpad_orca_wavebreak`    | `kb_decoder_launchpad_orca_wavebreak`    | `kb_executor_launchpad_orca_wavebreak`    |
| `launchpad_printr`            | `kb_decoder_launchpad_printr`            | `kb_executor_launchpad_printr`            |
| `launchpad_pump_fun`          | `kb_decoder_launchpad_pump_fun`          | `kb_executor_launchpad_pump_fun`          |
| `launchpad_pump_pumpup_ai`    | `kb_decoder_launchpad_pump_pumpup_ai`    | `kb_executor_launchpad_pump_pumpup_ai`    |
| `launchpad_raydium_launchlab` | `kb_decoder_launchpad_raydium_launchlab` | `kb_executor_launchpad_raydium_launchlab` |

## Router

| Surface                        | Décodeur                                  | Exécuteur                                  |
|--------------------------------|-------------------------------------------|--------------------------------------------|
| `router_dflow_aggregator_v4`   | `kb_decoder_router_dflow_aggregator_v4`   | `kb_executor_router_dflow_aggregator_v4`   |
| `router_jupiter_aggregator_v4` | `kb_decoder_router_jupiter_aggregator_v4` | `kb_executor_router_jupiter_aggregator_v4` |
| `router_jupiter_aggregator_v6` | `kb_decoder_router_jupiter_aggregator_v6` | `kb_executor_router_jupiter_aggregator_v6` |
| `router_jupiter_dca`           | `kb_decoder_router_jupiter_dca`           | `kb_executor_router_jupiter_dca`           |
| `router_okx_labs_v1`           | `kb_decoder_router_okx_labs_v1`           | `kb_executor_router_okx_labs_v1`           |
| `router_okx_labs_v2`           | `kb_decoder_router_okx_labs_v2`           | `kb_executor_router_okx_labs_v2`           |

## Orderbook

| Surface                            | Décodeur                                      | Exécuteur                                      |
|------------------------------------|-----------------------------------------------|------------------------------------------------|
| `orderbook_jupiter_limit_order`    | `kb_decoder_orderbook_jupiter_limit_order`    | `kb_executor_orderbook_jupiter_limit_order`    |
| `orderbook_jupiter_limit_order_v2` | `kb_decoder_orderbook_jupiter_limit_order_v2` | `kb_executor_orderbook_jupiter_limit_order_v2` |
| `orderbook_openbook_v2`            | `kb_decoder_orderbook_openbook_v2`            | `kb_executor_orderbook_openbook_v2`            |

## Admin

| Surface              | Décodeur                        | Exécuteur                        |
|----------------------|---------------------------------|----------------------------------|
| `admin_jupiter_lock` | `kb_decoder_admin_jupiter_lock` | `kb_executor_admin_jupiter_lock` |
| `admin_pump_fees`    | `kb_decoder_admin_pump_fees`    | `kb_executor_admin_pump_fees`    |

## Fees

| Surface                  | Décodeur                            | Exécuteur                            |
|--------------------------|-------------------------------------|--------------------------------------|
| `fees_bags_fee_share_v1` | `kb_decoder_fees_bags_fee_share_v1` | `kb_executor_fees_bags_fee_share_v1` |
| `fees_bags_fee_share_v2` | `kb_decoder_fees_bags_fee_share_v2` | `kb_executor_fees_bags_fee_share_v2` |

## Lock

| Surface           | Décodeur                     | Exécuteur                     |
|-------------------|------------------------------|-------------------------------|
| `lock_raydium_lp` | `kb_decoder_lock_raydium_lp` | `kb_executor_lock_raydium_lp` |

## Adapter

| Surface                         | Décodeur                                   | Exécuteur                                   |
|---------------------------------|--------------------------------------------|---------------------------------------------|
| `adapter_saber_decimal_wrapper` | `kb_decoder_adapter_saber_decimal_wrapper` | `kb_executor_adapter_saber_decimal_wrapper` |

## Governance

| Surface                       | Décodeur                                 | Exécuteur                                 |
|-------------------------------|------------------------------------------|-------------------------------------------|
| `governance_metadao_bid_wall` | `kb_decoder_governance_metadao_bid_wall` | `kb_executor_governance_metadao_bid_wall` |

## Bridge

| Surface                                        | Décodeur                                                  | Exécuteur                                                  |
|------------------------------------------------|-----------------------------------------------------------|------------------------------------------------------------|
| `bridge_circle_cctp_token_messenger_minter`    | `kb_decoder_bridge_circle_cctp_token_messenger_minter`    | `kb_executor_bridge_circle_cctp_token_messenger_minter`    |
| `bridge_circle_cctp_token_messenger_minter_v2` | `kb_decoder_bridge_circle_cctp_token_messenger_minter_v2` | `kb_executor_bridge_circle_cctp_token_messenger_minter_v2` |
| `bridge_layer_zero_endpoint`                   | `kb_decoder_bridge_layer_zero_endpoint`                   | `kb_executor_bridge_layer_zero_endpoint`                   |
| `bridge_layer_zero_executor`                   | `kb_decoder_bridge_layer_zero_executor`                   | `kb_executor_bridge_layer_zero_executor`                   |

## Rwa

| Surface                   | Décodeur                             | Exécuteur                             |
|---------------------------|--------------------------------------|---------------------------------------|
| `rwa_ondo_global_markets` | `kb_decoder_rwa_ondo_global_markets` | `kb_executor_rwa_ondo_global_markets` |

## Lending

| Surface                           | Décodeur                                     | Exécuteur                                     |
|-----------------------------------|----------------------------------------------|-----------------------------------------------|
| `lending_clone`                   | `kb_decoder_lending_clone`                   | `kb_executor_lending_clone`                   |
| `lending_jupiter_lend_borrow`     | `kb_decoder_lending_jupiter_lend_borrow`     | `kb_executor_lending_jupiter_lend_borrow`     |
| `lending_jupiter_lend_earn`       | `kb_decoder_lending_jupiter_lend_earn`       | `kb_executor_lending_jupiter_lend_earn`       |
| `lending_jupiter_lend_flash_loan` | `kb_decoder_lending_jupiter_lend_flash_loan` | `kb_executor_lending_jupiter_lend_flash_loan` |
| `lending_jupiter_lend_liquidity`  | `kb_decoder_lending_jupiter_lend_liquidity`  | `kb_executor_lending_jupiter_lend_liquidity`  |
| `lending_kamino`                  | `kb_decoder_lending_kamino`                  | `kb_executor_lending_kamino`                  |
| `lending_marginfi_v2`             | `kb_decoder_lending_marginfi_v2`             | `kb_executor_lending_marginfi_v2`             |

## Staking

| Surface                    | Décodeur                              | Exécuteur                              |
|----------------------------|---------------------------------------|----------------------------------------|
| `staking_kamino_farm`      | `kb_decoder_staking_kamino_farm`      | `kb_executor_staking_kamino_farm`      |
| `staking_marinade_finance` | `kb_decoder_staking_marinade_finance` | `kb_executor_staking_marinade_finance` |
| `staking_solayer`          | `kb_decoder_staking_solayer`          | `kb_executor_staking_solayer`          |

## Vault

| Surface                     | Décodeur                               | Exécuteur                               |
|-----------------------------|----------------------------------------|-----------------------------------------|
| `vault_carrot_defi`         | `kb_decoder_vault_carrot_defi`         | `kb_executor_vault_carrot_defi`         |
| `vault_hylo_stability_pool` | `kb_decoder_vault_hylo_stability_pool` | `kb_executor_vault_hylo_stability_pool` |
| `vault_kamino`              | `kb_decoder_vault_kamino`              | `kb_executor_vault_kamino`              |
| `vault_kamino_v2`           | `kb_decoder_vault_kamino_v2`           | `kb_executor_vault_kamino_v2`           |
| `vault_kamino_yvaults`      | `kb_decoder_vault_kamino_yvaults`      | `kb_executor_vault_kamino_yvaults`      |
| `vault_meteora`             | `kb_decoder_vault_meteora`             | `kb_executor_vault_meteora`             |

## Vesting

| Surface              | Décodeur                        | Exécuteur                        |
|----------------------|---------------------------------|----------------------------------|
| `vesting_streamflow` | `kb_decoder_vesting_streamflow` | `kb_executor_vesting_streamflow` |

## Nft

| Surface                  | Décodeur                            | Exécuteur                            |
|--------------------------|-------------------------------------|--------------------------------------|
| `nft_metaplex_bubblegum` | `kb_decoder_nft_metaplex_bubblegum` | `kb_executor_nft_metaplex_bubblegum` |

## Treasury

| Surface                               | Décodeur                                         | Exécuteur                                         |
|---------------------------------------|--------------------------------------------------|---------------------------------------------------|
| `treasury_helium_treasury_management` | `kb_decoder_treasury_helium_treasury_management` | `kb_executor_treasury_helium_treasury_management` |

## Wallet

| Surface                              | Décodeur                                        | Exécuteur                                        |
|--------------------------------------|-------------------------------------------------|--------------------------------------------------|
| `wallet_jupiter_apepro_smart_wallet` | `kb_decoder_wallet_jupiter_apepro_smart_wallet` | `kb_executor_wallet_jupiter_apepro_smart_wallet` |

## Perpetuals

| Surface               | Décodeur                         | Exécuteur                         |
|-----------------------|----------------------------------|-----------------------------------|
| `perpetuals_drift_v2` | `kb_decoder_perpetuals_drift_v2` | `kb_executor_perpetuals_drift_v2` |
| `perpetuals_jupiter`  | `kb_decoder_perpetuals_jupiter`  | `kb_executor_perpetuals_jupiter`  |
| `perpetuals_zeta`     | `kb_decoder_perpetuals_zeta`     | `kb_executor_perpetuals_zeta`     |

## Matérialisateurs

| Crate                                 |
|---------------------------------------|
| `kb_materializer_admin`               |
| `kb_materializer_bridge`              |
| `kb_materializer_compliance_audit`    |
| `kb_materializer_fees`                |
| `kb_materializer_governance`          |
| `kb_materializer_lending`             |
| `kb_materializer_lifecycle`           |
| `kb_materializer_liquidity`           |
| `kb_materializer_metadata`            |
| `kb_materializer_nft`                 |
| `kb_materializer_oracle`              |
| `kb_materializer_orderbook`           |
| `kb_materializer_perpetuals`          |
| `kb_materializer_pool_state`          |
| `kb_materializer_rewards`             |
| `kb_materializer_risk`                |
| `kb_materializer_routing`             |
| `kb_materializer_staking`             |
| `kb_materializer_token_accounts`      |
| `kb_materializer_token_metadata_risk` |
| `kb_materializer_trades`              |
| `kb_materializer_vault`               |