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

package/lib/minimal/utils.d.ts

@@ -16,4 +16,5 @@ export declare class Utils {
      * @static
      */
     static validateTimebounds(transaction: Transaction, gracePeriod?: number): boolean;
+    static sleep(ms: number): Promise<void>;
 }

package/lib/minimal/utils.js

@@ -27,5 +27,12 @@ var Utils = exports.Utils = function () {
         maxTime = _transaction$timeBoun.maxTime;
       return now >= Number.parseInt(minTime, 10) - gracePeriod && now <= Number.parseInt(maxTime, 10) + gracePeriod;
     }
+  }, {
+    key: "sleep",
+    value: function sleep(ms) {
+      return new Promise(function (resolve) {
+        return setTimeout(resolve, ms);
+      });
+    }
   }]);
 }();

package/lib/no-axios/contract/assembled_transaction.js

@@ -495,7 +495,7 @@ var AssembledTransaction = exports.AssembledTransaction = function () {
               throw new Error("The transaction has not yet been signed. Run `sign` first, or use `signAndSend` instead.");
             case 2:
               _context8.next = 4;
-              return _sent_transaction.SentTransaction.init(undefined, this);
+              return _sent_transaction.SentTransaction.init(this);
             case 4:
               sent = _context8.sent;
               return _context8.abrupt("return", sent);

package/lib/no-axios/contract/sent_transaction.d.ts

@@ -73,13 +73,12 @@ export declare class SentTransaction<T> {
             stackTraceLimit: number;
         };
     };
-    constructor(_: any, // deprecated: used to take sentTransaction, need to wait for major release for breaking change
-    assembled: AssembledTransaction<T>);
+    constructor(assembled: AssembledTransaction<T>);
     /**
      * Initialize a `SentTransaction` from `options` and a `signed`
      * AssembledTransaction. This will also send the transaction to the network.
      */
-    static init: <U>(_: any, assembled: AssembledTransaction<U>) => Promise<SentTransaction<U>>;
+    static init: <U>(assembled: AssembledTransaction<U>) => Promise<SentTransaction<U>>;
     private send;
     get result(): T;
 }

package/lib/no-axios/contract/sent_transaction.js

@@ -30,7 +30,7 @@ function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object
 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 SentTransaction = exports.SentTransaction = function () {
-  function SentTransaction(_, assembled) {
+  function SentTransaction(assembled) {
     var _this = this,
       _this$assembled$optio2;
     _classCallCheck(this, SentTransaction);
@@ -128,12 +128,12 @@ _defineProperty(SentTransaction, "Errors", {
   }(_wrapNativeSuper(Error))
 });
 _defineProperty(SentTransaction, "init", function () {
-  var _ref2 = _asyncToGenerator(_regeneratorRuntime().mark(function _callee2(_, assembled) {
+  var _ref2 = _asyncToGenerator(_regeneratorRuntime().mark(function _callee2(assembled) {
     var tx, sent;
     return _regeneratorRuntime().wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
-          tx = new _SentTransaction(undefined, assembled);
+          tx = new _SentTransaction(assembled);
           _context2.next = 3;
           return tx.send();
         case 3:
@@ -145,7 +145,7 @@ _defineProperty(SentTransaction, "init", function () {
       }
     }, _callee2);
   }));
-  return function (_x, _x2) {
+  return function (_x) {
     return _ref2.apply(this, arguments);
   };
 }());

package/lib/no-axios/horizon/horizon_axios_client.js

@@ -10,7 +10,7 @@ var _urijs = _interopRequireDefault(require("urijs"));
 var _httpClient = require("../http-client");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var version = exports.version = "13.0.0-beta.1";
+var version = exports.version = "13.0.0-rc.1";
 var SERVER_TIME_MAP = exports.SERVER_TIME_MAP = {};
 var AxiosClient = exports.AxiosClient = (0, _httpClient.create)({
   headers: {

package/lib/no-axios/horizon/server_api.d.ts

@@ -102,21 +102,6 @@ export declare namespace ServerApi {
         header_xdr: string;
         base_fee_in_stroops: number;
         base_reserve_in_stroops: number;
-        /**
-         * @deprecated  This will be removed in the next major version: the property
-         *     no longer exists on the Horizon API
-         */
-        transaction_count: number;
-        /**
-         * @deprecated  This will be removed in the next major version: the property
-         *     no longer exists on the Horizon API
-         */
-        base_fee: number;
-        /**
-         * @deprecated  This will be removed in the next major version: the property
-         *     no longer exists on the Horizon API
-         */
-        base_reserve: string;
         effects: CallCollectionFunction<EffectRecord>;
         operations: CallCollectionFunction<OperationRecord>;
         self: CallFunction<LedgerRecord>;

package/lib/no-axios/horizon/types/assets.d.ts

@@ -10,8 +10,6 @@ export interface AssetRecord extends HorizonApi.BaseResponse {
     num_claimable_balances: number;
     num_liquidity_pools: number;
     num_contracts: number;
-    num_accounts: number;
-    amount: string;
     claimable_balances_amount: string;
     liquidity_pools_amount: string;
     contracts_amount: string;

package/lib/no-axios/index.d.ts

@@ -16,10 +16,6 @@ export * as Horizon from './horizon';
  * import { Server } from '@stellar/stellar-sdk/rpc';
  */
 export * as rpc from './rpc';
-/**
- * @deprecated Use `rpc` instead
- */
-export * as SorobanRpc from './rpc';
 /**
  * Tools for interacting with smart contracts, such as `Client`, `Spec`, and
  * `AssembledTransaction`. You can import these from the `/contract`

package/lib/no-axios/index.js

@@ -13,7 +13,6 @@ var _exportNames = {
   Friendbot: true,
   Horizon: true,
   rpc: true,
-  SorobanRpc: true,
   contract: true
 };
 Object.defineProperty(exports, "Config", {
@@ -22,7 +21,7 @@ Object.defineProperty(exports, "Config", {
     return _config.Config;
   }
 });
-exports.StellarToml = exports.SorobanRpc = exports.Horizon = exports.Friendbot = exports.Federation = void 0;
+exports.StellarToml = exports.Horizon = exports.Friendbot = exports.Federation = void 0;
 Object.defineProperty(exports, "Utils", {
   enumerable: true,
   get: function get() {
@@ -55,9 +54,7 @@ exports.Friendbot = _Friendbot;
 var _Horizon = _interopRequireWildcard(require("./horizon"));
 exports.Horizon = _Horizon;
 var _rpc = _interopRequireWildcard(require("./rpc"));
-var _SorobanRpc = _rpc;
 exports.rpc = _rpc;
-exports.SorobanRpc = _rpc;
 var _contract = _interopRequireWildcard(require("./contract"));
 exports.contract = _contract;
 var _stellarBase = require("@stellar/stellar-base");

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

@@ -1,9 +1,5 @@
 import { Contract, SorobanDataBuilder, xdr } from '@stellar/stellar-base';
 export declare namespace Api {
-    export interface Cost {
-        cpuInsns: string;
-        memBytes: string;
-    }
     export interface GetHealthResponse {
         status: 'healthy';
     }
@@ -56,6 +52,7 @@ export declare namespace Api {
     export type GetTransactionResponse = GetSuccessfulTransactionResponse | GetFailedTransactionResponse | GetMissingTransactionResponse;
     interface GetAnyTransactionResponse {
         status: GetTransactionStatus;
+        txHash: string;
         latestLedger: number;
         latestLedgerCloseTime: number;
         oldestLedger: number;
@@ -93,13 +90,14 @@ export declare namespace Api {
         latestLedgerCloseTime: number;
         oldestLedger: number;
         oldestLedgerCloseTime: number;
+        txHash: string;
         applicationOrder?: number;
         feeBump?: boolean;
+        ledger?: number;
+        createdAt?: number;
         envelopeXdr?: string;
         resultXdr?: string;
         resultMetaXdr?: string;
-        ledger?: number;
-        createdAt?: number;
         diagnosticEventsXdr?: string[];
     }
     export interface GetTransactionsRequest {
@@ -113,6 +111,7 @@ export declare namespace Api {
         createdAt: number;
         applicationOrder: number;
         feeBump: boolean;
+        txHash: string;
         envelopeXdr?: string;
         resultXdr?: string;
         resultMetaXdr?: string;
@@ -124,6 +123,7 @@ export declare namespace Api {
         createdAt: number;
         applicationOrder: number;
         feeBump: boolean;
+        txHash: string;
         envelopeXdr: xdr.TransactionEnvelope;
         resultXdr: xdr.TransactionResult;
         resultMetaXdr: xdr.TransactionMeta;
@@ -170,6 +170,7 @@ export declare namespace Api {
         type: EventType;
         ledger: number;
         ledgerClosedAt: string;
+        cursor: string;
         pagingToken: string;
         inSuccessfulContractCall: boolean;
         txHash: string;
@@ -255,7 +256,6 @@ export declare namespace Api {
     export interface SimulateTransactionSuccessResponse extends BaseSimulateTransactionResponse {
         transactionData: SorobanDataBuilder;
         minResourceFee: string;
-        cost: Cost;
         /** present only for invocation simulation */
         result?: SimulateHostFunctionResult;
         /** State Difference information */
@@ -304,7 +304,6 @@ export declare namespace Api {
          * invokeHostFunctionOperation is supported per transaction.
          * */
         results?: RawSimulateHostFunctionResult[];
-        cost?: Cost;
         /** Present if succeeded but has expired ledger entries */
         restorePreamble?: {
             minResourceFee: string;
@@ -315,8 +314,12 @@ export declare namespace Api {
     }
     export interface GetVersionInfoResponse {
         version: string;
+        commitHash: string;
+        buildTimestamp: string;
+        captiveCoreVersion: string;
+        protocolVersion: number;
         commit_hash: string;
-        build_time_stamp: string;
+        build_timestamp: string;
         captive_core_version: string;
         protocol_version: number;
     }

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

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

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

@@ -1,6 +1,6 @@
 /** @module rpc */
 export * from "./api";
-export { RpcServer as Server, 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-axios/rpc/index.js

@@ -5,6 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 var _exportNames = {
   Server: true,
+  BasicSleepStrategy: true,
+  LinearSleepStrategy: true,
   Durability: true,
   AxiosClient: true,
   parseRawSimulation: true,
@@ -16,12 +18,24 @@ Object.defineProperty(exports, "AxiosClient", {
     return _axios.default;
   }
 });
+Object.defineProperty(exports, "BasicSleepStrategy", {
+  enumerable: true,
+  get: function get() {
+    return _server.BasicSleepStrategy;
+  }
+});
 Object.defineProperty(exports, "Durability", {
   enumerable: true,
   get: function get() {
     return _server.Durability;
   }
 });
+Object.defineProperty(exports, "LinearSleepStrategy", {
+  enumerable: true,
+  get: function get() {
+    return _server.LinearSleepStrategy;
+  }
+});
 Object.defineProperty(exports, "Server", {
   enumerable: true,
   get: function get() {

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

@@ -8,7 +8,7 @@ import { Api } from './api';
  * @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 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 Soroban RPC server.

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

@@ -57,7 +57,8 @@ function parseTransactionInfo(raw) {
 }
 function parseRawTransactions(r) {
   return _objectSpread({
-    status: r.status
+    status: r.status,
+    txHash: r.txHash
   }, parseTransactionInfo(r));
 }
 function parseRawEvents(raw) {
@@ -100,8 +101,7 @@ function parseSuccessful(sim, partial) {
   var _sim$results$length, _sim$results, _sim$stateChanges$len, _sim$stateChanges, _sim$stateChanges2;
   var success = _objectSpread(_objectSpread(_objectSpread({}, partial), {}, {
     transactionData: new _stellarBase.SorobanDataBuilder(sim.transactionData),
-    minResourceFee: sim.minResourceFee,
-    cost: sim.cost
+    minResourceFee: sim.minResourceFee
   }, ((_sim$results$length = (_sim$results = sim.results) === null || _sim$results === void 0 ? void 0 : _sim$results.length) !== null && _sim$results$length !== void 0 ? _sim$results$length : 0 > 0) && {
     result: sim.results.map(function (row) {
       var _row$auth;

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

@@ -48,6 +48,10 @@ export declare namespace RpcServer {
         cursor?: string;
         limit?: number;
     }
+    interface PollingOptions {
+        attempts?: number;
+        sleepStrategy?: SleepStrategy;
+    }
     interface ResourceLeeway {
         cpuInstructions: number;
     }
@@ -57,6 +61,13 @@ export declare namespace RpcServer {
         headers?: Record<string, string>;
     }
 }
+export declare const BasicSleepStrategy: SleepStrategy;
+export declare const LinearSleepStrategy: SleepStrategy;
+/**
+ * A function that returns the number of *milliseconds* to sleep
+ * on a given `iter`ation.
+ */
+export type SleepStrategy = (iter: number) => number;
 /**
  * Handles the network connection to a Soroban RPC instance, exposing an
  * interface for requests to that instance.
@@ -220,6 +231,32 @@ export declare class RpcServer {
      */
     getLedgerEntries(...keys: xdr.LedgerKey[]): Promise<Api.GetLedgerEntriesResponse>;
     _getLedgerEntries(...keys: xdr.LedgerKey[]): Promise<Api.RawGetLedgerEntriesResponse>;
+    /**
+     * Poll for a particular transaction with certain parameters.
+     *
+     * After submitting a transaction, clients can use this to poll for
+     * transaction completion and return a definitive state of success or failure.
+     *
+     * @param {string} hash   the transaction you're polling for
+     * @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.
+     * @param {SleepStrategy} [opts.sleepStrategy] (optional) the amount of time
+     *    to wait for between each attempt. By default, sleep for 1 second between
+     *    each attempt.
+     *
+     * @return {Promise<Api.GetTransactionsResponse>} the response after a "found"
+     *    response (which may be success or failure) or the last response obtained
+     *    after polling the maximum number of specified attempts.
+     *
+     * @example
+     * const h = "c4515e3bdc0897f21cc5dbec8c82cf0a936d4741cb74a8e158eb51b9fb00411a";
+     * const txStatus = await server.pollTransaction(h, {
+     *    attempts: 100, // I'm a maniac
+     *    sleepStrategy: rpc.LinearSleepStrategy
+     * }); // this will take 5,050 seconds to complete
+     */
+    pollTransaction(hash: string, opts?: RpcServer.PollingOptions): Promise<Api.GetTransactionResponse>;
     /**
      * Fetch the details of a submitted transaction.
      *
@@ -227,10 +264,11 @@ export declare class RpcServer {
      * transaction has completed.
      *
      * @param {string} hash Hex-encoded hash of the transaction to check
-     * @returns {Promise<Api.GetTransactionResponse>} The status,
-     *    result, and other details about the transaction
+     * @returns {Promise<Api.GetTransactionResponse>} The status, result, and
+     *    other details about the transaction
      *
-     * @see {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction | getTransaction docs}
+     * @see
+     * {@link https://developers.stellar.org/docs/data/rpc/api-reference/methods/getTransaction | getTransaction docs}
      *
      * @example
      * const transactionHash = "c4515e3bdc0897f21cc5dbec8c82cf0a936d4741cb74a8e158eb51b9fb00411a";