Makefile + commands added; README updated to detail activation and big blocks switch; deployment working

Author: adamocallaghan

Makefile

@@ -0,0 +1,10 @@
+-include .env
+
+# Deploy L1Read Contract to HyperEVM
+deploy-read-contract:
+	forge script script/DeployL1Read.s.sol:DeployL1Read --broadcast --legacy --account deployer -vvvvv
+
+# Read the Hyperliquid Core block number using our deployed contract
+read-block-number:
+	cast call $(L1READ_CONTRACT_ADDRESS) "l1BlockNumber()(uint64)" --rpc-url $(HYPEREVM_TESTNET_RPC)
+

README.md

@@ -4,3 +4,18 @@
 
 Hyperliquid Read Precompiles docs: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/interacting-with-hypercore
 
+# Activate on Core
+If you are using a dev wallet that has never interacted with Hyperliquid before, you will need to activate it on Hyperliquid Core.
+
+1. Go to: https://app.hyperliquid-testnet.xyz/drip
+2. Click on "Claim 1000 mock USDC"
+
+# Switch to 'Big Blocks'
+Hyperliquid uses a dual block architecture, with small/fast blocks and large/slow blocks:
+"Fast block duration is set to 1 seconds with a 2M gas limit. Slow block duration is set to 1 minute with a 30M gas limit."
+Small/fast blocks are enabled on accounts by default, and they are not sufficient for deploying smart contracts.
+To get around this you need to switch your account to 'big blocks'.
+1. Go to: https://hyperevm-block-toggle.vercel.app/
+2. Toggle it to "Testnet" and click on the "Big" button
+3. Approve the transactions
+....you have successfully switched your account to big blocks and can now deploy your contract.

broadcast/DeployL1Read.s.sol/998/run-1753738168.json

@@ -4,7 +4,7 @@ out = "out"
 libs = ["lib"]
 
 [rpc_endpoints]
-hyperevm = "${HYPEREVM_SEPOLIA_RPC}"
+hyperevm = "${HYPEREVM_TESTNET_RPC}"
 
 [etherscan]
 hyperevm = { key = "${HYPEREVM_ETHERSCAN_API_KEY}" }

broadcast/DeployL1Read.s.sol/998/run-1753738264.json

@@ -9,13 +9,13 @@ contract DeployL1Read is Script {
 
         // deployer
         uint256 deployerPrivateKey = vm.envUint("DEPLOYER_PRIVATE_KEY");
-        
+
         vm.createSelectFork("hyperevm");
 
         vm.startBroadcast(deployerPrivateKey);
 
-        // deploy OFT
-        L1Read l1read = new L1Read{salt: "letsread"}();
+        // deploy read contract
+        L1Read l1read = new L1Read();
         console2.log("L1Read contract deployed on HyperEVM to: ", address(l1read));
 
         vm.stopBroadcast();