@stellar/stellar-base 12.1.0 → 13.0.0-beta.1

package/lib/invocation.js

@@ -168,7 +168,8 @@ function buildInvocationTree(root) {
  * @param {xdr.SorobanAuthorizedInvocation} [parent]  this `node`s parent node,
  *    if any (i.e. this doesn't exist at the root)
  *
- * @returns {boolean?}   returning `false` is a hint to stop exploring
+ * @returns {boolean|null|void}   returning exactly `false` is a hint to stop
+ *    exploring, other values are ignored
  */
 
 /**

package/lib/operation.js

@@ -100,7 +100,12 @@ var AuthClawbackEnabledFlag = exports.AuthClawbackEnabledFlag = 1 << 3;
  * * `{@link Operation.setTrustLineFlags}`
  * * `{@link Operation.liquidityPoolDeposit}`
  * * `{@link Operation.liquidityPoolWithdraw}`
- * * `{@link Operation.invokeHostFunction}`
+ * * `{@link Operation.invokeHostFunction}`, which has the following additional
+ *   "pseudo-operations" that make building host functions easier:
+ *   - `{@link Operation.createStellarAssetContract}`
+ *   - `{@link Operation.invokeContractFunction}`
+ *   - `{@link Operation.createCustomContract}`
+ *   - `{@link Operation.uploadContractWasm}`
  * * `{@link Operation.extendFootprintTtlOp}`
  * * `{@link Operation.restoreFootprint}`
  *

package/lib/operations/invoke_host_function.js

@@ -97,7 +97,8 @@ function invokeContractFunction(opts) {
 }
 
 /**
- * Returns an operation that creates a custom WASM contract.
+ * Returns an operation that creates a custom WASM contract and atomically
+ * invokes its constructor.
  *
  * @function
  * @alias Operation.createCustomContract
@@ -107,6 +108,9 @@ function invokeContractFunction(opts) {
  * @param {Uint8Array|Buffer}  opts.wasmHash - the SHA-256 hash of the contract
  *    WASM you're uploading (see {@link hash} and
  *    {@link Operation.uploadContractWasm})
+ * @param {xdr.ScVal[]} [opts.constructorArgs] - the optional parameters to pass
+ *    to the constructor of this contract (see {@link nativeToScVal} for ways to
+ *    easily create these parameters from native JS values)
  * @param {Uint8Array|Buffer} [opts.salt] - an optional, 32-byte salt to
  *    distinguish deployment instances of the same wasm from the same user (if
  *    omitted, one will be generated for you)
@@ -121,6 +125,7 @@ function invokeContractFunction(opts) {
  * https://soroban.stellar.org/docs/fundamentals-and-concepts/invoking-contracts-with-transactions#function
  */
 function createCustomContract(opts) {
+  var _opts$constructorArgs;
   var salt = Buffer.from(opts.salt || getSalty());
   if (!opts.wasmHash || opts.wasmHash.length !== 32) {
     throw new TypeError("expected hash(contract WASM) in 'opts.wasmHash', got ".concat(opts.wasmHash));
@@ -131,12 +136,13 @@ function createCustomContract(opts) {
   return this.invokeHostFunction({
     source: opts.source,
     auth: opts.auth,
-    func: _xdr["default"].HostFunction.hostFunctionTypeCreateContract(new _xdr["default"].CreateContractArgs({
+    func: _xdr["default"].HostFunction.hostFunctionTypeCreateContractV2(new _xdr["default"].CreateContractArgsV2({
       executable: _xdr["default"].ContractExecutable.contractExecutableWasm(Buffer.from(opts.wasmHash)),
       contractIdPreimage: _xdr["default"].ContractIdPreimage.contractIdPreimageFromAddress(new _xdr["default"].ContractIdPreimageFromAddress({
         address: opts.address.toScAddress(),
         salt: salt
-      }))
+      })),
+      constructorArgs: (_opts$constructorArgs = opts.constructorArgs) !== null && _opts$constructorArgs !== void 0 ? _opts$constructorArgs : []
     }))
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellar/stellar-base",
-  "version": "12.1.0",
+  "version": "13.0.0-beta.1",
   "description": "Low-level support library for the Stellar network.",
   "main": "./lib/index.js",
   "browser": {
@@ -70,11 +70,11 @@
   },
   "homepage": "https://github.com/stellar/js-stellar-base",
   "devDependencies": {
-    "@babel/cli": "^7.24.8",
-    "@babel/core": "^7.24.9",
-    "@babel/eslint-parser": "^7.24.8",
-    "@babel/eslint-plugin": "^7.24.7",
-    "@babel/preset-env": "^7.24.8",
+    "@babel/cli": "^7.25.6",
+    "@babel/core": "^7.25.2",
+    "@babel/eslint-parser": "^7.25.1",
+    "@babel/eslint-plugin": "^7.25.1",
+    "@babel/preset-env": "^7.25.4",
     "@babel/register": "^7.24.6",
     "@definitelytyped/dtslint": "^0.0.182",
     "@istanbuljs/nyc-config-babel": "3.0.0",
@@ -88,7 +88,7 @@
     "eslint": "^8.57.0",
     "eslint-config-airbnb-base": "^15.0.0",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-import": "^2.30.0",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prefer-import": "^0.0.1",
     "eslint-plugin-prettier": "^5.2.1",
@@ -96,16 +96,16 @@
     "ghooks": "^2.0.4",
     "husky": "^8.0.3",
     "jsdoc": "^4.0.3",
-    "karma": "^6.4.3",
+    "karma": "^6.4.4",
     "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",
-    "lint-staged": "^15.2.7",
+    "lint-staged": "^15.2.10",
     "minami": "^1.1.1",
-    "mocha": "^10.6.0",
+    "mocha": "^10.7.3",
     "node-polyfill-webpack-plugin": "^3.0.0",
     "nyc": "^15.1.0",
     "prettier": "^3.3.3",
@@ -115,7 +115,7 @@
     "taffydb": "^2.7.3",
     "terser-webpack-plugin": "^5.3.10",
     "ts-node": "^10.9.2",
-    "typescript": "^5.5.3",
+    "typescript": "^5.6.2",
     "webpack": "^5.93.0",
     "webpack-cli": "^5.1.1"
   },