stelar-sdk 12.3.0

package/lib/contract/types.d.ts

@@ -0,0 +1,112 @@
+import { Memo, MemoType, Operation, Transaction, xdr } from "@stellar/stellar-base";
+export type XDR_BASE64 = string;
+export type u32 = number;
+export type i32 = number;
+export type u64 = bigint;
+export type i64 = bigint;
+export type u128 = bigint;
+export type i128 = bigint;
+export type u256 = bigint;
+export type i256 = bigint;
+export type Option<T> = T | undefined;
+export type Typepoint = bigint;
+export type Duration = bigint;
+/**
+ * A "regular" transaction, as opposed to a FeeBumpTransaction.
+ */
+export type Tx = Transaction<Memo<MemoType>, Operation[]>;
+export type ClientOptions = {
+    /**
+     * The public key of the account that will send this transaction. You can
+     * override this for specific methods later, like
+     * {@link AssembledTransaction#signAndSend} and
+     * {@link AssembledTransaction#signAuthEntries}.
+     */
+    publicKey?: string;
+    /**
+     * A function to sign the transaction using the private key corresponding to
+     * the given `publicKey`. You do not need to provide this, for read-only
+     * calls, which only need to be simulated. If you do not need to sign and
+     * send, there is no need to provide this. If you do not provide it during
+     * initialization, you can provide it later when you call
+     * {@link AssembledTransaction#signAndSend}.
+     *
+     * Matches signature of `signTransaction` from Freighter.
+     */
+    signTransaction?: (tx: XDR_BASE64, opts?: {
+        network?: string;
+        networkPassphrase?: string;
+        accountToSign?: string;
+    }) => Promise<XDR_BASE64>;
+    /**
+     * A function to sign a specific auth entry for a transaction, using the
+     * private key corresponding to the provided `publicKey`. This is only needed
+     * for multi-auth transactions, in which one transaction is signed by
+     * multiple parties. If you do not provide it during initialization, you can
+     * provide it later when you call {@link AssembledTransaction#signAuthEntries}.
+     *
+     * Matches signature of `signAuthEntry` from Freighter.
+     */
+    signAuthEntry?: (entryXdr: XDR_BASE64, opts?: {
+        accountToSign?: string;
+    }) => Promise<XDR_BASE64>;
+    contractId: string;
+    networkPassphrase: string;
+    rpcUrl: string;
+    /**
+     * If true, will allow HTTP requests to the Soroban network. If false, will
+     * only allow HTTPS requests. @default false
+     */
+    allowHttp?: boolean;
+    /**
+     * This gets filled in automatically from the ContractSpec when you
+     * instantiate a {@link Client}.
+     *
+     * Background: If the contract you're calling uses the `#[contracterror]`
+     * macro to create an `Error` enum, then those errors get included in the
+     * on-chain XDR that also describes your contract's methods. Each error will
+     * have a specific number.
+     *
+     * A Client makes method calls with an {@link AssembledTransaction}.
+     * When one of these method calls encounters an error, `AssembledTransaction`
+     * will first attempt to parse the error as an "official" `contracterror`
+     * error, by using this passed-in `errorTypes` object. See
+     * {@link AssembledTransaction#parseError}. If `errorTypes` is blank or no
+     * matching error is found, then it will throw the raw error.
+     * @default {}
+     */
+    errorTypes?: Record<number, {
+        message: string;
+    }>;
+};
+export type MethodOptions = {
+    /**
+     * The fee to pay for the transaction. Default: {@link BASE_FEE}
+     */
+    fee?: string;
+    /**
+     * The maximum amount of time to wait for the transaction to complete.
+     * Default: {@link DEFAULT_TIMEOUT}
+     */
+    timeoutInSeconds?: number;
+    /**
+     * Whether to automatically simulate the transaction when constructing the
+     * AssembledTransaction. Default: true
+     */
+    simulate?: boolean;
+    /**
+     * If true, will automatically attempt to restore the transaction if there
+     * are archived entries that need renewal. @default false
+     */
+    restore?: boolean;
+};
+export type AssembledTransactionOptions<T = string> = MethodOptions & ClientOptions & {
+    method: string;
+    args?: any[];
+    parseResultXdr: (xdr: xdr.ScVal) => T;
+};
+/**
+ * The default timeout for waiting for a transaction to be included in a block.
+ */
+export declare const DEFAULT_TIMEOUT: number;
+export declare const NULL_ACCOUNT = "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF";

package/lib/contract/types.js

@@ -0,0 +1,8 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NULL_ACCOUNT = exports.DEFAULT_TIMEOUT = void 0;
+var DEFAULT_TIMEOUT = exports.DEFAULT_TIMEOUT = 5 * 60;
+var NULL_ACCOUNT = exports.NULL_ACCOUNT = "GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF";

package/lib/contract/utils.d.ts

@@ -0,0 +1,39 @@
+import { xdr, Account } from "@stellar/stellar-base";
+import { Server } from "../rpc/server";
+import { AssembledTransactionOptions } from "./types";
+/**
+ * Keep calling a `fn` for `timeoutInSeconds` seconds, if `keepWaitingIf` is
+ * true. Returns an array of all attempts to call the function.
+ */
+export declare function withExponentialBackoff<T>(
+/** Function to call repeatedly */
+fn: (previousFailure?: T) => Promise<T>, 
+/** Condition to check when deciding whether or not to call `fn` again */
+keepWaitingIf: (result: T) => boolean, 
+/** How long to wait between the first and second call */
+timeoutInSeconds: number, 
+/** What to multiply `timeoutInSeconds` by, each subsequent attempt */
+exponentialFactor?: number, 
+/** Whether to log extra info */
+verbose?: boolean): Promise<T[]>;
+/**
+ * If contracts are implemented using the `#[contracterror]` macro, then the
+ * errors get included in the on-chain XDR that also describes your contract's
+ * methods. Each error will have a specific number. This Regular Expression
+ * matches these "expected error types" that a contract may throw, and helps
+ * {@link AssembledTransaction} parse these errors.
+ */
+export declare const contractErrorPattern: RegExp;
+/**
+ * A TypeScript type guard that checks if an object has a `toString` method.
+ */
+export declare function implementsToString(
+/** some object that may or may not have a `toString` method */
+obj: unknown): obj is {
+    toString(): string;
+};
+/**
+ * Reads a binary stream of ScSpecEntries into an array for processing by ContractSpec
+ */
+export declare function processSpecEntryStream(buffer: Buffer): xdr.ScSpecEntry[];
+export declare function getAccount<T>(options: AssembledTransactionOptions<T>, server: Server): Promise<Account>;

package/lib/contract/utils.js

@@ -0,0 +1,123 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.contractErrorPattern = void 0;
+exports.getAccount = getAccount;
+exports.implementsToString = implementsToString;
+exports.processSpecEntryStream = processSpecEntryStream;
+exports.withExponentialBackoff = withExponentialBackoff;
+var _stellarBase = require("@stellar/stellar-base");
+var _types = require("./types");
+function _regeneratorRuntime() { "use strict"; _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, 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); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+function withExponentialBackoff(_x, _x2, _x3) {
+  return _withExponentialBackoff.apply(this, arguments);
+}
+function _withExponentialBackoff() {
+  _withExponentialBackoff = _asyncToGenerator(_regeneratorRuntime().mark(function _callee(fn, keepWaitingIf, timeoutInSeconds) {
+    var exponentialFactor,
+      verbose,
+      attempts,
+      count,
+      waitUntil,
+      waitTime,
+      totalWaitTime,
+      _args = arguments;
+    return _regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          exponentialFactor = _args.length > 3 && _args[3] !== undefined ? _args[3] : 1.5;
+          verbose = _args.length > 4 && _args[4] !== undefined ? _args[4] : false;
+          attempts = [];
+          count = 0;
+          _context.t0 = attempts;
+          _context.next = 7;
+          return fn();
+        case 7:
+          _context.t1 = _context.sent;
+          _context.t0.push.call(_context.t0, _context.t1);
+          if (keepWaitingIf(attempts[attempts.length - 1])) {
+            _context.next = 11;
+            break;
+          }
+          return _context.abrupt("return", attempts);
+        case 11:
+          waitUntil = new Date(Date.now() + timeoutInSeconds * 1000).valueOf();
+          waitTime = 1000;
+          totalWaitTime = waitTime;
+        case 14:
+          if (!(Date.now() < waitUntil && keepWaitingIf(attempts[attempts.length - 1]))) {
+            _context.next = 30;
+            break;
+          }
+          count += 1;
+          if (verbose) {
+            console.info("Waiting ".concat(waitTime, "ms before trying again (bringing the total wait time to ").concat(totalWaitTime, "ms so far, of total ").concat(timeoutInSeconds * 1000, "ms)"));
+          }
+          _context.next = 19;
+          return new Promise(function (res) {
+            return setTimeout(res, waitTime);
+          });
+        case 19:
+          waitTime *= exponentialFactor;
+          if (new Date(Date.now() + waitTime).valueOf() > waitUntil) {
+            waitTime = waitUntil - Date.now();
+            if (verbose) {
+              console.info("was gonna wait too long; new waitTime: ".concat(waitTime, "ms"));
+            }
+          }
+          totalWaitTime = waitTime + totalWaitTime;
+          _context.t2 = attempts;
+          _context.next = 25;
+          return fn(attempts[attempts.length - 1]);
+        case 25:
+          _context.t3 = _context.sent;
+          _context.t2.push.call(_context.t2, _context.t3);
+          if (verbose && keepWaitingIf(attempts[attempts.length - 1])) {
+            console.info("".concat(count, ". Called ").concat(fn, "; ").concat(attempts.length, " prev attempts. Most recent: ").concat(JSON.stringify(attempts[attempts.length - 1], null, 2)));
+          }
+          _context.next = 14;
+          break;
+        case 30:
+          return _context.abrupt("return", attempts);
+        case 31:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return _withExponentialBackoff.apply(this, arguments);
+}
+var contractErrorPattern = exports.contractErrorPattern = /Error\(Contract, #(\d+)\)/;
+function implementsToString(obj) {
+  return _typeof(obj) === "object" && obj !== null && "toString" in obj;
+}
+function processSpecEntryStream(buffer) {
+  var reader = new _stellarBase.cereal.XdrReader(buffer);
+  var res = [];
+  while (!reader.eof) {
+    res.push(_stellarBase.xdr.ScSpecEntry.read(reader));
+  }
+  return res;
+}
+function getAccount(_x4, _x5) {
+  return _getAccount.apply(this, arguments);
+}
+function _getAccount() {
+  _getAccount = _asyncToGenerator(_regeneratorRuntime().mark(function _callee2(options, server) {
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          return _context2.abrupt("return", options.publicKey ? server.getAccount(options.publicKey) : new _stellarBase.Account(_types.NULL_ACCOUNT, "0"));
+        case 1:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return _getAccount.apply(this, arguments);
+}

package/lib/errors.d.ts

@@ -0,0 +1,59 @@
+import { HorizonApi } from "./horizon/horizon_api";
+export declare class NetworkError extends Error {
+    response: {
+        data?: HorizonApi.ErrorResponseData;
+        status?: number;
+        statusText?: string;
+        url?: string;
+    };
+    __proto__: NetworkError;
+    constructor(message: string, response: any);
+    getResponse(): {
+        data?: HorizonApi.ErrorResponseData;
+        status?: number;
+        statusText?: string;
+        url?: string;
+    };
+}
+export declare class NotFoundError extends NetworkError {
+    constructor(message: string, response: any);
+}
+export declare class BadRequestError extends NetworkError {
+    constructor(message: string, response: any);
+}
+export declare class BadResponseError extends NetworkError {
+    constructor(message: string, response: any);
+}
+/**
+ * AccountRequiresMemoError is raised when a transaction is trying to submit an
+ * operation to an account which requires a memo. See
+ * [SEP0029](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0029.md)
+ * for more information.
+ *
+ * This error contains two attributes to help you identify the account requiring
+ * the memo and the operation where the account is the destination
+ *
+ * ```
+ * console.log('The following account requires a memo ', err.accountId)
+ * console.log('The account is used in operation: ', err.operationIndex)
+ * ```
+ *
+ */
+export declare class AccountRequiresMemoError extends Error {
+    __proto__: AccountRequiresMemoError;
+    /**
+     * accountId account which requires a memo.
+     */
+    accountId: string;
+    /**
+     * operationIndex operation where accountId is the destination.
+     */
+    operationIndex: number;
+    /**
+     * Create an AccountRequiresMemoError
+     * @param {message} message - error message
+     * @param {string} accountId - The account which requires a memo.
+     * @param {number} operationIndex - The index of the operation where `accountId` is the destination.
+     */
+    constructor(message: string, accountId: string, operationIndex: number);
+}

package/lib/errors.js

@@ -0,0 +1,99 @@
+"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.NotFoundError = exports.NetworkError = exports.BadResponseError = exports.BadRequestError = exports.AccountRequiresMemoError = void 0;
+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 _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 _wrapNativeSuper(t) { var r = "function" == typeof Map ? new Map() : void 0; return _wrapNativeSuper = function _wrapNativeSuper(t) { if (null === t || !_isNativeFunction(t)) return t; if ("function" != typeof t) throw new TypeError("Super expression must either be null or a function"); if (void 0 !== r) { if (r.has(t)) return r.get(t); r.set(t, Wrapper); } function Wrapper() { return _construct(t, arguments, _getPrototypeOf(this).constructor); } return Wrapper.prototype = Object.create(t.prototype, { constructor: { value: Wrapper, enumerable: !1, writable: !0, configurable: !0 } }), _setPrototypeOf(Wrapper, t); }, _wrapNativeSuper(t); }
+function _construct(t, e, r) { if (_isNativeReflectConstruct()) return Reflect.construct.apply(null, arguments); var o = [null]; o.push.apply(o, e); var p = new (t.bind.apply(t, o))(); return r && _setPrototypeOf(p, r.prototype), p; }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+function _isNativeFunction(t) { try { return -1 !== Function.toString.call(t).indexOf("[native code]"); } catch (n) { return "function" == typeof t; } }
+function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
+var NetworkError = exports.NetworkError = function (_Error) {
+  function NetworkError(message, response) {
+    var _this;
+    _classCallCheck(this, NetworkError);
+    var trueProto = (this instanceof NetworkError ? this.constructor : void 0).prototype;
+    _this = _callSuper(this, NetworkError, [message]);
+    _this.__proto__ = trueProto;
+    _this.constructor = NetworkError;
+    _this.response = response;
+    return _this;
+  }
+  _inherits(NetworkError, _Error);
+  return _createClass(NetworkError, [{
+    key: "getResponse",
+    value: function getResponse() {
+      return this.response;
+    }
+  }]);
+}(_wrapNativeSuper(Error));
+var NotFoundError = exports.NotFoundError = function (_NetworkError) {
+  function NotFoundError(message, response) {
+    var _this2;
+    _classCallCheck(this, NotFoundError);
+    var trueProto = (this instanceof NotFoundError ? this.constructor : void 0).prototype;
+    _this2 = _callSuper(this, NotFoundError, [message, response]);
+    _this2.__proto__ = trueProto;
+    _this2.constructor = NotFoundError;
+    _this2.name = "NotFoundError";
+    return _this2;
+  }
+  _inherits(NotFoundError, _NetworkError);
+  return _createClass(NotFoundError);
+}(NetworkError);
+var BadRequestError = exports.BadRequestError = function (_NetworkError2) {
+  function BadRequestError(message, response) {
+    var _this3;
+    _classCallCheck(this, BadRequestError);
+    var trueProto = (this instanceof BadRequestError ? this.constructor : void 0).prototype;
+    _this3 = _callSuper(this, BadRequestError, [message, response]);
+    _this3.__proto__ = trueProto;
+    _this3.constructor = BadRequestError;
+    _this3.name = "BadRequestError";
+    return _this3;
+  }
+  _inherits(BadRequestError, _NetworkError2);
+  return _createClass(BadRequestError);
+}(NetworkError);
+var BadResponseError = exports.BadResponseError = function (_NetworkError3) {
+  function BadResponseError(message, response) {
+    var _this4;
+    _classCallCheck(this, BadResponseError);
+    var trueProto = (this instanceof BadResponseError ? this.constructor : void 0).prototype;
+    _this4 = _callSuper(this, BadResponseError, [message, response]);
+    _this4.__proto__ = trueProto;
+    _this4.constructor = BadResponseError;
+    _this4.name = "BadResponseError";
+    return _this4;
+  }
+  _inherits(BadResponseError, _NetworkError3);
+  return _createClass(BadResponseError);
+}(NetworkError);
+var AccountRequiresMemoError = exports.AccountRequiresMemoError = function (_Error2) {
+  function AccountRequiresMemoError(message, accountId, operationIndex) {
+    var _this5;
+    _classCallCheck(this, AccountRequiresMemoError);
+    var trueProto = (this instanceof AccountRequiresMemoError ? this.constructor : void 0).prototype;
+    _this5 = _callSuper(this, AccountRequiresMemoError, [message]);
+    _this5.__proto__ = trueProto;
+    _this5.constructor = AccountRequiresMemoError;
+    _this5.name = "AccountRequiresMemoError";
+    _this5.accountId = accountId;
+    _this5.operationIndex = operationIndex;
+    return _this5;
+  }
+  _inherits(AccountRequiresMemoError, _Error2);
+  return _createClass(AccountRequiresMemoError);
+}(_wrapNativeSuper(Error));

package/lib/federation/api.d.ts

@@ -0,0 +1,11 @@
+export declare namespace Api {
+    interface Record {
+        account_id: string;
+        memo_type?: string;
+        memo?: string;
+    }
+    interface Options {
+        allowHttp?: boolean;
+        timeout?: number;
+    }
+}

package/lib/federation/api.js

@@ -0,0 +1,7 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Api = void 0;
+var Api;

package/lib/federation/index.d.ts

@@ -0,0 +1,2 @@
+export { FederationServer as Server, FEDERATION_RESPONSE_MAX_SIZE } from './server';
+export * as Api from './api';

package/lib/federation/index.js

@@ -0,0 +1,24 @@
+"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.Api = void 0;
+Object.defineProperty(exports, "FEDERATION_RESPONSE_MAX_SIZE", {
+  enumerable: true,
+  get: function get() {
+    return _server.FEDERATION_RESPONSE_MAX_SIZE;
+  }
+});
+Object.defineProperty(exports, "Server", {
+  enumerable: true,
+  get: function get() {
+    return _server.FederationServer;
+  }
+});
+var _server = require("./server");
+var _Api = _interopRequireWildcard(require("./api"));
+exports.Api = _Api;
+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; }

package/lib/federation/server.d.ts

@@ -0,0 +1,118 @@
+import { Api } from "./api";
+export declare const FEDERATION_RESPONSE_MAX_SIZE: number;
+/**
+ * FederationServer handles a network connection to a
+ * [federation server](https://developers.stellar.org/docs/glossary/federation/)
+ * instance and exposes an interface for requests to that instance.
+ * @class
+ * @param {string} serverURL The federation server URL (ex. `https://acme.com/federation`).
+ * @param {string} domain Domain this server represents
+ * @param {object} [opts] options object
+ * @param {boolean} [opts.allowHttp] - Allow connecting to 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 {number} [opts.timeout] - Allow a timeout, default: 0. Allows user to avoid nasty lag due to TOML resolve issue. You can also use {@link Config} class to set this globally.
+ * @returns {void}
+ */
+export declare class FederationServer {
+    /**
+     * The federation server URL (ex. `https://acme.com/federation`).
+     *
+     * @memberof FederationServer
+     */
+    private readonly serverURL;
+    /**
+     * Domain this server represents.
+     *
+     * @type {string}
+     * @memberof FederationServer
+     */
+    private readonly domain;
+    /**
+     * Allow a timeout, default: 0. Allows user to avoid nasty lag due to TOML resolve issue.
+     *
+     * @type {number}
+     * @memberof FederationServer
+     */
+    private readonly timeout;
+    /**
+     * A helper method for handling user inputs that contain `destination` value.
+     * It accepts two types of values:
+     *
+     * * For Stellar address (ex. `bob*stellar.org`) it splits Stellar address and then tries to find information about
+     * federation server in `stellar.toml` file for a given domain. It returns a `Promise` which resolves if federation
+     * server exists and user has been found and rejects in all other cases.
+     * * For Account ID (ex. `GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS`) it returns a `Promise` which
+     * resolves if Account ID is valid and rejects in all other cases. Please note that this method does not check
+     * if the account actually exists in a ledger.
+     *
+     * Example:
+     * ```js
+     * StellarSdk.FederationServer.resolve('bob*stellar.org')
+     *  .then(federationRecord => {
+     *    // {
+     *    //   account_id: 'GB5XVAABEQMY63WTHDQ5RXADGYF345VWMNPTN2GFUDZT57D57ZQTJ7PS',
+     *    //   memo_type: 'id',
+     *    //   memo: 100
+     *    // }
+     *  });
+     * ```
+     *
+     * @see <a href="https://developers.stellar.org/docs/glossary/federation/" target="_blank">Federation doc</a>
+     * @see <a href="https://developers.stellar.org/docs/issuing-assets/publishing-asset-info/" target="_blank">Stellar.toml doc</a>
+     * @param {string} value Stellar Address (ex. `bob*stellar.org`)
+     * @param {object} [opts] Options object
+     * @param {boolean} [opts.allowHttp] - Allow connecting to http servers, default: `false`. This must be set to false in production deployments!
+     * @param {number} [opts.timeout] - Allow a timeout, default: 0. Allows user to avoid nasty lag due to TOML resolve issue.
+     * @returns {Promise} `Promise` that resolves to a JSON object with this shape:
+     * * `account_id` - Account ID of the destination,
+     * * `memo_type` (optional) - Memo type that needs to be attached to a transaction,
+     * * `memo` (optional) - Memo value that needs to be attached to a transaction.
+     */
+    static resolve(value: string, opts?: Api.Options): Promise<Api.Record>;
+    /**
+     * Creates a `FederationServer` instance based on information from
+     * [stellar.toml](https://developers.stellar.org/docs/issuing-assets/publishing-asset-info/)
+     * file for a given domain.
+     *
+     * If `stellar.toml` file does not exist for a given domain or it does not
+     * contain information about a federation server Promise will reject.
+     * ```js
+     * StellarSdk.FederationServer.createForDomain('acme.com')
+     *   .then(federationServer => {
+     *     // federationServer.resolveAddress('bob').then(...)
+     *   })
+     *   .catch(error => {
+     *     // stellar.toml does not exist or it does not contain information about federation server.
+     *   });
+     * ```
+     * @see <a href="https://developers.stellar.org/docs/issuing-assets/publishing-asset-info/" target="_blank">Stellar.toml doc</a>
+     * @param {string} domain Domain to get federation server for
+     * @param {object} [opts] Options object
+     * @param {boolean} [opts.allowHttp] - Allow connecting to http servers, default: `false`. This must be set to false in production deployments!
+     * @param {number} [opts.timeout] - Allow a timeout, default: 0. Allows user to avoid nasty lag due to TOML resolve issue.
+     * @returns {Promise} `Promise` that resolves to a FederationServer object
+     */
+    static createForDomain(domain: string, opts?: Api.Options): Promise<FederationServer>;
+    constructor(serverURL: string, domain: string, opts?: Api.Options);
+    /**
+     * Get the federation record if the user was found for a given Stellar address
+     * @see <a href="https://developers.stellar.org/docs/glossary/federation/" target="_blank">Federation doc</a>
+     * @param {string} address Stellar address (ex. `bob*stellar.org`). If `FederationServer` was instantiated with `domain` param only username (ex. `bob`) can be passed.
+     * @returns {Promise} Promise that resolves to the federation record
+     */
+    resolveAddress(address: string): Promise<Api.Record>;
+    /**
+     * Given an account ID, get their federation record if the user was found
+     * @see <a href="https://developers.stellar.org/docs/glossary/federation/" target="_blank">Federation doc</a>
+     * @param {string} accountId Account ID (ex. `GBYNR2QJXLBCBTRN44MRORCMI4YO7FZPFBCNOKTOBCAAFC7KC3LNPRYS`)
+     * @returns {Promise} A promise that resolves to the federation record
+     */
+    resolveAccountId(accountId: string): Promise<Api.Record>;
+    /**
+     * Given a transactionId, get the federation record if the sender of the transaction was found
+     * @see <a href="https://developers.stellar.org/docs/glossary/federation/" target="_blank">Federation doc</a>
+     * @param {string} transactionId Transaction ID (ex. `3389e9f0f1a65f19736cacf544c2e825313e8447f569233bb8db39aa607c8889`)
+     * @returns {Promise} A promise that resolves to the federation record
+     */
+    resolveTransactionId(transactionId: string): Promise<Api.Record>;
+    private _sendRequest;
+}