fix: add VM Execution State

[crStiv]

Add VM Execution State

Description

Added ExecutionState structure and get_execution_state() method to capture current VM state. Helps with debugging and simplifies integration with external tools.
What's included:

• Structure with key VM parameters (pc, ap, fp, current_step, etc.)
• Tests to verify functionality
• Documentation

Checklist

• Linked to Github Issue
• Unit tests added
• Integration tests added
• This change requires new documentation.
• Documentation updated
• CHANGELOG has been updated.

[FrancoGiachetta]

The changelog needs to be updated.

I made it by accident

[JulianGCalderon]

Hi @crStiv, could you share a bit more information on the usecases of this new structure? Why are those particular fields necessary?

[crStiv]

Hi @crStiv, could you share a bit more information on the usecases of this new structure? Why are those particular fields necessary?

@JulianGCalderon
Hey Julian,
About the ExecutionState, I'll try to be brief, so it basically:

• Makes debugging way easier - you get all VM state in one place
• Simplifies testing - no need to access VM internals directly
• Opens up better tooling options - both IDE plugins and standalone tools

I picked these specijfic fields after some trial and error - they're the minimum set that actualy gives you the full picture of what's hapening in the VM. Happy to go deeper if needed.

[crStiv]

The changelog needs to be updated.

@FrancoGiachetta got you, changelog is updated now, and deleted comments to the test as well

[FrancoGiachetta]

Is it possible for you to tell us what you are doing that needs this information at some point in the program?

[crStiv]

Is it possible for you to tell us what you are doing that needs this information at some point in the program?

@FrancoGiachetta
Before this structure, I had to directly access multiple VM internals, which was messy and fragile. Having a single method that returns a complete snapshot makes the integration much cleaner and less likely to break with future VM changes.
The ExecutionState provides what external tools need without exposing too many implementation details.