wormhole-foundation
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-1.json
+10 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-1.json
+10
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-10.html
+6 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-10.html
+6
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-11.html
+9 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-11.html
+9
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-12.ts
+29 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-12.ts
+29
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-13.html
+17 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-13.html
+17
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-14.ts
+10 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-14.ts
+10
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-15.html
+14 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-15.html
+14
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-16.ts
+53 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-16.ts
+53
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-17.html
+13 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-17.html
+13
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-2.ts
+14 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-2.ts
+14
diff --git a/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-3.ts
+38 b/‎.snippets/code/tutorials/by-product/wormholescan/replace-signatures/replace-sigs-3.ts
+38
@@ -0,0 +1,10 @@
+{
+    "compilerOptions": {
+        "target": "es2016",
+        "module": "commonjs",
+        "esModuleInterop": true,
+        "forceConsistentCasingInFileNames": true,
+        "strict": true,
+        "skipLibCheck": true
+    }
+}
@@ -0,0 +1,6 @@
+<div id="termynal" data-termynal>
+	<span data-ty="input"><span class="file-path"></span>npx tsx test/checkVaaValidity.run.ts</span>
+	<span data-ty> </span>
+	<span data-ty>✅ VAA Valid: true</span>
+	<span data-ty="input"><span class="file-path"></span></span>
+</div>
@@ -0,0 +1,9 @@
+<div id="termynal" data-termynal>
+	<span data-ty="input"><span class="file-path"></span>npx tsx test/checkVaaValidity.run.ts</span>
+	<span data-ty> </span>
+	<span data-ty>❌ VAA Valid: false, Reason: VM signature invalid</span>
+	<span data-ty
+		>Transaction: 0x3ad91ec530187bb2ce3b394d587878cd1e9e037a97e51fbc34af89b2e0719367</span
+	>
+	<span data-ty="input"><span class="file-path"></span></span>
+</div>
@@ -0,0 +1,29 @@
+import { fetchVaaId, fetchObservations } from '../src/helpers/vaaHelper';
+import { TXS } from '../src/config/constants';
+
+const testFetchObservations = async () => {
+  for (const tx of TXS) {
+    const vaaIds = await fetchVaaId([tx]);
+
+    if (vaaIds.length === 0) {
+      console.log(`No VAA ID found for transaction: ${tx}`);
+      continue;
+    }
+
+    for (const vaaId of vaaIds) {
+      const observations = await fetchObservations(vaaId);
+
+      if (observations.length === 0) {
+        console.log(`No observations found for VAA ID: ${vaaId}`);
+        continue;
+      }
+
+      console.log(
+        `Transaction: ${tx}\nVAA ID: ${vaaId}\nObservations:`,
+        observations
+      );
+    }
+  }
+};
+
+testFetchObservations();
@@ -0,0 +1,17 @@
+<div id="termynal" data-termynal>
+	<span data-ty="input"><span class="file-path"></span>npx tsx test/fetchObservations.run.ts</span>
+	<span data-ty> </span>
+	<span data-ty>Fetching observations</span>
+	<span data-ty
+		>Transaction: 0x3ad91ec530187bb2ce3b394d587878cd1e9e037a97e51fbc34af89b2e0719367</span
+	>
+	<span data-ty
+		>Observations: [ { guardianAddr: '0xda798f6896a3331f64b48c12d1d57fd9cbe70811', signature:
+		'ZGFlMDYyOGNjZjFjMmE0ZTk5YzE2OThhZjAzMDM4NzZlYTM1OWMxMzczNDA3YzdlMDMxZTkyNzk0ODkwYjRiYjRiOWFmNzM3NjRiMzIyOTE0ZTQwYzNlMjllMWEzNmM2NTc3ZDc5ZTdhNTM2MzA5YjA4YjExZjE3YzE3MDViNWIwMQ=='
+		}, { guardianAddr: '0x74a3bf913953d695260d88bc1aa25a4eee363ef0', signature:
+		'MzAyOTU4OGU4MWU0ODc0OTAwNDU3N2EzMGZlM2UxMDJjOWYwMjM0NWVhY2VmZWQ0ZGJlNTFkNmI3YzRhZmQ5ZTNiODFjNTg3MDNmYzUzNmJiYWFiZjNlODc1YTY3OTQwMGE4MmE3ZjZhNGYzOGY3YmRmNDNhM2VhNGQyNWNlNGMwMA=='
+		},</span
+	>
+	<span data-ty>...]</span>
+	<span data-ty="input"><span class="file-path"></span></span>
+</div>
@@ -0,0 +1,10 @@
+import { fetchGuardianSet } from '../src/helpers/vaaHelper';
+
+const testFetchGuardianSet = async () => {
+  const [guardians, guardianSetIndex] = await fetchGuardianSet();
+
+  console.log('Current Guardian Set Index:', guardianSetIndex);
+  console.log('Guardian Addresses:', guardians);
+};
+
+testFetchGuardianSet();
@@ -0,0 +1,14 @@
+<div id="termynal" data-termynal>
+	<span data-ty="input"><span class="file-path"></span>npx tsx test/fetchGuardianSet.run.ts</span>
+	<span data-ty> </span>
+	<span data-ty>Fetching current guardian set</span>
+	<span data-ty>Current Guardian Set Index: 4</span>
+    <span data-ty>Guardian Addresses: [
+        '0x5893b5a76c3f739645648885bdccc06cd70a3cd3',
+        '0xff6cb952589bde862c25ef4392132fb9d4a42157',
+        '0x114de8460193bdf3a2fcf81f86a09765f4762fd1',
+        '0x107a0086b32d7a0977926a205131d8731d39cbeb',
+    </span>
+    <span data-ty>...]</span>
+	<span data-ty="input"><span class="file-path"></span></span>
+</div>
@@ -0,0 +1,53 @@
+import {
+  fetchVaaId,
+  fetchVaa,
+  checkVaaValidity,
+  fetchObservations,
+  fetchGuardianSet,
+  replaceSignatures,
+} from '../helpers/vaaHelper';
+import { TXS } from '../config/constants';
+
+async function main() {
+  try {
+    for (const tx of TXS) {
+      console.log(`\nProcessing TX: ${tx}\n`);
+
+      // 1. Fetch Transaction VAA IDs:
+      const vaaIds = await fetchVaaId([tx]);
+      if (!vaaIds.length) continue;
+
+      // 2. Fetch VAA Data:
+      const vaaData = await fetchVaa(vaaIds);
+      if (!vaaData.length) continue;
+
+      const vaaBytes = vaaData[0].vaaBytes;
+      if (!vaaBytes) continue;
+
+      // 3. Check VAA Validity:
+      const { valid } = await checkVaaValidity(vaaBytes);
+      if (valid) continue;
+
+      // 4. Fetch Observations (VAA signatures):
+      const observations = await fetchObservations(vaaIds[0]);
+
+      // 5. Fetch Current Guardian Set:
+      const [currentGuardians, guardianSetIndex] = await fetchGuardianSet();
+
+      // 6. Replace Signatures:
+      const response = await replaceSignatures(
+        Buffer.from(vaaBytes, 'base64'),
+        observations,
+        currentGuardians,
+        guardianSetIndex
+      );
+
+      if (!response) continue;
+    }
+  } catch (error) {
+    console.error('❌ Error in execution:', error);
+    process.exit(1);
+  }
+}
+
+main();
@@ -0,0 +1,13 @@
+<div id="termynal" data-termynal>
+	<span data-ty="input"><span class="file-path"></span>npx tsx src/scripts/replaceSignatures.ts</span>
+	<span data-ty> </span>
+	<span data-ty>Processing TX: 0x3ad91ec530187bb2ce3b394d587878cd1e9e037a97e51fbc34af89b2e0719367</span>
+    <span data-ty>❌ VAA Valid: false, Reason: VM signature invalid</span>
+    <span data-ty>Fetching observations</span>
+    <span data-ty>Fetching current guardian set</span>
+    <span data-ty>Replacing Signatures...</span>
+    <span data-ty>Outdated Guardian Indexes: [ 0 ]</span>
+    <span data-ty>Sending updated VAA to RPC...</span>
+    <span data-ty>Updated VAA (hex): 0x01000000040d010019447b72d51e33923a3d6b28496ccd3722d5f1e33e2...</span>
+	<span data-ty="input"><span class="file-path"></span></span>
+</div>
@@ -0,0 +1,14 @@
+export const RPC = 'https://ethereum-rpc.publicnode.com';
+
+export const ETH_CORE =
+  '0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B'.toLowerCase();
+
+export const WORMHOLESCAN_API = 'https://api.wormholescan.io/v1';
+
+export const LOG_MESSAGE_PUBLISHED_TOPIC =
+  '0x6eb224fb001ed210e379b335e35efe88672a8ce935d981a6896b27ffdf52a3b2';
+
+export const TXS = [
+  '0x3ad91ec530187bb2ce3b394d587878cd1e9e037a97e51fbc34af89b2e0719367',
+  '0x3c989a6bb40dcd4719453fbe7bbac420f23962c900ae75793124fc9cc614368c',
+];
@@ -0,0 +1,38 @@
+export const PARSE_AND_VERIFY_VM_ABI = {
+  inputs: [{ internalType: 'bytes', name: 'encodedVM', type: 'bytes' }],
+  name: 'parseAndVerifyVM',
+  outputs: [
+    {
+      components: [
+        { internalType: 'uint8', name: 'version', type: 'uint8' },
+        { internalType: 'uint32', name: 'timestamp', type: 'uint32' },
+        { internalType: 'uint32', name: 'nonce', type: 'uint32' },
+        { internalType: 'uint16', name: 'emitterChainId', type: 'uint16' },
+        { internalType: 'bytes32', name: 'emitterAddress', type: 'bytes32' },
+        { internalType: 'uint64', name: 'sequence', type: 'uint64' },
+        { internalType: 'uint8', name: 'consistencyLevel', type: 'uint8' },
+        { internalType: 'bytes', name: 'payload', type: 'bytes' },
+        { internalType: 'uint32', name: 'guardianSetIndex', type: 'uint32' },
+        {
+          components: [
+            { internalType: 'bytes32', name: 'r', type: 'bytes32' },
+            { internalType: 'bytes32', name: 's', type: 'bytes32' },
+            { internalType: 'uint8', name: 'v', type: 'uint8' },
+            { internalType: 'uint8', name: 'guardianIndex', type: 'uint8' },
+          ],
+          internalType: 'struct Structs.Signature[]',
+          name: 'signatures',
+          type: 'tuple[]',
+        },
+        { internalType: 'bytes32', name: 'hash', type: 'bytes32' },
+      ],
+      internalType: 'struct Structs.VM',
+      name: 'vm',
+      type: 'tuple',
+    },
+    { internalType: 'bool', name: 'valid', type: 'bool' },
+    { internalType: 'string', name: 'reason', type: 'string' },
+  ],
+  stateMutability: 'view',
+  type: 'function',
+};