diff --git a/target_chains/ethereum/contracts/contracts/entropy/Entropy.sol b/target_chains/ethereum/contracts/contracts/entropy/Entropy.sol index 5305e09c..5e141277 100644 --- a/target_chains/ethereum/contracts/contracts/entropy/Entropy.sol +++ b/target_chains/ethereum/contracts/contracts/entropy/Entropy.sol @@ -363,10 +363,10 @@ abstract contract Entropy is IEntropy, EntropyState { clearRequest(provider, sequenceNumber); } - // Fulfill a request for a random number and call back the requester. This method validates the provided userRandomness + // Fulfill a request for a random number. This method validates the provided userRandomness // and provider's revelation against the corresponding commitment in the in-flight request. If both values are validated // and the requestor address is a contract address, this function calls the requester's entropyCallback method with the - // sequence number and the random number as arguments. Else if the requestor is an EOA, it won't call it. + // sequence number, provider address and the random number as arguments. Else if the requestor is an EOA, it won't call it. // // Note that this function can only be called once per in-flight request. Calling this function deletes the stored // request information (so that the contract doesn't use a linear amount of storage in the number of requests). diff --git a/target_chains/ethereum/entropy_sdk/solidity/IEntropy.sol b/target_chains/ethereum/entropy_sdk/solidity/IEntropy.sol index 6e5fb4aa..fd7f5be2 100644 --- a/target_chains/ethereum/entropy_sdk/solidity/IEntropy.sol +++ b/target_chains/ethereum/entropy_sdk/solidity/IEntropy.sol @@ -51,10 +51,9 @@ interface IEntropy is EntropyEvents { bytes32 userRandomNumber ) external payable returns (uint64 assignedSequenceNumber); - // Fulfill a request for a random number and call back the requester. This method validates the provided userRandomness - // and provider's revelation against the corresponding commitment in the in-flight request. If both values are validated - // and the requestor address is a contract address, this function calls the requester's entropyCallback method with the - // sequence number and the random number as arguments. Else if the requestor is an EOA, it won't call it. + // Fulfill a request for a random number. This method validates the provided userRandomness and provider's proof + // against the corresponding commitments in the in-flight request. If both values are validated, this function returns + // the corresponding random number. // // Note that this function can only be called once per in-flight request. Calling this function deletes the stored // request information (so that the contract doesn't use a linear amount of storage in the number of requests). @@ -66,9 +65,10 @@ interface IEntropy is EntropyEvents { bytes32 providerRevelation ) external returns (bytes32 randomNumber); - // Fulfill a request for a random number and call back the requester. This method validates the provided userRandomness - // and provider's revelation against the corresponding commitment in the in-flight request. If both values are validated, - // this function calls the requester's entropyCallback method with the sequence number and the random number as arguments. + // Fulfill a request for a random number. This method validates the provided userRandomness + // and provider's revelation against the corresponding commitment in the in-flight request. If both values are validated + // and the requestor address is a contract address, this function calls the requester's entropyCallback method with the + // sequence number, provider address and the random number as arguments. Else if the requestor is an EOA, it won't call it. // // Note that this function can only be called once per in-flight request. Calling this function deletes the stored // request information (so that the contract doesn't use a linear amount of storage in the number of requests).