@layerzerolabs/lz-v2-stellar-sdk 0.2.13 → 0.2.18

package/test/suites/constants.ts

@@ -1,6 +1,8 @@
 import { Asset, Keypair, Networks } from '@stellar/stellar-sdk';
 
-const CORE_URL = 'http://localhost:8000';
+import { Secp256k1KeyPair } from '../utils';
+
+const CORE_URL = 'http://localhost:8086';
 export const FRIENDBOT_URL = `${CORE_URL}/friendbot`;
 export const RPC_URL = `${CORE_URL}/rpc`;
 export const NETWORK_PASSPHRASE = Networks.STANDALONE;
@@ -10,8 +12,26 @@ export const DEFAULT_DEPLOYER = Keypair.fromSecret(
 export const ZRO_DISTRIBUTOR = Keypair.fromSecret(
     'SB6QAFXFRR2MXYHW4RRZ23JDGKHDCYCT5YTQEGG3WNT5VKZADJQFVNWG',
 );
-export const EID = 30111;
+// Use deterministic keypair for EXECUTOR_ADMIN to ensure consistency between globalSetup and test files
+// (globalSetup runs in a separate process, so Keypair.random() would generate different keys)
+export const EXECUTOR_ADMIN = Keypair.fromSecret(
+    'SACWJCNRT2AYRPBWW7IBRNI765EMZSWPXXAAHYN57UFQNOXMGET7HM5K',
+);
+
+// DVN secp256k1 signer for multisig (deterministic key for testing)
+// Private key is keccak256("dvn_test_signer") truncated to 32 bytes
+export const DVN_SIGNER = new Secp256k1KeyPair(
+    '0x8d3f8d5d8f1c7e2a5b4c3d6e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a',
+);
+
+// DVN configuration
+export const DVN_VID = 1;
+
+export const EID = 30400;
 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;
+export const MSG_TYPE_COMPOSED = 2;
+export const MSG_TYPE_ABA = 3;
+export const MSG_TYPE_COMPOSED_ABA = 4;

package/test/suites/dummyContractClient.ts

@@ -0,0 +1,169 @@
+import type { Option, u32 } from '@stellar/stellar-sdk/contract';
+import {
+    AssembledTransaction,
+    Client as ContractClient,
+    ClientOptions as ContractClientOptions,
+    MethodOptions,
+    Spec as ContractSpec,
+} from '@stellar/stellar-sdk/contract';
+import { Buffer } from 'buffer';
+export * from '@stellar/stellar-sdk';
+export * as contract from '@stellar/stellar-sdk/contract';
+export * as rpc from '@stellar/stellar-sdk/rpc';
+
+if (typeof window !== 'undefined') {
+    //@ts-ignore Buffer exists
+    window.Buffer = window.Buffer || Buffer;
+}
+
+export const BufferReaderError = {
+    1000: { message: 'InvalidLength' },
+    1001: { message: 'InvalidAddressPayload' },
+};
+
+export const BufferWriterError = {
+    1100: { message: 'InvalidAddressPayload' },
+};
+
+export const TtlError = {
+    1200: { message: 'InvalidTtlConfig' },
+    1201: { message: 'TtlConfigFrozen' },
+    1202: { message: 'TtlConfigAlreadyFrozen' },
+};
+
+export const OwnableError = {
+    1300: { message: 'OwnerAlreadySet' },
+    1301: { message: 'OwnerNotSet' },
+};
+
+export const BytesExtError = {
+    1400: { message: 'LengthMismatch' },
+};
+
+export const UpgradeableError = {
+    1500: { message: 'MigrationNotAllowed' },
+};
+
+export type DefaultOwnableStorage = { tag: 'Owner'; values: void };
+
+/**
+ * A pair of TTL values: threshold (when to trigger extension) and extend_to (target TTL).
+ */
+export interface TtlConfig {
+    /**
+     * Target TTL after extension (in ledgers).
+     */
+    extend_to: u32;
+    /**
+     * TTL threshold that triggers extension (in ledgers).
+     */
+    threshold: u32;
+}
+
+export type TtlConfigStorage =
+    | { tag: 'Frozen'; values: void }
+    | { tag: 'Instance'; values: void }
+    | { tag: 'Persistent'; values: void };
+
+export type UpgradeableStorage = { tag: 'Migrating'; values: void };
+
+export interface Client {
+    /**
+     * Construct and simulate a owner transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
+     */
+    owner: (options?: MethodOptions) => Promise<AssembledTransaction<Option<string>>>;
+
+    /**
+     * Construct and simulate a transfer_ownership transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
+     */
+    transfer_ownership: (
+        { new_owner }: { new_owner: string },
+        options?: MethodOptions,
+    ) => Promise<AssembledTransaction<null>>;
+
+    /**
+     * Construct and simulate a renounce_ownership transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
+     */
+    renounce_ownership: (options?: MethodOptions) => Promise<AssembledTransaction<null>>;
+
+    /**
+     * Construct and simulate a upgrade transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
+     */
+    upgrade: (
+        { new_wasm_hash }: { new_wasm_hash: Buffer },
+        options?: MethodOptions,
+    ) => Promise<AssembledTransaction<null>>;
+
+    /**
+     * Construct and simulate a migrate transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
+     */
+    migrate: (
+        { migration_data }: { migration_data: MigrationData },
+        options?: MethodOptions,
+    ) => Promise<AssembledTransaction<null>>;
+
+    /**
+     * Construct and simulate a counter transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
+     */
+    counter: (options?: MethodOptions) => Promise<AssembledTransaction<u32>>;
+
+    /**
+     * Construct and simulate a counter2 transaction. Returns an `AssembledTransaction` object which will have a `result` field containing the result of the simulation. If this transaction changes contract state, you will need to call `signAndSend()` on the returned object.
+     */
+    counter2: (options?: MethodOptions) => Promise<AssembledTransaction<u32>>;
+}
+export class Client extends ContractClient {
+    static async deploy<T = Client>(
+        /** Options for initializing a Client as well as for calling a method, with extras specific to deploying. */
+        options: MethodOptions &
+            Omit<ContractClientOptions, 'contractId'> & {
+                /** The hash of the Wasm blob, which must already be installed on-chain. */
+                wasmHash: Buffer | string;
+                /** Salt used to generate the contract's ID. Passed through to {@link Operation.createCustomContract}. Default: random. */
+                salt?: Buffer | Uint8Array;
+                /** The format used to decode `wasmHash`, if it's provided as a string. */
+                format?: 'hex' | 'base64';
+            },
+    ): Promise<AssembledTransaction<T>> {
+        return ContractClient.deploy(null, options);
+    }
+    constructor(public readonly options: ContractClientOptions) {
+        super(
+            new ContractSpec([
+                'AAAAAAAAAAAAAAAFb3duZXIAAAAAAAAAAAAAAQAAA+gAAAAT',
+                'AAAAAAAAAAAAAAASdHJhbnNmZXJfb3duZXJzaGlwAAAAAAABAAAAAAAAAAluZXdfb3duZXIAAAAAAAATAAAAAA==',
+                'AAAAAAAAAAAAAAAScmVub3VuY2Vfb3duZXJzaGlwAAAAAAAAAAAAAA==',
+                'AAAAAAAAAAAAAAAHdXBncmFkZQAAAAABAAAAAAAAAA1uZXdfd2FzbV9oYXNoAAAAAAAD7gAAACAAAAAA',
+                'AAAAAAAAAAAAAAAHbWlncmF0ZQAAAAABAAAAAAAAAA5taWdyYXRpb25fZGF0YQAAAAAH0AAAAA1NaWdyYXRpb25EYXRhAAAAAAAAAA==',
+                'AAAAAAAAAAAAAAAHY291bnRlcgAAAAAAAAAAAQAAAAQ=',
+                'AAAAAAAAAAAAAAAIY291bnRlcjIAAAAAAAAAAQAAAAQ=',
+                'AAAABAAAAAAAAAAAAAAAEUJ1ZmZlclJlYWRlckVycm9yAAAAAAAAAgAAAAAAAAANSW52YWxpZExlbmd0aAAAAAAAA+gAAAAAAAAAFUludmFsaWRBZGRyZXNzUGF5bG9hZAAAAAAAA+k=',
+                'AAAABAAAAAAAAAAAAAAAEUJ1ZmZlcldyaXRlckVycm9yAAAAAAAAAQAAAAAAAAAVSW52YWxpZEFkZHJlc3NQYXlsb2FkAAAAAAAETA==',
+                'AAAABAAAAAAAAAAAAAAACFR0bEVycm9yAAAAAwAAAAAAAAAQSW52YWxpZFR0bENvbmZpZwAABLAAAAAAAAAAD1R0bENvbmZpZ0Zyb3plbgAAAASxAAAAAAAAABZUdGxDb25maWdBbHJlYWR5RnJvemVuAAAAAASy',
+                'AAAABAAAAAAAAAAAAAAADE93bmFibGVFcnJvcgAAAAIAAAAAAAAAD093bmVyQWxyZWFkeVNldAAAAAUUAAAAAAAAAAtPd25lck5vdFNldAAAAAUV',
+                'AAAABAAAAAAAAAAAAAAADUJ5dGVzRXh0RXJyb3IAAAAAAAABAAAAAAAAAA5MZW5ndGhNaXNtYXRjaAAAAAAFeA==',
+                'AAAABAAAAAAAAAAAAAAAEFVwZ3JhZGVhYmxlRXJyb3IAAAABAAAAAAAAABNNaWdyYXRpb25Ob3RBbGxvd2VkAAAABdw=',
+                'AAAABQAAACxFdmVudCBlbWl0dGVkIHdoZW4gb3duZXJzaGlwIGlzIHRyYW5zZmVycmVkLgAAAAAAAAAUT3duZXJzaGlwVHJhbnNmZXJyZWQAAAABAAAAFE93bmVyc2hpcFRyYW5zZmVycmVkAAAAAgAAAAAAAAAJb2xkX293bmVyAAAAAAAAEwAAAAAAAAAAAAAACW5ld19vd25lcgAAAAAAABMAAAAAAAAAAg==',
+                'AAAABQAAACpFdmVudCBlbWl0dGVkIHdoZW4gb3duZXJzaGlwIGlzIHJlbm91bmNlZC4AAAAAAAAAAAAST3duZXJzaGlwUmVub3VuY2VkAAAAAAABAAAAEk93bmVyc2hpcFJlbm91bmNlZAAAAAAAAQAAAAAAAAAJb2xkX293bmVyAAAAAAAAEwAAAAAAAAAC',
+                'AAAAAgAAAAAAAAAAAAAAFURlZmF1bHRPd25hYmxlU3RvcmFnZQAAAAAAAAEAAAAAAAAAAAAAAAVPd25lcgAAAA==',
+                'AAAAAQAAAFdBIHBhaXIgb2YgVFRMIHZhbHVlczogdGhyZXNob2xkICh3aGVuIHRvIHRyaWdnZXIgZXh0ZW5zaW9uKSBhbmQgZXh0ZW5kX3RvICh0YXJnZXQgVFRMKS4AAAAAAAAAAAlUdGxDb25maWcAAAAAAAACAAAAKFRhcmdldCBUVEwgYWZ0ZXIgZXh0ZW5zaW9uIChpbiBsZWRnZXJzKS4AAAAJZXh0ZW5kX3RvAAAAAAAABAAAADNUVEwgdGhyZXNob2xkIHRoYXQgdHJpZ2dlcnMgZXh0ZW5zaW9uIChpbiBsZWRnZXJzKS4AAAAACXRocmVzaG9sZAAAAAAAAAQ=',
+                'AAAAAgAAAAAAAAAAAAAAEFR0bENvbmZpZ1N0b3JhZ2UAAAADAAAAAAAAAAAAAAAGRnJvemVuAAAAAAAAAAAAAAAAAAhJbnN0YW5jZQAAAAAAAAAAAAAAClBlcnNpc3RlbnQAAA==',
+                'AAAABQAAACdFdmVudCBlbWl0dGVkIHdoZW4gVFRMIGNvbmZpZ3MgYXJlIHNldC4AAAAAAAAAAA1UdGxDb25maWdzU2V0AAAAAAAAAQAAAA1UdGxDb25maWdzU2V0AAAAAAAAAgAAAAAAAAAIaW5zdGFuY2UAAAPoAAAH0AAAAAlUdGxDb25maWcAAAAAAAAAAAAAAAAAAApwZXJzaXN0ZW50AAAAAAPoAAAH0AAAAAlUdGxDb25maWcAAAAAAAAAAAAAAg==',
+                'AAAABQAAACpFdmVudCBlbWl0dGVkIHdoZW4gVFRMIGNvbmZpZ3MgYXJlIGZyb3plbi4AAAAAAAAAAAAQVHRsQ29uZmlnc0Zyb3plbgAAAAEAAAAQVHRsQ29uZmlnc0Zyb3plbgAAAAAAAAAC',
+                'AAAAAgAAAAAAAAAAAAAAElVwZ3JhZGVhYmxlU3RvcmFnZQAAAAAAAQAAAAAAAAAAAAAACU1pZ3JhdGluZwAAAA==',
+            ]),
+            options,
+        );
+    }
+    public readonly fromJSON = {
+        owner: this.txFromJSON<Option<string>>,
+        transfer_ownership: this.txFromJSON<null>,
+        renounce_ownership: this.txFromJSON<null>,
+        upgrade: this.txFromJSON<null>,
+        migrate: this.txFromJSON<null>,
+        counter: this.txFromJSON<u32>,
+        counter2: this.txFromJSON<u32>,
+    };
+}
+
+export type MigrationData = void;

package/test/suites/globalSetup.ts

@@ -0,0 +1,450 @@
+import path from 'path';
+import type { GlobalSetupContext } from 'vitest/node';
+
+import { getFullyQualifiedRepoRootPath } from '@layerzerolabs/common-node-utils';
+
+import { Client as DvnClient } from '../../src/generated/dvn';
+import { Client as DvnFeeLibClient } from '../../src/generated/dvn_fee_lib';
+import { Client as EndpointClient } from '../../src/generated/endpoint';
+import { Client as ExecutorClient } from '../../src/generated/executor';
+import { Client as ExecutorFeeLibClient } from '../../src/generated/executor_fee_lib';
+import { Client as ExecutorHelperClient } from '../../src/generated/executor_helper';
+import { Client as PriceFeedClient } from '../../src/generated/price_feed';
+import { Client as SMLClient } from '../../src/generated/sml';
+import { Client as TreasuryClient } from '../../src/generated/treasury';
+import { Client as Uln302Client } from '../../src/generated/uln302';
+import {
+    DEFAULT_DEPLOYER,
+    DVN_SIGNER,
+    DVN_VID,
+    EID,
+    EXECUTOR_ADMIN,
+    NATIVE_TOKEN_ADDRESS,
+    ZRO_TOKEN_ADDRESS,
+} from './constants';
+import { deployContract } from './deploy';
+import { startStellarLocalnet, stopStellarLocalnet } from './localnet';
+
+export interface ProtocolAddresses {
+    endpointV2: string;
+    uln302: string;
+    sml: string;
+    treasury: string;
+    executor: string;
+    executorHelper: string;
+    executorFeeLib: string;
+    priceFeed: string;
+    dvnFeeLib: string;
+    dvn: string;
+}
+
+export interface ProtocolClients {
+    endpointClient: EndpointClient;
+    uln302Client: Uln302Client;
+    smlClient: SMLClient;
+    treasuryClient: TreasuryClient;
+    executorClient: ExecutorClient;
+    executorHelperClient: ExecutorHelperClient;
+    executorFeeLibClient: ExecutorFeeLibClient;
+    priceFeedClient: PriceFeedClient;
+    dvnFeeLibClient: DvnFeeLibClient;
+    dvnClient: DvnClient;
+}
+
+// Declare the injection key type for vitest
+declare module 'vitest' {
+    export interface ProvidedContext {
+        protocolAddresses: ProtocolAddresses;
+    }
+}
+
+/**
+ * Deploy all protocol contracts and wire them together
+ * Returns the deployed contract addresses
+ */
+async function deployProtocolContracts(): Promise<{
+    addresses: ProtocolAddresses;
+    clients: ProtocolClients;
+}> {
+    const repoRoot = await getFullyQualifiedRepoRootPath();
+    const wasmDir = path.join(
+        repoRoot,
+        'contracts',
+        'protocol',
+        'stellar',
+        'target',
+        'wasm32v1-none',
+        'release',
+    );
+
+    const addresses: ProtocolAddresses = {
+        endpointV2: '',
+        uln302: '',
+        sml: '',
+        treasury: '',
+        executor: '',
+        executorHelper: '',
+        executorFeeLib: '',
+        priceFeed: '',
+        dvnFeeLib: '',
+        dvn: '',
+    };
+
+    // 1. Deploy Endpoint
+    console.log('🚀 Deploying Endpoint...');
+    const endpointClient = await deployContract<EndpointClient>(
+        EndpointClient,
+        path.join(wasmDir, 'endpoint_v2.wasm'),
+        {
+            eid: EID,
+            owner: DEFAULT_DEPLOYER.publicKey(),
+            native_token: NATIVE_TOKEN_ADDRESS,
+        },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.endpointV2 = endpointClient.options.contractId;
+    console.log('✅ Endpoint deployed:', addresses.endpointV2);
+
+    // 2. Deploy Treasury
+    console.log('🚀 Deploying Treasury...');
+    const treasuryClient = await deployContract<TreasuryClient>(
+        TreasuryClient,
+        path.join(wasmDir, 'treasury.wasm'),
+        { owner: DEFAULT_DEPLOYER.publicKey() },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.treasury = treasuryClient.options.contractId;
+    console.log('✅ Treasury deployed:', addresses.treasury);
+
+    // 3. Deploy ULN302
+    console.log('🚀 Deploying ULN302...');
+    const uln302Client = await deployContract<Uln302Client>(
+        Uln302Client,
+        path.join(wasmDir, 'uln302.wasm'),
+        {
+            owner: DEFAULT_DEPLOYER.publicKey(),
+            endpoint: addresses.endpointV2,
+            treasury: addresses.treasury,
+        },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.uln302 = uln302Client.options.contractId;
+    console.log('✅ ULN302 deployed:', addresses.uln302);
+
+    // 4. Deploy SML (SimpleMessageLib)
+    console.log('🚀 Deploying SimpleMessageLib...');
+    const smlClient = await deployContract<SMLClient>(
+        SMLClient,
+        path.join(wasmDir, 'simple_message_lib.wasm'),
+        {
+            owner: DEFAULT_DEPLOYER.publicKey(),
+            endpoint: addresses.endpointV2,
+            fee_recipient: DEFAULT_DEPLOYER.publicKey(),
+        },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.sml = smlClient.options.contractId;
+    console.log('✅ SimpleMessageLib deployed:', addresses.sml);
+
+    // 5. Deploy Price Feed
+    console.log('🚀 Deploying Price Feed...');
+    const priceFeedClient = await deployContract<PriceFeedClient>(
+        PriceFeedClient,
+        path.join(wasmDir, 'price_feed.wasm'),
+        {
+            owner: DEFAULT_DEPLOYER.publicKey(),
+            price_updater: DEFAULT_DEPLOYER.publicKey(),
+        },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.priceFeed = priceFeedClient.options.contractId;
+    console.log('✅ Price Feed deployed:', addresses.priceFeed);
+
+    // 6. Deploy Executor Fee Lib
+    console.log('🚀 Deploying Executor Fee Lib...');
+    const executorFeeLibClient = await deployContract<ExecutorFeeLibClient>(
+        ExecutorFeeLibClient,
+        path.join(wasmDir, 'executor_fee_lib.wasm'),
+        { owner: DEFAULT_DEPLOYER.publicKey() },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.executorFeeLib = executorFeeLibClient.options.contractId;
+    console.log('✅ Executor Fee Lib deployed:', addresses.executorFeeLib);
+
+    // 7. Deploy DVN Fee Lib
+    console.log('🚀 Deploying DVN Fee Lib...');
+    const dvnFeeLibClient = await deployContract<DvnFeeLibClient>(
+        DvnFeeLibClient,
+        path.join(wasmDir, 'dvn_fee_lib.wasm'),
+        { owner: DEFAULT_DEPLOYER.publicKey() },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.dvnFeeLib = dvnFeeLibClient.options.contractId;
+    console.log('✅ DVN Fee Lib deployed:', addresses.dvnFeeLib);
+
+    // 8. Deploy DVN
+    console.log('🚀 Deploying DVN...');
+    const dvnClient = await deployContract<DvnClient>(
+        DvnClient,
+        path.join(wasmDir, 'dvn.wasm'),
+        {
+            vid: DVN_VID,
+            signers: [DVN_SIGNER.ethAddress],
+            threshold: 1,
+            admins: [DEFAULT_DEPLOYER.publicKey()],
+            supported_msglibs: [addresses.uln302],
+            price_feed: addresses.priceFeed,
+            default_multiplier_bps: 10000,
+            worker_fee_lib: addresses.dvnFeeLib,
+            deposit_address: DEFAULT_DEPLOYER.publicKey(),
+        },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.dvn = dvnClient.options.contractId;
+    console.log('✅ DVN deployed:', addresses.dvn);
+
+    // 9. Deploy Executor Helper
+    console.log('🚀 Deploying Executor Helper...');
+    const executorHelperClient = await deployContract<ExecutorHelperClient>(
+        ExecutorHelperClient,
+        path.join(wasmDir, 'executor_helper.wasm'),
+        undefined,
+        DEFAULT_DEPLOYER,
+    );
+    addresses.executorHelper = executorHelperClient.options.contractId;
+    console.log('✅ Executor Helper deployed:', addresses.executorHelper);
+
+    // 10. Deploy Executor (supports both ULN302 and SML)
+    console.log('🚀 Deploying Executor...');
+    const whitelist = [
+        [addresses.executorHelper, 'native_drop_and_execute'],
+        [addresses.executorHelper, 'execute'],
+        [addresses.executorHelper, 'compose'],
+    ];
+    const executorClient = await deployContract<ExecutorClient>(
+        ExecutorClient,
+        path.join(wasmDir, 'executor.wasm'),
+        {
+            owner: DEFAULT_DEPLOYER.publicKey(),
+            endpoint: addresses.endpointV2,
+            whitelist,
+            admins: [EXECUTOR_ADMIN.publicKey(), DEFAULT_DEPLOYER.publicKey()],
+            message_libs: [addresses.uln302, addresses.sml],
+            price_feed: addresses.priceFeed,
+            default_multiplier_bps: 10000,
+            worker_fee_lib: addresses.executorFeeLib,
+            deposit_address: DEFAULT_DEPLOYER.publicKey(),
+        },
+        DEFAULT_DEPLOYER,
+    );
+    addresses.executor = executorClient.options.contractId;
+    console.log('✅ Executor deployed:', addresses.executor);
+
+    const clients: ProtocolClients = {
+        endpointClient,
+        uln302Client,
+        smlClient,
+        treasuryClient,
+        executorClient,
+        executorHelperClient,
+        executorFeeLibClient,
+        priceFeedClient,
+        dvnFeeLibClient,
+        dvnClient,
+    };
+
+    return { addresses, clients };
+}
+
+/**
+ * Wire protocol contracts (register libraries, set defaults, configure workers)
+ */
+async function wireProtocolContracts(
+    addresses: ProtocolAddresses,
+    clients: ProtocolClients,
+): Promise<void> {
+    const { endpointClient, uln302Client, priceFeedClient, executorClient, dvnClient } = clients;
+
+    console.log('🔗 Wiring protocol contracts...');
+
+    // Register libraries
+    await (await endpointClient.register_library({ new_lib: addresses.uln302 })).signAndSend();
+    await (await endpointClient.register_library({ new_lib: addresses.sml })).signAndSend();
+    console.log('✅ Libraries registered (ULN302 + SML)');
+
+    // Set ZRO token
+    await (await endpointClient.set_zro({ zro: ZRO_TOKEN_ADDRESS })).signAndSend();
+    console.log('✅ ZRO token set');
+
+    // Configure ULN302 executor config FIRST (so is_supported_eid returns true)
+    await (
+        await uln302Client.set_default_executor_configs({
+            params: [
+                {
+                    dst_eid: EID,
+                    config: { executor: addresses.executor, max_message_size: 10000 },
+                },
+            ],
+        })
+    ).signAndSend();
+    console.log('✅ ULN302 executor config set');
+
+    // Configure ULN302 send/receive configs
+    await (
+        await uln302Client.set_default_send_uln_configs({
+            params: [
+                {
+                    eid: EID,
+                    config: {
+                        confirmations: 1n,
+                        required_dvns: [addresses.dvn],
+                        optional_dvns: [],
+                        optional_dvn_threshold: 0,
+                    },
+                },
+            ],
+        })
+    ).signAndSend();
+
+    await (
+        await uln302Client.set_default_receive_uln_configs({
+            params: [
+                {
+                    eid: EID,
+                    config: {
+                        confirmations: 1n,
+                        required_dvns: [addresses.dvn],
+                        optional_dvns: [],
+                        optional_dvn_threshold: 0,
+                    },
+                },
+            ],
+        })
+    ).signAndSend();
+    console.log('✅ ULN302 send/receive configs set');
+
+    // NOW set default send/receive libraries to ULN302 (after configs are set)
+    await (
+        await endpointClient.set_default_send_library({ dst_eid: EID, new_lib: addresses.uln302 })
+    ).signAndSend();
+    await (
+        await endpointClient.set_default_receive_library({
+            src_eid: EID,
+            new_lib: addresses.uln302,
+            grace_period: 0n,
+        })
+    ).signAndSend();
+    console.log('✅ Default libraries set to ULN302');
+
+    // Configure Price Feed
+    await (
+        await priceFeedClient.set_price_ratio_denominator({ denominator: 100000000000000000000n })
+    ).signAndSend();
+    await (
+        await priceFeedClient.set_native_token_price_usd({
+            price_updater: DEFAULT_DEPLOYER.publicKey(),
+            native_token_price_usd: 1000000000000000000n,
+        })
+    ).signAndSend();
+
+    const NORMALIZED_EID = EID % 30000;
+    await (
+        await priceFeedClient.set_price({
+            price_updater: DEFAULT_DEPLOYER.publicKey(),
+            prices: [
+                {
+                    eid: NORMALIZED_EID,
+                    price: {
+                        gas_per_byte: 1,
+                        gas_price_in_unit: 1n,
+                        price_ratio: 100000000000000000000n,
+                    },
+                },
+            ],
+        })
+    ).signAndSend();
+    console.log('✅ Price Feed configured');
+
+    // Configure Executor
+    await (
+        await executorClient.set_dst_config({
+            admin: DEFAULT_DEPLOYER.publicKey(),
+            params: [
+                {
+                    dst_eid: EID,
+                    dst_config: {
+                        floor_margin_usd: 0n,
+                        lz_compose_base_gas: 50000n,
+                        lz_receive_base_gas: 100000n,
+                        multiplier_bps: 10000,
+                        native_cap: 1000000000000n,
+                    },
+                },
+            ],
+        })
+    ).signAndSend();
+    console.log('✅ Executor configured');
+
+    // Configure DVN
+    await (
+        await dvnClient.set_dst_config({
+            admin: DEFAULT_DEPLOYER.publicKey(),
+            params: [
+                {
+                    dst_eid: EID,
+                    config: {
+                        floor_margin_usd: 0n,
+                        gas: 100000n,
+                        multiplier_bps: 10000,
+                    },
+                },
+            ],
+        })
+    ).signAndSend();
+    console.log('✅ DVN configured');
+
+    console.log('🎉 Protocol wiring complete!');
+}
+
+/**
+ * Vitest Global Setup - runs ONCE before all test files
+ * Uses vitest's provide() to share data in memory with test files
+ */
+export default async function globalSetup({
+    provide,
+}: GlobalSetupContext): Promise<() => Promise<void>> {
+    console.log('\n========================================');
+    console.log('🌐 GLOBAL SETUP: Starting Stellar Localnet');
+    console.log('========================================\n');
+
+    await startStellarLocalnet();
+
+    console.log('\n========================================');
+    console.log('📦 GLOBAL SETUP: Deploying Protocol Contracts');
+    console.log('========================================\n');
+
+    const { addresses, clients } = await deployProtocolContracts();
+
+    console.log('\n========================================');
+    console.log('🔗 GLOBAL SETUP: Wiring Protocol Contracts');
+    console.log('========================================\n');
+
+    await wireProtocolContracts(addresses, clients);
+
+    // Provide addresses in memory for test files to access via inject()
+    provide('protocolAddresses', addresses);
+    console.log('\n✅ Protocol addresses provided to tests (in-memory)');
+
+    console.log('\n========================================');
+    console.log('✅ GLOBAL SETUP COMPLETE');
+    console.log('========================================\n');
+
+    // Return teardown function
+    return async () => {
+        console.log('\n========================================');
+        console.log('🛑 GLOBAL TEARDOWN: Stopping Stellar Localnet');
+        console.log('========================================\n');
+
+        await stopStellarLocalnet();
+    };
+}