98 lines
3.1 KiB
Markdown
98 lines
3.1 KiB
Markdown
# solana-flux-aggregator
|
|
|
|
Solnana Flux Aggregator
|
|
|
|
## Install Dependencies
|
|
|
|
```
|
|
yarn install
|
|
```
|
|
|
|
# Submit Prices As Oracle (devnet)
|
|
|
|
There are price oracles already deployed on the devnet, you can see their deploy
|
|
configuration and addresses at [./deploy.sandbox.json](./deploy.sandbox.json)
|
|
|
|
Configure `.env` to use the devnet:
|
|
|
|
```
|
|
cp .env.sandbox .env
|
|
```
|
|
|
|
The `.env` will set the price oracle to be the account:
|
|
|
|
```
|
|
FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4
|
|
```
|
|
|
|
Then run the oracle:
|
|
|
|
```
|
|
yarn solink oracle
|
|
```
|
|
|
|
The oracle should submit updates if the price changes by more than $1. You should see:
|
|
|
|
```
|
|
info: Starting a new round {"aggregator":"btc:usd","round":"9"}
|
|
info: Submit value {"aggregator":"btc:usd","round":"9","value":"5748914"}
|
|
info: Submit OK {"aggregator":"btc:usd","withdrawable":"90000","rewardToken":"3oLHHTaRqNsuTMjsTtkVy8bock6Bx8gCmDxku4TurVj1"}
|
|
info: Starting a new round {"aggregator":"btc:usd","round":"10"}
|
|
info: Submit value {"aggregator":"btc:usd","round":"10","value":"5749313"}
|
|
info: Submit OK {"aggregator":"btc:usd","withdrawable":"100000","rewardToken":"3oLHHTaRqNsuTMjsTtkVy8bock6Bx8gCmDxku4TurVj1"}
|
|
```
|
|
|
|
NOTE: This is a "sandbox" environment on the devnet to make it easy for you to
|
|
try running the price oracle. Anyone reading this README has access to the
|
|
private key of the account `FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4`. Do
|
|
not use this key for production!
|
|
|
|
NOTE 2: You might get error messages if somebody else is also running the
|
|
oracle.
|
|
|
|
# Observe The Aggregators
|
|
|
|
With the oracle running, you can subscribe to price changes. In another
|
|
terminal, run:
|
|
|
|
```
|
|
yarn solink observe
|
|
```
|
|
|
|
You should get prices pushed to you when they update:
|
|
|
|
```
|
|
info: update {"description":"btc:usd","decimals":2,"roundID":"21","median":"5744000","updatedAt":"37820525","createdAt":"37820525"}
|
|
info: update {"description":"eth:usd","decimals":2,"roundID":"9","median":"202600","updatedAt":"37820513","createdAt":"37820513"}
|
|
info: update {"description":"btc:usd","decimals":2,"roundID":"22","median":"5743803","updatedAt":"37820552","createdAt":"37820552"}
|
|
info: update {"description":"btc:usd","decimals":2,"roundID":"23","median":"5740350","updatedAt":"37820565","createdAt":"37820565"}
|
|
```
|
|
|
|
# Devnet Oracles
|
|
|
|
The sandbox environment could be modified by anyone, and is not suitable for
|
|
development purposes. For a reliable devnet price feed, use [./deploy.dev.json](./deploy.dev.json).
|
|
|
|
Observe the devnet prices by running:
|
|
|
|
```
|
|
NETWORK=dev DEPLOY_FILE=deploy.dev.json yarn solink observe
|
|
```
|
|
|
|
* `btc:usd` => 8tawJxhUbVJV7Aiss8DBkYoN4ZA1vpNVwjNmUdgpMw7J
|
|
* `eth:usd` => 4X5QRNHs3saF35fhL7FJtPR58PeqoFmzgq82EiHqa9a9
|
|
|
|
## Joining Devnet
|
|
|
|
If you want to become a testnet oracle, generate a solana devnet wallet (10 SOL will be airdropped):
|
|
|
|
```
|
|
NETWORK=dev yarn solink new-wallet
|
|
|
|
info: address: 8CGZz277PT6yA7nU6HEdpbwQsNYLvyJhP1guoUNxt9mF
|
|
info: mnemonic: ....
|
|
info: airdrop 10 SOL {"address":"8CGZz277PT6yA7nU6HEdpbwQsNYLvyJhP1guoUNxt9mF"}
|
|
```
|
|
|
|
Save the mnemonic in your `.env` file, and give the address to me, and I'll add
|
|
you to the oracle list so you can submit. |