@stellar/stellar-base 12.1.1 → 13.0.0

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.1",
+  "version": "13.0.0",
   "description": "Low-level support library for the Stellar network.",
   "main": "./lib/index.js",
   "browser": {
@@ -70,17 +70,17 @@
   },
   "homepage": "https://github.com/stellar/js-stellar-base",
   "devDependencies": {
-    "@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",
+    "@babel/cli": "^7.25.9",
+    "@babel/core": "^7.26.0",
+    "@babel/eslint-parser": "^7.25.9",
+    "@babel/eslint-plugin": "^7.25.9",
+    "@babel/preset-env": "^7.26.0",
+    "@babel/register": "^7.25.9",
     "@definitelytyped/dtslint": "^0.0.182",
     "@istanbuljs/nyc-config-babel": "3.0.0",
     "@types/node": "^20.14.11",
     "@typescript-eslint/parser": "^6.20.0",
-    "babel-loader": "^9.1.3",
+    "babel-loader": "^9.2.1",
     "babel-plugin-istanbul": "^6.1.1",
     "chai": "^4.3.10",
     "chai-as-promised": "^7.1.2",
@@ -88,14 +88,14 @@
     "eslint": "^8.57.0",
     "eslint-config-airbnb-base": "^15.0.0",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.30.0",
+    "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prefer-import": "^0.0.1",
     "eslint-plugin-prettier": "^5.2.1",
     "eslint-webpack-plugin": "^4.2.0",
     "ghooks": "^2.0.4",
     "husky": "^8.0.3",
-    "jsdoc": "^4.0.3",
+    "jsdoc": "^4.0.4",
     "karma": "^6.4.4",
     "karma-chrome-launcher": "^3.1.0",
     "karma-coverage": "^2.2.1",
@@ -105,7 +105,7 @@
     "karma-webpack": "^5.0.1",
     "lint-staged": "^15.2.10",
     "minami": "^1.1.1",
-    "mocha": "^10.7.3",
+    "mocha": "^10.8.2",
     "node-polyfill-webpack-plugin": "^3.0.0",
     "nyc": "^15.1.0",
     "prettier": "^3.3.3",
@@ -115,8 +115,8 @@
     "taffydb": "^2.7.3",
     "terser-webpack-plugin": "^5.3.10",
     "ts-node": "^10.9.2",
-    "typescript": "^5.6.2",
-    "webpack": "^5.93.0",
+    "typescript": "^5.6.3",
+    "webpack": "^5.96.1",
     "webpack-cli": "^5.1.1"
   },
   "dependencies": {
@@ -128,6 +128,6 @@
     "tweetnacl": "^1.0.3"
   },
   "optionalDependencies": {
-    "sodium-native": "^4.1.1"
+    "sodium-native": "^4.3.0"
   }
 }