Skip to content

Commit 29e4578

Browse files
Adán Sánchez de Pedro Crespogitbook-bot
Adán Sánchez de Pedro Crespo
authored andcommitted
GITBOOK-194: Update WitnetRequestBoard API
1 parent 734fa54 commit 29e4578

File tree

9 files changed

+889
-16
lines changed

9 files changed

+889
-16
lines changed

SUMMARY.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,10 @@
6767
* [HTTP POST Requests in Solidity](smart-contracts/witnet-web-oracle/make-a-post-request.md)
6868
* [Query GraphQL APIs in Solidity](smart-contracts/witnet-web-oracle/query-graphql-apis-in-solidity.md)
6969
* [UsingWitnet Inheritance](smart-contracts/witnet-web-oracle/usingwitnet-inheritance.md)
70-
* [WitnetRequestBoard Contract](smart-contracts/witnet-web-oracle/witnet-request-board.md)
7170
* [API Reference](smart-contracts/witnet-web-oracle/api-reference/README.md)
72-
* [Solidity API](smart-contracts/witnet-web-oracle/api-reference/api-solidity.md)
71+
* [Solidity API](smart-contracts/witnet-web-oracle/api-reference/api-solidity/README.md)
72+
* [Solidity Contracts](smart-contracts/witnet-web-oracle/api-reference/api-solidity/solidity-contracts/README.md)
73+
* [WitnetRequestBoard](smart-contracts/witnet-web-oracle/api-reference/api-solidity/solidity-contracts/witnet-request-board.md)
7374
* [Javascript API](smart-contracts/witnet-web-oracle/api-reference/api-javascript.md)
7475
* [Multi-chain Addresses](smart-contracts/witnet-web-oracle/contracts-addresses.md)
7576

smart-contracts/witnet-data-feeds/api-reference.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,6 @@ Functions defined within the [`IWitnetRequest`](https://github.com/witnet/witnet
5555

5656
Public function inherited from the [`UsingWitnet`](https://github.com/witnet/witnet-solidity-bridge/blob/master/contracts/UsingWitnet.sol) abstract contract:
5757

58-
| **Function** | **Description** |
59-
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
60-
| `witnet()` | Returns the immutable address of the [**Witnet Request Board**](../witnet-web-oracle/witnet-request-board.md) that interacts with the Witnet oracle's sidechain, for both posting new data requests and receiving results from it. |
58+
| **Function** | **Description** |
59+
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
60+
| `witnet()` | Returns the immutable address of the [**Witnet Request Board**](../witnet-web-oracle/api-reference/api-solidity/solidity-contracts/witnet-request-board.md) that interacts with the Witnet oracle's sidechain, for both posting new data requests and receiving results from it. |

smart-contracts/witnet-randomness-oracle/api-reference.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -36,9 +36,9 @@ Public functions inherited from the [`Clonable`](https://github.com/witnet/witne
3636

3737
Public function inherited from the [`UsingWitnet`](https://github.com/witnet/witnet-solidity-bridge/blob/master/contracts/UsingWitnet.sol) abstract contract:
3838

39-
| **Function** | **Description** |
40-
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
41-
| `witnet()` | Returns the immutable address of the [**Witnet Request Board**](../witnet-web-oracle/witnet-request-board.md) that interacts with the Witnet oracle's sidechain, for both posting new data requests and receiving results from it. |
39+
| **Function** | **Description** |
40+
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
41+
| `witnet()` | Returns the immutable address of the [**Witnet Request Board**](../witnet-web-oracle/api-reference/api-solidity/solidity-contracts/witnet-request-board.md) that interacts with the Witnet oracle's sidechain, for both posting new data requests and receiving results from it. |
4242

4343
## WitnetRequestRandomness contract
4444

smart-contracts/witnet-randomness-oracle/generating-randomness.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@
33
There are two major approaches to generate unpredictable and malleable randomness from the Witnet oracle:
44

55
* Using the [**WitnetRandomness Contract**](randomness-contract.md), also known as the «_**Witnet Randomness Oracle**_», that can be used by practically all kind of dapps, and that it has been already pre-deployed by the Witnet Foundation on [multiple chains](../witnet-web-oracle/contracts-addresses.md).
6-
* Posting a low-level [**WitnetRequestRandomness** ](randomness-requests.md)to the [WitnetRequestBoard ](../witnet-web-oracle/witnet-request-board.md)entrypoint.
6+
* Posting a low-level [**WitnetRequestRandomness** ](randomness-requests.md)to the [WitnetRequestBoard ](../witnet-web-oracle/api-reference/api-solidity/solidity-contracts/witnet-request-board.md)entrypoint.

smart-contracts/witnet-randomness-oracle/randomness-requests.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Low-level Requests
22

3-
The straight way to fetch randomness from the Witnet oracle is by posting a low-level randomness data request to the [**WitnetRequestBoard**](../witnet-web-oracle/witnet-request-board.md).
3+
The straight way to fetch randomness from the Witnet oracle is by posting a low-level randomness data request to the [**WitnetRequestBoard**](../witnet-web-oracle/api-reference/api-solidity/solidity-contracts/witnet-request-board.md).
44

55
However, you will then need to add logic within your smart contract as to await for an answer from the Witnet side-chain and handle corner-case revert situations at the Witnet level, before feeding your favourite _Pseudo Random Number Generator_ (PRNG) algorithm with the 32-byte random seed provided by the Witnet oracle.
66

7-
Besides, you or your contract will have to pay the required fee every time a randomness request is posted to the [WitnetRequestBoard](../witnet-web-oracle/witnet-request-board.md).
7+
Besides, you or your contract will have to pay the required fee every time a randomness request is posted to the [WitnetRequestBoard](../witnet-web-oracle/api-reference/api-solidity/solidity-contracts/witnet-request-board.md).
88

99
{% hint style="success" %}
1010
If your contract inherits from the [**UsingWitnet** abstract contract](../witnet-web-oracle/usingwitnet-inheritance.md), the reward will be estimated automatically. However, you should make sure that everytime a data request is posted, enough funds (i.e. EVM native currency) are provided as to cover the posting fee required by the **WitnetRequestBoard**.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Solidity Contracts
2+

0 commit comments

Comments
 (0)