@stellar/stellar-sdk 14.2.0 → 14.3.0

package/lib/contract/spec.js

@@ -559,7 +559,7 @@ var Spec = exports.Spec = function () {
       }
       if (value === _stellarBase.xdr.ScSpecType.scSpecTypeOption().value) {
         var opt = ty.option();
-        if (val === undefined) {
+        if (val === null || val === undefined) {
           return _stellarBase.xdr.ScVal.scvVoid();
         }
         return this.nativeToScVal(val, opt.valueType());
@@ -823,12 +823,20 @@ var Spec = exports.Spec = function () {
       var _this5 = this;
       var t = typeDef.switch();
       var value = t.value;
+      if (value === _stellarBase.xdr.ScSpecType.scSpecTypeOption().value) {
+        switch (scv.switch().value) {
+          case _stellarBase.xdr.ScValType.scvVoid().value:
+            return null;
+          default:
+            return this.scValToNative(scv, typeDef.option().valueType());
+        }
+      }
       if (value === _stellarBase.xdr.ScSpecType.scSpecTypeUdt().value) {
         return this.scValUdtToNative(scv, typeDef.udt());
       }
       switch (scv.switch().value) {
         case _stellarBase.xdr.ScValType.scvVoid().value:
-          return undefined;
+          return null;
         case _stellarBase.xdr.ScValType.scvU64().value:
         case _stellarBase.xdr.ScValType.scvI64().value:
         case _stellarBase.xdr.ScValType.scvU128().value:

package/lib/errors/account_requires_memo.d.ts

@@ -17,7 +17,6 @@
  * console.log('The account is used in operation: ', err.operationIndex)
  */
 export declare class AccountRequiresMemoError extends Error {
-    __proto__: AccountRequiresMemoError;
     accountId: string;
     operationIndex: number;
     constructor(message: string, accountId: string, operationIndex: number);

package/lib/errors/account_requires_memo.js

@@ -24,11 +24,7 @@ var AccountRequiresMemoError = exports.AccountRequiresMemoError = function (_Err
   function AccountRequiresMemoError(message, accountId, operationIndex) {
     var _this;
     _classCallCheck(this, AccountRequiresMemoError);
-    var trueProto = (this instanceof AccountRequiresMemoError ? this.constructor : void 0).prototype;
     _this = _callSuper(this, AccountRequiresMemoError, [message]);
-    _this.__proto__ = trueProto;
-    _this.constructor = AccountRequiresMemoError;
-    _this.name = "AccountRequiresMemoError";
     _this.accountId = accountId;
     _this.operationIndex = operationIndex;
     return _this;

package/lib/errors/bad_request.d.ts

@@ -10,5 +10,4 @@ import { NetworkError } from "./network";
  * @param {any} response Response details, received from the Horizon server
  */
 export declare class BadRequestError extends NetworkError {
-    constructor(message: string, response: any);
 }

package/lib/errors/bad_request.js

@@ -19,15 +19,9 @@ 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 BadRequestError = exports.BadRequestError = function (_NetworkError) {
-  function BadRequestError(message, response) {
-    var _this;
+  function BadRequestError() {
     _classCallCheck(this, BadRequestError);
-    var trueProto = (this instanceof BadRequestError ? this.constructor : void 0).prototype;
-    _this = _callSuper(this, BadRequestError, [message, response]);
-    _this.__proto__ = trueProto;
-    _this.constructor = BadRequestError;
-    _this.name = "BadRequestError";
-    return _this;
+    return _callSuper(this, BadRequestError, arguments);
   }
   _inherits(BadRequestError, _NetworkError);
   return _createClass(BadRequestError);

package/lib/errors/bad_response.d.ts

@@ -13,5 +13,4 @@ import { NetworkError } from "./network";
  * @param {any} response Response details, received from the server.
  */
 export declare class BadResponseError extends NetworkError {
-    constructor(message: string, response: any);
 }

package/lib/errors/bad_response.js

@@ -19,15 +19,9 @@ 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 BadResponseError = exports.BadResponseError = function (_NetworkError) {
-  function BadResponseError(message, response) {
-    var _this;
+  function BadResponseError() {
     _classCallCheck(this, BadResponseError);
-    var trueProto = (this instanceof BadResponseError ? this.constructor : void 0).prototype;
-    _this = _callSuper(this, BadResponseError, [message, response]);
-    _this.__proto__ = trueProto;
-    _this.constructor = BadResponseError;
-    _this.name = "BadResponseError";
-    return _this;
+    return _callSuper(this, BadResponseError, arguments);
   }
   _inherits(BadResponseError, _NetworkError);
   return _createClass(BadResponseError);

package/lib/errors/network.d.ts

@@ -18,7 +18,6 @@ export declare class NetworkError extends Error {
         statusText?: string;
         url?: string;
     };
-    __proto__: NetworkError;
     constructor(message: string, response: any);
     /**
      * Returns the error response sent by the Horizon server.

package/lib/errors/network.js

@@ -24,10 +24,7 @@ var NetworkError = exports.NetworkError = function (_Error) {
   function NetworkError(message, response) {
     var _this;
     _classCallCheck(this, NetworkError);
-    var trueProto = (this instanceof NetworkError ? this.constructor : void 0).prototype;
     _this = _callSuper(this, NetworkError, [message]);
-    _this.__proto__ = trueProto;
-    _this.constructor = NetworkError;
     _this.response = response;
     return _this;
   }

package/lib/errors/not_found.d.ts

@@ -10,5 +10,4 @@ import { NetworkError } from "./network";
  * @param {any} response Response details, received from the Horizon server
  */
 export declare class NotFoundError extends NetworkError {
-    constructor(message: string, response: any);
 }

package/lib/errors/not_found.js

@@ -19,15 +19,9 @@ 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 NotFoundError = exports.NotFoundError = function (_NetworkError) {
-  function NotFoundError(message, response) {
-    var _this;
+  function NotFoundError() {
     _classCallCheck(this, NotFoundError);
-    var trueProto = (this instanceof NotFoundError ? this.constructor : void 0).prototype;
-    _this = _callSuper(this, NotFoundError, [message, response]);
-    _this.__proto__ = trueProto;
-    _this.constructor = NotFoundError;
-    _this.name = "NotFoundError";
-    return _this;
+    return _callSuper(this, NotFoundError, arguments);
   }
   _inherits(NotFoundError, _NetworkError);
   return _createClass(NotFoundError);

package/lib/horizon/horizon_axios_client.js

@@ -10,7 +10,7 @@ var _urijs = _interopRequireDefault(require("urijs"));
 var _httpClient = require("../http-client");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 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); }
-var version = exports.version = "14.2.0";
+var version = exports.version = "14.3.0";
 var SERVER_TIME_MAP = exports.SERVER_TIME_MAP = {};
 var AxiosClient = exports.AxiosClient = (0, _httpClient.create)({
   headers: {

package/lib/minimal/contract/spec.js

@@ -559,7 +559,7 @@ var Spec = exports.Spec = function () {
       }
       if (value === _stellarBase.xdr.ScSpecType.scSpecTypeOption().value) {
         var opt = ty.option();
-        if (val === undefined) {
+        if (val === null || val === undefined) {
           return _stellarBase.xdr.ScVal.scvVoid();
         }
         return this.nativeToScVal(val, opt.valueType());
@@ -823,12 +823,20 @@ var Spec = exports.Spec = function () {
       var _this5 = this;
       var t = typeDef.switch();
       var value = t.value;
+      if (value === _stellarBase.xdr.ScSpecType.scSpecTypeOption().value) {
+        switch (scv.switch().value) {
+          case _stellarBase.xdr.ScValType.scvVoid().value:
+            return null;
+          default:
+            return this.scValToNative(scv, typeDef.option().valueType());
+        }
+      }
       if (value === _stellarBase.xdr.ScSpecType.scSpecTypeUdt().value) {
         return this.scValUdtToNative(scv, typeDef.udt());
       }
       switch (scv.switch().value) {
         case _stellarBase.xdr.ScValType.scvVoid().value:
-          return undefined;
+          return null;
         case _stellarBase.xdr.ScValType.scvU64().value:
         case _stellarBase.xdr.ScValType.scvI64().value:
         case _stellarBase.xdr.ScValType.scvU128().value:

package/lib/minimal/errors/account_requires_memo.d.ts

@@ -17,7 +17,6 @@
  * console.log('The account is used in operation: ', err.operationIndex)
  */
 export declare class AccountRequiresMemoError extends Error {
-    __proto__: AccountRequiresMemoError;
     accountId: string;
     operationIndex: number;
     constructor(message: string, accountId: string, operationIndex: number);

package/lib/minimal/errors/account_requires_memo.js

@@ -24,11 +24,7 @@ var AccountRequiresMemoError = exports.AccountRequiresMemoError = function (_Err
   function AccountRequiresMemoError(message, accountId, operationIndex) {
     var _this;
     _classCallCheck(this, AccountRequiresMemoError);
-    var trueProto = (this instanceof AccountRequiresMemoError ? this.constructor : void 0).prototype;
     _this = _callSuper(this, AccountRequiresMemoError, [message]);
-    _this.__proto__ = trueProto;
-    _this.constructor = AccountRequiresMemoError;
-    _this.name = "AccountRequiresMemoError";
     _this.accountId = accountId;
     _this.operationIndex = operationIndex;
     return _this;

package/lib/minimal/errors/bad_request.d.ts

@@ -10,5 +10,4 @@ import { NetworkError } from "./network";
  * @param {any} response Response details, received from the Horizon server
  */
 export declare class BadRequestError extends NetworkError {
-    constructor(message: string, response: any);
 }

package/lib/minimal/errors/bad_request.js

@@ -19,15 +19,9 @@ 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 BadRequestError = exports.BadRequestError = function (_NetworkError) {
-  function BadRequestError(message, response) {
-    var _this;
+  function BadRequestError() {
     _classCallCheck(this, BadRequestError);
-    var trueProto = (this instanceof BadRequestError ? this.constructor : void 0).prototype;
-    _this = _callSuper(this, BadRequestError, [message, response]);
-    _this.__proto__ = trueProto;
-    _this.constructor = BadRequestError;
-    _this.name = "BadRequestError";
-    return _this;
+    return _callSuper(this, BadRequestError, arguments);
   }
   _inherits(BadRequestError, _NetworkError);
   return _createClass(BadRequestError);

package/lib/minimal/errors/bad_response.d.ts

@@ -13,5 +13,4 @@ import { NetworkError } from "./network";
  * @param {any} response Response details, received from the server.
  */
 export declare class BadResponseError extends NetworkError {
-    constructor(message: string, response: any);
 }

package/lib/minimal/errors/bad_response.js

@@ -19,15 +19,9 @@ 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 BadResponseError = exports.BadResponseError = function (_NetworkError) {
-  function BadResponseError(message, response) {
-    var _this;
+  function BadResponseError() {
     _classCallCheck(this, BadResponseError);
-    var trueProto = (this instanceof BadResponseError ? this.constructor : void 0).prototype;
-    _this = _callSuper(this, BadResponseError, [message, response]);
-    _this.__proto__ = trueProto;
-    _this.constructor = BadResponseError;
-    _this.name = "BadResponseError";
-    return _this;
+    return _callSuper(this, BadResponseError, arguments);
   }
   _inherits(BadResponseError, _NetworkError);
   return _createClass(BadResponseError);

package/lib/minimal/errors/network.d.ts

@@ -18,7 +18,6 @@ export declare class NetworkError extends Error {
         statusText?: string;
         url?: string;
     };
-    __proto__: NetworkError;
     constructor(message: string, response: any);
     /**
      * Returns the error response sent by the Horizon server.

package/lib/minimal/errors/network.js

@@ -24,10 +24,7 @@ var NetworkError = exports.NetworkError = function (_Error) {
   function NetworkError(message, response) {
     var _this;
     _classCallCheck(this, NetworkError);
-    var trueProto = (this instanceof NetworkError ? this.constructor : void 0).prototype;
     _this = _callSuper(this, NetworkError, [message]);
-    _this.__proto__ = trueProto;
-    _this.constructor = NetworkError;
     _this.response = response;
     return _this;
   }

package/lib/minimal/errors/not_found.d.ts

@@ -10,5 +10,4 @@ import { NetworkError } from "./network";
  * @param {any} response Response details, received from the Horizon server
  */
 export declare class NotFoundError extends NetworkError {
-    constructor(message: string, response: any);
 }

package/lib/minimal/errors/not_found.js

@@ -19,15 +19,9 @@ 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 NotFoundError = exports.NotFoundError = function (_NetworkError) {
-  function NotFoundError(message, response) {
-    var _this;
+  function NotFoundError() {
     _classCallCheck(this, NotFoundError);
-    var trueProto = (this instanceof NotFoundError ? this.constructor : void 0).prototype;
-    _this = _callSuper(this, NotFoundError, [message, response]);
-    _this.__proto__ = trueProto;
-    _this.constructor = NotFoundError;
-    _this.name = "NotFoundError";
-    return _this;
+    return _callSuper(this, NotFoundError, arguments);
   }
   _inherits(NotFoundError, _NetworkError);
   return _createClass(NotFoundError);

package/lib/minimal/horizon/horizon_axios_client.js

@@ -10,7 +10,7 @@ var _urijs = _interopRequireDefault(require("urijs"));
 var _httpClient = require("../http-client");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 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); }
-var version = exports.version = "14.2.0";
+var version = exports.version = "14.3.0";
 var SERVER_TIME_MAP = exports.SERVER_TIME_MAP = {};
 var AxiosClient = exports.AxiosClient = (0, _httpClient.create)({
   headers: {

package/lib/minimal/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/minimal/rpc/axios.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.version = exports.default = exports.AxiosClient = void 0;
 var _httpClient = require("../http-client");
-var version = exports.version = "14.2.0";
+var version = exports.version = "14.3.0";
 var AxiosClient = exports.AxiosClient = (0, _httpClient.create)({
   headers: {
     "X-Client-Name": "js-soroban-client",

package/lib/minimal/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/minimal/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/minimal/rpc/server.d.ts

@@ -20,14 +20,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,13 +33,11 @@ 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;
@@ -365,20 +355,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 +393,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 +615,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 +683,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>;
 }