@layerzerolabs/lz-v2-stellar-sdk 0.2.8

package/test/suites/scan.ts

@@ -0,0 +1,189 @@
+import { rpc, xdr } from '@stellar/stellar-sdk';
+
+import { RPC_URL } from './constants';
+
+/**
+ * Event filter for scanning contract events
+ */
+export interface EventFilter {
+    contractId: string;
+}
+
+/**
+ * Parsed contract event
+ */
+export interface ParsedContractEvent {
+    type: string;
+    contractId: string;
+    topics: any[];
+    data: any;
+    ledger: number;
+    txHash: string;
+}
+
+/**
+ * PacketSent event structure from endpoint_v2.rs
+ */
+export interface PacketSentEvent {
+    encoded_packet: Buffer;
+    options: Buffer;
+    send_library: string;
+}
+
+/**
+ * Scan for contract events within a ledger range
+ */
+export async function scanEvents(
+    startLedger: number,
+    filter: EventFilter,
+): Promise<ParsedContractEvent[]> {
+    const server = new rpc.Server(RPC_URL, { allowHttp: true });
+    
+    console.log('🔍 Scanning events from ledger', startLedger);
+    
+    try {
+        const events = await server.getEvents({
+            startLedger: startLedger,
+            filters: [{type: 'contract', contractIds: [filter.contractId]}],
+        });
+        
+        const parsedEvents: ParsedContractEvent[] = [];
+        
+        for (const event of events.events || []) {
+            try {
+                const parsedEvent: ParsedContractEvent = {
+                    type: event.type,
+                    contractId: event.contractId?.contractId() || '',
+                    topics: event.topic.map((t) => {
+                        try {
+                            return xdr.ScVal.fromXDR(Buffer.from(t, 'base64'));
+                        } catch {
+                            return t;
+                        }
+                    }),
+                    data: event.value ? xdr.ScVal.fromXDR(event.value.toXDR()) : undefined,
+                    ledger: event.ledger,
+                    txHash: event.txHash,
+                };
+                parsedEvents.push(parsedEvent);
+            } catch (e) {
+                console.warn('Failed to parse event:', e);
+            }
+        }
+        
+        console.log(`✅ Found ${parsedEvents.length} events`);
+        return parsedEvents;
+    } catch (error: any) {
+        console.error('Error scanning events:', error.message);
+        throw error;
+    }
+}
+
+/**
+ * Scan for PacketSent events from the Endpoint contract
+ */
+export async function scanPacketSentEvents(
+    endpointAddress: string,
+    startLedger: number,
+): Promise<PacketSentEvent[]> {
+    console.log('📦 Scanning for PacketSent events...');    
+    const events = await scanEvents(startLedger, {
+        contractId: endpointAddress,
+    });
+    
+    // Filter for PacketSent events
+    // PacketSent event has topics like ["PacketSent"] or similar
+    const packetSentEvents: PacketSentEvent[] = [];
+    
+    for (const event of events) {
+        try {
+            // Check if this is a PacketSent event
+            // The first topic should be the event name
+            const firstTopic = event.topics[0];
+            
+            // Convert ScVal to string to check event name
+            let eventName = '';
+            if (firstTopic && firstTopic._switch?.name === 'scvSymbol') {
+                eventName = firstTopic.value()?.toString() || '';
+            }
+            
+            if (eventName === 'PacketSent') {
+                // Parse the event data
+                // PacketSent { encoded_packet, options, send_library }
+                const eventData = event.data;
+                
+                // Try to extract fields from the struct
+                if (eventData && eventData._switch?.name === 'scvMap') {
+                    const map = eventData.value();
+                    const packetEvent: Partial<PacketSentEvent> = {};
+                    
+                    for (const entry of map || []) {
+                        const key = entry.key().value()?.toString();
+                        const value = entry.val();
+                        
+                        if (key === 'encoded_packet' && value._switch?.name === 'scvBytes') {
+                            packetEvent.encoded_packet = Buffer.from(value.value());
+                        } else if (key === 'options' && value._switch?.name === 'scvBytes') {
+                            packetEvent.options = Buffer.from(value.value());
+                        } else if (key === 'send_library' && value._switch?.name === 'scvAddress') {
+                            packetEvent.send_library = value.value()?.toString() || '';
+                        }
+                    }
+                    
+                    if (packetEvent.encoded_packet && packetEvent.options !== undefined && packetEvent.send_library) {
+                        packetSentEvents.push(packetEvent as PacketSentEvent);
+                    }
+                }
+            }
+        } catch (e) {
+            console.warn('Failed to parse PacketSent event:', e);
+        }
+    }
+    
+    console.log(`✅ Found ${packetSentEvents.length} PacketSent events`);
+    return packetSentEvents;
+}
+
+/**
+ * Wait for new ledgers and scan for events
+ */
+export async function waitAndScanEvents(
+    startLedger: number,
+    contractAddress: string,
+    eventName: string,
+    maxWaitSeconds: number = 30,
+): Promise<ParsedContractEvent[]> {
+    const server = new rpc.Server(RPC_URL, { allowHttp: true });
+    const endTime = Date.now() + maxWaitSeconds * 1000;
+    
+    console.log(`⏳ Waiting for ${eventName} events...`);
+    
+    while (Date.now() < endTime) {
+        const currentLedger = await server.getLatestLedger();
+        
+        if (currentLedger.sequence > startLedger) {
+            const events = await scanEvents(startLedger, {
+                contractId: contractAddress,
+            });
+            
+            const matchingEvents = events.filter((e) => {
+                const firstTopic = e.topics[0];
+                if (firstTopic && firstTopic._switch?.name === 'scvSymbol') {
+                    const name = firstTopic.value()?.toString() || '';
+                    return name === eventName;
+                }
+                return false;
+            });
+            
+            if (matchingEvents.length > 0) {
+                return matchingEvents;
+            }
+        }
+        
+        // Wait 1 second before checking again
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+    
+    throw new Error(`Timeout waiting for ${eventName} events`);
+}
+

package/tsconfig.json

@@ -0,0 +1,106 @@
+{
+    "compilerOptions": {
+      /* Visit https://aka.ms/tsconfig to read more about this file */
+      /* Projects */
+      // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+      // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+      // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+      // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+      // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+      // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+      /* Language and Environment */
+      "target": "ESNext", /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+      // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+      // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+      // "experimentalDecorators": true,                   /* Enable experimental support for TC39 stage 2 draft decorators. */
+      // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+      // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+      // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+      // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+      // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+      // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+      // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+      // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+      /* Modules */
+      "module": "NodeNext", /* Specify what module code is generated. */
+      // "rootDir": "./",                                  /* Specify the root folder within your source files. */
+      "moduleResolution": "nodenext", /* Specify how TypeScript looks up a file from a given module specifier. */
+      // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+      // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+      // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+      // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+      // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+      // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+      // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+      // "resolveJsonModule": true,                        /* Enable importing .json files. */
+      // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+      /* JavaScript Support */
+      // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+      // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+      // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+      /* Emit */
+      "declaration": true, /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+      // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+      // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+      // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+      // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+      "outDir": "./dist", /* Specify an output folder for all emitted files. */
+      // "removeComments": true,                           /* Disable emitting comments. */
+      // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+      // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+      // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+      // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+      // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+      // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+      // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+      // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+      // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+      // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+      // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+      // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+      // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+      // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+      // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+      // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+      /* Interop Constraints */
+      // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+      // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+      // "esModuleInterop": true, /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
+      // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+      // "forceConsistentCasingInFileNames": true, /* Ensure that casing is correct in imports. */
+      /* Type Checking */
+      // "strict": true, /* Enable all strict type-checking options. */
+      // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+      "strictNullChecks": true, /* When type checking, take into account 'null' and 'undefined'. */
+      // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+      // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+      "strictPropertyInitialization": false,             /* Check for class properties that are declared but not set in the constructor. */
+      // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+      // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+      // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+      "noUnusedLocals": false,                           /* Enable error reporting when local variables aren't read. */
+      "noUnusedParameters": false,                       /* Raise an error when a function parameter isn't read. */
+      // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+      // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+      // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+      // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+      // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+      // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+      // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+      // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+      /* Completeness */
+      // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+      "skipLibCheck": true /* Skip type checking all .d.ts files. */
+    },
+    "exclude": [
+        "node_modules",
+        "**/__mocks__/*",
+        "**/__tests__/*",
+        "**/*.spec.ts",
+        "**/*.test.ts",
+        "dist"
+    ],
+    "include": [
+      "src/*"
+    ]
+  }