From 687dfe2af3ce5e8cc1e661976da3ecb7e4e6a301 Mon Sep 17 00:00:00 2001
From: chainide-agent-bob <shenyang@whitematrix.io>
Date: Tue, 8 Apr 2025 18:02:32 +0800
Subject: [PATCH] docs: add examples for querying and listening to events from
 specific addresses

---
 docs.wrm/getting-started.wrm | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs.wrm/getting-started.wrm b/docs.wrm/getting-started.wrm
index 373a60f596..1d3b142953 100644
--- a/docs.wrm/getting-started.wrm
+++ b/docs.wrm/getting-started.wrm
@@ -425,6 +425,22 @@ _code: listen for ERC-20 events  @lang<script>
     // `to` will always be equal to the address of "ethers.eth"
   });
 
+  // Listen for any Transfer from a specific address
+  fromAddress = "0x123..."; // Replace with actual address
+  filter = contract.filters.Transfer(fromAddress, null)
+  contract.on(filter, (from, to, amount, event) => {
+    // `from` will always be equal to fromAddress
+    console.log(`Transfer from ${from} to ${to}: ${formatEther(amount)}`);
+  });
+
+  // Listen for any Transfer from a specific address to a specific address
+  toAddress = "0x456..."; // Replace with actual address
+  filter = contract.filters.Transfer(fromAddress, toAddress)
+  contract.on(filter, (from, to, amount, event) => {
+    // Both `from` and `to` will be fixed
+    console.log(`Transfer from ${from} to ${to}: ${formatEther(amount)}`);
+  });
+
   // Listen for any event, whether it is present in the ABI
   // or not. Since unknown events can be picked up, the
   // parameters are not destructed.
@@ -470,6 +486,25 @@ _code: query historic ERC-20 events  @lang<javascript>
   events[0]
   //_result:
 
+  // Query all transfers sent from a specific address
+  fromAddress = "0x123..."; // Replace with actual address
+  filter = contract.filters.Transfer(fromAddress, null)
+  events = await contract.queryFilter(filter)
+
+  // The first matching event
+  events[0]
+  //_result:
+
+  // Query all transfers sent from a specific address in the last 1000 blocks
+  events = await contract.queryFilter(filter, -1000)
+  //_result:
+
+  // Query all transfers sent from a specific address to a specific address
+  toAddress = "0x456..."; // Replace with actual address
+  filter = contract.filters.Transfer(fromAddress, toAddress)
+  events = await contract.queryFilter(filter)
+  //_result:
+
 
 _subsection: Signing Messages  @<starting-signing>