add randomness consumer deployment script and deploy

Author: najienka

.gitmodules

@@ -7,3 +7,6 @@
 [submodule "lib/blocklock-solidity"]
 	path = lib/blocklock-solidity
 	url = https://github.com/randa-mu/blocklock-solidity
+[submodule "lib/randomness-solidity"]
+	path = lib/randomness-solidity
+	url = https://github.com/randa-mu/randomness-solidity

README.md

@@ -59,6 +59,8 @@ source .env
 forge script script/SealedBidAuction.s.sol --rpc-url $CALIBRATION_TESTNET_RPC_URL --private-key $CALIBRATION_TESTNET_PRIVATE_KEY --broadcast
 ```
 
+For common deployment issues with the Filecoin calibration testnet, please refer to the  [FEVM (Ethereum Virtual Machine on Filecoin) Foundry toolkit](https://github.com/filecoin-project/fevm-foundry-kit).
+
 
 ## How It Works
 1. Encrypting Your Bid (Off-Chain): Bidders encrypt their bid amounts off-chain, generating ciphertexts for submission.
@@ -75,6 +77,5 @@ forge script script/SealedBidAuction.s.sol --rpc-url $CALIBRATION_TESTNET_RPC_UR
 Check out the detailed tutorial on [our blog](https://drand.love/blog/2025/03/04/onchain-sealed-bid-auction/).
 
 
-
 ## Licensing
 This source code is licensed under the MIT License which can be accessed [here](LICENSE).

lib/randomness-solidity

@@ -7,3 +7,4 @@ config/=config/
 
 @openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/
 @blocklock-solidity/src/=lib/blocklock-solidity/src/
+@randomness-solidity/src/=lib/randomness-solidity/src/

remappings.txt

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.28;
+
+import {Script} from "forge-std/Script.sol";
+import {console} from "forge-std/console.sol";
+
+import {RandomnessConsumer} from "src/RandomnessConsumer.sol";
+
+contract RandomnessConsumerScript is Script {
+    function run() external {
+        vm.broadcast();
+        RandomnessConsumer randomnessConsumer = new RandomnessConsumer();
+
+        console.log("RandomnessConsumer deployed at: ", address(randomnessConsumer));
+    }
+}

script/RandomnessConsumer.s.sol

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.28;
+
+import {RandomnessReceiverBase} from "@randomness-solidity/src/RandomnessReceiverBase.sol";
+
+/// @title Randomness Consumer contract
+/// @author Randamu developers
+/// @notice A mock RandomnessConsumer contract that makes use of the Randamu randomness-solidity
+/// library to request verifiable randomness
+/// The library is available at: https://github.com/randa-mu/randomness-solidity/tree/main
+/// The library also contains logic for array shuffling using Feistel shuffle
+/// and selecting n items randomly from an array
+/// Deployed at: 0x410354CCce2c9d99bfD1968F91d37767beE97315
+contract RandomnessConsumer is RandomnessReceiverBase {
+    address public constant RANDOMNESS_SENDER = 0x9c789bc7F2B5c6619Be1572A39F2C3d6f33001dC;
+
+    bytes32 public randomness;
+    uint256 public requestId;
+
+    constructor() RandomnessReceiverBase(RANDOMNESS_SENDER) {}
+
+    /**
+     * @dev Requests randomness.
+     *
+     * This function calls the `requestRandomness` method to request a random value.
+     * The `requestId` is updated with the ID returned from the randomness request.
+     */
+    function rollDice() external {
+        requestId = requestRandomness();
+    }
+
+    /**
+     * @dev Callback function that is called when randomness is received.
+     * @param requestID The ID of the randomness request that was made.
+     * @param _randomness The random value received.
+     *
+     * This function verifies that the received `requestID` matches the one that
+     * was previously stored. If they match, it updates the `randomness` state variable
+     * with the newly received random value.
+     *
+     * Reverts if the `requestID` does not match the stored `requestId`, ensuring that
+     * the randomness is received in response to a valid request.
+     */
+    function onRandomnessReceived(uint256 requestID, bytes32 _randomness) internal override {
+        require(requestId == requestID, "Request ID mismatch");
+        randomness = _randomness;
+    }
+}

src/RandomnessConsumer.sol

@@ -8,13 +8,21 @@ import {AbstractBlocklockReceiver} from "@blocklock-solidity/src/AbstractBlocklo
 // Import ReentrancyGuard which is an Openzeppelin solidity library that helps prevent reentrant calls to a function.
 import {ReentrancyGuard} from "@openzeppelin/contracts/utils/ReentrancyGuard.sol";
 
+/// @title Sealed Bid Auction interface
+/// @author Randamu developers
+/// @notice An interface for a sealed bid auction smart contract
+/// allowing encrypted bids which are decrypted at a future block number.
 interface ISealedBidAuction {
     function placeSealedBid(TypesLib.Ciphertext calldata sealedBid) external payable returns (uint256);
     function withdrawRefund() external;
     function fulfillHighestBid() external payable;
     function finalizeAuction() external;
 }
 
+/// @title Sealed Bid Auction contract
+/// @author Randamu developers
+/// @notice A bid smart contract which allows sealed bids to be made in an auction.
+/// The bids are automatically decrypted at a future block number (block number that closes the bidding window).
 contract SealedBidAuction is ISealedBidAuction, AbstractBlocklockReceiver, ReentrancyGuard {
     struct Bid {
         uint256 bidID; // Unique identifier for the bid