fix(starknet_os): fix macro docstring

Author: aner-starkware

crates/starknet_os/src/hints/hint_implementation/syscalls.rs

@@ -1,12 +1,10 @@
 use blockifier::execution::deprecated_syscalls::deprecated_syscall_executor::execute_next_deprecated_syscall;
 use blockifier::execution::deprecated_syscalls::hint_processor::DeprecatedSyscallExecutionError;
 use blockifier::execution::deprecated_syscalls::DeprecatedSyscallSelector;
-use blockifier::execution::execution_utils::felt_from_ptr;
 use blockifier::state::state_api::StateReader;
 use cairo_vm::hint_processor::builtin_hint_processor::hint_utils::get_ptr_from_var_name;
 use paste::paste;
 
-use crate::hints::error::OsHintError::DeprecatedSyscallExecution;
 use crate::hints::error::OsHintResult;
 use crate::hints::types::HintArgs;
 use crate::hints::vars::{Ids, Scope};
@@ -22,11 +20,37 @@ use crate::syscall_handler_utils::SyscallHandlerType;
 /// Expands to:
 ///
 /// pub(crate) fn get_block_number<S: StateReader>(
-/// HintArgs { hint_processor, vm, ids_data, ap_tracking, .. }: HintArgs<'_, '_, S>,
+/// HintArgs { hint_processor, vm, ids_data, ap_tracking, exec_scopes, .. }: HintArgs<'_, '_, S>,
 /// ) -> OsHintResult
 /// {
+///     assert_eq!(
+///         exec_scopes.get(Scope::SyscallHandlerType.into())?,
+///         SyscallHandlerType::DeprecatedSyscallHandler
+///     );
 ///     let syscall_hint_processor = &mut hint_processor.deprecated_syscall_hint_processor;
-///     Ok(execute_next_deprecated_syscall(syscall_hint_processor, vm, ids_data, ap_tracking)?)
+///         let syscall_ptr = get_ptr_from_var_name(
+///         Ids::SyscallPtr.into(), vm, ids_data, ap_tracking)?;
+///         let syscall_selector = DeprecatedSyscallSelector::try_from(
+///         vm.get_integer(syscall_ptr)?.into_owned()
+///     )?;
+///     let expected_selector = paste! { DeprecatedSyscallSelector::[$name:camel] };
+///     if syscall_selector != expected_selector {
+///         return Err(
+///             DeprecatedSyscallExecutionError::BadSyscallSelector {
+///                 expected_selector,
+///                 actual_selector: syscall_selector,
+///             }.into()
+///         );
+///     }
+///     syscall_hint_processor.set_syscall_ptr(syscall_ptr);
+///     Ok(
+///         execute_next_deprecated_syscall(
+///             syscall_hint_processor,
+///             vm,
+///             ids_data,
+///             ap_tracking
+///         )?
+///     )
 /// }
 macro_rules! create_syscall_func {
     ($($name:ident),+) => {
@@ -55,12 +79,10 @@ macro_rules! create_syscall_func {
                 let expected_selector = paste! { DeprecatedSyscallSelector::[<$name:camel>] };
                 if syscall_selector != expected_selector {
                     return Err(
-                        DeprecatedSyscallExecution(
-                            DeprecatedSyscallExecutionError::BadSyscallSelector {
-                                expected_selector,
-                                actual_selector: syscall_selector,
-                            }
-                        )
+                        DeprecatedSyscallExecutionError::BadSyscallSelector {
+                            expected_selector,
+                            actual_selector: syscall_selector,
+                        }.into()
                     );
                 }
                 syscall_hint_processor.set_syscall_ptr(syscall_ptr);