Cardano Updates

Implements extensive test coverage for the ToJSON and FromJSON instances
of TxOut across all eras and contexts, ensuring robust JSON serialization
and deserialization behavior.

Test modules added:
- Test.Cardano.Api.TxOut.Gen: Specialized generators for TxOut with specific
  datum types (no datum, datum hash, supplemental, inline) and invalid JSON
  scenarios for error testing
- Test.Cardano.Api.TxOut.Helpers: Test utilities including JSON field
  assertions, parse failure validators, and datum equality checks
- Test.Cardano.Api.TxOut.Json: Main test module organizing all test suites
- Test.Cardano.Api.TxOut.JsonRoundtrip: Roundtrip property tests for all
  eras (Shelley through Conway) in both CtxTx and CtxUTxO contexts
- Test.Cardano.Api.TxOut.JsonEdgeCases: Edge case tests for supplemental
  datum behavior, null field handling, and ToJSON output validation
- Test.Cardano.Api.TxOut.JsonErrorCases: Error case tests for conflicting
  datums, mismatched hashes, partial fields, and invalid data

Coverage highlights:
- All eras from Byron through Dijkstra (where supported)
- Both transaction contexts (CtxTx and CtxUTxO)
- All datum types including edge cases like supplemental datums
- Comprehensive error handling validation
- JSON field presence and null handling verification

This test suite ensures the TxOut JSON instances maintain backward
compatibility while properly handling the complex datum type variations
across different Cardano eras.

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Chris Gianelloni <[email protected]>

refactor(internal): improve clarity and maintainability of alonzoTxOutParser

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Chris Gianelloni <[email protected]>

Refactor the case expression to return a tuple of (TxOutDatum, ReferenceScript)
instead of constructing TxOut in each branch.

Refactors the alonzoTxOutParser function to enhance code readability and
maintainability by introducing clearer variable names and improving the
logical flow of datum field parsing.

Key improvements:
- Rename ambiguous variables (mDatumVal -> mDatumJson, dVal -> datumJson)
  to clearly indicate they contain JSON representations of datum values
- Add descriptive comments explaining each datum parsing case:
  * No datum information (Nothing, Nothing)
  * Datum hash only (Nothing, Just hash)
  * Both hash and JSON for supplemental datum (Just json, Just hash)
  * Invalid state with JSON but no hash (Just json, Nothing)
- Extract datum parsing into a dedicated section, separating it from
  reference script handling for better code organization
- Use more descriptive variable names (parsedAddress, parsedValue) to
  distinguish parsed results from raw JSON fields

Signed-off-by: Chris Gianelloni <[email protected]>

- Add gouroboros CBOR integration with DecodeStoreCbor for repeated decodes
- Implement buffer pooling for JSON marshaling optimization
- Optimize PrintLoadedKeys with bytes.Buffer to reduce allocations
- Pre-allocate slices in LoadWalletDir to reduce allocations
- Update CBOR encoding to use tagged arrays [0, key_data] per Shelley spec
- Change NewWallet accountId to uint32 with bounds checking
- Improve error handling to skip corrupted files instead of failing

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Chris Gianelloni <[email protected]>

Signed-off-by: Aurora Gaffney <[email protected]>