devnet sandbox README
This commit is contained in:
parent
88d5c9c913
commit
d22a7a02cd
|
@ -0,0 +1,9 @@
|
||||||
|
NETWORK=dev
|
||||||
|
|
||||||
|
DEPLOY_FILE=deploy.sandbox.json
|
||||||
|
|
||||||
|
# EQ54CB7UTuteAYtbmsDuphcwVhB44rf2fcZpBqkv8ewh
|
||||||
|
ADMIN_MNEMONIC="summer fuel twin history item learn flip marble ginger knee mix ten"
|
||||||
|
|
||||||
|
# FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4
|
||||||
|
ORACLE_MNEMONIC="amount smoke bar coil current trial toward minimum model pass moral liberty"
|
137
README.md
137
README.md
|
@ -2,135 +2,68 @@
|
||||||
|
|
||||||
Solnana Flux Aggregator
|
Solnana Flux Aggregator
|
||||||
|
|
||||||
Price Feeds: [https://sol.link](https://sol.link)
|
## Install Dependencies
|
||||||
|
|
||||||
## Install
|
|
||||||
|
|
||||||
```
|
```
|
||||||
yarn install
|
yarn install
|
||||||
```
|
```
|
||||||
|
|
||||||
## Admin Wallet Setup
|
# Submit Prices As Oracle (devnet)
|
||||||
|
|
||||||
Setup a wallet for the flux aggregator admin:
|
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:
|
||||||
|
|
||||||
```
|
```
|
||||||
yarn solink generate-wallet
|
cp .env.sandbox .env
|
||||||
|
|
||||||
address: 7YMUUCzZir7AAuoy4CtZih9JFBqYwtQiCxjA5dtqwRxU
|
|
||||||
mnemonic: wine vault fancy enhance trade dolphin hard traffic social butter client pave
|
|
||||||
```
|
```
|
||||||
|
|
||||||
```
|
The `.env` will set the price oracle to be the account:
|
||||||
yarn solink airdrop 7YMUUCzZir7AAuoy4CtZih9JFBqYwtQiCxjA5dtqwRxU
|
|
||||||
```
|
|
||||||
|
|
||||||
Create `.env` configuration file for the deploy script.
|
|
||||||
|
|
||||||
```
|
```
|
||||||
NETWORK=dev
|
FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4
|
||||||
DEPLOY_FILE=deploy.json
|
|
||||||
ADMIN_MNEMONIC="wine vault fancy enhance trade dolphin hard traffic social butter client pave"
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Aggregator Setup
|
Then run the oracle:
|
||||||
|
|
||||||
Build and deploy the flux aggregator:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
yarn build:program
|
yarn solink oracle
|
||||||
```
|
```
|
||||||
|
|
||||||
```
|
The oracle should submit updates if the price changes by more than $1. You should see:
|
||||||
yarn solink deploy-program
|
|
||||||
|
|
||||||
deployed aggregator program. program id: DErMSHHbyVisohfM6miHaxstZEAxD5GBq2RrkdcXEasy
|
|
||||||
```
|
|
||||||
|
|
||||||
Create the `btc:usd` feed (that accepts max and min u64 as valid submission values):
|
|
||||||
|
|
||||||
```
|
```
|
||||||
yarn solink add-aggregator \
|
info: Starting a new round {"aggregator":"btc:usd","round":"9"}
|
||||||
--feedName btc:usd
|
info: Submit value {"aggregator":"btc:usd","round":"9","value":"5748914"}
|
||||||
|
info: Submit OK {"aggregator":"btc:usd","withdrawable":"90000","rewardToken":"3oLHHTaRqNsuTMjsTtkVy8bock6Bx8gCmDxku4TurVj1"}
|
||||||
feed initialized, pubkey: 3aTBom2uodyWkuVPiUkwCZ2HiFywdUx9tp7su7U2H4Nx
|
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"}
|
||||||
```
|
```
|
||||||
|
|
||||||
## Adding an oracle
|
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!
|
||||||
|
|
||||||
Next, we create a separate wallet to control oracles:
|
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 generate-wallet
|
yarn solink observe
|
||||||
|
|
||||||
address: FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4
|
|
||||||
mnemonic: amount smoke bar coil current trial toward minimum model pass moral liberty
|
|
||||||
```
|
```
|
||||||
|
|
||||||
```
|
You should get prices pushed to you when they update:
|
||||||
yarn solink airdrop FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4
|
|
||||||
```
|
|
||||||
|
|
||||||
Add this wallet to `.env`:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
ORACLE_MNEMONIC="amount smoke bar coil current trial toward minimum model pass moral liberty"
|
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"}
|
||||||
Next we create a new oracle to the feed we've created previously, and set its owner to be the new oracle wallet that we've generated:
|
info: update {"description":"btc:usd","decimals":2,"roundID":"23","median":"5740350","updatedAt":"37820565","createdAt":"37820565"}
|
||||||
|
|
||||||
```
|
|
||||||
yarn solink add-oracle \
|
|
||||||
--aggregatorAddress 3aTBom2uodyWkuVPiUkwCZ2HiFywdUx9tp7su7U2H4Nx \
|
|
||||||
--oracleName solink-test \
|
|
||||||
--oracleOwner FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4
|
|
||||||
|
|
||||||
added oracle. pubkey: 7bsB4v6nvHuVC5cWwRheg8opJgmvKVP27pjxiGgoXLoq
|
|
||||||
```
|
|
||||||
|
|
||||||
Start submitting data from a price feed (e.g. coinbase BTC-USDT):
|
|
||||||
|
|
||||||
```
|
|
||||||
yarn solink feed \
|
|
||||||
--feedAddress 3aTBom2uodyWkuVPiUkwCZ2HiFywdUx9tp7su7U2H4Nx \
|
|
||||||
--oracleAddress 7bsB4v6nvHuVC5cWwRheg8opJgmvKVP27pjxiGgoXLoq \
|
|
||||||
--pairSymbol BTC/USD
|
|
||||||
```
|
|
||||||
|
|
||||||
## Read price
|
|
||||||
|
|
||||||
Poll the latest aggregated (median) value from a feed:
|
|
||||||
|
|
||||||
```
|
|
||||||
yarn solink feed-poll \
|
|
||||||
--feedAddress 3aTBom2uodyWkuVPiUkwCZ2HiFywdUx9tp7su7U2H4Nx
|
|
||||||
```
|
|
||||||
|
|
||||||
## Remove oracle
|
|
||||||
|
|
||||||
```
|
|
||||||
yarn solink remove-oracle \
|
|
||||||
--feedAddress 3aTBom2uodyWkuVPiUkwCZ2HiFywdUx9tp7su7U2H4Nx \
|
|
||||||
--oracleAddress 7bsB4v6nvHuVC5cWwRheg8opJgmvKVP27pjxiGgoXLoq
|
|
||||||
```
|
|
||||||
|
|
||||||
## Test Token
|
|
||||||
|
|
||||||
For testing purposes, create a test token held by the aggregator program to reward:
|
|
||||||
|
|
||||||
```
|
|
||||||
yarn solink testToken --amount 10000000000
|
|
||||||
```
|
|
||||||
|
|
||||||
## Program Integration
|
|
||||||
|
|
||||||
Refer to the [integration-example][./integration-example].
|
|
||||||
|
|
||||||
The gist is to pass in the feed address to the program, and call `get_median` from the flux_aggregator crate.
|
|
||||||
|
|
||||||
```rust
|
|
||||||
use flux_aggregator;
|
|
||||||
|
|
||||||
let feed_info = next_account_info(accounts_iter)?;
|
|
||||||
let value = flux_aggregator::get_median(feed_info)?;
|
|
||||||
```
|
```
|
||||||
|
|
|
@ -0,0 +1,31 @@
|
||||||
|
{
|
||||||
|
"aggregators": {
|
||||||
|
"btc:usd": {
|
||||||
|
"decimals": 2,
|
||||||
|
"minSubmissions": 1,
|
||||||
|
"maxSubmissions": 3,
|
||||||
|
"restartDelay": 0,
|
||||||
|
"rewardAmount": 10000,
|
||||||
|
"rewardTokenAccount": "3oLHHTaRqNsuTMjsTtkVy8bock6Bx8gCmDxku4TurVj1",
|
||||||
|
"oracles": [
|
||||||
|
"tester"
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"eth:usd": {
|
||||||
|
"decimals": 2,
|
||||||
|
"minSubmissions": 1,
|
||||||
|
"maxSubmissions": 3,
|
||||||
|
"restartDelay": 0,
|
||||||
|
"rewardAmount": 10000,
|
||||||
|
"rewardTokenAccount": "3oLHHTaRqNsuTMjsTtkVy8bock6Bx8gCmDxku4TurVj1",
|
||||||
|
"oracles": [
|
||||||
|
"tester"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"oracles": {
|
||||||
|
"tester": {
|
||||||
|
"owner": "FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,76 @@
|
||||||
|
{
|
||||||
|
"aggregators": {
|
||||||
|
"btc:usd": {
|
||||||
|
"pubkey": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "9u7fuQCJCX13HhU8DZoj4bwP3vWsDFVWkurNkv7JvhYh"
|
||||||
|
},
|
||||||
|
"owner": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "EQ54CB7UTuteAYtbmsDuphcwVhB44rf2fcZpBqkv8ewh"
|
||||||
|
},
|
||||||
|
"config": {
|
||||||
|
"description": "btc:usd",
|
||||||
|
"decimals": 2,
|
||||||
|
"minSubmissions": 1,
|
||||||
|
"maxSubmissions": 3,
|
||||||
|
"restartDelay": 0,
|
||||||
|
"rewardTokenAccount": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "3oLHHTaRqNsuTMjsTtkVy8bock6Bx8gCmDxku4TurVj1"
|
||||||
|
},
|
||||||
|
"rewardAmount": 10000
|
||||||
|
},
|
||||||
|
"oracles": {
|
||||||
|
"tester": {
|
||||||
|
"pubkey": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "EiJ93oR38pvJNjZDdAufYFDReYGGBpHPEXYfcTKYYgVq"
|
||||||
|
},
|
||||||
|
"owner": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"eth:usd": {
|
||||||
|
"pubkey": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "ELz3y7PCa6gp8GjD8TrXnggmS2bxsDrznrxAMmSz9Thq"
|
||||||
|
},
|
||||||
|
"owner": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "EQ54CB7UTuteAYtbmsDuphcwVhB44rf2fcZpBqkv8ewh"
|
||||||
|
},
|
||||||
|
"config": {
|
||||||
|
"description": "eth:usd",
|
||||||
|
"decimals": 2,
|
||||||
|
"minSubmissions": 1,
|
||||||
|
"maxSubmissions": 3,
|
||||||
|
"restartDelay": 0,
|
||||||
|
"rewardTokenAccount": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "3oLHHTaRqNsuTMjsTtkVy8bock6Bx8gCmDxku4TurVj1"
|
||||||
|
},
|
||||||
|
"rewardAmount": 10000
|
||||||
|
},
|
||||||
|
"oracles": {
|
||||||
|
"tester": {
|
||||||
|
"pubkey": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "5X62rNUqSBAcB39kjyeJrTivguYxeeEFh738oMvpaPXc"
|
||||||
|
},
|
||||||
|
"owner": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "FosLwbttPgkEDv36VJLU3wwXcBSSoUGkh7dyZPsXNtT4"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"programID": {
|
||||||
|
"type": "PublicKey",
|
||||||
|
"base58": "97diqBRSqa4nYRro2QPzyoWrDp78mkGiiAVV3sQYRBes"
|
||||||
|
}
|
||||||
|
}
|
Loading…
Reference in New Issue