| 12345678910111213141516171819202122232425262728293031323334353637383940414243 |
- ---
- title: What's New in Entropy v2
- description: New features and improvements in Entropy v2
- icon: Sparkle
- ---
- ## Key Improvements
- Pyth Entropy v2 brings new features and improvements that make random number generation more flexible, efficient, and easier to integrate.
- ### 1. Multiple Request Variants
- Entropy v2 provides multiple ways to request random numbers:
- - **Basic Request**: Simplest implementation with default settings
- - **Custom Gas Limit**: Specify gas limits for complex callbacks
- - **Custom Provider**: Choose specific entropy providers
- - **Full Control**: Specify all parameters (provider, gas limit, user random number)
- Each of these request types is described in more detail with examples in [Request Callback Variants](./entropy/request-callback-variants).
- ### 2. Enhanced Callback Status
- Entropy V2 introduces callback statuses, which allow users to track the status of their callbacks.
- [Pyth Dev-Forum Announcement](https://dev-forum.pyth.network/t/announcing-entropy-v2/324#p-649-enhanced-callback-statuses-2) provides more details on enhanced callback statuses.
- ### 3. Entropy Explorer
- Entropy V2 includes a public Entropy Explorer, that lets teams easily track the status of their callbacks and re-request them if they fail on-chain.
- See [Entropy Explorer](https://entropy-explorer.pyth.network/) to search and debug your callbacks.
- ## Migration Guide
- If you're upgrading from Entropy v1 to v2:
- 1. Update your imports to use [`IEntropyV2`](https://github.com/pyth-network/pyth-crosschain/blob/main/target_chains/ethereum/entropy_sdk/solidity/IEntropyV2.sol).
- 2. Replace `request()` calls with [`requestV2()`](https://github.com/pyth-network/pyth-crosschain/blob/f5402df8e44158c519496bcd2fac5d3afe856a0e/target_chains/ethereum/entropy_sdk/solidity/IEntropyV2.sol#L26)
- 3. Update fee calculation to use [`getFeeV2()`](https://github.com/pyth-network/pyth-crosschain/blob/f5402df8e44158c519496bcd2fac5d3afe856a0e/target_chains/ethereum/entropy_sdk/solidity/IEntropyV2.sol#L135)
- 4. Test thoroughly with the new interface
- ## Backward Compatibility
- Entropy v2 maintains backward compatibility with v1 for existing applications. However, we recommend migrating to v2 for new applications to take advantage of the improved features.
|