@digitalworld/digital-world-sdk 16.0.0 → 16.0.1

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 Digital World 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/esm/rpc/axios.js

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

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

@@ -1,2 +1,2 @@
 export * from "./index.js";
-export * as StellarBase from "../base/index.js";
+export * as DigitalWorldBase from "../base/index.js";

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

@@ -87,7 +87,7 @@ export declare class RpcServer {
     readonly httpClient: HttpClient;
     constructor(serverURL: string, opts?: RpcServer.Options);
     /**
-     * Fetch a minimal set of current info about a Stellar account.
+     * Fetch a minimal set of current info about a Digital World account.
      *
      * Needed to get the current sequence number for the account so you can build
      * a successful transaction with {@link TransactionBuilder}.
@@ -108,7 +108,7 @@ export declare class RpcServer {
      */
     getAccount(address: string): Promise<Account>;
     /**
-     * Fetch the full account entry for a Stellar account.
+     * Fetch the full account entry for a Digital World account.
      *
      * @param address - The public address of the account to load.
      * @returns Resolves to the full on-chain account
@@ -127,7 +127,7 @@ export declare class RpcServer {
      */
     getAccountEntry(address: string): Promise<xdr.AccountEntry>;
     /**
-     * Fetch the full trustline entry for a Stellar account.
+     * Fetch the full trustline entry for a Digital World account.
      *
      * @param account - The public address of the account whose trustline it is
      * @param asset - The trustline's asset
@@ -152,7 +152,7 @@ export declare class RpcServer {
      */
     getTrustline(account: string, asset: Asset): Promise<xdr.TrustLineEntry>;
     /**
-     * Fetch the full claimable balance entry for a Stellar account.
+     * Fetch the full claimable balance entry for a Digital World account.
      *
      * @param id - The strkey (`B...`) or hex (`00000000abcde...`) (both
      *    IDs with and without the 000... version prefix are accepted) of the
@@ -535,15 +535,15 @@ export declare class RpcServer {
      * @example
      * ```ts
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-     * const contract = new StellarSdk.Contract(contractId);
+     * const contract = new DigitalWorldSdk.Contract(contractId);
      *
      * // Right now, this is just the default fee for this example.
-     * const fee = StellarSdk.BASE_FEE;
-     * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+     * const fee = DigitalWorldSdk.BASE_FEE;
+     * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
      *   // Uncomment the following line to build transactions for the live network. Be
      *   // sure to also change the horizon hostname.
-     *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-     *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+     *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+     *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
      *   .setTimeout(30) // valid for the next 30s
      *   // Add an operation to call increment() on the contract
      *   .addOperation(contract.call("increment"))
@@ -600,15 +600,15 @@ export declare class RpcServer {
      * @example
      * ```ts
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-     * const contract = new StellarSdk.Contract(contractId);
+     * const contract = new DigitalWorldSdk.Contract(contractId);
      *
      * // Right now, this is just the default fee for this example.
-     * const fee = StellarSdk.BASE_FEE;
-     * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+     * const fee = DigitalWorldSdk.BASE_FEE;
+     * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
      *   // Uncomment the following line to build transactions for the live network. Be
      *   // sure to also change the horizon hostname.
-     *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-     *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+     *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+     *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
      *   .setTimeout(30) // valid for the next 30s
      *   // Add an operation to call increment() on the contract
      *   .addOperation(contract.call("increment"))
@@ -619,8 +619,8 @@ export declare class RpcServer {
      * // Sign this transaction with the secret key
      * // NOTE: signing is transaction is network specific. Test network transactions
      * // won't work in the public network. To switch networks, use the Network object
-     * // as explained above (look for StellarSdk.Network).
-     * const sourceKeypair = StellarSdk.Keypair.fromSecret(sourceSecretKey);
+     * // as explained above (look for DigitalWorldSdk.Network).
+     * const sourceKeypair = DigitalWorldSdk.Keypair.fromSecret(sourceSecretKey);
      * preparedTransaction.sign(sourceKeypair);
      *
      * server.sendTransaction(transaction).then(result => {
@@ -632,7 +632,7 @@ export declare class RpcServer {
      */
     prepareTransaction(tx: Transaction | FeeBumpTransaction): Promise<Transaction>;
     /**
-     * Submit a real transaction to the Stellar network.
+     * Submit a real transaction to the Digital World network.
      *
      * Unlike Horizon, RPC does not wait for transaction completion. It
      * simply validates the transaction and enqueues it. Clients should call
@@ -649,15 +649,15 @@ export declare class RpcServer {
      * @example
      * ```ts
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-     * const contract = new StellarSdk.Contract(contractId);
+     * const contract = new DigitalWorldSdk.Contract(contractId);
      *
      * // Right now, this is just the default fee for this example.
-     * const fee = StellarSdk.BASE_FEE;
-     * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+     * const fee = DigitalWorldSdk.BASE_FEE;
+     * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
      *   // Uncomment the following line to build transactions for the live network. Be
      *   // sure to also change the horizon hostname.
-     *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-     *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+     *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+     *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
      *   .setTimeout(30) // valid for the next 30s
      *   // Add an operation to call increment() on the contract
      *   .addOperation(contract.call("increment"))
@@ -666,8 +666,8 @@ export declare class RpcServer {
      * // Sign this transaction with the secret key
      * // NOTE: signing is transaction is network specific. Test network transactions
      * // won't work in the public network. To switch networks, use the Network object
-     * // as explained above (look for StellarSdk.Network).
-     * const sourceKeypair = StellarSdk.Keypair.fromSecret(sourceSecretKey);
+     * // as explained above (look for DigitalWorldSdk.Network).
+     * const sourceKeypair = DigitalWorldSdk.Keypair.fromSecret(sourceSecretKey);
      * transaction.sign(sourceKeypair);
      *
      * server.sendTransaction(transaction).then((result) => {
@@ -716,10 +716,10 @@ export declare class RpcServer {
      *
      * This method supports both account (G...) and contract (C...) addresses.
      *
-     * @param address - The address to fund. Can be either a Stellar
+     * @param address - The address to fund. Can be either a Digital World
      *    account (G...) or contract (C...) address.
      * @param faucetUrl - (optional) Optionally, an explicit faucet URL
-     *    (by default: this calls the Stellar RPC
+     *    (by default: this calls the Digital World RPC
      *    {@link rpc.Server.getNetwork | getNetwork} method to try to
      *    discover this network's faucet url).
      * @returns The transaction

package/lib/esm/rpc/server.js

@@ -88,7 +88,7 @@ class RpcServer {
     }
   }
   /**
-   * Fetch a minimal set of current info about a Stellar account.
+   * Fetch a minimal set of current info about a Digital World account.
    *
    * Needed to get the current sequence number for the account so you can build
    * a successful transaction with {@link TransactionBuilder}.
@@ -112,7 +112,7 @@ class RpcServer {
     return new Account(address, entry.seqNum().toString());
   }
   /**
-   * Fetch the full account entry for a Stellar account.
+   * Fetch the full account entry for a Digital World account.
    *
    * @param address - The public address of the account to load.
    * @returns Resolves to the full on-chain account
@@ -143,7 +143,7 @@ class RpcServer {
     }
   }
   /**
-   * Fetch the full trustline entry for a Stellar account.
+   * Fetch the full trustline entry for a Digital World account.
    *
    * @param account - The public address of the account whose trustline it is
    * @param asset - The trustline's asset
@@ -183,7 +183,7 @@ class RpcServer {
     }
   }
   /**
-   * Fetch the full claimable balance entry for a Stellar account.
+   * Fetch the full claimable balance entry for a Digital World account.
    *
    * @param id - The strkey (`B...`) or hex (`00000000abcde...`) (both
    *    IDs with and without the 000... version prefix are accepted) of the
@@ -813,15 +813,15 @@ class RpcServer {
    * @example
    * ```ts
    * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-   * const contract = new StellarSdk.Contract(contractId);
+   * const contract = new DigitalWorldSdk.Contract(contractId);
    *
    * // Right now, this is just the default fee for this example.
-   * const fee = StellarSdk.BASE_FEE;
-   * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+   * const fee = DigitalWorldSdk.BASE_FEE;
+   * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
    *   // Uncomment the following line to build transactions for the live network. Be
    *   // sure to also change the horizon hostname.
-   *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-   *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+   *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+   *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
    *   .setTimeout(30) // valid for the next 30s
    *   // Add an operation to call increment() on the contract
    *   .addOperation(contract.call("increment"))
@@ -897,15 +897,15 @@ class RpcServer {
    * @example
    * ```ts
    * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-   * const contract = new StellarSdk.Contract(contractId);
+   * const contract = new DigitalWorldSdk.Contract(contractId);
    *
    * // Right now, this is just the default fee for this example.
-   * const fee = StellarSdk.BASE_FEE;
-   * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+   * const fee = DigitalWorldSdk.BASE_FEE;
+   * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
    *   // Uncomment the following line to build transactions for the live network. Be
    *   // sure to also change the horizon hostname.
-   *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-   *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+   *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+   *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
    *   .setTimeout(30) // valid for the next 30s
    *   // Add an operation to call increment() on the contract
    *   .addOperation(contract.call("increment"))
@@ -916,8 +916,8 @@ class RpcServer {
    * // Sign this transaction with the secret key
    * // NOTE: signing is transaction is network specific. Test network transactions
    * // won't work in the public network. To switch networks, use the Network object
-   * // as explained above (look for StellarSdk.Network).
-   * const sourceKeypair = StellarSdk.Keypair.fromSecret(sourceSecretKey);
+   * // as explained above (look for DigitalWorldSdk.Network).
+   * const sourceKeypair = DigitalWorldSdk.Keypair.fromSecret(sourceSecretKey);
    * preparedTransaction.sign(sourceKeypair);
    *
    * server.sendTransaction(transaction).then(result => {
@@ -935,7 +935,7 @@ class RpcServer {
     return assembleTransaction(tx, simResponse).build();
   }
   /**
-   * Submit a real transaction to the Stellar network.
+   * Submit a real transaction to the Digital World network.
    *
    * Unlike Horizon, RPC does not wait for transaction completion. It
    * simply validates the transaction and enqueues it. Clients should call
@@ -952,15 +952,15 @@ class RpcServer {
    * @example
    * ```ts
    * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-   * const contract = new StellarSdk.Contract(contractId);
+   * const contract = new DigitalWorldSdk.Contract(contractId);
    *
    * // Right now, this is just the default fee for this example.
-   * const fee = StellarSdk.BASE_FEE;
-   * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+   * const fee = DigitalWorldSdk.BASE_FEE;
+   * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
    *   // Uncomment the following line to build transactions for the live network. Be
    *   // sure to also change the horizon hostname.
-   *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-   *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+   *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+   *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
    *   .setTimeout(30) // valid for the next 30s
    *   // Add an operation to call increment() on the contract
    *   .addOperation(contract.call("increment"))
@@ -969,8 +969,8 @@ class RpcServer {
    * // Sign this transaction with the secret key
    * // NOTE: signing is transaction is network specific. Test network transactions
    * // won't work in the public network. To switch networks, use the Network object
-   * // as explained above (look for StellarSdk.Network).
-   * const sourceKeypair = StellarSdk.Keypair.fromSecret(sourceSecretKey);
+   * // as explained above (look for DigitalWorldSdk.Network).
+   * const sourceKeypair = DigitalWorldSdk.Keypair.fromSecret(sourceSecretKey);
    * transaction.sign(sourceKeypair);
    *
    * server.sendTransaction(transaction).then((result) => {
@@ -1026,6 +1026,11 @@ class RpcServer {
    */
   async requestAirdrop(address, faucetUrl) {
     const account = typeof address === "string" ? address : address.accountId();
+    if (!StrKey.isValidEd25519PublicKey(account) && !StrKey.isValidContract(account)) {
+      throw new Error(
+        `Invalid address: ${account}. Expected a Digital World account (G...) or contract (C...) address.`
+      );
+    }
     faucetUrl = faucetUrl || (await this.getNetwork()).friendbotUrl;
     if (!faucetUrl) {
       throw new Error("No faucet URL configured for current network");
@@ -1063,10 +1068,10 @@ class RpcServer {
    *
    * This method supports both account (G...) and contract (C...) addresses.
    *
-   * @param address - The address to fund. Can be either a Stellar
+   * @param address - The address to fund. Can be either a Digital World
    *    account (G...) or contract (C...) address.
    * @param faucetUrl - (optional) Optionally, an explicit faucet URL
-   *    (by default: this calls the Stellar RPC
+   *    (by default: this calls the Digital World RPC
    *    {@link rpc.Server.getNetwork | getNetwork} method to try to
    *    discover this network's faucet url).
    * @returns The transaction
@@ -1093,7 +1098,7 @@ class RpcServer {
   async fundAddress(address, faucetUrl) {
     if (!StrKey.isValidEd25519PublicKey(address) && !StrKey.isValidContract(address)) {
       throw new Error(
-        `Invalid address: ${address}. Expected a Stellar account (G...) or contract (C...) address.`
+        `Invalid address: ${address}. Expected a Digital World account (G...) or contract (C...) address.`
       );
     }
     faucetUrl = faucetUrl || (await this.getNetwork()).friendbotUrl;