@stellar/stellar-sdk 14.3.0 → 14.3.2

package/lib/rpc/server.d.ts

@@ -1,6 +1,7 @@
 import URI from "urijs";
 import { Account, Address, Asset, Contract, FeeBumpTransaction, Transaction, xdr } from "@stellar/stellar-base";
 import { Api } from "./api";
+import { HttpClient } from "../http-client";
 /**
  * Default transaction submission timeout for RPC requests, in milliseconds
  * @constant {number}
@@ -42,9 +43,24 @@ export declare namespace RpcServer {
         attempts?: number;
         sleepStrategy?: SleepStrategy;
     }
+    /**
+     * Describes additional resource leeways for transaction simulation.
+     * @property {number} cpuInstructions Simulate the transaction with more CPU instructions available.
+     * @memberof module:rpc.Server
+     */
     interface ResourceLeeway {
         cpuInstructions: number;
     }
+    /**
+     * Options for configuring connections to RPC servers.
+     *
+     * @property {boolean} allowHttp - Allow connecting to http servers, default: `false`. This must be set to false in production deployments!
+     * @property {number} timeout - Allow a timeout, default: 0. Allows user to avoid nasty lag.
+     * @property {Record<string, string>} headers - Additional headers that should be added to any requests to the RPC server.
+     *
+     * @alias module:rpc.Server.Options
+     * @memberof module:rpc.Server
+     */
     interface Options {
         allowHttp?: boolean;
         timeout?: number;
@@ -76,6 +92,21 @@ export type SleepStrategy = (iter: number) => number;
  */
 export declare class RpcServer {
     readonly serverURL: URI;
+    /**
+     * HTTP client instance for making requests to Horizon.
+     * Exposes interceptors, defaults, and other configuration options.
+     *
+     * @example
+     * // Add authentication header
+     * server.httpClient.defaults.headers['Authorization'] = 'Bearer token';
+     *
+     * // Add request interceptor
+     * server.httpClient.interceptors.request.use((config) => {
+     *   console.log('Request:', config.url);
+     *   return config;
+     * });
+     */
+    readonly httpClient: HttpClient;
     constructor(serverURL: string, opts?: RpcServer.Options);
     /**
      * Fetch a minimal set of current info about a Stellar account.

package/lib/rpc/server.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.SUBMIT_TRANSACTION_TIMEOUT = exports.RpcServer = exports.LinearSleepStrategy = exports.Durability = exports.BasicSleepStrategy = void 0;
 var _urijs = _interopRequireDefault(require("urijs"));
 var _stellarBase = require("@stellar/stellar-base");
-var _axios = _interopRequireDefault(require("./axios"));
+var _axios = require("./axios");
 var jsonrpc = _interopRequireWildcard(require("./jsonrpc"));
 var _api = require("./api");
 var _transaction = require("./transaction");
@@ -71,12 +71,7 @@ var RpcServer = exports.RpcServer = function () {
     var opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
     _classCallCheck(this, RpcServer);
     this.serverURL = (0, _urijs.default)(serverURL);
-    if (opts.headers && Object.keys(opts.headers).length !== 0) {
-      _axios.default.interceptors.request.use(function (config) {
-        config.headers = Object.assign(config.headers, opts.headers);
-        return config;
-      });
-    }
+    this.httpClient = (0, _axios.createHttpClient)(opts.headers);
     if (this.serverURL.protocol() !== "https" && !opts.allowHttp) {
       throw new Error("Cannot connect to insecure Soroban RPC server if `allowHttp` isn't set");
     }
@@ -231,7 +226,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context5) {
           while (1) switch (_context5.n) {
             case 0:
-              return _context5.a(2, jsonrpc.postObject(this.serverURL.toString(), "getHealth"));
+              return _context5.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getHealth"));
           }
         }, _callee5, this);
       }));
@@ -406,7 +401,7 @@ var RpcServer = exports.RpcServer = function () {
       for (var _len = arguments.length, keys = new Array(_len), _key = 0; _key < _len; _key++) {
         keys[_key] = arguments[_key];
       }
-      return jsonrpc.postObject(this.serverURL.toString(), "getLedgerEntries", {
+      return jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getLedgerEntries", {
         keys: keys.map(function (k) {
           return k.toXDR("base64");
         })
@@ -518,7 +513,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context10) {
           while (1) switch (_context10.n) {
             case 0:
-              return _context10.a(2, jsonrpc.postObject(this.serverURL.toString(), "getTransaction", {
+              return _context10.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getTransaction", {
                 hash: hash
               }));
           }
@@ -562,7 +557,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context12) {
           while (1) switch (_context12.n) {
             case 0:
-              return _context12.a(2, jsonrpc.postObject(this.serverURL.toString(), "getTransactions", request));
+              return _context12.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getTransactions", request));
           }
         }, _callee12, this);
       }));
@@ -595,7 +590,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context14) {
           while (1) switch (_context14.n) {
             case 0:
-              return _context14.a(2, jsonrpc.postObject(this.serverURL.toString(), "getEvents", _objectSpread(_objectSpread({
+              return _context14.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getEvents", _objectSpread(_objectSpread({
                 filters: (_request$filters = request.filters) !== null && _request$filters !== void 0 ? _request$filters : [],
                 pagination: _objectSpread(_objectSpread({}, request.cursor && {
                   cursor: request.cursor
@@ -622,7 +617,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context15) {
           while (1) switch (_context15.n) {
             case 0:
-              return _context15.a(2, jsonrpc.postObject(this.serverURL.toString(), "getNetwork"));
+              return _context15.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getNetwork"));
           }
         }, _callee15, this);
       }));
@@ -638,7 +633,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context16) {
           while (1) switch (_context16.n) {
             case 0:
-              return _context16.a(2, jsonrpc.postObject(this.serverURL.toString(), "getLatestLedger"));
+              return _context16.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getLatestLedger"));
           }
         }, _callee16, this);
       }));
@@ -670,7 +665,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context18) {
           while (1) switch (_context18.n) {
             case 0:
-              return _context18.a(2, jsonrpc.postObject(this.serverURL.toString(), "simulateTransaction", _objectSpread({
+              return _context18.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "simulateTransaction", _objectSpread({
                 transaction: transaction.toXDR(),
                 authMode: authMode
               }, addlResources !== undefined && {
@@ -736,7 +731,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context21) {
           while (1) switch (_context21.n) {
             case 0:
-              return _context21.a(2, jsonrpc.postObject(this.serverURL.toString(), "sendTransaction", {
+              return _context21.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "sendTransaction", {
                 transaction: transaction.toXDR()
               }));
           }
@@ -775,7 +770,7 @@ var RpcServer = exports.RpcServer = function () {
             case 3:
               _context22.p = 3;
               _context22.n = 4;
-              return _axios.default.post("".concat(friendbotUrl, "?addr=").concat(encodeURIComponent(account)));
+              return this.httpClient.post("".concat(friendbotUrl, "?addr=").concat(encodeURIComponent(account)));
             case 4:
               response = _context22.v;
               if (response.data.result_meta_xdr) {
@@ -831,7 +826,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context23) {
           while (1) switch (_context23.n) {
             case 0:
-              return _context23.a(2, jsonrpc.postObject(this.serverURL.toString(), "getFeeStats"));
+              return _context23.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getFeeStats"));
           }
         }, _callee23, this);
       }));
@@ -847,7 +842,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context24) {
           while (1) switch (_context24.n) {
             case 0:
-              return _context24.a(2, jsonrpc.postObject(this.serverURL.toString(), "getVersionInfo"));
+              return _context24.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getVersionInfo"));
           }
         }, _callee24, this);
       }));
@@ -969,7 +964,7 @@ var RpcServer = exports.RpcServer = function () {
         return _regenerator().w(function (_context27) {
           while (1) switch (_context27.n) {
             case 0:
-              return _context27.a(2, jsonrpc.postObject(this.serverURL.toString(), "getLedgers", request));
+              return _context27.a(2, jsonrpc.postObject(this.httpClient, this.serverURL.toString(), "getLedgers", request));
           }
         }, _callee27, this);
       }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellar/stellar-sdk",
-  "version": "14.3.0",
+  "version": "14.3.2",
   "description": "A library for working with the Stellar network, including communication with the Horizon and Soroban RPC servers.",
   "keywords": [
     "stellar"
@@ -89,7 +89,6 @@
     "build:node:all": "yarn build:node && yarn build:node:no-axios && yarn build:node:no-eventsource && yarn build:node:minimal",
     "clean:temp": "rm -f ./config/tsconfig.tmp.json",
     "build:ts": "node config/set-output-dir.js && tsc -p ./config/tsconfig.tmp.json && yarn clean:temp",
-    "build:test": "tsc -p ./test/unit/tsconfig.json",
     "build:browser": "webpack -c config/webpack.config.browser.js",
     "build:browser:no-axios": "cross-env USE_AXIOS=false webpack -c config/webpack.config.browser.js",
     "build:browser:no-eventsource": "cross-env USE_EVENTSOURCE=false webpack -c config/webpack.config.browser.js",
@@ -98,17 +97,18 @@
     "build:docs": "cross-env NODE_ENV=docs yarn _babel",
     "clean": "rm -rf lib/ dist/ coverage/ .nyc_output/ jsdoc/ test/e2e/.soroban",
     "docs": "yarn build:docs && jsdoc -c ./config/.jsdoc.json",
-    "test": "yarn build:test && yarn test:node && yarn test:integration && yarn test:browser",
-    "test:e2e": "./test/e2e/initialize.sh && yarn _nyc mocha --recursive 'test/e2e/src/test-*.js'",
-    "test:node": "NODE_OPTIONS=--no-experimental-detect-module yarn _nyc mocha --recursive 'test/unit/**/*.js'",
+    "test": "yarn test:node && yarn test:integration && yarn test:browser",
+    "test:all": "yarn test:node && yarn test:integration && yarn test:browser && yarn test:e2e",
+    "test:e2e": "./test/e2e/initialize.sh && vitest run --config config/vitest.config.e2e.ts --coverage",
+    "test:node": "vitest run test/unit --config config/vitest.config.ts --coverage",
     "test:e2e:noeval": "NODE_OPTIONS=--disallow-code-generation-from-strings yarn test:e2e",
-    "test:integration": "yarn _nyc mocha --recursive 'test/integration/**/*.js'",
-    "test:browser": "karma start config/karma.conf.js",
-    "test:browser:no-axios": "cross-env USE_AXIOS=false yarn build:browser && cross-env USE_AXIOS=false karma start config/karma.conf.js",
+    "test:integration": "vitest run test/integration --config config/vitest.config.ts --coverage",
+    "test:browser": "yarn build:browser && vitest run --config config/vitest.config.browser.ts test/unit --coverage",
+    "test:browser:no-axios": "cross-env USE_AXIOS=false yarn build:browser && cross-env USE_AXIOS=false vitest run --config config/vitest.config.browser.ts test/unit",
     "fmt": "yarn _prettier && yarn eslint -c .eslintrc.js src/ --fix",
     "preversion": "yarn clean && yarn _prettier && yarn build:prod && yarn test",
     "prepare": "yarn build:prod",
-    "_build": "yarn build:node:all && yarn build:test && yarn build:browser:all",
+    "_build": "yarn build:node:all && yarn build:browser:all",
     "_babel": "babel --extensions '.ts' --out-dir ${OUTPUT_DIR:-lib} src/",
     "_nyc": "node node_modules/.bin/nyc --nycrc-path config/.nycrc",
     "_prettier": "prettier --config config/prettier.config.js --ignore-path config/.prettierignore --write './src/**/*.ts' './test/**/*.{js,ts}'"
@@ -126,20 +126,6 @@
   "engines": {
     "node": ">=20.0.0"
   },
-  "mocha": {
-    "reporter": "spec",
-    "require": [
-      "@babel/register",
-      "test/test-nodejs.js",
-      "dotenv/config"
-    ],
-    "exclude": [
-      "test/test-browser.js"
-    ],
-    "sort": true,
-    "recursive": true,
-    "timeout": 120000
-  },
   "nyc": {
     "instrument": false,
     "sourceMap": false,
@@ -157,26 +143,24 @@
     "@definitelytyped/dtslint": "^0.2.29",
     "@istanbuljs/nyc-config-babel": "3.0.0",
     "@stellar/tsconfig": "^1.0.2",
-    "@types/chai": "^4.3.19",
     "@types/detect-node": "^2.0.0",
     "@types/eventsource": "^1.1.12",
     "@types/json-schema": "^7.0.15",
     "@types/lodash": "^4.17.20",
-    "@types/mocha": "^10.0.9",
     "@types/node": "^20.14.11",
     "@types/randombytes": "^2.0.1",
-    "@types/sinon": "^17.0.4",
     "@types/urijs": "^1.19.20",
     "@typescript-eslint/parser": "^7.16.1",
+    "@vitest/browser": "^3.2.4",
+    "@vitest/coverage-istanbul": "3.2.4",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
     "axios-mock-adapter": "^1.22.0",
     "babel-loader": "^9.1.3",
     "babel-plugin-istanbul": "^7.0.1",
     "babel-plugin-transform-define": "^2.1.4",
     "better-docs": "^2.7.3",
     "buffer": "^6.0.3",
-    "chai": "^4.3.10",
-    "chai-as-promised": "^7.1.1",
-    "chai-http": "^4.3.0",
     "cross-env": "^7.0.3",
     "dotenv": "^16.6.0",
     "eslint": "^8.57.0",
@@ -192,34 +176,25 @@
     "ghooks": "^2.0.4",
     "husky": "^9.1.6",
     "jsdoc": "^4.0.4",
-    "json-schema-faker": "^0.5.9",
-    "karma": "^6.4.3",
-    "karma-chai": "^0.1.0",
-    "karma-chrome-launcher": "^3.1.0",
-    "karma-coverage": "^2.2.1",
-    "karma-firefox-launcher": "^2.1.3",
-    "karma-mocha": "^2.0.0",
-    "karma-sinon-chai": "^2.0.2",
-    "karma-webpack": "^5.0.1",
+    "jsdom": "^27.0.0",
     "lint-staged": "^15.5.1",
     "lodash": "^4.17.21",
-    "mocha": "^10.8.2",
     "node-polyfill-webpack-plugin": "^3.0.0",
     "null-loader": "^4.0.1",
     "nyc": "^17.0.0",
+    "playwright": "^1.56.0",
     "prettier": "^3.6.2",
     "randombytes": "^2.1.0",
-    "sinon": "^17.0.1",
-    "sinon-chai": "^3.7.0",
     "taffydb": "^2.7.3",
     "terser-webpack-plugin": "^5.3.14",
     "ts-node": "^10.9.2",
     "typescript": "5.6.3",
+    "vitest": "^3.2.4",
     "webpack": "^5.102.1",
     "webpack-cli": "^5.0.1"
   },
   "dependencies": {
-    "@stellar/stellar-base": "^14.0.1",
+    "@stellar/stellar-base": "^14.0.2",
     "axios": "^1.12.2",
     "bignumber.js": "^9.3.1",
     "eventsource": "^2.0.2",