thru_base/
lib.rs

1pub mod bintrie;
2pub mod bintrie_error;
3pub mod bintrie_proof;
4pub mod bintrie_types;
5pub mod block_parser;
6pub mod crypto_utils;
7pub mod rpc_types;
8pub mod tn_account;
9pub mod tn_block_packet;
10pub mod tn_public_address;
11pub mod tn_runtime_utils;
12pub mod tn_signature;
13pub mod tn_signature_encoding;
14pub mod tn_state_proof;
15pub mod tn_tools;
16pub mod txn_lib;
17pub mod txn_tools;
18
19#[cfg(test)]
20mod txn_tools_test;
21
22#[cfg(test)]
23mod bintrie_tests;
24
25pub const TN_VM_ERROR_REVERT: i32 = -765; /* TN_RUNTIME_TXN_VM_REVERT fffffd03 */
26pub const TN_VM_ERROR_FEE_PAYER_ACCOUNT_DOES_NOT_EXIST: i32 = -508; /* TN_RUNTIME_TXN_ERR_FEE_PAYER_ACCOUNT_DOES_NOT_EXIST fffffe04 */
27
28pub const TN_EXECUTION_RESULT: u64 = 0xfffffffffffffffc; /* TN_VM_ERR_SIGFAULT  */
29pub const TN_USER_ERROR_CODE_SYSCALL_INSUFFICIENT_BALANCE: u64 = 0xffffffffffffffdc; /* TN_VM_ERR_SYSCALL_INSUFFICIENT_BALANCE */
30
31// re-export types
32pub use bintrie::{BinTrie, BinTriePair};
33pub use tn_state_proof::{StateProof, StateProofBody, StateProofHeader, StateProofType};
34pub use tn_tools::KeyPair;
35pub use tn_tools::Pubkey;
36pub use tn_tools::Signature;
37pub use txn_lib::Transaction;
38pub use txn_tools::TransactionBuilder;
39
40// re-export crypto utilities
41pub use crypto_utils::{derive_manager_program_accounts, derive_uploader_program_accounts};
42
43// re-export public address utilities
44pub use tn_public_address::{
45    create_program_defined_account_address, create_program_defined_account_address_string,
46    pack_seed, tn_pubkey_to_address_string, tn_public_address_decode, tn_public_address_encode,
47};
48
49// re-export runtime utilities
50pub use bintrie_error::BinTrieError;
51pub use bintrie_proof::{NonExistenceProof, Proof};
52pub use bintrie_types::{Hash as BinTrieHash, Pubkey as BinTriePubkey};
53pub use tn_runtime_utils::tn_vm_error_str;
54
55/// Checks if the given byte slice is a valid C-style null-terminated string containing only printable ASCII characters.
56pub fn is_c_printable_ascii_null_terminated(bytes: &[u8]) -> bool {
57    // Must contain at least one null byte
58    let Some(pos) = bytes.iter().position(|&b| b == 0) else {
59        return false;
60    };
61    // All bytes before the first null must be printable ASCII (0x20..=0x7E)
62    for &b in &bytes[..pos] {
63        if !(b >= 0x20 && b <= 0x7E) {
64            return false;
65        }
66    }
67    true
68}
69
70#[cfg(test)]
71mod tests {
72    use super::*;
73
74    #[test]
75    fn test_is_c_printable_ascii_null_terminated() {
76        // Valid cases
77        assert!(is_c_printable_ascii_null_terminated(b"hello\0"));
78        assert!(is_c_printable_ascii_null_terminated(b"!@#$%^&*()_+\0"));
79        assert!(is_c_printable_ascii_null_terminated(b" \0")); // space is printable
80        assert!(is_c_printable_ascii_null_terminated(b"~\0")); // tilde is printable
81        assert!(is_c_printable_ascii_null_terminated(b"\0")); // empty string
82        // Valid: data after null is ignored
83        assert!(is_c_printable_ascii_null_terminated(
84            b"hello\0not_printed\x01\x02"
85        ));
86
87        // Invalid: not null-terminated
88        assert!(!is_c_printable_ascii_null_terminated(b"hello"));
89        // Invalid: contains non-printable ASCII (tab)
90        assert!(!is_c_printable_ascii_null_terminated(b"hel\tlo\0"));
91        // Invalid: contains non-printable ASCII (DEL)
92        assert!(!is_c_printable_ascii_null_terminated(b"hel\x7Flo\0"));
93        // Invalid: empty slice
94        assert!(!is_c_printable_ascii_null_terminated(b""));
95        // Invalid: non-printable before null
96        assert!(!is_c_printable_ascii_null_terminated(b"foo\x19\0"));
97    }
98}
thru_base/lib.rs

thru_base/
lib.rs
