@@ -14,24 +14,24 @@ interface EntropyEventsV2 {
1414 /**
1515 * @notice Emitted when a new provider registers with the Entropy system
1616 * @param provider The address of the registered provider
17- * @param dummy Additional data field (unused)
17+ * @param extraArgs A field for extra data for forward compatibility.
1818 */
19- event Registered (address indexed provider , bytes dummy );
19+ event Registered (address indexed provider , bytes extraArgs );
2020
2121 /**
2222 * @notice Emitted when a user requests a random number from a provider
2323 * @param provider The address of the provider handling the request
2424 * @param caller The address of the user requesting the random number
2525 * @param sequenceNumber A unique identifier for this request
2626 * @param userRandomNumber A random number provided by the user for additional entropy
27- * @param dummy Additional data field (unused)
27+ * @param extraArgs A field for extra data for forward compatibility.
2828 */
2929 event Requested (
3030 address indexed provider ,
3131 address indexed caller ,
3232 uint64 indexed sequenceNumber ,
3333 bytes32 userRandomNumber ,
34- bytes dummy
34+ bytes extraArgs
3535 );
3636
3737 /**
@@ -41,101 +41,102 @@ interface EntropyEventsV2 {
4141 * @param sequenceNumber The unique identifier of the request
4242 * @param randomNumber The generated random number
4343 * @param callbackFailed Whether the callback to the caller failed
44- * @param callbackErrorCode If the callback failed, the error code from the callback. Note
45- * that "" often indicates an out-of-gas error.
46- * @param dummy Additional data field (unused)
44+ * @param callbackReturnValue Return value from the callback. If the callback failed, this field contains
45+ * the error code and any additional returned data. Note that "" often indicates an out-of-gas error.
46+ * If the callback returns more than 256 bytes, only the first 256 bytes of the callback return value are included.
47+ * @param extraArgs A field for extra data for forward compatibility.
4748 */
4849 event Revealed (
4950 address indexed provider ,
5051 address indexed caller ,
5152 uint64 indexed sequenceNumber ,
5253 bytes32 randomNumber ,
5354 bool callbackFailed ,
54- bytes callbackErrorCode ,
55- bytes dummy
55+ bytes callbackReturnValue ,
56+ bytes extraArgs
5657 );
5758
5859 /**
5960 * @notice Emitted when a provider updates their fee
6061 * @param provider The address of the provider updating their fee
6162 * @param oldFee The previous fee amount
6263 * @param newFee The new fee amount
63- * @param dummy Additional data field (unused)
64+ * @param extraArgs A field for extra data for forward compatibility.
6465 */
6566 event ProviderFeeUpdated (
6667 address indexed provider ,
6768 uint128 oldFee ,
6869 uint128 newFee ,
69- bytes dummy
70+ bytes extraArgs
7071 );
7172
7273 /**
7374 * @notice Emitted when a provider updates their default gas limit
7475 * @param provider The address of the provider updating their gas limit
7576 * @param oldDefaultGasLimit The previous default gas limit
7677 * @param newDefaultGasLimit The new default gas limit
77- * @param dummy Additional data field (unused)
78+ * @param extraArgs A field for extra data for forward compatibility.
7879 */
7980 event ProviderDefaultGasLimitUpdated (
8081 address indexed provider ,
8182 uint32 oldDefaultGasLimit ,
8283 uint32 newDefaultGasLimit ,
83- bytes dummy
84+ bytes extraArgs
8485 );
8586
8687 /**
8788 * @notice Emitted when a provider updates their URI
8889 * @param provider The address of the provider updating their URI
8990 * @param oldUri The previous URI
9091 * @param newUri The new URI
91- * @param dummy Additional data field (unused)
92+ * @param extraArgs A field for extra data for forward compatibility.
9293 */
9394 event ProviderUriUpdated (
9495 address indexed provider ,
9596 bytes oldUri ,
9697 bytes newUri ,
97- bytes dummy
98+ bytes extraArgs
9899 );
99100
100101 /**
101102 * @notice Emitted when a provider updates their fee manager address
102103 * @param provider The address of the provider updating their fee manager
103104 * @param oldFeeManager The previous fee manager address
104105 * @param newFeeManager The new fee manager address
105- * @param dummy Additional data field (unused)
106+ * @param extraArgs A field for extra data for forward compatibility.
106107 */
107108 event ProviderFeeManagerUpdated (
108109 address indexed provider ,
109110 address oldFeeManager ,
110111 address newFeeManager ,
111- bytes dummy
112+ bytes extraArgs
112113 );
113114
114115 /**
115116 * @notice Emitted when a provider updates their maximum number of hashes that can be advanced
116117 * @param provider The address of the provider updating their max hashes
117118 * @param oldMaxNumHashes The previous maximum number of hashes
118119 * @param newMaxNumHashes The new maximum number of hashes
119- * @param dummy Additional data field (unused)
120+ * @param extraArgs A field for extra data for forward compatibility.
120121 */
121122 event ProviderMaxNumHashesAdvanced (
122123 address indexed provider ,
123124 uint32 oldMaxNumHashes ,
124125 uint32 newMaxNumHashes ,
125- bytes dummy
126+ bytes extraArgs
126127 );
127128
128129 /**
129130 * @notice Emitted when a provider withdraws their accumulated fees
130131 * @param provider The address of the provider withdrawing fees
131132 * @param recipient The address receiving the withdrawn fees
132133 * @param withdrawnAmount The amount of fees withdrawn
133- * @param dummy Additional data field (unused)
134+ * @param extraArgs A field for extra data for forward compatibility.
134135 */
135136 event Withdrawal (
136137 address indexed provider ,
137138 address indexed recipient ,
138139 uint128 withdrawnAmount ,
139- bytes dummy
140+ bytes extraArgs
140141 );
141142}
0 commit comments