logos-blockchain · 0x-r4bbit · Aug 26, 2026 · Aug 25, 2026
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Overview
 
-This repo contains essential programs for the **Logos Execution Zone (LEZ)** — a zkVM-based execution environment built on [RISC Zero](https://risczero.com/). Programs run inside the RISC Zero zkVM (`riscv32im-risc0-zkvm-elf` target) and interact with the LEZ runtime via the `nssa_core` library from `logos-execution-zone`.
+This repo contains essential programs for the **Logos Execution Zone (LEZ)** — a zkVM-based execution environment built on [RISC Zero](https://risczero.com/). Programs run inside the RISC Zero zkVM (`riscv32im-risc0-zkvm-elf` target) and interact with the LEZ runtime via the `lee_core` library from `logos-execution-zone`.
 
 Five programs are implemented:
 - **token** — Fungible and non-fungible token program (create, mint, burn, transfer, print NFTs)
@@ -81,7 +81,7 @@ Generated IDL files live in `artifacts/`. CI checks that every program under `*/
 
 ## Deployment
 
-`wallet` and `spel` are CLI tools that ship with the [SPEL](https://github.com/logos-co/spel.git) toolchain. `wallet` requires `NSSA_WALLET_HOME_DIR` to point to a directory containing the wallet config.
+`wallet` and `spel` are CLI tools that ship with the [SPEL](https://github.com/logos-co/spel.git) toolchain. `wallet` requires `LEE_WALLET_HOME_DIR` to point to a directory containing the wallet config.
 
 **Note:** `spel` and `wallet` may use different versions of the wallet package. If `spel --idl <IDL> <PROGRAM_FUNCTION> ...` fails, ensure `seq_poll_timeout_millis` is set in the wallet config at `~/.nssa/wallet`.
 

diff --git a/Cargo.toml b/Cargo.toml
@@ -34,8 +34,8 @@ exclude = [
 resolver = "2"
 
 [workspace.dependencies]
-nssa_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["host"], package = "lee_core" }
-nssa = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["test-utils"], package = "lee" }
+lee_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["host"] }
+lee = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["test-utils"] }
 token_core = { path = "programs/token/core" }
 token_program = { path = "programs/token" }
 amm_core = { path = "programs/amm/core" }

diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # lez-programs
 
-Essential programs for the **Logos Execution Zone (LEZ)** — a zkVM-based execution environment built on [RISC Zero](https://risczero.com/). Programs run inside the RISC Zero zkVM (`riscv32im-risc0-zkvm-elf` target) and interact with the LEZ runtime via the `nssa_core` library.
+Essential programs for the **Logos Execution Zone (LEZ)** — a zkVM-based execution environment built on [RISC Zero](https://risczero.com/). Programs run inside the RISC Zero zkVM (`riscv32im-risc0-zkvm-elf` target) and interact with the LEZ runtime via the `lee_core` library.
 
 ## Programs
 

diff --git a/apps/amm/tests/custom-token.mjs b/apps/amm/tests/custom-token.mjs
@@ -80,7 +80,7 @@ async function saveShot(app, name) {
 function resolveTokenD() {
   const out = execFileSync("wallet", ["account", "id", "--account-id", "token-d-def"], {
     encoding: "utf8",
-    env: { ...process.env, LEE_WALLET_HOME_DIR: WALLET_HOME, NSSA_WALLET_HOME_DIR: WALLET_HOME },
+    env: { ...process.env, LEE_WALLET_HOME_DIR: WALLET_HOME },
   });
   const id = (out.match(/[1-9A-HJ-NP-Za-km-z]{32,44}/) || [])[0];
   if (!id)

diff --git a/apps/amm/tests/testnet/setup-amm-testnet.sh b/apps/amm/tests/testnet/setup-amm-testnet.sh
@@ -51,12 +51,10 @@ cd "$REPO_ROOT"
 # TEST WALLET — isolated + deterministic
 ###############################################################################
 
-# Dedicated wallet home for tests. Kept out of git (see .gitignore). Exported
-# under both env var names so whichever the installed `wallet`/`spel` expects is
-# satisfied (the current wallet uses LEE_WALLET_HOME_DIR).
+# Dedicated wallet home for tests. Kept out of git (see .gitignore). The v0.2.x
+# wallet/spel read LEE_WALLET_HOME_DIR (the old NSSA_WALLET_HOME_DIR is unused).
 TEST_WALLET_HOME="${TEST_WALLET_HOME:-$SCRIPT_DIR/.wallet}"
 export LEE_WALLET_HOME_DIR="$TEST_WALLET_HOME"
-export NSSA_WALLET_HOME_DIR="$TEST_WALLET_HOME"
 
 # The deterministic test seed. A wallet restored from this mnemonic yields the
 # same account ids every time, which is why they can be shared/pinned.

diff --git a/apps/token/tests/run-basecamp-e2e.sh b/apps/token/tests/run-basecamp-e2e.sh
@@ -67,7 +67,6 @@ QT_FORCE_STDERR_LOGGING=1 \
 QML_DISABLE_DISK_CACHE=1 \
 QML_INSPECTOR_PORT="${inspector_port}" \
 LEE_WALLET_HOME_DIR="${wallet_home}" \
-NSSA_WALLET_HOME_DIR="${wallet_home}" \
 LD_LIBRARY_PATH="${bundle_root}/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}" \
 "${basecamp_bin}" --user-dir "${run_root}/user" -platform offscreen \
   >"${run_root}/basecamp.log" 2>&1 &

diff --git a/docs/token/README.md b/docs/token/README.md
@@ -49,8 +49,6 @@ below was exercised with the `spel` CLI **v0.5.0**; where v0.6.0 differs it is c
   ```bash
   export LEE_WALLET_HOME_DIR="$HOME/.lee/wallet"
   ```
-  Older toolchain builds read `NSSA_WALLET_HOME_DIR` instead — set whichever yours expects, and
-  use the **same** one everywhere.
 - Wallet pointed at your sequencer:
   ```bash
   wallet config set sequencer_addr https://testnet.lez.logos.co/

diff --git a/modules/amm/ffi/Cargo.toml b/modules/amm/ffi/Cargo.toml
@@ -12,7 +12,7 @@ amm_core = { workspace = true }
 borsh = { workspace = true }
 clock_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4" }
 hex = "0.4"
-nssa_core = { workspace = true }
+lee_core = { workspace = true }
 risc0-binfmt = { version = "=3.0.4", default-features = false }
 risc0-zkvm = { workspace = true }
 serde = { workspace = true }

diff --git a/modules/amm/ffi/src/account.rs b/modules/amm/ffi/src/account.rs
@@ -1,6 +1,6 @@
 use std::str::FromStr;
 
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountId, Data, Nonce},
     program::ProgramId,
 };

diff --git a/modules/amm/ffi/src/api/config.rs b/modules/amm/ffi/src/api/config.rs
@@ -1,5 +1,5 @@
 use amm_core::{compute_config_pda, AmmConfig};
-use nssa_core::{account::Account, program::ProgramId};
+use lee_core::{account::Account, program::ProgramId};
 use serde_json::{json, Value};
 
 use super::{ConfigAccountRequest, ConfigIdRequest};

diff --git a/modules/amm/ffi/src/api/context.rs b/modules/amm/ffi/src/api/context.rs
@@ -1,6 +1,6 @@
 use std::collections::BTreeSet;
 
-use nssa_core::{account::AccountId, program::ProgramId};
+use lee_core::{account::AccountId, program::ProgramId};
 use serde_json::{json, Value};
 use token_core::TokenDefinition;
 

diff --git a/modules/amm/ffi/src/api/holding.rs b/modules/amm/ffi/src/api/holding.rs
@@ -1,4 +1,4 @@
-use nssa_core::{account::AccountId, program::ProgramId};
+use lee_core::{account::AccountId, program::ProgramId};
 use token_core::TokenHolding;
 
 use crate::account::{decode_account, AccountRead};

diff --git a/modules/amm/ffi/src/api/liquidity.rs b/modules/amm/ffi/src/api/liquidity.rs
@@ -15,7 +15,7 @@ use amm_core::{
     isqrt_product, mul_div_floor, spot_price_q64_64, PoolDefinition, FEE_BPS_DENOMINATOR,
     MINIMUM_LIQUIDITY,
 };
-use nssa_core::account::AccountId;
+use lee_core::account::AccountId;
 use serde_json::{json, Value};
 
 use super::{
@@ -633,7 +633,7 @@ pub(super) fn sync_reserves_plan(request: SyncReservesPlanRequest) -> Result<Val
 #[cfg(test)]
 mod tests {
     use amm_core::{compute_config_pda, compute_pool_pda, compute_vault_pda, AmmConfig};
-    use nssa_core::account::{Account, AccountId, Data};
+    use lee_core::account::{Account, AccountId, Data};
 
     use super::*;
     use crate::account::{account_read, AccountRead};
@@ -657,7 +657,7 @@ mod tests {
     }
 
     /// A valid AMM config account read so `derive_pair` succeeds in plan tests.
-    fn valid_config(amm: nssa_core::program::ProgramId) -> AccountRead {
+    fn valid_config(amm: lee_core::program::ProgramId) -> AccountRead {
         let token_program = parse_program_id(&"01".repeat(32)).unwrap();
         let twap_program = parse_program_id(&"02".repeat(32)).unwrap();
         let account = Account {

diff --git a/modules/amm/ffi/src/api/oracle.rs b/modules/amm/ffi/src/api/oracle.rs
@@ -1,5 +1,5 @@
 use amm_core::Instruction;
-use nssa_core::account::AccountId;
+use lee_core::account::AccountId;
 use serde_json::{json, Value};
 use twap_oracle_core::{compute_oracle_price_account_pda, compute_price_observations_pda};
 

diff --git a/modules/amm/ffi/src/api/pair.rs b/modules/amm/ffi/src/api/pair.rs
@@ -3,7 +3,7 @@ use amm_core::{
     compute_vault_pda,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{account::AccountId, program::ProgramId};
+use lee_core::{account::AccountId, program::ProgramId};
 use serde_json::{json, Value};
 use twap_oracle_core::compute_current_tick_account_pda;
 

diff --git a/modules/amm/ffi/src/api/swap.rs b/modules/amm/ffi/src/api/swap.rs
@@ -7,7 +7,7 @@ use amm_core::{
     compute_pool_pda, mul_div_ceil, mul_div_floor, price_impact_bps, swap_exact_in_amounts,
     swap_exact_out_amounts, PoolDefinition, FEE_BPS_DENOMINATOR,
 };
-use nssa_core::account::AccountId;
+use lee_core::account::AccountId;
 use risc0_binfmt::ProgramBinary;
 use serde_json::{json, Value};
 
@@ -429,7 +429,7 @@ pub(super) fn swap_exact_out_plan(request: SwapExactOutPlanRequest) -> Result<Va
 pub(super) fn program_id(request: ProgramIdRequest) -> Result<Value, String> {
     let elf = hex::decode(&request.elf).map_err(|error| format!("invalid elf hex: {error}"))?;
     let binary = ProgramBinary::decode(&elf).map_err(|error| format!("{error:?}"))?;
-    let image_id: nssa_core::program::ProgramId = binary
+    let image_id: lee_core::program::ProgramId = binary
         .compute_image_id()
         .map_err(|error| format!("{error:?}"))?
         .into();
@@ -439,7 +439,7 @@ pub(super) fn program_id(request: ProgramIdRequest) -> Result<Value, String> {
 #[cfg(test)]
 mod tests {
     use amm_core::PoolDefinition;
-    use nssa_core::account::AccountId;
+    use lee_core::account::AccountId;
 
     use super::*;
     use crate::account::{AccountRead, WalletAccount};

diff --git a/modules/amm/ffi/src/api/tests.rs b/modules/amm/ffi/src/api/tests.rs
@@ -4,7 +4,7 @@ use amm_core::{
     compute_vault_pda, isqrt_product, AmmConfig, Instruction, PoolDefinition, MINIMUM_LIQUIDITY,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountId, Data, Nonce},
     program::ProgramId,
 };

diff --git a/modules/amm/ffi/src/api/token_holdings.rs b/modules/amm/ffi/src/api/token_holdings.rs
@@ -40,7 +40,7 @@ pub(super) fn token_holdings(request: TokenHoldingsRequest) -> Result<Value, Str
 #[cfg(test)]
 mod tests {
     use amm_core::{compute_config_pda, AmmConfig};
-    use nssa_core::{
+    use lee_core::{
         account::{Account, AccountId, Data},
         program::ProgramId,
     };

diff --git a/modules/token/ffi/Cargo.toml b/modules/token/ffi/Cargo.toml
@@ -8,7 +8,7 @@ crate-type = ["cdylib", "rlib"]
 
 [dependencies]
 hex = "0.4"
-nssa_core = { workspace = true }
+lee_core = { workspace = true }
 risc0-binfmt = { version = "=3.0.4", default-features = false }
 risc0-zkvm = { workspace = true }
 serde = { workspace = true }

diff --git a/modules/token/ffi/src/account.rs b/modules/token/ffi/src/account.rs
@@ -1,4 +1,4 @@
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountId, Data, Nonce},
     program::ProgramId,
 };

diff --git a/modules/token/ffi/src/api/decode.rs b/modules/token/ffi/src/api/decode.rs
@@ -1,4 +1,4 @@
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountId},
     program::ProgramId,
 };

diff --git a/modules/token/ffi/src/api/mod.rs b/modules/token/ffi/src/api/mod.rs
@@ -54,6 +54,6 @@ impl fmt::Display for TokenApiError {
 
 impl Error for TokenApiError {}
 
-fn parse_token_program_id(value: &str) -> Result<nssa_core::program::ProgramId, TokenApiError> {
+fn parse_token_program_id(value: &str) -> Result<lee_core::program::ProgramId, TokenApiError> {
     parse_program_id(value).map_err(|_| TokenApiError::new("bad_request"))
 }
diff --git a/modules/token/ffi/src/api/plan.rs b/modules/token/ffi/src/api/plan.rs
@@ -1,4 +1,4 @@
-use nssa_core::account::AccountId;
+use lee_core::account::AccountId;
 use risc0_binfmt::ProgramBinary;
 use serde_json::{json, Value};
 use token_core::{Instruction, MetadataStandard, NewTokenDefinition, NewTokenMetadata};
@@ -18,7 +18,7 @@ use crate::account::{account_id_from_hex, account_id_hex, program_id_bytes};
 pub fn program_id(request: ProgramIdRequest) -> TokenResult {
     let elf = hex::decode(&request.elf).map_err(|_| TokenApiError::new("bad_request"))?;
     let binary = ProgramBinary::decode(&elf).map_err(|_| TokenApiError::new("bad_request"))?;
-    let image_id: nssa_core::program::ProgramId = binary
+    let image_id: lee_core::program::ProgramId = binary
         .compute_image_id()
         .map_err(|_| TokenApiError::new("backend_error"))?
         .into();
@@ -298,7 +298,7 @@ fn reject_zero_account_id(account_id: AccountId, code: &'static str) -> Result<(
 }
 
 fn plan_response<const N: usize>(
-    program_id: nssa_core::program::ProgramId,
+    program_id: lee_core::program::ProgramId,
     account_ids: [AccountId; N],
     signing_requirements: [bool; N],
     instruction: Instruction,

diff --git a/modules/token/ffi/src/api/tests.rs b/modules/token/ffi/src/api/tests.rs
@@ -1,4 +1,4 @@
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountId, Data, Nonce},
     program::ProgramId,
 };

diff --git a/programs/amm/Cargo.toml b/programs/amm/Cargo.toml
@@ -7,7 +7,7 @@ edition = "2021"
 workspace = true
 
 [dependencies]
-nssa_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["host"], package = "lee_core" }
+lee_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["host"] }
 clock_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4" }
 amm_core = { path = "core" }
 token_core = { path = "../token/core" }

diff --git a/programs/amm/core/Cargo.toml b/programs/amm/core/Cargo.toml
@@ -7,7 +7,7 @@ edition = "2021"
 workspace = true
 
 [dependencies]
-nssa_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["host"], package = "lee_core" }
+lee_core = { git = "https://github.com/logos-blockchain/logos-execution-zone.git", tag = "v0.2.4", features = ["host"] }
 spel-framework-macros = { git = "https://github.com/logos-co/spel.git", rev = "1ef0500f8fc8ce3ddf95523726ae159db83f744f", package = "spel-framework-macros" }
 token_core = { path = "../../token/core" }
 borsh = { version = "1.5", features = ["derive"] }

diff --git a/programs/amm/core/src/lib.rs b/programs/amm/core/src/lib.rs
@@ -1,7 +1,7 @@
 //! This crate contains core data structures and utilities for the AMM Program.
 
 use borsh::{BorshDeserialize, BorshSerialize};
-use nssa_core::{
+use lee_core::{
     account::{AccountId, AccountWithMetadata, Data},
     program::{PdaSeed, ProgramId},
 };

diff --git a/programs/amm/examples/amm_pdas.rs b/programs/amm/examples/amm_pdas.rs
@@ -13,7 +13,7 @@ use amm_core::{
     compute_config_pda, compute_liquidity_token_pda, compute_lp_lock_holding_pda, compute_pool_pda,
     compute_vault_pda,
 };
-use nssa_core::{account::AccountId, program::ProgramId};
+use lee_core::{account::AccountId, program::ProgramId};
 use twap_oracle_core::compute_current_tick_account_pda;
 
 // Accepts a ProgramId as 8 comma-separated u32 limbs, a 64-char ImageID hex, or a base58

diff --git a/programs/amm/src/add.rs b/programs/amm/src/add.rs
@@ -6,7 +6,7 @@ use amm_core::{
     AmmConfig, PoolDefinition,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{AccountWithMetadata, Data},
     program::{AccountPostState, ChainedCall, ProgramId},
 };

diff --git a/programs/amm/src/create_oracle_price_account.rs b/programs/amm/src/create_oracle_price_account.rs
@@ -3,7 +3,7 @@ use amm_core::{
     PoolDefinition,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountWithMetadata},
     program::{AccountPostState, ChainedCall, ProgramId},
 };
@@ -152,7 +152,7 @@ pub fn create_oracle_price_account(
 #[cfg(test)]
 mod tests {
     use amm_core::compute_pool_pda_seed;
-    use nssa_core::account::{Account, AccountId, Data, Nonce};
+    use lee_core::account::{Account, AccountId, Data, Nonce};
 
     use super::*;
 

diff --git a/programs/amm/src/create_price_observations.rs b/programs/amm/src/create_price_observations.rs
@@ -2,7 +2,7 @@ use amm_core::{
     compute_config_pda, compute_pool_pda, compute_pool_pda_seed, AmmConfig, PoolDefinition,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountWithMetadata},
     program::{AccountPostState, ChainedCall, ProgramId},
 };
@@ -134,7 +134,7 @@ pub fn create_price_observations(
 #[cfg(test)]
 mod tests {
     use amm_core::compute_pool_pda_seed;
-    use nssa_core::account::{Account, AccountId, Data, Nonce};
+    use lee_core::account::{Account, AccountId, Data, Nonce};
     use twap_oracle_core::compute_current_tick_account_pda;
 
     use super::*;

diff --git a/programs/amm/src/initialize.rs b/programs/amm/src/initialize.rs
@@ -1,5 +1,5 @@
 use amm_core::{compute_config_pda, compute_config_pda_seed, AmmConfig};
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountId, AccountWithMetadata, Data},
     program::{AccountPostState, Claim, ProgramId},
 };
@@ -51,7 +51,7 @@ pub fn initialize(
 #[cfg(test)]
 mod tests {
     use amm_core::compute_config_pda;
-    use nssa_core::account::{AccountId, Nonce};
+    use lee_core::account::{AccountId, Nonce};
 
     use super::*;
 

diff --git a/programs/amm/src/new_definition.rs b/programs/amm/src/new_definition.rs
@@ -8,7 +8,7 @@ use amm_core::{
     MINIMUM_LIQUIDITY,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{Account, AccountWithMetadata, Data},
     program::{AccountPostState, ChainedCall, Claim, ProgramId},
 };

diff --git a/programs/amm/src/remove.rs b/programs/amm/src/remove.rs
@@ -6,7 +6,7 @@ use amm_core::{
     PoolDefinition, MINIMUM_LIQUIDITY,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{AccountWithMetadata, Data},
     program::{AccountPostState, ChainedCall, ProgramId},
 };

diff --git a/programs/amm/src/swap.rs b/programs/amm/src/swap.rs
@@ -5,7 +5,7 @@ use amm_core::{
 };
 pub use amm_core::{compute_liquidity_token_pda_seed, compute_vault_pda_seed, PoolDefinition};
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{AccountId, AccountWithMetadata, Data},
     program::{AccountPostState, ChainedCall, ProgramId},
 };

diff --git a/programs/amm/src/sync.rs b/programs/amm/src/sync.rs
@@ -3,7 +3,7 @@ use amm_core::{
     read_vault_fungible_balances, spot_price_q64_64, AmmConfig, PoolDefinition, MINIMUM_LIQUIDITY,
 };
 use clock_core::CLOCK_01_PROGRAM_ACCOUNT_ID;
-use nssa_core::{
+use lee_core::{
     account::{AccountWithMetadata, Data},
     program::{AccountPostState, ChainedCall, ProgramId},
 };