add run_with_libfunc_profile + AotWithProgram variant for ContractExecutor

[avi-starkware]

Summary

Exposes the libfunc-profiling primitives that downstream consumers (e.g. the blockifier in starkware-libs/sequencer) currently maintain locally. The profile-collection pattern is callback-driven so the per-call key (tx hash, etc.) stays out of cairo-native.

Replaces #1599 / #1609.

Changes

• metadata::profiler::Profile is now pub (was a private type alias).
• AotContractExecutor::run_with_libfunc_profile<H, F> (gated on with-libfunc-profiling, in new file src/executor/libfunc_profile.rs) wraps run: allocates a unique trace ID, points the executor's cairo_native__profiler__profile_id symbol at it, drains the resulting Profile after run returns, and hands it to a caller-supplied FnOnce(Profile). A ProfilerGuard restores the previous trace ID and drops the LIBFUNC_PROFILE slot on both the success and unwind paths.
• ContractExecutor::AotWithProgram(AotWithProgram { executor, program }) is a new variant that bundles an AOT executor with the Sierra program it was built from. From<AotWithProgram> is provided.
• ContractExecutor::run dispatches the new variant via run_with_libfunc_profile with a no-op profile callback.
• ContractExecutor::run_with_profile<H, F> is the profile-capturing counterpart of run; for non-AotWithProgram variants it falls through to run (callback never fires).

Stack

1. align sierra-emu StarknetSyscallHandler trait/types with cairo-native #1610 — trait alignment
2. extract shared cairo-native-syscalls crate #1611 — extract shared crate
3. add ContractExecutor dispatch enum (Aot + Emu) #1612 — ContractExecutor (supersedes add ContractExecutor dispatch enum (Aot + Emu) #1598 / add ContractExecutor dispatch enum (Aot + Emu) #1608)
4. this PR — run_with_libfunc_profile + AotWithProgram (supersedes add run_with_libfunc_profile + AotWithProgram variant for ContractExecutor #1599 / add run_with_libfunc_profile + AotWithProgram variant for ContractExecutor #1609)

Test plan

• cargo check (default features) clean
• cargo check --features with-libfunc-profiling clean
• cargo check --features sierra-emu,with-libfunc-profiling clean
• cargo check --workspace --all-features clean
• CI green

---

This change is 

[github-actions]

✅ Code is now correctly formatted.

[orizi]

@orizi reviewed 3 files and all commit messages.
Reviewable status: 3 of 4 files reviewed, all discussions resolved (waiting on TomerStarkware and Yoni-Starkware).

[orizi]

@orizi reviewed all commit messages and made 1 comment.
Reviewable status: 1 of 4 files reviewed, 1 unresolved discussion (waiting on avi-starkware, TomerStarkware, and Yoni-Starkware).

---

src/executor.rs line 31 at r3 (raw file):

};
use bumpalo::Bump;
// Re-exported so libfunc-profiling consumers (e.g. blockifier) can refer to the

what kind of reference is expected?
if it is just as a value - since you only use is as Arc<Program> - export:
pub type ArcProgram = std::sync::Arc<cairo_lang_sierra::program::Program>;

[avi-starkware]

@avi-starkware made 1 comment.
Reviewable status: 0 of 5 files reviewed, 1 unresolved discussion (waiting on orizi, TomerStarkware, and Yoni-Starkware).

---

src/executor.rs line 31 at r3 (raw file):

Previously, orizi wrote…

what kind of reference is expected?
if it is just as a value - since you only use is as Arc<Program> - export:
pub type ArcProgram = std::sync::Arc<cairo_lang_sierra::program::Program>;

Done.