Merge pull request #7 from matter-labs/comment-fix

docs: improve comments a bit

src/callframe.rs

@@ -11,7 +11,6 @@ pub struct Callframe {
     pub context_u128: u128,
     pub is_static: bool,
 
-    // TODO: joint allocate these.
     pub stack: Box<Stack>,
 
     pub heap: u32,

src/modified_world.rs

@@ -35,6 +35,8 @@ pub struct ExternalSnapshot {
     written_storage_slots: <RollbackableMap<(H160, U256), ()> as Rollback>::Snapshot,
 }
 
+/// There is no address field because nobody is interested in events that don't come
+/// from the event writer, so we simply do not record events coming frome anywhere else.
 #[derive(Clone, PartialEq, Debug)]
 pub struct Event {
     pub key: U256,

src/stack.rs

@@ -4,6 +4,7 @@ use u256::U256;
 
 #[derive(Clone, PartialEq, Debug)]
 pub struct Stack {
+    /// set of slots that may be interpreted as [crate::fat_pointer::FatPointer].
     pub pointer_flags: Bitset,
     dirty_areas: u64,
     slots: [U256; 1 << 16],