@layerzerolabs/protocol-stellar-v2 0.2.8

package/sdk/test/suites/constants.ts

@@ -0,0 +1,13 @@
+import { Asset, Keypair, Networks} from '@stellar/stellar-sdk';
+
+const CORE_URL = 'http://localhost:8000';
+export const FRIENDBOT_URL = `${CORE_URL}/friendbot`;
+export const RPC_URL = `${CORE_URL}/rpc`;
+export const NETWORK_PASSPHRASE = Networks.STANDALONE;
+export const DEFAULT_DEPLOYER = Keypair.fromSecret('SDLCA3JUES3G6R4FTI6XXDIWW7QCNMZNWPYQQIKQ26TEIZUFOLIVIUDK');
+export const ZRO_DISTRIBUTOR = Keypair.fromSecret('SB6QAFXFRR2MXYHW4RRZ23JDGKHDCYCT5YTQEGG3WNT5VKZADJQFVNWG');
+export const EID = 30111;
+export const NATIVE_TOKEN_ADDRESS = Asset.native().contractId(NETWORK_PASSPHRASE);
+export const ZRO_ASSET = new Asset('ZRO', DEFAULT_DEPLOYER.publicKey());
+export const ZRO_TOKEN_ADDRESS = ZRO_ASSET.contractId(NETWORK_PASSPHRASE);
+export const MSG_TYPE_VANILLA = 1;

package/sdk/test/suites/deploy.ts

@@ -0,0 +1,277 @@
+import {
+    Asset,
+    BASE_FEE,
+    hash,
+    Keypair,
+    Operation,
+    rpc,
+    TransactionBuilder,
+    xdr
+} from '@stellar/stellar-sdk';
+import { readFileSync } from 'fs';
+
+import { DEFAULT_DEPLOYER, NETWORK_PASSPHRASE, RPC_URL, ZRO_ASSET, ZRO_DISTRIBUTOR } from './constants';
+
+/**
+ * Query and display the TTL (Time To Live) of uploaded WASM code
+ * 
+ * @param wasmHash - The hex-encoded SHA-256 hash of the WASM code
+ * @param server - The Stellar RPC server instance
+ * @param rpcUrl - Optional RPC URL (defaults to RPC_URL constant)
+ */
+async function queryWasmTtl(
+    wasmHash: string,
+    server: rpc.Server,
+    rpcUrl?: string
+): Promise<void> {
+    try {
+        const latestLedger = await server.getLatestLedger();
+        const currentLedger = latestLedger.sequence;
+        
+        // Create the LedgerKey for contract code using XDR encoding
+        const wasmHashBuffer = Buffer.from(wasmHash, 'hex');
+        // Ensure hash is exactly 32 bytes
+        const hashBytes = wasmHashBuffer.length === 32 ? wasmHashBuffer : wasmHashBuffer.slice(0, 32);
+        // Create LedgerKeyContractCode with hash
+        const ledgerKeyContractCode = new xdr.LedgerKeyContractCode({
+            hash: hashBytes
+        });
+        const ledgerKey = xdr.LedgerKey.contractCode(ledgerKeyContractCode);
+        const ledgerKeyXdr = ledgerKey.toXDR('base64');
+        
+        // Query contract code entry using direct RPC call
+        const rpcEndpoint = rpcUrl || (server as any).serverURL || RPC_URL;
+        const response = await fetch(rpcEndpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'getLedgerEntries',
+                params: {
+                    keys: [ledgerKeyXdr]
+                }
+            })
+        });
+        
+        const result = await response.json();
+        if (result.error) {
+            console.warn(`⚠️  Could not retrieve WASM TTL: ${result.error.message}`);
+        } else if (result.result?.entries?.[0]?.liveUntilLedgerSeq) {
+            const liveUntilLedgerSeq = result.result.entries[0].liveUntilLedgerSeq;
+            const ttlLedgers = liveUntilLedgerSeq - currentLedger;
+            const ttlDays = (ttlLedgers * 5) / (24 * 3600); // ~5 seconds per ledger
+            console.log(`⏰ WASM TTL: live until ledger ${liveUntilLedgerSeq} (${ttlLedgers} ledgers remaining, ~${ttlDays.toFixed(2)} days)`);
+        }
+    } catch (error) {
+        // If querying TTL fails, it might be because the code isn't indexed yet
+        // This is non-fatal, so we just log a warning
+        console.warn(`⚠️  Could not retrieve WASM TTL: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+
+export async function uploadWasm(
+    wasmBuffer: Buffer,
+    keypair: Keypair,
+    server: rpc.Server,
+): Promise<string> {
+    console.log(`📦 WASM buffer size: ${wasmBuffer.length} bytes (${(wasmBuffer.length / 1024).toFixed(2)} KB)`);
+    
+    const account = await server.getAccount(keypair.publicKey());
+
+    const uploadTx = new TransactionBuilder(account, {
+        fee: BASE_FEE,
+        networkPassphrase: NETWORK_PASSPHRASE,
+    })
+        .addOperation(Operation.uploadContractWasm({ wasm: wasmBuffer }))
+        .setTimeout(30)
+        .build();
+
+    const simulated = await server.simulateTransaction(uploadTx);
+    const preparedTx = rpc.assembleTransaction(uploadTx, simulated).build();
+    
+    console.log(`💰 Upload transaction fee: ${preparedTx.fee} stroops (${(Number(preparedTx.fee) / 10000000).toFixed(7)} XLM)`);
+    
+    preparedTx.sign(keypair);
+
+    const sendResult = await server.sendTransaction(preparedTx);
+
+    if (sendResult.status !== 'PENDING') {
+        throw new Error(`Transaction failed: ${JSON.stringify(sendResult)}`);
+    }
+
+    // Wait for transaction to be confirmed
+    const txResult = await server.pollTransaction(sendResult.hash);
+
+    if (txResult.status !== 'SUCCESS') {
+        throw new Error(`Transaction not successful: ${JSON.stringify(txResult)}`);
+    }
+
+    // Compute the WASM hash (SHA-256 of the WASM bytes)
+    const wasmHash = hash(wasmBuffer).toString('hex');
+
+    // Query and display the WASM code TTL
+    await queryWasmTtl(wasmHash, server);
+
+    return wasmHash;
+}
+
+/**
+ * Generic contract deployment helper that works with any contract Client
+ * 
+ * @param ClientClass - The contract Client class (e.g., EndpointClient, SMLClient)
+ * @param wasmFilePath - Path to the compiled WASM file
+ * @param constructorArgs - Arguments for the contract's constructor
+ * @param deployer - The keypair that will deploy the contract
+ * @param options - Optional deployment options (salt, fee, timeout, etc.)
+ * @returns The deployed contract's Client instance with the contractId
+ */
+export async function deployContract<T extends { options: { contractId: string } }>(
+    ClientClass: {
+        deploy: (
+            args: any,
+            options: any,
+        ) => Promise<{ signAndSend: () => Promise<{ result: T }> }>;
+    },
+    wasmFilePath: string,
+    constructorArgs: any,
+    deployer: Keypair,
+    options: {
+        salt?: Buffer;
+        rpcUrl?: string;
+        networkPassphrase?: string;
+        allowHttp?: boolean;
+    } = {},
+): Promise<T> {
+    const {
+        rpcUrl = RPC_URL,
+        networkPassphrase = NETWORK_PASSPHRASE,
+        allowHttp = true,
+        salt,
+    } = options;
+
+    const server = new rpc.Server(rpcUrl, {
+        allowHttp: allowHttp,
+    });
+
+    // Step 1: Read WASM file
+    console.log('📖 Reading WASM file from:', wasmFilePath);
+    const wasmBuffer = readFileSync(wasmFilePath);
+
+    // Step 2: Upload WASM and get hash
+    console.log('📤 Uploading WASM...');
+    const wasmHash = await uploadWasm(wasmBuffer, deployer, server);
+    console.log('✅ WASM uploaded, hash:', wasmHash);
+
+    // Step 3: Deploy the contract
+    console.log('🚀 Deploying contract...');
+    const deployTx = await ClientClass.deploy(constructorArgs, {
+        wasmHash: wasmHash,
+        publicKey: deployer.publicKey(),
+        signTransaction: async (tx: string) => {
+            const transaction = TransactionBuilder.fromXDR(tx, networkPassphrase);
+            transaction.sign(deployer);
+            return {
+                signedTxXdr: transaction.toXDR(),
+                signerAddress: deployer.publicKey(),
+            };
+        },
+        rpcUrl: rpcUrl,
+        networkPassphrase: networkPassphrase,
+        allowHttp: allowHttp,
+        salt: salt,
+    });
+
+    // Step 4: Sign and send
+    const sentTx = await deployTx.signAndSend();
+
+    // Step 5: Extract contract ID from result
+    const contractClient = sentTx.result;
+    const contractId = contractClient.options.contractId;
+    console.log('✅ Contract deployed at:', contractId);
+
+    return contractClient;
+}
+
+export async function deployNativeSac(): Promise<void> {
+    await deployAssetSac(Asset.native());
+    console.log('✅ Native SAC deployed');
+}
+
+export async function deployZroToken(): Promise<void> {
+    const server = new rpc.Server(RPC_URL, {
+        allowHttp: true,
+    });
+    
+    // First, issue the ZRO token.
+    // We can't changeTrust of Issuer account, because the Issuer can't hold the asset.
+    const account = await server.getAccount(DEFAULT_DEPLOYER.publicKey());
+    const transaction = new TransactionBuilder(account, {
+        fee: BASE_FEE,
+        networkPassphrase: NETWORK_PASSPHRASE,
+    })
+        .addOperation(Operation.changeTrust({ asset: ZRO_ASSET, source: ZRO_DISTRIBUTOR.publicKey() }))
+        .addOperation(Operation.payment({ asset: ZRO_ASSET, amount: '10000', destination: ZRO_DISTRIBUTOR.publicKey() }))
+        .setTimeout(10)
+        .build();
+    transaction.sign(DEFAULT_DEPLOYER, ZRO_DISTRIBUTOR);
+
+    const sendResult = await server.sendTransaction(transaction);
+    if (sendResult.status !== 'PENDING') {
+        throw new Error(`Failed to issue ZRO token: ${JSON.stringify(sendResult)}`);
+    }
+    const txResult = await server.pollTransaction(sendResult.hash);
+    if (txResult.status !== 'SUCCESS') {
+        throw new Error(`Failed to issue ZRO token: ${JSON.stringify(txResult)}`);
+    }
+    console.log('✅ ZRO asset issued');
+    
+    // Deploy the Stellar Asset Contract (SAC)
+    await deployAssetSac(ZRO_ASSET);
+    console.log('✅ ZRO SAC deployed');
+}
+
+/**
+ * Deploy SAC for a custom asset using TypeScript
+ */
+export async function deployAssetSac(asset: Asset): Promise<string> {
+    console.log('Deploying SAC for asset:', asset.toString());
+    
+    const server = new rpc.Server(RPC_URL, { allowHttp: true });
+    const account = await server.getAccount(DEFAULT_DEPLOYER.publicKey());
+    
+    // Build transaction with createStellarAssetContract operation
+    const deployTx = new TransactionBuilder(account, {
+        fee: BASE_FEE,
+        networkPassphrase: NETWORK_PASSPHRASE,
+    })
+        .addOperation(
+            Operation.createStellarAssetContract({
+                asset: asset,
+            })
+        )
+        .setTimeout(30)
+        .build();
+    
+    // Simulate transaction first (required for contract operations)
+    const simulated = await server.simulateTransaction(deployTx);
+    
+    // Check if simulation was successful
+    if (rpc.Api.isSimulationError(simulated)) {
+        throw new Error(`Transaction simulation failed: ${JSON.stringify(simulated)}`);
+    }
+    
+    const preparedTx = rpc.assembleTransaction(deployTx, simulated).build();
+    
+    // Sign and send
+    preparedTx.sign(DEFAULT_DEPLOYER);
+    const sendResult = await server.sendTransaction(preparedTx);
+    if (sendResult.status !== 'PENDING') {
+        throw new Error(`Failed to deploy SAC: ${JSON.stringify(sendResult)}`);
+    }
+    const txResult = await server.pollTransaction(sendResult.hash);
+    if (txResult.status !== 'SUCCESS') {
+        throw new Error(`SAC deployment not successful: ${JSON.stringify(txResult)}`);
+    }    
+    return asset.contractId(NETWORK_PASSPHRASE);
+}

package/sdk/test/suites/localnet.ts

@@ -0,0 +1,42 @@
+import axios from 'axios';
+import { $,sleep } from 'zx';
+
+import { DEFAULT_DEPLOYER, FRIENDBOT_URL, ZRO_DISTRIBUTOR } from './constants';
+import { deployNativeSac, deployZroToken } from './deploy';
+
+export async function startStellarLocalnet(): Promise<void> {
+    console.log('🚀 Starting Stellar localnet...');
+
+    //TODO: pnpm localnet up --only stellar
+    await $`stellar container start local`;
+
+    // Wait for Stellar to start
+    for (let i = 0; i < 60; i++) {
+        try {
+            // Ensure faucet service is started and fund the default deployer account
+            await fundAccount(DEFAULT_DEPLOYER.publicKey());
+            await fundAccount(ZRO_DISTRIBUTOR.publicKey());
+            console.log(`✅ Account ${DEFAULT_DEPLOYER.publicKey()} funded`);
+            console.log('✅ Stellar localnet started');
+            break;
+        } catch (_e) {
+            await sleep(1000);
+            console.log('⏳ Waiting for Stellar localnet to start...');
+        }
+    }
+    await deployNativeSac();
+    await deployZroToken();
+}
+
+export async function fundAccount(publicKey: string): Promise<void> {
+    await axios.get(FRIENDBOT_URL, {
+        params: {
+            addr: publicKey,
+        },
+    });
+}
+
+export async function stopStellarLocalnet(): Promise<void> {
+    await $`stellar container stop`;
+    console.log('✅ Stellar localnet stopped');
+}

package/sdk/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/sdk/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/*"
+    ]
+  }

package/tools/ts-bindings-gen/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "ts-bindings-gen"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+
+[[bin]]
+name = "ts-bindings-gen"
+path = "src/main.rs"
+
+[dependencies]
+anyhow = "1.0"
+soroban-spec-typescript = "23.0.3"
+