refactor: move programs into programs and UIs into apps

This refactors the repository structure as it has grown over time.

programs/token/methods/guest/src/bin/token.rs

@@ -0,0 +1,140 @@
+#![cfg_attr(not(test), no_main)]
+
+use spel_framework::prelude::*;
+use spel_framework::context::ProgramContext;
+use nssa_core::account::AccountWithMetadata;
+
+#[cfg(not(test))]
+risc0_zkvm::guest::entry!(main);
+
+#[lez_program(instruction = "token_core::Instruction")]
+mod token {
+    #[expect(
+        unused_imports,
+        reason = "SPEL instruction macro requires importing parent-scope handler types"
+    )]
+    use super::*;
+
+    /// Transfer tokens from sender to recipient.
+    /// Fresh public recipients must be explicitly authorized in the same transaction.
+    #[instruction]
+    pub fn transfer(
+        sender: AccountWithMetadata,
+        recipient: AccountWithMetadata,
+        amount_to_transfer: u128,
+    ) -> SpelResult {
+        Ok(spel_framework::SpelOutput::execute(token_program::transfer::transfer(
+            sender,
+            recipient,
+            amount_to_transfer,
+        ), vec![]))
+    }
+
+    /// Create a new fungible token definition without metadata.
+    /// Definition and holding targets must be uninitialized and authorized.
+    #[instruction]
+    pub fn new_fungible_definition(
+        definition_target_account: AccountWithMetadata,
+        holding_target_account: AccountWithMetadata,
+        name: String,
+        total_supply: u128,
+    ) -> SpelResult {
+        Ok(spel_framework::SpelOutput::execute(
+            token_program::new_definition::new_fungible_definition(
+                definition_target_account,
+                holding_target_account,
+                name,
+                total_supply,
+            ),
+            vec![],
+        ))
+    }
+
+    /// Create a new fungible or non-fungible token definition with metadata.
+    /// Definition, holding, and metadata targets must be uninitialized and authorized.
+    #[expect(
+        clippy::boxed_local,
+        reason = "boxed metadata keeps the instruction argument size bounded on the stack"
+    )]
+    #[instruction]
+    pub fn new_definition_with_metadata(
+        definition_target_account: AccountWithMetadata,
+        holding_target_account: AccountWithMetadata,
+        metadata_target_account: AccountWithMetadata,
+        new_definition: token_core::NewTokenDefinition,
+        metadata: Box<token_core::NewTokenMetadata>,
+    ) -> SpelResult {
+        Ok(spel_framework::SpelOutput::execute(
+            token_program::new_definition::new_definition_with_metadata(
+                definition_target_account,
+                holding_target_account,
+                metadata_target_account,
+                new_definition,
+                *metadata,
+            ),
+            vec![],
+        ))
+    }
+
+    /// Initialize a token holding account for a given token definition.
+    /// The holding target must be uninitialized and authorized.
+    #[instruction]
+    pub fn initialize_account(
+        ctx: ProgramContext,
+        definition_account: AccountWithMetadata,
+        account_to_initialize: AccountWithMetadata,
+    ) -> SpelResult {
+        Ok(spel_framework::SpelOutput::execute(
+            token_program::initialize::initialize_account(
+                definition_account,
+                account_to_initialize,
+                ctx.self_program_id,
+            ),
+            vec![],
+        ))
+    }
+
+    /// Burn tokens from the holder's account.
+    #[instruction]
+    pub fn burn(
+        definition_account: AccountWithMetadata,
+        user_holding_account: AccountWithMetadata,
+        amount_to_burn: u128,
+    ) -> SpelResult {
+        Ok(spel_framework::SpelOutput::execute(token_program::burn::burn(
+            definition_account,
+            user_holding_account,
+            amount_to_burn,
+        ), vec![]))
+    }
+
+    /// Mint new tokens to the holder's account.
+    /// Fresh public holders must be explicitly authorized in the same transaction.
+    #[instruction]
+    pub fn mint(
+        ctx: ProgramContext,
+        definition_account: AccountWithMetadata,
+        user_holding_account: AccountWithMetadata,
+        amount_to_mint: u128,
+    ) -> SpelResult {
+        Ok(spel_framework::SpelOutput::execute(token_program::mint::mint(
+            definition_account,
+            user_holding_account,
+            amount_to_mint,
+            ctx.self_program_id,
+        ), vec![]))
+    }
+
+    /// Print a new NFT from the master copy.
+    /// The printed copy target must be uninitialized and authorized.
+    #[instruction]
+    pub fn print_nft(
+        master_account: AccountWithMetadata,
+        printed_account: AccountWithMetadata,
+    ) -> SpelResult {
+        Ok(spel_framework::SpelOutput::execute(token_program::print_nft::print_nft(
+            master_account,
+            printed_account,
+        ), vec![]))
+    }
+}