chore: bump version to 0.3.0

Author: athexweb3

Cargo.lock

@@ -34,6 +34,11 @@ The library strictly adheres to the following standards:
 *   **[Ed25519](https://ed25519.cr.yp.to/)**: High-speed Edwards-curve Digital Signature Algorithm.
 *   **[Base58](https://learn.bybit.com/blockchain/what-is-base58/)**: Standard Solana address encoding.
 
+### TON (The Open Network)
+*   **[V4R2](https://ton.org/docs)**: Standard high-performance wallet contract (Wallet ID `0x29a9a317`).
+*   **[V5R1](https://docs.ton.org/v3/guidelines/smart-contracts/wallet-v5)**: Latest W5 standard (Wallet ID `0x7fffff11`), optimized for gasless operations.
+*   **Smart Addresses**: Generates non-bounceable (UQ) addresses by default, and automatically switches to bounceable (EQ) if the prefix starts with `E`.
+
 ## Architecture
 
 The project employs a specific **Verify-after-Generate** architecture to eliminate single points of failure in the cryptographic logic.
@@ -42,7 +47,7 @@ The project employs a specific **Verify-after-Generate** architecture to elimina
     Using the `rand::OsRng` system entropy source, a 256-bit private key is generated. The corresponding public key and address are derived via RustCrypto or libsecp256k1. This process is parallelized across all logical CPU cores using a work-stealing scheduler (`rayon`).
 
 2.  **Cross-Verification (Python)**:
-    Upon identifying a candidate address matching the user's constraints, the key material is passed to an isolated subprocess. This process invokes reference Python implementations (`eth_account` for Ethereum, `base58`/`bech32` for Bitcoin) to independently re-derive the address from the private key.
+    Upon identifying a candidate address matching the user's constraints, the key material is passed to an isolated subprocess. This process invokes reference Python implementations (`eth_account` for Ethereum, `base58`/`bech32` for Bitcoin, manual derivation for TON) to independently re-derive the address from the private key.
 
 3.  **Validation**:
     The result is presented to the user **if and only if** the Rust-derived address and the Python-derived address are bitwise identical.
@@ -112,13 +117,20 @@ vc --chain bitcoin --btc-type taproot --prefix bc1p
 
 # Solana
 vc --chain solana --prefix abc
+
+# TON (V4R2)
+vc --chain ton --ton-version v4r2 --prefix EQA
+
+# TON (V5R1)
+vc --chain ton --ton-version v5r1 --prefix UQ
 ```
 
 | Argument | Description |
 | :--- | :--- |
-| `--chain <ethereum\|bitcoin\|solana>` | Select the blockchain network (Default: ethereum). |
+| `--chain <ethereum\|bitcoin\|solana\|ton>` | Select the blockchain network (Default: ethereum). |
 | `--prefix <STRING>` | The case-insensitive string to search for. |
 | `--btc-type <legacy\|segwit\|taproot>` | **[Bitcoin]** The address type to generate. |
+| `--ton-version <v4r2\|v5r1>` | **[TON]** The wallet contract version (Default: v4r2). |
 | `--case-sensitive` | Strictly enforce casing (e.g. `DeaD` vs `dead`). |
 | `--threads <N>` | Override thread count (Default: logical core count). |
 | `--no-tui` | Disable the TUI and output only the final result JSON. |
@@ -141,6 +153,10 @@ python3 tests/verify_validate/fuzz_test.py --chain bitcoin --btc-type legacy
 
 # Audit Bitcoin (Taproot/Schnorr)
 python3 tests/verify_validate/fuzz_test.py --chain bitcoin --btc-type taproot
+
+# Audit TON (V4R2 & V5R1)
+python3 tests/verify_validate/fuzz_test.py --chain ton --ton-version v4r2
+python3 tests/verify_validate/fuzz_test.py --chain ton --ton-version v5r1
 ```
 
 ## License

README.md

@@ -4,7 +4,10 @@ use std::sync::Arc;
 use std::{sync::mpsc, thread};
 use vanity_core::VanityGenerator;
 use vanity_ui::{
-    app::{BitcoinType as UiBtcType, Chain as UiChain, Network as UiNetwork},
+    app::{
+        BitcoinType as UiBtcType, Chain as UiChain, Network as UiNetwork,
+        TonVersion as UiTonVersion,
+    },
     run_tui,
 };
 use vanity_wallet::{
@@ -16,6 +19,7 @@ enum Chain {
     Ethereum,
     Bitcoin,
     Solana,
+    Ton,
 }
 
 #[derive(Debug, Clone, ValueEnum)]
@@ -32,12 +36,37 @@ enum BtcType {
     Taproot,
 }
 
+#[derive(Debug, Clone, ValueEnum)]
+enum TonVersion {
+    V4R2,
+    V5R1,
+}
+
+impl From<TonVersion> for vanity_core::TonWalletVersion {
+    fn from(v: TonVersion) -> Self {
+        match v {
+            TonVersion::V4R2 => vanity_core::TonWalletVersion::V4R2,
+            TonVersion::V5R1 => vanity_core::TonWalletVersion::V5R1,
+        }
+    }
+}
+
+impl From<TonVersion> for UiTonVersion {
+    fn from(v: TonVersion) -> Self {
+        match v {
+            TonVersion::V4R2 => UiTonVersion::V4R2,
+            TonVersion::V5R1 => UiTonVersion::V5R1,
+        }
+    }
+}
+
 impl From<Chain> for UiChain {
     fn from(c: Chain) -> Self {
         match c {
             Chain::Ethereum => UiChain::Ethereum,
             Chain::Bitcoin => UiChain::Bitcoin,
             Chain::Solana => UiChain::Solana,
+            Chain::Ton => UiChain::Ton,
         }
     }
 }
@@ -112,6 +141,10 @@ struct Args {
     #[arg(long, value_enum, default_value_t = BtcType::Segwit)]
     btc_type: BtcType,
 
+    /// TON wallet version (only used if chain is ton)
+    #[arg(long, value_enum, default_value_t = TonVersion::V4R2)]
+    ton_version: TonVersion,
+
     /// Prefix must start with this string (e.g., "0xDEAD")
     #[arg(short, long, default_value = "")]
     prefix: String,
@@ -168,7 +201,8 @@ fn main() {
                                 p_case: bool,
                                 p_chain: UiChain,
                                 p_network: UiNetwork,
-                                p_btc_type: UiBtcType| {
+                                p_btc_type: UiBtcType,
+                                p_ton_version: UiTonVersion| {
         let p_prefix = if let Some(stripped) = p_prefix.strip_prefix("0x") {
             stripped.to_string()
         } else {
@@ -177,6 +211,7 @@ fn main() {
 
         let my_attempts = attempts_clone.clone();
         let my_tx = tx.clone();
+        // capture cli_ton_version only needed if not passed, but we pass it now.
 
         thread::spawn(move || {
             let (pk, addr) = match p_chain {
@@ -197,6 +232,18 @@ fn main() {
                     let gen = SolanaVanityGenerator::new(&p_prefix, &p_suffix, p_case);
                     gen.search(Some(my_attempts))
                 }
+                UiChain::Ton => {
+                    // Convert UiTonVersion to CoreVersion manually
+                    let core_version: vanity_core::TonWalletVersion = p_ton_version.into();
+
+                    let gen = vanity_wallet::TonVanityGenerator::new(
+                        &p_prefix,
+                        &p_suffix,
+                        p_case,
+                        core_version,
+                    );
+                    gen.search(Some(my_attempts))
+                }
             };
 
             // Send tuple (Address, PrivateKey) as strings
@@ -218,6 +265,7 @@ fn main() {
         let ui_chain: UiChain = cli_chain.into();
         let ui_network: UiNetwork = cli_network.into();
         let ui_btc_type: UiBtcType = cli_btc_type.into();
+        let ui_ton_version: UiTonVersion = args.ton_version.clone().into();
 
         // Spawn search thread directly
         on_search_start(
@@ -227,13 +275,14 @@ fn main() {
             ui_chain,
             ui_network,
             ui_btc_type,
+            ui_ton_version,
         );
 
         // Simple loop waiting for result
         loop {
             if let Ok(res) = rx.try_recv() {
                 println!("\nAddress: {}\nPrivate Key: {}", res.0, res.1);
-                run_verification(&res.1);
+                run_verification(&res.1, &format!("{:?}", args.chain).to_lowercase());
                 break;
             }
             std::thread::sleep(std::time::Duration::from_millis(100));
@@ -256,6 +305,7 @@ fn main() {
         let initial_ui_chain: UiChain = cli_chain.into();
         let initial_ui_network: UiNetwork = cli_network.into();
         let initial_ui_btc_type: UiBtcType = cli_btc_type.into();
+        let initial_ui_ton_version: UiTonVersion = args.ton_version.clone().into();
 
         if start_immediately {
             on_search_start(
@@ -265,6 +315,7 @@ fn main() {
                 initial_ui_chain,
                 initial_ui_network,
                 initial_ui_btc_type,
+                initial_ui_ton_version,
             );
         }
 
@@ -278,6 +329,7 @@ fn main() {
             initial_ui_chain,
             initial_ui_network,
             initial_ui_btc_type,
+            initial_ui_ton_version,
             on_search_start,
         ) {
             Ok(res) => res,
@@ -287,13 +339,14 @@ fn main() {
             }
         };
 
-        if let Some((_, pk)) = result {
-            run_verification(&pk);
+        if let Some((_, pk, chain)) = result {
+            // TUI now returns the selected chain, so we use it for verification.
+            run_verification(&pk, &format!("{:?}", chain).to_lowercase());
         }
     }
 }
 
-fn run_verification(pk: &str) {
+fn run_verification(pk: &str, chain: &str) {
     // Check if python3 is available
     use std::process::Command;
 
@@ -318,7 +371,11 @@ fn run_verification(pk: &str) {
         system_python
     };
 
-    let output = Command::new(python_cmd).arg(script_path).arg(pk).output();
+    let output = Command::new(python_cmd)
+        .arg(script_path)
+        .arg(pk)
+        .arg(chain)
+        .output();
 
     match output {
         Ok(out) => {
@@ -347,6 +404,12 @@ fn run_batch_generation(count: u64, args: &Args) {
             Box::new(BitcoinVanityGenerator::new("", "", false, net, t))
         }
         Chain::Solana => Box::new(SolanaVanityGenerator::new("", "", false)), // No prefix/suffix for batch random
+        Chain::Ton => Box::new(vanity_wallet::TonVanityGenerator::new(
+            "",
+            "",
+            false,
+            args.ton_version.clone().into(),
+        )),
     };
 
     for _ in 0..count {

crates/cli/src/main.rs

@@ -8,11 +8,13 @@ Usage: vc [OPTIONS]
 
 Options:
       --chain <CHAIN>
-          Blockchain to generate address for [default: ethereum] [possible values: ethereum, bitcoin, solana]
+          Blockchain to generate address for [default: ethereum] [possible values: ethereum, bitcoin, solana, ton]
       --network <NETWORK>
           Network (mainnet, testnet, regtest) [default: mainnet] [possible values: mainnet, testnet, regtest]
       --btc-type <BTC_TYPE>
           Bitcoin address type (only used if chain is bitcoin) [default: segwit] [possible values: legacy, segwit, taproot]
+      --ton-version <TON_VERSION>
+          TON wallet version (only used if chain is ton) [default: v4r2] [possible values: v4r2, v5r1]
   -p, --prefix <PREFIX>
           Prefix must start with this string (e.g., "0xDEAD") [default: ]
   -s, --suffix <SUFFIX>

crates/cli/tests/snapshots/integration__help_snapshot.snap

@@ -5,4 +5,4 @@ pub mod types;
 
 pub use error::CoreError;
 pub use traits::VanityGenerator;
-pub use types::{Address, PrivateKey};
+pub use types::{Address, PrivateKey, TonWalletVersion};