Update README

Author: cffls

README.md

@@ -45,9 +45,10 @@ could be beneficial for faster R&D iterations.
 - [X] Reward withdraw
 - [X] Mnemonic 
 - [X] HD Wallet
+- [x] Pool certificate
+- [x] Protocol proposal update
+- [x] Governance actions
 - [ ] Byron Address
-- [ ] Pool certificate
-- [ ] Protocol proposal update
 
 
 ### Installation
@@ -56,17 +57,21 @@ Install the library using [pip](https://pip.pypa.io/en/stable/):
 
 `pip install pycardano`
 
-### Documentation
+#### Install cbor2 pure python implementation (Optional)
+[cbor2](https://github.com/agronholm/cbor2/tree/master) is a dependency of pycardano. It is used to encode and decode CBOR data.
+It has two implementations: one is pure Python and the other is C, which is installed by default. The C implementation is faster, but it is less flexible than the pure Python implementation.
 
-https://pycardano.readthedocs.io/en/latest/
+For some users, the C implementation may not work properly when deserializing cbor data. For example, the order of inputs of a transaction isn't guaranteed to be the same as the order of inputs in the original transaction (details could be found in [this issue](https://github.com/Python-Cardano/pycardano/issues/311)). This would result in a different transaction hash when the transaction is serialized again. For users who encounter this issue, we recommend to use the pure Python implementation of cbor2. You can do so by running [ensure_pure_cbor2.sh](./ensure_pure_cbor2.sh), which inspect the cbor2 installed in the running environment and force install pure python implementation if necessary.
 
-### Examples
+```bash
+ensure_pure_cbor2.sh
+```
 
-#### Full stack DApp
+### Documentation
 
-A full stack testnet DApp is hosted on replit: https://pycardano.cffls.repl.co/
+https://pycardano.readthedocs.io/en/latest/
 
-To learn more details, go to the [DApp page](https://github.com/Python-Cardano/pycardano/tree/main/examples/full_stack).
+### Examples
 
 #### Transaction creation and signing
 
@@ -161,8 +166,9 @@ context.submit_tx(signed_tx)
 ```
 </details>
 
-See more usages under [examples](https://github.com/Python-Cardano/pycardano/tree/main/examples).
+See more usages under project [examples](https://github.com/Python-Cardano/pycardano/tree/main/examples).
 
+There is also a collection of examples under [awesome-pycardano](https://github.com/B3nac/awesome-pycardano).
 
 ### Development
 

ensure_pure_cbor2.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Script to ensure cbor2 is installed with pure Python implementation
+
+set -e
+
+# Check if poetry is available, otherwise use python directly
+if command -v poetry &> /dev/null; then
+    PYTHON="poetry run python"
+else
+    PYTHON="python"
+fi
+
+echo "Checking cbor2 version..."
+$PYTHON -c "from importlib.metadata import version; print(version('cbor2'))" > .cbor2_version
+CBOR2_VERSION=$(cat .cbor2_version)
+echo "Found cbor2 version: $CBOR2_VERSION"
+
+echo "Checking cbor2 implementation..."
+$PYTHON -c "
+import cbor2, inspect, sys
+decoder_path = inspect.getfile(cbor2.CBORDecoder)
+using_c_ext = decoder_path.endswith('.so')
+print(f'Implementation path: {decoder_path}')
+print(f'Using C extension: {using_c_ext}')
+sys.exit(1 if using_c_ext else 0)
+"
+
+if [ $? -ne 0 ]; then
+    echo "Reinstalling cbor2 with pure Python implementation..."
+    $PYTHON -m pip uninstall -y cbor2
+    CBOR2_BUILD_C_EXTENSION=0 $PYTHON -m pip install --no-binary cbor2 "cbor2==$CBOR2_VERSION" --force-reinstall
+    echo "Successfully reinstalled cbor2 with pure Python implementation"
+else
+    echo "Already using pure Python implementation of cbor2"
+fi
+
+# Clean up
+rm -f .cbor2_version