@stellar/stellar-sdk 12.3.0 → 13.0.0-beta.1

package/lib/rpc/axios.js

@@ -4,10 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.version = exports.default = exports.AxiosClient = void 0;
-var _axios = _interopRequireDefault(require("axios"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-var version = exports.version = require('../../package.json').version;
-var AxiosClient = exports.AxiosClient = _axios.default.create({
+var _httpClient = require("../http-client");
+var version = exports.version = "13.0.0-beta.1";
+var AxiosClient = exports.AxiosClient = (0, _httpClient.create)({
   headers: {
     'X-Client-Name': 'js-soroban-client',
     'X-Client-Version': version

package/lib/rpc/browser.d.ts

@@ -1,6 +1,4 @@
-import axios from 'axios';
 export * from './index';
 export * as StellarBase from '@stellar/stellar-base';
-export { axios };
 declare const _default: any;
 export default _default;

package/lib/rpc/browser.js

@@ -5,18 +5,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 var _exportNames = {
-  axios: true,
   StellarBase: true
 };
-exports.StellarBase = void 0;
-Object.defineProperty(exports, "axios", {
-  enumerable: true,
-  get: function get() {
-    return _axios.default;
-  }
-});
-exports.default = void 0;
-var _axios = _interopRequireDefault(require("axios"));
+exports.default = exports.StellarBase = void 0;
 var _index = require("./index");
 Object.keys(_index).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -33,5 +24,4 @@ var _StellarBase = _interopRequireWildcard(require("@stellar/stellar-base"));
 exports.StellarBase = _StellarBase;
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 var _default = exports.default = module.exports;

package/lib/rpc/index.d.ts

@@ -1,5 +1,6 @@
+/** @module rpc */
 export * from "./api";
-export { Server, Durability } from "./server";
+export { RpcServer as Server, Durability } from "./server";
 export { default as AxiosClient } from "./axios";
 export { parseRawSimulation, parseRawEvents } from "./parsers";
 export * from "./transaction";

package/lib/rpc/index.js

@@ -25,7 +25,7 @@ Object.defineProperty(exports, "Durability", {
 Object.defineProperty(exports, "Server", {
   enumerable: true,
   get: function get() {
-    return _server.Server;
+    return _server.RpcServer;
   }
 });
 exports.default = void 0;

package/lib/rpc/jsonrpc.d.ts

@@ -23,5 +23,13 @@ export interface Error<E = any> {
     message?: string;
     data?: E;
 }
-/** Sends the jsonrpc 'params' as a single 'param' object (no array support). */
+/**
+ * Sends the jsonrpc 'params' as a single 'param' object (no array support).
+ *
+ * @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>}
+ * @private
+ */
 export declare function postObject<T>(url: string, method: string, param?: any): Promise<T>;

package/lib/rpc/parsers.d.ts

@@ -1,19 +1,39 @@
 import { Api } from './api';
-export declare function parseRawSendTransaction(r: Api.RawSendTransactionResponse): Api.SendTransactionResponse;
+/**
+ * Parse the response from invoking the `submitTransaction` method of a Soroban RPC server.
+ * @memberof module:rpc
+ * @private
+ *
+ * @param {Api.RawSendTransactionResponse} raw the raw `submitTransaction` response from the Soroban RPC server to parse
+ * @returns {Api.SendTransactionResponse} transaction response parsed from the Soroban RPC server's response
+ */
+export declare function parseRawSendTransaction(raw: Api.RawSendTransactionResponse): Api.SendTransactionResponse;
 export declare function parseTransactionInfo(raw: Api.RawTransactionInfo | Api.RawGetTransactionResponse): Omit<Api.TransactionInfo, 'status'>;
 export declare function parseRawTransactions(r: Api.RawTransactionInfo): Api.TransactionInfo;
-export declare function parseRawEvents(r: Api.RawGetEventsResponse): Api.GetEventsResponse;
-export declare function parseRawLedgerEntries(raw: Api.RawGetLedgerEntriesResponse): Api.GetLedgerEntriesResponse;
 /**
- * Converts a raw response schema into one with parsed XDR fields and a
- * simplified interface.
- * Warning: This API is only exported for testing purposes and should not be
- *          relied on or considered "stable".
+ * Parse and return the retrieved events, if any, from a raw response from a Soroban RPC server.
+ * @memberof module:rpc
  *
- * @param {Api.SimulateTransactionResponse|Api.RawSimulateTransactionResponse} sim the raw response schema (parsed ones are allowed, best-effort
- *    detected, and returned untouched)
+ * @param {Api.RawGetEventsResponse} raw the raw `getEvents` response from the Soroban RPC server to parse
+ * @returns {Api.GetEventsResponse} events parsed from the Soroban RPC server's response
+ */
+export declare function parseRawEvents(raw: Api.RawGetEventsResponse): Api.GetEventsResponse;
+/**
+ * Parse and return the retrieved ledger entries, if any, from a raw response from a Soroban RPC server.
+ * @memberof module:rpc
+ * @private
  *
- * @returns the original parameter (if already parsed), parsed otherwise
+ * @param {Api.RawGetLedgerEntriesResponse} raw he raw `getLedgerEntries` response from the Soroban RPC server to parse
+ * @returns {Api.GetLedgerEntriesResponse} ledger entries parsed from the Soroban RPC server's response
+ */
+export declare function parseRawLedgerEntries(raw: Api.RawGetLedgerEntriesResponse): Api.GetLedgerEntriesResponse;
+/**
+ * Converts a raw response schema into one with parsed XDR fields and a simplified interface.
+ * @warning This API is only exported for testing purposes and should not be relied on or considered "stable".
+ * @memberof module:rpc
  *
+ * @param {Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse} sim the raw response schema (parsed ones are allowed, best-effort
+ *    detected, and returned untouched)
+ * @returns {Api.SimulateTransactionResponse} the original parameter (if already parsed), parsed otherwise
  */
 export declare function parseRawSimulation(sim: Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse): Api.SimulateTransactionResponse;

package/lib/rpc/parsers.js

@@ -17,13 +17,13 @@ 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); }
-function parseRawSendTransaction(r) {
-  var errorResultXdr = r.errorResultXdr,
-    diagnosticEventsXdr = r.diagnosticEventsXdr;
-  delete r.errorResultXdr;
-  delete r.diagnosticEventsXdr;
+function parseRawSendTransaction(raw) {
+  var errorResultXdr = raw.errorResultXdr,
+    diagnosticEventsXdr = raw.diagnosticEventsXdr;
+  delete raw.errorResultXdr;
+  delete raw.diagnosticEventsXdr;
   if (errorResultXdr) {
-    return _objectSpread(_objectSpread(_objectSpread({}, r), diagnosticEventsXdr !== undefined && diagnosticEventsXdr.length > 0 && {
+    return _objectSpread(_objectSpread(_objectSpread({}, raw), diagnosticEventsXdr !== undefined && diagnosticEventsXdr.length > 0 && {
       diagnosticEvents: diagnosticEventsXdr.map(function (evt) {
         return _stellarBase.xdr.DiagnosticEvent.fromXDR(evt, 'base64');
       })
@@ -31,7 +31,7 @@ function parseRawSendTransaction(r) {
       errorResult: _stellarBase.xdr.TransactionResult.fromXDR(errorResultXdr, 'base64')
     });
   }
-  return _objectSpread({}, r);
+  return _objectSpread({}, raw);
 }
 function parseTransactionInfo(raw) {
   var meta = _stellarBase.xdr.TransactionMeta.fromXDR(raw.resultMetaXdr, 'base64');
@@ -60,11 +60,11 @@ function parseRawTransactions(r) {
     status: r.status
   }, parseTransactionInfo(r));
 }
-function parseRawEvents(r) {
-  var _r$events;
+function parseRawEvents(raw) {
+  var _raw$events;
   return {
-    latestLedger: r.latestLedger,
-    events: ((_r$events = r.events) !== null && _r$events !== void 0 ? _r$events : []).map(function (evt) {
+    latestLedger: raw.latestLedger,
+    events: ((_raw$events = raw.events) !== null && _raw$events !== void 0 ? _raw$events : []).map(function (evt) {
       var clone = _objectSpread({}, evt);
       delete clone.contractId;
       return _objectSpread(_objectSpread(_objectSpread({}, clone), evt.contractId !== '' && {

package/lib/rpc/server.d.ts

@@ -1,21 +1,53 @@
 import URI from 'urijs';
-import { Account, Address, Contract, FeeBumpTransaction, Transaction, xdr } from '@stellar/stellar-base';
+import { Account, Address, Asset, Contract, FeeBumpTransaction, Transaction, xdr } from '@stellar/stellar-base';
 import { Api } from './api';
+/**
+ * Default transaction submission timeout for RPC requests, in milliseconds
+ * @constant {number}
+ * @default 60000
+ * @memberof module:rpc.Server
+ */
 export declare const SUBMIT_TRANSACTION_TIMEOUT: number;
-/** Specifies the durability namespace of contract-related ledger entries. */
+/**
+ * Specifies the durability namespace of contract-related ledger entries.
+ * @enum {('temporary' | 'persistent')}
+ * @memberof module:rpc
+ *
+ * @see {@link https://developers.stellar.org/docs/learn/smart-contract-internals/state-archival | State Archival docs}
+ * @see {@link https://docs.rs/soroban-sdk/latest/soroban_sdk/storage/struct.Storage.html | Rust SDK Storage docs}
+ */
 export declare enum Durability {
     Temporary = "temporary",
     Persistent = "persistent"
 }
-export declare namespace Server {
-    /** Describes the complex filter combinations available for event queries. */
+/**
+ * @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.
+ * @memberof module:rpc.Server
+ */
+/**
+ * @typedef {object} Options Options for configuring connections to RPC servers.
+ * @property {boolean} [allowHttp=false] Allow connecting to http servers, default: `false`. This must be set to false in production deployments!
+ * @property {number} [timeout=0] Allow a timeout, default: 0. Allows user to avoid nasty lag. You can also use {@link Config} class to set this globally.
+ * @property {Record<string, string>} [headers] Additional headers that should be added to any requests to the RPC server.
+ * @memberof module:rpc.Server
+ */
+export declare namespace RpcServer {
     interface GetEventsRequest {
         filters: Api.EventFilter[];
         startLedger?: number;
+        endLedger?: number;
         cursor?: string;
         limit?: number;
     }
-    /** Describes additional resource leeways for transaction simulation. */
     interface ResourceLeeway {
         cpuInstructions: number;
     }
@@ -29,34 +61,33 @@ export declare namespace Server {
  * Handles the network connection to a Soroban RPC instance, exposing an
  * interface for requests to that instance.
  *
- * @class
+ * @alias module:rpc.Server
+ * @memberof module:rpc
  *
- * @param {string} serverURL Soroban-RPC Server URL (ex.
- *    `http://localhost:8000/soroban/rpc`).
- * @param {object} [opts] Options object
- * @param {boolean} [opts.allowHttp]  allows connecting to insecure http servers
+ * @param {string} serverURL Soroban-RPC Server URL (ex. `http://localhost:8000/soroban/rpc`).
+ * @param {module:rpc.Server.Options} [opts] Options object
+ * @param {boolean} [opts.allowHttp] Allows connecting to insecure http servers
  *    (default: `false`). This must be set to false in production deployments!
  *    You can also use {@link Config} class to set this globally.
- * @param {Record<string, string>} [opts.headers] allows setting custom headers
+ * @param {Record<string, string>} [opts.headers] Allows setting custom headers
  *
- * @see https://soroban.stellar.org/api/methods
+ * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods | API reference docs}
  */
-export declare class Server {
-    /** Soroban RPC Server URL (ex. `http://localhost:8000/soroban/rpc`). */
+export declare class RpcServer {
     readonly serverURL: URI;
-    constructor(serverURL: string, opts?: Server.Options);
+    constructor(serverURL: string, opts?: RpcServer.Options);
     /**
      * Fetch a minimal set of current info about a Stellar account.
      *
      * Needed to get the current sequence number for the account so you can build
      * a successful transaction with {@link TransactionBuilder}.
      *
-     * @param {string} address - The public address of the account to load.
+     * @param {string} address The public address of the account to load.
+     * @returns {Promise<Account>} A promise which resolves to the {@link Account}
+     * object with a populated sequence number
      *
-     * @returns {Promise<Account>}  a promise to the {@link Account} object with
-     *    a populated sequence number
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries | getLedgerEntries docs}
      *
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries
      * @example
      * const accountId = "GBZC6Y2Y7Q3ZQ2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4";
      * server.getAccount(accountId).then((account) => {
@@ -67,11 +98,12 @@ export declare class Server {
     /**
      * General node health check.
      *
-     * @returns {Promise<Api.GetHealthResponse>}   a promise to the
-     *    {@link Api.GetHealthResponse} object with the status of the
-     *    server (e.g. "healthy").
+     * @returns {Promise<Api.GetHealthResponse>} A promise which resolves to the
+     * {@link Api.GetHealthResponse} object with the status of the
+     * server (e.g. "healthy").
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getHealth | getLedgerEntries docs}
      *
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getHealth
      * @example
      * server.getHealth().then((health) => {
      *   console.log("status:", health.status);
@@ -83,21 +115,22 @@ export declare class Server {
      *
      * Allows you to directly inspect the current state of a contract. This is a
      * backup way to access your contract data which may not be available via
-     * events or {@link Server.simulateTransaction}.
-     * Warning: If the data entry in question is a 'temporary' entry, it's
-     *    entirely possible that it has expired out of existence.
+     * events or {@link module:rpc.Server#simulateTransaction}.
      *
-     * @param {string|Address|Contract} contract    the contract ID containing the
+     * @param {string|Address|Contract} contract The contract ID containing the
      *    data to load as a strkey (`C...` form), a {@link Contract}, or an
      *    {@link Address} instance
-     * @param {xdr.ScVal} key   the key of the contract data to load
-     * @param {Durability} [durability=Durability.Persistent]   the "durability
+     * @param {xdr.ScVal} key The key of the contract data to load
+     * @param {module:rpc.Durability} [durability=Durability.Persistent] The "durability
      *    keyspace" that this ledger key belongs to, which is either 'temporary'
-     *    or 'persistent' (the default), see {@link Durability}.
+     *    or 'persistent' (the default), see {@link module:rpc.Durability}.
+     * @returns {Promise<Api.LedgerEntryResult>} The current data value
      *
-     * @returns {Promise<Api.LedgerEntryResult>}   the current data value
+     * @warning If the data entry in question is a 'temporary' entry, it's
+     *    entirely possible that it has expired out of existence.
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries | getLedgerEntries docs}
      *
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries
      * @example
      * const contractId = "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5";
      * const key = xdr.ScVal.scvSymbol("counter");
@@ -116,13 +149,10 @@ export declare class Server {
      * deployed on the Soroban network. The WASM bytecode represents the executable
      * code of the contract.
      *
-     * @param {string} contractId    the contract ID containing the
-     *    WASM bytecode to retrieve
-     *
-     * @returns {Promise<Buffer>}   a Buffer containing the WASM bytecode
-     *
+     * @param {string} contractId The contract ID containing the WASM bytecode to retrieve
+     * @returns {Promise<Buffer>} A Buffer containing the WASM bytecode
      * @throws {Error} If the contract or its associated WASM bytecode cannot be
-     *    found on the network.
+     * found on the network.
      *
      * @example
      * const contractId = "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5";
@@ -141,12 +171,10 @@ export declare class Server {
      * deployed on the Soroban network using the contract's WASM hash. The WASM bytecode
      * represents the executable code of the contract.
      *
-     * @param {Buffer} wasmHash    the WASM hash of the contract
-     *
-     * @returns {Promise<Buffer>}   a Buffer containing the WASM bytecode
-     *
+     * @param {Buffer} wasmHash The WASM hash of the contract
+     * @returns {Promise<Buffer>} A Buffer containing the WASM bytecode
      * @throws {Error} If the contract or its associated WASM bytecode cannot be
-     *    found on the network.
+     * found on the network.
      *
      * @example
      * const wasmHash = Buffer.from("...");
@@ -168,13 +196,12 @@ export declare class Server {
      * {@link xdr.LedgerKeyContractCode} ledger entry key (or see
      * {@link Contract.getFootprint}).
      *
-     * @param {xdr.ScVal[]} keys  one or more ledger entry keys to load
+     * @param {xdr.ScVal[]} keys One or more ledger entry keys to load
+     * @returns {Promise<Api.GetLedgerEntriesResponse>} The current on-chain
+     * values for the given ledger keys
      *
-     * @returns {Promise<Api.GetLedgerEntriesResponse>}  the current
-     *    on-chain values for the given ledger keys
-     *
-     * @see Server._getLedgerEntries
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries | getLedgerEntries docs}
+     * @see RpcServer._getLedgerEntries
      * @example
      * const contractId = "CAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD2KM";
      * const key = xdr.LedgerKey.contractData(new xdr.LedgerKeyContractData({
@@ -199,12 +226,12 @@ export declare class Server {
      * After submitting a transaction, clients should poll this to tell when the
      * transaction has completed.
      *
-     * @param {string} hash   hex-encoded hash of the transaction to check
-     *
-     * @returns {Promise<Api.GetTransactionResponse>}  the status,
+     * @param {string} hash Hex-encoded hash of the transaction to check
+     * @returns {Promise<Api.GetTransactionResponse>} The status,
      *    result, and other details about the transaction
      *
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction | getTransaction docs}
+     *
      * @example
      * const transactionHash = "c4515e3bdc0897f21cc5dbec8c82cf0a936d4741cb74a8e158eb51b9fb00411a";
      * server.getTransaction(transactionHash).then((tx) => {
@@ -239,21 +266,23 @@ export declare class Server {
     /**
      * Fetch all events that match a given set of filters.
      *
-     * 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.
+     * The given filters (see {@link module:rpc.Api.EventFilter | 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 {Server.GetEventsRequest} request   event filters
-     * @returns {Promise<Api.GetEventsResponse>}   a paginatable set of the
-     *    events matching the given event filters
+     * @param {module:rpc.Server.GetEventsRequest} request Event filters
+     * @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}
      *
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getEvents
      * @example
      * server.getEvents({
      *    startLedger: 1000,
+     *    endLedger: 2000,
      *    filters: [
      *     {
      *      type: "contract",
@@ -274,15 +303,16 @@ export declare class Server {
      *    limit: 10,
      * });
      */
-    getEvents(request: Server.GetEventsRequest): Promise<Api.GetEventsResponse>;
-    _getEvents(request: Server.GetEventsRequest): Promise<Api.RawGetEventsResponse>;
+    getEvents(request: RpcServer.GetEventsRequest): Promise<Api.GetEventsResponse>;
+    _getEvents(request: RpcServer.GetEventsRequest): Promise<Api.RawGetEventsResponse>;
     /**
      * Fetch metadata about the network this Soroban RPC server is connected to.
      *
-     * @returns {Promise<Api.GetNetworkResponse>}  metadata about the
-     *    current network this RPC server is connected to
+     * @returns {Promise<Api.GetNetworkResponse>} Metadata about the current
+     * network this RPC server is connected to
+     *
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getNetwork | getNetwork docs}
      *
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getNetwork
      * @example
      * server.getNetwork().then((network) => {
      *   console.log("friendbotUrl:", network.friendbotUrl);
@@ -298,7 +328,8 @@ export declare class Server {
      * @returns {Promise<Api.GetLatestLedgerResponse>}   metadata about the
      *    latest ledger on the network that this RPC server is connected to
      *
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLatestLedger
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLatestLedger | getLatestLedger docs}
+     *
      * @example
      * server.getLatestLedger().then((response) => {
      *   console.log("hash:", response.id);
@@ -316,15 +347,14 @@ export declare class Server {
      *    {@link xdr.InvokeHostFunctionOp}, {@link xdr.ExtendFootprintTTLOp}, or
      *    {@link xdr.RestoreFootprintOp}). Any provided footprint or auth
      *    information will be ignored.
-     *
-     * @returns {Promise<Api.SimulateTransactionResponse>}   an object with the
+     * @returns {Promise<Api.SimulateTransactionResponse>} An object with the
      *    cost, footprint, result/auth requirements (if applicable), and error of
      *    the transaction
      *
-     * @see https://developers.stellar.org/docs/glossary/transactions/
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction
-     * @see Server.prepareTransaction
-     * @see assembleTransaction
+     * @see {@link https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures/operations-and-transactions | transaction docs}
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction | simulateTransaction docs}
+     * @see module:rpc.Server#prepareTransaction
+     * @see module:rpc.assembleTransaction
      *
      * @example
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
@@ -349,8 +379,8 @@ export declare class Server {
      *   console.log("latestLedger:", sim.latestLedger);
      * });
      */
-    simulateTransaction(tx: Transaction | FeeBumpTransaction, addlResources?: Server.ResourceLeeway): Promise<Api.SimulateTransactionResponse>;
-    _simulateTransaction(transaction: Transaction | FeeBumpTransaction, addlResources?: Server.ResourceLeeway): Promise<Api.RawSimulateTransactionResponse>;
+    simulateTransaction(tx: Transaction | FeeBumpTransaction, addlResources?: RpcServer.ResourceLeeway): Promise<Api.SimulateTransactionResponse>;
+    _simulateTransaction(transaction: Transaction | FeeBumpTransaction, addlResources?: RpcServer.ResourceLeeway): Promise<Api.RawSimulateTransactionResponse>;
     /**
      * Submit a trial contract invocation, first run a simulation of the contract
      * invocation as defined on the incoming transaction, and apply the results to
@@ -360,13 +390,14 @@ export declare class Server {
      *
      * The returned transaction will also have an updated fee that is the sum of
      * fee set on incoming transaction with the contract resource fees estimated
-     * from simulation. It is adviseable to check the fee on returned transaction
+     * from simulation. It is advisable to check the fee on returned transaction
      * and validate or take appropriate measures for interaction with user to
      * confirm it is acceptable.
      *
-     * You can call the {@link Server.simulateTransaction} method directly first
-     * if you want to inspect estimated fees for a given transaction in detail
-     * first, then re-assemble it manually or via {@link assembleTransaction}.
+     * You can call the {@link module:rpc.Server#simulateTransaction} method
+     * directly first if you want to inspect estimated fees for a given
+     * transaction in detail first, then re-assemble it manually or via
+     * {@link module:rpc.assembleTransaction}.
      *
      * @param {Transaction | FeeBumpTransaction} tx  the transaction to
      *    prepare. It should include exactly one operation, which must be one of
@@ -378,17 +409,17 @@ export declare class Server {
      *    from the simulation. In other words, if you include auth entries, you
      *    don't care about the auth returned from the simulation. Other fields
      *    (footprint, etc.) will be filled as normal.
-     *
-     * @returns {Promise<Transaction | FeeBumpTransaction>}   a copy of the
+     * @returns {Promise<Transaction | FeeBumpTransaction>} A copy of the
      *    transaction with the expected authorizations (in the case of
      *    invocation), resources, and ledger footprints added. The transaction fee
      *    will also automatically be padded with the contract's minimum resource
      *    fees discovered from the simulation.
-     *
-     * @see assembleTransaction
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction
      * @throws {jsonrpc.Error<any>|Error|Api.SimulateTransactionErrorResponse}
-     *    if simulation fails
+     *    If simulation fails
+     *
+     * @see module:rpc.assembleTransaction
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction | simulateTransaction docs}
+     *
      * @example
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
      * const contract = new StellarSdk.Contract(contractId);
@@ -426,15 +457,16 @@ export declare class Server {
      *
      * Unlike Horizon, Soroban RPC does not wait for transaction completion. It
      * simply validates the transaction and enqueues it. Clients should call
-     * {@link Server.getTransactionStatus} to learn about transaction
+     * {@link module:rpc.Server#getTransaction} to learn about transaction
      * success/failure.
      *
      * @param {Transaction | FeeBumpTransaction} transaction  to submit
      * @returns {Promise<Api.SendTransactionResponse>}   the
      *    transaction id, status, and any error if available
      *
-     * @see https://developers.stellar.org/docs/glossary/transactions/
-     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/sendTransaction
+     * @see {@link https://developers.stellar.org/docs/learn/fundamentals/stellar-data-structures/operations-and-transactions | transaction docs}
+     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/sendTransaction | sendTransaction docs}
+     *
      * @example
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
      * const contract = new StellarSdk.Contract(contractId);
@@ -467,25 +499,23 @@ export declare class Server {
     sendTransaction(transaction: Transaction | FeeBumpTransaction): Promise<Api.SendTransactionResponse>;
     _sendTransaction(transaction: Transaction | FeeBumpTransaction): Promise<Api.RawSendTransactionResponse>;
     /**
-     * Fund a new account using the network's friendbot faucet, if any.
+     * Fund a new account using the network's Friendbot faucet, if any.
      *
-     * @param {string | Account} address  the address or account instance that we
-     *    want to create and fund with friendbot
-     * @param {string} [friendbotUrl]     optionally, an explicit address for
+     * @param {string | Account} address The address or account instance that we
+     *    want to create and fund with Friendbot
+     * @param {string} [friendbotUrl] Optionally, an explicit address for
      *    friendbot (by default: this calls the Soroban RPC
-     *    {@link Server.getNetwork} method to try to discover this network's
-     *    Friendbot url).
-     *
-     * @returns {Promise<Account>}  an {@link Account} object for the created
+     *    {@link module:rpc.Server#getNetwork | getNetwork} method to try to
+     *    discover this network's Friendbot url).
+     * @returns {Promise<Account>} An {@link Account} object for the created
      *    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 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 module:Friendbot.Api.Response}
      *
-     * @see
-     * https://developers.stellar.org/docs/fundamentals-and-concepts/testnet-and-pubnet#friendbot
-     * @see Friendbot.Response
      * @example
      * server
      *    .requestAirdrop("GBZC6Y2Y7Q3ZQ2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4")
@@ -511,4 +541,44 @@ export declare class Server {
      * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getVersionInfo
      */
     getVersionInfo(): Promise<Api.GetVersionInfoResponse>;
+    /**
+     * Returns a contract's balance of a particular SAC asset, if any.
+     *
+     * This is a convenience wrapper around {@link Server.getLedgerEntries}.
+     *
+     * @param {string}  contractId    the contract ID (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
+     *    which this token applies. If omitted, 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>}, which will contain the balance
+     *    entry details if and only if the request returned a valid balance ledger
+     *    entry. If it doesn't, the `balanceEntry` field will not exist.
+     *
+     * @throws {TypeError} If `contractId` is not a valid contract strkey (C...).
+     *
+     * @see getLedgerEntries
+     * @see https://developers.stellar.org/docs/tokens/stellar-asset-contract
+     *
+     * @example
+     * // assume `contractId` is some contract with an XLM balance
+     * // assume server is an instantiated `Server` instance.
+     * const entry = (await server.getSACBalance(
+     *   new Address(contractId),
+     *   Asset.native(),
+     *   Networks.PUBLIC
+     * ));
+     *
+     * // assumes BigInt support:
+     * console.log(
+     *   entry.balanceEntry ?
+     *   BigInt(entry.balanceEntry.amount) :
+     *   "Contract has no XLM");
+     */
+    getSACBalance(contractId: string, sac: Asset, networkPassphrase?: string): Promise<Api.BalanceResponse>;
 }