{ "contractName": "IWitOracleQueriable", "abi": [ { "inputs": [ { "internalType": "uint256", "name": "queryId", "type": "uint256" } ], "name": "deleteQuery", "outputs": [ { "internalType": "Witnet.QueryEvmReward", "name": "", "type": "uint72" } ], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "evmGasPrice", "type": "uint256" } ], "name": "estimateBaseFee", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "evmGasPrice", "type": "uint256" }, { "internalType": "uint24", "name": "callbackGas", "type": "uint24" } ], "name": "estimateBaseFeeWithCallback", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "evmGasPrice", "type": "uint256" }, { "internalType": "uint256", "name": "evmWitPrice", "type": "uint256" }, { "components": [ { "internalType": "uint16", "name": "witResultMaxSize", "type": "uint16" }, { "internalType": "uint16", "name": "witCommitteeSize", "type": "uint16" }, { "internalType": "uint64", "name": "witUnitaryReward", "type": "uint64" } ], "internalType": "struct Witnet.QuerySLA", "name": "querySLA", "type": "tuple" } ], "name": "estimateExtraFee", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "getNextQueryId", "outputs": [ { "internalType": "Witnet.QueryId", "name": "", "type": "uint64" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "Witnet.QueryId", "name": "queryId", "type": "uint64" } ], "name": "getQuery", "outputs": [ { "components": [ { "components": [ { "internalType": "address", "name": "requester", "type": "address" }, { "internalType": "uint24", "name": "callbackGas", "type": "uint24" }, { "internalType": "bytes", "name": "radonBytecode", "type": "bytes" }, { "internalType": "Witnet.RadonHash", "name": "radonHash", "type": "bytes32" } ], "internalType": "struct Witnet.QueryRequest", "name": "request", "type": "tuple" }, { "components": [ { "internalType": "address", "name": "reporter", "type": "address" }, { "internalType": "Witnet.Timestamp", "name": "resultTimestamp", "type": "uint64" }, { "internalType": "Witnet.TransactionHash", "name": "resultDrTxHash", "type": "bytes32" }, { "internalType": "bytes", "name": "resultCborBytes", "type": "bytes" }, { "internalType": "address", "name": "disputer", "type": "address" } ], "internalType": "struct Witnet.QueryResponse", "name": "response", "type": "tuple" }, { "components": [ { "internalType": "uint16", "name": "witResultMaxSize", "type": "uint16" }, { "internalType": "uint16", "name": "witCommitteeSize", "type": "uint16" }, { "internalType": "uint64", "name": "witUnitaryReward", "type": "uint64" } ], "internalType": "struct Witnet.QuerySLA", "name": "slaParams", "type": "tuple" }, { "internalType": "Witnet.QueryUUID", "name": "uuid", "type": "bytes15" }, { "internalType": "Witnet.QueryEvmReward", "name": "reward", "type": "uint72" }, { "internalType": "Witnet.BlockNumber", "name": "checkpoint", "type": "uint64" } ], "internalType": "struct Witnet.Query", "name": "", "type": "tuple" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "getQueryEvmReward", "outputs": [ { "internalType": "Witnet.QueryEvmReward", "name": "", "type": "uint72" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "Witnet.QueryId", "name": "", "type": "uint64" } ], "name": "getQueryRequest", "outputs": [ { "components": [ { "internalType": "address", "name": "requester", "type": "address" }, { "internalType": "uint24", "name": "callbackGas", "type": "uint24" }, { "internalType": "bytes", "name": "radonBytecode", "type": "bytes" }, { "internalType": "Witnet.RadonHash", "name": "radonHash", "type": "bytes32" } ], "internalType": "struct Witnet.QueryRequest", "name": "", "type": "tuple" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "Witnet.QueryId", "name": "", "type": "uint64" } ], "name": "getQueryResponse", "outputs": [ { "components": [ { "internalType": "address", "name": "reporter", "type": "address" }, { "internalType": "Witnet.Timestamp", "name": "resultTimestamp", "type": "uint64" }, { "internalType": "Witnet.TransactionHash", "name": "resultDrTxHash", "type": "bytes32" }, { "internalType": "bytes", "name": "resultCborBytes", "type": "bytes" }, { "internalType": "address", "name": "disputer", "type": "address" } ], "internalType": "struct Witnet.QueryResponse", "name": "", "type": "tuple" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "getQueryResult", "outputs": [ { "components": [ { "internalType": "enum Witnet.ResultStatus", "name": "status", "type": "uint8" }, { "internalType": "enum Witnet.RadonDataTypes", "name": "dataType", "type": "uint8" }, { "internalType": "Witnet.TransactionHash", "name": "drTxHash", "type": "bytes32" }, { "internalType": "uint256", "name": "finality", "type": "uint256" }, { "internalType": "Witnet.Timestamp", "name": "timestamp", "type": "uint64" }, { "components": [ { "components": [ { "internalType": "bytes", "name": "data", "type": "bytes" }, { "internalType": "uint256", "name": "cursor", "type": "uint256" } ], "internalType": "struct WitnetBuffer.Buffer", "name": "buffer", "type": "tuple" }, { "internalType": "uint8", "name": "initialByte", "type": "uint8" }, { "internalType": "uint8", "name": "majorType", "type": "uint8" }, { "internalType": "uint8", "name": "additionalInformation", "type": "uint8" }, { "internalType": "uint64", "name": "len", "type": "uint64" }, { "internalType": "uint64", "name": "tag", "type": "uint64" } ], "internalType": "struct WitnetCBOR.CBOR", "name": "value", "type": "tuple" } ], "internalType": "struct Witnet.DataResult", "name": "", "type": "tuple" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "getQueryResultStatus", "outputs": [ { "internalType": "enum Witnet.ResultStatus", "name": "", "type": "uint8" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "getQueryResultStatusDescription", "outputs": [ { "internalType": "string", "name": "", "type": "string" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "getQueryResultTrails", "outputs": [ { "internalType": "bytes32", "name": "queryUUID", "type": "bytes32" }, { "internalType": "Witnet.TransactionHash", "name": "resultDrTxHash", "type": "bytes32" }, { "internalType": "Witnet.Timestamp", "name": "resultTimestamp", "type": "uint64" }, { "internalType": "uint256", "name": "resultFinalityBlock", "type": "uint256" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "getQueryStatus", "outputs": [ { "internalType": "enum Witnet.QueryStatus", "name": "", "type": "uint8" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "getQueryStatusString", "outputs": [ { "internalType": "string", "name": "", "type": "string" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "uint256[]", "name": "", "type": "uint256[]" } ], "name": "getQueryStatusBatch", "outputs": [ { "internalType": "enum Witnet.QueryStatus[]", "name": "", "type": "uint8[]" } ], "stateMutability": "view", "type": "function" }, { "inputs": [ { "internalType": "Witnet.RadonHash", "name": "radonHash", "type": "bytes32" }, { "components": [ { "internalType": "uint16", "name": "witResultMaxSize", "type": "uint16" }, { "internalType": "uint16", "name": "witCommitteeSize", "type": "uint16" }, { "internalType": "uint64", "name": "witUnitaryReward", "type": "uint64" } ], "internalType": "struct Witnet.QuerySLA", "name": "", "type": "tuple" } ], "name": "queryData", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "payable", "type": "function" }, { "inputs": [ { "internalType": "Witnet.RadonHash", "name": "radonHash", "type": "bytes32" }, { "components": [ { "internalType": "uint16", "name": "witResultMaxSize", "type": "uint16" }, { "internalType": "uint16", "name": "witCommitteeSize", "type": "uint16" }, { "internalType": "uint64", "name": "witUnitaryReward", "type": "uint64" } ], "internalType": "struct Witnet.QuerySLA", "name": "", "type": "tuple" }, { "components": [ { "internalType": "address", "name": "consumer", "type": "address" }, { "internalType": "uint24", "name": "gasLimit", "type": "uint24" } ], "internalType": "struct Witnet.QueryCallback", "name": "", "type": "tuple" } ], "name": "queryDataWithCallback", "outputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "stateMutability": "payable", "type": "function" }, { "inputs": [ { "internalType": "uint256", "name": "", "type": "uint256" } ], "name": "upgradeQueryEvmReward", "outputs": [], "stateMutability": "payable", "type": "function" } ], "metadata": "{\"compiler\":{\"version\":\"0.8.30+commit.73712a01\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"queryId\",\"type\":\"uint256\"}],\"name\":\"deleteQuery\",\"outputs\":[{\"internalType\":\"Witnet.QueryEvmReward\",\"name\":\"\",\"type\":\"uint72\"}],\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"evmGasPrice\",\"type\":\"uint256\"}],\"name\":\"estimateBaseFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"evmGasPrice\",\"type\":\"uint256\"},{\"internalType\":\"uint24\",\"name\":\"callbackGas\",\"type\":\"uint24\"}],\"name\":\"estimateBaseFeeWithCallback\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"evmGasPrice\",\"type\":\"uint256\"},{\"internalType\":\"uint256\",\"name\":\"evmWitPrice\",\"type\":\"uint256\"},{\"components\":[{\"internalType\":\"uint16\",\"name\":\"witResultMaxSize\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"witCommitteeSize\",\"type\":\"uint16\"},{\"internalType\":\"uint64\",\"name\":\"witUnitaryReward\",\"type\":\"uint64\"}],\"internalType\":\"struct Witnet.QuerySLA\",\"name\":\"querySLA\",\"type\":\"tuple\"}],\"name\":\"estimateExtraFee\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[],\"name\":\"getNextQueryId\",\"outputs\":[{\"internalType\":\"Witnet.QueryId\",\"name\":\"\",\"type\":\"uint64\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"Witnet.QueryId\",\"name\":\"queryId\",\"type\":\"uint64\"}],\"name\":\"getQuery\",\"outputs\":[{\"components\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"requester\",\"type\":\"address\"},{\"internalType\":\"uint24\",\"name\":\"callbackGas\",\"type\":\"uint24\"},{\"internalType\":\"bytes\",\"name\":\"radonBytecode\",\"type\":\"bytes\"},{\"internalType\":\"Witnet.RadonHash\",\"name\":\"radonHash\",\"type\":\"bytes32\"}],\"internalType\":\"struct Witnet.QueryRequest\",\"name\":\"request\",\"type\":\"tuple\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"reporter\",\"type\":\"address\"},{\"internalType\":\"Witnet.Timestamp\",\"name\":\"resultTimestamp\",\"type\":\"uint64\"},{\"internalType\":\"Witnet.TransactionHash\",\"name\":\"resultDrTxHash\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"resultCborBytes\",\"type\":\"bytes\"},{\"internalType\":\"address\",\"name\":\"disputer\",\"type\":\"address\"}],\"internalType\":\"struct Witnet.QueryResponse\",\"name\":\"response\",\"type\":\"tuple\"},{\"components\":[{\"internalType\":\"uint16\",\"name\":\"witResultMaxSize\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"witCommitteeSize\",\"type\":\"uint16\"},{\"internalType\":\"uint64\",\"name\":\"witUnitaryReward\",\"type\":\"uint64\"}],\"internalType\":\"struct Witnet.QuerySLA\",\"name\":\"slaParams\",\"type\":\"tuple\"},{\"internalType\":\"Witnet.QueryUUID\",\"name\":\"uuid\",\"type\":\"bytes15\"},{\"internalType\":\"Witnet.QueryEvmReward\",\"name\":\"reward\",\"type\":\"uint72\"},{\"internalType\":\"Witnet.BlockNumber\",\"name\":\"checkpoint\",\"type\":\"uint64\"}],\"internalType\":\"struct Witnet.Query\",\"name\":\"\",\"type\":\"tuple\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"getQueryEvmReward\",\"outputs\":[{\"internalType\":\"Witnet.QueryEvmReward\",\"name\":\"\",\"type\":\"uint72\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"Witnet.QueryId\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"getQueryRequest\",\"outputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"requester\",\"type\":\"address\"},{\"internalType\":\"uint24\",\"name\":\"callbackGas\",\"type\":\"uint24\"},{\"internalType\":\"bytes\",\"name\":\"radonBytecode\",\"type\":\"bytes\"},{\"internalType\":\"Witnet.RadonHash\",\"name\":\"radonHash\",\"type\":\"bytes32\"}],\"internalType\":\"struct Witnet.QueryRequest\",\"name\":\"\",\"type\":\"tuple\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"Witnet.QueryId\",\"name\":\"\",\"type\":\"uint64\"}],\"name\":\"getQueryResponse\",\"outputs\":[{\"components\":[{\"internalType\":\"address\",\"name\":\"reporter\",\"type\":\"address\"},{\"internalType\":\"Witnet.Timestamp\",\"name\":\"resultTimestamp\",\"type\":\"uint64\"},{\"internalType\":\"Witnet.TransactionHash\",\"name\":\"resultDrTxHash\",\"type\":\"bytes32\"},{\"internalType\":\"bytes\",\"name\":\"resultCborBytes\",\"type\":\"bytes\"},{\"internalType\":\"address\",\"name\":\"disputer\",\"type\":\"address\"}],\"internalType\":\"struct Witnet.QueryResponse\",\"name\":\"\",\"type\":\"tuple\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"getQueryResult\",\"outputs\":[{\"components\":[{\"internalType\":\"enum Witnet.ResultStatus\",\"name\":\"status\",\"type\":\"uint8\"},{\"internalType\":\"enum Witnet.RadonDataTypes\",\"name\":\"dataType\",\"type\":\"uint8\"},{\"internalType\":\"Witnet.TransactionHash\",\"name\":\"drTxHash\",\"type\":\"bytes32\"},{\"internalType\":\"uint256\",\"name\":\"finality\",\"type\":\"uint256\"},{\"internalType\":\"Witnet.Timestamp\",\"name\":\"timestamp\",\"type\":\"uint64\"},{\"components\":[{\"components\":[{\"internalType\":\"bytes\",\"name\":\"data\",\"type\":\"bytes\"},{\"internalType\":\"uint256\",\"name\":\"cursor\",\"type\":\"uint256\"}],\"internalType\":\"struct WitnetBuffer.Buffer\",\"name\":\"buffer\",\"type\":\"tuple\"},{\"internalType\":\"uint8\",\"name\":\"initialByte\",\"type\":\"uint8\"},{\"internalType\":\"uint8\",\"name\":\"majorType\",\"type\":\"uint8\"},{\"internalType\":\"uint8\",\"name\":\"additionalInformation\",\"type\":\"uint8\"},{\"internalType\":\"uint64\",\"name\":\"len\",\"type\":\"uint64\"},{\"internalType\":\"uint64\",\"name\":\"tag\",\"type\":\"uint64\"}],\"internalType\":\"struct WitnetCBOR.CBOR\",\"name\":\"value\",\"type\":\"tuple\"}],\"internalType\":\"struct Witnet.DataResult\",\"name\":\"\",\"type\":\"tuple\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"getQueryResultStatus\",\"outputs\":[{\"internalType\":\"enum Witnet.ResultStatus\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"getQueryResultStatusDescription\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"getQueryResultTrails\",\"outputs\":[{\"internalType\":\"bytes32\",\"name\":\"queryUUID\",\"type\":\"bytes32\"},{\"internalType\":\"Witnet.TransactionHash\",\"name\":\"resultDrTxHash\",\"type\":\"bytes32\"},{\"internalType\":\"Witnet.Timestamp\",\"name\":\"resultTimestamp\",\"type\":\"uint64\"},{\"internalType\":\"uint256\",\"name\":\"resultFinalityBlock\",\"type\":\"uint256\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"getQueryStatus\",\"outputs\":[{\"internalType\":\"enum Witnet.QueryStatus\",\"name\":\"\",\"type\":\"uint8\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256[]\",\"name\":\"\",\"type\":\"uint256[]\"}],\"name\":\"getQueryStatusBatch\",\"outputs\":[{\"internalType\":\"enum Witnet.QueryStatus[]\",\"name\":\"\",\"type\":\"uint8[]\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"getQueryStatusString\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"stateMutability\":\"view\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"Witnet.RadonHash\",\"name\":\"radonHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"uint16\",\"name\":\"witResultMaxSize\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"witCommitteeSize\",\"type\":\"uint16\"},{\"internalType\":\"uint64\",\"name\":\"witUnitaryReward\",\"type\":\"uint64\"}],\"internalType\":\"struct Witnet.QuerySLA\",\"name\":\"\",\"type\":\"tuple\"}],\"name\":\"queryData\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"Witnet.RadonHash\",\"name\":\"radonHash\",\"type\":\"bytes32\"},{\"components\":[{\"internalType\":\"uint16\",\"name\":\"witResultMaxSize\",\"type\":\"uint16\"},{\"internalType\":\"uint16\",\"name\":\"witCommitteeSize\",\"type\":\"uint16\"},{\"internalType\":\"uint64\",\"name\":\"witUnitaryReward\",\"type\":\"uint64\"}],\"internalType\":\"struct Witnet.QuerySLA\",\"name\":\"\",\"type\":\"tuple\"},{\"components\":[{\"internalType\":\"address\",\"name\":\"consumer\",\"type\":\"address\"},{\"internalType\":\"uint24\",\"name\":\"gasLimit\",\"type\":\"uint24\"}],\"internalType\":\"struct Witnet.QueryCallback\",\"name\":\"\",\"type\":\"tuple\"}],\"name\":\"queryDataWithCallback\",\"outputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"stateMutability\":\"payable\",\"type\":\"function\"},{\"inputs\":[{\"internalType\":\"uint256\",\"name\":\"\",\"type\":\"uint256\"}],\"name\":\"upgradeQueryEvmReward\",\"outputs\":[],\"stateMutability\":\"payable\",\"type\":\"function\"}],\"devdoc\":{\"kind\":\"dev\",\"methods\":{\"deleteQuery(uint256)\":{\"details\":\"Fails if the query is not in a final status, or not called from the actual requester.\",\"params\":{\"queryId\":\"The unique query identifier.\"}},\"estimateBaseFee(uint256)\":{\"params\":{\"evmGasPrice\":\"Expected gas price to pay upon posting the data request.\"}},\"estimateBaseFeeWithCallback(uint256,uint24)\":{\"params\":{\"callbackGas\":\"Maximum gas to be spent when reporting the data request result.\",\"evmGasPrice\":\"Expected gas price to pay upon posting the data request.\"}},\"estimateExtraFee(uint256,uint256,(uint16,uint16,uint64))\":{\"details\":\"The extra fee gets calculated in proportion to:\",\"params\":{\"evmGasPrice\":\"Tentative EVM gas price at the moment the query result is ready.\",\"evmWitPrice\":\"Tentative nanoWit price in Wei at the moment the query is solved on the Wit/Oracle blockchain.\",\"querySLA\":\"The query SLA data security parameters as required for the Wit/Oracle blockchain. \"}},\"queryData(bytes32,(uint16,uint16,uint64))\":{\"details\":\"Reasons to revert:- the data request's RAD hash was not previously verified into the WitOracleRadonRegistry contract;- invalid query SLA parameters were provided;- insufficient value is paid as reward.\",\"params\":{\"radonHash\":\"The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. \"}},\"queryDataWithCallback(bytes32,(uint16,uint16,uint64),(address,uint24))\":{\"details\":\"Reasons to revert:- the data request's RAD hash was not previously verified into the Radon Registry;- invalid query SLA parameters were provided;- insufficient value is paid as reward.- passed `consumer` is not a contract implementing the IWitOracleQueriableConsumer interface;\",\"params\":{\"radonHash\":\"The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. \"}}},\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"deleteQuery(uint256)\":{\"notice\":\"Removes all query data from storage. Pays back reward on expired queries.\"},\"estimateBaseFee(uint256)\":{\"notice\":\"Estimate the minimum reward required for posting a data request.\"},\"estimateBaseFeeWithCallback(uint256,uint24)\":{\"notice\":\"Estimate the minimum reward required for posting a data request with a callback.\"},\"estimateExtraFee(uint256,uint256,(uint16,uint16,uint64))\":{\"notice\":\"Estimate the extra reward (i.e. over the base fee) to be paid when posting a newdata query in order to avoid getting provable \\\"too low incentives\\\" results fromthe Wit/Oracle blockchain. \"},\"getNextQueryId()\":{\"notice\":\"Returns next query id to be generated by the Witnet Request Board.\"},\"getQuery(uint64)\":{\"notice\":\"Gets the whole Query data contents, if any, no matter its current status.\"},\"getQueryEvmReward(uint256)\":{\"notice\":\"Gets the current EVM reward the reporter can claim, if not done yet.\"},\"getQueryRequest(uint64)\":{\"notice\":\"Retrieves the RAD hash and SLA parameters of the given query.\"},\"getQueryResponse(uint64)\":{\"notice\":\"Retrieves the whole `Witnet.QueryResponse` record referred to a previously posted Witnet Data Request.\"},\"getQueryResultTrails(uint256)\":{\"notice\":\"Gets query's result back tracing trails\"},\"getQueryStatus(uint256)\":{\"notice\":\"Gets current status of given query.\"},\"getQueryStatusBatch(uint256[])\":{\"notice\":\"Get current status of all given query ids.\"},\"queryData(bytes32,(uint16,uint16,uint64))\":{\"notice\":\"Request real world data from the Wit/Oracle sidechain. The paid fee is escrowed as a reward for the reporter that eventually relays back a valid query result from the Wit/Oracle sidechain.Query results are CBOR-encoded, and can contain either some data, or an error.\"},\"queryDataWithCallback(bytes32,(uint16,uint16,uint64),(address,uint24))\":{\"notice\":\"Request real world data from the Wit/Oracle sidechain. The paid fee is escrowed as a reward for the reporter that eventually relays back a valid query result from the Wit/Oracle sidechain.The Witnet-provable result will be reported directly to the requesting contract. Query results are CBOR-encoded, and can contain either some data, or an error.\"},\"upgradeQueryEvmReward(uint256)\":{\"notice\":\"Increments the reward of a previously posted request by adding the transaction value to it.\"}},\"version\":1}},\"settings\":{\"compilationTarget\":{\"project:/contracts/interfaces/IWitOracleQueriable.sol\":\"IWitOracleQueriable\"},\"evmVersion\":\"prague\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"project:/contracts/interfaces/IWitOracleQueriable.sol\":{\"keccak256\":\"0xdb0da1e377a35a7d620f43cb583a876750a52d91da2b888f48042483ad9c4910\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://edfcdf3e96ec3c5de7438f82e3d5a1dc9af9eb29080044213dccb26ff978354c\",\"dweb:/ipfs/Qmap2FzSysh2fug88eortbsTM7itFygRzKc9HfV43ePMik\"]},\"project:/contracts/libs/Bech32.sol\":{\"keccak256\":\"0x14618323a0efe7586c20906a2e9cee7ad63baa976ff231c57f7f2d7d3707fb8b\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://a19f05fe84047a7a6d3d6fc39972b432e6e536aa70472386a9d7a6d9aab64a64\",\"dweb:/ipfs/QmcHwUY66yjiotRH4Q3kbRvSzcHyLQ1yHL3KbtQKiMhtZE\"]},\"project:/contracts/libs/Secp256k1.sol\":{\"keccak256\":\"0xbe686002da5004ff39dd70709f3820eba2afe9323ae9cb894009c161e4b1a666\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://18fab91775216de0707cea9ad285b10be09127461a13432fea358bf9cb2a0c2e\",\"dweb:/ipfs/QmeRUGsgstnM4hxM9hpkBf3L6cE5btirEaowcMxmuw3utj\"]},\"project:/contracts/libs/Witnet.sol\":{\"keccak256\":\"0x1d446c3e534e40e676d1763bfb2897fadfac8afed904ab757843d7d6770b0a6c\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://338fb1073f17d64e8d31bfe492d9475ce906788ee08e6489ce30413f91dc1328\",\"dweb:/ipfs/QmPe5QX2AGTnQFjse1Xttq4ZYWwYAiXoySb5VUui3PqPhk\"]},\"project:/contracts/libs/WitnetBuffer.sol\":{\"keccak256\":\"0x8e07aebe2954ab3e6f2d8eceedb12db7cf915c1f3e8630f4fa9999cecb1c78ec\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://ed6c54cc901183d61546e8fd15bd5ea8ef238ebc915642946071d435dd7481ea\",\"dweb:/ipfs/Qmcaqta7YjUSBbBUGqoh44bsCS6UqqoyHjBuz4qnKBShXM\"]},\"project:/contracts/libs/WitnetCBOR.sol\":{\"keccak256\":\"0xd99308373575cc10fb7f2ceb0f6a8625f3911275c1fa27811fae498d98d03d97\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://b4909a999d7b660a2dc54ca957b6eccfa523e2765fc4d6a2574dee7d5cd67b43\",\"dweb:/ipfs/QmWGQT4KDcfSFe1hcHVoWx6E4PhYMaod5iLpJCWBEeShzh\"]}},\"version\":1}", "bytecode": "0x", "deployedBytecode": "0x", "immutableReferences": {}, "generatedSources": [], "deployedGeneratedSources": [], "sourceMap": "", "deployedSourceMap": "", "source": "// SPDX-License-Identifier: MIT\r\n\r\npragma solidity >=0.8.0 <0.9.0;\r\n\r\nimport \"../libs/Witnet.sol\";\r\n\r\ninterface IWitOracleQueriable {\r\n \r\n /// @notice Removes all query data from storage. Pays back reward on expired queries.\r\n /// @dev Fails if the query is not in a final status, or not called from the actual requester.\r\n /// @param queryId The unique query identifier.\r\n function deleteQuery(uint256 queryId) external returns (Witnet.QueryEvmReward);\r\n\r\n /// @notice Estimate the minimum reward required for posting a data request.\r\n /// @param evmGasPrice Expected gas price to pay upon posting the data request.\r\n function estimateBaseFee(uint256 evmGasPrice) external view returns (uint256);\r\n \r\n /// @notice Estimate the minimum reward required for posting a data request with a callback.\r\n /// @param evmGasPrice Expected gas price to pay upon posting the data request.\r\n /// @param callbackGas Maximum gas to be spent when reporting the data request result.\r\n function estimateBaseFeeWithCallback(uint256 evmGasPrice, uint24 callbackGas) external view returns (uint256);\r\n\r\n /// @notice Estimate the extra reward (i.e. over the base fee) to be paid when posting a new\r\n /// @notice data query in order to avoid getting provable \"too low incentives\" results from\r\n /// @notice the Wit/Oracle blockchain. \r\n /// @dev The extra fee gets calculated in proportion to:\r\n /// @param evmGasPrice Tentative EVM gas price at the moment the query result is ready.\r\n /// @param evmWitPrice Tentative nanoWit price in Wei at the moment the query is solved on the Wit/Oracle blockchain.\r\n /// @param querySLA The query SLA data security parameters as required for the Wit/Oracle blockchain. \r\n function estimateExtraFee(uint256 evmGasPrice, uint256 evmWitPrice, Witnet.QuerySLA calldata querySLA) external view returns (uint256);\r\n\r\n /// @notice Returns next query id to be generated by the Witnet Request Board.\r\n function getNextQueryId() external view returns (Witnet.QueryId);\r\n\r\n /// @notice Gets the whole Query data contents, if any, no matter its current status.\r\n function getQuery(Witnet.QueryId queryId) external view returns (Witnet.Query memory);\r\n\r\n /// @notice Gets the current EVM reward the reporter can claim, if not done yet.\r\n function getQueryEvmReward(uint256) external view returns (Witnet.QueryEvmReward);\r\n\r\n /// @notice Retrieves the RAD hash and SLA parameters of the given query.\r\n function getQueryRequest(Witnet.QueryId) external view returns (Witnet.QueryRequest memory);\r\n\r\n /// @notice Retrieves the whole `Witnet.QueryResponse` record referred to a previously posted Witnet Data Request.\r\n function getQueryResponse(Witnet.QueryId) external view returns (Witnet.QueryResponse memory);\r\n\r\n function getQueryResult(uint256) external view returns (Witnet.DataResult memory);\r\n function getQueryResultStatus(uint256) external view returns (Witnet.ResultStatus);\r\n function getQueryResultStatusDescription(uint256) external view returns (string memory);\r\n \r\n /// @notice Gets query's result back tracing trails\r\n function getQueryResultTrails(uint256) \r\n external view returns (\r\n bytes32 queryUUID,\r\n Witnet.TransactionHash resultDrTxHash,\r\n Witnet.Timestamp resultTimestamp,\r\n uint256 resultFinalityBlock\r\n );\r\n\r\n /// @notice Gets current status of given query.\r\n function getQueryStatus(uint256) external view returns (Witnet.QueryStatus);\r\n function getQueryStatusString(uint256) external view returns (string memory);\r\n \r\n /// @notice Get current status of all given query ids.\r\n function getQueryStatusBatch(uint256[] calldata) external view returns (Witnet.QueryStatus[] memory);\r\n\r\n /// @notice Request real world data from the Wit/Oracle sidechain. \r\n /// @notice The paid fee is escrowed as a reward for the reporter that eventually relays back \r\n /// @notice a valid query result from the Wit/Oracle sidechain.\r\n /// @notice Query results are CBOR-encoded, and can contain either some data, or an error.\r\n /// @dev Reasons to revert:\r\n /// @dev - the data request's RAD hash was not previously verified into the WitOracleRadonRegistry contract;\r\n /// @dev - invalid query SLA parameters were provided;\r\n /// @dev - insufficient value is paid as reward.\r\n /// @param radonHash The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. \r\n function queryData(\r\n Witnet.RadonHash radonHash,\r\n Witnet.QuerySLA calldata\r\n )\r\n external payable returns (uint256);\r\n\r\n /// @notice Request real world data from the Wit/Oracle sidechain. \r\n /// @notice The paid fee is escrowed as a reward for the reporter that eventually relays back \r\n /// @notice a valid query result from the Wit/Oracle sidechain.\r\n /// @notice The Witnet-provable result will be reported directly to the requesting contract. \r\n /// @notice Query results are CBOR-encoded, and can contain either some data, or an error.\r\n /// @dev Reasons to revert:\r\n /// @dev - the data request's RAD hash was not previously verified into the Radon Registry;\r\n /// @dev - invalid query SLA parameters were provided;\r\n /// @dev - insufficient value is paid as reward.\r\n /// @dev - passed `consumer` is not a contract implementing the IWitOracleQueriableConsumer interface;\r\n /// @param radonHash The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. \r\n function queryDataWithCallback(\r\n Witnet.RadonHash radonHash, \r\n Witnet.QuerySLA calldata, \r\n Witnet.QueryCallback calldata\r\n )\r\n external payable returns (uint256);\r\n\r\n /// @notice Increments the reward of a previously posted request by adding the transaction value to it.\r\n function upgradeQueryEvmReward(uint256) external payable;\r\n}", "sourcePath": "C:\\Users\\guill\\github\\guidiaz\\witnet-solidity-bridge\\contracts\\interfaces\\IWitOracleQueriable.sol", "ast": { "absolutePath": "project:/contracts/interfaces/IWitOracleQueriable.sol", "exportedSymbols": { "Bech32": [ 31372 ], "IWitOracleQueriable": [ 26795 ], "Secp256k1": [ 32535 ], "Witnet": [ 40741 ], "WitnetBuffer": [ 42631 ], "WitnetCBOR": [ 44174 ] }, "id": 26796, "license": "MIT", "nodeType": "SourceUnit", "nodes": [ { "id": 26608, "literals": [ "solidity", ">=", "0.8", ".0", "<", "0.9", ".0" ], "nodeType": "PragmaDirective", "src": "35:31:67" }, { "absolutePath": "project:/contracts/libs/Witnet.sol", "file": "../libs/Witnet.sol", "id": 26609, "nameLocation": "-1:-1:-1", "nodeType": "ImportDirective", "scope": 26796, "sourceUnit": 40742, "src": "70:28:67", "symbolAliases": [], "unitAlias": "" }, { "abstract": false, "baseContracts": [], "canonicalName": "IWitOracleQueriable", "contractDependencies": [], "contractKind": "interface", "fullyImplemented": false, "id": 26795, "linearizedBaseContracts": [ 26795 ], "name": "IWitOracleQueriable", "nameLocation": "112:19:67", "nodeType": "ContractDefinition", "nodes": [ { "documentation": { "id": 26610, "nodeType": "StructuredDocumentation", "src": "145:238:67", "text": "@notice Removes all query data from storage. Pays back reward on expired queries.\n @dev Fails if the query is not in a final status, or not called from the actual requester.\n @param queryId The unique query identifier." }, "functionSelector": "7c1fbda3", "id": 26618, "implemented": false, "kind": "function", "modifiers": [], "name": "deleteQuery", "nameLocation": "398:11:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26613, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26612, "mutability": "mutable", "name": "queryId", "nameLocation": "418:7:67", "nodeType": "VariableDeclaration", "scope": 26618, "src": "410:15:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26611, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "410:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "409:17:67" }, "returnParameters": { "id": 26617, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26616, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26618, "src": "445:21:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryEvmReward_$37147", "typeString": "Witnet.QueryEvmReward" }, "typeName": { "id": 26615, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26614, "name": "Witnet.QueryEvmReward", "nameLocations": [ "445:6:67", "452:14:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37147, "src": "445:21:67" }, "referencedDeclaration": 37147, "src": "445:21:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryEvmReward_$37147", "typeString": "Witnet.QueryEvmReward" } }, "visibility": "internal" } ], "src": "444:23:67" }, "scope": 26795, "src": "389:79:67", "stateMutability": "nonpayable", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26619, "nodeType": "StructuredDocumentation", "src": "476:161:67", "text": "@notice Estimate the minimum reward required for posting a data request.\n @param evmGasPrice Expected gas price to pay upon posting the data request." }, "functionSelector": "39a8653e", "id": 26626, "implemented": false, "kind": "function", "modifiers": [], "name": "estimateBaseFee", "nameLocation": "652:15:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26622, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26621, "mutability": "mutable", "name": "evmGasPrice", "nameLocation": "676:11:67", "nodeType": "VariableDeclaration", "scope": 26626, "src": "668:19:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26620, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "668:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "667:21:67" }, "returnParameters": { "id": 26625, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26624, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26626, "src": "712:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26623, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "712:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "711:9:67" }, "scope": 26795, "src": "643:78:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26627, "nodeType": "StructuredDocumentation", "src": "733:269:67", "text": "@notice Estimate the minimum reward required for posting a data request with a callback.\n @param evmGasPrice Expected gas price to pay upon posting the data request.\n @param callbackGas Maximum gas to be spent when reporting the data request result." }, "functionSelector": "05e742ef", "id": 26636, "implemented": false, "kind": "function", "modifiers": [], "name": "estimateBaseFeeWithCallback", "nameLocation": "1017:27:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26632, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26629, "mutability": "mutable", "name": "evmGasPrice", "nameLocation": "1053:11:67", "nodeType": "VariableDeclaration", "scope": 26636, "src": "1045:19:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26628, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "1045:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" }, { "constant": false, "id": 26631, "mutability": "mutable", "name": "callbackGas", "nameLocation": "1073:11:67", "nodeType": "VariableDeclaration", "scope": 26636, "src": "1066:18:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint24", "typeString": "uint24" }, "typeName": { "id": 26630, "name": "uint24", "nodeType": "ElementaryTypeName", "src": "1066:6:67", "typeDescriptions": { "typeIdentifier": "t_uint24", "typeString": "uint24" } }, "visibility": "internal" } ], "src": "1044:41:67" }, "returnParameters": { "id": 26635, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26634, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26636, "src": "1109:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26633, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "1109:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "1108:9:67" }, "scope": 26795, "src": "1008:110:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26637, "nodeType": "StructuredDocumentation", "src": "1126:621:67", "text": "@notice Estimate the extra reward (i.e. over the base fee) to be paid when posting a new\n @notice data query in order to avoid getting provable \"too low incentives\" results from\n @notice the Wit/Oracle blockchain. \n @dev The extra fee gets calculated in proportion to:\n @param evmGasPrice Tentative EVM gas price at the moment the query result is ready.\n @param evmWitPrice Tentative nanoWit price in Wei at the moment the query is solved on the Wit/Oracle blockchain.\n @param querySLA The query SLA data security parameters as required for the Wit/Oracle blockchain. " }, "functionSelector": "d0a92a08", "id": 26649, "implemented": false, "kind": "function", "modifiers": [], "name": "estimateExtraFee", "nameLocation": "1762:16:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26645, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26639, "mutability": "mutable", "name": "evmGasPrice", "nameLocation": "1787:11:67", "nodeType": "VariableDeclaration", "scope": 26649, "src": "1779:19:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26638, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "1779:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" }, { "constant": false, "id": 26641, "mutability": "mutable", "name": "evmWitPrice", "nameLocation": "1808:11:67", "nodeType": "VariableDeclaration", "scope": 26649, "src": "1800:19:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26640, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "1800:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" }, { "constant": false, "id": 26644, "mutability": "mutable", "name": "querySLA", "nameLocation": "1846:8:67", "nodeType": "VariableDeclaration", "scope": 26649, "src": "1821:33:67", "stateVariable": false, "storageLocation": "calldata", "typeDescriptions": { "typeIdentifier": "t_struct$_QuerySLA_$37373_calldata_ptr", "typeString": "struct Witnet.QuerySLA" }, "typeName": { "id": 26643, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26642, "name": "Witnet.QuerySLA", "nameLocations": [ "1821:6:67", "1828:8:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37373, "src": "1821:15:67" }, "referencedDeclaration": 37373, "src": "1821:15:67", "typeDescriptions": { "typeIdentifier": "t_struct$_QuerySLA_$37373_storage_ptr", "typeString": "struct Witnet.QuerySLA" } }, "visibility": "internal" } ], "src": "1778:77:67" }, "returnParameters": { "id": 26648, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26647, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26649, "src": "1879:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26646, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "1879:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "1878:9:67" }, "scope": 26795, "src": "1753:135:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26650, "nodeType": "StructuredDocumentation", "src": "1896:78:67", "text": "@notice Returns next query id to be generated by the Witnet Request Board." }, "functionSelector": "c805dd0f", "id": 26656, "implemented": false, "kind": "function", "modifiers": [], "name": "getNextQueryId", "nameLocation": "1989:14:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26651, "nodeType": "ParameterList", "parameters": [], "src": "2003:2:67" }, "returnParameters": { "id": 26655, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26654, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26656, "src": "2029:14:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" }, "typeName": { "id": 26653, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26652, "name": "Witnet.QueryId", "nameLocations": [ "2029:6:67", "2036:7:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37151, "src": "2029:14:67" }, "referencedDeclaration": 37151, "src": "2029:14:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" } }, "visibility": "internal" } ], "src": "2028:16:67" }, "scope": 26795, "src": "1980:65:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26657, "nodeType": "StructuredDocumentation", "src": "2053:85:67", "text": "@notice Gets the whole Query data contents, if any, no matter its current status." }, "functionSelector": "8cfcdea2", "id": 26666, "implemented": false, "kind": "function", "modifiers": [], "name": "getQuery", "nameLocation": "2153:8:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26661, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26660, "mutability": "mutable", "name": "queryId", "nameLocation": "2177:7:67", "nodeType": "VariableDeclaration", "scope": 26666, "src": "2162:22:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" }, "typeName": { "id": 26659, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26658, "name": "Witnet.QueryId", "nameLocations": [ "2162:6:67", "2169:7:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37151, "src": "2162:14:67" }, "referencedDeclaration": 37151, "src": "2162:14:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" } }, "visibility": "internal" } ], "src": "2161:24:67" }, "returnParameters": { "id": 26665, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26664, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26666, "src": "2209:19:67", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_struct$_Query_$37326_memory_ptr", "typeString": "struct Witnet.Query" }, "typeName": { "id": 26663, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26662, "name": "Witnet.Query", "nameLocations": [ "2209:6:67", "2216:5:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37326, "src": "2209:12:67" }, "referencedDeclaration": 37326, "src": "2209:12:67", "typeDescriptions": { "typeIdentifier": "t_struct$_Query_$37326_storage_ptr", "typeString": "struct Witnet.Query" } }, "visibility": "internal" } ], "src": "2208:21:67" }, "scope": 26795, "src": "2144:86:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26667, "nodeType": "StructuredDocumentation", "src": "2238:80:67", "text": "@notice Gets the current EVM reward the reporter can claim, if not done yet." }, "functionSelector": "6fdaab7e", "id": 26675, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryEvmReward", "nameLocation": "2333:17:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26670, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26669, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26675, "src": "2351:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26668, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "2351:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "2350:9:67" }, "returnParameters": { "id": 26674, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26673, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26675, "src": "2383:21:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryEvmReward_$37147", "typeString": "Witnet.QueryEvmReward" }, "typeName": { "id": 26672, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26671, "name": "Witnet.QueryEvmReward", "nameLocations": [ "2383:6:67", "2390:14:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37147, "src": "2383:21:67" }, "referencedDeclaration": 37147, "src": "2383:21:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryEvmReward_$37147", "typeString": "Witnet.QueryEvmReward" } }, "visibility": "internal" } ], "src": "2382:23:67" }, "scope": 26795, "src": "2324:82:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26676, "nodeType": "StructuredDocumentation", "src": "2414:73:67", "text": "@notice Retrieves the RAD hash and SLA parameters of the given query." }, "functionSelector": "a667533f", "id": 26685, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryRequest", "nameLocation": "2502:15:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26680, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26679, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26685, "src": "2518:14:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" }, "typeName": { "id": 26678, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26677, "name": "Witnet.QueryId", "nameLocations": [ "2518:6:67", "2525:7:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37151, "src": "2518:14:67" }, "referencedDeclaration": 37151, "src": "2518:14:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" } }, "visibility": "internal" } ], "src": "2517:16:67" }, "returnParameters": { "id": 26684, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26683, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26685, "src": "2557:26:67", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_struct$_QueryRequest_$37351_memory_ptr", "typeString": "struct Witnet.QueryRequest" }, "typeName": { "id": 26682, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26681, "name": "Witnet.QueryRequest", "nameLocations": [ "2557:6:67", "2564:12:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37351, "src": "2557:19:67" }, "referencedDeclaration": 37351, "src": "2557:19:67", "typeDescriptions": { "typeIdentifier": "t_struct$_QueryRequest_$37351_storage_ptr", "typeString": "struct Witnet.QueryRequest" } }, "visibility": "internal" } ], "src": "2556:28:67" }, "scope": 26795, "src": "2493:92:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26686, "nodeType": "StructuredDocumentation", "src": "2593:114:67", "text": "@notice Retrieves the whole `Witnet.QueryResponse` record referred to a previously posted Witnet Data Request." }, "functionSelector": "ca7da98b", "id": 26695, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryResponse", "nameLocation": "2722:16:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26690, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26689, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26695, "src": "2739:14:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" }, "typeName": { "id": 26688, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26687, "name": "Witnet.QueryId", "nameLocations": [ "2739:6:67", "2746:7:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37151, "src": "2739:14:67" }, "referencedDeclaration": 37151, "src": "2739:14:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_QueryId_$37151", "typeString": "Witnet.QueryId" } }, "visibility": "internal" } ], "src": "2738:16:67" }, "returnParameters": { "id": 26694, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26693, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26695, "src": "2778:27:67", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_struct$_QueryResponse_$37365_memory_ptr", "typeString": "struct Witnet.QueryResponse" }, "typeName": { "id": 26692, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26691, "name": "Witnet.QueryResponse", "nameLocations": [ "2778:6:67", "2785:13:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37365, "src": "2778:20:67" }, "referencedDeclaration": 37365, "src": "2778:20:67", "typeDescriptions": { "typeIdentifier": "t_struct$_QueryResponse_$37365_storage_ptr", "typeString": "struct Witnet.QueryResponse" } }, "visibility": "internal" } ], "src": "2777:29:67" }, "scope": 26795, "src": "2713:94:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "functionSelector": "59209b39", "id": 26703, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryResult", "nameLocation": "2824:14:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26698, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26697, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26703, "src": "2839:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26696, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "2839:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "2838:9:67" }, "returnParameters": { "id": 26702, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26701, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26703, "src": "2871:24:67", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_struct$_DataResult_$37293_memory_ptr", "typeString": "struct Witnet.DataResult" }, "typeName": { "id": 26700, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26699, "name": "Witnet.DataResult", "nameLocations": [ "2871:6:67", "2878:10:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37293, "src": "2871:17:67" }, "referencedDeclaration": 37293, "src": "2871:17:67", "typeDescriptions": { "typeIdentifier": "t_struct$_DataResult_$37293_storage_ptr", "typeString": "struct Witnet.DataResult" } }, "visibility": "internal" } ], "src": "2870:26:67" }, "scope": 26795, "src": "2815:82:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "functionSelector": "4cddf615", "id": 26711, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryResultStatus", "nameLocation": "2912:20:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26706, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26705, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26711, "src": "2933:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26704, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "2933:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "2932:9:67" }, "returnParameters": { "id": 26710, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26709, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26711, "src": "2965:19:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_enum$_ResultStatus_$37698", "typeString": "enum Witnet.ResultStatus" }, "typeName": { "id": 26708, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26707, "name": "Witnet.ResultStatus", "nameLocations": [ "2965:6:67", "2972:12:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37698, "src": "2965:19:67" }, "referencedDeclaration": 37698, "src": "2965:19:67", "typeDescriptions": { "typeIdentifier": "t_enum$_ResultStatus_$37698", "typeString": "enum Witnet.ResultStatus" } }, "visibility": "internal" } ], "src": "2964:21:67" }, "scope": 26795, "src": "2903:83:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "functionSelector": "c2581348", "id": 26718, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryResultStatusDescription", "nameLocation": "3001:31:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26714, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26713, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26718, "src": "3033:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26712, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "3033:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "3032:9:67" }, "returnParameters": { "id": 26717, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26716, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26718, "src": "3065:13:67", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_string_memory_ptr", "typeString": "string" }, "typeName": { "id": 26715, "name": "string", "nodeType": "ElementaryTypeName", "src": "3065:6:67", "typeDescriptions": { "typeIdentifier": "t_string_storage_ptr", "typeString": "string" } }, "visibility": "internal" } ], "src": "3064:15:67" }, "scope": 26795, "src": "2992:88:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26719, "nodeType": "StructuredDocumentation", "src": "3092:51:67", "text": "@notice Gets query's result back tracing trails" }, "functionSelector": "3fa59576", "id": 26734, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryResultTrails", "nameLocation": "3158:20:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26722, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26721, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26734, "src": "3179:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26720, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "3179:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "3178:9:67" }, "returnParameters": { "id": 26733, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26724, "mutability": "mutable", "name": "queryUUID", "nameLocation": "3243:9:67", "nodeType": "VariableDeclaration", "scope": 26734, "src": "3235:17:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 26723, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "3235:7:67", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" }, { "constant": false, "id": 26727, "mutability": "mutable", "name": "resultDrTxHash", "nameLocation": "3290:14:67", "nodeType": "VariableDeclaration", "scope": 26734, "src": "3267:37:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_TransactionHash_$37159", "typeString": "Witnet.TransactionHash" }, "typeName": { "id": 26726, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26725, "name": "Witnet.TransactionHash", "nameLocations": [ "3267:6:67", "3274:15:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37159, "src": "3267:22:67" }, "referencedDeclaration": 37159, "src": "3267:22:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_TransactionHash_$37159", "typeString": "Witnet.TransactionHash" } }, "visibility": "internal" }, { "constant": false, "id": 26730, "mutability": "mutable", "name": "resultTimestamp", "nameLocation": "3336:15:67", "nodeType": "VariableDeclaration", "scope": 26734, "src": "3319:32:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_Timestamp_$37157", "typeString": "Witnet.Timestamp" }, "typeName": { "id": 26729, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26728, "name": "Witnet.Timestamp", "nameLocations": [ "3319:6:67", "3326:9:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37157, "src": "3319:16:67" }, "referencedDeclaration": 37157, "src": "3319:16:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_Timestamp_$37157", "typeString": "Witnet.Timestamp" } }, "visibility": "internal" }, { "constant": false, "id": 26732, "mutability": "mutable", "name": "resultFinalityBlock", "nameLocation": "3374:19:67", "nodeType": "VariableDeclaration", "scope": 26734, "src": "3366:27:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26731, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "3366:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "3220:184:67" }, "scope": 26795, "src": "3149:256:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26735, "nodeType": "StructuredDocumentation", "src": "3413:47:67", "text": "@notice Gets current status of given query." }, "functionSelector": "6f07abcc", "id": 26743, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryStatus", "nameLocation": "3475:14:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26738, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26737, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26743, "src": "3490:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26736, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "3490:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "3489:9:67" }, "returnParameters": { "id": 26742, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26741, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26743, "src": "3522:18:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_enum$_QueryStatus_$37335", "typeString": "enum Witnet.QueryStatus" }, "typeName": { "id": 26740, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26739, "name": "Witnet.QueryStatus", "nameLocations": [ "3522:6:67", "3529:11:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37335, "src": "3522:18:67" }, "referencedDeclaration": 37335, "src": "3522:18:67", "typeDescriptions": { "typeIdentifier": "t_enum$_QueryStatus_$37335", "typeString": "enum Witnet.QueryStatus" } }, "visibility": "internal" } ], "src": "3521:20:67" }, "scope": 26795, "src": "3466:76:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "functionSelector": "838d44e2", "id": 26750, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryStatusString", "nameLocation": "3557:20:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26746, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26745, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26750, "src": "3578:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26744, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "3578:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "3577:9:67" }, "returnParameters": { "id": 26749, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26748, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26750, "src": "3610:13:67", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_string_memory_ptr", "typeString": "string" }, "typeName": { "id": 26747, "name": "string", "nodeType": "ElementaryTypeName", "src": "3610:6:67", "typeDescriptions": { "typeIdentifier": "t_string_storage_ptr", "typeString": "string" } }, "visibility": "internal" } ], "src": "3609:15:67" }, "scope": 26795, "src": "3548:77:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26751, "nodeType": "StructuredDocumentation", "src": "3637:54:67", "text": "@notice Get current status of all given query ids." }, "functionSelector": "581f5094", "id": 26761, "implemented": false, "kind": "function", "modifiers": [], "name": "getQueryStatusBatch", "nameLocation": "3706:19:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26755, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26754, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26761, "src": "3726:18:67", "stateVariable": false, "storageLocation": "calldata", "typeDescriptions": { "typeIdentifier": "t_array$_t_uint256_$dyn_calldata_ptr", "typeString": "uint256[]" }, "typeName": { "baseType": { "id": 26752, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "3726:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "id": 26753, "nodeType": "ArrayTypeName", "src": "3726:9:67", "typeDescriptions": { "typeIdentifier": "t_array$_t_uint256_$dyn_storage_ptr", "typeString": "uint256[]" } }, "visibility": "internal" } ], "src": "3725:20:67" }, "returnParameters": { "id": 26760, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26759, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26761, "src": "3769:27:67", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_array$_t_enum$_QueryStatus_$37335_$dyn_memory_ptr", "typeString": "enum Witnet.QueryStatus[]" }, "typeName": { "baseType": { "id": 26757, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26756, "name": "Witnet.QueryStatus", "nameLocations": [ "3769:6:67", "3776:11:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37335, "src": "3769:18:67" }, "referencedDeclaration": 37335, "src": "3769:18:67", "typeDescriptions": { "typeIdentifier": "t_enum$_QueryStatus_$37335", "typeString": "enum Witnet.QueryStatus" } }, "id": 26758, "nodeType": "ArrayTypeName", "src": "3769:20:67", "typeDescriptions": { "typeIdentifier": "t_array$_t_enum$_QueryStatus_$37335_$dyn_storage_ptr", "typeString": "enum Witnet.QueryStatus[]" } }, "visibility": "internal" } ], "src": "3768:29:67" }, "scope": 26795, "src": "3697:101:67", "stateMutability": "view", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26762, "nodeType": "StructuredDocumentation", "src": "3806:699:67", "text": "@notice Request real world data from the Wit/Oracle sidechain. \n @notice The paid fee is escrowed as a reward for the reporter that eventually relays back \n @notice a valid query result from the Wit/Oracle sidechain.\n @notice Query results are CBOR-encoded, and can contain either some data, or an error.\n @dev Reasons to revert:\n @dev - the data request's RAD hash was not previously verified into the WitOracleRadonRegistry contract;\n @dev - invalid query SLA parameters were provided;\n @dev - insufficient value is paid as reward.\n @param radonHash The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. " }, "functionSelector": "a58f6803", "id": 26773, "implemented": false, "kind": "function", "modifiers": [], "name": "queryData", "nameLocation": "4520:9:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26769, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26765, "mutability": "mutable", "name": "radonHash", "nameLocation": "4561:9:67", "nodeType": "VariableDeclaration", "scope": 26773, "src": "4544:26:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_RadonHash_$37153", "typeString": "Witnet.RadonHash" }, "typeName": { "id": 26764, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26763, "name": "Witnet.RadonHash", "nameLocations": [ "4544:6:67", "4551:9:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37153, "src": "4544:16:67" }, "referencedDeclaration": 37153, "src": "4544:16:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_RadonHash_$37153", "typeString": "Witnet.RadonHash" } }, "visibility": "internal" }, { "constant": false, "id": 26768, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26773, "src": "4585:24:67", "stateVariable": false, "storageLocation": "calldata", "typeDescriptions": { "typeIdentifier": "t_struct$_QuerySLA_$37373_calldata_ptr", "typeString": "struct Witnet.QuerySLA" }, "typeName": { "id": 26767, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26766, "name": "Witnet.QuerySLA", "nameLocations": [ "4585:6:67", "4592:8:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37373, "src": "4585:15:67" }, "referencedDeclaration": 37373, "src": "4585:15:67", "typeDescriptions": { "typeIdentifier": "t_struct$_QuerySLA_$37373_storage_ptr", "typeString": "struct Witnet.QuerySLA" } }, "visibility": "internal" } ], "src": "4529:91:67" }, "returnParameters": { "id": 26772, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26771, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26773, "src": "4656:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26770, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "4656:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "4655:9:67" }, "scope": 26795, "src": "4511:154:67", "stateMutability": "payable", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26774, "nodeType": "StructuredDocumentation", "src": "4673:885:67", "text": "@notice Request real world data from the Wit/Oracle sidechain. \n @notice The paid fee is escrowed as a reward for the reporter that eventually relays back \n @notice a valid query result from the Wit/Oracle sidechain.\n @notice The Witnet-provable result will be reported directly to the requesting contract. \n @notice Query results are CBOR-encoded, and can contain either some data, or an error.\n @dev Reasons to revert:\n @dev - the data request's RAD hash was not previously verified into the Radon Registry;\n @dev - invalid query SLA parameters were provided;\n @dev - insufficient value is paid as reward.\n @dev - passed `consumer` is not a contract implementing the IWitOracleQueriableConsumer interface;\n @param radonHash The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. " }, "functionSelector": "3b3195b7", "id": 26788, "implemented": false, "kind": "function", "modifiers": [], "name": "queryDataWithCallback", "nameLocation": "5573:21:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26784, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26777, "mutability": "mutable", "name": "radonHash", "nameLocation": "5626:9:67", "nodeType": "VariableDeclaration", "scope": 26788, "src": "5609:26:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_RadonHash_$37153", "typeString": "Witnet.RadonHash" }, "typeName": { "id": 26776, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26775, "name": "Witnet.RadonHash", "nameLocations": [ "5609:6:67", "5616:9:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37153, "src": "5609:16:67" }, "referencedDeclaration": 37153, "src": "5609:16:67", "typeDescriptions": { "typeIdentifier": "t_userDefinedValueType$_RadonHash_$37153", "typeString": "Witnet.RadonHash" } }, "visibility": "internal" }, { "constant": false, "id": 26780, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26788, "src": "5651:24:67", "stateVariable": false, "storageLocation": "calldata", "typeDescriptions": { "typeIdentifier": "t_struct$_QuerySLA_$37373_calldata_ptr", "typeString": "struct Witnet.QuerySLA" }, "typeName": { "id": 26779, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26778, "name": "Witnet.QuerySLA", "nameLocations": [ "5651:6:67", "5658:8:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37373, "src": "5651:15:67" }, "referencedDeclaration": 37373, "src": "5651:15:67", "typeDescriptions": { "typeIdentifier": "t_struct$_QuerySLA_$37373_storage_ptr", "typeString": "struct Witnet.QuerySLA" } }, "visibility": "internal" }, { "constant": false, "id": 26783, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26788, "src": "5691:29:67", "stateVariable": false, "storageLocation": "calldata", "typeDescriptions": { "typeIdentifier": "t_struct$_QueryCallback_$37340_calldata_ptr", "typeString": "struct Witnet.QueryCallback" }, "typeName": { "id": 26782, "nodeType": "UserDefinedTypeName", "pathNode": { "id": 26781, "name": "Witnet.QueryCallback", "nameLocations": [ "5691:6:67", "5698:13:67" ], "nodeType": "IdentifierPath", "referencedDeclaration": 37340, "src": "5691:20:67" }, "referencedDeclaration": 37340, "src": "5691:20:67", "typeDescriptions": { "typeIdentifier": "t_struct$_QueryCallback_$37340_storage_ptr", "typeString": "struct Witnet.QueryCallback" } }, "visibility": "internal" } ], "src": "5594:137:67" }, "returnParameters": { "id": 26787, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26786, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26788, "src": "5767:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26785, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "5767:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "5766:9:67" }, "scope": 26795, "src": "5564:212:67", "stateMutability": "payable", "virtual": false, "visibility": "external" }, { "documentation": { "id": 26789, "nodeType": "StructuredDocumentation", "src": "5784:103:67", "text": "@notice Increments the reward of a previously posted request by adding the transaction value to it." }, "functionSelector": "ec5946db", "id": 26794, "implemented": false, "kind": "function", "modifiers": [], "name": "upgradeQueryEvmReward", "nameLocation": "5902:21:67", "nodeType": "FunctionDefinition", "parameters": { "id": 26792, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 26791, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 26794, "src": "5924:7:67", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 26790, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "5924:7:67", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "internal" } ], "src": "5923:9:67" }, "returnParameters": { "id": 26793, "nodeType": "ParameterList", "parameters": [], "src": "5949:0:67" }, "scope": 26795, "src": "5893:57:67", "stateMutability": "payable", "virtual": false, "visibility": "external" } ], "scope": 26796, "src": "102:5851:67", "usedErrors": [], "usedEvents": [] } ], "src": "35:5918:67" }, "compiler": { "name": "solc", "version": "0.8.30+commit.73712a01.Emscripten.clang" }, "networks": {}, "schemaVersion": "3.4.16", "updatedAt": "2025-10-15T14:34:45.894Z", "devdoc": { "kind": "dev", "methods": { "deleteQuery(uint256)": { "details": "Fails if the query is not in a final status, or not called from the actual requester.", "params": { "queryId": "The unique query identifier." } }, "estimateBaseFee(uint256)": { "params": { "evmGasPrice": "Expected gas price to pay upon posting the data request." } }, "estimateBaseFeeWithCallback(uint256,uint24)": { "params": { "callbackGas": "Maximum gas to be spent when reporting the data request result.", "evmGasPrice": "Expected gas price to pay upon posting the data request." } }, "estimateExtraFee(uint256,uint256,(uint16,uint16,uint64))": { "details": "The extra fee gets calculated in proportion to:", "params": { "evmGasPrice": "Tentative EVM gas price at the moment the query result is ready.", "evmWitPrice": "Tentative nanoWit price in Wei at the moment the query is solved on the Wit/Oracle blockchain.", "querySLA": "The query SLA data security parameters as required for the Wit/Oracle blockchain. " } }, "queryData(bytes32,(uint16,uint16,uint64))": { "details": "Reasons to revert:- the data request's RAD hash was not previously verified into the WitOracleRadonRegistry contract;- invalid query SLA parameters were provided;- insufficient value is paid as reward.", "params": { "radonHash": "The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. " } }, "queryDataWithCallback(bytes32,(uint16,uint16,uint64),(address,uint24))": { "details": "Reasons to revert:- the data request's RAD hash was not previously verified into the Radon Registry;- invalid query SLA parameters were provided;- insufficient value is paid as reward.- passed `consumer` is not a contract implementing the IWitOracleQueriableConsumer interface;", "params": { "radonHash": "The unique hash of the Radon Request to be solved by Wit/Oracle sidechain. " } } }, "version": 1 }, "userdoc": { "kind": "user", "methods": { "deleteQuery(uint256)": { "notice": "Removes all query data from storage. Pays back reward on expired queries." }, "estimateBaseFee(uint256)": { "notice": "Estimate the minimum reward required for posting a data request." }, "estimateBaseFeeWithCallback(uint256,uint24)": { "notice": "Estimate the minimum reward required for posting a data request with a callback." }, "estimateExtraFee(uint256,uint256,(uint16,uint16,uint64))": { "notice": "Estimate the extra reward (i.e. over the base fee) to be paid when posting a newdata query in order to avoid getting provable \"too low incentives\" results fromthe Wit/Oracle blockchain. " }, "getNextQueryId()": { "notice": "Returns next query id to be generated by the Witnet Request Board." }, "getQuery(uint64)": { "notice": "Gets the whole Query data contents, if any, no matter its current status." }, "getQueryEvmReward(uint256)": { "notice": "Gets the current EVM reward the reporter can claim, if not done yet." }, "getQueryRequest(uint64)": { "notice": "Retrieves the RAD hash and SLA parameters of the given query." }, "getQueryResponse(uint64)": { "notice": "Retrieves the whole `Witnet.QueryResponse` record referred to a previously posted Witnet Data Request." }, "getQueryResultTrails(uint256)": { "notice": "Gets query's result back tracing trails" }, "getQueryStatus(uint256)": { "notice": "Gets current status of given query." }, "getQueryStatusBatch(uint256[])": { "notice": "Get current status of all given query ids." }, "queryData(bytes32,(uint16,uint16,uint64))": { "notice": "Request real world data from the Wit/Oracle sidechain. The paid fee is escrowed as a reward for the reporter that eventually relays back a valid query result from the Wit/Oracle sidechain.Query results are CBOR-encoded, and can contain either some data, or an error." }, "queryDataWithCallback(bytes32,(uint16,uint16,uint64),(address,uint24))": { "notice": "Request real world data from the Wit/Oracle sidechain. The paid fee is escrowed as a reward for the reporter that eventually relays back a valid query result from the Wit/Oracle sidechain.The Witnet-provable result will be reported directly to the requesting contract. Query results are CBOR-encoded, and can contain either some data, or an error." }, "upgradeQueryEvmReward(uint256)": { "notice": "Increments the reward of a previously posted request by adding the transaction value to it." } }, "version": 1 } }