@layerzerolabs/protocol-stellar-v2 0.2.121 → 0.2.123

package/sdk/test/suites/deploy.ts

@@ -1,312 +0,0 @@
-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.js';
-
-/**
- * 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()) as any;
-        if (result.error) {
-            console.warn(`Warning: 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(
-            `Warning: 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: (
-            argsOrOptions: any,
-            options?: any,
-        ) => Promise<{ signAndSend: () => Promise<{ result: T }> }>;
-    },
-    wasmFilePath: string,
-    constructorArgs: any | undefined,
-    deployer: Keypair,
-    options: {
-        salt?: Buffer;
-        wasmHash?: string;
-        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,
-    });
-
-    let wasmHash = options.wasmHash;
-    if (wasmHash) {
-        console.log('📦 Using pre-uploaded WASM hash:', wasmHash);
-    } else {
-        // 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...');
-        wasmHash = await uploadWasm(wasmBuffer, deployer, server);
-        console.log('✅ WASM uploaded, hash:', wasmHash);
-    }
-
-    // Step 3: Deploy the contract
-    console.log('🚀 Deploying contract...');
-    const deployOptions = {
-        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,
-    };
-    const deployTx =
-        constructorArgs == null
-            ? await ClientClass.deploy(deployOptions)
-            : await ClientClass.deploy(constructorArgs, deployOptions);
-
-    // 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)) {
-        // Soroban returns ExistingValue when the contract is already deployed.
-        // This is expected on container reuse (local dev reruns).
-        if (simulated.error?.includes('ExistingValue')) {
-            console.log(`SAC for ${asset.toString()} already deployed, skipping`);
-            return asset.contractId(NETWORK_PASSPHRASE);
-        }
-        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/dummyContractClient.ts

@@ -1,168 +0,0 @@
-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';
-
-const globalWithBuffer = globalThis as typeof globalThis & { Buffer?: typeof Buffer };
-//@ts-ignore Buffer exists
-globalWithBuffer.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;