Merge pull request #27 from multiversx/update-31

Extra examples: counted variadic parameters

Author: andreibancioiu

cookbook/contracts_04_interactions.js

@@ -50,7 +50,7 @@ let tx2 = interaction
 // ```
 import { AbiRegistry } from "@multiversx/sdk-core";
 
-const abiRegistry = AbiRegistry.create({
+let abiRegistry = AbiRegistry.create({
     "endpoints": [
         {
             "name": "foobar",
@@ -84,6 +84,47 @@ let tx3 = contract.methods.doSomethingWithValue([1, 2, 3])
     .buildTransaction();
 // ```
 
+// Now let's see an example using variadic arguments, as well:
+
+// ```
+import { StringValue, VariadicValue } from "@multiversx/sdk-core";
+
+abiRegistry = AbiRegistry.create({
+    "endpoints": [
+        {
+            "name": "foobar",
+            "inputs": [],
+            "outputs": []
+        },
+        {
+            "name": "doSomething",
+            "inputs": [{
+                "type": "counted-variadic<utf-8 string>"
+            },
+            {
+                "type": "variadic<u64>"
+            }],
+            "outputs": []
+        }
+    ]
+});
+
+contract = new SmartContract({ address: contractAddress, abi: abiRegistry });
+
+let tx4 = contract.methods.doSomething(
+    [
+        // Counted variadic must be explicitly typed // md-as-comment
+        VariadicValue.fromItemsCounted(StringValue.fromUTF8("foo"), StringValue.fromUTF8("bar")),
+        // Regular variadic can be implicitly typed // md-as-comment
+        1, 2, 3
+    ])
+    .withSender(addressOfAlice)
+    .withNonce(45)
+    .withGasLimit(20000000)
+    .withChainID("D")
+    .buildTransaction();
+// ```
+
 // ### Transfer & execute
 
 // Given an interaction:

cookbook/generate.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 from typing import List
 
-current_dir = Path(__file__).parent
+current_dir = Path(__file__).parent.absolute()
 
 input_files = [
     current_dir / "basic.js",
@@ -22,7 +22,7 @@
 
 def main():
     for input_file in input_files:
-        output_file = current_dir / "generated" / input_file.with_suffix(".md")
+        output_file = current_dir / "generated" / input_file.with_suffix(".md").name
         render_file(input_file, output_file)
 
 

cookbook/generated/contracts_04_interactions.md

@@ -47,7 +47,7 @@ Then, sign, broadcast `tx` and wait for its completion.
 ```
 import { AbiRegistry } from "@multiversx/sdk-core";
 
-const abiRegistry = AbiRegistry.create({
+let abiRegistry = AbiRegistry.create({
     "endpoints": [
         {
             "name": "foobar",
@@ -81,6 +81,47 @@ let tx3 = contract.methods.doSomethingWithValue([1, 2, 3])
     .buildTransaction();
 ```
 
+Now let's see an example using variadic arguments, as well:
+
+```
+import { StringValue, VariadicValue } from "@multiversx/sdk-core";
+
+abiRegistry = AbiRegistry.create({
+    "endpoints": [
+        {
+            "name": "foobar",
+            "inputs": [],
+            "outputs": []
+        },
+        {
+            "name": "doSomething",
+            "inputs": [{
+                "type": "counted-variadic<utf-8 string>"
+            },
+            {
+                "type": "variadic<u64>"
+            }],
+            "outputs": []
+        }
+    ]
+});
+
+contract = new SmartContract({ address: contractAddress, abi: abiRegistry });
+
+let tx4 = contract.methods.doSomething(
+    [
+        // Counted variadic must be explicitly typed 
+        VariadicValue.fromItemsCounted(StringValue.fromUTF8("foo"), StringValue.fromUTF8("bar")),
+        // Regular variadic can be implicitly typed 
+        1, 2, 3
+    ])
+    .withSender(addressOfAlice)
+    .withNonce(45)
+    .withGasLimit(20000000)
+    .withChainID("D")
+    .buildTransaction();
+```
+
 ### Transfer & execute
 
 Given an interaction:

cookbook/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "dependencies": {
         "@multiversx/sdk-wallet": "4.0.0",
-        "@multiversx/sdk-core": "12.1.0",
+        "@multiversx/sdk-core": "12.8.0",
         "@multiversx/sdk-network-providers": "1.3.0",
         "axios": "1.3.4"
     }