@stellar/stellar-sdk 12.2.0 → 12.3.0

package/lib/contract/assembled_transaction.d.ts

@@ -445,7 +445,6 @@ export declare class AssembledTransaction<T> {
          */
         signTransaction?: ClientOptions["signTransaction"];
     }) => Promise<SentTransaction<T>>;
-    private getStorageExpiration;
     /**
      * Get a list of accounts, other than the invoker of the simulation, that
      * need to sign auth entries in this transaction.
@@ -492,8 +491,7 @@ export declare class AssembledTransaction<T> {
         /**
          * When to set each auth entry to expire. Could be any number of blocks in
          * the future. Can be supplied as a promise or a raw number. Default:
-         * contract's current `persistent` storage expiration date/ledger
-         * number/block.
+         * about 8.3 minutes from now.
          */
         expiration?: number | Promise<number>;
         /**

package/lib/contract/assembled_transaction.js

@@ -208,33 +208,11 @@ var AssembledTransaction = exports.AssembledTransaction = function () {
         }
       }, _callee3);
     })));
-    _defineProperty(this, "getStorageExpiration", _asyncToGenerator(_regeneratorRuntime().mark(function _callee4() {
-      var entryRes;
-      return _regeneratorRuntime().wrap(function _callee4$(_context4) {
-        while (1) switch (_context4.prev = _context4.next) {
-          case 0:
-            _context4.next = 2;
-            return _this.server.getLedgerEntries(new _stellarBase.Contract(_this.options.contractId).getFootprint());
-          case 2:
-            entryRes = _context4.sent;
-            if (!(!entryRes.entries || !entryRes.entries.length || !entryRes.entries[0].liveUntilLedgerSeq)) {
-              _context4.next = 5;
-              break;
-            }
-            throw new Error("failed to get ledger entry");
-          case 5:
-            return _context4.abrupt("return", entryRes.entries[0].liveUntilLedgerSeq);
-          case 6:
-          case "end":
-            return _context4.stop();
-        }
-      }, _callee4);
-    })));
     _defineProperty(this, "needsNonInvokerSigningBy", function () {
       var _rawInvokeHostFunctio;
-      var _ref8 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
-        _ref8$includeAlreadyS = _ref8.includeAlreadySigned,
-        includeAlreadySigned = _ref8$includeAlreadyS === void 0 ? false : _ref8$includeAlreadyS;
+      var _ref7 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+        _ref7$includeAlreadyS = _ref7.includeAlreadySigned,
+        includeAlreadySigned = _ref7$includeAlreadyS === void 0 ? false : _ref7$includeAlreadyS;
       if (!_this.built) {
         throw new Error("Transaction has not yet been simulated");
       }
@@ -250,12 +228,12 @@ var AssembledTransaction = exports.AssembledTransaction = function () {
     });
     _defineProperty(this, "signAuthEntries", _asyncToGenerator(_regeneratorRuntime().mark(function _callee6() {
       var _rawInvokeHostFunctio2;
-      var _ref10,
-        _ref10$expiration,
+      var _ref9,
+        _ref9$expiration,
         expiration,
-        _ref10$signAuthEntry,
+        _ref9$signAuthEntry,
         signAuthEntry,
-        _ref10$publicKey,
+        _ref9$publicKey,
         publicKey,
         needsNonInvokerSigningBy,
         rawInvokeHostFunctionOp,
@@ -270,7 +248,21 @@ var AssembledTransaction = exports.AssembledTransaction = function () {
       return _regeneratorRuntime().wrap(function _callee6$(_context6) {
         while (1) switch (_context6.prev = _context6.next) {
           case 0:
-            _ref10 = _args6.length > 0 && _args6[0] !== undefined ? _args6[0] : {}, _ref10$expiration = _ref10.expiration, expiration = _ref10$expiration === void 0 ? _this.getStorageExpiration() : _ref10$expiration, _ref10$signAuthEntry = _ref10.signAuthEntry, signAuthEntry = _ref10$signAuthEntry === void 0 ? _this.options.signAuthEntry : _ref10$signAuthEntry, _ref10$publicKey = _ref10.publicKey, publicKey = _ref10$publicKey === void 0 ? _this.options.publicKey : _ref10$publicKey;
+            _ref9 = _args6.length > 0 && _args6[0] !== undefined ? _args6[0] : {}, _ref9$expiration = _ref9.expiration, expiration = _ref9$expiration === void 0 ? _asyncToGenerator(_regeneratorRuntime().mark(function _callee4() {
+              return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+                while (1) switch (_context4.prev = _context4.next) {
+                  case 0:
+                    _context4.next = 2;
+                    return _this.server.getLatestLedger();
+                  case 2:
+                    _context4.t0 = _context4.sent.sequence;
+                    return _context4.abrupt("return", _context4.t0 + 100);
+                  case 4:
+                  case "end":
+                    return _context4.stop();
+                }
+              }, _callee4);
+            }))() : _ref9$expiration, _ref9$signAuthEntry = _ref9.signAuthEntry, signAuthEntry = _ref9$signAuthEntry === void 0 ? _this.options.signAuthEntry : _ref9$signAuthEntry, _ref9$publicKey = _ref9.publicKey, publicKey = _ref9$publicKey === void 0 ? _this.options.publicKey : _ref9$publicKey;
             if (_this.built) {
               _context6.next = 3;
               break;

package/lib/horizon/call_builder.js

@@ -54,10 +54,10 @@ var CallBuilder = exports.CallBuilder = function () {
         timeout = setTimeout(function () {
           var _es;
           (_es = es) === null || _es === void 0 || _es.close();
-          es = createEventSource();
+          es = _createEventSource();
         }, options.reconnectTimeout || 15 * 1000);
       };
-      var createEventSource = function createEventSource() {
+      var _createEventSource = function createEventSource() {
         try {
           es = new EventSource(_this2.url.toString());
         } catch (err) {
@@ -76,7 +76,7 @@ var CallBuilder = exports.CallBuilder = function () {
           }
           clearTimeout(timeout);
           es.close();
-          createEventSource();
+          _createEventSource();
           closed = true;
         };
         var onMessage = function onMessage(message) {
@@ -109,7 +109,7 @@ var CallBuilder = exports.CallBuilder = function () {
         }
         return es;
       };
-      createEventSource();
+      _createEventSource();
       return function () {
         var _es2;
         clearTimeout(timeout);
@@ -321,10 +321,11 @@ var CallBuilder = exports.CallBuilder = function () {
     key: "_handleNetworkError",
     value: (function () {
       var _handleNetworkError2 = _asyncToGenerator(_regeneratorRuntime().mark(function _callee6(error) {
+        var _error$response$statu, _error$response$statu2;
         return _regeneratorRuntime().wrap(function _callee6$(_context6) {
           while (1) switch (_context6.prev = _context6.next) {
             case 0:
-              if (!(error.response && error.response.status && error.response.statusText)) {
+              if (!(error.response && error.response.status)) {
                 _context6.next = 8;
                 break;
               }
@@ -332,9 +333,9 @@ var CallBuilder = exports.CallBuilder = function () {
               _context6.next = _context6.t0 === 404 ? 4 : 5;
               break;
             case 4:
-              return _context6.abrupt("return", Promise.reject(new _errors.NotFoundError(error.response.statusText, error.response.data)));
+              return _context6.abrupt("return", Promise.reject(new _errors.NotFoundError((_error$response$statu = error.response.statusText) !== null && _error$response$statu !== void 0 ? _error$response$statu : "Not Found", error.response.data)));
             case 5:
-              return _context6.abrupt("return", Promise.reject(new _errors.NetworkError(error.response.statusText, error.response.data)));
+              return _context6.abrupt("return", Promise.reject(new _errors.NetworkError((_error$response$statu2 = error.response.statusText) !== null && _error$response$statu2 !== void 0 ? _error$response$statu2 : "Unknown", error.response.data)));
             case 6:
               _context6.next = 9;
               break;

package/lib/rpc/api.d.ts

@@ -31,18 +31,18 @@ export declare namespace Api {
         entries: LedgerEntryResult[];
         latestLedger: number;
     }
-    /** @see https://soroban.stellar.org/api/methods/getLedgerEntries */
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries */
     export interface RawGetLedgerEntriesResponse {
         entries?: RawLedgerEntryResult[];
         latestLedger: number;
     }
-    /** @see https://soroban.stellar.org/api/methods/getNetwork */
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getNetwork */
     export interface GetNetworkResponse {
         friendbotUrl?: string;
         passphrase: string;
         protocolVersion: string;
     }
-    /** @see https://soroban.stellar.org/api/methods/getLatestLedger */
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLatestLedger */
     export interface GetLatestLedgerResponse {
         id: string;
         sequence: number;
@@ -53,7 +53,7 @@ export declare namespace Api {
         NOT_FOUND = "NOT_FOUND",
         FAILED = "FAILED"
     }
-    /** @see https://soroban.stellar.org/api/methods/getTransaction */
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction */
     export type GetTransactionResponse = GetSuccessfulTransactionResponse | GetFailedTransactionResponse | GetMissingTransactionResponse;
     interface GetAnyTransactionResponse {
         status: GetTransactionStatus;
@@ -74,6 +74,7 @@ export declare namespace Api {
         envelopeXdr: xdr.TransactionEnvelope;
         resultXdr: xdr.TransactionResult;
         resultMetaXdr: xdr.TransactionMeta;
+        diagnosticEventsXdr?: xdr.DiagnosticEvent[];
     }
     export interface GetSuccessfulTransactionResponse extends GetAnyTransactionResponse {
         status: GetTransactionStatus.SUCCESS;
@@ -84,6 +85,7 @@ export declare namespace Api {
         envelopeXdr: xdr.TransactionEnvelope;
         resultXdr: xdr.TransactionResult;
         resultMetaXdr: xdr.TransactionMeta;
+        diagnosticEventsXdr?: xdr.DiagnosticEvent[];
         returnValue?: xdr.ScVal;
     }
     export interface RawGetTransactionResponse {
@@ -99,6 +101,51 @@ export declare namespace Api {
         resultMetaXdr?: string;
         ledger?: number;
         createdAt?: number;
+        diagnosticEventsXdr?: string[];
+    }
+    export interface GetTransactionsRequest {
+        startLedger: number;
+        cursor?: string;
+        limit?: number;
+    }
+    export interface RawTransactionInfo {
+        status: GetTransactionStatus;
+        ledger: number;
+        createdAt: number;
+        applicationOrder: number;
+        feeBump: boolean;
+        envelopeXdr?: string;
+        resultXdr?: string;
+        resultMetaXdr?: string;
+        diagnosticEventsXdr?: string[];
+    }
+    export interface TransactionInfo {
+        status: GetTransactionStatus;
+        ledger: number;
+        createdAt: number;
+        applicationOrder: number;
+        feeBump: boolean;
+        envelopeXdr: xdr.TransactionEnvelope;
+        resultXdr: xdr.TransactionResult;
+        resultMetaXdr: xdr.TransactionMeta;
+        returnValue?: xdr.ScVal;
+        diagnosticEventsXdr?: xdr.DiagnosticEvent[];
+    }
+    export interface GetTransactionsResponse {
+        transactions: TransactionInfo[];
+        latestLedger: number;
+        latestLedgerCloseTimestamp: number;
+        oldestLedger: number;
+        oldestLedgerCloseTimestamp: number;
+        cursor: string;
+    }
+    export interface RawGetTransactionsResponse {
+        transactions: RawTransactionInfo[];
+        latestLedger: number;
+        latestLedgerCloseTimestamp: number;
+        oldestLedger: number;
+        oldestLedgerCloseTimestamp: number;
+        cursor: string;
     }
     export type EventType = 'contract' | 'system' | 'diagnostic';
     export interface EventFilter {
@@ -188,7 +235,7 @@ export declare namespace Api {
      *     fields
      *   - for all other errors, this only includes error fields
      *
-     * @see https://soroban.stellar.org/api/methods/simulateTransaction#returns
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction
      */
     export type SimulateTransactionResponse = SimulateTransactionSuccessResponse | SimulateTransactionRestoreResponse | SimulateTransactionErrorResponse;
     export interface BaseSimulateTransactionResponse {
@@ -243,7 +290,7 @@ export declare namespace Api {
         auth?: string[];
         xdr: string;
     }
-    /** @see https://soroban.stellar.org/api/methods/simulateTransaction#returns */
+    /** @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction */
     export interface RawSimulateTransactionResponse {
         id: string;
         latestLedger: number;
@@ -267,6 +314,13 @@ export declare namespace Api {
         /** State Difference information */
         stateChanges?: RawLedgerEntryChange[];
     }
+    export interface GetVersionInfoResponse {
+        version: string;
+        commit_hash: string;
+        build_time_stamp: string;
+        captive_core_version: string;
+        protocol_version: number;
+    }
     export interface GetFeeStatsResponse {
         sorobanInclusionFee: FeeDistribution;
         inclusionFee: FeeDistribution;

package/lib/rpc/parsers.d.ts

@@ -1,5 +1,7 @@
 import { Api } from './api';
 export declare function parseRawSendTransaction(r: 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;
 /**

package/lib/rpc/parsers.js

@@ -7,6 +7,8 @@ exports.parseRawEvents = parseRawEvents;
 exports.parseRawLedgerEntries = parseRawLedgerEntries;
 exports.parseRawSendTransaction = parseRawSendTransaction;
 exports.parseRawSimulation = parseRawSimulation;
+exports.parseRawTransactions = parseRawTransactions;
+exports.parseTransactionInfo = parseTransactionInfo;
 var _stellarBase = require("@stellar/stellar-base");
 var _api = require("./api");
 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); }
@@ -31,6 +33,33 @@ function parseRawSendTransaction(r) {
   }
   return _objectSpread({}, r);
 }
+function parseTransactionInfo(raw) {
+  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'),
+    resultMetaXdr: meta
+  };
+  if (meta.switch() === 3 && meta.v3().sorobanMeta() !== null) {
+    var _meta$v3$sorobanMeta;
+    info.returnValue = (_meta$v3$sorobanMeta = meta.v3().sorobanMeta()) === null || _meta$v3$sorobanMeta === void 0 ? void 0 : _meta$v3$sorobanMeta.returnValue();
+  }
+  if ('diagnosticEventsXdr' in raw && raw.diagnosticEventsXdr) {
+    info.diagnosticEventsXdr = raw.diagnosticEventsXdr.map(function (diagnosticEvent) {
+      return _stellarBase.xdr.DiagnosticEvent.fromXDR(diagnosticEvent, 'base64');
+    });
+  }
+  return info;
+}
+function parseRawTransactions(r) {
+  return _objectSpread({
+    status: r.status
+  }, parseTransactionInfo(r));
+}
 function parseRawEvents(r) {
   var _r$events;
   return {

package/lib/rpc/server.d.ts

@@ -56,7 +56,7 @@ export declare class Server {
      * @returns {Promise<Account>}  a promise to the {@link Account} object with
      *    a populated sequence number
      *
-     * @see https://soroban.stellar.org/api/methods/getLedgerEntries
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries
      * @example
      * const accountId = "GBZC6Y2Y7Q3ZQ2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4QZJ2XZ3Z5YXZ6Z7Z2Y4";
      * server.getAccount(accountId).then((account) => {
@@ -71,7 +71,7 @@ export declare class Server {
      *    {@link Api.GetHealthResponse} object with the status of the
      *    server (e.g. "healthy").
      *
-     * @see https://soroban.stellar.org/api/methods/getHealth
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getHealth
      * @example
      * server.getHealth().then((health) => {
      *   console.log("status:", health.status);
@@ -97,7 +97,7 @@ export declare class Server {
      *
      * @returns {Promise<Api.LedgerEntryResult>}   the current data value
      *
-     * @see https://soroban.stellar.org/api/methods/getLedgerEntries
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries
      * @example
      * const contractId = "CCJZ5DGASBWQXR5MPFCJXMBI333XE5U3FSJTNQU7RIKE3P5GN2K2WYD5";
      * const key = xdr.ScVal.scvSymbol("counter");
@@ -174,7 +174,7 @@ export declare class Server {
      *    on-chain values for the given ledger keys
      *
      * @see Server._getLedgerEntries
-     * @see https://soroban.stellar.org/api/methods/getLedgerEntries
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLedgerEntries
      * @example
      * const contractId = "CAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD2KM";
      * const key = xdr.LedgerKey.contractData(new xdr.LedgerKeyContractData({
@@ -204,7 +204,7 @@ export declare class Server {
      * @returns {Promise<Api.GetTransactionResponse>}  the status,
      *    result, and other details about the transaction
      *
-     * @see https://soroban.stellar.org/api/methods/getTransaction
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction
      * @example
      * const transactionHash = "c4515e3bdc0897f21cc5dbec8c82cf0a936d4741cb74a8e158eb51b9fb00411a";
      * server.getTransaction(transactionHash).then((tx) => {
@@ -216,6 +216,26 @@ export declare class Server {
      */
     getTransaction(hash: string): Promise<Api.GetTransactionResponse>;
     _getTransaction(hash: string): Promise<Api.RawGetTransactionResponse>;
+    /**
+     * Fetch transactions starting from a given start ledger or a cursor. The end ledger is the latest ledger
+     * in that RPC instance.
+     *
+     * @param {Api.GetTransactionsRequest} request - The request parameters.
+     * @returns {Promise<Api.GetTransactionsResponse>} - A promise that resolves to the transactions response.
+     *
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransactions
+     * @example
+     * server.getTransactions({
+     *   startLedger: 10000,
+     *   limit: 10,
+     * }).then((response) => {
+     *   console.log("Transactions:", response.transactions);
+     *   console.log("Latest Ledger:", response.latestLedger);
+     *   console.log("Cursor:", response.cursor);
+     * });
+     */
+    getTransactions(request: Api.GetTransactionsRequest): Promise<Api.GetTransactionsResponse>;
+    private _getTransactions;
     /**
      * Fetch all events that match a given set of filters.
      *
@@ -230,7 +250,7 @@ export declare class Server {
      * @returns {Promise<Api.GetEventsResponse>}   a paginatable set of the
      *    events matching the given event filters
      *
-     * @see https://soroban.stellar.org/api/methods/getEvents
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getEvents
      * @example
      * server.getEvents({
      *    startLedger: 1000,
@@ -262,7 +282,7 @@ export declare class Server {
      * @returns {Promise<Api.GetNetworkResponse>}  metadata about the
      *    current network this RPC server is connected to
      *
-     * @see https://soroban.stellar.org/api/methods/getNetwork
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getNetwork
      * @example
      * server.getNetwork().then((network) => {
      *   console.log("friendbotUrl:", network.friendbotUrl);
@@ -278,7 +298,7 @@ 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://soroban.stellar.org/api/methods/getLatestLedger
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getLatestLedger
      * @example
      * server.getLatestLedger().then((response) => {
      *   console.log("hash:", response.id);
@@ -302,7 +322,7 @@ export declare class Server {
      *    the transaction
      *
      * @see https://developers.stellar.org/docs/glossary/transactions/
-     * @see https://soroban.stellar.org/api/methods/simulateTransaction
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction
      * @see Server.prepareTransaction
      * @see assembleTransaction
      *
@@ -366,7 +386,7 @@ export declare class Server {
      *    fees discovered from the simulation.
      *
      * @see assembleTransaction
-     * @see https://soroban.stellar.org/api/methods/simulateTransaction
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/simulateTransaction
      * @throws {jsonrpc.Error<any>|Error|Api.SimulateTransactionErrorResponse}
      *    if simulation fails
      * @example
@@ -414,7 +434,7 @@ export declare class Server {
      *    transaction id, status, and any error if available
      *
      * @see https://developers.stellar.org/docs/glossary/transactions/
-     * @see https://soroban.stellar.org/api/methods/sendTransaction
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/sendTransaction
      * @example
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
      * const contract = new StellarSdk.Contract(contractId);
@@ -481,7 +501,14 @@ export declare class Server {
      * contract operations.
      *
      * @returns {Promise<Api.GetFeeStatsResponse>}  the fee stats
-     * @see https://soroban.stellar.org/api/methods/getFeeStats
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getFeeStats
      */
     getFeeStats(): Promise<Api.GetFeeStatsResponse>;
+    /**
+     * Provides information about the current version details of the Soroban RPC and captive-core
+     *
+     * @returns {Promise<Api.GetVersionInfoResponse>} the version info
+     * @see https://developers.stellar.org/docs/data/rpc/api-reference/methods/getVersionInfo
+     */
+    getVersionInfo(): Promise<Api.GetVersionInfoResponse>;
 }