//! @brief Solana Rust-based BPF program logging use crate::account_info::AccountInfo; /// Prints a string /// There are two forms and are fast /// 1. Single string /// 2. 5 integers #[macro_export] macro_rules! info { ($msg:expr) => { $crate::log::sol_log($msg) }; ($arg1:expr, $arg2:expr, $arg3:expr, $arg4:expr, $arg5:expr) => { $crate::log::sol_log_64( $arg1 as u64, $arg2 as u64, $arg3 as u64, $arg4 as u64, $arg5 as u64, ) }; // `format!()` is not supported yet, Issue #3099 // `format!()` incurs a very large runtime overhead so it should be used with care // ($($arg:tt)*) => ($crate::log::sol_log(&format!($($arg)*))); } /// Prints a string to stdout /// /// @param message - Message to print #[cfg(feature = "program")] pub fn sol_log(message: &str) { unsafe { sol_log_(message.as_ptr(), message.len() as u64); } } #[cfg(feature = "program")] extern "C" { fn sol_log_(message: *const u8, length: u64); } #[cfg(not(feature = "program"))] pub fn sol_log(_message: &str) {} /// Prints 64 bit values represented as hexadecimal to stdout /// /// @param argx - integer arguments to print #[cfg(feature = "program")] pub fn sol_log_64(arg1: u64, arg2: u64, arg3: u64, arg4: u64, arg5: u64) { unsafe { sol_log_64_(arg1, arg2, arg3, arg4, arg5); } } #[cfg(feature = "program")] extern "C" { fn sol_log_64_(arg1: u64, arg2: u64, arg3: u64, arg4: u64, arg5: u64); } #[cfg(not(feature = "program"))] pub fn sol_log_64(_arg1: u64, _arg2: u64, _arg3: u64, _arg4: u64, _arg5: u64) {} /// Prints the hexadecimal representation of a slice /// /// @param slice - The array to print #[allow(dead_code)] pub fn sol_log_slice(slice: &[u8]) { for (i, s) in slice.iter().enumerate() { sol_log_64(0, 0, 0, i as u64, u64::from(*s)); } } /// Prints the hexadecimal representation of the program's input parameters /// /// @param ka - A pointer to an array of `AccountInfo` to print /// @param data - A pointer to the instruction data to print #[allow(dead_code)] pub fn sol_log_params(accounts: &[AccountInfo], data: &[u8]) { for (i, account) in accounts.iter().enumerate() { sol_log("AccountInfo"); sol_log_64(0, 0, 0, 0, i as u64); sol_log("- Is signer"); sol_log_64(0, 0, 0, 0, account.is_signer as u64); sol_log("- Key"); account.key.log(); sol_log("- Lamports"); sol_log_64(0, 0, 0, 0, *account.lamports); sol_log("- Account data length"); sol_log_64(0, 0, 0, 0, account.data.len() as u64); sol_log("- Owner"); account.owner.log(); } sol_log("Instruction data"); sol_log_slice(data); }