Skip to content

Latest commit

 

History

History

contract

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
scripts
scripts
 
 
src
src
 
 
Cargo.toml
Cargo.toml
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 

README.md

Lightecho Oracle contract Rust source code

Lightecho is a Stellar Oracle for emerging markets data and XLM volatility feeds.

For more information see docs at https://github.com/bp-ventures/lightecho-stellar-oracle

TESTNET Official Contracts:

PUBLIC Official Contracts:

Consuming the Oracle from another Soroban contract

See the PriceUpDown contract example on how to consume the Oracle from another Soroban contract.

Deploying a new Oracle instance

These instructions are for deploying a new Oracle instance to the blockchain.
Note that if you deploy a new Oracle instance, the instance will not contain any price unless you feed the prices yourself. So we highly recommend not deploying a new instance, and instead, fetch prices from our official Oracle contract.

Install Soroban Rust toolchain

Follow the instructions in https://soroban.stellar.org/docs/getting-started/setup.

Install GNU build tools

  • For Ubuntu:
sudo apt install build-essential
  • For other operating systems, please check the documentation of your specific system. Make sure GNU make is available along with its related tools.

Deploy contract to the blockchain

# load stellar source account secret key into environment
source ./scripts/source_secret.sh

# deploy the contract to the blockchain
# examples:
#   ./scripts/deploy.sh light testnet  # deploy the 'light' version to Testnet
#   ./scripts/deploy.sh map testnet # deploy the 'map' (old, deprecated) version to Testnet
./scripts/deploy.sh light testnet

Initialize contract via CLI

We provide a Python-based CLI for interacting with the deployed contract.

Install Poetry:

curl -sSL https://install.python-poetry.org | python3 -

Make sure to add $HOME/.local/bin to your Shell startup file (e.g. ~/.bashrc), otherwise the poetry program might not be found.

Go to CLI dir:

cd ../cli

Install CLI dependencies:

./poetry_install.sh

Create CLI local_settings.py file, and edit it with your deployed Oracle contract id:

SOURCE_SECRET = "<stellar source secret you used above>"
ADMIN_SECRET = "<stellar secret key of contract admin>"

ORACLE_CONTRACT_ID = "<oracle contract id you obtained above>"
PRICEUPDOWN_CONTRACT_ID = "" # leave empty

RPC_SERVER_URL = "https://rpc-futurenet.stellar.org:443/"
NETWORK_PASSPHRASE = "Test SDF Future Network ; October 2022"

Initialize the contract:

./cli oracle initialize <admin> <base> <decimals> <resolution>

Example:

./cli oracle initialize \
    GCDXRFUE3OCQLIUYYCQHOS2TPEZ5VMVSVRXEOBQDUJRRGP67IXRFPS7T
    XLM
    18
    300