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

package/lib/minimal/horizon/account_call_builder.js

@@ -0,0 +1,62 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AccountCallBuilder = void 0;
+var _call_builder = require("./call_builder");
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), 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 _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
+function _possibleConstructorReturn(t, e) { if (e && ("object" == _typeof(e) || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
+function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
+function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
+function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+var AccountCallBuilder = exports.AccountCallBuilder = function (_CallBuilder) {
+  function AccountCallBuilder(serverUrl) {
+    var _this;
+    _classCallCheck(this, AccountCallBuilder);
+    _this = _callSuper(this, AccountCallBuilder, [serverUrl]);
+    _this.url.segment("accounts");
+    return _this;
+  }
+  _inherits(AccountCallBuilder, _CallBuilder);
+  return _createClass(AccountCallBuilder, [{
+    key: "accountId",
+    value: function accountId(id) {
+      var builder = new _call_builder.CallBuilder(this.url.clone());
+      builder.filter.push([id]);
+      return builder;
+    }
+  }, {
+    key: "forSigner",
+    value: function forSigner(id) {
+      this.url.setQuery("signer", id);
+      return this;
+    }
+  }, {
+    key: "forAsset",
+    value: function forAsset(asset) {
+      this.url.setQuery("asset", "".concat(asset));
+      return this;
+    }
+  }, {
+    key: "sponsor",
+    value: function sponsor(id) {
+      this.url.setQuery("sponsor", id);
+      return this;
+    }
+  }, {
+    key: "forLiquidityPool",
+    value: function forLiquidityPool(id) {
+      this.url.setQuery("liquidity_pool", id);
+      return this;
+    }
+  }]);
+}(_call_builder.CallBuilder);

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

@@ -0,0 +1,61 @@
+import { HorizonApi } from "./horizon_api";
+import { ServerApi } from "./server_api";
+/**
+ * Do not create this object directly, use {@link module:Horizon.Server#loadAccount | Horizon.Server#loadAccount}.
+ *
+ * Returns information and links relating to a single account.
+ * The balances section in the returned JSON will also list all the trust lines this account has set up.
+ * It also contains {@link BaseAccount} object and exposes it's methods so can be used in {@link TransactionBuilder}.
+ *
+ * @memberof module:Horizon
+ * @private
+ *
+ * @see {@link https://developers.stellar.org/docs/data/horizon/api-reference/resources/accounts/object|Account Details}
+ * @param {string} response Response from horizon account endpoint.
+ * @returns {AccountResponse} AccountResponse instance
+ */
+export declare class AccountResponse {
+    readonly id: string;
+    readonly paging_token: string;
+    readonly account_id: string;
+    sequence: string;
+    readonly sequence_ledger?: number;
+    readonly sequence_time?: string;
+    readonly subentry_count: number;
+    readonly home_domain?: string;
+    readonly inflation_destination?: string;
+    readonly last_modified_ledger: number;
+    readonly last_modified_time: string;
+    readonly thresholds: HorizonApi.AccountThresholds;
+    readonly flags: HorizonApi.Flags;
+    readonly balances: HorizonApi.BalanceLine[];
+    readonly signers: ServerApi.AccountRecordSigners[];
+    readonly data: (options: {
+        value: string;
+    }) => Promise<{
+        value: string;
+    }>;
+    readonly data_attr: Record<string, string>;
+    readonly effects: ServerApi.CallCollectionFunction<ServerApi.EffectRecord>;
+    readonly offers: ServerApi.CallCollectionFunction<ServerApi.OfferRecord>;
+    readonly operations: ServerApi.CallCollectionFunction<ServerApi.OperationRecord>;
+    readonly payments: ServerApi.CallCollectionFunction<ServerApi.PaymentOperationRecord>;
+    readonly trades: ServerApi.CallCollectionFunction<ServerApi.TradeRecord>;
+    private readonly _baseAccount;
+    constructor(response: ServerApi.AccountRecord);
+    /**
+     * Get Stellar account public key ex. `GB3KJPLFUYN5VL6R3GU3EGCGVCKFDSD7BEDX42HWG5BWFKB3KQGJJRMA`
+     * @returns {string} accountId
+     */
+    accountId(): string;
+    /**
+     * Get the current sequence number
+     * @returns {string} sequenceNumber
+     */
+    sequenceNumber(): string;
+    /**
+     * Increments sequence number in this object by one.
+     * @returns {void}
+     */
+    incrementSequenceNumber(): void;
+}

package/lib/minimal/horizon/account_response.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AccountResponse = void 0;
+var _stellarBase = require("@stellar/stellar-base");
+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); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var AccountResponse = exports.AccountResponse = function () {
+  function AccountResponse(response) {
+    var _this = this;
+    _classCallCheck(this, AccountResponse);
+    this._baseAccount = new _stellarBase.Account(response.account_id, response.sequence);
+    Object.entries(response).forEach(function (_ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+        key = _ref2[0],
+        value = _ref2[1];
+      _this[key] = value;
+    });
+  }
+  return _createClass(AccountResponse, [{
+    key: "accountId",
+    value: function accountId() {
+      return this._baseAccount.accountId();
+    }
+  }, {
+    key: "sequenceNumber",
+    value: function sequenceNumber() {
+      return this._baseAccount.sequenceNumber();
+    }
+  }, {
+    key: "incrementSequenceNumber",
+    value: function incrementSequenceNumber() {
+      this._baseAccount.incrementSequenceNumber();
+      this.sequence = this._baseAccount.sequenceNumber();
+    }
+  }]);
+}();

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

@@ -0,0 +1,27 @@
+import { CallBuilder } from "./call_builder";
+import { ServerApi } from "./server_api";
+/**
+ * Creates a new {@link AssetsCallBuilder} pointed to server defined by serverUrl.
+ *
+ * Do not create this object directly, use {@link Horizon.Server#assets}.
+ *
+ * @class
+ * @augments CallBuilder
+ * @private
+ * @param {string} serverUrl Horizon server URL.
+ */
+export declare class AssetsCallBuilder extends CallBuilder<ServerApi.CollectionPage<ServerApi.AssetRecord>> {
+    constructor(serverUrl: URI);
+    /**
+     * This endpoint filters all assets by the asset code.
+     * @param {string} value For example: `USD`
+     * @returns {AssetsCallBuilder} current AssetCallBuilder instance
+     */
+    forCode(value: string): AssetsCallBuilder;
+    /**
+     * This endpoint filters all assets by the asset issuer.
+     * @param {string} value For example: `GDGQVOKHW4VEJRU2TETD6DBRKEO5ERCNF353LW5WBFW3JJWQ2BRQ6KDD`
+     * @returns {AssetsCallBuilder} current AssetCallBuilder instance
+     */
+    forIssuer(value: string): AssetsCallBuilder;
+}

package/lib/minimal/horizon/assets_call_builder.js

@@ -0,0 +1,43 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AssetsCallBuilder = void 0;
+var _call_builder = require("./call_builder");
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), 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 _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
+function _possibleConstructorReturn(t, e) { if (e && ("object" == _typeof(e) || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
+function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
+function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
+function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+var AssetsCallBuilder = exports.AssetsCallBuilder = function (_CallBuilder) {
+  function AssetsCallBuilder(serverUrl) {
+    var _this;
+    _classCallCheck(this, AssetsCallBuilder);
+    _this = _callSuper(this, AssetsCallBuilder, [serverUrl]);
+    _this.url.segment("assets");
+    return _this;
+  }
+  _inherits(AssetsCallBuilder, _CallBuilder);
+  return _createClass(AssetsCallBuilder, [{
+    key: "forCode",
+    value: function forCode(value) {
+      this.url.setQuery("asset_code", value);
+      return this;
+    }
+  }, {
+    key: "forIssuer",
+    value: function forIssuer(value) {
+      this.url.setQuery("asset_issuer", value);
+      return this;
+    }
+  }]);
+}(_call_builder.CallBuilder);

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

@@ -0,0 +1,128 @@
+import URI from "urijs";
+import { HorizonApi } from "./horizon_api";
+import { ServerApi } from "./server_api";
+export interface EventSourceOptions<T> {
+    onmessage?: (value: T) => void;
+    onerror?: (event: MessageEvent) => void;
+    reconnectTimeout?: number;
+}
+/**
+ * Creates a new {@link CallBuilder} pointed to server defined by serverUrl.
+ *
+ * This is an **abstract** class. Do not create this object directly, use {@link Server} class.
+ * @param {string} serverUrl URL of Horizon server
+ * @class CallBuilder
+ */
+export declare class CallBuilder<T extends HorizonApi.FeeStatsResponse | HorizonApi.BaseResponse | ServerApi.CollectionPage<HorizonApi.BaseResponse>> {
+    protected url: URI;
+    filter: string[][];
+    protected originalSegments: string[];
+    protected neighborRoot: string;
+    constructor(serverUrl: URI, neighborRoot?: string);
+    /**
+     * Triggers a HTTP request using this builder's current configuration.
+     * @returns {Promise} a Promise that resolves to the server's response.
+     */
+    call(): Promise<T>;
+    /**
+     * Creates an EventSource that listens for incoming messages from the server. To stop listening for new
+     * events call the function returned by this method.
+     * @see [Horizon Response Format](https://developers.stellar.org/api/introduction/response-format/)
+     * @see [MDN EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource)
+     * @param {object} [options] EventSource options.
+     * @param {Function} [options.onmessage] Callback function to handle incoming messages.
+     * @param {Function} [options.onerror] Callback function to handle errors.
+     * @param {number} [options.reconnectTimeout] Custom stream connection timeout in ms, default is 15 seconds.
+     * @returns {Function} Close function. Run to close the connection and stop listening for new events.
+     */
+    stream(options?: EventSourceOptions<T>): () => void;
+    /**
+     * Sets `cursor` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+     * @see [Paging](https://developers.stellar.org/api/introduction/pagination/)
+     * @param {string} cursor A cursor is a value that points to a specific location in a collection of resources.
+     * @returns {object} current CallBuilder instance
+     */
+    cursor(cursor: string): this;
+    /**
+     * Sets `limit` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+     * @see [Paging](https://developers.stellar.org/api/introduction/pagination/)
+     * @param {number} recordsNumber Number of records the server should return.
+     * @returns {object} current CallBuilder instance
+     */
+    limit(recordsNumber: number): this;
+    /**
+     * Sets `order` parameter for the current call. Returns the CallBuilder object on which this method has been called.
+     * @param {"asc"|"desc"} direction Sort direction
+     * @returns {object} current CallBuilder instance
+     */
+    order(direction: "asc" | "desc"): this;
+    /**
+     * Sets `join` parameter for the current call. The `join` parameter
+     * includes the requested resource in the response. Currently, the
+     * only valid value for the parameter is `transactions` and is only
+     * supported on the operations and payments endpoints. The response
+     * will include a `transaction` field for each operation in the
+     * response.
+     *
+     * @param "include" join Records to be included in the response.
+     * @returns {object} current CallBuilder instance.
+     */
+    join(include: "transactions"): this;
+    /**
+     * A helper method to craft queries to "neighbor" endpoints.
+     *
+     *  For example, we have an `/effects` suffix endpoint on many different
+     *  "root" endpoints, such as `/transactions/:id` and `/accounts/:id`. So,
+     *  it's helpful to be able to conveniently create queries to the
+     *  `/accounts/:id/effects` endpoint:
+     *
+     *    this.forEndpoint("accounts", accountId)`.
+     *
+     * @param  {string} endpoint neighbor endpoint in question, like /operations
+     * @param  {string} param    filter parameter, like an operation ID
+     *
+     * @returns {CallBuilder} this CallBuilder instance
+     */
+    protected forEndpoint(endpoint: string, param: string): this;
+    /**
+     * @private
+     * @returns {void}
+     */
+    private checkFilter;
+    /**
+     * Convert a link object to a function that fetches that link.
+     * @private
+     * @param {object} link A link object
+     * @param {boolean} link.href the URI of the link
+     * @param {boolean} [link.templated] Whether the link is templated
+     * @returns {Function} A function that requests the link
+     */
+    private _requestFnForLink;
+    /**
+     * Given the json response, find and convert each link into a function that
+     * calls that link.
+     * @private
+     * @param {object} json JSON response
+     * @returns {object} JSON response with string links replaced with functions
+     */
+    private _parseRecord;
+    private _sendNormalRequest;
+    /**
+     * @private
+     * @param {object} json Response object
+     * @returns {object} Extended response
+     */
+    private _parseResponse;
+    /**
+     * @private
+     * @param {object} json Response object
+     * @returns {object} Extended response object
+     */
+    private _toCollectionPage;
+    /**
+     * @private
+     * @param {object} error Network error object
+     * @returns {Promise<Error>} Promise that rejects with a human-readable error
+     */
+    private _handleNetworkError;
+}