@stellar/stellar-sdk 14.1.0 → 14.2.0

package/lib/no-eventsource/index.js

@@ -71,9 +71,9 @@ Object.keys(_stellarBase).forEach(function (key) {
 });
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 var _default = exports.default = module.exports;
-if (typeof global.__USE_AXIOS__ === 'undefined') {
+if (typeof global.__USE_AXIOS__ === "undefined") {
   global.__USE_AXIOS__ = true;
 }
-if (typeof global.__USE_EVENTSOURCE__ === 'undefined') {
+if (typeof global.__USE_EVENTSOURCE__ === "undefined") {
   global.__USE_EVENTSOURCE__ = false;
 }

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

@@ -1,7 +1,7 @@
-import { Contract, SorobanDataBuilder, xdr } from '@stellar/stellar-base';
+import { Contract, SorobanDataBuilder, xdr } from "@stellar/stellar-base";
 export declare namespace Api {
     export interface GetHealthResponse {
-        status: 'healthy';
+        status: "healthy";
     }
     export interface LedgerEntryResult {
         lastModifiedLedgerSeq?: number;
@@ -103,11 +103,19 @@ export declare namespace Api {
         diagnosticEventsXdr?: string[];
         events?: RawTransactionEvents;
     }
-    export interface GetTransactionsRequest {
+    export type GetTransactionsRequest = {
         startLedger: number;
-        cursor?: string;
-        limit?: number;
-    }
+        pagination?: {
+            cursor?: never;
+            limit?: number;
+        };
+    } | {
+        startLedger?: never;
+        pagination: {
+            cursor: string;
+            limit?: number;
+        };
+    };
     export interface RawTransactionEvents {
         transactionEventsXdr?: string[];
         contractEventsXdr?: string[][];
@@ -159,7 +167,7 @@ export declare namespace Api {
         oldestLedgerCloseTimestamp: number;
         cursor: string;
     }
-    export type EventType = 'contract' | 'system';
+    export type EventType = "contract" | "system";
     export interface EventFilter {
         type?: EventType;
         contractIds?: string[];
@@ -189,7 +197,8 @@ export declare namespace Api {
         type: EventType;
         ledger: number;
         ledgerClosedAt: string;
-        pagingToken: string;
+        transactionIndex: number;
+        operationIndex: number;
         inSuccessfulContractCall: boolean;
         txHash: string;
     }
@@ -213,7 +222,7 @@ export declare namespace Api {
         before: xdr.LedgerEntry | null;
         after: xdr.LedgerEntry | null;
     }
-    export type SendTransactionStatus = 'PENDING' | 'DUPLICATE' | 'TRY_AGAIN_LATER' | 'ERROR';
+    export type SendTransactionStatus = "PENDING" | "DUPLICATE" | "TRY_AGAIN_LATER" | "ERROR";
     export interface SendTransactionResponse extends BaseSendTransactionResponse {
         errorResult?: xdr.TransactionResult;
         diagnosticEvents?: xdr.DiagnosticEvent[];

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

@@ -14,15 +14,15 @@ var Api;
   }({});
   _Api.GetTransactionStatus = GetTransactionStatus;
   function isSimulationError(sim) {
-    return 'error' in sim;
+    return "error" in sim;
   }
   _Api.isSimulationError = isSimulationError;
   function isSimulationSuccess(sim) {
-    return 'transactionData' in sim;
+    return "transactionData" in sim;
   }
   _Api.isSimulationSuccess = isSimulationSuccess;
   function isSimulationRestore(sim) {
-    return isSimulationSuccess(sim) && 'restorePreamble' in sim && !!sim.restorePreamble.transactionData;
+    return isSimulationSuccess(sim) && "restorePreamble" in sim && !!sim.restorePreamble.transactionData;
   }
   _Api.isSimulationRestore = isSimulationRestore;
   function isSimulationRaw(sim) {

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { Api } from './api';
+import { Api } from "./api";
 /**
  * Parse the response from invoking the `submitTransaction` method of a RPC server.
  * @memberof module:rpc
@@ -8,7 +8,7 @@ import { Api } from './api';
  * @returns {Api.SendTransactionResponse} transaction response parsed from the 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' | 'txHash'>;
+export declare function parseTransactionInfo(raw: Api.RawTransactionInfo | Api.RawGetTransactionResponse): Omit<Api.TransactionInfo, "status" | "txHash">;
 export declare function parseRawTransactions(r: Api.RawTransactionInfo): Api.TransactionInfo;
 /**
  * Parse and return the retrieved events, if any, from a raw response from a

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

@@ -25,24 +25,24 @@ function parseRawSendTransaction(raw) {
   if (errorResultXdr) {
     return _objectSpread(_objectSpread(_objectSpread({}, raw), diagnosticEventsXdr !== undefined && diagnosticEventsXdr.length > 0 && {
       diagnosticEvents: diagnosticEventsXdr.map(function (evt) {
-        return _stellarBase.xdr.DiagnosticEvent.fromXDR(evt, 'base64');
+        return _stellarBase.xdr.DiagnosticEvent.fromXDR(evt, "base64");
       })
     }), {}, {
-      errorResult: _stellarBase.xdr.TransactionResult.fromXDR(errorResultXdr, 'base64')
+      errorResult: _stellarBase.xdr.TransactionResult.fromXDR(errorResultXdr, "base64")
     });
   }
   return _objectSpread({}, raw);
 }
 function parseTransactionInfo(raw) {
   var _raw$events$contractE, _raw$events, _raw$events$transacti, _raw$events2;
-  var meta = _stellarBase.xdr.TransactionMeta.fromXDR(raw.resultMetaXdr, 'base64');
+  var meta = _stellarBase.xdr.TransactionMeta.fromXDR(raw.resultMetaXdr, "base64");
   var info = {
     ledger: raw.ledger,
     createdAt: raw.createdAt,
     applicationOrder: raw.applicationOrder,
     feeBump: raw.feeBump,
-    envelopeXdr: _stellarBase.xdr.TransactionEnvelope.fromXDR(raw.envelopeXdr, 'base64'),
-    resultXdr: _stellarBase.xdr.TransactionResult.fromXDR(raw.resultXdr, 'base64'),
+    envelopeXdr: _stellarBase.xdr.TransactionEnvelope.fromXDR(raw.envelopeXdr, "base64"),
+    resultXdr: _stellarBase.xdr.TransactionResult.fromXDR(raw.resultXdr, "base64"),
     resultMetaXdr: meta,
     events: {
       contractEventsXdr: ((_raw$events$contractE = (_raw$events = raw.events) === null || _raw$events === void 0 ? void 0 : _raw$events.contractEventsXdr) !== null && _raw$events$contractE !== void 0 ? _raw$events$contractE : []).map(function (lst) {
@@ -66,7 +66,7 @@ function parseTransactionInfo(raw) {
   }
   if (raw.diagnosticEventsXdr) {
     info.diagnosticEventsXdr = raw.diagnosticEventsXdr.map(function (e) {
-      return _stellarBase.xdr.DiagnosticEvent.fromXDR(e, 'base64');
+      return _stellarBase.xdr.DiagnosticEvent.fromXDR(e, "base64");
     });
   }
   return info;
@@ -88,13 +88,13 @@ function parseRawEvents(raw) {
     events: ((_raw$events3 = raw.events) !== null && _raw$events3 !== void 0 ? _raw$events3 : []).map(function (evt) {
       var clone = _objectSpread({}, evt);
       delete clone.contractId;
-      return _objectSpread(_objectSpread(_objectSpread({}, clone), evt.contractId !== '' && {
+      return _objectSpread(_objectSpread(_objectSpread({}, clone), evt.contractId !== "" && {
         contractId: new _stellarBase.Contract(evt.contractId)
       }), {}, {
         topic: evt.topic.map(function (topic) {
-          return _stellarBase.xdr.ScVal.fromXDR(topic, 'base64');
+          return _stellarBase.xdr.ScVal.fromXDR(topic, "base64");
         }),
-        value: _stellarBase.xdr.ScVal.fromXDR(evt.value, 'base64')
+        value: _stellarBase.xdr.ScVal.fromXDR(evt.value, "base64")
       });
     })
   };
@@ -109,8 +109,8 @@ function parseRawLedgerEntries(raw) {
       }
       return _objectSpread({
         lastModifiedLedgerSeq: rawEntry.lastModifiedLedgerSeq,
-        key: _stellarBase.xdr.LedgerKey.fromXDR(rawEntry.key, 'base64'),
-        val: _stellarBase.xdr.LedgerEntryData.fromXDR(rawEntry.xdr, 'base64')
+        key: _stellarBase.xdr.LedgerKey.fromXDR(rawEntry.key, "base64"),
+        val: _stellarBase.xdr.LedgerEntryData.fromXDR(rawEntry.xdr, "base64")
       }, rawEntry.liveUntilLedgerSeq !== undefined && {
         liveUntilLedgerSeq: rawEntry.liveUntilLedgerSeq
       });
@@ -127,22 +127,22 @@ function parseSuccessful(sim, partial) {
       var _row$auth;
       return {
         auth: ((_row$auth = row.auth) !== null && _row$auth !== void 0 ? _row$auth : []).map(function (entry) {
-          return _stellarBase.xdr.SorobanAuthorizationEntry.fromXDR(entry, 'base64');
+          return _stellarBase.xdr.SorobanAuthorizationEntry.fromXDR(entry, "base64");
         }),
-        retval: row.xdr ? _stellarBase.xdr.ScVal.fromXDR(row.xdr, 'base64') : _stellarBase.xdr.ScVal.scvVoid()
+        retval: row.xdr ? _stellarBase.xdr.ScVal.fromXDR(row.xdr, "base64") : _stellarBase.xdr.ScVal.scvVoid()
       };
     })[0]
   }), ((_sim$stateChanges$len = (_sim$stateChanges = sim.stateChanges) === null || _sim$stateChanges === void 0 ? void 0 : _sim$stateChanges.length) !== null && _sim$stateChanges$len !== void 0 ? _sim$stateChanges$len : 0 > 0) && {
     stateChanges: (_sim$stateChanges2 = sim.stateChanges) === null || _sim$stateChanges2 === void 0 ? void 0 : _sim$stateChanges2.map(function (entryChange) {
       return {
         type: entryChange.type,
-        key: _stellarBase.xdr.LedgerKey.fromXDR(entryChange.key, 'base64'),
-        before: entryChange.before ? _stellarBase.xdr.LedgerEntry.fromXDR(entryChange.before, 'base64') : null,
-        after: entryChange.after ? _stellarBase.xdr.LedgerEntry.fromXDR(entryChange.after, 'base64') : null
+        key: _stellarBase.xdr.LedgerKey.fromXDR(entryChange.key, "base64"),
+        before: entryChange.before ? _stellarBase.xdr.LedgerEntry.fromXDR(entryChange.before, "base64") : null,
+        after: entryChange.after ? _stellarBase.xdr.LedgerEntry.fromXDR(entryChange.after, "base64") : null
       };
     })
   });
-  if (!sim.restorePreamble || sim.restorePreamble.transactionData === '') {
+  if (!sim.restorePreamble || sim.restorePreamble.transactionData === "") {
     return success;
   }
   return _objectSpread(_objectSpread({}, success), {}, {
@@ -163,10 +163,10 @@ function parseRawSimulation(sim) {
     id: sim.id,
     latestLedger: sim.latestLedger,
     events: (_sim$events$map = (_sim$events = sim.events) === null || _sim$events === void 0 ? void 0 : _sim$events.map(function (evt) {
-      return _stellarBase.xdr.DiagnosticEvent.fromXDR(evt, 'base64');
+      return _stellarBase.xdr.DiagnosticEvent.fromXDR(evt, "base64");
     })) !== null && _sim$events$map !== void 0 ? _sim$events$map : []
   };
-  if (typeof sim.error === 'string') {
+  if (typeof sim.error === "string") {
     return _objectSpread(_objectSpread({}, base), {}, {
       error: sim.error
     });

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

@@ -1,6 +1,6 @@
-import URI from 'urijs';
-import { Account, Address, Asset, Contract, FeeBumpTransaction, Transaction, xdr } from '@stellar/stellar-base';
-import { Api } from './api';
+import URI from "urijs";
+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}
@@ -106,6 +106,66 @@ export declare class RpcServer {
      * });
      */
     getAccount(address: string): Promise<Account>;
+    /**
+     * Fetch the full account entry for a Stellar account.
+     *
+     * @param {string} address The public address of the account to load.
+     * @returns {Promise<xdr.AccountEntry>} Resolves to the full on-chain account
+     *    entry
+     *
+     * @see
+     * {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries | getLedgerEntries docs}
+     *
+     * @example
+     * const accountId = "GBZC6Y2Y7Q3ZQ2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4";
+     * server.getAccountEntry(accountId).then((account) => {
+     *   console.log("sequence:", account.balance().toString());
+     * });
+     */
+    getAccountEntry(address: string): Promise<xdr.AccountEntry>;
+    /**
+     * Fetch the full trustline entry for a Stellar account.
+     *
+     * @param {string} account  The public address of the account whose trustline it is
+     * @param {string} asset    The trustline's asset
+     * @returns {Promise<xdr.TrustLineEntry>} Resolves to the full on-chain trustline
+     *    entry
+     *
+     * @see
+     * {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries | getLedgerEntries docs}
+     *
+     * @example
+     * const accountId = "GBZC6Y2Y7Q3ZQ2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4";
+     * const asset = new Asset(
+     *  "USDC",
+     *  "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
+     * );
+     * server.getTrustline(accountId, asset).then((entry) => {
+     *   console.log(`{asset.toString()} balance for ${accountId}:", entry.balance().toString());
+     * });
+     */
+    getTrustline(account: string, asset: Asset): Promise<xdr.TrustLineEntry>;
+    /**
+     * Fetch the full claimable balance entry for a Stellar account.
+     *
+     * @param {string} id   The strkey (`B...`) or hex (`00000000abcde...`) (both
+     *    IDs with and without the 000... version prefix are accepted) of the
+     *    claimable balance to load
+     * @returns {Promise<xdr.ClaimableBalanceEntry>} Resolves to the full on-chain
+     *    claimable balance entry
+     *
+     * @see
+     * {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries | getLedgerEntries docs}
+     *
+     * @example
+     * const id = "00000000178826fbfe339e1f5c53417c6fedfe2c05e8bec14303143ec46b38981b09c3f9";
+     * server.getClaimableBalance(id).then((entry) => {
+     *   console.log(`Claimable balance {id.substr(0, 12)} has:`);
+     *   console.log(`  asset:  ${Asset.fromXDRObject(entry.asset()).toString()}`;
+     *   console.log(`  amount: ${entry.amount().toString()}`;
+     * });
+     */
+    getClaimableBalance(id: string): Promise<xdr.ClaimableBalanceEntry>;
     /**
      * General node health check.
      *
@@ -231,6 +291,7 @@ export declare class RpcServer {
      */
     getLedgerEntries(...keys: xdr.LedgerKey[]): Promise<Api.GetLedgerEntriesResponse>;
     _getLedgerEntries(...keys: xdr.LedgerKey[]): Promise<Api.RawGetLedgerEntriesResponse>;
+    getLedgerEntry(key: xdr.LedgerKey): Promise<Api.LedgerEntryResult>;
     /**
      * Poll for a particular transaction with certain parameters.
      *
@@ -575,7 +636,7 @@ export declare class RpcServer {
      *      console.error("error:", error);
      *    });
      */
-    requestAirdrop(address: string | Pick<Account, 'accountId'>, friendbotUrl?: string): Promise<Account>;
+    requestAirdrop(address: string | Pick<Account, "accountId">, friendbotUrl?: string): Promise<Account>;
     /**
      * Provides an analysis of the recent fee stats for regular and smart
      * contract operations.
@@ -596,8 +657,8 @@ export declare class RpcServer {
      *
      * 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 {string}  address the contract (string `C...`) or account ID
+     *    (`G...`) 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
@@ -610,16 +671,16 @@ export declare class RpcServer {
      *    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...).
+     * @throws {TypeError} If `address` is not a valid contract ID (C...).
      *
      * @see getLedgerEntries
      * @see https://developers.stellar.org/docs/tokens/stellar-asset-contract
      *
      * @example
-     * // assume `contractId` is some contract with an XLM balance
+     * // assume `address` is some contract or account with an XLM balance
      * // assume server is an instantiated `Server` instance.
      * const entry = (await server.getSACBalance(
-     *   new Address(contractId),
+     *   new Address(address),
      *   Asset.native(),
      *   Networks.PUBLIC
      * ));
@@ -628,7 +689,7 @@ export declare class RpcServer {
      * console.log(
      *   entry.balanceEntry ?
      *   BigInt(entry.balanceEntry.amount) :
-     *   "Contract has no XLM");
+     *   "Address has no XLM");
      */
-    getSACBalance(contractId: string, sac: Asset, networkPassphrase?: string): Promise<Api.BalanceResponse>;
+    getSACBalance(address: string | Address, sac: Asset, networkPassphrase?: string): Promise<Api.BalanceResponse>;
 }