@layerzerolabs/test-utils-stellar 0.2.122

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"env.js"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { createClient } from './client.js';
+export { deployAssetSac, deployContract, deployNativeSac, deployZroToken, uploadWasm, } from './deploy.js';
+export { createStellarTestEnv, type CreateStellarTestEnvOptions, type StellarTestEnv, } from './env.js';
+export { fundAccount, startStellarLocalnet, stopStellarLocalnet } from './localnet.js';
+export { createLocalnetOnlyGlobalSetup } from './localnet-global-setup.js';
+export { type ChainAddresses, createProtocolStackGlobalSetup, type ProtocolContractModule, type ProtocolGlobalSetupContext, type ProtocolStackGlobalSetupOptions, type ProtocolStackModules, } from './protocol-global-setup.js';
+export { type EventFilter, type PacketSentEvent, type ParsedContractEvent, scanEvents, scanPacketSentEvents, waitAndScanEvents, } from './scan.js';
+export { Secp256k1KeyPair } from './secp256k1.js';
+export { assertTransactionSucceeded, getNativeBalance, getTokenAuthorized, getTokenBalance, signAndSendWithExecutorAuth, signDvnAuthEntries, } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACH,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,cAAc,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EACH,KAAK,cAAc,EACnB,8BAA8B,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,oBAAoB,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACH,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,UAAU,EACV,oBAAoB,EACpB,iBAAiB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACH,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,2BAA2B,EAC3B,kBAAkB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { assertTransactionSucceeded, getNativeBalance, getTokenAuthorized, getTokenBalance, signAndSendWithExecutorAuth, signDvnAuthEntries } from './VRABOZPX.js';
+export { createStellarTestEnv } from './7DZ4SVEO.js';
+export { Secp256k1KeyPair } from './DNRE4ENZ.js';
+export { createLocalnetOnlyGlobalSetup } from './4UKUSHEU.js';
+export { createProtocolStackGlobalSetup } from './ZWKXKZVT.js';
+export { createClient } from './GAGBEOCZ.js';
+export { fundAccount, startStellarLocalnet, stopStellarLocalnet } from './CYINPPER.js';
+export { deployAssetSac, deployContract, deployNativeSac, deployZroToken, uploadWasm } from './TYAJMKGY.js';
+export { scanEvents, scanPacketSentEvents, waitAndScanEvents } from './PMDPSIA2.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/localnet-global-setup.d.ts

@@ -0,0 +1,7 @@
+import type { StellarTestEnv } from './env.js';
+/**
+ * Vitest globalSetup that only starts/stops Stellar localnet.
+ * Use when the suite deploys its own contracts (e.g. protocol SDK upgrader tests).
+ */
+export declare function createLocalnetOnlyGlobalSetup(env: StellarTestEnv): (_ctx?: unknown) => Promise<() => Promise<void>>;
+//# sourceMappingURL=localnet-global-setup.d.ts.map

package/dist/localnet-global-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localnet-global-setup.d.ts","sourceRoot":"","sources":["../src/localnet-global-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,GAAG,EAAE,cAAc,GACpB,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAoBlD"}

package/dist/localnet-global-setup.js

@@ -0,0 +1,6 @@
+export { createLocalnetOnlyGlobalSetup } from './4UKUSHEU.js';
+import './CYINPPER.js';
+import './TYAJMKGY.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=localnet-global-setup.js.map
+//# sourceMappingURL=localnet-global-setup.js.map

package/dist/localnet-global-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"localnet-global-setup.js"}

package/dist/localnet.d.ts

@@ -0,0 +1,37 @@
+import type { StellarTestEnv } from './env.js';
+export declare const DEFAULT_STELLAR_LOCALNET_IMAGE = "438003944538.dkr.ecr.us-east-1.amazonaws.com/layerzerolabs/stellar:2026-03-02";
+export declare const STELLAR_LOCALNET_OWNER_LABEL = "com.layerzerolabs.test-utils-stellar=1";
+export declare const FUNDING_RETRY_INTERVAL_MS = 2000;
+export interface DockerCommandResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+}
+/** Injectable so container lifecycle policy can be tested without a Docker daemon. */
+export type DockerCommandRunner = (args: readonly string[]) => DockerCommandResult;
+export interface LocalnetLifecycleOptions {
+    env: StellarTestEnv;
+    commandRunner?: DockerCommandRunner;
+}
+export type NamedContainerRemovalPolicy = 'absent' | 'remove' | 'reject';
+export declare function assertDockerArgs(env: StellarTestEnv): void;
+export declare function buildDockerRunArgs(env: StellarTestEnv): string[];
+export declare function buildDockerContainerIdLookupArgs(containerName: string): string[];
+export declare function buildDockerOwnershipLabelLookupArgs(containerId: string): string[];
+export declare function buildDockerRemoveArgs(containerId: string): string[];
+export declare function getNamedContainerRemovalPolicy(containerId: string | undefined, ownerLabel: string | undefined): NamedContainerRemovalPolicy;
+export declare function startStellarLocalnet({ env, commandRunner, }: LocalnetLifecycleOptions): Promise<void>;
+/**
+ * Fund a single account from the junk wallet (for ad-hoc test accounts).
+ * Calls are serialized to avoid sequence number conflicts on the junk wallet.
+ */
+export declare function fundAccount(env: StellarTestEnv, publicKey: string): Promise<void>;
+/** Returns true when a destination account was created despite an ambiguous transaction poll. */
+export declare function accountExists(getAccount: (accountId: string) => Promise<unknown>, accountId: string): Promise<boolean>;
+/**
+ * Back off between fundTestAccounts rebuilds so a lagging localnet can confirm
+ * the previous attempt before we burn another try.
+ */
+export declare function pauseBeforeFundingRetry(attempt: number, maxAttempts: number, sleep?: (ms: number) => Promise<void>, intervalMs?: number): Promise<void>;
+export declare function stopStellarLocalnet({ env, commandRunner, }: LocalnetLifecycleOptions): Promise<void>;
+//# sourceMappingURL=localnet.d.ts.map

package/dist/localnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localnet.d.ts","sourceRoot":"","sources":["../src/localnet.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,eAAO,MAAM,8BAA8B,kFACwC,CAAC;AAEpF,eAAO,MAAM,4BAA4B,2CAA2C,CAAC;AAMrF,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAO/C,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,sFAAsF;AACtF,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,mBAAmB,CAAC;AAEnF,MAAM,WAAW,wBAAwB;IACrC,GAAG,EAAE,cAAc,CAAC;IACpB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAW1D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAahE;AAED,wBAAgB,gCAAgC,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhF;AAED,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAQjF;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnE;AAED,wBAAgB,8BAA8B,CAC1C,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC/B,2BAA2B,CAG7B;AAiED,wBAAsB,oBAAoB,CAAC,EACvC,GAAG,EACH,aAAgC,GACnC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB1C;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF;AAkED,iGAAiG;AACjG,wBAAsB,aAAa,CAC/B,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACnD,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CACkB,EACrD,UAAU,GAAE,MAAkC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAIf;AAyGD,wBAAsB,mBAAmB,CAAC,EACtC,GAAG,EACH,aAAgC,GACnC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU1C"}

package/dist/localnet.js

@@ -0,0 +1,5 @@
+export { DEFAULT_STELLAR_LOCALNET_IMAGE, FUNDING_RETRY_INTERVAL_MS, STELLAR_LOCALNET_OWNER_LABEL, accountExists, assertDockerArgs, buildDockerContainerIdLookupArgs, buildDockerOwnershipLabelLookupArgs, buildDockerRemoveArgs, buildDockerRunArgs, fundAccount, getNamedContainerRemovalPolicy, pauseBeforeFundingRetry, startStellarLocalnet, stopStellarLocalnet } from './CYINPPER.js';
+import './TYAJMKGY.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=localnet.js.map
+//# sourceMappingURL=localnet.js.map

package/dist/localnet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"localnet.js"}

package/dist/protocol-global-setup.d.ts

@@ -0,0 +1,58 @@
+import type { StellarTestEnv } from './env.js';
+/** Vitest globalSetup context subset (avoids a hard vitest type dependency in src/). */
+export type ProtocolGlobalSetupContext = {
+    provide: (key: 'chainA' | 'chainB', value: ChainAddresses) => void;
+};
+export interface ProtocolContractModule {
+    /** The generated SDK Client constructor. Validated at the adapter boundary before use. */
+    Client: unknown;
+}
+/**
+ * Protocol contract modules from `@layerzerolabs/lz-v2-stellar-sdk`.
+ * Injected by consumers to avoid a workspace cycle (test-utils ↔ sdk).
+ */
+export interface ProtocolStackModules {
+    endpoint: ProtocolContractModule;
+    treasury: ProtocolContractModule;
+    uln302: ProtocolContractModule;
+    sml: ProtocolContractModule;
+    priceFeed: ProtocolContractModule;
+    executorFeeLib: ProtocolContractModule;
+    dvnFeeLib: ProtocolContractModule;
+    dvn: ProtocolContractModule;
+    executorHelper: ProtocolContractModule;
+    executor: ProtocolContractModule;
+}
+/**
+ * Addresses for a single chain's protocol contracts
+ */
+export interface ChainAddresses {
+    eid: number;
+    endpointV2: string;
+    uln302: string;
+    sml: string;
+    treasury: string;
+    executor: string;
+    executorHelper: string;
+    executorFeeLib: string;
+    priceFeed: string;
+    dvnFeeLib: string;
+    dvn: string;
+}
+export interface ProtocolStackGlobalSetupOptions {
+    /**
+     * Directory containing protocol WASM artifacts, or an async resolver.
+     * Consumers typically resolve via getFullyQualifiedRepoRootPath.
+     */
+    wasmDir: string | (() => string | Promise<string>);
+    /**
+     * Protocol contract modules from `@layerzerolabs/lz-v2-stellar-sdk`.
+     * Passed by the consumer to avoid a workspace dependency cycle.
+     */
+    protocol: ProtocolStackModules;
+}
+/**
+ * Returns a Vitest globalSetup that deploys two protocol stacks and wires them.
+ */
+export declare function createProtocolStackGlobalSetup(env: StellarTestEnv, options: ProtocolStackGlobalSetupOptions): (ctx: ProtocolGlobalSetupContext) => Promise<() => Promise<void>>;
+//# sourceMappingURL=protocol-global-setup.d.ts.map

package/dist/protocol-global-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-global-setup.d.ts","sourceRoot":"","sources":["../src/protocol-global-setup.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG/C,wFAAwF;AACxF,MAAM,MAAM,0BAA0B,GAAG;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CACtE,CAAC;AAqBF,MAAM,WAAW,sBAAsB;IACnC,0FAA0F;IAC1F,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,GAAG,EAAE,sBAAsB,CAAC;IAC5B,SAAS,EAAE,sBAAsB,CAAC;IAClC,cAAc,EAAE,sBAAsB,CAAC;IACvC,SAAS,EAAE,sBAAsB,CAAC;IAClC,GAAG,EAAE,sBAAsB,CAAC;IAC5B,cAAc,EAAE,sBAAsB,CAAC;IACvC,QAAQ,EAAE,sBAAsB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACf;AAikBD,MAAM,WAAW,+BAA+B;IAC5C;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD;;;OAGG;IACH,QAAQ,EAAE,oBAAoB,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC1C,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,+BAA+B,GACzC,CAAC,GAAG,EAAE,0BAA0B,KAAK,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA+EnE"}

package/dist/protocol-global-setup.js

@@ -0,0 +1,7 @@
+export { createProtocolStackGlobalSetup } from './ZWKXKZVT.js';
+import './GAGBEOCZ.js';
+import './CYINPPER.js';
+import './TYAJMKGY.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=protocol-global-setup.js.map
+//# sourceMappingURL=protocol-global-setup.js.map

package/dist/protocol-global-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"protocol-global-setup.js"}

package/dist/scan.d.ts

@@ -0,0 +1,59 @@
+import type { StellarTestEnv } from './env.js';
+/**
+ * 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;
+}
+export declare const DEFAULT_LEDGER_WAIT_ATTEMPTS = 10;
+export declare const DEFAULT_LEDGER_WAIT_DELAY_MS = 1000;
+export type LatestLedgerReader = () => Promise<{
+    sequence: number;
+}>;
+export interface ResolveScanEndLedgerOptions {
+    maxAttempts?: number;
+    delayMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * RPC `getEvents` rejects ranges where start is past the tip, and treats end as
+ * exclusive in practice. Require tip strictly greater than the scan start ledger.
+ */
+export declare function assertValidScanLedgerRange(startLedger: number, endLedger: number): void;
+/**
+ * Ensure latest ledger is strictly after `startLedgerSequence` before scanning.
+ * Returns the tip to use as `endLedger`.
+ */
+export declare function resolveScanEndLedger(getLatestLedger: LatestLedgerReader, startLedgerSequence: number, options?: ResolveScanEndLedgerOptions): Promise<number>;
+/**
+ * Scan for contract events within a ledger range
+ */
+export declare function scanEvents(env: StellarTestEnv, startLedgerSequence: number, filter: EventFilter): Promise<ParsedContractEvent[]>;
+/**
+ * Scan for PacketSent events from the Endpoint contract
+ */
+export declare function scanPacketSentEvents(env: StellarTestEnv, endpointAddress: string, startLedger: number): Promise<PacketSentEvent[]>;
+/**
+ * Wait for new ledgers and scan for events
+ */
+export declare function waitAndScanEvents(env: StellarTestEnv, startLedger: number, contractAddress: string, eventName: string, maxWaitSeconds?: number): Promise<ParsedContractEvent[]>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAErE,MAAM,WAAW,2BAA2B;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAQvF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,eAAe,EAAE,kBAAkB,EACnC,mBAAmB,EAAE,MAAM,EAC3B,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC5B,GAAG,EAAE,cAAc,EACnB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAyChC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,GAAG,EAAE,cAAc,EACnB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CA6D5B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACnC,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,MAAW,GAC5B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAiChC"}

package/dist/scan.js

@@ -0,0 +1,4 @@
+export { DEFAULT_LEDGER_WAIT_ATTEMPTS, DEFAULT_LEDGER_WAIT_DELAY_MS, assertValidScanLedgerRange, resolveScanEndLedger, scanEvents, scanPacketSentEvents, waitAndScanEvents } from './PMDPSIA2.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=scan.js.map
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"scan.js"}

package/dist/secp256k1.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A secp256k1 key pair with private key and derived Ethereum-style address.
+ * Used for DVN multisig signing.
+ */
+export declare class Secp256k1KeyPair {
+    private privateKey;
+    readonly ethAddress: Buffer;
+    constructor(privateKey: Uint8Array | Buffer | string);
+    /**
+     * Generate a random key pair.
+     */
+    static generate(): Secp256k1KeyPair;
+    /**
+     * Derive Ethereum-style address from the public key.
+     * Address = last 20 bytes of keccak256(uncompressed_pubkey[1:65])
+     */
+    private deriveEthAddress;
+    /**
+     * Sign a 32-byte digest and return a 65-byte signature (r || s || v).
+     */
+    sign(digest: Uint8Array): Promise<Buffer>;
+}
+//# sourceMappingURL=secp256k1.d.ts.map

package/dist/secp256k1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secp256k1.d.ts","sourceRoot":"","sources":["../src/secp256k1.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM;IAWpD;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,gBAAgB;IAKnC;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAclD"}

package/dist/secp256k1.js

@@ -0,0 +1,4 @@
+export { Secp256k1KeyPair } from './DNRE4ENZ.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=secp256k1.js.map
+//# sourceMappingURL=secp256k1.js.map

package/dist/secp256k1.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"secp256k1.js"}

package/dist/utils.d.ts

@@ -0,0 +1,54 @@
+import type { contract, Keypair } from '@stellar/stellar-sdk';
+import * as rpc from '@stellar/stellar-sdk/rpc';
+import type { StellarTestEnv } from './env.js';
+import type { Secp256k1KeyPair } from './secp256k1.js';
+export { createClient } from './client.js';
+/**
+ * Helper to get token balance for an address using SAC (Stellar Asset Contract).
+ * Works for any token including native XLM.
+ *
+ * @param tokenAddress - The SAC contract address (defaults to native XLM)
+ * @param accountAddress - The account to check balance for
+ */
+export declare function getTokenBalance(env: StellarTestEnv, accountAddress: string, tokenAddress?: string): Promise<bigint>;
+/**
+ * Helper to get native token (XLM) balance for an address.
+ * Convenience wrapper around getTokenBalance.
+ */
+export declare function getNativeBalance(env: StellarTestEnv, accountAddress: string): Promise<bigint>;
+/**
+ * Helper to check if an account is authorized on a SAC (Stellar Asset Contract).
+ * Calls the SAC's `authorized()` method directly.
+ *
+ * @param accountAddress - The account to check authorization for
+ * @param tokenAddress - The SAC contract address
+ */
+export declare function getTokenAuthorized(env: StellarTestEnv, accountAddress: string, tokenAddress: string): Promise<boolean>;
+/**
+ * Signs the DVN abstract account's auth entries.
+ *
+ * The DVN contract implements CustomAccountInterface with Signature = TransactionAuthData.
+ * TransactionAuthData contains:
+ * - vid: u32 - Verifier ID
+ * - expiration: u64 - Ledger timestamp for when auth expires
+ * - signatures: Vec<BytesN<65>> - Secp256k1 signatures from multisig signers
+ * - sender: Sender - Either None or Admin(public_key, ed25519_signature)
+ */
+export declare function signDvnAuthEntries<T>(dvnAddress: string, vid: number, adminKeypair: Keypair, multisigSigners: Secp256k1KeyPair[], assembledTx: contract.AssembledTransaction<T>, networkPassphrase: string): Promise<void>;
+/**
+ * Signs and sends a transaction with Executor abstract account auth entries.
+ *
+ * The Executor contract implements CustomAccountInterface with Signature = ExecutorSignature.
+ * ExecutorSignature contains:
+ * - public_key: BytesN<32> - Admin's Ed25519 public key
+ * - signature: BytesN<64> - Ed25519 signature over the signature_payload
+ *
+ * This function uses `record_allow_nonroot` simulation mode to capture non-root auth entries,
+ * which is required because the executor authorizes `lz_receive`/`lz_compose` calls that are
+ * invoked by the ExecutorHelper contract (not the root invoker).
+ *
+ * @returns The transaction result after sending
+ */
+export declare function signAndSendWithExecutorAuth<T>(env: StellarTestEnv, executorAddress: string, adminKeypair: Keypair, assembledTx: contract.AssembledTransaction<T>, networkPassphrase?: string): Promise<rpc.Api.GetSuccessfulTransactionResponse>;
+export declare function assertTransactionSucceeded(txResult: rpc.Api.GetTransactionResponse, contextLabel: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAa9D,OAAO,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C;;;;;;GAMG;AACH,wBAAsB,eAAe,CACjC,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,MAAM,EACtB,YAAY,GAAE,MAAiC,GAChD,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACpC,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAMD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACtC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,OAAO,EACrB,eAAe,EAAE,gBAAgB,EAAE,EACnC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAC7C,iBAAiB,EAAE,MAAM,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoJf;AA8GD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAAC,CAAC,EAC/C,GAAG,EAAE,cAAc,EACnB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAC7C,iBAAiB,GAAE,MAA+B,GACnD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAyLnD;AA4BD,wBAAgB,0BAA0B,CACtC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,sBAAsB,EACxC,YAAY,EAAE,MAAM,GACrB,IAAI,CAMN"}

package/dist/utils.js

@@ -0,0 +1,5 @@
+export { assertTransactionSucceeded, getNativeBalance, getTokenAuthorized, getTokenBalance, signAndSendWithExecutorAuth, signDvnAuthEntries } from './VRABOZPX.js';
+export { createClient } from './GAGBEOCZ.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=utils.js.map
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"utils.js"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@layerzerolabs/test-utils-stellar",
+  "version": "0.2.122",
+  "private": false,
+  "description": "Shared Stellar/Soroban test harness (localnet, funding, deploy helpers) for LayerZero V2 protocol SDK and custom OApp/OFT tests",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.js",
+    "default": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@noble/hashes": "^1.8.0",
+    "@noble/secp256k1": "1.7.1",
+    "@stellar/stellar-sdk": "^14.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.6",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.2.6",
+    "@layerzerolabs/tsup-configuration": "0.2.122",
+    "@layerzerolabs/typescript-configuration": "0.2.122"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "externalRepoConfig": {
+    "targets": [
+      "audit-external",
+      "console-pen-test",
+      "monorepo-external",
+      "onesig-client"
+    ]
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)",
+    "test": "vitest --run --pass-with-no-tests --typecheck"
+  }
+}

package/src/client.ts

@@ -0,0 +1,37 @@
+import type { Keypair } from '@stellar/stellar-sdk';
+import { TransactionBuilder } from '@stellar/stellar-sdk';
+
+import type { StellarTestEnv } from './env.js';
+
+/**
+ * Create a Soroban contract client with DEFAULT_DEPLOYER as signer.
+ */
+export function createClient<T>(
+    env: StellarTestEnv,
+    ClientClass: new (options: {
+        contractId: string;
+        publicKey: string;
+        signTransaction: (tx: string) => Promise<{ signedTxXdr: string; signerAddress: string }>;
+        rpcUrl: string;
+        networkPassphrase: string;
+        allowHttp: boolean;
+    }) => T,
+    contractId: string,
+    signer: Keypair = env.DEFAULT_DEPLOYER,
+): T {
+    return new ClientClass({
+        contractId,
+        publicKey: signer.publicKey(),
+        signTransaction: async (tx: string) => {
+            const transaction = TransactionBuilder.fromXDR(tx, env.NETWORK_PASSPHRASE);
+            transaction.sign(signer);
+            return {
+                signedTxXdr: transaction.toXDR(),
+                signerAddress: signer.publicKey(),
+            };
+        },
+        rpcUrl: env.RPC_URL,
+        networkPassphrase: env.NETWORK_PASSPHRASE,
+        allowHttp: true,
+    });
+}