@stellar/stellar-sdk 14.2.0 → 14.3.1

package/lib/no-eventsource/horizon/trades_call_builder.js

@@ -19,10 +19,10 @@ function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? O
 function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
 function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
 var TradesCallBuilder = exports.TradesCallBuilder = function (_CallBuilder) {
-  function TradesCallBuilder(serverUrl) {
+  function TradesCallBuilder(serverUrl, httpClient) {
     var _this;
     _classCallCheck(this, TradesCallBuilder);
-    _this = _callSuper(this, TradesCallBuilder, [serverUrl, "trades"]);
+    _this = _callSuper(this, TradesCallBuilder, [serverUrl, httpClient, "trades"]);
     _this.url.segment("trades");
     return _this;
   }

package/lib/no-eventsource/horizon/transaction_call_builder.d.ts

@@ -1,5 +1,6 @@
 import { CallBuilder } from "./call_builder";
 import { ServerApi } from "./server_api";
+import { HttpClient } from "../http-client";
 /**
  * Creates a new {@link TransactionCallBuilder} pointed to server defined by serverUrl.
  *
@@ -14,7 +15,7 @@ import { ServerApi } from "./server_api";
  * @param {string} serverUrl Horizon server URL.
  */
 export declare class TransactionCallBuilder extends CallBuilder<ServerApi.CollectionPage<ServerApi.TransactionRecord>> {
-    constructor(serverUrl: URI);
+    constructor(serverUrl: URI, httpClient: HttpClient);
     /**
      * The transaction details endpoint provides information on a single transaction. The transaction hash provided in the hash argument specifies which transaction to load.
      * @see {@link https://developers.stellar.org/docs/data/horizon/api-reference/resources/retrieve-a-transaction|Transaction Details}

package/lib/no-eventsource/horizon/transaction_call_builder.js

@@ -19,10 +19,10 @@ function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? O
 function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
 function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
 var TransactionCallBuilder = exports.TransactionCallBuilder = function (_CallBuilder) {
-  function TransactionCallBuilder(serverUrl) {
+  function TransactionCallBuilder(serverUrl, httpClient) {
     var _this;
     _classCallCheck(this, TransactionCallBuilder);
-    _this = _callSuper(this, TransactionCallBuilder, [serverUrl, "transactions"]);
+    _this = _callSuper(this, TransactionCallBuilder, [serverUrl, httpClient, "transactions"]);
     _this.url.segment("transactions");
     return _this;
   }
@@ -30,7 +30,7 @@ var TransactionCallBuilder = exports.TransactionCallBuilder = function (_CallBui
   return _createClass(TransactionCallBuilder, [{
     key: "transaction",
     value: function transaction(transactionId) {
-      var builder = new _call_builder.CallBuilder(this.url.clone());
+      var builder = new _call_builder.CallBuilder(this.url.clone(), this.httpClient);
       builder.filter.push([transactionId]);
       return builder;
     }

package/lib/no-eventsource/rpc/api.d.ts

@@ -179,6 +179,55 @@ export declare namespace Api {
         latestLedgerCloseTime: string;
         oldestLedgerCloseTime: string;
     }
+    /**
+     * Request parameters for fetching events from the Stellar network.
+     *
+     * **Important**: This type enforces mutually exclusive pagination modes:
+     * - **Ledger range mode**: Use `startLedger` and `endLedger` (cursor must be omitted)
+     * - **Cursor pagination mode**: Use `cursor` (startLedger and endLedger must be omitted)
+     *
+     * @example
+     * // ✅ Correct: Ledger range mode
+     * const rangeRequest: GetEventsRequest = {
+     *   filters: [],
+     *   startLedger: 1000,
+     *   endLedger: 2000,
+     *   limit: 100
+     * };
+     *
+     * @example
+     * // ✅ Correct: Cursor pagination mode
+     * const cursorRequest: GetEventsRequest = {
+     *   filters: [],
+     *   cursor: "some-cursor-value",
+     *   limit: 100
+     * };
+     *
+     * @example
+     * // ❌ Invalid: Cannot mix cursor with ledger range
+     * const invalidRequest = {
+     *   filters: [],
+     *   startLedger: 1000,  // ❌ Cannot use with cursor
+     *   endLedger: 2000,    // ❌ Cannot use with cursor
+     *   cursor: "cursor",   // ❌ Cannot use with ledger range
+     *   limit: 100
+     * };
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getEvents | getEvents API reference}
+     */
+    export type GetEventsRequest = {
+        filters: Api.EventFilter[];
+        startLedger: number;
+        endLedger: number;
+        cursor?: never;
+        limit?: number;
+    } | {
+        filters: Api.EventFilter[];
+        cursor: string;
+        startLedger?: never;
+        endLedger?: never;
+        limit?: number;
+    };
     export interface GetEventsResponse extends RetentionState {
         events: EventResponse[];
         cursor: string;
@@ -386,5 +435,88 @@ export declare namespace Api {
             liveUntilLedgerSeq?: number;
         };
     }
+    /**
+     * Request parameters for fetching a sequential list of ledgers.
+     *
+     * This type supports two distinct pagination modes that are mutually exclusive:
+     * - **Ledger-based pagination**: Use `startLedger` to begin fetching from a specific ledger sequence
+     * - **Cursor-based pagination**: Use `cursor` to continue from a previous response's pagination token
+     *
+     * @typedef {object} GetLedgersRequest
+     * @property {number} [startLedger] - Ledger sequence number to start fetching from (inclusive).
+     *   Must be omitted if cursor is provided. Cannot be less than the oldest ledger or greater
+     *   than the latest ledger stored on the RPC node.
+     * @property {object} [pagination] - Pagination configuration for the request.
+     * @property {string} [pagination.cursor] - Page cursor for continuing pagination from a previous
+     *   response. Must be omitted if startLedger is provided.
+     * @property {number} [pagination.limit=100] - Maximum number of ledgers to return per page.
+     *   Valid range: 1-10000. Defaults to 100 if not specified.
+     *
+     * @example
+     * // Ledger-based pagination - start from specific ledger
+     * const ledgerRequest: GetLedgersRequest = {
+     *   startLedger: 36233,
+     *   pagination: {
+     *     limit: 10
+     *   }
+     * };
+     *
+     * @example
+     * // Cursor-based pagination - continue from previous response
+     * const cursorRequest: GetLedgersRequest = {
+     *   pagination: {
+     *     cursor: "36234",
+     *     limit: 5
+     *   }
+     * };
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgers | getLedgers API reference}
+     */
+    export type GetLedgersRequest = {
+        startLedger: number;
+        pagination?: {
+            cursor?: never;
+            limit?: number;
+        };
+    } | {
+        startLedger?: never;
+        pagination: {
+            cursor: string;
+            limit?: number;
+        };
+    };
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgers */
+    export interface GetLedgersResponse {
+        ledgers: LedgerResponse[];
+        latestLedger: number;
+        latestLedgerCloseTime: number;
+        oldestLedger: number;
+        oldestLedgerCloseTime: number;
+        cursor: string;
+    }
+    export interface RawGetLedgersResponse {
+        ledgers: RawLedgerResponse[];
+        latestLedger: number;
+        latestLedgerCloseTime: number;
+        oldestLedger: number;
+        oldestLedgerCloseTime: number;
+        cursor: string;
+    }
+    export interface LedgerResponse {
+        hash: string;
+        sequence: number;
+        ledgerCloseTime: string;
+        headerXdr: xdr.LedgerHeaderHistoryEntry;
+        metadataXdr: xdr.LedgerCloseMeta;
+    }
+    export interface RawLedgerResponse {
+        hash: string;
+        sequence: number;
+        ledgerCloseTime: string;
+        /** a base-64 encoded {@link xdr.LedgerHeaderHistoryEntry} instance */
+        headerXdr: string;
+        /** a base-64 encoded {@link xdr.LedgerCloseMeta} instance */
+        metadataXdr: string;
+    }
     export {};
 }

package/lib/no-eventsource/rpc/axios.d.ts

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

package/lib/no-eventsource/rpc/axios.js

@@ -3,13 +3,21 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.version = exports.default = exports.AxiosClient = void 0;
+exports.createHttpClient = createHttpClient;
+exports.version = void 0;
 var _httpClient = require("../http-client");
-var version = exports.version = "14.2.0";
-var AxiosClient = exports.AxiosClient = (0, _httpClient.create)({
-  headers: {
-    "X-Client-Name": "js-soroban-client",
-    "X-Client-Version": version
-  }
-});
-var _default = exports.default = AxiosClient;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var version = exports.version = "14.3.1";
+function createHttpClient(headers) {
+  return (0, _httpClient.create)({
+    headers: _objectSpread(_objectSpread({}, headers), {}, {
+      "X-Client-Name": "js-stellar-sdk",
+      "X-Client-Version": version
+    })
+  });
+}

package/lib/no-eventsource/rpc/index.d.ts

@@ -1,7 +1,6 @@
 /** @module rpc */
 export * from "./api";
 export { RpcServer as Server, BasicSleepStrategy, LinearSleepStrategy, Durability, } from "./server";
-export { default as AxiosClient } from "./axios";
 export { parseRawSimulation, parseRawEvents } from "./parsers";
 export * from "./transaction";
 declare const _default: any;

package/lib/no-eventsource/rpc/index.js

@@ -8,16 +8,9 @@ var _exportNames = {
   BasicSleepStrategy: true,
   LinearSleepStrategy: true,
   Durability: true,
-  AxiosClient: true,
   parseRawSimulation: true,
   parseRawEvents: true
 };
-Object.defineProperty(exports, "AxiosClient", {
-  enumerable: true,
-  get: function get() {
-    return _axios.default;
-  }
-});
 Object.defineProperty(exports, "BasicSleepStrategy", {
   enumerable: true,
   get: function get() {
@@ -68,7 +61,6 @@ Object.keys(_api).forEach(function (key) {
   });
 });
 var _server = require("./server");
-var _axios = _interopRequireDefault(require("./axios"));
 var _parsers = require("./parsers");
 var _transaction = require("./transaction");
 Object.keys(_transaction).forEach(function (key) {
@@ -82,5 +74,4 @@ Object.keys(_transaction).forEach(function (key) {
     }
   });
 });
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 var _default = exports.default = module.exports;

package/lib/no-eventsource/rpc/jsonrpc.d.ts

@@ -1,3 +1,4 @@
+import { HttpClient } from "../http-client";
 export type Id = string | number;
 export interface Request<T> {
     jsonrpc: "2.0";
@@ -32,4 +33,4 @@ export interface Error<E = any> {
  * @returns {Promise<T>}
  * @private
  */
-export declare function postObject<T>(url: string, method: string, param?: any): Promise<T>;
+export declare function postObject<T>(client: HttpClient, url: string, method: string, param?: any): Promise<T>;

package/lib/no-eventsource/rpc/jsonrpc.js

@@ -4,8 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.postObject = postObject;
-var _axios = _interopRequireDefault(require("./axios"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _regenerator() { var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i.return) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
@@ -13,11 +11,11 @@ function _asyncToGenerator(n) { return function () { var t = this, e = arguments
 function hasOwnProperty(obj, prop) {
   return obj.hasOwnProperty(prop);
 }
-function postObject(_x, _x2) {
+function postObject(_x, _x2, _x3) {
   return _postObject.apply(this, arguments);
 }
 function _postObject() {
-  _postObject = _asyncToGenerator(_regenerator().m(function _callee(url, method) {
+  _postObject = _asyncToGenerator(_regenerator().m(function _callee(client, url, method) {
     var param,
       response,
       _response$data,
@@ -25,9 +23,9 @@ function _postObject() {
     return _regenerator().w(function (_context) {
       while (1) switch (_context.n) {
         case 0:
-          param = _args.length > 2 && _args[2] !== undefined ? _args[2] : null;
+          param = _args.length > 3 && _args[3] !== undefined ? _args[3] : null;
           _context.n = 1;
-          return _axios.default.post(url, {
+          return client.post(url, {
             jsonrpc: "2.0",
             id: 1,
             method: method,

package/lib/no-eventsource/rpc/parsers.d.ts

@@ -43,3 +43,4 @@ export declare function parseRawLedgerEntries(raw: Api.RawGetLedgerEntriesRespon
  * @returns {Api.SimulateTransactionResponse} the original parameter (if already parsed), parsed otherwise
  */
 export declare function parseRawSimulation(sim: Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse): Api.SimulateTransactionResponse;
+export declare function parseRawLedger(raw: Api.RawLedgerResponse): Api.LedgerResponse;

package/lib/no-eventsource/rpc/parsers.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.parseRawEvents = parseRawEvents;
+exports.parseRawLedger = parseRawLedger;
 exports.parseRawLedgerEntries = parseRawLedgerEntries;
 exports.parseRawSendTransaction = parseRawSendTransaction;
 exports.parseRawSimulation = parseRawSimulation;
@@ -172,4 +173,26 @@ function parseRawSimulation(sim) {
     });
   }
   return parseSuccessful(sim, base);
+}
+function parseRawLedger(raw) {
+  if (!raw.metadataXdr || !raw.headerXdr) {
+    var missingFields;
+    if (!raw.metadataXdr && !raw.headerXdr) {
+      missingFields = "metadataXdr and headerXdr";
+    } else if (!raw.metadataXdr) {
+      missingFields = "metadataXdr";
+    } else {
+      missingFields = "headerXdr";
+    }
+    throw new TypeError("invalid ledger missing fields: ".concat(missingFields));
+  }
+  var metadataXdr = _stellarBase.xdr.LedgerCloseMeta.fromXDR(raw.metadataXdr, "base64");
+  var headerXdr = _stellarBase.xdr.LedgerHeaderHistoryEntry.fromXDR(raw.headerXdr, "base64");
+  return {
+    hash: raw.hash,
+    sequence: raw.sequence,
+    ledgerCloseTime: raw.ledgerCloseTime,
+    metadataXdr: metadataXdr,
+    headerXdr: headerXdr
+  };
 }

package/lib/no-eventsource/rpc/server.d.ts

@@ -1,6 +1,7 @@
 import URI from "urijs";
 import { Account, Address, Asset, Contract, FeeBumpTransaction, Transaction, xdr } from "@stellar/stellar-base";
 import { Api } from "./api";
+import { HttpClient } from "../http-client";
 /**
  * Default transaction submission timeout for RPC requests, in milliseconds
  * @constant {number}
@@ -20,14 +21,6 @@ export declare enum Durability {
     Temporary = "temporary",
     Persistent = "persistent"
 }
-/**
- * @typedef {object} GetEventsRequest Describes the complex filter combinations available for event queries.
- * @property {Array.<module:rpc.Api.EventFilter>} filters Filters to use when querying events from the RPC server.
- * @property {number} [startLedger] Ledger number (inclusive) to begin querying events.
- * @property {string} [cursor] Page cursor (exclusive) to begin querying events.
- * @property {number} [limit=100] The maximum number of events that should be returned in the RPC response.
- * @memberof module:rpc.Server
- */
 /**
  * @typedef {object} ResourceLeeway Describes additional resource leeways for transaction simulation.
  * @property {number} cpuInstructions Simulate the transaction with more CPU instructions available.
@@ -41,20 +34,33 @@ export declare enum Durability {
  * @memberof module:rpc.Server
  */
 export declare namespace RpcServer {
-    interface GetEventsRequest {
-        filters: Api.EventFilter[];
-        startLedger?: number;
-        endLedger?: number;
-        cursor?: string;
-        limit?: number;
-    }
+    /**
+     * @deprecated Use `Api.GetEventsRequest` instead.
+     * @see {@link Api.GetEventsRequest}
+     */
+    type GetEventsRequest = Api.GetEventsRequest;
     interface PollingOptions {
         attempts?: number;
         sleepStrategy?: SleepStrategy;
     }
+    /**
+     * Describes additional resource leeways for transaction simulation.
+     * @property {number} cpuInstructions Simulate the transaction with more CPU instructions available.
+     * @memberof module:rpc.Server
+     */
     interface ResourceLeeway {
         cpuInstructions: number;
     }
+    /**
+     * Options for configuring connections to RPC servers.
+     *
+     * @property {boolean} allowHttp - Allow connecting to http servers, default: `false`. This must be set to false in production deployments!
+     * @property {number} timeout - Allow a timeout, default: 0. Allows user to avoid nasty lag.
+     * @property {Record<string, string>} headers - Additional headers that should be added to any requests to the RPC server.
+     *
+     * @alias module:rpc.Server.Options
+     * @memberof module:rpc.Server
+     */
     interface Options {
         allowHttp?: boolean;
         timeout?: number;
@@ -86,6 +92,21 @@ export type SleepStrategy = (iter: number) => number;
  */
 export declare class RpcServer {
     readonly serverURL: URI;
+    /**
+     * HTTP client instance for making requests to Horizon.
+     * Exposes interceptors, defaults, and other configuration options.
+     *
+     * @example
+     * // Add authentication header
+     * server.httpClient.defaults.headers['Authorization'] = 'Bearer token';
+     *
+     * // Add request interceptor
+     * server.httpClient.interceptors.request.use((config) => {
+     *   console.log('Request:', config.url);
+     *   return config;
+     * });
+     */
+    readonly httpClient: HttpClient;
     constructor(serverURL: string, opts?: RpcServer.Options);
     /**
      * Fetch a minimal set of current info about a Stellar account.
@@ -365,20 +386,21 @@ export declare class RpcServer {
     /**
      * Fetch all events that match a given set of filters.
      *
-     * The given filters (see {@link module:rpc.Api.EventFilter | Api.EventFilter}
+     * The given filters (see {@link Api.EventFilter}
      * for detailed fields) are combined only in a logical OR fashion, and all of
      * the fields in each filter are optional.
      *
      * To page through events, use the `pagingToken` field on the relevant
      * {@link Api.EventResponse} object to set the `cursor` parameter.
      *
-     * @param {module:rpc.Server.GetEventsRequest} request Event filters
+     * @param {Api.GetEventsRequest} request Event filters {@link Api.GetEventsRequest},
      * @returns {Promise<Api.GetEventsResponse>} A paginatable set of the events
      * matching the given event filters
      *
      * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getEvents | getEvents docs}
      *
      * @example
+     *
      * server.getEvents({
      *    startLedger: 1000,
      *    endLedger: 2000,
@@ -402,8 +424,8 @@ export declare class RpcServer {
      *    limit: 10,
      * });
      */
-    getEvents(request: RpcServer.GetEventsRequest): Promise<Api.GetEventsResponse>;
-    _getEvents(request: RpcServer.GetEventsRequest): Promise<Api.RawGetEventsResponse>;
+    getEvents(request: Api.GetEventsRequest): Promise<Api.GetEventsResponse>;
+    _getEvents(request: Api.GetEventsRequest): Promise<Api.RawGetEventsResponse>;
     /**
      * Fetch metadata about the network this Soroban RPC server is connected to.
      *
@@ -624,7 +646,7 @@ export declare class RpcServer {
      *    off" if it already exists)
      * @throws If Friendbot is not configured on this network or request failure
      *
-     * @see {@link https://developers.stellar.org/docs/learn/networks#friendbot | Friendbot docs}
+     * @see {@link https://developers.stellar.org/docs/learn/fundamentals/networks#friendbot | Friendbot docs}
      * @see {@link module:Friendbot.Api.Response}
      *
      * @example
@@ -692,4 +714,44 @@ export declare class RpcServer {
      *   "Address has no XLM");
      */
     getSACBalance(address: string | Address, sac: Asset, networkPassphrase?: string): Promise<Api.BalanceResponse>;
+    /**
+     * Fetch a detailed list of ledgers starting from a specified point.
+     *
+     * Returns ledger data with support for pagination as long as the requested
+     * pages fall within the history retention of the RPC provider.
+     *
+     * @param {Api.GetLedgersRequest} request - The request parameters for fetching ledgers. {@link Api.GetLedgersRequest}
+     * @returns {Promise<Api.GetLedgersResponse>} A promise that resolves to the
+     *    ledgers response containing an array of ledger data and pagination info. {@link Api.GetLedgersResponse}
+     *
+     * @throws {Error} If startLedger is less than the oldest ledger stored in this
+     *    node, or greater than the latest ledger seen by this node.
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgers | getLedgers docs}
+     *
+     * @example
+     * // Fetch ledgers starting from a specific sequence number
+     * server.getLedgers({
+     *   startLedger: 36233,
+     *   limit: 10
+     * }).then((response) => {
+     *   console.log("Ledgers:", response.ledgers);
+     *   console.log("Latest Ledger:", response.latestLedger);
+     *   console.log("Cursor:", response.cursor);
+     * });
+     *
+     * @example
+     * // Paginate through ledgers using cursor
+     * const firstPage = await server.getLedgers({
+     *   startLedger: 36233,
+     *   limit: 5
+     * });
+     *
+     * const nextPage = await server.getLedgers({
+     *   cursor: firstPage.cursor,
+     *   limit: 5
+     * });
+     */
+    getLedgers(request: Api.GetLedgersRequest): Promise<Api.GetLedgersResponse>;
+    _getLedgers(request: Api.GetLedgersRequest): Promise<Api.RawGetLedgersResponse>;
 }