Merge pull request #14 from no-witness-labs/feat/update-mdx-1

docs: update mdx

Author: solidsnakedev

docs/pages/getting-started/_meta.json

@@ -0,0 +1,26 @@
+# Address
+
+Address module provides functionality for working with address types in Cardano.
+
+## Address Example
+
+```typescript
+import { Address } from "@evolution-sdk/evolution"
+
+const hexAddress = "60ba1d6b6283c219a0530e3682c316215d55819cf97bbf26552c6f8530"
+const expectedBech32 = "addr_test1vzap66mzs0ppngznpcmg9scky9w4tqvul9am7fj493hc2vq4ry02m"
+
+// Decode from hex
+const address = Address.Codec.Decode.hex(hexAddress)
+
+// Encode to bech32
+const actualBech32 = Address.Codec.Encode.bech32(address)
+
+// Verify the conversion is correct
+assert(actualBech32 === expectedBech32)
+
+```
+
+## API Reference
+
+For detailed API documentation, see the generated TypeDoc documentation.

docs/pages/getting-started/address.mdx

@@ -0,0 +1,87 @@
+# Data
+
+Data module provides functionality for working with data types in Cardano.
+
+## Data Example
+
+```typescript
+import { Data } from "@evolution-sdk/evolution"
+
+// Create a complex nested data structure with:
+// - Constructor with index 1 containing multiple fields
+// - Nested constructors with different indices
+// - A Map with mixed key-value pairs
+// - An array of numbers
+const nestedUnsortedData = new Data.Constr({
+  index: 1n,
+  fields: [
+    // Nested constructor: 121_0([123_0([])])
+    new Data.Constr({
+      index: 0n,
+      fields: [
+        new Data.Constr({
+          index: 2n,
+          fields: []
+        })
+      ]
+    }),
+    // Map with unsorted keys (will be sorted in canonical mode)
+    new Map<Data.Data, Data.Data>([
+      ["deadbeef01", new Data.Constr({ index: 0n, fields: [] })],
+      ["beef", 19n],
+      ["deadbeef03", new Data.Constr({ index: 1n, fields: [] })]
+    ]),
+    // Array of numbers
+    [10n, 5n, 2n, 3n, 1n, 4n]
+  ]
+})
+
+// Encode using default codec (indefinite-length encoding)
+const cborHex = Data.Codec().Encode.cborHex(nestedUnsortedData)
+// Output: d87a9fd8799fd87b80ffbf45deadbeef01d8798042beef1345deadbeef03d87a80ff9f0a0502030104ffff
+
+// CBOR diagnostic notation (indefinite-length):
+// 122_0([_
+//     121_0([_ 123_0([])]),
+//     {_
+//         h'deadbeef01': 121_0([]),
+//         h'beef': 19,
+//         h'deadbeef03': 122_0([]),
+//     },
+//     [_ 10, 5, 2, 3, 1, 4],
+// ])
+// Visualize at: https://cbor.nemo157.com/
+
+const decodedData = Data.Codec().Decode.cborHex(cborHex)
+
+// Create a canonical codec for deterministic encoding
+// This ensures consistent output and sorted map keys
+const canonicalCodec = Data.Codec({
+  options: {
+    mode: "canonical"
+  }
+})
+
+// Encode using canonical mode (definite-length, sorted keys)
+const canonicalCborHex = canonicalCodec.Encode.cborHex(nestedUnsortedData)
+// Output: d87a83d87981d87b80a342beef1345deadbeef01d8798045deadbeef03d87a80860a0502030104
+
+// CBOR diagnostic notation (canonical/definite-length):
+// 122_0([
+//     121_0([123_0([])]),
+//     {
+//         h'beef': 19,                    ← Keys are now sorted
+//         h'deadbeef01': 121_0([]),
+//         h'deadbeef03': 122_0([]),
+//     },
+//     [10, 5, 2, 3, 1, 4],              ← Definite-length array
+// ])
+
+// Verify that decoding works correctly
+assert.deepStrictEqual(decodedData, nestedUnsortedData, "Decoded data should match original")
+
+```
+
+## API Reference
+
+For detailed API documentation, see the generated TypeDoc documentation.