Known Issues / FAQ
This page documents known issues, workarounds, and frequently asked questions about Yaci DevKit.
Known Issues
Plutus V2 Script Data Hash Mismatch (v0.11.0-beta1+)
Issue: Plutus V2 transactions may fail with "script data hash mismatch" exception when using Lucid Evolution or other off-chain SDKs.
Background
In Yaci DevKit v0.11.0-beta1 and later, two configuration flags are commented out by default in config/node.properties
:
# conwayHardForkAtEpoch=1
# shiftStartTimeBehind=true
These flags were previously used as a workaround to avoid extra cost model entries in Plutus V2 when the Conway hard fork happens at epoch 0. The workaround manipulated the devnet start time to move to epoch 1, avoiding 10 extra entries in the Plutus V2 cost model in protocol parameters.
Current Behavior With Default Configuration
- Plutus V3 transactions: Work perfectly ✅
- Regular transactions: Work perfectly ✅
- Plutus V2 with Cardano Client Lib: Works perfectly ✅
- Plutus V2 with Lucid Evolution: May fail with script data hash mismatch ❌
Root Cause
The default configuration works fine with Cardano Client Lib for all Plutus versions (including Plutus V2) because Cardano Client Lib fetches the cost model directly from the node to calculate script data hash for script transactions.
However, Plutus V2 scripts fail with Lucid Evolution using the default configuration. The issue appears to be related to hardcoded cost models that don't match the current protocol parameters when Conway hard fork occurs at epoch 0.
Workaround
If you need to use Plutus V2 with Lucid Evolution or other off-chain SDKs, enable the workaround flags:
-
Edit your node configuration file:
- Docker distribution:
config/node.properties
- Zip distribution:
config/node.properties
- Docker distribution:
-
Uncomment and enable the flags:
conwayHardForkAtEpoch=1 shiftStartTimeBehind=true
-
Restart your devnet to apply the changes
Trade-off: Enabling these flags may cause issues with rewards or AdaPot calculations, but allows Plutus V2 transactions to work correctly.
More Information
For technical details about this issue, see: GitHub Issue #65 (opens in a new tab)
Getting Help
If you encounter issues not covered here:
- Check the documentation: Verify you're following the correct setup for your distribution
- Search existing issues: GitHub Issues (opens in a new tab)
- Join the community: Discord (opens in a new tab)
- Report a bug: Create new issue (opens in a new tab)