@stellar/stellar-sdk 14.3.2 → 14.4.0

package/lib/minimal/contract/types.d.ts

@@ -42,7 +42,7 @@ export type u256 = bigint;
  */
 export type i256 = bigint;
 export type Option<T> = T | undefined;
-export type Typepoint = bigint;
+export type Timepoint = bigint;
 export type Duration = bigint;
 /**
  * A "regular" transaction, as opposed to a FeeBumpTransaction.
@@ -111,18 +111,16 @@ export type SignAuthEntry = (authEntry: string, opts?: {
  */
 export type ClientOptions = {
     /**
-     * The public key of the account that will send this transaction. You can
-     * override this for specific methods later, like
-     * [signAndSend]{@link module:contract.AssembledTransaction#signAndSend} and
-     * [signAuthEntries]{@link module:contract.AssembledTransaction#signAuthEntries}.
+     * The public key of the source account for this transaction. You can
+     * override this for specific methods later; see {@link MethodOptions}.
      */
     publicKey?: string;
     /**
      * A function to sign the transaction using the private key corresponding to
      * the given `publicKey`. You do not need to provide this, for read-only
-     * calls, which only need to be simulated. If you do not need to sign and
-     * send, there is no need to provide this. If you do not provide it during
-     * initialization, you can provide it later when you call
+     * calls, which only need to be simulated. If you do not provide it during
+     * initialization, you can provide it later, either when you initialize a
+     * method (see {@link MethodOptions}) or when you call
      * {@link module:contract.AssembledTransaction#signAndSend signAndSend}.
      *
      * Matches signature of `signTransaction` from Freighter.
@@ -133,7 +131,8 @@ export type ClientOptions = {
      * private key corresponding to the provided `publicKey`. This is only needed
      * for multi-auth transactions, in which one transaction is signed by
      * multiple parties. If you do not provide it during initialization, you can
-     * provide it later when you call {@link module:contract.AssembledTransaction#signAuthEntries signAuthEntries}.
+     * provide it later either when you initialize a method (see {@link MethodOptions})
+     * or when you call {@link module:contract.AssembledTransaction#signAuthEntries signAuthEntries}.
      *
      * Matches signature of `signAuthEntry` from Freighter.
      */
@@ -212,6 +211,33 @@ export type MethodOptions = {
      * @default false
      */
     restore?: boolean;
+    /**
+     * The public key of the source account for this transaction.
+     *
+     * Default: the one provided to the {@link Client} in {@link ClientOptions}
+     */
+    publicKey?: string;
+    /**
+     * A function to sign the transaction using the private key corresponding to
+     * the given `publicKey`. You do not need to provide this, for read-only
+     * calls, which only need to be simulated.
+     *
+     * Matches signature of `signTransaction` from Freighter.
+     *
+     * Default: the one provided to the {@link Client} in {@link ClientOptions}
+     */
+    signTransaction?: SignTransaction;
+    /**
+     * A function to sign a specific auth entry for a transaction, using the
+     * private key corresponding to the provided `publicKey`. This is only needed
+     * for multi-auth transactions, in which one transaction is signed by
+     * multiple parties.
+     *
+     * Matches signature of `signAuthEntry` from Freighter.
+     *
+     * Default: the one provided to the {@link Client} in {@link ClientOptions}
+     */
+    signAuthEntry?: SignAuthEntry;
 };
 export type AssembledTransactionOptions<T = string> = MethodOptions & ClientOptions & {
     method: string;

package/lib/minimal/contract/utils.d.ts

@@ -38,7 +38,7 @@ export declare function implementsToString(
 obj: unknown): obj is {
     toString(): string;
 };
-export declare function specFromWasm(wasm: Buffer): Promise<Buffer>;
+export declare function parseWasmCustomSections(buffer: Buffer): Map<string, Uint8Array[]>;
 /**
  * Reads a binary stream of ScSpecEntries into an array for processing by ContractSpec
  * @private

package/lib/minimal/contract/utils.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.contractErrorPattern = void 0;
 exports.getAccount = getAccount;
 exports.implementsToString = implementsToString;
+exports.parseWasmCustomSections = parseWasmCustomSections;
 exports.processSpecEntryStream = processSpecEntryStream;
-exports.specFromWasm = specFromWasm;
 exports.withExponentialBackoff = withExponentialBackoff;
 var _stellarBase = require("@stellar/stellar-base");
 var _types = require("./types");
@@ -101,41 +101,6 @@ var contractErrorPattern = exports.contractErrorPattern = /Error\(Contract, #(\d
 function implementsToString(obj) {
   return _typeof(obj) === "object" && obj !== null && "toString" in obj;
 }
-function specFromWasm(_x4) {
-  return _specFromWasm.apply(this, arguments);
-}
-function _specFromWasm() {
-  _specFromWasm = _asyncToGenerator(_regenerator().m(function _callee2(wasm) {
-    var xdrSections, wasmModule, customData, _t3;
-    return _regenerator().w(function (_context2) {
-      while (1) switch (_context2.p = _context2.n) {
-        case 0:
-          _context2.p = 0;
-          _context2.n = 1;
-          return WebAssembly.compile(wasm);
-        case 1:
-          wasmModule = _context2.v;
-          xdrSections = WebAssembly.Module.customSections(wasmModule, "contractspecv0");
-          _context2.n = 3;
-          break;
-        case 2:
-          _context2.p = 2;
-          _t3 = _context2.v;
-          customData = parseWasmCustomSections(wasm);
-          xdrSections = customData.get("contractspecv0");
-        case 3:
-          if (!(!xdrSections || xdrSections.length === 0)) {
-            _context2.n = 4;
-            break;
-          }
-          throw new Error("Could not obtain contract spec from wasm");
-        case 4:
-          return _context2.a(2, Buffer.from(xdrSections[0]));
-      }
-    }, _callee2, null, [[0, 2]]);
-  }));
-  return _specFromWasm.apply(this, arguments);
-}
 function parseWasmCustomSections(buffer) {
   var sections = new Map();
   var arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
@@ -146,6 +111,17 @@ function parseWasmCustomSections(buffer) {
     offset += length;
     return bytes;
   };
+  function readVarUint32() {
+    var value = 0;
+    var shift = 0;
+    while (true) {
+      var byte = read(1)[0];
+      value |= (byte & 0x7f) << shift;
+      if ((byte & 0x80) === 0) break;
+      if ((shift += 7) >= 32) throw new Error("Invalid WASM value");
+    }
+    return value >>> 0;
+  }
   if (_toConsumableArray(read(4)).join() !== "0,97,115,109") throw new Error("Invalid WASM magic");
   if (_toConsumableArray(read(4)).join() !== "1,0,0,0") throw new Error("Invalid WASM version");
   while (offset < buffer.byteLength) {
@@ -169,17 +145,6 @@ function parseWasmCustomSections(buffer) {
       offset += sectionLength;
     }
   }
-  function readVarUint32() {
-    var value = 0,
-      shift = 0;
-    while (true) {
-      var byte = read(1)[0];
-      value |= (byte & 0x7f) << shift;
-      if ((byte & 0x80) === 0) break;
-      if ((shift += 7) >= 32) throw new Error("Invalid WASM value");
-    }
-    return value >>> 0;
-  }
   return sections;
 }
 function processSpecEntryStream(buffer) {
@@ -190,17 +155,17 @@ function processSpecEntryStream(buffer) {
   }
   return res;
 }
-function getAccount(_x5, _x6) {
+function getAccount(_x4, _x5) {
   return _getAccount.apply(this, arguments);
 }
 function _getAccount() {
-  _getAccount = _asyncToGenerator(_regenerator().m(function _callee3(options, server) {
-    return _regenerator().w(function (_context3) {
-      while (1) switch (_context3.n) {
+  _getAccount = _asyncToGenerator(_regenerator().m(function _callee2(options, server) {
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
         case 0:
-          return _context3.a(2, options.publicKey ? server.getAccount(options.publicKey) : new _stellarBase.Account(_types.NULL_ACCOUNT, "0"));
+          return _context2.a(2, options.publicKey ? server.getAccount(options.publicKey) : new _stellarBase.Account(_types.NULL_ACCOUNT, "0"));
       }
-    }, _callee3);
+    }, _callee2);
   }));
   return _getAccount.apply(this, arguments);
 }

package/lib/minimal/contract/wasm_spec_parser.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Obtains the contract spec XDR from a contract's wasm binary.
+ * @param wasm The contract's wasm binary as a Buffer.
+ * @returns The XDR buffer representing the contract spec.
+ * @throws {Error} If the contract spec cannot be obtained from the provided wasm binary.
+ */
+export declare function specFromWasm(wasm: Buffer): Buffer;

package/lib/minimal/contract/wasm_spec_parser.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.specFromWasm = specFromWasm;
+var _utils = require("./utils");
+function specFromWasm(wasm) {
+  var customData = (0, _utils.parseWasmCustomSections)(wasm);
+  var xdrSections = customData.get("contractspecv0");
+  if (!xdrSections || xdrSections.length === 0) {
+    throw new Error("Could not obtain contract spec from wasm");
+  }
+  return Buffer.from(xdrSections[0]);
+}

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

@@ -21,7 +21,7 @@ export declare class NetworkError extends Error {
     constructor(message: string, response: any);
     /**
      * Returns the error response sent by the Horizon server.
-     * @returns {any}
+     * @returns {any} Response details, received from the Horizon server.
      */
     getResponse(): {
         data?: HorizonApi.ErrorResponseData;

package/lib/minimal/federation/server.d.ts

@@ -56,7 +56,7 @@ export declare class FederationServer {
      * @param {string} value Stellar Address (ex. `bob*stellar.org`)
      * @param {object} [opts] Options object
      * @returns {Promise<module:Federation.Api.Record>} A promise that resolves to the federation record
-     * @throws Will throw an error if the provided account ID is not a valid Ed25519 public key.
+     * @throws {Error} Will throw an error if the provided account ID is not a valid Ed25519 public key.
      */
     static resolve(value: string, opts?: Api.Options): Promise<Api.Record>;
     /**
@@ -80,7 +80,7 @@ export declare class FederationServer {
      * @param {string} domain Domain to get federation server for
      * @param {module:Federation.Api.Options} [opts] Options object
      * @returns {Promise<module:Federation.Api.Record>} A promise that resolves to the federation record
-     * @throws Will throw an error if the domain's stellar.toml file does not contain a federation server field.
+     * @throws {Error} Will throw an error if the domain's stellar.toml file does not contain a federation server field.
      */
     static createForDomain(domain: string, opts?: Api.Options): Promise<FederationServer>;
     constructor(serverURL: string, domain: string, opts?: Api.Options);
@@ -89,7 +89,7 @@ export declare class FederationServer {
      * @see <a href="https://developers.stellar.org/docs/encyclopedia/federation" target="_blank">Federation doc</a>
      * @param {string} address Stellar address (ex. `bob*stellar.org`). If `FederationServer` was instantiated with `domain` param only username (ex. `bob`) can be passed.
      * @returns {Promise<module:Federation.Api.Record>} A promise that resolves to the federation record
-     * @throws Will throw an error if the federated address does not contain a domain, or if the server object was not instantiated with a `domain` parameter
+     * @throws {Error} Will throw an error if the federated address does not contain a domain, or if the server object was not instantiated with a `domain` parameter
      */
     resolveAddress(address: string): Promise<Api.Record>;
     /**
@@ -97,8 +97,8 @@ export declare class FederationServer {
      * @see <a href="https://developers.stellar.org/docs/encyclopedia/federation" target="_blank">Federation doc</a>
      * @param {string} accountId Account ID (ex. `GBYNR2QJXLBCBTRN44MRORCMI4YO7FZPFBCNOKTOBCAAFC7KC3LNPRYS`)
      * @returns {Promise<module:Federation.Api.Record>} A promise that resolves to the federation record
-     * @throws Will throw an error if the federation server returns an invalid memo value.
-     * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.
+     * @throws {Error} Will throw an error if the federation server returns an invalid memo value.
+     * @throws {Error} Will throw an error if the federation server's response exceeds the allowed maximum size.
      * @throws {BadResponseError} Will throw an error if the server query fails with an improper response.
      */
     resolveAccountId(accountId: string): Promise<Api.Record>;
@@ -107,8 +107,8 @@ export declare class FederationServer {
      * @see <a href="https://developers.stellar.org/docs/glossary/federation/" target="_blank">Federation doc</a>
      * @param {string} transactionId Transaction ID (ex. `3389e9f0f1a65f19736cacf544c2e825313e8447f569233bb8db39aa607c8889`)
      * @returns {Promise<module:Federation.Api.Record>} A promise that resolves to the federation record
-     * @throws Will throw an error if the federation server returns an invalid memo value.
-     * @throws Will throw an error if the federation server's response exceeds the allowed maximum size.
+     * @throws {Error} Will throw an error if the federation server returns an invalid memo value.
+     * @throws {Error} Will throw an error if the federation server's response exceeds the allowed maximum size.
      * @throws {BadResponseError} Will throw an error if the server query fails with an improper response.
      */
     resolveTransactionId(transactionId: string): Promise<Api.Record>;

package/lib/minimal/horizon/horizon_axios_client.js

@@ -16,7 +16,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 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.2";
+var version = exports.version = "14.4.0";
 var SERVER_TIME_MAP = exports.SERVER_TIME_MAP = {};
 function toSeconds(ms) {
   return Math.floor(ms / 1000);

package/lib/minimal/horizon/server.d.ts

@@ -83,7 +83,7 @@ export declare class HorizonServer {
      * @param {number} seconds Number of seconds past the current time to wait.
      * @param {boolean} [_isRetry] True if this is a retry. Only set this internally!
      * This is to avoid a scenario where Horizon is horking up the wrong date.
-     * @returns {Promise<Timebounds>} Promise that resolves a `timebounds` object
+     * @returns {Promise<module:HorizonServer.Timebounds>} Promise that resolves a `Timebounds` object
      * (with the shape `{ minTime: 0, maxTime: N }`) that you can set the `timebounds` option to.
      */
     fetchTimebounds(seconds: number, _isRetry?: boolean): Promise<HorizonServer.Timebounds>;

package/lib/minimal/horizon/server.js

@@ -193,7 +193,7 @@ var HorizonServer = exports.HorizonServer = function () {
               return this.checkMemoRequired(transaction);
             case 1:
               tx = encodeURIComponent(transaction.toEnvelope().toXDR().toString("base64"));
-              return _context5.a(2, this.httpClient.post(this.serverURL.segment("transactions").toString(), "tx=".concat(tx), {
+              return _context5.a(2, this.httpClient.post(this.serverURL.clone().segment("transactions").toString(), "tx=".concat(tx), {
                 timeout: SUBMIT_TRANSACTION_TIMEOUT,
                 headers: {
                   "Content-Type": "application/x-www-form-urlencoded"
@@ -334,7 +334,7 @@ var HorizonServer = exports.HorizonServer = function () {
               return this.checkMemoRequired(transaction);
             case 1:
               tx = encodeURIComponent(transaction.toEnvelope().toXDR().toString("base64"));
-              return _context6.a(2, this.httpClient.post(this.serverURL.segment("transactions_async").toString(), "tx=".concat(tx), {
+              return _context6.a(2, this.httpClient.post(this.serverURL.clone().segment("transactions_async").toString(), "tx=".concat(tx), {
                 headers: {
                   "Content-Type": "application/x-www-form-urlencoded"
                 }

package/lib/minimal/index.d.ts

@@ -11,7 +11,6 @@ export * as Horizon from "./horizon";
  * `assembleTransaction`, and the `Api` types. You can import these from the
  * `/rpc` entrypoint, if your version of Node and your TypeScript configuration
  * allow it:
- *
  * @example
  * import { Server } from '@stellar/stellar-sdk/rpc';
  */
@@ -21,10 +20,8 @@ export * as rpc from "./rpc";
  * `AssembledTransaction`. You can import these from the `/contract`
  * entrypoint, if your version of Node and your TypeScript configuration allow
  * it:
- *
  * @example
  * import { Client } from '@stellar/stellar-sdk/contract';
- * @private
  */
 export * as contract from "./contract";
 export * from "@stellar/stellar-base";

package/lib/minimal/rpc/api.d.ts

@@ -1,6 +1,9 @@
 import { Contract, SorobanDataBuilder, xdr } from "@stellar/stellar-base";
 export declare namespace Api {
     export interface GetHealthResponse {
+        latestLedger: number;
+        ledgerRetentionWindow: number;
+        oldestLedger: number;
         status: "healthy";
     }
     export interface LedgerEntryResult {
@@ -253,7 +256,7 @@ export declare namespace Api {
     }
     export interface RawEventResponse extends BaseEventResponse {
         contractId: string;
-        topic: string[];
+        topic?: string[];
         value: string;
     }
     interface RawLedgerEntryChange {
@@ -303,7 +306,7 @@ export declare namespace Api {
     }
     export type SimulationAuthMode = "enforce" | "record" | "record_allow_nonroot";
     /**
-     * Simplifies {@link Api.RawSimulateTransactionResponse} into separate interfaces
+     * Simplifies {@link RawSimulateTransactionResponse} into separate interfaces
      * based on status:
      *   - on success, this includes all fields, though `result` is only present
      *     if an invocation was simulated (since otherwise there's nothing to
@@ -358,9 +361,29 @@ export declare namespace Api {
             transactionData: SorobanDataBuilder;
         };
     }
+    /**
+     * Checks if a simulation response indicates an error.
+     * @param sim The simulation response to check.
+     * @returns True if the response indicates an error, false otherwise.
+     */
     export function isSimulationError(sim: SimulateTransactionResponse): sim is SimulateTransactionErrorResponse;
+    /**
+     * Checks if a simulation response indicates success.
+     * @param sim The simulation response to check.
+     * @returns True if the response indicates success, false otherwise.
+     */
     export function isSimulationSuccess(sim: SimulateTransactionResponse): sim is SimulateTransactionSuccessResponse;
+    /**
+     * Checks if a simulation response indicates that a restoration is needed.
+     * @param sim The simulation response to check.
+     * @returns True if the response indicates a restoration is needed, false otherwise.
+     */
     export function isSimulationRestore(sim: SimulateTransactionResponse): sim is SimulateTransactionRestoreResponse;
+    /**
+     * Checks if a simulation response is in raw (unparsed) form.
+     * @param sim The simulation response to check.
+     * @returns True if the response is raw, false otherwise.
+     */
     export function isSimulationRaw(sim: Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse): sim is Api.RawSimulateTransactionResponse;
     interface RawSimulateHostFunctionResult {
         auth?: string[];
@@ -427,10 +450,11 @@ export declare namespace Api {
         latestLedger: number;
         /** present only on success, otherwise request malformed or no balance */
         balanceEntry?: {
-            /** a 64-bit integer */
+            /** a 64-bit integer for trustlines, 128-bit value for contracts */
             amount: string;
             authorized: boolean;
             clawback: boolean;
+            revocable?: boolean;
             lastModifiedLedgerSeq?: number;
             liveUntilLedgerSeq?: number;
         };

package/lib/minimal/rpc/axios.js

@@ -12,7 +12,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 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.2";
+var version = exports.version = "14.4.0";
 function createHttpClient(headers) {
   return (0, _httpClient.create)({
     headers: _objectSpread(_objectSpread({}, headers), {}, {

package/lib/minimal/rpc/jsonrpc.d.ts

@@ -27,10 +27,11 @@ export interface Error<E = any> {
 /**
  * Sends the jsonrpc 'params' as a single 'param' object (no array support).
  *
+ * @param {HttpClient} client HttpClient instance to use for the request
  * @param {string} url URL to the RPC instance
  * @param {string} method RPC method name that should be called
  * @param {(any | null)} [param=null] params that should be supplied to the method
- * @returns {Promise<T>}
+ * @returns {Promise} Promise that resolves to the result of type T
  * @private
  */
 export declare function postObject<T>(client: HttpClient, url: string, method: string, param?: any): Promise<T>;

package/lib/minimal/rpc/jsonrpc.js

@@ -9,7 +9,7 @@ function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try {
 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); }
 function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
 function hasOwnProperty(obj, prop) {
-  return obj.hasOwnProperty(prop);
+  return Object.prototype.hasOwnProperty.call(obj, prop);
 }
 function postObject(_x, _x2, _x3) {
   return _postObject.apply(this, arguments);

package/lib/minimal/rpc/parsers.js

@@ -59,10 +59,12 @@ function parseTransactionInfo(raw) {
   switch (meta.switch()) {
     case 3:
     case 4:
-      var metaV = meta.value();
-      if (metaV.sorobanMeta() !== null) {
-        var _metaV$sorobanMeta$re, _metaV$sorobanMeta;
-        info.returnValue = (_metaV$sorobanMeta$re = (_metaV$sorobanMeta = metaV.sorobanMeta()) === null || _metaV$sorobanMeta === void 0 ? void 0 : _metaV$sorobanMeta.returnValue()) !== null && _metaV$sorobanMeta$re !== void 0 ? _metaV$sorobanMeta$re : undefined;
+      {
+        var metaV = meta.value();
+        if (metaV.sorobanMeta() !== null) {
+          var _metaV$sorobanMeta$re, _metaV$sorobanMeta;
+          info.returnValue = (_metaV$sorobanMeta$re = (_metaV$sorobanMeta = metaV.sorobanMeta()) === null || _metaV$sorobanMeta === void 0 ? void 0 : _metaV$sorobanMeta.returnValue()) !== null && _metaV$sorobanMeta$re !== void 0 ? _metaV$sorobanMeta$re : undefined;
+        }
       }
   }
   if (raw.diagnosticEventsXdr) {
@@ -87,12 +89,13 @@ function parseRawEvents(raw) {
     oldestLedgerCloseTime: raw.oldestLedgerCloseTime,
     cursor: raw.cursor,
     events: ((_raw$events3 = raw.events) !== null && _raw$events3 !== void 0 ? _raw$events3 : []).map(function (evt) {
+      var _evt$topic;
       var clone = _objectSpread({}, evt);
       delete clone.contractId;
       return _objectSpread(_objectSpread(_objectSpread({}, clone), evt.contractId !== "" && {
         contractId: new _stellarBase.Contract(evt.contractId)
       }), {}, {
-        topic: evt.topic.map(function (topic) {
+        topic: ((_evt$topic = evt.topic) !== null && _evt$topic !== void 0 ? _evt$topic : []).map(function (topic) {
           return _stellarBase.xdr.ScVal.fromXDR(topic, "base64");
         }),
         value: _stellarBase.xdr.ScVal.fromXDR(evt.value, "base64")

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

@@ -155,6 +155,7 @@ export declare class RpcServer {
      * @see
      * {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries | getLedgerEntries docs}
      *
+     * @deprecated Use {@link getAssetBalance}, instead
      * @example
      * const accountId = "GBZC6Y2Y7Q3ZQ2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4";
      * const asset = new Asset(
@@ -187,6 +188,36 @@ export declare class RpcServer {
      * });
      */
     getClaimableBalance(id: string): Promise<xdr.ClaimableBalanceEntry>;
+    /**
+     * Fetch the balance of an asset held by an account or contract.
+     *
+     * The `address` argument may be provided as a string (as a {@link StrKey}),
+     * {@link Address}, or {@link Contract}.
+     *
+     * @param {string|Address|Contract} address The account or contract whose
+     *    balance should be fetched.
+     * @param {Asset} asset The asset whose balance you want to inspect.
+     * @param {string}  [networkPassphrase] optionally, when requesting the
+     *    balance of a contract, the network passphrase to which this token
+     *    applies. If omitted and necessary, a request about network information
+     *    will be made (see {@link getNetwork}), since contract IDs for assets are
+     *    specific to a network. You can refer to {@link Networks} for a list of
+     *    built-in passphrases, e.g., `Networks.TESTNET`.
+     * @returns {Promise<Api.BalanceResponse>} Resolves with balance entry details
+     *    when available.
+     *
+     * @throws {Error} If the supplied `address` is not a valid account or
+     *    contract strkey.
+     *
+     * @example
+     * const usdc = new Asset(
+     *   "USDC",
+     *   "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
+     * );
+     * const balance = await server.getAssetBalance("GD...", usdc);
+     * console.log(balance.balanceEntry?.amount);
+     */
+    getAssetBalance(address: string | Address | Contract, asset: Asset, networkPassphrase?: string): Promise<Api.BalanceResponse>;
     /**
      * General node health check.
      *
@@ -320,6 +351,7 @@ export declare class RpcServer {
      * transaction completion and return a definitive state of success or failure.
      *
      * @param {string} hash   the transaction you're polling for
+     * @param {[RpcServer.PollingOptions]} [opts] polling options
      * @param {number} [opts.attempts] (optional) the number of attempts to make
      *    before returning the last-seen status. By default or on invalid inputs,
      *    try 5 times.
@@ -644,7 +676,7 @@ export declare class RpcServer {
      *    account, or the existing account if it's already funded with the
      *    populated sequence number (note that the account will not be "topped
      *    off" if it already exists)
-     * @throws If Friendbot is not configured on this network or request failure
+     * @throws {Error} If Friendbot is not configured on this network or request failure
      *
      * @see {@link https://developers.stellar.org/docs/learn/fundamentals/networks#friendbot | Friendbot docs}
      * @see {@link module:Friendbot.Api.Response}
@@ -679,8 +711,8 @@ export declare class RpcServer {
      *
      * This is a convenience wrapper around {@link Server.getLedgerEntries}.
      *
-     * @param {string}  address the contract (string `C...`) or account ID
-     *    (`G...`) whose balance of `sac` you want to know
+     * @param {string}  address the contract (string `C...`) whose balance of
+     *    `sac` you want to know
      * @param {Asset}   sac     the built-in SAC token (e.g. `USDC:GABC...`) that
      *    you are querying from the given `contract`.
      * @param {string}  [networkPassphrase] optionally, the network passphrase to
@@ -698,6 +730,7 @@ export declare class RpcServer {
      * @see getLedgerEntries
      * @see https://developers.stellar.org/docs/tokens/stellar-asset-contract
      *
+     * @deprecated Use {@link getAssetBalance}, instead
      * @example
      * // assume `address` is some contract or account with an XLM balance
      * // assume server is an instantiated `Server` instance.
@@ -733,7 +766,9 @@ export declare class RpcServer {
      * // Fetch ledgers starting from a specific sequence number
      * server.getLedgers({
      *   startLedger: 36233,
-     *   limit: 10
+     *   pagination: {
+     *     limit: 10
+     *   }
      * }).then((response) => {
      *   console.log("Ledgers:", response.ledgers);
      *   console.log("Latest Ledger:", response.latestLedger);
@@ -744,12 +779,16 @@ export declare class RpcServer {
      * // Paginate through ledgers using cursor
      * const firstPage = await server.getLedgers({
      *   startLedger: 36233,
-     *   limit: 5
+     *   pagination: {
+     *     limit: 5
+     *   }
      * });
      *
      * const nextPage = await server.getLedgers({
-     *   cursor: firstPage.cursor,
-     *   limit: 5
+     *   pagination: {
+     *     cursor: firstPage.cursor,
+     *     limit: 5
+     *   }
      * });
      */
     getLedgers(request: Api.GetLedgersRequest): Promise<Api.GetLedgersResponse>;