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

thru_base/
lib.rs
