Export events in readonly endpoints

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to the versioning scheme outlined in the [README.md](RE
 - Fixed an issue where `event.committed` was always equal to `true` in the block replay RPC endpoint
 - Added `result_hex` and `post_condition_aborted` to the block replay RPC endpoint
 - Added `--epoch <epoch_number>` flag to `clarity-cli` commands to specify the epoch context for evaluation.
+- Added the `events` array to readonly endpoints output.
 
 ### Fixed
 

clarity/src/vm/clarity.rs

@@ -204,6 +204,46 @@ pub trait ClarityConnection {
             (result, db)
         })
     }
+
+    #[allow(clippy::too_many_arguments)]
+    fn with_readonly_clarity_env_and_fill_events<F, R>(
+        &mut self,
+        mainnet: bool,
+        chain_id: u32,
+        sender: PrincipalData,
+        sponsor: Option<PrincipalData>,
+        cost_track: LimitedCostTracker,
+        events: &mut Vec<StacksTransactionEvent>,
+        to_do: F,
+    ) -> Result<R, VmExecutionError>
+    where
+        F: FnOnce(&mut Environment) -> Result<R, VmExecutionError>,
+    {
+        let epoch_id = self.get_epoch();
+        let clarity_version = ClarityVersion::default_for_epoch(epoch_id);
+        self.with_clarity_db_readonly_owned(|clarity_db| {
+            let initial_context =
+                ContractContext::new(QualifiedContractIdentifier::transient(), clarity_version);
+            let mut vm_env = OwnedEnvironment::new_cost_limited(
+                mainnet, chain_id, clarity_db, cost_track, epoch_id,
+            );
+            let result = vm_env
+                .execute_in_env(sender, sponsor, Some(initial_context), to_do)
+                .map(|(result, _, transaction_events)| {
+                    events.extend(transaction_events);
+                    result
+                });
+            // this expect is allowed, if the database has escaped this context, then it is no longer sane
+            //  and we must crash
+            #[allow(clippy::expect_used)]
+            let (db, _) = {
+                vm_env
+                    .destruct()
+                    .expect("Failed to recover database reference after executing transaction")
+            };
+            (result, db)
+        })
+    }
 }
 
 pub trait TransactionConnection: ClarityConnection {

docs/rpc/components/schemas/read-only-function-result.schema.yaml

@@ -24,3 +24,18 @@ oneOf:
       cause:
         type: string
         description: A string representing the cause of the error.
+      events:
+        type: array
+        description: Contract events generated by the call
+        items:
+          type: object
+          properties:
+            sender:
+              type: string
+              description: The contract address generating the event.
+            key:
+              type: string
+              description: Who generated the event (generally "print").
+            value:
+              type: string
+              description: Hex-encoded Clarity value of the event.