@stellar/stellar-sdk 16.0.1 → 16.2.0

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

@@ -1 +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;;;;"}
+{"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  /** A single input parameter of a {@link ContractMethod}. */\n  export interface ContractMethodInput {\n    /** the declared parameter name */\n    name: string;\n    /** a human-readable type name, e.g. `U32`, `Address`, or a UDT's name */\n    type: string;\n  }\n\n  /**\n   * A callable method declared in a contract's spec, as returned by\n   * `RpcServer.getContractMethods`.\n   */\n  export interface ContractMethod {\n    /** the on-chain method name */\n    name: string;\n    /** the method's parameters, in declaration order */\n    inputs: ContractMethodInput[];\n    /** human-readable return type name(s); empty when the method returns void */\n    outputs: string[];\n    /** the method's spec doc string, when the contract declares one */\n    doc?: 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/esm/rpc/axios.js

@@ -1,6 +1,6 @@
 import { create as createFetchClient } from '../http-client/fetch-client.js';
 
-const version = "16.0.1";
+const version = "16.2.0";
 function createHttpClient(headers) {
   return createFetchClient({
     headers: {

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

@@ -257,6 +257,25 @@ export declare class RpcServer {
      * ```
      */
     getContractData(contract: string | Address | Contract, key: xdr.ScVal, durability?: Durability): Promise<Api.LedgerEntryResult>;
+    /**
+     * Retrieves the deployed contract instance for a given contract ID.
+     *
+     * The instance describes the contract's executable — either a Wasm hash or
+     * the built-in Stellar Asset Contract — along with its instance storage.
+     *
+     * @param contractId - The contract ID (`C...`) to look up
+     * @returns The contract's `xdr.ScContractInstance`
+     * @throws If the contract instance cannot be found on the network.
+     *
+     * @example
+     * ```ts
+     * const instance = await server.getContractInstance(
+     *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+     * );
+     * console.log(instance.executable().switch().name);
+     * ```
+     */
+    getContractInstance(contractId: string): Promise<xdr.ScContractInstance>;
     /**
      * Retrieves the WASM bytecode for a given contract.
      *
@@ -264,10 +283,14 @@ export declare class RpcServer {
      * deployed on the Soroban network. The WASM bytecode represents the executable
      * code of the contract.
      *
+     * This only works for Wasm-based contracts. A built-in Stellar Asset Contract
+     * (SAC) has no Wasm bytecode on-chain, so this throws for a SAC; use
+     * {@link contract.Client.from} to build a client from the embedded SAC spec.
+     *
      * @param contractId - The contract ID containing the WASM bytecode to retrieve
      * @returns A Buffer containing the WASM bytecode
      * @throws If the contract or its associated WASM bytecode cannot be
-     * found on the network.
+     * found on the network, or if the contract is a Stellar Asset Contract (SAC).
      *
      * @example
      * ```ts
@@ -305,6 +328,86 @@ export declare class RpcServer {
      * ```
      */
     getContractWasmByHash(wasmHash: Buffer | string, format?: undefined | "hex" | "base64"): Promise<Buffer>;
+    /**
+     * Performs a read-only call to a contract method and returns the decoded result.
+     *
+     * This is a convenience wrapper for one-line contract state queries: it builds
+     * a {@link contract.Client} for the contract, simulates the method call, and
+     * returns the spec-decoded return value — no manual transaction assembly,
+     * signing, or submission required.
+     *
+     * Works for both Wasm contracts and built-in Stellar Asset Contracts (SACs):
+     * the embedded SAC spec is used automatically for SACs (see
+     * {@link contract.Client.from}). The query reuses this server's transport
+     * (headers, interceptors, `allowHttp`).
+     *
+     * @typeParam T - the expected (decoded) return type of the method
+     * @param contractId - the contract to query (`C...`)
+     * @param method - the contract method to call
+     * @param args - named arguments for the method, keyed by parameter name
+     *    (omit for methods that take no arguments)
+     * @param networkPassphrase - (optional) the network passphrase. If omitted, a
+     *    request about network information will be made (see {@link getNetwork}).
+     *    You can refer to {@link Networks} for a list of built-in passphrases,
+     *    e.g., `Networks.TESTNET`.
+     * @returns An object with the method's decoded return value (`result`) and
+     *    `isReadCall`: whether this specific call is a side-effect-free read that
+     *    needs no signature (it wrote no state and required no authorization).
+     *    `isReadCall` is per-call, not per-method: it reflects the given `args`.
+     *    Since `queryContract` never signs or sends, `isReadCall: false` means the
+     *    `result` is a simulation preview of a call that would change state.
+     * @throws If the contract has no such method, or if the simulation fails.
+     *
+     * @example
+     * ```ts
+     * const { result: decimals, isReadCall } = await server.queryContract<number>(
+     *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+     *   "decimals",
+     * );
+     * const { result: balance } = await server.queryContract<bigint>(
+     *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+     *   "balance",
+     *   { id: "GA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJVSGZ" },
+     * );
+     * ```
+     */
+    queryContract<T = any>(contractId: string, method: string, args?: Record<string, unknown>, networkPassphrase?: string): Promise<{
+        result: T;
+        isReadCall: boolean;
+    }>;
+    /**
+     * Lists a contract's callable methods and their signatures.
+     *
+     * A discovery helper for tooling, dapps, and agents that need to inspect an
+     * arbitrary contract without knowing its interface up front. It resolves the
+     * contract's spec (embedded in the Wasm for regular contracts, or the
+     * built-in spec for Stellar Asset Contracts — see {@link contract.Client.from})
+     * and reports each declared function's name, inputs, and outputs. No method
+     * is invoked or simulated; this performs only the spec lookup.
+     *
+     * The complement to {@link queryContract}: list methods here, then call a
+     * read-only one with `server.queryContract(contractId, method, args?)`.
+     *
+     * @param contractId - the contract to inspect (`C...`)
+     * @param networkPassphrase - (optional) the network passphrase. If omitted, a
+     *    request about network information will be made (see {@link getNetwork}).
+     *    You can refer to {@link Networks} for a list of built-in passphrases,
+     *    e.g., `Networks.TESTNET`.
+     * @returns The contract's methods, in the order they appear in the spec
+     *
+     * @example
+     * ```ts
+     * const methods = await server.getContractMethods(
+     *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+     * );
+     * // [
+     * //   { name: "decimals", inputs: [], outputs: ["U32"] },
+     * //   { name: "balance", inputs: [{ name: "id", type: "Address" }], outputs: ["I128"] },
+     * //   { name: "transfer", inputs: [...], outputs: [] },
+     * // ]
+     * ```
+     */
+    getContractMethods(contractId: string, networkPassphrase?: string): Promise<Api.ContractMethod[]>;
     /**
      * Reads the current value of arbitrary ledger entries directly.
      *
@@ -518,6 +621,15 @@ export declare class RpcServer {
      *    auth mode to use for simulation: `enforce` for enforcement mode,
      *    `record` for recording mode, or `record_allow_nonroot` for recording
      *    mode that allows non-root authorization
+     * @param useUpgradedAuth - (optional) opt simulation into recording
+     *    v2 address credentials (CAP-71) instead of the legacy v1 address
+     *    credentials. Best-effort: it only affects the recording auth modes and
+     *    is silently ignored on protocol versions whose host cannot emit v2
+     *    credentials.
+     *
+     *    **Deprecated**: this flag is transitional. Once the network returns v2
+     *    credentials by default (protocol 28), it becomes a no-op — do not rely
+     *    on omitting it to keep receiving the legacy v1 format.
      *
      * @returns An object with the
      *    cost, footprint, result/auth requirements (if applicable), and error of
@@ -557,8 +669,8 @@ export declare class RpcServer {
      * });
      * ```
      */
-    simulateTransaction(tx: Transaction | FeeBumpTransaction, addlResources?: RpcServer.ResourceLeeway, authMode?: Api.SimulationAuthMode): Promise<Api.SimulateTransactionResponse>;
-    _simulateTransaction(transaction: Transaction | FeeBumpTransaction, addlResources?: RpcServer.ResourceLeeway, authMode?: Api.SimulationAuthMode): Promise<Api.RawSimulateTransactionResponse>;
+    simulateTransaction(tx: Transaction | FeeBumpTransaction, addlResources?: RpcServer.ResourceLeeway, authMode?: Api.SimulationAuthMode, useUpgradedAuth?: boolean): Promise<Api.SimulateTransactionResponse>;
+    _simulateTransaction(transaction: Transaction | FeeBumpTransaction, addlResources?: RpcServer.ResourceLeeway, authMode?: Api.SimulationAuthMode, useUpgradedAuth?: boolean): Promise<Api.RawSimulateTransactionResponse>;
     /**
      * Submit a trial contract invocation, first run a simulation of the contract
      * invocation as defined on the incoming transaction, and apply the results to

package/lib/esm/rpc/server.js

@@ -59,6 +59,12 @@ function findCreatedAccountSequenceInTransactionMeta(meta) {
   }
   throw new Error("No account created in transaction");
 }
+function contractSpecTypeName(td) {
+  if (td.switch().value === types.ScSpecType.scSpecTypeUdt().value) {
+    return td.udt().name().toString();
+  }
+  return td.switch().name.replace(/^scSpecType/, "");
+}
 class RpcServer {
   serverURL;
   /**
@@ -395,6 +401,35 @@ class RpcServer {
       };
     }
   }
+  /**
+   * Retrieves the deployed contract instance for a given contract ID.
+   *
+   * The instance describes the contract's executable — either a Wasm hash or
+   * the built-in Stellar Asset Contract — along with its instance storage.
+   *
+   * @param contractId - The contract ID (`C...`) to look up
+   * @returns The contract's `xdr.ScContractInstance`
+   * @throws If the contract instance cannot be found on the network.
+   *
+   * @example
+   * ```ts
+   * const instance = await server.getContractInstance(
+   *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+   * );
+   * console.log(instance.executable().switch().name);
+   * ```
+   */
+  async getContractInstance(contractId) {
+    const contractLedgerKey = new Contract(contractId).getFootprint();
+    const response = await this.getLedgerEntries(contractLedgerKey);
+    if (!response.entries.length || !response.entries[0]?.val) {
+      return Promise.reject({
+        code: 404,
+        message: "Could not obtain contract instance from server"
+      });
+    }
+    return response.entries[0].val.contractData().val().instance();
+  }
   /**
    * Retrieves the WASM bytecode for a given contract.
    *
@@ -402,10 +437,14 @@ class RpcServer {
    * deployed on the Soroban network. The WASM bytecode represents the executable
    * code of the contract.
    *
+   * This only works for Wasm-based contracts. A built-in Stellar Asset Contract
+   * (SAC) has no Wasm bytecode on-chain, so this throws for a SAC; use
+   * {@link contract.Client.from} to build a client from the embedded SAC spec.
+   *
    * @param contractId - The contract ID containing the WASM bytecode to retrieve
    * @returns A Buffer containing the WASM bytecode
    * @throws If the contract or its associated WASM bytecode cannot be
-   * found on the network.
+   * found on the network, or if the contract is a Stellar Asset Contract (SAC).
    *
    * @example
    * ```ts
@@ -419,16 +458,14 @@ class RpcServer {
    * ```
    */
   async getContractWasmByContractId(contractId) {
-    const contractLedgerKey = new Contract(contractId).getFootprint();
-    const response = await this.getLedgerEntries(contractLedgerKey);
-    if (!response.entries.length || !response.entries[0]?.val) {
+    const instance = await this.getContractInstance(contractId);
+    if (instance.executable().switch() === types.ContractExecutableType.contractExecutableStellarAsset()) {
       return Promise.reject({
-        code: 404,
-        message: `Could not obtain contract hash from server`
+        code: 400,
+        message: `Contract ${contractId} is a Stellar Asset Contract (SAC), which has no Wasm bytecode. Use contract.Client.from() to build a client from the built-in SAC spec instead.`
       });
     }
-    const wasmHash = response.entries[0].val.contractData().val().instance().executable().wasmHash();
-    return this.getContractWasmByHash(wasmHash);
+    return this.getContractWasmByHash(instance.executable().wasmHash());
   }
   /**
    * Retrieves the WASM bytecode for a given contract hash.
@@ -470,6 +507,124 @@ class RpcServer {
     const wasmBuffer = responseWasm.entries[0].val.contractCode().code();
     return wasmBuffer;
   }
+  /**
+   * Performs a read-only call to a contract method and returns the decoded result.
+   *
+   * This is a convenience wrapper for one-line contract state queries: it builds
+   * a {@link contract.Client} for the contract, simulates the method call, and
+   * returns the spec-decoded return value — no manual transaction assembly,
+   * signing, or submission required.
+   *
+   * Works for both Wasm contracts and built-in Stellar Asset Contracts (SACs):
+   * the embedded SAC spec is used automatically for SACs (see
+   * {@link contract.Client.from}). The query reuses this server's transport
+   * (headers, interceptors, `allowHttp`).
+   *
+   * @typeParam T - the expected (decoded) return type of the method
+   * @param contractId - the contract to query (`C...`)
+   * @param method - the contract method to call
+   * @param args - named arguments for the method, keyed by parameter name
+   *    (omit for methods that take no arguments)
+   * @param networkPassphrase - (optional) the network passphrase. If omitted, a
+   *    request about network information will be made (see {@link getNetwork}).
+   *    You can refer to {@link Networks} for a list of built-in passphrases,
+   *    e.g., `Networks.TESTNET`.
+   * @returns An object with the method's decoded return value (`result`) and
+   *    `isReadCall`: whether this specific call is a side-effect-free read that
+   *    needs no signature (it wrote no state and required no authorization).
+   *    `isReadCall` is per-call, not per-method: it reflects the given `args`.
+   *    Since `queryContract` never signs or sends, `isReadCall: false` means the
+   *    `result` is a simulation preview of a call that would change state.
+   * @throws If the contract has no such method, or if the simulation fails.
+   *
+   * @example
+   * ```ts
+   * const { result: decimals, isReadCall } = await server.queryContract<number>(
+   *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+   *   "decimals",
+   * );
+   * const { result: balance } = await server.queryContract<bigint>(
+   *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+   *   "balance",
+   *   { id: "GA7QYNF7SOWQ3GLR2BGMZEHXAVIRZA4KVWLTJJFC7MGXUA74P7UJVSGZ" },
+   * );
+   * ```
+   */
+  async queryContract(contractId, method, args = {}, networkPassphrase) {
+    const passphrase = networkPassphrase ?? (await this.getNetwork()).passphrase;
+    const { Client } = await import('../contract/client.js');
+    const client = await Client.from({
+      contractId,
+      rpcUrl: this.serverURL.toString(),
+      networkPassphrase: passphrase,
+      server: this
+    });
+    const isContractMethod = client.spec.funcs().some((fn) => fn.name().toString() === method);
+    const { sanitizeIdentifier } = await import('../bindings/utils.js');
+    const invoke = client[sanitizeIdentifier(method)];
+    if (!isContractMethod || typeof invoke !== "function") {
+      throw new TypeError(`Contract ${contractId} has no method '${method}'`);
+    }
+    const assembled = await invoke(args);
+    return { result: assembled.result, isReadCall: assembled.isReadCall };
+  }
+  /**
+   * Lists a contract's callable methods and their signatures.
+   *
+   * A discovery helper for tooling, dapps, and agents that need to inspect an
+   * arbitrary contract without knowing its interface up front. It resolves the
+   * contract's spec (embedded in the Wasm for regular contracts, or the
+   * built-in spec for Stellar Asset Contracts — see {@link contract.Client.from})
+   * and reports each declared function's name, inputs, and outputs. No method
+   * is invoked or simulated; this performs only the spec lookup.
+   *
+   * The complement to {@link queryContract}: list methods here, then call a
+   * read-only one with `server.queryContract(contractId, method, args?)`.
+   *
+   * @param contractId - the contract to inspect (`C...`)
+   * @param networkPassphrase - (optional) the network passphrase. If omitted, a
+   *    request about network information will be made (see {@link getNetwork}).
+   *    You can refer to {@link Networks} for a list of built-in passphrases,
+   *    e.g., `Networks.TESTNET`.
+   * @returns The contract's methods, in the order they appear in the spec
+   *
+   * @example
+   * ```ts
+   * const methods = await server.getContractMethods(
+   *   "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5",
+   * );
+   * // [
+   * //   { name: "decimals", inputs: [], outputs: ["U32"] },
+   * //   { name: "balance", inputs: [{ name: "id", type: "Address" }], outputs: ["I128"] },
+   * //   { name: "transfer", inputs: [...], outputs: [] },
+   * // ]
+   * ```
+   */
+  async getContractMethods(contractId, networkPassphrase) {
+    const passphrase = networkPassphrase ?? (await this.getNetwork()).passphrase;
+    const { Client } = await import('../contract/client.js');
+    const client = await Client.from({
+      contractId,
+      rpcUrl: this.serverURL.toString(),
+      networkPassphrase: passphrase,
+      server: this
+    });
+    return client.spec.funcs().map((fn) => {
+      const doc = fn.doc().toString();
+      const method = {
+        name: fn.name().toString(),
+        inputs: fn.inputs().map((input) => ({
+          name: input.name().toString(),
+          type: contractSpecTypeName(input.type())
+        })),
+        outputs: fn.outputs().map(contractSpecTypeName)
+      };
+      if (doc) {
+        method.doc = doc;
+      }
+      return method;
+    });
+  }
   /**
    * Reads the current value of arbitrary ledger entries directly.
    *
@@ -796,6 +951,15 @@ class RpcServer {
    *    auth mode to use for simulation: `enforce` for enforcement mode,
    *    `record` for recording mode, or `record_allow_nonroot` for recording
    *    mode that allows non-root authorization
+   * @param useUpgradedAuth - (optional) opt simulation into recording
+   *    v2 address credentials (CAP-71) instead of the legacy v1 address
+   *    credentials. Best-effort: it only affects the recording auth modes and
+   *    is silently ignored on protocol versions whose host cannot emit v2
+   *    credentials.
+   *
+   *    **Deprecated**: this flag is transitional. Once the network returns v2
+   *    credentials by default (protocol 28), it becomes a no-op — do not rely
+   *    on omitting it to keep receiving the legacy v1 format.
    *
    * @returns An object with the
    *    cost, footprint, result/auth requirements (if applicable), and error of
@@ -835,12 +999,15 @@ class RpcServer {
    * });
    * ```
    */
-  async simulateTransaction(tx, addlResources, authMode) {
-    return this._simulateTransaction(tx, addlResources, authMode).then(
-      parseRawSimulation
-    );
+  async simulateTransaction(tx, addlResources, authMode, useUpgradedAuth) {
+    return this._simulateTransaction(
+      tx,
+      addlResources,
+      authMode,
+      useUpgradedAuth
+    ).then(parseRawSimulation);
   }
-  async _simulateTransaction(transaction, addlResources, authMode) {
+  async _simulateTransaction(transaction, addlResources, authMode, useUpgradedAuth) {
     return postObject(
       this.httpClient,
       this.serverURL.toString(),
@@ -848,6 +1015,7 @@ class RpcServer {
       {
         transaction: transaction.toXDR(),
         authMode,
+        ...useUpgradedAuth !== void 0 && { useUpgradedAuth },
         ...addlResources !== void 0 && {
           resourceConfig: {
             instructionLeeway: addlResources.cpuInstructions