docs: document struct coded and add examples

src/SUMMARY.md

@@ -265,3 +265,4 @@
       - [`addr`](./cheatcodes/addr.md)
       - [`sign`](./cheatcodes/sign.md)
       - [`label`](./cheatcodes/label.md)
+- [Misc](./misc/README.md)

src/misc/README.md

@@ -0,0 +1,3 @@
+## Misc
+
+- [struct encoding](./struct-encoding.md)

src/misc/struct-encoding.md

@@ -0,0 +1,64 @@
+#### Struct Encoding
+
+Structs are custom defined types that can group several variables:
+
+```solidity
+struct MyStruct {
+    address addr;
+    uint256 amount;
+}
+```
+
+Only the new [ABI coder v2](https://docs.soliditylang.org/en/latest/layout-of-source-files.html#abi-coder-pragma) can encode and decode arbitrarily nested arrays and structs. Since Solidity 0.8.0 it is activated by default, prior to that it needs to be activated via `pragma experimental ABIEncoderV2`.
+
+Structs map to the ABI type "tuple", See also [Mapping Solidity to ABI types](https://docs.soliditylang.org/en/latest/abi-spec.html#mapping-solidity-to-abi-types)
+
+Structs are therefor encoded and decodes as tuples. So `MyStruct` is a `(address,uint256)` tuple when it comes to the ABI spec.
+
+For example the ABI of
+
+```solidity
+pragma solidity =0.8.15;
+
+
+contract Test {
+    struct MyStruct {
+        address addr;
+        uint256 amount;
+    }
+    function f(MyStruct memory t) public pure {}
+}
+```
+
+results in the following ABI json object:
+
+```json
+{
+	"inputs": [
+		{
+			"components": [
+				{
+					"internalType": "address",
+					"name": "addr",
+					"type": "address"
+				},
+				{
+					"internalType": "uint256",
+					"name": "amount",
+					"type": "uint256"
+				}
+			],
+			"internalType": "struct Test.MyStruct",
+			"name": "t",
+			"type": "tuple"
+		}
+	],
+	"name": "f",
+	"outputs": [],
+	"stateMutability": "pure",
+	"type": "function"
+}
+```
+
+which reads:
+The function `f` takes 1 input of type `tuple` with two components of type `address` and `uint256`.

src/reference/cast/cast-send.md

@@ -52,6 +52,23 @@ The destination (*to*) can be an ENS name or an address.
     cast send --ledger 0x... "deposit(address,uint256)" 0x... 1
     ```
 
+3. Call a function that expects a `struct`:
+
+    ```solidity
+    contract Test {
+        struct MyStruct {
+            address addr;
+            uint256 amount;
+        }
+        function myfunction(MyStruct memory t) public pure {}
+    }
+    ```
+
+Structs are encoded as tuples, See [struct encoding](./reference/common/struct-encoding.md)
+
+```sh
+cast send --ledger 0x... "myfunction((address,uint256))" 0x... 1
+```
 ### SEE ALSO
 
-[cast](./cast.md), [cast call](./cast-call.md), [cast publish](./cast-publish.md), [cast receipt](./cast-receipt.md)
+[cast](./cast.md), [cast call](./cast-call.md), [cast publish](./cast-publish.md), [cast receipt](./cast-receipt.md), [struct encoding](./misc/struct-encoding.md)

src/reference/cast/cast-sig.md

@@ -25,6 +25,23 @@ The signature (*sig*) is a fragment in the form `<function name>(<types...>)`.
     cast sig "transfer(address,uint256)"
     ```
 
+2. Get the selector for a function that expects a `struct`:
+
+    ```solidity
+    contract Test {
+        struct MyStruct {
+            address addr;
+            uint256 amount;
+        }
+        function myfunction(MyStruct memory t) public pure {}
+    }
+    ```
+
+Structs are encoded as tuples, See [struct encoding](./reference/common/struct-encoding.md)
+
+```sh
+cast sig "myfunction((address,uint256))"
+```
 ### SEE ALSO
 
-[cast](./cast.md)
+[cast](./cast.md), [struct encoding](./misc/struct-encoding.md)