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

package/lib/rpc/api.d.ts

@@ -1,10 +1,5 @@
 import { Contract, SorobanDataBuilder, xdr } from '@stellar/stellar-base';
-/** @namespace Api */
 export declare namespace Api {
-    export interface Cost {
-        cpuInsns: string;
-        memBytes: string;
-    }
     export interface GetHealthResponse {
         status: 'healthy';
     }
@@ -57,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;
@@ -94,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 {
@@ -114,6 +111,7 @@ export declare namespace Api {
         createdAt: number;
         applicationOrder: number;
         feeBump: boolean;
+        txHash: string;
         envelopeXdr?: string;
         resultXdr?: string;
         resultMetaXdr?: string;
@@ -125,6 +123,7 @@ export declare namespace Api {
         createdAt: number;
         applicationOrder: number;
         feeBump: boolean;
+        txHash: string;
         envelopeXdr: xdr.TransactionEnvelope;
         resultXdr: xdr.TransactionResult;
         resultMetaXdr: xdr.TransactionMeta;
@@ -171,6 +170,7 @@ export declare namespace Api {
         type: EventType;
         ledger: number;
         ledgerClosedAt: string;
+        cursor: string;
         pagingToken: string;
         inSuccessfulContractCall: boolean;
         txHash: string;
@@ -256,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 */
@@ -305,19 +304,22 @@ export declare namespace Api {
          * invokeHostFunctionOperation is supported per transaction.
          * */
         results?: RawSimulateHostFunctionResult[];
-        cost?: Cost;
         /** Present if succeeded but has expired ledger entries */
         restorePreamble?: {
             minResourceFee: string;
             transactionData: string;
         };
-        /** State Difference information */
+        /** State difference information */
         stateChanges?: RawLedgerEntryChange[];
     }
     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;
     }
@@ -344,5 +346,17 @@ export declare namespace Api {
         transactionCount: string;
         ledgerCount: number;
     }
+    export interface BalanceResponse {
+        latestLedger: number;
+        /** present only on success, otherwise request malformed or no balance */
+        balanceEntry?: {
+            /** a 64-bit integer */
+            amount: string;
+            authorized: boolean;
+            clawback: boolean;
+            lastModifiedLedgerSeq?: number;
+            liveUntilLedgerSeq?: number;
+        };
+    }
     export {};
 }

package/lib/rpc/axios.d.ts

@@ -1,3 +1,4 @@
-export declare const version: any;
-export declare const AxiosClient: import("axios").AxiosInstance;
+import { HttpClient } from "../http-client";
+export declare const version: string;
+export declare const AxiosClient: HttpClient;
 export default AxiosClient;

package/lib/rpc/axios.js

@@ -4,10 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.version = exports.default = exports.AxiosClient = void 0;
-var _axios = _interopRequireDefault(require("axios"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-var version = exports.version = require('../../package.json').version;
-var AxiosClient = exports.AxiosClient = _axios.default.create({
+var _httpClient = require("../http-client");
+var version = exports.version = "13.0.0-rc.1";
+var AxiosClient = exports.AxiosClient = (0, _httpClient.create)({
   headers: {
     'X-Client-Name': 'js-soroban-client',
     'X-Client-Version': version

package/lib/rpc/browser.d.ts

@@ -1,6 +1,4 @@
-import axios from 'axios';
 export * from './index';
 export * as StellarBase from '@stellar/stellar-base';
-export { axios };
 declare const _default: any;
 export default _default;

package/lib/rpc/browser.js

@@ -5,18 +5,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 var _exportNames = {
-  axios: true,
   StellarBase: true
 };
-exports.StellarBase = void 0;
-Object.defineProperty(exports, "axios", {
-  enumerable: true,
-  get: function get() {
-    return _axios.default;
-  }
-});
-exports.default = void 0;
-var _axios = _interopRequireDefault(require("axios"));
+exports.default = exports.StellarBase = void 0;
 var _index = require("./index");
 Object.keys(_index).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -33,5 +24,4 @@ var _StellarBase = _interopRequireWildcard(require("@stellar/stellar-base"));
 exports.StellarBase = _StellarBase;
 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; }
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 var _default = exports.default = module.exports;

package/lib/rpc/index.d.ts

@@ -1,5 +1,6 @@
+/** @module rpc */
 export * from "./api";
-export { 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/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,16 +18,28 @@ 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() {
-    return _server.Server;
+    return _server.RpcServer;
   }
 });
 exports.default = void 0;

package/lib/rpc/jsonrpc.d.ts

@@ -23,5 +23,13 @@ export interface Error<E = any> {
     message?: string;
     data?: E;
 }
-/** Sends the jsonrpc 'params' as a single 'param' object (no array support). */
+/**
+ * Sends the jsonrpc 'params' as a single 'param' object (no array support).
+ *
+ * @param {string} url URL to the RPC instance
+ * @param {string} method RPC method name that should be called
+ * @param {(any | null)} [param=null] params that should be supplied to the method
+ * @returns {Promise<T>}
+ * @private
+ */
 export declare function postObject<T>(url: string, method: string, param?: any): Promise<T>;

package/lib/rpc/parsers.d.ts

@@ -1,19 +1,39 @@
 import { Api } from './api';
-export declare function parseRawSendTransaction(r: Api.RawSendTransactionResponse): Api.SendTransactionResponse;
-export declare function parseTransactionInfo(raw: Api.RawTransactionInfo | Api.RawGetTransactionResponse): Omit<Api.TransactionInfo, 'status'>;
+/**
+ * Parse the response from invoking the `submitTransaction` method of a Soroban RPC server.
+ * @memberof module:rpc
+ * @private
+ *
+ * @param {Api.RawSendTransactionResponse} raw the raw `submitTransaction` response from the Soroban RPC server to parse
+ * @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' | 'txHash'>;
 export declare function parseRawTransactions(r: Api.RawTransactionInfo): Api.TransactionInfo;
-export declare function parseRawEvents(r: Api.RawGetEventsResponse): Api.GetEventsResponse;
-export declare function parseRawLedgerEntries(raw: Api.RawGetLedgerEntriesResponse): Api.GetLedgerEntriesResponse;
 /**
- * Converts a raw response schema into one with parsed XDR fields and a
- * simplified interface.
- * Warning: This API is only exported for testing purposes and should not be
- *          relied on or considered "stable".
+ * Parse and return the retrieved events, if any, from a raw response from a Soroban RPC server.
+ * @memberof module:rpc
  *
- * @param {Api.SimulateTransactionResponse|Api.RawSimulateTransactionResponse} sim the raw response schema (parsed ones are allowed, best-effort
- *    detected, and returned untouched)
+ * @param {Api.RawGetEventsResponse} raw the raw `getEvents` response from the Soroban RPC server to parse
+ * @returns {Api.GetEventsResponse} events parsed from the Soroban RPC server's response
+ */
+export declare function parseRawEvents(raw: Api.RawGetEventsResponse): Api.GetEventsResponse;
+/**
+ * Parse and return the retrieved ledger entries, if any, from a raw response from a Soroban RPC server.
+ * @memberof module:rpc
+ * @private
  *
- * @returns the original parameter (if already parsed), parsed otherwise
+ * @param {Api.RawGetLedgerEntriesResponse} raw he raw `getLedgerEntries` response from the Soroban RPC server to parse
+ * @returns {Api.GetLedgerEntriesResponse} ledger entries parsed from the Soroban RPC server's response
+ */
+export declare function parseRawLedgerEntries(raw: Api.RawGetLedgerEntriesResponse): Api.GetLedgerEntriesResponse;
+/**
+ * Converts a raw response schema into one with parsed XDR fields and a simplified interface.
+ * @warning This API is only exported for testing purposes and should not be relied on or considered "stable".
+ * @memberof module:rpc
  *
+ * @param {Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse} sim the raw response schema (parsed ones are allowed, best-effort
+ *    detected, and returned untouched)
+ * @returns {Api.SimulateTransactionResponse} the original parameter (if already parsed), parsed otherwise
  */
 export declare function parseRawSimulation(sim: Api.SimulateTransactionResponse | Api.RawSimulateTransactionResponse): Api.SimulateTransactionResponse;

package/lib/rpc/parsers.js

@@ -17,13 +17,13 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, 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 parseRawSendTransaction(r) {
-  var errorResultXdr = r.errorResultXdr,
-    diagnosticEventsXdr = r.diagnosticEventsXdr;
-  delete r.errorResultXdr;
-  delete r.diagnosticEventsXdr;
+function parseRawSendTransaction(raw) {
+  var errorResultXdr = raw.errorResultXdr,
+    diagnosticEventsXdr = raw.diagnosticEventsXdr;
+  delete raw.errorResultXdr;
+  delete raw.diagnosticEventsXdr;
   if (errorResultXdr) {
-    return _objectSpread(_objectSpread(_objectSpread({}, r), diagnosticEventsXdr !== undefined && diagnosticEventsXdr.length > 0 && {
+    return _objectSpread(_objectSpread(_objectSpread({}, raw), diagnosticEventsXdr !== undefined && diagnosticEventsXdr.length > 0 && {
       diagnosticEvents: diagnosticEventsXdr.map(function (evt) {
         return _stellarBase.xdr.DiagnosticEvent.fromXDR(evt, 'base64');
       })
@@ -31,7 +31,7 @@ function parseRawSendTransaction(r) {
       errorResult: _stellarBase.xdr.TransactionResult.fromXDR(errorResultXdr, 'base64')
     });
   }
-  return _objectSpread({}, r);
+  return _objectSpread({}, raw);
 }
 function parseTransactionInfo(raw) {
   var meta = _stellarBase.xdr.TransactionMeta.fromXDR(raw.resultMetaXdr, 'base64');
@@ -57,14 +57,15 @@ function parseTransactionInfo(raw) {
 }
 function parseRawTransactions(r) {
   return _objectSpread({
-    status: r.status
+    status: r.status,
+    txHash: r.txHash
   }, parseTransactionInfo(r));
 }
-function parseRawEvents(r) {
-  var _r$events;
+function parseRawEvents(raw) {
+  var _raw$events;
   return {
-    latestLedger: r.latestLedger,
-    events: ((_r$events = r.events) !== null && _r$events !== void 0 ? _r$events : []).map(function (evt) {
+    latestLedger: raw.latestLedger,
+    events: ((_raw$events = raw.events) !== null && _raw$events !== void 0 ? _raw$events : []).map(function (evt) {
       var clone = _objectSpread({}, evt);
       delete clone.contractId;
       return _objectSpread(_objectSpread(_objectSpread({}, clone), evt.contractId !== '' && {
@@ -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;