rebase: Merge develop to main

.github/workflows/bump-version.yml

@@ -26,7 +26,7 @@ jobs:
       - name: ⚙️ Setup Node.js
         uses: actions/setup-node@v2
         with:
-          node-version: '16'
+          node-version: '20.x'
           cache: 'npm'
 
       - name: 🧰 Install

.github/workflows/release.yml

@@ -19,10 +19,10 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: ⚙️ Setup Node.js v16
+      - name: ⚙️ Setup Node.js 20.x
         uses: actions/setup-node@v2
         with:
-          node-version: '16.x'
+          node-version: '20.x'
           registry-url: 'https://registry.npmjs.org'
           scope: '@erc725'
           cache: 'npm'

.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+node = "20"

.mocharc.json

@@ -2,5 +2,9 @@
   "extension": ["ts"],
   "spec": "src/**/*.test.ts",
   "require": "ts-node/register",
-  "timeout": 20000
+  "timeout": 20000,
+  "node-option": [
+    "experimental-specifier-resolution=node",
+    "loader=ts-node/esm"
+  ]
 }

.node-version

@@ -1 +1 @@
-18.19.0
+20.5.1

.tool-versions

@@ -0,0 +1 @@
+nodejs 20.x

docs/methods.md

@@ -3,6 +3,10 @@ sidebar_position: 1
 title: 'Methods'
 ---
 
+import CodeSandbox from "../../../src/components/CodeSandbox";
+
+<CodeSandbox />
+
 ## Encoding
 
 ### encodeData
@@ -92,6 +96,40 @@ After the `data` is encoded, the object is ready to be stored in smart contracts
 
 #### Examples
 
+<details>
+  <summary>**Encode** a <code>Singleton</code> data key</summary>
+
+```javascript title="encode a Singleton data key of valueContent Address"
+import ERC725 from '@erc725/erc725.js';
+
+const schemas = [
+  {
+    name: 'LSP1UniversalReceiverDelegate',
+    key: '0x0cfc51aec37c55a4d0b1a65c6255c4bf2fbdf6277f3cc0730c45b828b6db8b47',
+    keyType: 'Singleton',
+    valueType: 'address',
+    valueContent: 'Address',
+  },
+];
+
+const myErc725 = new ERC725(schemas);
+
+myErc725.encodeData([
+  {
+    keyName: 'LSP1UniversalReceiverDelegate',
+    value: '0x1183790f29BE3cDfD0A102862fEA1a4a30b3AdAb',
+  },
+]);
+/**
+{
+  keys: ['0x0cfc51aec37c55a4d0b1a65c6255c4bf2fbdf6277f3cc0730c45b828b6db8b47'],
+  values: ['0x1183790f29be3cdfd0a102862fea1a4a30b3adab'],
+}
+*/
+```
+
+</details>
+
 <details>
     <summary>Encode a <code>VerifiableURI</code> with JSON and uploaded URL</summary>
 
@@ -162,39 +200,10 @@ myErc725.encodeData([
 */
 ```
 
-```javascript title="encode a Singleton data key of valueContent Address"
-import ERC725 from '@erc725/erc725.js';
-
-const schemas = [
-  {
-    name: 'LSP1UniversalReceiverDelegate',
-    key: '0x0cfc51aec37c55a4d0b1a65c6255c4bf2fbdf6277f3cc0730c45b828b6db8b47',
-    keyType: 'Singleton',
-    valueType: 'address',
-    valueContent: 'Address',
-  },
-];
-
-const myErc725 = new ERC725(schemas);
-
-myErc725.encodeData([
-  {
-    keyName: 'LSP1UniversalReceiverDelegate',
-    value: '0x1183790f29BE3cDfD0A102862fEA1a4a30b3AdAb',
-  },
-]);
-/**
-{
-  keys: ['0x0cfc51aec37c55a4d0b1a65c6255c4bf2fbdf6277f3cc0730c45b828b6db8b47'],
-  values: ['0x1183790f29be3cdfd0a102862fea1a4a30b3adab'],
-}
-*/
-```
-
 </details>
 
 <details>
-    <summary>Encode a <code>VerifiableURI</code> with hash function, hash and uploaded URL</summary>
+    <summary>**Encode** a <code>VerifiableURI</code> with hash function, hash and uploaded URL</summary>
 
 ```javascript title="Encode a VerifiableURI with hash function, hash and uploaded URL"
 import ERC725 from '@erc725/erc725.js';
@@ -459,6 +468,46 @@ myErc725.encodeData(
 
 </details>
 
+<details>
+    <summary>Encode a tuple for <code>valueType</code> / <code>valueContent</code></summary>
+
+```javascript title="Encode a tuple for valueType / valueContent"
+import ERC725 from '@erc725/erc725.js';
+
+const schemas = [
+  {
+    name: 'LSP4CreatorsMap:<address>',
+    key: '0x6de85eaf5d982b4e5da00000<address>',
+    keyType: 'Mapping',
+    valueType: '(bytes4,uint128)',
+    valueContent: '(Bytes4,Number)',
+  },
+];
+
+ERC725.encodeData(
+  [
+    {
+      keyName: 'LSP4CreatorsMap:<address>',
+      dynamicKeyParts: "0xcafecafecafecafecafecafecafecafecafecafe"
+      value: ['0x24871b3d', '11'],
+    },
+  ],
+  schemas,
+);
+/**
+{
+  keys: [
+    '0xdf30dba06db6a30e65354d9a64c609861f089545ca58c6b4dbe31a5f338cb0e3', // -> data key for `LSP4CreatorsMap:0xcafecafecafecafecafecafecafecafecafecafe`
+  ],
+  values: [
+    '0x24871b3d0000000000000000000000000000000b', // (bytes4,uint128)
+  ],
+}
+*/
+```
+
+</details>
+
 ---
 
 ### encodeKeyName
@@ -884,6 +933,38 @@ myErc725.decodeData(
 
 ---
 
+#### Tuple Example
+
+```javascript title="Decode a key with tuple as valueType / valueContent"
+import ERC725 from '@erc725/erc725.js';
+
+const schemas = [
+  {
+    name: 'LSP4CreatorsMap:<address>',
+    key: '0x6de85eaf5d982b4e5da00000<address>',
+    keyType: 'Mapping',
+    valueType: '(bytes4,uint128)',
+    valueContent: '(Bytes4,Number)',
+  },
+];
+
+ERC725.decodeData(
+    {
+      keyName: 'LSP4CreatorsMap:<address>',
+      dynamicKeyParts: "0xcafecafecafecafecafecafecafecafecafecafe"
+      value: "0x24871b3d0000000000000000000000000000000b",
+    },
+  schemas,
+);
+/**
+{
+    key: '0x6de85eaf5d982b4e5da00000cafecafecafecafecafecafecafecafecafecafe',
+    name: 'LSP4CreatorsMap:cafecafecafecafecafecafecafecafecafecafe',
+    value: ['0x24871b3d', 11]
+}
+*/
+```
+
 ### decodeValueType
 
 ```js