@d20dao/vrf-sdk 0.1.0

package/dist/abi.js

@@ -0,0 +1,3 @@
+// Generated from canonical protocol sources with solc 0.8.28+commit.7893614a.Emscripten.clang.
+export const coordinatorAbi = [{ "inputs": [], "stateMutability": "nonpayable", "type": "constructor" }, { "inputs": [{ "internalType": "address", "name": "target", "type": "address" }], "name": "AddressEmptyCode", "type": "error" }, { "inputs": [], "name": "AlreadyDelivered", "type": "error" }, { "inputs": [], "name": "AlreadyFulfilled", "type": "error" }, { "inputs": [], "name": "BlockHashUnavailable", "type": "error" }, { "inputs": [], "name": "ContractConsumerRequired", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "implementation", "type": "address" }], "name": "ERC1967InvalidImplementation", "type": "error" }, { "inputs": [], "name": "ERC1967NonPayable", "type": "error" }, { "inputs": [], "name": "EpochUnavailable", "type": "error" }, { "inputs": [], "name": "EvidencePacketTooLarge", "type": "error" }, { "inputs": [], "name": "FailedCall", "type": "error" }, { "inputs": [{ "internalType": "uint256", "name": "expected", "type": "uint256" }, { "internalType": "uint256", "name": "actual", "type": "uint256" }], "name": "IncorrectFee", "type": "error" }, { "inputs": [], "name": "InsufficientCallbackGas", "type": "error" }, { "inputs": [], "name": "InvalidCallbackGas", "type": "error" }, { "inputs": [], "name": "InvalidConfig", "type": "error" }, { "inputs": [], "name": "InvalidInitialization", "type": "error" }, { "inputs": [], "name": "InvalidMapping", "type": "error" }, { "inputs": [], "name": "InvalidPublicKey", "type": "error" }, { "inputs": [], "name": "InvalidRefundAddress", "type": "error" }, { "inputs": [], "name": "InvalidScan", "type": "error" }, { "inputs": [], "name": "NoKeeperCredit", "type": "error" }, { "inputs": [], "name": "NoRefundCredit", "type": "error" }, { "inputs": [], "name": "NotFulfilled", "type": "error" }, { "inputs": [], "name": "NotInitializing", "type": "error" }, { "inputs": [], "name": "NotReady", "type": "error" }, { "inputs": [], "name": "NotRefunded", "type": "error" }, { "inputs": [], "name": "OnlyFeeRecipient", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "owner", "type": "address" }], "name": "OwnableInvalidOwner", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "OwnableUnauthorizedAccount", "type": "error" }, { "inputs": [], "name": "ReentrancyGuardReentrantCall", "type": "error" }, { "inputs": [], "name": "RefundCallbackAlreadyDelivered", "type": "error" }, { "inputs": [], "name": "RefundNotAvailable", "type": "error" }, { "inputs": [], "name": "RequestExpired", "type": "error" }, { "inputs": [], "name": "RequestRefunded", "type": "error" }, { "inputs": [], "name": "TransferFailed", "type": "error" }, { "inputs": [], "name": "UUPSUnauthorizedCallContext", "type": "error" }, { "inputs": [{ "internalType": "bytes32", "name": "slot", "type": "bytes32" }], "name": "UUPSUnsupportedProxiableUUID", "type": "error" }, { "inputs": [], "name": "UnknownRequest", "type": "error" }, { "inputs": [], "name": "WrongPublicKey", "type": "error" }, { "inputs": [], "name": "WrongSeed", "type": "error" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": false, "internalType": "uint64", "name": "targetBlock", "type": "uint64" }, { "indexed": false, "internalType": "bytes32", "name": "blockHash", "type": "bytes32" }], "name": "BlockHashStored", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": false, "internalType": "bool", "name": "success", "type": "bool" }, { "indexed": false, "internalType": "uint32", "name": "gasLimit", "type": "uint32" }], "name": "CallbackAttempted", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "previousRecipient", "type": "address" }, { "indexed": true, "internalType": "address", "name": "newRecipient", "type": "address" }], "name": "FeeRecipientChanged", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "recipient", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "FeesWithdrawn", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "bytes32", "name": "transcriptHash", "type": "bytes32" }, { "indexed": false, "internalType": "bytes", "name": "packet", "type": "bytes" }], "name": "FulfillmentEvidence", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": false, "internalType": "uint64", "name": "version", "type": "uint64" }], "name": "Initialized", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "keeper", "type": "address" }, { "indexed": true, "internalType": "address", "name": "recipient", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "KeeperCreditWithdrawn", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": false, "internalType": "uint16", "name": "previousBps", "type": "uint16" }, { "indexed": false, "internalType": "uint16", "name": "newBps", "type": "uint16" }], "name": "KeeperFeeBpsChanged", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "address", "name": "keeper", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }, { "indexed": false, "internalType": "bool", "name": "paid", "type": "bool" }], "name": "KeeperFeePaid", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "bytes32", "name": "mappingHash", "type": "bytes32" }, { "components": [{ "internalType": "enum RandomnessMapping.Operation", "name": "operation", "type": "uint8" }, { "internalType": "uint256", "name": "lower", "type": "uint256" }, { "internalType": "uint256", "name": "upper", "type": "uint256" }, { "internalType": "uint32", "name": "count", "type": "uint32" }, { "internalType": "uint32", "name": "population", "type": "uint32" }], "indexed": false, "internalType": "struct RandomnessMapping.Spec", "name": "spec", "type": "tuple" }], "name": "MappingRequested", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "previousOwner", "type": "address" }, { "indexed": true, "internalType": "address", "name": "newOwner", "type": "address" }], "name": "OwnershipTransferStarted", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "previousOwner", "type": "address" }, { "indexed": true, "internalType": "address", "name": "newOwner", "type": "address" }], "name": "OwnershipTransferred", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "bytes32", "name": "keyHash", "type": "bytes32" }, { "indexed": false, "internalType": "uint256", "name": "seed", "type": "uint256" }, { "indexed": false, "internalType": "bytes32", "name": "proofHash", "type": "bytes32" }], "name": "ProofVerified", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": false, "internalType": "bytes32", "name": "randomness", "type": "bytes32" }, { "indexed": true, "internalType": "address", "name": "submitter", "type": "address" }], "name": "RandomnessFulfilled", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "address", "name": "consumer", "type": "address" }, { "indexed": true, "internalType": "bytes32", "name": "keyHash", "type": "bytes32" }, { "indexed": false, "internalType": "bytes32", "name": "clientSeed", "type": "bytes32" }, { "indexed": false, "internalType": "uint64", "name": "requestBlock", "type": "uint64" }, { "indexed": false, "internalType": "uint32", "name": "callbackGasLimit", "type": "uint32" }, { "indexed": false, "internalType": "uint256", "name": "feePaid", "type": "uint256" }, { "indexed": false, "internalType": "address", "name": "refundAddress", "type": "address" }, { "indexed": false, "internalType": "uint64", "name": "deadline", "type": "uint64" }], "name": "RandomnessRequested", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "address", "name": "consumer", "type": "address" }, { "indexed": false, "internalType": "bool", "name": "success", "type": "bool" }, { "indexed": false, "internalType": "uint32", "name": "gasLimit", "type": "uint32" }], "name": "RefundCallbackAttempted", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "owner", "type": "address" }, { "indexed": true, "internalType": "address", "name": "recipient", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "RefundCreditWithdrawn", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "address", "name": "refundAddress", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }, { "indexed": false, "internalType": "bool", "name": "paid", "type": "bool" }], "name": "RequestRefundedTo", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "indexed": true, "internalType": "uint256", "name": "serveIndex", "type": "uint256" }], "name": "RequestServed", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "implementation", "type": "address" }], "name": "Upgraded", "type": "event" }, { "inputs": [], "name": "CONFIG_DOMAIN", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "MAX_CALLBACK_GAS", "outputs": [{ "internalType": "uint32", "name": "", "type": "uint32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "MAX_EVIDENCE_PACKET_BYTES", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "MIN_CALLBACK_GAS", "outputs": [{ "internalType": "uint32", "name": "", "type": "uint32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "REFUND_CALLBACK_GAS", "outputs": [{ "internalType": "uint32", "name": "", "type": "uint32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "RESPONSE_TIMEOUT", "outputs": [{ "internalType": "uint64", "name": "", "type": "uint64" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "SEED_DOMAIN", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "TRANSCRIPT_DOMAIN", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "UPGRADE_INTERFACE_VERSION", "outputs": [{ "internalType": "string", "name": "", "type": "string" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "acceptOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "confirmationBlocks", "outputs": [{ "internalType": "uint16", "name": "", "type": "uint16" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "earnedFees", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "epochRegistry", "outputs": [{ "internalType": "contract EpochEntropy", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "feeRecipient", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "components": [{ "internalType": "uint256[2]", "name": "pk", "type": "uint256[2]" }, { "internalType": "uint256[2]", "name": "gamma", "type": "uint256[2]" }, { "internalType": "uint256", "name": "c", "type": "uint256" }, { "internalType": "uint256", "name": "s", "type": "uint256" }, { "internalType": "uint256", "name": "seed", "type": "uint256" }, { "internalType": "address", "name": "uWitness", "type": "address" }, { "internalType": "uint256[2]", "name": "cGammaWitness", "type": "uint256[2]" }, { "internalType": "uint256[2]", "name": "sHashWitness", "type": "uint256[2]" }, { "internalType": "uint256", "name": "zInv", "type": "uint256" }], "internalType": "struct VRF.Proof", "name": "proof", "type": "tuple" }], "name": "fulfillRandomness", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "name": "getMappedResult", "outputs": [{ "internalType": "uint256[]", "name": "", "type": "uint256[]" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "name": "getMapping", "outputs": [{ "components": [{ "internalType": "enum RandomnessMapping.Operation", "name": "operation", "type": "uint8" }, { "internalType": "uint256", "name": "lower", "type": "uint256" }, { "internalType": "uint256", "name": "upper", "type": "uint256" }, { "internalType": "uint32", "name": "count", "type": "uint32" }, { "internalType": "uint32", "name": "population", "type": "uint32" }], "internalType": "struct RandomnessMapping.Spec", "name": "", "type": "tuple" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "fromId", "type": "uint256" }, { "internalType": "uint256", "name": "limit", "type": "uint256" }], "name": "getPendingRequestIds", "outputs": [{ "internalType": "uint256[]", "name": "ids", "type": "uint256[]" }, { "internalType": "uint256", "name": "nextCursor", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "name": "getProofContext", "outputs": [{ "internalType": "uint256", "name": "seed", "type": "uint256" }, { "internalType": "uint64", "name": "deadline", "type": "uint64" }, { "internalType": "bool", "name": "fulfilled", "type": "bool" }, { "internalType": "bool", "name": "refunded", "type": "bool" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "name": "getRequest", "outputs": [{ "components": [{ "internalType": "address", "name": "consumer", "type": "address" }, { "internalType": "uint32", "name": "callbackGasLimit", "type": "uint32" }, { "internalType": "uint64", "name": "requestBlock", "type": "uint64" }, { "internalType": "uint64", "name": "targetBlock", "type": "uint64" }, { "internalType": "uint64", "name": "deadline", "type": "uint64" }, { "internalType": "address", "name": "refundAddress", "type": "address" }, { "internalType": "bytes32", "name": "clientSeed", "type": "bytes32" }, { "internalType": "bytes32", "name": "mappingHash", "type": "bytes32" }, { "internalType": "bytes32", "name": "blockHash", "type": "bytes32" }, { "internalType": "bytes32", "name": "randomness", "type": "bytes32" }, { "internalType": "bytes32", "name": "proofHash", "type": "bytes32" }, { "internalType": "bytes32", "name": "transcriptHash", "type": "bytes32" }, { "internalType": "bool", "name": "fulfilled", "type": "bool" }, { "internalType": "bool", "name": "delivered", "type": "bool" }, { "internalType": "bool", "name": "refunded", "type": "bool" }, { "internalType": "uint64", "name": "epochId", "type": "uint64" }, { "internalType": "bytes32", "name": "epochHash", "type": "bytes32" }], "internalType": "struct D20VRFCoordinator.Request", "name": "result", "type": "tuple" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "initialFeeRecipient", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256[2]", "name": "publicKey", "type": "uint256[2]" }, { "internalType": "address", "name": "initialOwner", "type": "address" }, { "internalType": "address", "name": "recipient", "type": "address" }, { "internalType": "uint256", "name": "fee", "type": "uint256" }, { "internalType": "uint16", "name": "confirmations", "type": "uint16" }, { "internalType": "contract EpochEntropy", "name": "registry", "type": "address" }, { "internalType": "uint16", "name": "keeperBps", "type": "uint16" }], "name": "initialize", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }], "name": "keeperCredits", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "keeperFeeBps", "outputs": [{ "internalType": "uint16", "name": "", "type": "uint16" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "keyHash", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "lastServedIndex", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "lastServedRequestId", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "bytes32", "name": "randomness", "type": "bytes32" }, { "components": [{ "internalType": "enum RandomnessMapping.Operation", "name": "operation", "type": "uint8" }, { "internalType": "uint256", "name": "lower", "type": "uint256" }, { "internalType": "uint256", "name": "upper", "type": "uint256" }, { "internalType": "uint32", "name": "count", "type": "uint32" }, { "internalType": "uint32", "name": "population", "type": "uint32" }], "internalType": "struct RandomnessMapping.Spec", "name": "spec", "type": "tuple" }], "name": "mapRandomness", "outputs": [{ "internalType": "uint256[]", "name": "", "type": "uint256[]" }], "stateMutability": "pure", "type": "function" }, { "inputs": [], "name": "nextRequestId", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "owner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "pendingOwner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "protocolConfigurationHash", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "proxiableUUID", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "publicKeyX", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "publicKeyY", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "name": "refundCallbackDelivered", "outputs": [{ "internalType": "bool", "name": "", "type": "bool" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }], "name": "refundCredits", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "name": "refundRequest", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "renounceOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "requestFee", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "bytes32", "name": "clientSeed", "type": "bytes32" }, { "internalType": "uint32", "name": "callbackGasLimit", "type": "uint32" }, { "internalType": "address", "name": "_refundAddress", "type": "address" }, { "components": [{ "internalType": "enum RandomnessMapping.Operation", "name": "operation", "type": "uint8" }, { "internalType": "uint256", "name": "lower", "type": "uint256" }, { "internalType": "uint256", "name": "upper", "type": "uint256" }, { "internalType": "uint32", "name": "count", "type": "uint32" }, { "internalType": "uint32", "name": "population", "type": "uint32" }], "internalType": "struct RandomnessMapping.Spec", "name": "spec", "type": "tuple" }], "name": "requestMappedRandomness", "outputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "stateMutability": "payable", "type": "function" }, { "inputs": [{ "internalType": "bytes32", "name": "clientSeed", "type": "bytes32" }, { "internalType": "uint32", "name": "callbackGasLimit", "type": "uint32" }, { "internalType": "address", "name": "_refundAddress", "type": "address" }], "name": "requestRandomness", "outputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "stateMutability": "payable", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "name": "requestSeed", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "internalType": "uint32", "name": "gasLimit", "type": "uint32" }], "name": "retryCallback", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "internalType": "uint32", "name": "gasLimit", "type": "uint32" }], "name": "retryRefundCallback", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "name": "servedRequestAt", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "next", "type": "address" }], "name": "setFeeRecipient", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint16", "name": "next", "type": "uint16" }], "name": "setKeeperFeeBps", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }], "name": "storeBlockHash", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "totalKeeperCredits", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "totalRefundCredits", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "newOwner", "type": "address" }], "name": "transferOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "newImplementation", "type": "address" }, { "internalType": "bytes", "name": "data", "type": "bytes" }], "name": "upgradeToAndCall", "outputs": [], "stateMutability": "payable", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "requestId", "type": "uint256" }, { "components": [{ "internalType": "uint256[2]", "name": "pk", "type": "uint256[2]" }, { "internalType": "uint256[2]", "name": "gamma", "type": "uint256[2]" }, { "internalType": "uint256", "name": "c", "type": "uint256" }, { "internalType": "uint256", "name": "s", "type": "uint256" }, { "internalType": "uint256", "name": "seed", "type": "uint256" }, { "internalType": "address", "name": "uWitness", "type": "address" }, { "internalType": "uint256[2]", "name": "cGammaWitness", "type": "uint256[2]" }, { "internalType": "uint256[2]", "name": "sHashWitness", "type": "uint256[2]" }, { "internalType": "uint256", "name": "zInv", "type": "uint256" }], "internalType": "struct VRF.Proof", "name": "proof", "type": "tuple" }], "name": "verifyRequestProof", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address payable", "name": "recipient", "type": "address" }], "name": "withdrawFees", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address payable", "name": "recipient", "type": "address" }], "name": "withdrawKeeperCredit", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address payable", "name": "recipient", "type": "address" }], "name": "withdrawRefundCredit", "outputs": [], "stateMutability": "nonpayable", "type": "function" }];
+export const epochEntropyAbi = [{ "inputs": [], "stateMutability": "nonpayable", "type": "constructor" }, { "inputs": [{ "internalType": "address", "name": "target", "type": "address" }], "name": "AddressEmptyCode", "type": "error" }, { "inputs": [], "name": "AlreadyCommitted", "type": "error" }, { "inputs": [], "name": "AnchorUnavailable", "type": "error" }, { "inputs": [], "name": "ECDSAInvalidSignature", "type": "error" }, { "inputs": [{ "internalType": "uint256", "name": "length", "type": "uint256" }], "name": "ECDSAInvalidSignatureLength", "type": "error" }, { "inputs": [{ "internalType": "bytes32", "name": "s", "type": "bytes32" }], "name": "ECDSAInvalidSignatureS", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "implementation", "type": "address" }], "name": "ERC1967InvalidImplementation", "type": "error" }, { "inputs": [], "name": "ERC1967NonPayable", "type": "error" }, { "inputs": [], "name": "FailedCall", "type": "error" }, { "inputs": [], "name": "InvalidConfig", "type": "error" }, { "inputs": [], "name": "InvalidData", "type": "error" }, { "inputs": [], "name": "InvalidEpoch", "type": "error" }, { "inputs": [], "name": "InvalidInitialization", "type": "error" }, { "inputs": [], "name": "InvalidSigner", "type": "error" }, { "inputs": [], "name": "InvalidTime", "type": "error" }, { "inputs": [], "name": "NotInitializing", "type": "error" }, { "inputs": [], "name": "OnlyCommitter", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "owner", "type": "address" }], "name": "OwnableInvalidOwner", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "OwnableUnauthorizedAccount", "type": "error" }, { "inputs": [], "name": "PacketTooLarge", "type": "error" }, { "inputs": [], "name": "PreparationClosed", "type": "error" }, { "inputs": [], "name": "UUPSUnauthorizedCallContext", "type": "error" }, { "inputs": [{ "internalType": "bytes32", "name": "slot", "type": "bytes32" }], "name": "UUPSUnsupportedProxiableUUID", "type": "error" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "previousCommitter", "type": "address" }, { "indexed": true, "internalType": "address", "name": "newCommitter", "type": "address" }], "name": "CommitterChanged", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "uint64", "name": "epochId", "type": "uint64" }, { "indexed": true, "internalType": "bytes32", "name": "epochHash", "type": "bytes32" }, { "indexed": false, "internalType": "bytes", "name": "packet", "type": "bytes" }], "name": "EpochCommitted", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": false, "internalType": "uint64", "name": "version", "type": "uint64" }], "name": "Initialized", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "previousOwner", "type": "address" }, { "indexed": true, "internalType": "address", "name": "newOwner", "type": "address" }], "name": "OwnershipTransferStarted", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "previousOwner", "type": "address" }, { "indexed": true, "internalType": "address", "name": "newOwner", "type": "address" }], "name": "OwnershipTransferred", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "implementation", "type": "address" }], "name": "Upgraded", "type": "event" }, { "inputs": [], "name": "EPOCH_DOMAIN", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "EPOCH_LENGTH", "outputs": [{ "internalType": "uint64", "name": "", "type": "uint64" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "MAX_PACKET_BYTES", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "RECIPE_DOMAIN", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "SELECT_DOMAIN", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "UPGRADE_INTERFACE_VERSION", "outputs": [{ "internalType": "string", "name": "", "type": "string" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "acceptOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "anuSigner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "btcTradeSigner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "catalogHash", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint64", "name": "epochId", "type": "uint64" }], "name": "checkpointEpoch", "outputs": [{ "internalType": "bytes32", "name": "anchor", "type": "bytes32" }], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint64", "name": "epochId", "type": "uint64" }, { "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": "commitEpoch", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "committer", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint64", "name": "", "type": "uint64" }], "name": "epochAnchors", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "number", "type": "uint256" }], "name": "epochForBlock", "outputs": [{ "internalType": "uint64", "name": "", "type": "uint64" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint64", "name": "epochId", "type": "uint64" }], "name": "epochStart", "outputs": [{ "internalType": "uint64", "name": "", "type": "uint64" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "ethTradeSigner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "firstEpochStart", "outputs": [{ "internalType": "uint64", "name": "", "type": "uint64" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint64", "name": "epochId", "type": "uint64" }], "name": "getEpoch", "outputs": [{ "components": [{ "internalType": "bytes32", "name": "epochHash", "type": "bytes32" }, { "internalType": "bytes32", "name": "catalogHash", "type": "bytes32" }, { "internalType": "bytes32", "name": "anchorHash", "type": "bytes32" }, { "internalType": "uint8", "name": "source", "type": "uint8" }, { "internalType": "bytes32", "name": "queryHash", "type": "bytes32" }, { "internalType": "bytes32", "name": "dataHash", "type": "bytes32" }, { "internalType": "bytes32", "name": "attestationHash", "type": "bytes32" }, { "internalType": "uint256", "name": "signedAt", "type": "uint256" }, { "internalType": "uint64", "name": "committedBlock", "type": "uint64" }], "internalType": "struct EpochEntropy.Epoch", "name": "", "type": "tuple" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint64", "name": "epochId", "type": "uint64" }], "name": "getEpochSelection", "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": [], "name": "hyperliquidSigner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address[4]", "name": "signers", "type": "address[4]" }, { "internalType": "address", "name": "initialOwner", "type": "address" }, { "internalType": "address", "name": "initialCommitter", "type": "address" }], "name": "initialize", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint256", "name": "number", "type": "uint256" }], "name": "nextEpochToPrepare", "outputs": [{ "internalType": "uint64", "name": "", "type": "uint64" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "owner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "pendingOwner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "proxiableUUID", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "renounceOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "next", "type": "address" }], "name": "setCommitter", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "newOwner", "type": "address" }], "name": "transferOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "newImplementation", "type": "address" }, { "internalType": "bytes", "name": "data", "type": "bytes" }], "name": "upgradeToAndCall", "outputs": [], "stateMutability": "payable", "type": "function" }];

package/dist/epoch.d.ts

@@ -0,0 +1,189 @@
+import { type ApiAttestation } from "./sources.js";
+import { type VRFProof, type RequestContext } from "./verification.js";
+import type { XY } from "./verification.js";
+export declare const EPOCH_LENGTH = 200n;
+export declare const EPOCH_RECIPE_DOMAIN: string;
+export type EpochSigners = readonly [string, string, string, string];
+export interface EpochCatalog {
+    signers: EpochSigners;
+    registry: string;
+    chainId: bigint;
+    firstEpochStart: bigint;
+}
+export interface EpochRecord {
+    epochHash: string;
+    catalogHash: string;
+    anchorHash: string;
+    source: number | bigint;
+    queryHash: string;
+    dataHash: string;
+    attestationHash: string;
+    signedAt: bigint;
+    committedBlock: bigint;
+}
+export type EpochRequestContext = RequestContext;
+export interface EpochProtocolConfiguration {
+    publicKey: XY;
+    feeRecipient: string;
+    requestFee: bigint;
+    confirmationBlocks: number;
+    registry: string;
+    catalogHash: string;
+    firstEpochStart: bigint;
+}
+export declare function epochCatalogHash(signers: EpochSigners): string;
+export declare function epochStart(firstEpochStart: bigint, epochId: bigint): bigint;
+export declare function epochForBlock(firstEpochStart: bigint, block: bigint): bigint;
+export declare function selectEpoch(catalog: EpochCatalog, epochId: bigint, anchorHash: string): {
+    source: number;
+    airnode: string;
+    selector: string;
+    canonicalRequest: string;
+    queryHash: string;
+    request: {
+        operation: string;
+        parameters: {
+            dex: string;
+            type?: undefined;
+            length?: undefined;
+            size?: undefined;
+            assetClass?: undefined;
+            symbol?: undefined;
+        };
+        responseProjection: {
+            symbol: string;
+            value: string;
+        };
+    } | {
+        operation: string;
+        parameters: {
+            type: string;
+            length: number;
+            size: number;
+            dex?: undefined;
+            assetClass?: undefined;
+            symbol?: undefined;
+        };
+        responseProjection?: undefined;
+    } | {
+        operation: string;
+        parameters: {
+            assetClass: string;
+            symbol: string;
+            dex?: undefined;
+            type?: undefined;
+            length?: undefined;
+            size?: undefined;
+        };
+        responseProjection?: undefined;
+    };
+};
+export declare function verifyEpochAttestation(selected: ReturnType<typeof selectEpoch>, a: ApiAttestation, commitTimestamp: bigint): {
+    dataHash: string;
+    attestationHash: string;
+    signer: string;
+};
+export declare function epochCommitmentHash(catalog: EpochCatalog, epochId: bigint, anchorHash: string, source: number, queryHash: string, dataHash: string, attestationHash: string): string;
+export declare function encodeEpochEvidencePacket(canonicalRequest: string, attestation: ApiAttestation): string;
+export declare function decodeEpochEvidencePacket(packet: string): {
+    canonicalRequest: string;
+    attestation: ApiAttestation;
+};
+export declare function replayEpochCommitment(input: {
+    catalog: EpochCatalog;
+    epochId: bigint;
+    record: EpochRecord;
+    commitTimestamp: bigint;
+    packet: string;
+}): {
+    dataHash: string;
+    attestationHash: string;
+    signer: string;
+    epochHash: string;
+    selected: {
+        source: number;
+        airnode: string;
+        selector: string;
+        canonicalRequest: string;
+        queryHash: string;
+        request: {
+            operation: string;
+            parameters: {
+                dex: string;
+                type?: undefined;
+                length?: undefined;
+                size?: undefined;
+                assetClass?: undefined;
+                symbol?: undefined;
+            };
+            responseProjection: {
+                symbol: string;
+                value: string;
+            };
+        } | {
+            operation: string;
+            parameters: {
+                type: string;
+                length: number;
+                size: number;
+                dex?: undefined;
+                assetClass?: undefined;
+                symbol?: undefined;
+            };
+            responseProjection?: undefined;
+        } | {
+            operation: string;
+            parameters: {
+                assetClass: string;
+                symbol: string;
+                dex?: undefined;
+                type?: undefined;
+                length?: undefined;
+                size?: undefined;
+            };
+            responseProjection?: undefined;
+        };
+    };
+};
+export declare function epochProtocolConfigurationHash(c: EpochProtocolConfiguration): string;
+export declare function epochTranscriptHash(c: EpochRequestContext, configurationHash: string, proofHash: string, randomness: string): string;
+export declare function replayEpochCoordinator(input: {
+    context: EpochRequestContext;
+    configuration: EpochProtocolConfiguration;
+    protocolConfigurationHash: string;
+    epoch: {
+        catalog: EpochCatalog;
+        record: EpochRecord;
+        commitTimestamp: bigint;
+        packet: string;
+    };
+    requestedAt: bigint;
+    deadline: bigint;
+    acceptanceTimestamp: bigint;
+    acceptanceBlock: bigint;
+    vrfProof: VRFProof;
+    recorded: {
+        fulfilled: boolean;
+        randomness: string;
+        proofHash: string;
+        transcriptHash: string;
+    };
+}): {
+    request: {
+        seed: bigint;
+        epochId: bigint;
+        epochHash: string;
+    };
+    reveal: {
+        randomness: string;
+    };
+    map: {
+        values: bigint[];
+        mappingHash: string;
+    };
+    proof: {
+        proofHash: string;
+        transcriptHash: string;
+        matchesRecordedState: boolean;
+    };
+};

package/dist/epoch.js

@@ -0,0 +1,107 @@
+import { AbiCoder, id, keccak256, getBytes, toUtf8Bytes, toUtf8String, verifyMessage } from "ethers";
+import { canonicalApiRequest, attestationDigest, hashAttestation, validateApiSignatureEncoding } from "./sources.js";
+import { deriveRequestSeed, hashPublicKey, hashProof, verifyVRFProof } from "./verification.js";
+import { hashMapping, mapRandomness } from "./mapping.js";
+const abi = AbiCoder.defaultAbiCoder();
+export const EPOCH_LENGTH = 200n;
+export const EPOCH_RECIPE_DOMAIN = id("D20_EPOCH_RECIPES");
+export function epochCatalogHash(signers) {
+    return keccak256(abi.encode(["bytes32", "address[4]"], [EPOCH_RECIPE_DOMAIN, signers]));
+}
+export function epochStart(firstEpochStart, epochId) {
+    if (epochId < 1n)
+        throw new Error("Invalid epoch");
+    return firstEpochStart + (epochId - 1n) * EPOCH_LENGTH;
+}
+export function epochForBlock(firstEpochStart, block) { return block < firstEpochStart ? 0n : 1n + (block - firstEpochStart) / EPOCH_LENGTH; }
+export function selectEpoch(catalog, epochId, anchorHash) {
+    if (epochId < 1n || BigInt(anchorHash) === 0n)
+        throw new Error("Invalid epoch anchor");
+    const catalogHash = epochCatalogHash(catalog.signers);
+    const selector = keccak256(abi.encode(["bytes32", "bytes32", "uint64", "bytes32"], [id("D20_EPOCH_SELECT"), catalogHash, epochId, anchorHash]));
+    const source = Number(BigInt(selector) % 4n);
+    const request = source === 0 ? { operation: "metaAndAssetCtxs", parameters: { dex: "" }, responseProjection: { symbol: "/0/universe/0/name", value: "/1/0/dayNtlVlm" } }
+        : source === 1 ? { operation: "randomNumbers", parameters: { type: "hex8", length: 4, size: 8 } }
+            : { operation: "lastTrade", parameters: { assetClass: "crypto", symbol: source === 2 ? "BTCUSD" : "ETHUSD" } };
+    const canonicalRequest = canonicalApiRequest(request);
+    return { source, airnode: catalog.signers[source], selector, canonicalRequest, queryHash: keccak256(toUtf8Bytes(canonicalRequest)), request };
+}
+export function verifyEpochAttestation(selected, a, commitTimestamp) {
+    validateApiSignatureEncoding(a.signature);
+    if (a.timestamp > commitTimestamp || commitTimestamp - a.timestamp > 120n)
+        throw new Error("Invalid epoch attestation time");
+    const body = toUtf8String(a.data);
+    const number = "(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?(?:[eE][+-]?[0-9]+)?";
+    const pattern = selected.source === 0 ? /^\{"symbol":"BTC","value":"(?:0|[1-9][0-9]*)(?:\.[0-9]+)?"\}$/
+        : selected.source === 1 ? /^\{"success":true,"type":"hex8","length":"4","data":\["[0-9a-f]{16}","[0-9a-f]{16}","[0-9a-f]{16}","[0-9a-f]{16}"\]\}$/
+            : new RegExp(`^\\{"symbol":"${selected.source === 2 ? "BTCUSD" : "ETHUSD"}","price":${number},"size":${number},"timestamp":[1-9][0-9]{0,15}\\}$`);
+    if (getBytes(a.data).length > 128 || !pattern.test(body))
+        throw new Error("Invalid exact epoch data");
+    const signer = verifyMessage(getBytes(attestationDigest(selected.queryHash, a)), a.signature);
+    if (signer.toLowerCase() !== selected.airnode.toLowerCase())
+        throw new Error("Wrong epoch signer/query");
+    return { dataHash: keccak256(a.data), attestationHash: hashAttestation(selected.queryHash, a), signer };
+}
+export function epochCommitmentHash(catalog, epochId, anchorHash, source, queryHash, dataHash, attestationHash) {
+    return keccak256(abi.encode(["bytes32", "uint256", "address", "bytes32", "uint64", "uint64", "bytes32", "uint8", "bytes32", "bytes32", "bytes32"], [id("D20_EPOCH"), catalog.chainId, catalog.registry, epochCatalogHash(catalog.signers), epochId, epochStart(catalog.firstEpochStart, epochId), anchorHash, source, queryHash, dataHash, attestationHash]));
+}
+const packetTypes = ["string", "tuple(uint256 timestamp,bytes data,bytes signature)"];
+export function encodeEpochEvidencePacket(canonicalRequest, attestation) {
+    const packet = abi.encode(packetTypes, [canonicalRequest, attestation]);
+    if (getBytes(packet).length > 2048)
+        throw new Error("Epoch packet exceeds 2048 bytes");
+    return packet;
+}
+export function decodeEpochEvidencePacket(packet) {
+    if (getBytes(packet).length > 2048)
+        throw new Error("Epoch packet exceeds 2048 bytes");
+    const [canonicalRequest, a] = abi.decode(packetTypes, packet);
+    const attestation = { timestamp: a.timestamp, data: a.data, signature: a.signature };
+    if (keccak256(encodeEpochEvidencePacket(canonicalRequest, attestation)) !== keccak256(packet))
+        throw new Error("Noncanonical epoch packet");
+    return { canonicalRequest: canonicalRequest, attestation };
+}
+export function replayEpochCommitment(input) {
+    const { catalog, epochId, record } = input, start = epochStart(catalog.firstEpochStart, epochId);
+    if (record.committedBlock < start)
+        throw new Error("Invalid epoch commit block");
+    const selected = selectEpoch(catalog, epochId, record.anchorHash), evidence = decodeEpochEvidencePacket(input.packet);
+    if (evidence.canonicalRequest !== selected.canonicalRequest)
+        throw new Error("Epoch recipe mismatch");
+    const verified = verifyEpochAttestation(selected, evidence.attestation, input.commitTimestamp);
+    const epochHash = epochCommitmentHash(catalog, epochId, record.anchorHash, selected.source, selected.queryHash, verified.dataHash, verified.attestationHash);
+    if (record.epochHash !== epochHash || record.catalogHash !== epochCatalogHash(catalog.signers) || Number(record.source) !== selected.source || record.queryHash !== selected.queryHash ||
+        record.dataHash !== verified.dataHash || record.attestationHash !== verified.attestationHash || record.signedAt !== evidence.attestation.timestamp)
+        throw new Error("Epoch record mismatch");
+    return { epochHash, selected, ...verified };
+}
+export function epochProtocolConfigurationHash(c) {
+    return keccak256(abi.encode(["bytes32", "uint256[2]", "address", "uint256", "uint16", "address", "bytes32", "uint64", "uint64"], [id("D20_VRF_CONFIG"), c.publicKey, c.feeRecipient, c.requestFee, c.confirmationBlocks, c.registry, c.catalogHash, c.firstEpochStart, EPOCH_LENGTH]));
+}
+export function epochTranscriptHash(c, configurationHash, proofHash, randomness) {
+    return keccak256(abi.encode(["bytes32", "uint256", "address", "uint256", "bytes32", "bytes32", "bytes32", "bytes32", "bytes32", "uint64", "bytes32"], [id("D20_VRF_TRANSCRIPT"), c.chainId, c.coordinator, c.requestId, configurationHash, c.blockHash, proofHash, randomness, hashMapping(c.mapping), c.epochId, c.epochHash]));
+}
+/// Canonical blocks, transaction inclusion/timestamps and the proxy implementation code active
+/// at each receipt must be independently trusted chain context. A proxy code hash alone is insufficient.
+export function replayEpochCoordinator(input) {
+    const c = input.context, cfg = input.configuration, e = input.epoch;
+    const epoch = replayEpochCommitment({ ...e, epochId: c.epochId });
+    if (e.catalog.registry.toLowerCase() !== cfg.registry.toLowerCase() || e.catalog.chainId !== c.chainId || e.catalog.firstEpochStart !== cfg.firstEpochStart || epochCatalogHash(e.catalog.signers) !== cfg.catalogHash || epoch.epochHash !== c.epochHash || epochForBlock(cfg.firstEpochStart, c.requestBlock) !== c.epochId)
+        throw new Error("Epoch request binding mismatch");
+    const expectedTarget = c.requestBlock > e.record.committedBlock + 1n ? c.requestBlock : e.record.committedBlock + 1n;
+    if (c.targetBlock !== expectedTarget || e.record.committedBlock >= c.targetBlock)
+        throw new Error("Invalid future randomness block");
+    if (hashPublicKey(cfg.publicKey) !== c.keyHash || epochProtocolConfigurationHash(cfg) !== input.protocolConfigurationHash)
+        throw new Error("Protocol configuration mismatch");
+    if (cfg.confirmationBlocks < 1 || cfg.confirmationBlocks > 64 || input.acceptanceBlock < c.targetBlock + BigInt(cfg.confirmationBlocks))
+        throw new Error("Invalid acceptance block");
+    if (input.deadline !== input.requestedAt + 60n || input.acceptanceTimestamp < input.requestedAt || input.acceptanceTimestamp > input.deadline || e.commitTimestamp > input.acceptanceTimestamp)
+        throw new Error("Invalid acceptance time");
+    const seed = deriveRequestSeed(c), vrf = verifyVRFProof(input.vrfProof, cfg.publicKey, seed);
+    if (!vrf.valid)
+        throw new Error(vrf.reason);
+    const proofHash = hashProof(input.vrfProof), transcriptHash = epochTranscriptHash(c, input.protocolConfigurationHash, proofHash, vrf.randomness), r = input.recorded;
+    if (!r.fulfilled || r.randomness !== vrf.randomness || r.proofHash !== proofHash || r.transcriptHash !== transcriptHash)
+        throw new Error("Recorded coordinator state mismatch");
+    return { request: { seed, epochId: c.epochId, epochHash: c.epochHash }, reveal: { randomness: vrf.randomness }, map: { values: mapRandomness(vrf.randomness, c.mapping), mappingHash: hashMapping(c.mapping) }, proof: { proofHash, transcriptHash, matchesRecordedState: true } };
+}

package/dist/evidence.d.ts

@@ -0,0 +1,6 @@
+import type { VRFProof } from "./verification.js";
+export declare const EVIDENCE_PACKET_BYTES = 416;
+export declare function encodeEvidencePacket(proof: VRFProof): string;
+export declare function decodeEvidencePacket(packet: string): {
+    proof: VRFProof;
+};

package/dist/evidence.js

@@ -0,0 +1,16 @@
+import { AbiCoder, getBytes, keccak256 } from "ethers";
+const abi = AbiCoder.defaultAbiCoder();
+const types = ["tuple(uint256[2] pk,uint256[2] gamma,uint256 c,uint256 s,uint256 seed,address uWitness,uint256[2] cGammaWitness,uint256[2] sHashWitness,uint256 zInv)"];
+export const EVIDENCE_PACKET_BYTES = 416;
+export function encodeEvidencePacket(proof) { return abi.encode(types, [proof]); }
+/// Decoding is not verification. Replay with independently trusted chain context.
+export function decodeEvidencePacket(packet) {
+    if (getBytes(packet).length !== EVIDENCE_PACKET_BYTES)
+        throw new Error("Evidence packet must be exactly 416 bytes");
+    const [p] = abi.decode(types, packet);
+    const pair = (v) => [v[0], v[1]];
+    const proof = { pk: pair(p.pk), gamma: pair(p.gamma), c: p.c, s: p.s, seed: p.seed, uWitness: p.uWitness, cGammaWitness: pair(p.cGammaWitness), sHashWitness: pair(p.sHashWitness), zInv: p.zInv };
+    if (keccak256(encodeEvidencePacket(proof)) !== keccak256(packet))
+        throw new Error("Noncanonical evidence packet");
+    return { proof };
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { builtins, Operation, validateMapping, hashMapping, mapRandomness } from "./mapping.js";
+export type { MappingSpec } from "./mapping.js";
+export { deriveRequestSeed, hashPublicKey, hashProof, verifyVRFProof } from "./verification.js";
+export type { RequestContext, VRFProof, XY } from "./verification.js";
+export { canonicalApiRequest, attestationDigest, hashAttestation, validateApiSignatureEncoding } from "./sources.js";
+export type { ApiRequest, ApiAttestation } from "./sources.js";
+export { replayCoordinator, transcriptHash } from "./replay.js";
+export { encodeEvidencePacket, decodeEvidencePacket, EVIDENCE_PACKET_BYTES } from "./evidence.js";
+export { EPOCH_LENGTH, EPOCH_RECIPE_DOMAIN, epochCatalogHash, epochStart, epochForBlock, selectEpoch, verifyEpochAttestation, epochCommitmentHash, encodeEpochEvidencePacket, decodeEpochEvidencePacket, replayEpochCommitment, epochProtocolConfigurationHash } from "./epoch.js";
+export type { EpochCatalog, EpochSigners, EpochRecord, EpochProtocolConfiguration } from "./epoch.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { builtins, Operation, validateMapping, hashMapping, mapRandomness } from "./mapping.js";
+export { deriveRequestSeed, hashPublicKey, hashProof, verifyVRFProof } from "./verification.js";
+export { canonicalApiRequest, attestationDigest, hashAttestation, validateApiSignatureEncoding } from "./sources.js";
+export { replayCoordinator, transcriptHash } from "./replay.js";
+export { encodeEvidencePacket, decodeEvidencePacket, EVIDENCE_PACKET_BYTES } from "./evidence.js";
+export { EPOCH_LENGTH, EPOCH_RECIPE_DOMAIN, epochCatalogHash, epochStart, epochForBlock, selectEpoch, verifyEpochAttestation, epochCommitmentHash, encodeEpochEvidencePacket, decodeEpochEvidencePacket, replayEpochCommitment, epochProtocolConfigurationHash } from "./epoch.js";

package/dist/mapping.d.ts

@@ -0,0 +1,35 @@
+export declare const Operation: {
+    readonly Raw: 0;
+    readonly DiceRoll: 1;
+    readonly CoinFlip: 2;
+    readonly NumberRange: 3;
+    readonly ChooseOne: 4;
+    readonly ChooseMany: 5;
+    readonly Shuffle: 6;
+};
+export interface MappingSpec {
+    operation: number;
+    lower: bigint;
+    upper: bigint;
+    count: number;
+    population: number;
+}
+export declare const builtins: {
+    raw: () => MappingSpec;
+    diceRoll: (sides: bigint, count?: number) => MappingSpec;
+    dN: (sides: bigint) => MappingSpec;
+    d20: () => MappingSpec;
+    d12: () => MappingSpec;
+    d10: () => MappingSpec;
+    d8: () => MappingSpec;
+    d6: () => MappingSpec;
+    d4: () => MappingSpec;
+    coinFlip: () => MappingSpec;
+    numberRange: (min: bigint, max: bigint) => MappingSpec;
+    chooseOne: (size: number) => MappingSpec;
+    chooseMany: (size: number, count: number) => MappingSpec;
+    shuffle: (size: number) => MappingSpec;
+};
+export declare function validateMapping(s: MappingSpec): void;
+export declare function hashMapping(s: MappingSpec): string;
+export declare function mapRandomness(randomness: string, s: MappingSpec): bigint[];

package/dist/mapping.js

@@ -0,0 +1,97 @@
+import { AbiCoder, id, keccak256 } from "ethers";
+export const Operation = { Raw: 0, DiceRoll: 1, CoinFlip: 2, NumberRange: 3, ChooseOne: 4, ChooseMany: 5, Shuffle: 6 };
+const MAX = (1n << 256n) - 1n;
+const abi = AbiCoder.defaultAbiCoder();
+const MAP_DOMAIN = id("D20_MAP");
+function spec(operation, lower = 0n, upper = 0n, count = 1, population = 0) {
+    const result = { operation, lower, upper, count, population };
+    validateMapping(result);
+    return result;
+}
+export const builtins = {
+    raw: () => spec(Operation.Raw, 0n, 0n, 0),
+    diceRoll: (sides, count = 1) => spec(Operation.DiceRoll, 0n, sides, count),
+    dN: (sides) => spec(Operation.DiceRoll, 0n, sides),
+    d20: () => spec(Operation.DiceRoll, 0n, 20n),
+    d12: () => spec(Operation.DiceRoll, 0n, 12n),
+    d10: () => spec(Operation.DiceRoll, 0n, 10n),
+    d8: () => spec(Operation.DiceRoll, 0n, 8n),
+    d6: () => spec(Operation.DiceRoll, 0n, 6n),
+    d4: () => spec(Operation.DiceRoll, 0n, 4n),
+    coinFlip: () => spec(Operation.CoinFlip),
+    numberRange: (min, max) => spec(Operation.NumberRange, min, max),
+    chooseOne: (size) => spec(Operation.ChooseOne, 0n, 0n, 1, size),
+    chooseMany: (size, count) => spec(Operation.ChooseMany, 0n, 0n, count, size),
+    shuffle: (size) => spec(Operation.Shuffle, 0n, 0n, size, size),
+};
+export function validateMapping(s) {
+    const bad = () => { throw new Error("Invalid mapping parameters"); };
+    if (!Number.isInteger(s.operation) || s.operation < 0 || s.operation > 6 ||
+        !Number.isInteger(s.count) || !Number.isInteger(s.population) ||
+        s.count < 0 || s.population < 0 || s.lower < 0n || s.upper < 0n || s.lower > MAX || s.upper > MAX)
+        bad();
+    switch (s.operation) {
+        case Operation.Raw:
+            if (s.lower !== 0n || s.upper !== 0n || s.count !== 0 || s.population !== 0)
+                bad();
+            break;
+        case Operation.DiceRoll:
+            if (s.lower !== 0n || s.upper < 2n || s.count < 1 || s.count > 128 || s.population !== 0)
+                bad();
+            break;
+        case Operation.CoinFlip:
+            if (s.lower !== 0n || s.upper !== 0n || s.count !== 1 || s.population !== 0)
+                bad();
+            break;
+        case Operation.NumberRange:
+            if (s.lower > s.upper || s.count !== 1 || s.population !== 0)
+                bad();
+            break;
+        default:
+            if (s.lower !== 0n || s.upper !== 0n || s.population < 1 || s.population > 256)
+                bad();
+            if (s.operation === Operation.ChooseOne && s.count !== 1)
+                bad();
+            if (s.operation === Operation.ChooseMany && (s.count < 1 || s.count > s.population))
+                bad();
+            if (s.operation === Operation.Shuffle && s.count !== s.population)
+                bad();
+    }
+}
+export function hashMapping(s) {
+    validateMapping(s);
+    return keccak256(abi.encode(["uint8", "uint256", "uint256", "uint32", "uint32"], [s.operation, s.lower, s.upper, s.count, s.population]));
+}
+export function mapRandomness(randomness, s) {
+    validateMapping(s);
+    if (!/^0x[0-9a-fA-F]{64}$/.test(randomness))
+        throw new Error("Expected bytes32 randomness");
+    let cursor = 0n;
+    const next = () => BigInt(keccak256(abi.encode(["bytes32", "bytes32", "uint256"], [MAP_DOMAIN, randomness, cursor++])));
+    const sample = (bound) => {
+        const threshold = (1n << 256n) % bound;
+        let word;
+        do {
+            word = next();
+        } while (word < threshold);
+        return word % bound;
+    };
+    switch (s.operation) {
+        case Operation.Raw: return [BigInt(randomness)];
+        case Operation.DiceRoll: return Array.from({ length: s.count }, () => sample(s.upper) + 1n);
+        case Operation.CoinFlip: return [sample(2n)];
+        case Operation.NumberRange:
+            return [s.lower === 0n && s.upper === MAX ? next() : s.lower + sample(s.upper - s.lower + 1n)];
+        case Operation.ChooseOne: return [sample(BigInt(s.population))];
+        default: {
+            const pool = Array.from({ length: s.population }, (_, i) => BigInt(i));
+            const output = [];
+            for (let i = 0; i < s.count; i++) {
+                const j = i + Number(sample(BigInt(s.population - i)));
+                [pool[i], pool[j]] = [pool[j], pool[i]];
+                output.push(pool[i]);
+            }
+            return output;
+        }
+    }
+}

package/dist/replay.d.ts

@@ -0,0 +1 @@
+export { replayEpochCoordinator as replayCoordinator, epochTranscriptHash as transcriptHash } from "./epoch.js";

package/dist/replay.js

@@ -0,0 +1 @@
+export { replayEpochCoordinator as replayCoordinator, epochTranscriptHash as transcriptHash } from "./epoch.js";