@d20dao/vrf-sdk 0.1.2 → 0.3.0

package/abi/EpochEntropy.json

@@ -73,6 +73,11 @@
     "name": "FailedCall",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "FallbackNotOpen",
+    "type": "error"
+  },
   {
     "inputs": [],
     "name": "InvalidConfig",
@@ -88,6 +93,11 @@
     "name": "InvalidEpoch",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "InvalidFallback",
+    "type": "error"
+  },
   {
     "inputs": [],
     "name": "InvalidInitialization",
@@ -145,6 +155,11 @@
     "name": "PreparationClosed",
     "type": "error"
   },
+  {
+    "inputs": [],
+    "name": "RenounceDisabled",
+    "type": "error"
+  },
   {
     "inputs": [],
     "name": "UUPSUnauthorizedCallContext",
@@ -161,6 +176,31 @@
     "name": "UUPSUnsupportedProxiableUUID",
     "type": "error"
   },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "uint64",
+        "name": "fromEpoch",
+        "type": "uint64"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "catalogHash",
+        "type": "bytes32"
+      },
+      {
+        "indexed": false,
+        "internalType": "address[4]",
+        "name": "signers",
+        "type": "address[4]"
+      }
+    ],
+    "name": "CatalogScheduled",
+    "type": "event"
+  },
   {
     "anonymous": false,
     "inputs": [
@@ -295,6 +335,45 @@
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [],
+    "name": "FALLBACK_DELAY_BLOCKS",
+    "outputs": [
+      {
+        "internalType": "uint64",
+        "name": "",
+        "type": "uint64"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "MAX_ATTESTATION_AGE",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "MAX_FALLBACK_ATTEMPT",
+    "outputs": [
+      {
+        "internalType": "uint8",
+        "name": "",
+        "type": "uint8"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "MAX_PACKET_BYTES",
@@ -393,6 +472,25 @@
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint64",
+        "name": "epochId",
+        "type": "uint64"
+      }
+    ],
+    "name": "catalogHashAt",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "hash",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
@@ -447,6 +545,46 @@
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint64",
+        "name": "epochId",
+        "type": "uint64"
+      },
+      {
+        "internalType": "uint8",
+        "name": "attempt",
+        "type": "uint8"
+      },
+      {
+        "components": [
+          {
+            "internalType": "uint256",
+            "name": "timestamp",
+            "type": "uint256"
+          },
+          {
+            "internalType": "bytes",
+            "name": "data",
+            "type": "bytes"
+          },
+          {
+            "internalType": "bytes",
+            "name": "signature",
+            "type": "bytes"
+          }
+        ],
+        "internalType": "struct EpochEntropy.Attestation",
+        "name": "a",
+        "type": "tuple"
+      }
+    ],
+    "name": "commitEpochFallback",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "committer",
@@ -530,6 +668,30 @@
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint64",
+        "name": "epochId",
+        "type": "uint64"
+      },
+      {
+        "internalType": "uint8",
+        "name": "attempt",
+        "type": "uint8"
+      }
+    ],
+    "name": "fallbackOpensAt",
+    "outputs": [
+      {
+        "internalType": "uint64",
+        "name": "",
+        "type": "uint64"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [],
     "name": "firstEpochStart",
@@ -609,6 +771,57 @@
     "stateMutability": "view",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint64",
+        "name": "epochId",
+        "type": "uint64"
+      },
+      {
+        "internalType": "uint8",
+        "name": "attempt",
+        "type": "uint8"
+      }
+    ],
+    "name": "getEpochFallbackSelection",
+    "outputs": [
+      {
+        "components": [
+          {
+            "internalType": "uint8",
+            "name": "source",
+            "type": "uint8"
+          },
+          {
+            "internalType": "address",
+            "name": "airnode",
+            "type": "address"
+          },
+          {
+            "internalType": "bytes32",
+            "name": "selector",
+            "type": "bytes32"
+          },
+          {
+            "internalType": "bytes32",
+            "name": "queryHash",
+            "type": "bytes32"
+          },
+          {
+            "internalType": "string",
+            "name": "canonicalRequest",
+            "type": "string"
+          }
+        ],
+        "internalType": "struct EpochEntropy.Selection",
+        "name": "s",
+        "type": "tuple"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {
@@ -753,6 +966,24 @@
     "inputs": [],
     "name": "renounceOwnership",
     "outputs": [],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address[4]",
+        "name": "signers",
+        "type": "address[4]"
+      },
+      {
+        "internalType": "uint64",
+        "name": "fromEpoch",
+        "type": "uint64"
+      }
+    ],
+    "name": "scheduleCatalog",
+    "outputs": [],
     "stateMutability": "nonpayable",
     "type": "function"
   },
@@ -769,6 +1000,25 @@
     "stateMutability": "nonpayable",
     "type": "function"
   },
+  {
+    "inputs": [
+      {
+        "internalType": "uint64",
+        "name": "epochId",
+        "type": "uint64"
+      }
+    ],
+    "name": "signersAt",
+    "outputs": [
+      {
+        "internalType": "address[4]",
+        "name": "signers",
+        "type": "address[4]"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
   {
     "inputs": [
       {

package/contracts/examples/MiningRandomnessConsumer.sol

@@ -27,7 +27,8 @@ abstract contract MiningRandomnessConsumer is D20VRFConsumer {
         if (claimRandomness[claimId].requested) revert ClaimAlreadyRequested();
         claimRandomness[claimId].requested = true;
         ID20VRF rng = ID20VRF(vrfCoordinator);
-        requestId = rng.requestRandomness{value: rng.requestFee()}(
+        // The same-transaction quote is exact; only off-chain senders need a buffer.
+        requestId = rng.requestRandomness{value: rng.quoteFee(callbackGasLimit)}(
             keccak256(abi.encode(claimId, lockedWork)), callbackGasLimit, refundAddress
         );
         claimRandomness[claimId].requestId = requestId;

package/contracts/interfaces/ID20VRF.sol

@@ -4,7 +4,11 @@ pragma solidity 0.8.28;
 import {RandomnessMapping} from "../libraries/RandomnessMapping.sol";
 
 interface ID20VRF {
-    function requestFee() external view returns (uint256);
+    /// @notice Exact fee for a request sent in this same transaction. Through eth_call the base fee is often reported as 0,
+    ///         so off-chain senders must quote with quoteFeeAt and the latest header baseFeePerGas plus a buffer.
+    function quoteFee(uint32 callbackGasLimit) external view returns (uint256);
+    /// @notice max(minFee, feeMultiplier * baseFee * (fulfillGasOverhead + callbackGasLimit)) over the current parameters.
+    function quoteFeeAt(uint32 callbackGasLimit, uint256 baseFee) external view returns (uint256);
     function requestRandomness(bytes32 clientSeed, uint32 callbackGasLimit, address _refundAddress)
         external payable returns (uint256 requestId);
     function requestMappedRandomness(

package/contracts/libraries/D20VRFRequests.sol

@@ -6,6 +6,7 @@ import {RandomnessMapping as M} from "./RandomnessMapping.sol";
 
 /// @notice Built-in request helpers for game contracts. All requests still callback with (id, rawWord).
 /// @dev Usage: using D20VRFRequests for ID20VRF; rng.d20(options). Inspect getMappedResult(id) after fulfillment.
+///      Each helper pays the exact same-transaction quote from the calling contract balance.
 library D20VRFRequests {
     struct Options { bytes32 clientSeed; uint32 callbackGasLimit; address refundAddress; }
     function diceRoll(ID20VRF rng, uint256 sides, uint32 count, Options memory o) internal returns (uint256) {
@@ -36,6 +37,6 @@ library D20VRFRequests {
         return _send(rng, M.Spec(M.Operation.Shuffle, 0, 0, population, population), o);
     }
     function _send(ID20VRF rng, M.Spec memory spec, Options memory o) private returns (uint256) {
-        return rng.requestMappedRandomness{value: rng.requestFee()}(o.clientSeed, o.callbackGasLimit, o.refundAddress, spec);
+        return rng.requestMappedRandomness{value: rng.quoteFee(o.callbackGasLimit)}(o.clientSeed, o.callbackGasLimit, o.refundAddress, spec);
     }
 }