stxer 0.4.5 → 0.7.0

package/dist/stxer.cjs.development.js

@@ -171,23 +171,6 @@ function _regeneratorDefine(e, r, n, t) {
     }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2));
   }, _regeneratorDefine(e, r, n, t);
 }
-function _regeneratorValues(e) {
-  if (null != e) {
-    var t = e["function" == typeof Symbol && Symbol.iterator || "@@iterator"],
-      r = 0;
-    if (t) return t.call(e);
-    if ("function" == typeof e.next) return e;
-    if (!isNaN(e.length)) return {
-      next: function () {
-        return e && r >= e.length && (e = void 0), {
-          value: e && e[r++],
-          done: !e
-        };
-      }
-    };
-  }
-  throw new TypeError(typeof e + " is not iterable");
-}
 function _unsupportedIterableToArray(r, a) {
   if (r) {
     if ("string" == typeof r) return _arrayLikeToArray(r, a);
@@ -196,10 +179,127 @@ function _unsupportedIterableToArray(r, a) {
   }
 }
 
+/**
+ * API endpoint constants
+ */
+/** Default stxer API endpoint for mainnet */
+var STXER_API_MAINNET = 'https://api.stxer.xyz';
+/** stxer API endpoint for testnet */
+var STXER_API_TESTNET = 'https://testnet-api.stxer.xyz';
+/** Default stxer API endpoint (mainnet) */
+var DEFAULT_STXER_API$1 = STXER_API_MAINNET;
+
+/**
+ * Fetch the AST for an on-chain contract.
+ * @param options - Contract ID and optional API endpoint
+ * @returns The contract AST with metadata
+ */
+function getContractAST(_x) {
+  return _getContractAST.apply(this, arguments);
+}
+/**
+ * Parse contract source code into an AST.
+ * @param options - Source code, contract ID, and optional configuration
+ * @returns The parsed contract AST
+ */
+function _getContractAST() {
+  _getContractAST = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(options) {
+    var _options$stxerApi;
+    var url, response, text;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          url = ((_options$stxerApi = options.stxerApi) != null ? _options$stxerApi : DEFAULT_STXER_API$1) + "/contracts/" + options.contractId;
+          _context.n = 1;
+          return fetch(url, {
+            method: 'GET',
+            headers: {
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context.v;
+          if (response.ok) {
+            _context.n = 2;
+            break;
+          }
+          throw new Error("Failed to fetch contract AST: " + response.status + " " + response.statusText);
+        case 2:
+          _context.n = 3;
+          return response.text();
+        case 3:
+          text = _context.v;
+          if (text.startsWith('{')) {
+            _context.n = 4;
+            break;
+          }
+          throw new Error("Invalid response from contracts endpoint: " + text);
+        case 4:
+          return _context.a(2, JSON.parse(text));
+      }
+    }, _callee);
+  }));
+  return _getContractAST.apply(this, arguments);
+}
+function parseContract(_x2) {
+  return _parseContract.apply(this, arguments);
+}
+function _parseContract() {
+  _parseContract = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(options) {
+    var _options$stxerApi2;
+    var url, payload, response, text;
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
+        case 0:
+          url = ((_options$stxerApi2 = options.stxerApi) != null ? _options$stxerApi2 : DEFAULT_STXER_API$1) + "/contracts:parse";
+          payload = {
+            contract_id: options.contractId,
+            source_code: options.sourceCode
+          };
+          if (options.clarityVersion !== undefined) {
+            payload.clarity_version = options.clarityVersion;
+          }
+          if (options.epoch !== undefined) {
+            payload.epoch = options.epoch;
+          }
+          _context2.n = 1;
+          return fetch(url, {
+            method: 'POST',
+            body: JSON.stringify(payload),
+            headers: {
+              'Content-Type': 'application/json',
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context2.v;
+          if (response.ok) {
+            _context2.n = 2;
+            break;
+          }
+          throw new Error("Failed to parse contract: " + response.status + " " + response.statusText);
+        case 2:
+          _context2.n = 3;
+          return response.text();
+        case 3:
+          text = _context2.v;
+          if (text.startsWith('{')) {
+            _context2.n = 4;
+            break;
+          }
+          throw new Error("Invalid response from contract parse endpoint: " + text);
+        case 4:
+          return _context2.a(2, JSON.parse(text));
+      }
+    }, _callee2);
+  }));
+  return _parseContract.apply(this, arguments);
+}
+
 var DEFAULT_STXER_API = 'https://api.stxer.xyz';
 function convertResults(rs) {
   var results = [];
-  for (var _iterator = _createForOfIteratorHelperLoose(rs), _step; !(_step = _iterator()).done;) {
+  for (var _iterator = _createForOfIteratorHelperLoose(rs != null ? rs : []), _step; !(_step = _iterator()).done;) {
     var v = _step.value;
     if ('Ok' in v) {
       results.push(transactions.deserializeCV(v.Ok));
@@ -272,7 +372,7 @@ function _batchRead() {
         case 3:
           rs = JSON.parse(text);
           return _context.a(2, {
-            tip: rs.tip,
+            index_block_hash: rs.index_block_hash,
             vars: convertResults(rs.vars),
             maps: convertResults(rs.maps),
             readonly: convertResults(rs.readonly)
@@ -596,6 +696,325 @@ function _readVariable() {
   return _readVariable.apply(this, arguments);
 }
 
+/**
+ * Instantly simulate a transaction
+ *
+ * This is useful for apps/wallets to get the result of a transaction before sending it.
+ * Lightweight - no debug tracing information.
+ *
+ * @param request - Instant simulation request
+ * @param options - API options
+ * @returns Instant simulation response with receipt and optional reads
+ *
+ * @example
+ * ```typescript
+ * import { instantSimulation } from 'stxer';
+ *
+ * const result = await instantSimulation({
+ *   transaction: '0x...',
+ *   block_height: 130818,
+ *   block_hash: '0x...',
+ *   reads: [
+ *     { DataVar: ['SP...contract', 'my-var'] },
+ *     { StxBalance: 'SP...' }
+ *   ]
+ * });
+ * console.log(result.receipt.result);
+ * ```
+ */
+function instantSimulation(_x, _x2) {
+  return _instantSimulation.apply(this, arguments);
+}
+/**
+ * Create a new simulation session
+ *
+ * A session allows you to run multiple steps in a forked chain state.
+ *
+ * @param options - Create session options
+ * @param apiOptions - API options
+ * @returns Session ID
+ *
+ * @example
+ * ```typescript
+ * import { createSimulationSession } from 'stxer';
+ *
+ * const sessionId = await createSimulationSession({
+ *   block_height: 130818,
+ *   skip_tracing: false
+ * });
+ * ```
+ */
+function _instantSimulation() {
+  _instantSimulation = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(request, options) {
+    var _options$stxerApi;
+    var apiEndpoint, response, text;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          if (options === void 0) {
+            options = {};
+          }
+          apiEndpoint = (_options$stxerApi = options.stxerApi) != null ? _options$stxerApi : DEFAULT_STXER_API$1;
+          _context.n = 1;
+          return fetch(apiEndpoint + "/devtools/v2/simulations:instant", {
+            method: 'POST',
+            body: JSON.stringify(request),
+            headers: {
+              'Content-Type': 'application/json',
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context.v;
+          if (response.ok) {
+            _context.n = 3;
+            break;
+          }
+          _context.n = 2;
+          return response.text();
+        case 2:
+          text = _context.v;
+          throw new Error("Instant simulation failed: " + text);
+        case 3:
+          return _context.a(2, response.json());
+      }
+    }, _callee);
+  }));
+  return _instantSimulation.apply(this, arguments);
+}
+function createSimulationSession(_x3, _x4) {
+  return _createSimulationSession.apply(this, arguments);
+}
+/**
+ * Submit steps to a simulation session
+ *
+ * Steps are executed sequentially in the session's forked chain state.
+ *
+ * @param sessionId - Simulation session ID
+ * @param request - Steps to submit
+ * @param options - API options
+ * @returns Array of step results
+ *
+ * @example
+ * ```typescript
+ * import { submitSimulationSteps } from 'stxer';
+ *
+ * const results = await submitSimulationSteps(sessionId, {
+ *   steps: [
+ *     { Transaction: '0x...' },
+ *     { Eval: ['SP...', '', 'SP...contract', '(var-get my-var)'] },
+ *     { Reads: [{ DataVar: ['SP...contract', 'my-var'] }] }
+ *   ]
+ * });
+ * ```
+ */
+function _createSimulationSession() {
+  _createSimulationSession = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(options, apiOptions) {
+    var _apiOptions$stxerApi;
+    var apiEndpoint, response, text, result;
+    return _regenerator().w(function (_context2) {
+      while (1) switch (_context2.n) {
+        case 0:
+          if (options === void 0) {
+            options = {};
+          }
+          if (apiOptions === void 0) {
+            apiOptions = {};
+          }
+          apiEndpoint = (_apiOptions$stxerApi = apiOptions.stxerApi) != null ? _apiOptions$stxerApi : DEFAULT_STXER_API$1;
+          _context2.n = 1;
+          return fetch(apiEndpoint + "/devtools/v2/simulations", {
+            method: 'POST',
+            body: JSON.stringify(options),
+            headers: {
+              'Content-Type': 'application/json',
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context2.v;
+          if (response.ok) {
+            _context2.n = 3;
+            break;
+          }
+          _context2.n = 2;
+          return response.text();
+        case 2:
+          text = _context2.v;
+          throw new Error("Failed to create simulation session: " + text);
+        case 3:
+          _context2.n = 4;
+          return response.json();
+        case 4:
+          result = _context2.v;
+          return _context2.a(2, result.id);
+      }
+    }, _callee2);
+  }));
+  return _createSimulationSession.apply(this, arguments);
+}
+function submitSimulationSteps(_x5, _x6, _x7) {
+  return _submitSimulationSteps.apply(this, arguments);
+}
+/**
+ * Get simulation session results
+ *
+ * Returns the full simulation result including metadata and all step results.
+ *
+ * @param sessionId - Simulation session ID
+ * @param options - API options
+ * @returns Complete simulation result
+ *
+ * @example
+ * ```typescript
+ * import { getSimulationResult } from 'stxer';
+ *
+ * const result = await getSimulationResult(sessionId);
+ * console.log(result.metadata);
+ * console.log(result.steps);
+ * ```
+ */
+function _submitSimulationSteps() {
+  _submitSimulationSteps = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(sessionId, request, options) {
+    var _options$stxerApi2;
+    var apiEndpoint, response, text;
+    return _regenerator().w(function (_context3) {
+      while (1) switch (_context3.n) {
+        case 0:
+          if (options === void 0) {
+            options = {};
+          }
+          apiEndpoint = (_options$stxerApi2 = options.stxerApi) != null ? _options$stxerApi2 : DEFAULT_STXER_API$1;
+          _context3.n = 1;
+          return fetch(apiEndpoint + "/devtools/v2/simulations/" + sessionId, {
+            method: 'POST',
+            body: JSON.stringify(request),
+            headers: {
+              'Content-Type': 'application/json',
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context3.v;
+          if (response.ok) {
+            _context3.n = 3;
+            break;
+          }
+          _context3.n = 2;
+          return response.text();
+        case 2:
+          text = _context3.v;
+          throw new Error("Failed to submit simulation steps: " + text);
+        case 3:
+          return _context3.a(2, response.json());
+      }
+    }, _callee3);
+  }));
+  return _submitSimulationSteps.apply(this, arguments);
+}
+function getSimulationResult(_x8, _x9) {
+  return _getSimulationResult.apply(this, arguments);
+}
+/**
+ * Batch reads from a simulation session
+ *
+ * Similar to sidecar batch reads, but reads from the simulation's forked state.
+ *
+ * @param sessionId - Simulation session ID
+ * @param request - Batch reads request
+ * @param options - API options
+ * @returns Batch read results
+ *
+ * @example
+ * ```typescript
+ * import { simulationBatchReads } from 'stxer';
+ *
+ * const results = await simulationBatchReads(sessionId, {
+ *   vars: [['SP...contract', 'my-var']],
+ *   maps: [['SP...contract', 'my-map', '0x...']],
+ *   stx: ['SP...']
+ * });
+ * console.log(results.vars);
+ * ```
+ */
+function _getSimulationResult() {
+  _getSimulationResult = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(sessionId, options) {
+    var _options$stxerApi3;
+    var apiEndpoint, response, text;
+    return _regenerator().w(function (_context4) {
+      while (1) switch (_context4.n) {
+        case 0:
+          if (options === void 0) {
+            options = {};
+          }
+          apiEndpoint = (_options$stxerApi3 = options.stxerApi) != null ? _options$stxerApi3 : DEFAULT_STXER_API$1;
+          _context4.n = 1;
+          return fetch(apiEndpoint + "/devtools/v2/simulations/" + sessionId, {
+            method: 'GET',
+            headers: {
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context4.v;
+          if (response.ok) {
+            _context4.n = 3;
+            break;
+          }
+          _context4.n = 2;
+          return response.text();
+        case 2:
+          text = _context4.v;
+          throw new Error("Failed to get simulation result: " + text);
+        case 3:
+          return _context4.a(2, response.json());
+      }
+    }, _callee4);
+  }));
+  return _getSimulationResult.apply(this, arguments);
+}
+function simulationBatchReads(_x0, _x1, _x10) {
+  return _simulationBatchReads.apply(this, arguments);
+}
+function _simulationBatchReads() {
+  _simulationBatchReads = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(sessionId, request, options) {
+    var _options$stxerApi4;
+    var apiEndpoint, response, text;
+    return _regenerator().w(function (_context5) {
+      while (1) switch (_context5.n) {
+        case 0:
+          if (options === void 0) {
+            options = {};
+          }
+          apiEndpoint = (_options$stxerApi4 = options.stxerApi) != null ? _options$stxerApi4 : DEFAULT_STXER_API$1;
+          _context5.n = 1;
+          return fetch(apiEndpoint + "/devtools/v2/simulations/" + sessionId + "/reads", {
+            method: 'POST',
+            body: JSON.stringify(request),
+            headers: {
+              'Content-Type': 'application/json',
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context5.v;
+          if (response.ok) {
+            _context5.n = 3;
+            break;
+          }
+          _context5.n = 2;
+          return response.text();
+        case 2:
+          text = _context5.v;
+          throw new Error("Failed to batch reads from simulation: " + text);
+        case 3:
+          return _context5.a(2, response.json());
+      }
+    }, _callee5);
+  }));
+  return _simulationBatchReads.apply(this, arguments);
+}
+
 function setSender(tx, sender) {
   var _c32addressDecode = c32check.c32addressDecode(sender),
     addressVersion = _c32addressDecode[0],
@@ -623,128 +1042,25 @@ function setSender(tx, sender) {
   }
   return tx;
 }
-function runTx(tx) {
-  // type 0: run transaction
-  return transactions.tupleCV({
-    type: transactions.uintCV(0),
-    data: transactions.bufferCV(tx.serializeBytes())
-  });
-}
-function runEval(_ref) {
-  var contract_id = _ref.contract_id,
-    code = _ref.code;
-  var _contract_id$split = contract_id.split('.'),
-    contract_address = _contract_id$split[0],
-    contract_name = _contract_id$split[1];
-  // type 1: eval arbitrary code inside a contract
-  return transactions.tupleCV({
-    type: transactions.uintCV(1),
-    data: transactions.bufferCV(transactions.serializeCVBytes(transactions.tupleCV({
-      contract: transactions.contractPrincipalCV(contract_address, contract_name),
-      code: transactions.stringAsciiCV(code)
-    })))
-  });
-}
-function runSimulation(_x, _x2, _x3, _x4) {
-  return _runSimulation.apply(this, arguments);
-}
-function _runSimulation() {
-  _runSimulation = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(apiEndpoint, block_hash, block_height, txs) {
-    var header, heightBytes, view, hashHex, matches, hashBytes, txBytes, totalLength, body, offset, _iterator3, _step4, tx, rs;
-    return _regenerator().w(function (_context7) {
-      while (1) switch (_context7.n) {
-        case 0:
-          // Convert 'sim-v1' to Uint8Array
-          header = new TextEncoder().encode('sim-v1'); // Create 8 bytes for block height
-          heightBytes = new Uint8Array(8); // Convert block height to bytes
-          view = new DataView(heightBytes.buffer);
-          view.setBigUint64(0, BigInt(block_height), false); // false for big-endian
-          // Convert block hash to bytes
-          hashHex = block_hash.startsWith('0x') ? block_hash.substring(2) : block_hash; // Replace non-null assertion with null check
-          matches = hashHex.match(/.{1,2}/g);
-          if (matches) {
-            _context7.n = 1;
-            break;
-          }
-          throw new Error('Invalid block hash format');
-        case 1:
-          hashBytes = new Uint8Array(matches.map(function (_byte) {
-            return Number.parseInt(_byte, 16);
-          })); // Convert transactions to bytes
-          txBytes = txs.map(function (t) {
-            return 'contract_id' in t && 'code' in t ? runEval(t) : runTx(t);
-          }).map(function (t) {
-            return transactions.serializeCVBytes(t);
-          }); // Combine all byte arrays
-          totalLength = header.length + heightBytes.length + hashBytes.length + txBytes.reduce(function (acc, curr) {
-            return acc + curr.length;
-          }, 0);
-          body = new Uint8Array(totalLength);
-          offset = 0;
-          body.set(header, offset);
-          offset += header.length;
-          body.set(heightBytes, offset);
-          offset += heightBytes.length;
-          body.set(hashBytes, offset);
-          offset += hashBytes.length;
-          for (_iterator3 = _createForOfIteratorHelperLoose(txBytes); !(_step4 = _iterator3()).done;) {
-            tx = _step4.value;
-            body.set(tx, offset);
-            offset += tx.length;
-          }
-          _context7.n = 2;
-          return fetch(apiEndpoint, {
-            method: 'POST',
-            body: body
-          }).then(/*#__PURE__*/function () {
-            var _ref4 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(rs) {
-              var response;
-              return _regenerator().w(function (_context6) {
-                while (1) switch (_context6.n) {
-                  case 0:
-                    _context6.n = 1;
-                    return rs.text();
-                  case 1:
-                    response = _context6.v;
-                    if (response.startsWith('{')) {
-                      _context6.n = 2;
-                      break;
-                    }
-                    throw new Error("failed to submit simulation: " + response);
-                  case 2:
-                    return _context6.a(2, JSON.parse(response));
-                }
-              }, _callee5);
-            }));
-            return function (_x7) {
-              return _ref4.apply(this, arguments);
-            };
-          }());
-        case 2:
-          rs = _context7.v;
-          return _context7.a(2, rs.id);
-      }
-    }, _callee6);
-  }));
-  return _runSimulation.apply(this, arguments);
-}
 var SimulationBuilder = /*#__PURE__*/function () {
   function SimulationBuilder(options) {
-    var _options$network, _options$apiEndpoint, _options$stacksNodeAP;
+    var _options$network, _options$apiEndpoint, _options$stacksNodeAP, _options$skipTracing;
     if (options === void 0) {
       options = {};
     }
     this.apiEndpoint = void 0;
     this.stacksNodeAPI = void 0;
     this.network = void 0;
+    this.skipTracing = void 0;
     // biome-ignore lint/style/useNumberNamespace: ignore this
     this.block = NaN;
     this.sender = '';
     this.steps = [];
     this.network = (_options$network = options.network) != null ? _options$network : 'mainnet';
     var isTestnet = this.network === 'testnet';
-    this.apiEndpoint = (_options$apiEndpoint = options.apiEndpoint) != null ? _options$apiEndpoint : isTestnet ? 'https://testnet-api.stxer.xyz' : 'https://api.stxer.xyz';
+    this.apiEndpoint = (_options$apiEndpoint = options.apiEndpoint) != null ? _options$apiEndpoint : isTestnet ? STXER_API_TESTNET : STXER_API_MAINNET;
     this.stacksNodeAPI = (_options$stacksNodeAP = options.stacksNodeAPI) != null ? _options$stacksNodeAP : isTestnet ? 'https://api.testnet.hiro.so' : 'https://api.hiro.so';
+    this.skipTracing = (_options$skipTracing = options.skipTracing) != null ? _options$skipTracing : false;
   }
   SimulationBuilder["new"] = function _new(options) {
     return new SimulationBuilder(options);
@@ -819,6 +1135,29 @@ var SimulationBuilder = /*#__PURE__*/function () {
     });
     return this;
   };
+  _proto.addSetContractCode = function addSetContractCode(params) {
+    var _params$clarity_versi2;
+    this.steps.push({
+      type: 'SetContractCode',
+      contract_id: params.contract_id,
+      source_code: params.source_code,
+      clarity_version: (_params$clarity_versi2 = params.clarity_version) != null ? _params$clarity_versi2 : transactions.ClarityVersion.Clarity4
+    });
+    return this;
+  };
+  _proto.addReads = function addReads(reads) {
+    this.steps.push({
+      type: 'Reads',
+      reads: reads
+    });
+    return this;
+  };
+  _proto.addTenureExtend = function addTenureExtend() {
+    this.steps.push({
+      type: 'TenureExtend'
+    });
+    return this;
+  };
   _proto.getBlockInfo = /*#__PURE__*/function () {
     var _getBlockInfo = /*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
       var _yield$getNodeInfo, stacks_tip_height, info;
@@ -864,22 +1203,22 @@ var SimulationBuilder = /*#__PURE__*/function () {
     return getBlockInfo;
   }();
   _proto.run = /*#__PURE__*/function () {
-    var _run = /*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
+    var _run = /*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
       var _this = this;
-      var block, txs, nonce_by_address, nextNonce, network$1, _loop, _iterator, _step, id;
-      return _regenerator().w(function (_context5) {
-        while (1) switch (_context5.n) {
+      var block, v2Steps, nonce_by_address, nextNonce, network$1, _iterator, _step, step, _step$function_args, nonce, tx, _nonce, _tx, _nonce2, _tx2, _step$contract_id$spl, contractAddress, contractName, simulationId;
+      return _regenerator().w(function (_context3) {
+        while (1) switch (_context3.n) {
           case 0:
             console.log("--------------------------------\nThis product can never exist without your support!\n\nWe receive sponsorship funds with:\nSP212Y5JKN59YP3GYG07K3S8W5SSGE4KH6B5STXER\n\nFeedbacks and feature requests are welcome.\nTo get in touch: contact@stxer.xyz\n--------------------------------");
-            _context5.n = 1;
+            _context3.n = 1;
             return this.getBlockInfo();
           case 1:
-            block = _context5.v;
+            block = _context3.v;
             console.log("Using block height " + block.block_height + " hash 0x" + block.block_hash + " to run simulation.");
-            txs = [];
+            v2Steps = [];
             nonce_by_address = new Map();
             nextNonce = /*#__PURE__*/function () {
-              var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(sender) {
+              var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(sender) {
                 var nonce, url, account;
                 return _regenerator().w(function (_context2) {
                   while (1) switch (_context2.n) {
@@ -904,8 +1243,8 @@ var SimulationBuilder = /*#__PURE__*/function () {
                   }
                 }, _callee2);
               }));
-              return function nextNonce(_x5) {
-                return _ref2.apply(this, arguments);
+              return function nextNonce(_x) {
+                return _ref.apply(this, arguments);
               };
             }();
             network$1 = this.network === 'mainnet' ? network.STACKS_MAINNET : network.STACKS_TESTNET;
@@ -916,164 +1255,152 @@ var SimulationBuilder = /*#__PURE__*/function () {
                 })
               });
             }
-            _loop = /*#__PURE__*/_regenerator().m(function _loop() {
-              var step, previousSimulation, _iterator2, _step2, _step3, _step$function_args, nonce, _step$contract_id$spl, contractAddress, contractName, tx, _nonce, _tx, _nonce2, _tx2;
-              return _regenerator().w(function (_context4) {
-                while (1) switch (_context4.n) {
-                  case 0:
-                    step = _step.value;
-                    if (!('simulationId' in step)) {
-                      _context4.n = 2;
-                      break;
-                    }
-                    _context4.n = 1;
-                    return fetch("https://api.stxer.xyz/simulations/" + step.simulationId + "/request").then(/*#__PURE__*/function () {
-                      var _ref3 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(rs) {
-                        var body;
-                        return _regenerator().w(function (_context3) {
-                          while (1) switch (_context3.n) {
-                            case 0:
-                              _context3.n = 1;
-                              return rs.text();
-                            case 1:
-                              body = _context3.v;
-                              if (body.startsWith('{')) {
-                                _context3.n = 2;
-                                break;
-                              }
-                              throw new Error("failed to get simulation " + step.simulationId + ": " + body);
-                            case 2:
-                              return _context3.a(2, JSON.parse(body));
-                          }
-                        }, _callee3);
-                      }));
-                      return function (_x6) {
-                        return _ref3.apply(this, arguments);
-                      };
-                    }());
-                  case 1:
-                    previousSimulation = _context4.v;
-                    for (_iterator2 = _createForOfIteratorHelperLoose(previousSimulation.steps); !(_step2 = _iterator2()).done;) {
-                      _step3 = _step2.value;
-                      if ('tx' in _step3) {
-                        txs.push(transactions.deserializeTransaction(_step3.tx));
-                      } else if ('code' in _step3 && 'contract' in _step3) {
-                        txs.push({
-                          contract_id: _step3.contract,
-                          code: _step3.code
-                        });
-                      }
-                    }
-                    _context4.n = 12;
-                    break;
-                  case 2:
-                    if (!('sender' in step && 'function_name' in step)) {
-                      _context4.n = 5;
-                      break;
-                    }
-                    _context4.n = 3;
-                    return nextNonce(step.sender);
-                  case 3:
-                    nonce = _context4.v;
-                    _step$contract_id$spl = step.contract_id.split('.'), contractAddress = _step$contract_id$spl[0], contractName = _step$contract_id$spl[1];
-                    _context4.n = 4;
-                    return transactions.makeUnsignedContractCall({
-                      contractAddress: contractAddress,
-                      contractName: contractName,
-                      functionName: step.function_name,
-                      functionArgs: (_step$function_args = step.function_args) != null ? _step$function_args : [],
-                      nonce: nonce,
-                      network: network$1,
-                      publicKey: '',
-                      postConditionMode: transactions.PostConditionMode.Allow,
-                      fee: step.fee
-                    });
-                  case 4:
-                    tx = _context4.v;
-                    setSender(tx, step.sender);
-                    txs.push(tx);
-                    _context4.n = 12;
-                    break;
-                  case 5:
-                    if (!('sender' in step && 'recipient' in step)) {
-                      _context4.n = 8;
-                      break;
-                    }
-                    _context4.n = 6;
-                    return nextNonce(step.sender);
-                  case 6:
-                    _nonce = _context4.v;
-                    _context4.n = 7;
-                    return transactions.makeUnsignedSTXTokenTransfer({
-                      recipient: step.recipient,
-                      amount: step.amount,
-                      nonce: _nonce,
-                      network: network$1,
-                      publicKey: '',
-                      fee: step.fee
-                    });
-                  case 7:
-                    _tx = _context4.v;
-                    setSender(_tx, step.sender);
-                    txs.push(_tx);
-                    _context4.n = 12;
-                    break;
-                  case 8:
-                    if (!('deployer' in step)) {
-                      _context4.n = 11;
-                      break;
-                    }
-                    _context4.n = 9;
-                    return nextNonce(step.deployer);
-                  case 9:
-                    _nonce2 = _context4.v;
-                    _context4.n = 10;
-                    return transactions.makeUnsignedContractDeploy({
-                      contractName: step.contract_name,
-                      codeBody: step.source_code,
-                      nonce: _nonce2,
-                      network: network$1,
-                      publicKey: '',
-                      postConditionMode: transactions.PostConditionMode.Allow,
-                      fee: step.fee,
-                      clarityVersion: step.clarity_version
-                    });
-                  case 10:
-                    _tx2 = _context4.v;
-                    setSender(_tx2, step.deployer);
-                    txs.push(_tx2);
-                    _context4.n = 12;
-                    break;
-                  case 11:
-                    if ('code' in step) {
-                      txs.push(step);
-                    } else {
-                      console.log("Invalid simulation step: " + step);
-                    }
-                  case 12:
-                    return _context4.a(2);
-                }
-              }, _loop);
-            });
             _iterator = _createForOfIteratorHelperLoose(this.steps);
           case 2:
             if ((_step = _iterator()).done) {
-              _context5.n = 4;
+              _context3.n = 14;
+              break;
+            }
+            step = _step.value;
+            if (!('simulationId' in step)) {
+              _context3.n = 3;
               break;
             }
-            return _context5.d(_regeneratorValues(_loop()), 3);
+            throw new Error('inlineSimulation is not yet supported in V2 API. Please run simulations from scratch.');
           case 3:
-            _context5.n = 2;
-            break;
+            if (!('sender' in step && 'function_name' in step)) {
+              _context3.n = 6;
+              break;
+            }
+            _context3.n = 4;
+            return nextNonce(step.sender);
           case 4:
-            _context5.n = 5;
-            return runSimulation(this.apiEndpoint + "/simulations", block.block_hash, block.block_height, txs);
+            nonce = _context3.v;
+            _context3.n = 5;
+            return transactions.makeUnsignedContractCall({
+              contractAddress: step.contract_id.split('.')[0],
+              contractName: step.contract_id.split('.')[1],
+              functionName: step.function_name,
+              functionArgs: (_step$function_args = step.function_args) != null ? _step$function_args : [],
+              nonce: nonce,
+              network: network$1,
+              publicKey: '',
+              postConditionMode: transactions.PostConditionMode.Allow,
+              fee: step.fee
+            });
           case 5:
-            id = _context5.v;
-            console.log("Simulation will be available at: https://stxer.xyz/simulations/" + this.network + "/" + id);
-            return _context5.a(2, id);
+            tx = _context3.v;
+            setSender(tx, step.sender);
+            v2Steps.push({
+              Transaction: bytesToHex(tx.serializeBytes())
+            });
+            _context3.n = 13;
+            break;
+          case 6:
+            if (!('sender' in step && 'recipient' in step)) {
+              _context3.n = 9;
+              break;
+            }
+            _context3.n = 7;
+            return nextNonce(step.sender);
+          case 7:
+            _nonce = _context3.v;
+            _context3.n = 8;
+            return transactions.makeUnsignedSTXTokenTransfer({
+              recipient: step.recipient,
+              amount: step.amount,
+              nonce: _nonce,
+              network: network$1,
+              publicKey: '',
+              fee: step.fee
+            });
+          case 8:
+            _tx = _context3.v;
+            setSender(_tx, step.sender);
+            v2Steps.push({
+              Transaction: bytesToHex(_tx.serializeBytes())
+            });
+            _context3.n = 13;
+            break;
+          case 9:
+            if (!('deployer' in step)) {
+              _context3.n = 12;
+              break;
+            }
+            _context3.n = 10;
+            return nextNonce(step.deployer);
+          case 10:
+            _nonce2 = _context3.v;
+            _context3.n = 11;
+            return transactions.makeUnsignedContractDeploy({
+              contractName: step.contract_name,
+              codeBody: step.source_code,
+              nonce: _nonce2,
+              network: network$1,
+              publicKey: '',
+              postConditionMode: transactions.PostConditionMode.Allow,
+              fee: step.fee,
+              clarityVersion: step.clarity_version
+            });
+          case 11:
+            _tx2 = _context3.v;
+            setSender(_tx2, step.deployer);
+            v2Steps.push({
+              Transaction: bytesToHex(_tx2.serializeBytes())
+            });
+            _context3.n = 13;
+            break;
+          case 12:
+            if ('code' in step) {
+              // Eval step - format: [sender, sponsor, contract_id, code]
+              // For eval without a sender, we use empty string for sponsor
+              _step$contract_id$spl = step.contract_id.split('.'), contractAddress = _step$contract_id$spl[0], contractName = _step$contract_id$spl[1];
+              v2Steps.push({
+                Eval: [this.sender || contractAddress, '', contractAddress + "." + contractName, step.code]
+              });
+            } else if (step.type === 'SetContractCode') {
+              // SetContractCode - format: [contract_id, code, clarity_version]
+              v2Steps.push({
+                SetContractCode: [step.contract_id, step.source_code, clarityVersionToNumber(step.clarity_version)]
+              });
+            } else if (step.type === 'Reads') {
+              // Reads - batch read operations
+              v2Steps.push({
+                Reads: step.reads
+              });
+            } else if (step.type === 'TenureExtend') {
+              // TenureExtend - format: []
+              v2Steps.push({
+                TenureExtend: []
+              });
+            } else {
+              console.log("Invalid simulation step: " + step);
+            }
+          case 13:
+            _context3.n = 2;
+            break;
+          case 14:
+            _context3.n = 15;
+            return createSimulationSession({
+              block_height: block.block_height,
+              block_hash: block.block_hash,
+              skip_tracing: this.skipTracing
+            }, {
+              stxerApi: this.apiEndpoint
+            });
+          case 15:
+            simulationId = _context3.v;
+            _context3.n = 16;
+            return submitSimulationSteps(simulationId, {
+              steps: v2Steps
+            }, {
+              stxerApi: this.apiEndpoint
+            });
+          case 16:
+            console.log("Simulation will be available at: https://stxer.xyz/simulations/" + this.network + "/" + simulationId);
+            return _context3.a(2, simulationId);
         }
-      }, _callee4, this);
+      }, _callee3, this);
     }));
     function run() {
       return _run.apply(this, arguments);
@@ -1085,12 +1412,103 @@ var SimulationBuilder = /*#__PURE__*/function () {
   };
   return SimulationBuilder;
 }();
+// Helper function to convert Uint8Array to hex string
+function bytesToHex(bytes) {
+  return Array.from(bytes).map(function (b) {
+    return b.toString(16).padStart(2, '0');
+  }).join('');
+}
+// Helper function to convert ClarityVersion to number
+function clarityVersionToNumber(version) {
+  switch (version) {
+    case transactions.ClarityVersion.Clarity1:
+      return 1;
+    case transactions.ClarityVersion.Clarity2:
+      return 2;
+    case transactions.ClarityVersion.Clarity3:
+      return 3;
+    case transactions.ClarityVersion.Clarity4:
+      return 4;
+    default:
+      return 4;
+  }
+}
+
+/**
+ * Fetch the current tip information from the sidecar.
+ * @param options - Optional API endpoint configuration
+ * @returns The current chain tip information
+ */
+function getTip(_x) {
+  return _getTip.apply(this, arguments);
+}
+function _getTip() {
+  _getTip = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(options) {
+    var _options$stxerApi;
+    var url, response, text;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          if (options === void 0) {
+            options = {};
+          }
+          url = ((_options$stxerApi = options.stxerApi) != null ? _options$stxerApi : DEFAULT_STXER_API$1) + "/sidecar/tip";
+          _context.n = 1;
+          return fetch(url, {
+            method: 'GET',
+            headers: {
+              Accept: 'application/json'
+            }
+          });
+        case 1:
+          response = _context.v;
+          if (response.ok) {
+            _context.n = 2;
+            break;
+          }
+          throw new Error("Failed to fetch tip: " + response.status + " " + response.statusText);
+        case 2:
+          _context.n = 3;
+          return response.text();
+        case 3:
+          text = _context.v;
+          if (text.startsWith('{')) {
+            _context.n = 4;
+            break;
+          }
+          throw new Error("Invalid response from tip endpoint: " + text);
+        case 4:
+          return _context.a(2, JSON.parse(text));
+      }
+    }, _callee);
+  }));
+  return _getTip.apply(this, arguments);
+}
+
+/**
+ * Type definitions for stxer-api V2 endpoints
+ * Hand-written types based on OpenAPI spec at https://api.stxer.xyz/openapi.json
+ */
+/** Convenience parser for `TransactionReceipt.events[i]`. */
+function parseSimulationEvent(raw) {
+  return JSON.parse(raw);
+}
 
+exports.DEFAULT_STXER_API = DEFAULT_STXER_API$1;
+exports.STXER_API_MAINNET = STXER_API_MAINNET;
+exports.STXER_API_TESTNET = STXER_API_TESTNET;
 exports.SimulationBuilder = SimulationBuilder;
 exports.batchRead = batchRead;
 exports.callReadonly = callReadonly;
+exports.createSimulationSession = createSimulationSession;
+exports.getContractAST = getContractAST;
+exports.getSimulationResult = getSimulationResult;
+exports.getTip = getTip;
+exports.instantSimulation = instantSimulation;
+exports.parseContract = parseContract;
+exports.parseSimulationEvent = parseSimulationEvent;
 exports.readMap = readMap;
 exports.readVariable = readVariable;
-exports.runEval = runEval;
-exports.runSimulation = runSimulation;
+exports.simulationBatchReads = simulationBatchReads;
+exports.submitSimulationSteps = submitSimulationSteps;
 //# sourceMappingURL=stxer.cjs.development.js.map