Become an oracle script developer

Search…

A brief description of how to develop an oracle script on Oraichain:#​
Oraichain currently only supports oracle scripts written in shell script
For an oracle script, the number of input arguments must be at least two. The first one: $1 is reserved for execution type of the script. For now, the validators only accept three execution types: aiDataSource, testcase, and aggregation. Other types will not be read, and unexpected behaviours may happen. The first type collects all the AI data source names that the oracle wants to execute, while the second type gets all the test cases it prefers. The last type, on the other hand, is the business logic of the oracle script, which is responsible for processing all the results retrieved from the data sources. Indeed, all the results are put in a string passed to the second argument $2 with a delimiter, which is -, and it is the oracle script's job to process these values to come up with a final result to be returned back to Oraichain. An example of an oracle script that is syntaxtically correct is below:
1
#!/bin/bash
2
​
3
# the number of parameters are fixed depending on the total data sources run
4
route() {
5
  if [[ $1 = "aiDataSource" ]]
6
  then 
7
    echo "crypto_compare_btc coindesk_btc coingecko_btc" # return names of the data sources
8
  elif [[ $1 = "testcase" ]] # return names of the test cases
9
  then
10
    echo "testcase_price"
11
  elif [[ $1 = "aggregation" ]] # $2 is true output, $3 is expected output
12
  then
13
    # collect input string with a delimiter of each data source value separated with a '-' delimiter
14
    IFS='-' read -ra array <<< "$2"
15
    aggregation_result=0
16
    size=0
17
    # here is the algorithm for each oracle script. This should be different based on the oscript
18
    for i in "${array[@]}"; do
19
      let "size+=1"
20
      # process "$i"
21
      aggregation_result=`echo $aggregation_result + $i | bc`
22
      #$aggregation_result = $aggregation_result + $i
23
    done
24
    temp=$aggregation_result
25
    # scale=2 allows division with floating points (two decimals)
26
    aggregation_result=$(echo "scale=2; ($temp) / $size" |bc) # |bc allows adding two floating point numbers
27
    echo "$aggregation_result"
28
  else
29
    echo 0
30
  fi
31
}
32
​
33
route_name="$(route $1 $2 $3 $4)"
34
echo $route_name
Copied!
Note:#​
+): In order to deploy an oracle script on Oraichain, all sufficient data sources and test cases provided in the script need to be on the network already.
+): If a data source or a test case change its name, the oracle script deployer must manually edit his script. Otherwise, the script will not run properly because it cannot find the correct data source or test case.

Become a test case provider

Become an AI Executor

Last modified 1mo ago

Copy link

Edit on GitHub

Contents

A brief description of how to develop an oracle script on Oraichain:#

A brief description of how to develop an oracle script on Oraichain:#​

Note:#​

A brief description of how to develop an oracle script on Oraichain:#

Note:#