diff --git a/README.md b/README.md
index 8032ed3..911aca0 100644
--- a/README.md
+++ b/README.md
@@ -114,14 +114,14 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
     // Load configuration
     let config: Config = load_config("config.yaml")?;
 
-    // Start oracle to watch for cross-chain events
+    // Start oracle to watch for events on multiple chains
     let blocks = oracle(config, Db::memory(), 0).map_err(|e| anyhow::anyhow!(e));
 
     // Define your app's state and transition logic
     let state_transition = |block: &Block, _state: &mut State| -> Result<(), Infallible> {
         // Process block and update state
         for _event in &block.events {
-            // Handle cross-chain events
+            // Handle events inbound from various chains
             println!(
                 "Processing {} events in block {}",
                 block.events.len(),
@@ -238,7 +238,7 @@ ECDSA signature utilities compatible with Ethereum's cryptographic standards.
 Network communication primitives for distributed replication and synchronization.
 
 ### `void-oracle-decoder`
-Macro library for generating Ethereum event decoders for cross-chain event processing.
+Macro library for generating Ethereum event decoders for multi-chain event processing.
 
 ## Advanced Features
 
@@ -306,7 +306,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
     // Load configuration
     let config: Config = load_config("config.yaml")?;
 
-    // Start oracle to watch for cross-chain events
+    // Start oracle to watch for events on multiple chains
     let blocks = oracle(config, Db::memory(), 0);
 
     // Process decoded events in your state transition function
@@ -342,7 +342,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
 
 ## Use Cases
 
-VOID is ideal for applications that need high performance, custom logic execution, and seamless cross-chain integration, such as:
+VOID is ideal for applications that need high performance, custom logic execution, and seamless multi-chain integration, such as:
 
 - **DeFi Protocols**: DEXs, lending platforms, derivatives with cross-chain liquidity
 - **Gaming Applications**: Real-time games requiring low latency and custom logic