docs: add type-checked examples for skip_initialization and poll_for_events

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: critesjosh

docs/docs-developers/docs/aztec-js/how_to_deploy_contract.md

@@ -106,16 +106,7 @@ Universal deployment excludes the sender from address computation, allowing the
 
 Deploy without running the constructor:
 
-```typescript
-// wallet and alice are from the connection guide
-const contract = await MyContract.deploy(wallet).send({
-  from: aliceAddress,
-  skipInitialization: true,
-});
-
-// Initialize later
-await contract.methods.initialize(arg1, arg2).send({ from: aliceAddress });
-```
+#include_code skip_initialization /docs/examples/ts/aztecjs_advanced/index.ts typescript
 
 ### Deploy with a specific initializer
 

docs/docs-developers/docs/aztec-js/how_to_read_data.md

@@ -165,36 +165,7 @@ collectedEvents.forEach((ev) => {
 
 To continuously monitor for new events, poll at regular intervals while tracking the last processed block:
 
-```typescript
-import { BlockNumber } from "@aztec/foundation/branded-types";
-
-// aztecNode is from createAztecNodeClient() in the connection guide
-// TokenContract is your deployed token contract class
-let lastProcessedBlock = startBlock; // BlockNumber type
-
-async function pollForEvents() {
-  const currentBlock = await aztecNode.getBlockNumber();
-
-  if (currentBlock > lastProcessedBlock) {
-    const events = await getDecodedPublicEvents<Transfer>(
-      aztecNode,
-      TokenContract.events.Transfer,
-      lastProcessedBlock + 1,
-      currentBlock - lastProcessedBlock,
-    );
-
-    for (const event of events) {
-      // Process each event
-      console.log(`Transfer: ${event.amount} from ${event.from}`);
-    }
-
-    lastProcessedBlock = currentBlock;
-  }
-}
-
-// Poll every 10 seconds
-setInterval(pollForEvents, 10000);
-```
+#include_code poll_for_events /docs/examples/ts/aztecjs_advanced/index.ts typescript
 
 For private events, use the same pattern with `wallet.getPrivateEvents()` and update the `fromBlock` in your filter accordingly.
 

docs/examples/ts/aztecjs_advanced/index.ts

@@ -7,7 +7,7 @@ import {
   TestWallet,
   registerInitialLocalNetworkAccountsInWallet,
 } from "@aztec/test-wallet/server";
-import { TokenContract } from "@aztec/noir-contracts.js/Token";
+import { TokenContract, type Transfer } from "@aztec/noir-contracts.js/Token";
 import { SponsoredFPCContract } from "@aztec/noir-contracts.js/SponsoredFPC";
 import { Fr } from "@aztec/aztec.js/fields";
 import { NO_WAIT, BatchCall } from "@aztec/aztec.js/contracts";
@@ -189,4 +189,57 @@ console.log(`Contract 2 at: ${contracts[1].address}`);
 console.log(`Contract 3 at: ${contracts[2].address}`);
 // docs:end:parallel_deploy
 
+// docs:start:skip_initialization
+// Deploy without running the constructor using skipInitialization
+const uninitializedToken = await TokenContract.deploy(
+  wallet,
+  aliceAddress,
+  "UninitToken",
+  "UNIT",
+  18,
+).send({
+  from: aliceAddress,
+  skipInitialization: true,
+});
+
+console.log(`Uninitialized contract at: ${uninitializedToken.address}`);
+
+// Initialize later by calling the constructor manually
+await uninitializedToken.methods
+  .constructor(aliceAddress, "UninitToken", "UNIT", 18)
+  .send({ from: aliceAddress });
+
+console.log("Contract initialized");
+// docs:end:skip_initialization
+
+// docs:start:poll_for_events
+import { getDecodedPublicEvents } from "@aztec/aztec.js/events";
+
+// Poll for new events at regular intervals
+let lastProcessedBlock = await node.getBlockNumber();
+
+async function pollForTransferEvents() {
+  const currentBlock = await node.getBlockNumber();
+
+  if (currentBlock > lastProcessedBlock) {
+    const events = await getDecodedPublicEvents<Transfer>(
+      node,
+      TokenContract.events.Transfer,
+      lastProcessedBlock + 1,
+      currentBlock - lastProcessedBlock,
+    );
+
+    for (const event of events) {
+      // Process each transfer event
+      console.log(`Transfer: ${event.amount} from ${event.from} to ${event.to}`);
+    }
+
+    lastProcessedBlock = currentBlock;
+  }
+}
+
+// Example: poll once (in production, use setInterval)
+await pollForTransferEvents();
+// docs:end:poll_for_events
+
 console.log("All advanced examples completed successfully");