@digitalworld/digital-world-sdk 16.0.0

package/lib/axios/esm/rpc/api.d.ts

@@ -0,0 +1,580 @@
+import { Contract, SorobanDataBuilder, xdr } from "../base/index.js";
+export declare namespace Api {
+    export interface GetHealthResponse {
+        latestLedger: number;
+        ledgerRetentionWindow: number;
+        oldestLedger: number;
+        status: "healthy";
+    }
+    export interface LedgerEntryResult {
+        lastModifiedLedgerSeq?: number;
+        key: xdr.LedgerKey;
+        val: xdr.LedgerEntryData;
+        liveUntilLedgerSeq?: number;
+    }
+    export interface RawLedgerEntryResult {
+        lastModifiedLedgerSeq?: number;
+        /** a base-64 encoded {@link xdr.LedgerKey} instance */
+        key: string;
+        /** a base-64 encoded {@link xdr.LedgerEntryData} instance */
+        xdr: string;
+        /**
+         * optional, a future ledger number upon which this entry will expire
+         *  based on https://github.com/stellar/soroban-tools/issues/1010
+         */
+        liveUntilLedgerSeq?: number;
+    }
+    /** An XDR-parsed version of {@link RawLedgerEntryResult} */
+    export interface GetLedgerEntriesResponse {
+        entries: LedgerEntryResult[];
+        latestLedger: number;
+    }
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries */
+    export interface RawGetLedgerEntriesResponse {
+        entries?: RawLedgerEntryResult[];
+        latestLedger: number;
+    }
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getNetwork */
+    export interface GetNetworkResponse {
+        friendbotUrl?: string;
+        passphrase: string;
+        protocolVersion: string;
+    }
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLatestLedger */
+    export interface GetLatestLedgerResponse {
+        id: string;
+        sequence: number;
+        protocolVersion: string;
+        closeTime: string;
+        headerXdr: xdr.LedgerHeader;
+        metadataXdr: xdr.LedgerCloseMeta;
+    }
+    export interface RawGetLatestLedgerResponse {
+        id: string;
+        sequence: number;
+        protocolVersion: string;
+        closeTime: string;
+        /** a base-64 encoded {@link xdr.LedgerHeader} instance */
+        headerXdr: string;
+        /** a base-64 encoded {@link xdr.LedgerCloseMeta} instance */
+        metadataXdr: string;
+    }
+    export enum GetTransactionStatus {
+        SUCCESS = "SUCCESS",
+        NOT_FOUND = "NOT_FOUND",
+        FAILED = "FAILED"
+    }
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction */
+    export type GetTransactionResponse = GetSuccessfulTransactionResponse | GetFailedTransactionResponse | GetMissingTransactionResponse;
+    interface GetAnyTransactionResponse {
+        status: GetTransactionStatus;
+        txHash: string;
+        latestLedger: number;
+        latestLedgerCloseTime: number;
+        oldestLedger: number;
+        oldestLedgerCloseTime: number;
+    }
+    export interface GetMissingTransactionResponse extends GetAnyTransactionResponse {
+        status: GetTransactionStatus.NOT_FOUND;
+    }
+    export interface GetFailedTransactionResponse extends GetAnyTransactionResponse {
+        status: GetTransactionStatus.FAILED;
+        ledger: number;
+        createdAt: number;
+        applicationOrder: number;
+        feeBump: boolean;
+        envelopeXdr: xdr.TransactionEnvelope;
+        resultXdr: xdr.TransactionResult;
+        resultMetaXdr: xdr.TransactionMeta;
+        diagnosticEventsXdr?: xdr.DiagnosticEvent[];
+        events: TransactionEvents;
+    }
+    export interface GetSuccessfulTransactionResponse extends GetAnyTransactionResponse {
+        status: GetTransactionStatus.SUCCESS;
+        ledger: number;
+        createdAt: number;
+        applicationOrder: number;
+        feeBump: boolean;
+        envelopeXdr: xdr.TransactionEnvelope;
+        resultXdr: xdr.TransactionResult;
+        resultMetaXdr: xdr.TransactionMeta;
+        diagnosticEventsXdr?: xdr.DiagnosticEvent[];
+        returnValue?: xdr.ScVal;
+        events: TransactionEvents;
+    }
+    export interface RawGetTransactionResponse {
+        status: GetTransactionStatus;
+        latestLedger: number;
+        latestLedgerCloseTime: number;
+        oldestLedger: number;
+        oldestLedgerCloseTime: number;
+        txHash: string;
+        applicationOrder?: number;
+        feeBump?: boolean;
+        ledger?: number;
+        createdAt?: number;
+        envelopeXdr?: string;
+        resultXdr?: string;
+        resultMetaXdr?: string;
+        diagnosticEventsXdr?: string[];
+        events?: RawTransactionEvents;
+    }
+    export type GetTransactionsRequest = {
+        startLedger: number;
+        pagination?: {
+            cursor?: never;
+            limit?: number;
+        };
+    } | {
+        startLedger?: never;
+        pagination: {
+            cursor: string;
+            limit?: number;
+        };
+    };
+    export interface RawTransactionEvents {
+        transactionEventsXdr?: string[];
+        contractEventsXdr?: string[][];
+    }
+    export interface RawTransactionInfo {
+        status: GetTransactionStatus;
+        ledger: number;
+        createdAt: number;
+        applicationOrder: number;
+        feeBump: boolean;
+        txHash: string;
+        envelopeXdr?: string;
+        resultXdr?: string;
+        resultMetaXdr?: string;
+        diagnosticEventsXdr?: string[];
+        events?: RawTransactionEvents;
+    }
+    export interface TransactionEvents {
+        transactionEventsXdr: xdr.TransactionEvent[];
+        contractEventsXdr: xdr.ContractEvent[][];
+    }
+    export interface TransactionInfo {
+        status: GetTransactionStatus;
+        ledger: number;
+        createdAt: number;
+        applicationOrder: number;
+        feeBump: boolean;
+        txHash: string;
+        envelopeXdr: xdr.TransactionEnvelope;
+        resultXdr: xdr.TransactionResult;
+        resultMetaXdr: xdr.TransactionMeta;
+        returnValue?: xdr.ScVal;
+        diagnosticEventsXdr?: xdr.DiagnosticEvent[];
+        events: TransactionEvents;
+    }
+    export interface GetTransactionsResponse {
+        transactions: TransactionInfo[];
+        latestLedger: number;
+        latestLedgerCloseTimestamp: number;
+        oldestLedger: number;
+        oldestLedgerCloseTimestamp: number;
+        cursor: string;
+    }
+    export interface RawGetTransactionsResponse {
+        transactions: RawTransactionInfo[] | null;
+        latestLedger: number;
+        latestLedgerCloseTimestamp: number;
+        oldestLedger: number;
+        oldestLedgerCloseTimestamp: number;
+        cursor: string;
+    }
+    export type EventType = "contract" | "system";
+    export interface EventFilter {
+        type?: EventType;
+        contractIds?: string[];
+        topics?: string[][];
+    }
+    interface RetentionState {
+        latestLedger: number;
+        oldestLedger: number;
+        latestLedgerCloseTime: string;
+        oldestLedgerCloseTime: string;
+    }
+    /**
+     * Request parameters for fetching events from the Stellar network.
+     *
+     * **Important**: This type enforces mutually exclusive pagination modes:
+     * - **Ledger range mode**: Use `startLedger` and `endLedger` (cursor must be omitted)
+     * - **Cursor pagination mode**: Use `cursor` (startLedger and endLedger must be omitted)
+     *
+     * @example
+     * ```ts
+     * // ✅ Correct: Ledger range mode
+     * const rangeRequest: GetEventsRequest = {
+     *   filters: [],
+     *   startLedger: 1000,
+     *   endLedger: 2000,
+     *   limit: 100
+     * };
+     * ```
+     *
+     * @example
+     * ```ts
+     * // ✅ Correct: Cursor pagination mode
+     * const cursorRequest: GetEventsRequest = {
+     *   filters: [],
+     *   cursor: "some-cursor-value",
+     *   limit: 100
+     * };
+     * ```
+     *
+     * @example
+     * ```ts
+     * // ❌ Invalid: Cannot mix cursor with ledger range
+     * const invalidRequest = {
+     *   filters: [],
+     *   startLedger: 1000,  // ❌ Cannot use with cursor
+     *   endLedger: 2000,    // ❌ Cannot use with cursor
+     *   cursor: "cursor",   // ❌ Cannot use with ledger range
+     *   limit: 100
+     * };
+     * ```
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getEvents | getEvents API reference}
+     */
+    export type GetEventsRequest = {
+        filters: Api.EventFilter[];
+        startLedger: number;
+        endLedger?: number;
+        cursor?: never;
+        limit?: number;
+    } | {
+        filters: Api.EventFilter[];
+        cursor: string;
+        startLedger?: never;
+        endLedger?: never;
+        limit?: number;
+    };
+    export interface GetEventsResponse extends RetentionState {
+        events: EventResponse[];
+        cursor: string;
+    }
+    export interface EventResponse extends BaseEventResponse {
+        contractId?: Contract;
+        topic: xdr.ScVal[];
+        value: xdr.ScVal;
+    }
+    export interface RawGetEventsResponse extends RetentionState {
+        events: RawEventResponse[];
+        cursor: string;
+    }
+    interface BaseEventResponse {
+        id: string;
+        type: EventType;
+        ledger: number;
+        ledgerClosedAt: string;
+        transactionIndex: number;
+        operationIndex: number;
+        inSuccessfulContractCall: boolean;
+        txHash: string;
+    }
+    export interface RawEventResponse extends BaseEventResponse {
+        contractId: string;
+        topic?: string[];
+        value: string;
+    }
+    interface RawLedgerEntryChange {
+        type: number;
+        /** This is LedgerKey in base64 */
+        key: string;
+        /** This is xdr.LedgerEntry in base64 */
+        before: string | null;
+        /** This is xdr.LedgerEntry in base64 */
+        after: string | null;
+    }
+    export interface LedgerEntryChange {
+        type: number;
+        key: xdr.LedgerKey;
+        before: xdr.LedgerEntry | null;
+        after: xdr.LedgerEntry | null;
+    }
+    export type SendTransactionStatus = "PENDING" | "DUPLICATE" | "TRY_AGAIN_LATER" | "ERROR";
+    export interface SendTransactionResponse extends BaseSendTransactionResponse {
+        errorResult?: xdr.TransactionResult;
+        diagnosticEvents?: xdr.DiagnosticEvent[];
+    }
+    export interface RawSendTransactionResponse extends BaseSendTransactionResponse {
+        /**
+         * This is a base64-encoded instance of {@link xdr.TransactionResult}, set
+         * only when `status` is `"ERROR"`.
+         *
+         * It contains details on why the network rejected the transaction.
+         */
+        errorResultXdr?: string;
+        /**
+         * This is a base64-encoded instance of an array of
+         * {@link xdr.DiagnosticEvent}s, set only when `status` is `"ERROR"` and
+         * diagnostic events are enabled on the server.
+         */
+        diagnosticEventsXdr?: string[];
+    }
+    export interface BaseSendTransactionResponse {
+        status: SendTransactionStatus;
+        hash: string;
+        latestLedger: number;
+        latestLedgerCloseTime: number;
+    }
+    export interface SimulateHostFunctionResult {
+        auth: xdr.SorobanAuthorizationEntry[];
+        retval: xdr.ScVal;
+    }
+    export type SimulationAuthMode = "enforce" | "record" | "record_allow_nonroot";
+    /**
+     * Simplifies {@link RawSimulateTransactionResponse} into separate interfaces
+     * based on status:
+     *   - on success, this includes all fields, though `result` is only present
+     *     if an invocation was simulated (since otherwise there's nothing to
+     *     "resultify")
+     *   - if there was an expiration error, this includes error and restoration
+     *     fields
+     *   - for all other errors, this only includes error fields
+     *
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction
+     */
+    export type SimulateTransactionResponse = SimulateTransactionSuccessResponse | SimulateTransactionRestoreResponse | SimulateTransactionErrorResponse;
+    export interface BaseSimulateTransactionResponse {
+        /** always present: the JSON-RPC request ID */
+        id: string;
+        /** always present: the LCL known to the server when responding */
+        latestLedger: number;
+        /**
+         * The field is always present, but may be empty in cases where:
+         *   - you didn't simulate an invocation or
+         *   - there were no events
+         */
+        events: xdr.DiagnosticEvent[];
+        /** a private field to mark the schema as parsed */
+        _parsed: boolean;
+    }
+    /** Includes simplified fields only present on success. */
+    export interface SimulateTransactionSuccessResponse extends BaseSimulateTransactionResponse {
+        transactionData: SorobanDataBuilder;
+        minResourceFee: string;
+        /** present only for invocation simulation */
+        result?: SimulateHostFunctionResult;
+        /** State Difference information */
+        stateChanges?: LedgerEntryChange[];
+    }
+    /** Includes details about why the simulation failed */
+    export interface SimulateTransactionErrorResponse extends BaseSimulateTransactionResponse {
+        error: string;
+        events: xdr.DiagnosticEvent[];
+    }
+    export interface SimulateTransactionRestoreResponse extends SimulateTransactionSuccessResponse {
+        result: SimulateHostFunctionResult;
+        /**
+         * Indicates that a restoration is necessary prior to submission.
+         *
+         * In other words, seeing a restoration preamble means that your invocation
+         * was executed AS IF the required ledger entries were present, and this
+         * field includes information about what you need to restore for the
+         * simulation to succeed.
+         */
+        restorePreamble: {
+            minResourceFee: string;
+            transactionData: SorobanDataBuilder;
+        };
+    }
+    /**
+     * Checks if a simulation response indicates an error.
+     * @param sim - The simulation response to check.
+     * @returns True if the response indicates an error, false otherwise.
+     */
+    export function isSimulationError(sim: SimulateTransactionResponse): sim is SimulateTransactionErrorResponse;
+    /**
+     * Checks if a simulation response indicates success.
+     * @param sim - The simulation response to check.
+     * @returns True if the response indicates success, false otherwise.
+     */
+    export function isSimulationSuccess(sim: SimulateTransactionResponse): sim is SimulateTransactionSuccessResponse;
+    /**
+     * Checks if a simulation response indicates that a restoration is needed.
+     * @param sim - The simulation response to check.
+     * @returns True if the response indicates a restoration is needed, false otherwise.
+     */
+    export function isSimulationRestore(sim: SimulateTransactionResponse): sim is SimulateTransactionRestoreResponse;
+    /**
+     * Checks if a simulation response is in raw (unparsed) form.
+     * @param sim - The simulation response to check.
+     * @returns True if the response is raw, false otherwise.
+     */
+    export function isSimulationRaw(sim: Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse): sim is Api.RawSimulateTransactionResponse;
+    interface RawSimulateHostFunctionResult {
+        auth?: string[];
+        xdr: string;
+    }
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction */
+    export interface RawSimulateTransactionResponse {
+        id: string;
+        latestLedger: number;
+        error?: string;
+        /** This is an xdr.SorobanTransactionData in base64 */
+        transactionData?: string;
+        /** These are xdr.DiagnosticEvents in base64 */
+        events?: string[];
+        minResourceFee?: string;
+        /**
+         * This will only contain a single element if present, because only a single
+         * invokeHostFunctionOperation is supported per transaction.
+         * */
+        results?: RawSimulateHostFunctionResult[];
+        /** Present if succeeded but has expired ledger entries */
+        restorePreamble?: {
+            minResourceFee: string;
+            transactionData: string;
+        };
+        /** State difference information */
+        stateChanges?: RawLedgerEntryChange[];
+    }
+    export interface GetVersionInfoResponse {
+        version: string;
+        commitHash: string;
+        buildTimestamp: string;
+        captiveCoreVersion: string;
+        protocolVersion: number;
+        commit_hash: string;
+        build_timestamp: string;
+        captive_core_version: string;
+        protocol_version: number;
+    }
+    export interface GetFeeStatsResponse {
+        sorobanInclusionFee: FeeDistribution;
+        inclusionFee: FeeDistribution;
+        latestLedger: number;
+    }
+    interface FeeDistribution {
+        max: string;
+        min: string;
+        mode: string;
+        p10: string;
+        p20: string;
+        p30: string;
+        p40: string;
+        p50: string;
+        p60: string;
+        p70: string;
+        p80: string;
+        p90: string;
+        p95: string;
+        p99: string;
+        transactionCount: string;
+        ledgerCount: number;
+    }
+    export interface BalanceResponse {
+        latestLedger: number;
+        /** present only on success, otherwise request malformed or no balance */
+        balanceEntry?: {
+            /** a 64-bit integer for trustlines, 128-bit value for contracts */
+            amount: string;
+            authorized: boolean;
+            clawback: boolean;
+            authorizedToMaintainLiabilities?: boolean;
+            /** @deprecated Please use `authorizedToMaintainLiabilities` instead */
+            revocable?: boolean;
+            lastModifiedLedgerSeq?: number;
+            liveUntilLedgerSeq?: number;
+        };
+    }
+    /**
+     * Request parameters for fetching a sequential list of ledgers.
+     *
+     * This type supports two distinct pagination modes that are mutually exclusive:
+     * - **Ledger-based pagination**: Use `startLedger` to begin fetching from a specific ledger sequence
+     * - **Cursor-based pagination**: Use `cursor` to continue from a previous response's pagination token
+     *
+     * @example
+     * ```ts
+     * // Ledger-based pagination - start from specific ledger
+     * const ledgerRequest: GetLedgersRequest = {
+     *   startLedger: 36233,
+     *   pagination: {
+     *     limit: 10
+     *   }
+     * };
+     * ```
+     *
+     * @example
+     * ```ts
+     * // Cursor-based pagination - continue from previous response
+     * const cursorRequest: GetLedgersRequest = {
+     *   pagination: {
+     *     cursor: "36234",
+     *     limit: 5
+     *   }
+     * };
+     * ```
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgers | getLedgers API reference}
+     */
+    export type GetLedgersRequest = {
+        /**
+         * Ledger sequence number to start fetching from (inclusive).
+         * Must be omitted if cursor is provided. Cannot be less than the oldest ledger or greater
+         * than the latest ledger stored on the RPC node.
+         */
+        startLedger: number;
+        /** Pagination configuration for the request. */
+        pagination?: {
+            cursor?: never;
+            /**
+             * Maximum number of ledgers to return per page.
+             * Valid range: 1-10000. Defaults to 100 if not specified.
+             */
+            limit?: number;
+        };
+    } | {
+        startLedger?: never;
+        /** Pagination configuration for the request. */
+        pagination: {
+            /**
+             * Page cursor for continuing pagination from a previous
+             * response. Must be omitted if startLedger is provided.
+             */
+            cursor: string;
+            /**
+             * Maximum number of ledgers to return per page.
+             * Valid range: 1-10000. Defaults to 100 if not specified.
+             */
+            limit?: number;
+        };
+    };
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgers */
+    export interface GetLedgersResponse {
+        ledgers: LedgerResponse[];
+        latestLedger: number;
+        latestLedgerCloseTime: number;
+        oldestLedger: number;
+        oldestLedgerCloseTime: number;
+        cursor: string;
+    }
+    export interface RawGetLedgersResponse {
+        ledgers: RawLedgerResponse[];
+        latestLedger: number;
+        latestLedgerCloseTime: number;
+        oldestLedger: number;
+        oldestLedgerCloseTime: number;
+        cursor: string;
+    }
+    export interface LedgerResponse {
+        hash: string;
+        sequence: number;
+        ledgerCloseTime: string;
+        headerXdr: xdr.LedgerHeaderHistoryEntry;
+        metadataXdr: xdr.LedgerCloseMeta;
+    }
+    export interface RawLedgerResponse {
+        hash: string;
+        sequence: number;
+        ledgerCloseTime: string;
+        /** a base-64 encoded {@link xdr.LedgerHeaderHistoryEntry} instance */
+        headerXdr: string;
+        /** a base-64 encoded {@link xdr.LedgerCloseMeta} instance */
+        metadataXdr: string;
+    }
+    export {};
+}

package/lib/axios/esm/rpc/api.js

@@ -0,0 +1,27 @@
+var Api;
+((Api2) => {
+  ((GetTransactionStatus2) => {
+    GetTransactionStatus2["SUCCESS"] = "SUCCESS";
+    GetTransactionStatus2["NOT_FOUND"] = "NOT_FOUND";
+    GetTransactionStatus2["FAILED"] = "FAILED";
+  })(Api2.GetTransactionStatus || (Api2.GetTransactionStatus = {}));
+  function isSimulationError(sim) {
+    return "error" in sim;
+  }
+  Api2.isSimulationError = isSimulationError;
+  function isSimulationSuccess(sim) {
+    return "transactionData" in sim;
+  }
+  Api2.isSimulationSuccess = isSimulationSuccess;
+  function isSimulationRestore(sim) {
+    return isSimulationSuccess(sim) && "restorePreamble" in sim && !!sim.restorePreamble.transactionData;
+  }
+  Api2.isSimulationRestore = isSimulationRestore;
+  function isSimulationRaw(sim) {
+    return !sim._parsed;
+  }
+  Api2.isSimulationRaw = isSimulationRaw;
+})(Api || (Api = {}));
+
+export { Api };
+//# sourceMappingURL=api.js.map

package/lib/axios/esm/rpc/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sources":["../../../../src/rpc/api.ts"],"sourcesContent":["import { Contract, SorobanDataBuilder, xdr } from \"../base/index.js\";\n\n/* tslint:disable-next-line:no-namespace */\nexport namespace Api {\n  export interface GetHealthResponse {\n    latestLedger: number;\n    ledgerRetentionWindow: number;\n    oldestLedger: number;\n    status: \"healthy\";\n  }\n\n  export interface LedgerEntryResult {\n    lastModifiedLedgerSeq?: number;\n    key: xdr.LedgerKey;\n    val: xdr.LedgerEntryData;\n    liveUntilLedgerSeq?: number;\n  }\n\n  export interface RawLedgerEntryResult {\n    lastModifiedLedgerSeq?: number;\n    /** a base-64 encoded {@link xdr.LedgerKey} instance */\n    key: string;\n    /** a base-64 encoded {@link xdr.LedgerEntryData} instance */\n    xdr: string;\n    /**\n     * optional, a future ledger number upon which this entry will expire\n     *  based on https://github.com/stellar/soroban-tools/issues/1010\n     */\n    liveUntilLedgerSeq?: number;\n  }\n\n  /** An XDR-parsed version of {@link RawLedgerEntryResult} */\n  export interface GetLedgerEntriesResponse {\n    entries: LedgerEntryResult[];\n    latestLedger: number;\n  }\n\n  /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries */\n  export interface RawGetLedgerEntriesResponse {\n    entries?: RawLedgerEntryResult[];\n    latestLedger: number;\n  }\n\n  /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getNetwork */\n  export interface GetNetworkResponse {\n    friendbotUrl?: string;\n    passphrase: string;\n    protocolVersion: string;\n  }\n\n  /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLatestLedger */\n  export interface GetLatestLedgerResponse {\n    id: string;\n    sequence: number;\n    protocolVersion: string;\n    closeTime: string;\n    headerXdr: xdr.LedgerHeader;\n    metadataXdr: xdr.LedgerCloseMeta;\n  }\n\n  export interface RawGetLatestLedgerResponse {\n    id: string;\n    sequence: number;\n    protocolVersion: string;\n    closeTime: string;\n    /** a base-64 encoded {@link xdr.LedgerHeader} instance */\n    headerXdr: string;\n    /** a base-64 encoded {@link xdr.LedgerCloseMeta} instance */\n    metadataXdr: string;\n  }\n\n  export enum GetTransactionStatus {\n    SUCCESS = \"SUCCESS\",\n    NOT_FOUND = \"NOT_FOUND\",\n    FAILED = \"FAILED\",\n  }\n\n  /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction */\n  export type GetTransactionResponse =\n    | GetSuccessfulTransactionResponse\n    | GetFailedTransactionResponse\n    | GetMissingTransactionResponse;\n\n  interface GetAnyTransactionResponse {\n    status: GetTransactionStatus;\n    txHash: string;\n    latestLedger: number;\n    latestLedgerCloseTime: number;\n    oldestLedger: number;\n    oldestLedgerCloseTime: number;\n  }\n\n  export interface GetMissingTransactionResponse extends GetAnyTransactionResponse {\n    status: GetTransactionStatus.NOT_FOUND;\n  }\n\n  export interface GetFailedTransactionResponse extends GetAnyTransactionResponse {\n    status: GetTransactionStatus.FAILED;\n\n    ledger: number;\n    createdAt: number;\n    applicationOrder: number;\n    feeBump: boolean;\n    envelopeXdr: xdr.TransactionEnvelope;\n    resultXdr: xdr.TransactionResult;\n    resultMetaXdr: xdr.TransactionMeta;\n    diagnosticEventsXdr?: xdr.DiagnosticEvent[];\n    events: TransactionEvents;\n  }\n\n  export interface GetSuccessfulTransactionResponse extends GetAnyTransactionResponse {\n    status: GetTransactionStatus.SUCCESS;\n\n    ledger: number;\n    createdAt: number;\n    applicationOrder: number;\n    feeBump: boolean;\n    envelopeXdr: xdr.TransactionEnvelope;\n    resultXdr: xdr.TransactionResult;\n    resultMetaXdr: xdr.TransactionMeta;\n    diagnosticEventsXdr?: xdr.DiagnosticEvent[];\n\n    returnValue?: xdr.ScVal; // present iff resultMeta is a v3|v4\n    events: TransactionEvents;\n  }\n\n  export interface RawGetTransactionResponse {\n    status: GetTransactionStatus;\n    latestLedger: number;\n    latestLedgerCloseTime: number;\n    oldestLedger: number;\n    oldestLedgerCloseTime: number;\n    txHash: string;\n\n    // the fields below are set if status is SUCCESS\n    applicationOrder?: number;\n    feeBump?: boolean;\n    ledger?: number;\n    createdAt?: number;\n\n    envelopeXdr?: string;\n    resultXdr?: string;\n    resultMetaXdr?: string;\n    diagnosticEventsXdr?: string[];\n\n    events?: RawTransactionEvents;\n  }\n\n  export type GetTransactionsRequest =\n    | {\n        startLedger: number;\n        pagination?: {\n          cursor?: never;\n          limit?: number;\n        };\n      }\n    | {\n        startLedger?: never;\n        pagination: {\n          cursor: string;\n          limit?: number;\n        };\n      };\n\n  export interface RawTransactionEvents {\n    transactionEventsXdr?: string[];\n    contractEventsXdr?: string[][];\n  }\n\n  export interface RawTransactionInfo {\n    status: GetTransactionStatus;\n    ledger: number;\n    createdAt: number;\n    applicationOrder: number;\n    feeBump: boolean;\n    txHash: string;\n\n    envelopeXdr?: string;\n    resultXdr?: string;\n    resultMetaXdr?: string;\n    diagnosticEventsXdr?: string[];\n\n    events?: RawTransactionEvents;\n  }\n\n  export interface TransactionEvents {\n    transactionEventsXdr: xdr.TransactionEvent[];\n    contractEventsXdr: xdr.ContractEvent[][];\n  }\n\n  export interface TransactionInfo {\n    status: GetTransactionStatus;\n    ledger: number;\n    createdAt: number;\n    applicationOrder: number;\n    feeBump: boolean;\n    txHash: string;\n\n    envelopeXdr: xdr.TransactionEnvelope;\n    resultXdr: xdr.TransactionResult;\n    resultMetaXdr: xdr.TransactionMeta;\n    returnValue?: xdr.ScVal;\n    diagnosticEventsXdr?: xdr.DiagnosticEvent[];\n\n    events: TransactionEvents;\n  }\n\n  export interface GetTransactionsResponse {\n    transactions: TransactionInfo[];\n    latestLedger: number;\n    latestLedgerCloseTimestamp: number;\n    oldestLedger: number;\n    oldestLedgerCloseTimestamp: number;\n    cursor: string;\n  }\n\n  export interface RawGetTransactionsResponse {\n    transactions: RawTransactionInfo[] | null;\n    latestLedger: number;\n    latestLedgerCloseTimestamp: number;\n    oldestLedger: number;\n    oldestLedgerCloseTimestamp: number;\n    cursor: string;\n  }\n\n  export type EventType = \"contract\" | \"system\";\n\n  export interface EventFilter {\n    type?: EventType;\n    contractIds?: string[];\n    topics?: string[][];\n  }\n\n  interface RetentionState {\n    latestLedger: number;\n    oldestLedger: number;\n    latestLedgerCloseTime: string;\n    oldestLedgerCloseTime: string;\n  }\n\n  /**\n   * Request parameters for fetching events from the Stellar network.\n   *\n   * **Important**: This type enforces mutually exclusive pagination modes:\n   * - **Ledger range mode**: Use `startLedger` and `endLedger` (cursor must be omitted)\n   * - **Cursor pagination mode**: Use `cursor` (startLedger and endLedger must be omitted)\n   *\n   * @example\n   * ```ts\n   * // ✅ Correct: Ledger range mode\n   * const rangeRequest: GetEventsRequest = {\n   *   filters: [],\n   *   startLedger: 1000,\n   *   endLedger: 2000,\n   *   limit: 100\n   * };\n   * ```\n   *\n   * @example\n   * ```ts\n   * // ✅ Correct: Cursor pagination mode\n   * const cursorRequest: GetEventsRequest = {\n   *   filters: [],\n   *   cursor: \"some-cursor-value\",\n   *   limit: 100\n   * };\n   * ```\n   *\n   * @example\n   * ```ts\n   * // ❌ Invalid: Cannot mix cursor with ledger range\n   * const invalidRequest = {\n   *   filters: [],\n   *   startLedger: 1000,  // ❌ Cannot use with cursor\n   *   endLedger: 2000,    // ❌ Cannot use with cursor\n   *   cursor: \"cursor\",   // ❌ Cannot use with ledger range\n   *   limit: 100\n   * };\n   * ```\n   *\n   * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getEvents | getEvents API reference}\n   */\n  export type GetEventsRequest =\n    | {\n        filters: Api.EventFilter[];\n        startLedger: number;\n        endLedger?: number;\n        cursor?: never; // explicitly exclude cursor\n        limit?: number;\n      }\n    | {\n        filters: Api.EventFilter[];\n        cursor: string;\n        startLedger?: never; // explicitly exclude startLedger\n        endLedger?: never; // explicitly exclude endLedger\n        limit?: number;\n      };\n\n  export interface GetEventsResponse extends RetentionState {\n    events: EventResponse[];\n    cursor: string;\n  }\n\n  export interface EventResponse extends BaseEventResponse {\n    contractId?: Contract;\n    topic: xdr.ScVal[];\n    value: xdr.ScVal;\n  }\n\n  export interface RawGetEventsResponse extends RetentionState {\n    events: RawEventResponse[];\n    cursor: string;\n  }\n\n  interface BaseEventResponse {\n    id: string;\n    type: EventType;\n    ledger: number;\n    ledgerClosedAt: string;\n    transactionIndex: number;\n    operationIndex: number;\n    inSuccessfulContractCall: boolean;\n    txHash: string;\n  }\n\n  export interface RawEventResponse extends BaseEventResponse {\n    contractId: string;\n    topic?: string[];\n    value: string;\n  }\n\n  interface RawLedgerEntryChange {\n    type: number;\n    /** This is LedgerKey in base64 */\n    key: string;\n    /** This is xdr.LedgerEntry in base64 */\n    before: string | null;\n    /** This is xdr.LedgerEntry in base64 */\n    after: string | null;\n  }\n\n  export interface LedgerEntryChange {\n    type: number;\n    key: xdr.LedgerKey;\n    before: xdr.LedgerEntry | null;\n    after: xdr.LedgerEntry | null;\n  }\n\n  export type SendTransactionStatus =\n    | \"PENDING\"\n    | \"DUPLICATE\"\n    | \"TRY_AGAIN_LATER\"\n    | \"ERROR\";\n\n  export interface SendTransactionResponse extends BaseSendTransactionResponse {\n    errorResult?: xdr.TransactionResult;\n    diagnosticEvents?: xdr.DiagnosticEvent[];\n  }\n\n  export interface RawSendTransactionResponse extends BaseSendTransactionResponse {\n    /**\n     * This is a base64-encoded instance of {@link xdr.TransactionResult}, set\n     * only when `status` is `\"ERROR\"`.\n     *\n     * It contains details on why the network rejected the transaction.\n     */\n    errorResultXdr?: string;\n    /**\n     * This is a base64-encoded instance of an array of\n     * {@link xdr.DiagnosticEvent}s, set only when `status` is `\"ERROR\"` and\n     * diagnostic events are enabled on the server.\n     */\n    diagnosticEventsXdr?: string[];\n  }\n\n  export interface BaseSendTransactionResponse {\n    status: SendTransactionStatus;\n    hash: string;\n    latestLedger: number;\n    latestLedgerCloseTime: number;\n  }\n\n  export interface SimulateHostFunctionResult {\n    auth: xdr.SorobanAuthorizationEntry[];\n    retval: xdr.ScVal;\n  }\n\n  export type SimulationAuthMode =\n    | \"enforce\"\n    | \"record\"\n    | \"record_allow_nonroot\";\n\n  /**\n   * Simplifies {@link RawSimulateTransactionResponse} into separate interfaces\n   * based on status:\n   *   - on success, this includes all fields, though `result` is only present\n   *     if an invocation was simulated (since otherwise there's nothing to\n   *     \"resultify\")\n   *   - if there was an expiration error, this includes error and restoration\n   *     fields\n   *   - for all other errors, this only includes error fields\n   *\n   * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction\n   */\n  export type SimulateTransactionResponse =\n    | SimulateTransactionSuccessResponse\n    | SimulateTransactionRestoreResponse\n    | SimulateTransactionErrorResponse;\n\n  export interface BaseSimulateTransactionResponse {\n    /** always present: the JSON-RPC request ID */\n    id: string;\n\n    /** always present: the LCL known to the server when responding */\n    latestLedger: number;\n\n    /**\n     * The field is always present, but may be empty in cases where:\n     *   - you didn't simulate an invocation or\n     *   - there were no events\n     */\n    events: xdr.DiagnosticEvent[];\n\n    /** a private field to mark the schema as parsed */\n    _parsed: boolean;\n  }\n\n  /** Includes simplified fields only present on success. */\n  export interface SimulateTransactionSuccessResponse extends BaseSimulateTransactionResponse {\n    transactionData: SorobanDataBuilder;\n    minResourceFee: string;\n\n    /** present only for invocation simulation */\n    result?: SimulateHostFunctionResult;\n\n    /** State Difference information */\n    stateChanges?: LedgerEntryChange[];\n  }\n\n  /** Includes details about why the simulation failed */\n  export interface SimulateTransactionErrorResponse extends BaseSimulateTransactionResponse {\n    error: string;\n    events: xdr.DiagnosticEvent[];\n  }\n\n  export interface SimulateTransactionRestoreResponse extends SimulateTransactionSuccessResponse {\n    result: SimulateHostFunctionResult; // not optional now\n\n    /**\n     * Indicates that a restoration is necessary prior to submission.\n     *\n     * In other words, seeing a restoration preamble means that your invocation\n     * was executed AS IF the required ledger entries were present, and this\n     * field includes information about what you need to restore for the\n     * simulation to succeed.\n     */\n    restorePreamble: {\n      minResourceFee: string;\n      transactionData: SorobanDataBuilder;\n    };\n  }\n\n  /**\n   * Checks if a simulation response indicates an error.\n   * @param sim - The simulation response to check.\n   * @returns True if the response indicates an error, false otherwise.\n   */\n  export function isSimulationError(\n    sim: SimulateTransactionResponse,\n  ): sim is SimulateTransactionErrorResponse {\n    return \"error\" in sim;\n  }\n\n  /**\n   * Checks if a simulation response indicates success.\n   * @param sim - The simulation response to check.\n   * @returns True if the response indicates success, false otherwise.\n   */\n  export function isSimulationSuccess(\n    sim: SimulateTransactionResponse,\n  ): sim is SimulateTransactionSuccessResponse {\n    return \"transactionData\" in sim;\n  }\n\n  /**\n   * Checks if a simulation response indicates that a restoration is needed.\n   * @param sim - The simulation response to check.\n   * @returns True if the response indicates a restoration is needed, false otherwise.\n   */\n  export function isSimulationRestore(\n    sim: SimulateTransactionResponse,\n  ): sim is SimulateTransactionRestoreResponse {\n    return (\n      isSimulationSuccess(sim) &&\n      \"restorePreamble\" in sim &&\n      !!sim.restorePreamble.transactionData\n    );\n  }\n\n  /**\n   * Checks if a simulation response is in raw (unparsed) form.\n   * @param sim - The simulation response to check.\n   * @returns True if the response is raw, false otherwise.\n   */\n  export function isSimulationRaw(\n    sim: Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse,\n  ): sim is Api.RawSimulateTransactionResponse {\n    return !(sim as Api.SimulateTransactionResponse)._parsed;\n  }\n\n  interface RawSimulateHostFunctionResult {\n    // each string is SorobanAuthorizationEntry XDR in base64\n    auth?: string[];\n    // invocation return value: the ScVal in base64\n    xdr: string;\n  }\n\n  /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction */\n  export interface RawSimulateTransactionResponse {\n    id: string;\n    latestLedger: number;\n    error?: string;\n    /** This is an xdr.SorobanTransactionData in base64 */\n    transactionData?: string;\n    /** These are xdr.DiagnosticEvents in base64 */\n    events?: string[];\n    minResourceFee?: string;\n    /**\n     * This will only contain a single element if present, because only a single\n     * invokeHostFunctionOperation is supported per transaction.\n     * */\n    results?: RawSimulateHostFunctionResult[];\n    /** Present if succeeded but has expired ledger entries */\n    restorePreamble?: {\n      minResourceFee: string;\n      transactionData: string;\n    };\n\n    /** State difference information */\n    stateChanges?: RawLedgerEntryChange[];\n  }\n\n  export interface GetVersionInfoResponse {\n    version: string;\n    commitHash: string;\n    buildTimestamp: string;\n    captiveCoreVersion: string;\n    protocolVersion: number; // uint32\n\n    /// @deprecated\n    commit_hash: string;\n    /// @deprecated\n    build_timestamp: string;\n    /// @deprecated\n    captive_core_version: string;\n    /// @deprecated\n    protocol_version: number; // uint32\n  }\n\n  export interface GetFeeStatsResponse {\n    sorobanInclusionFee: FeeDistribution;\n    inclusionFee: FeeDistribution;\n    latestLedger: number; // uint32\n  }\n\n  interface FeeDistribution {\n    max: string; // uint64\n    min: string; // uint64\n    mode: string; // uint64\n    p10: string; // uint64\n    p20: string; // uint64\n    p30: string; // uint64\n    p40: string; // uint64\n    p50: string; // uint64\n    p60: string; // uint64\n    p70: string; // uint64\n    p80: string; // uint64\n    p90: string; // uint64\n    p95: string; // uint64\n    p99: string; // uint64\n\n    transactionCount: string; // uint32\n    ledgerCount: number; // uint32\n  }\n\n  export interface BalanceResponse {\n    latestLedger: number;\n    /** present only on success, otherwise request malformed or no balance */\n    balanceEntry?: {\n      /** a 64-bit integer for trustlines, 128-bit value for contracts */\n      amount: string;\n      authorized: boolean;\n      clawback: boolean;\n      authorizedToMaintainLiabilities?: boolean; // only present for trustlines\n      /** @deprecated Please use `authorizedToMaintainLiabilities` instead */\n      revocable?: boolean;\n      lastModifiedLedgerSeq?: number;\n      liveUntilLedgerSeq?: number;\n    };\n  }\n\n  /**\n   * Request parameters for fetching a sequential list of ledgers.\n   *\n   * This type supports two distinct pagination modes that are mutually exclusive:\n   * - **Ledger-based pagination**: Use `startLedger` to begin fetching from a specific ledger sequence\n   * - **Cursor-based pagination**: Use `cursor` to continue from a previous response's pagination token\n   *\n   * @example\n   * ```ts\n   * // Ledger-based pagination - start from specific ledger\n   * const ledgerRequest: GetLedgersRequest = {\n   *   startLedger: 36233,\n   *   pagination: {\n   *     limit: 10\n   *   }\n   * };\n   * ```\n   *\n   * @example\n   * ```ts\n   * // Cursor-based pagination - continue from previous response\n   * const cursorRequest: GetLedgersRequest = {\n   *   pagination: {\n   *     cursor: \"36234\",\n   *     limit: 5\n   *   }\n   * };\n   * ```\n   *\n   * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgers | getLedgers API reference}\n   */\n  export type GetLedgersRequest =\n    | {\n        /**\n         * Ledger sequence number to start fetching from (inclusive).\n         * Must be omitted if cursor is provided. Cannot be less than the oldest ledger or greater\n         * than the latest ledger stored on the RPC node.\n         */\n        startLedger: number;\n        /** Pagination configuration for the request. */\n        pagination?: {\n          cursor?: never;\n          /**\n           * Maximum number of ledgers to return per page.\n           * Valid range: 1-10000. Defaults to 100 if not specified.\n           */\n          limit?: number;\n        };\n      }\n    | {\n        startLedger?: never;\n        /** Pagination configuration for the request. */\n        pagination: {\n          /**\n           * Page cursor for continuing pagination from a previous\n           * response. Must be omitted if startLedger is provided.\n           */\n          cursor: string;\n          /**\n           * Maximum number of ledgers to return per page.\n           * Valid range: 1-10000. Defaults to 100 if not specified.\n           */\n          limit?: number;\n        };\n      };\n\n  /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgers */\n  export interface GetLedgersResponse {\n    ledgers: LedgerResponse[];\n    latestLedger: number;\n    latestLedgerCloseTime: number;\n    oldestLedger: number;\n    oldestLedgerCloseTime: number;\n    cursor: string;\n  }\n\n  export interface RawGetLedgersResponse {\n    ledgers: RawLedgerResponse[];\n    latestLedger: number;\n    latestLedgerCloseTime: number;\n    oldestLedger: number;\n    oldestLedgerCloseTime: number;\n    cursor: string;\n  }\n\n  export interface LedgerResponse {\n    hash: string;\n    sequence: number;\n    ledgerCloseTime: string;\n    headerXdr: xdr.LedgerHeaderHistoryEntry;\n    metadataXdr: xdr.LedgerCloseMeta;\n  }\n\n  export interface RawLedgerResponse {\n    hash: string;\n    sequence: number;\n    ledgerCloseTime: string;\n    /** a base-64 encoded {@link xdr.LedgerHeaderHistoryEntry} instance */\n    headerXdr: string;\n    /** a base-64 encoded {@link xdr.LedgerCloseMeta} instance */\n    metadataXdr: string;\n  }\n}\n"],"names":["Api","GetTransactionStatus"],"mappings":"AAGO,IAAU;AAAA,CAAV,CAAUA,IAAAA,KAAV;AAoEE,EAAA,CAAA,CAAKC,qBAAAA,KAAL;AACL,IAAAA,sBAAA,SAAA,CAAA,GAAU,SAAA;AACV,IAAAA,sBAAA,WAAA,CAAA,GAAY,WAAA;AACZ,IAAAA,sBAAA,QAAA,CAAA,GAAS,QAAA;AAAA,EAAA,CAAA,EAHCD,IAAAA,CAAA,oBAAA,KAAAA,IAAAA,CAAA,oBAAA,GAAA,EAAA,CAAA,CAAA;AA4YL,EAAA,SAAS,kBACd,GAAA,EACyC;AACzC,IAAA,OAAO,OAAA,IAAW,GAAA;AAAA,EACpB;AAJO,EAAAA,IAAAA,CAAS,iBAAA,GAAA,iBAAA;AAWT,EAAA,SAAS,oBACd,GAAA,EAC2C;AAC3C,IAAA,OAAO,iBAAA,IAAqB,GAAA;AAAA,EAC9B;AAJO,EAAAA,IAAAA,CAAS,mBAAA,GAAA,mBAAA;AAWT,EAAA,SAAS,oBACd,GAAA,EAC2C;AAC3C,IAAA,OACE,mBAAA,CAAoB,GAAG,CAAA,IACvB,iBAAA,IAAqB,OACrB,CAAC,CAAC,IAAI,eAAA,CAAgB,eAAA;AAAA,EAE1B;AARO,EAAAA,IAAAA,CAAS,mBAAA,GAAA,mBAAA;AAeT,EAAA,SAAS,gBACd,GAAA,EAC2C;AAC3C,IAAA,OAAO,CAAE,GAAA,CAAwC,OAAA;AAAA,EACnD;AAJO,EAAAA,IAAAA,CAAS,eAAA,GAAA,eAAA;AAAA,CAAA,EArfD,GAAA,KAAA,GAAA,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/axios/esm/rpc/axios.d.ts

@@ -0,0 +1,3 @@
+import { type HttpClient } from "../http-client/index.js";
+export declare const version: string;
+export declare function createHttpClient(headers?: Record<string, string>): HttpClient;

package/lib/axios/esm/rpc/axios.js

@@ -0,0 +1,15 @@
+import { create } from '../http-client/axios-client.js';
+
+const version = "16.0.0";
+function createHttpClient(headers) {
+  return create({
+    headers: {
+      ...headers,
+      "X-Client-Name": "digital-world-js-sdk",
+      "X-Client-Version": version
+    }
+  });
+}
+
+export { createHttpClient, version };
+//# sourceMappingURL=axios.js.map

package/lib/axios/esm/rpc/axios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios.js","sources":["../../../../src/rpc/axios.ts"],"sourcesContent":["import { create, type HttpClient } from \"../http-client/index.js\";\n\ndeclare const __PACKAGE_VERSION__: string;\nexport const version = __PACKAGE_VERSION__;\n\nexport function createHttpClient(headers?: Record<string, string>): HttpClient {\n  return create({\n    headers: {\n      ...headers,\n      \"X-Client-Name\": \"digital-world-js-sdk\",\n      \"X-Client-Version\": version,\n    },\n  });\n}\n"],"names":[],"mappings":";;AAGO,MAAM,OAAA,GAAU;AAEhB,SAAS,iBAAiB,OAAA,EAA8C;AAC7E,EAAA,OAAO,MAAA,CAAO;AAAA,IACZ,OAAA,EAAS;AAAA,MACP,GAAG,OAAA;AAAA,MACH,eAAA,EAAiB,sBAAA;AAAA,MACjB,kBAAA,EAAoB;AAAA;AACtB,GACD,CAAA;AACH;;;;"}