blockworks-foundation
/
sbv2-solana
mirror of https://github.com/blockworks-foundation/sbv2-solana.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

added protos to switchboard-v2 

protos


added lint
This commit is contained in:
Conner Gallagher 2022-05-27 10:48:25 -06:00
parent d0fdd03357
commit 89f31a622b
8 changed files with 20006 additions and 4340 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

429
libraries/protos/job_schemas.proto Normal file
View File

@ -0,0 +1,429 @@
syntax = "proto2";
// Represnts a list of tasks to be performed by a switchboard oracle.
message OracleJob {
// The adapter will report the text body of a successful HTTP request to the specified url,
// or return an error if the response status code is greater than or equal to 400.
// @return string representation of it's output.
message HttpTask {
// An enumeration representing the types of HTTP requests available to make.
enum Method {
// Unset HTTP method will default to METHOD_GET
METHOD_UNKOWN = 0;
// Perform an HTTP 'GET' request.
METHOD_GET = 1;
// Perform an HTTP 'POST' request.
METHOD_POST = 2;
}
// An object that represents a header to add to an HTTP request.
message Header {
optional string key = 1;
optional string value = 2;
}
// A string containing the URL to direct this HTTP request to.
optional string url = 1;
// The type of HTTP request to make.
optional Method method = 2;
// A list of headers to add to this HttpTask.
repeated Header headers = 3;
// A stringified body (if any) to add to this HttpTask.
optional string body = 4;
}
// The adapter walks the path specified and returns the value found at that result. If returning
// JSON data from the HttpGet or HttpPost adapters, you must use this adapter to parse the
// response.
message JsonParseTask {
// JSONPath formatted path to the element. https://t.ly/uLtw
// https://www.npmjs.com/package/jsonpath-plus
optional string path = 1;
// The methods of combining a list of numerical results.
enum AggregationMethod {
NONE = 0;
// Grab the minimum value of the results.
MIN = 1;
// Grab the maximum value of the results.
MAX = 2;
// Sum up all of the results.
SUM = 3;
}
// The technique that will be used to aggregate the results if walking the specified path
// returns multiple numerical results.
optional AggregationMethod aggregation_method = 2;
}
// Returns the median of all the results returned by the provided subtasks and subjobs. Nested
// tasks must return a Number.
message MedianTask {
// A list of subtasks to process and produce a list of result values.
repeated Task tasks = 1;
// A list of subjobs to process and produce a list of result values.
repeated OracleJob jobs = 2;
optional int32 min_successful_required = 3;
}
// Returns the mean of all the results returned by the provided subtasks and subjobs.
message MeanTask {
// A list of subtasks to process and produce a list of result values.
repeated Task tasks = 1;
// A list of subjobs to process and produce a list of result values.
repeated OracleJob jobs = 2;
}
// Returns the maximum value of all the results returned by the provided subtasks and subjobs.
message MaxTask {
// A list of subtasks to process and produce a list of result values.
repeated Task tasks = 1;
// A list of subjobs to process and produce a list of result values.
repeated OracleJob jobs = 2;
}
// Returns a specified value.
message ValueTask {
oneof Value {
// The value that will be returned from this task.
double value = 1;
// Specifies an aggregatorr to pull the value of.
string aggregator_pubkey = 2;
}
}
// Opens and maintains a websocket for light speed data retrieval.
message WebsocketTask {
// The websocket url.
optional string url = 1;
// The websocket message to notify of a new subscription.
optional string subscription = 2;
// Minimum amount of time required between when the horses are taking out.
optional int32 max_data_age_seconds = 3;
// Incoming message JSONPath filter.
// Example: "$[?(@.channel == 'ticker' && @.market == 'BTC/USD')]"
optional string filter = 4;
}
// This task will run the `attempt` subtasks in an effort to produce a valid numerical result. If
// `attempt` fails to produce an acceptable result, `on_failure` subtasks will be run instead.
message ConditionalTask {
// A list of subtasks to process in an attempt to produce a valid numerical result.
repeated Task attempt = 1;
// A list of subtasks that will be run if `attempt` subtasks are unable to produce an acceptable
// result.
repeated Task on_failure = 2;
}
// This task will divide a numerical input by a scalar value or by another
// aggregate.
message DivideTask {
oneof Denominator {
// Specifies a basic scalar denominator to divide by.
double scalar = 1;
// Specifies another aggregator resut to divide by.
string aggregator_pubkey = 2;
// A job whose result is computed before dividing our numerical input by that result.
OracleJob job = 3;
}
}
// This task will multiply a numerical input by a scalar value or by another
// aggregate.
message MultiplyTask {
oneof Multiple {
// Specifies a scalar to multiply by.
double scalar = 1;
// Specifies an aggregator to multiply by.
string aggregator_pubkey = 2;
// A job whose result is computed before multiplying our numerical input by that result.
OracleJob job = 3;
}
}
// This task will add a numerical input by a scalar value or by another
// aggregate.
message AddTask {
oneof Addition {
// Specifies a scalar to add by.
double scalar = 1;
// Specifies an aggregator to add by.
string aggregator_pubkey = 2;
// A job whose result is computed before adding our numerical input by that result.
OracleJob job = 3;
}
}
// This task will subtract a numerical input by a scalar value or by another
// aggregate.
message SubtractTask {
oneof Subtraction {
// Specifies a scalar to subtract by.
double scalar = 1;
// Specifies an aggregator to subtract by.
string aggregator_pubkey = 2;
// A job whose result is computed before subtracting our numerical input by that result.
OracleJob job = 3;
}
}
// Fetch LP token price info from a number of supported exchanges.
message LpTokenPriceTask {
oneof PoolAddress {
// Mercurial finance pool address. A full list can be found here: https://github.com/mercurial-finance/stable-swap-n-pool-js
string mercurial_pool_address = 1;
// Saber pool address. A full list can be found here: https://github.com/saber-hq/saber-registry-dist
string saber_pool_address = 2;
// Orca pool address. A full list can be found here: https://www.orca.so/pools
string orca_pool_address = 3;
// The Raydium liquidity pool ammId. A full list can be found here: https://sdk.raydium.io/liquidity/mainnet.json
string raydium_pool_address = 4;
}
// A list of Switchboard aggregator accounts used to calculate the fair LP price. This ensures the price is based on the previous round to mitigate flash loan price manipulation.
repeated string price_feed_addresses = 5;
repeated OracleJob price_feed_jobs = 6;
// If enabled and price_feed_addresses provided, the oracle will calculate the fair LP price based on the liquidity pool reserves. See our blog post for more information: https://switchboardxyz.medium.com/fair-lp-token-oracles-94a457c50239
optional bool use_fair_price = 7;
}
// Fetch the current swap price for a given liquidity pool
message LpExchangeRateTask {
// Not Used
optional string in_token_address = 1;
// Not Used
optional string out_token_address = 2;
oneof PoolAddress {
// Mercurial finance pool address. A full list can be found here: https://github.com/mercurial-finance/stable-swap-n-pool-js
string mercurial_pool_address = 3;
// Saber pool address. A full list can be found here: https://github.com/saber-hq/saber-registry-dist
string saber_pool_address = 4;
// Orca pool address. A full list can be found here: https://www.orca.so/pools
string orca_pool_token_mint_address = 5;
// The Raydium liquidity pool ammId. A full list can be found here: https://sdk.raydium.io/liquidity/mainnet.json
string raydium_pool_address = 6;
}
}
// Find a pattern within a string of a previous task and extract a group number.
message RegexExtractTask {
// Regex pattern to find.
optional string pattern = 1;
// Group number to extract.
optional int32 group_number = 2;
}
message XStepPriceTask {
oneof StepSource {
// median task containing the job definitions to fetch the STEP/USD price
MedianTask step_job = 1;
// existing aggregator pubkey for STEP/USD
string step_aggregator_pubkey = 2;
}
}
// Takes a twap over a set period for a certain aggregator.
message TwapTask {
// The target aggregator for the TWAP.
optional string aggregator_pubkey = 1;
// Period, in seconds, the twap should account for
optional int32 period = 2;
// Weight samples by their propagation time
optional bool weight_by_propagation_time = 3;
// Minimum number of samples in the history to calculate a valid result
optional uint32 min_samples = 4;
// Ending unix timestamp to collect values up to
optional int32 ending_unix_timestamp = 5;
}
// Fetch the latest swap price on Serum's orderbook
message SerumSwapTask {
// The serum pool to fetch swap price for
optional string serum_pool_address = 1;
}
// Take the power of the working value.
message PowTask {
oneof Exponent {
// Take the working value to the exponent of value.
double scalar = 1;
// Take the working value to the exponent of the aggregators value.
string aggregator_pubkey = 2;
}
}
// Fetch the lending rates for various Solana protocols
message LendingRateTask {
// 01, apricot, francium, jet, larix, mango, port, solend, tulip
optional string protocol = 1;
// A token mint address supported by the chosen protocol
optional string asset_mint = 2;
enum Field {
// deposit lending rate
FIELD_DEPOSIT_RATE = 0;
// borrow lending rate
FIELD_BORROW_RATE = 1;
}
optional Field field = 3;
}
// Fetch the current price for a Mango perpetual market
message MangoPerpMarketTask {
// Mainnet address for a mango perpetual market. A full list can be found here: https://github.com/blockworks-foundation/mango-client-v3/blob/main/src/ids.json
optional string perp_market_address = 1;
}
message JupiterSwapTask {
optional string in_token_address = 1;
optional string out_token_address = 2;
optional double base_amount = 3;
}
// Fetch the current price of a perpetual market
message PerpMarketTask {
oneof MarketAddress {
// Market address for a mango perpetual market. A full list can be found here: https://github.com/blockworks-foundation/mango-client-v3/blob/main/src/ids.json
string mango_market_address = 1;
// Market address for a drift perpetual market. A full list can be found here: https://github.com/drift-labs/protocol-v1/blob/master/sdk/src/constants/markets.ts
string drift_market_address = 2;
// Market address for a zeta perpetual market.
string zeta_market_address = 3;
// Market address for a 01 protocol perpetual market.
string zo_market_address = 4;
}
}
// Fetch the current price of a Solana oracle protocol
message OracleTask {
oneof AggregatorAddress {
// Mainnet address of a Switchboard V2 feed. Switchboard is decentralized and allows anyone to build their own feed. A small subset of feeds is available here: https://switchboard.xyz/explorer
string switchboard_address = 1;
// Mainnet address for a Pyth feed. A full list can be found here: https://pyth.network/markets/
string pyth_address = 2;
// Devnet address for a Chainlink feed. A full list can be found here: https://docs.chain.link/docs/solana/data-feeds-solana
string chainlink_address = 3;
}
// Value (as a percentage) that the lower bound confidence interval is of the actual value.
// Confidence intervals that are larger that this treshold are rejected.
optional double pyth_allowed_confidence_interval = 4;
}
// Load a parse an Anchor based solana account.
message AnchorFetchTask {
// Owning program of the account to parse.
optional string program_id = 1;
// The account to parse.
optional string account_address = 2;
}
message DefiKingdomsTask {
message Token {
optional string address = 1;
optional int32 decimals = 2;
}
optional string provider = 1;
optional Token in_token = 2;
optional Token out_token = 3;
}
message TpsTask {}
message SplStakePoolTask {
// The pubkey of the SPL Stake Pool.``
optional string pubkey = 1;
}
message SplTokenParseTask {
oneof AccountAddress {
string token_account_address = 1;
string mint_address = 2;
}
}
message UniswapExchangeRateTask {
optional string in_token_address = 1;
optional string out_token_address = 2;
optional double in_token_amount = 3;
optional double slippage = 4;
optional string provider = 5;
}
message SushiswapExchangeRateTask {
optional string in_token_address = 1;
optional string out_token_address = 2;
optional double in_token_amount = 3;
optional double slippage = 4;
optional string provider = 5;
}
message PancakeswapExchangeRateTask {
optional string in_token_address = 1;
optional string out_token_address = 2;
optional double in_token_amount = 3;
optional double slippage = 4;
optional string provider = 5;
}
message Task {
oneof Task {
HttpTask http_task = 1;
JsonParseTask json_parse_task = 2;
MedianTask median_task = 4;
MeanTask mean_task = 5;
WebsocketTask websocket_task = 6;
DivideTask divide_task = 7;
MultiplyTask multiply_task = 8;
LpTokenPriceTask lp_token_price_task = 9;
LpExchangeRateTask lp_exchange_rate_task = 10;
ConditionalTask conditional_task = 11;
ValueTask value_task = 12;
MaxTask max_task = 13;
RegexExtractTask regex_extract_task = 14;
XStepPriceTask xstep_price_task = 15;
AddTask add_task = 16;
SubtractTask subtract_task = 17;
TwapTask twap_task = 18;
SerumSwapTask serum_swap_task = 19;
PowTask pow_task = 20;
LendingRateTask lending_rate_task = 21;
MangoPerpMarketTask mango_perp_market_task = 22;
JupiterSwapTask jupiter_swap_task = 23;
PerpMarketTask perp_market_task = 24;
OracleTask oracle_task = 25;
AnchorFetchTask anchor_fetch_task = 26;
DefiKingdomsTask defi_kingdoms_task = 27;
TpsTask tps_task = 28;
SplStakePoolTask spl_stake_pool_task = 29;
SplTokenParseTask spl_token_parse_task = 30;
UniswapExchangeRateTask uniswap_exchange_rate_task = 31;
SushiswapExchangeRateTask sushiswap_exchange_rate_task = 32;
PancakeswapExchangeRateTask pancakeswap_exchange_rate_task = 33;
}
}
// The chain of tasks to perform for this OracleJob.
repeated Task tasks = 1;
}
// The schema Oracle nodes receive when they are notified to fulfill a job.
message JobPosting {
// Pubkey of the aggregator to fulfill the job for.
optional bytes aggregator_state_pubkey = 1;
// The pubkey of the nodes this job is assigned to.
repeated bytes node_pubkeys = 2;
// Slot number of the job posting.
optional uint64 slot = 3;
}
// This schema Oracle nodes respond with when fulfilling a job.
message JobResult {
reserved 1, 5, 6;
// The public key of the responding node.
optional bytes node_pubkey = 2;
// The median value of the jobs the node has fulfilled successfully.
optional double result = 3;
// True if the node failed to decide on an answer to the job.
optional bool error = 4;
}

15
libraries/ts/package.json
View File

@ -29,22 +29,23 @@
},
"scripts": {
"docgen": "yarn build && npx typedoc",
"build:protos": "pbjs -t static-module -o src/protos.js ../protos/*.proto && pbts -o src/protos.d.ts src/protos.js",
"build:cjs": "shx rm -rf lib/cjs && tsc -p tsconfig.cjs.json && shx echo '{\"type\": \"commonjs\"}' > lib/cjs/package.json",
"build:esm": "shx rm -rf lib/esm && tsc -p tsconfig.esm.json && shx echo '{\"type\": \"module\"}' > lib/esm/package.json",
"build": "shx rm -rf lib && yarn build:cjs && yarn build:esm && shx rm lib/*.tsbuildinfo",
"test": "mocha --extension ts --require ts-node/register -t 1000000 tests/",
"lint": "eslint --fix-dry-run --ext .ts src/**/*.ts",
"prepublish": "yarn build"
},
"peerDependencies": {
"@solana/spl-governance": "^0.0.34",
"@solana/spl-token": "^0.1.8",
"@solana/web3.js": "1.37.1",
"@switchboard-xyz/switchboard-api": "^0.2.200"
"@solana/web3.js": "1.37.1"
},
"dependencies": {
"@project-serum/anchor": "^0.24.2",
"@solana/spl-governance": "^0.0.34",
"@switchboard-xyz/switchboard-api": "^0.2.200",
"@switchboard-xyz/eslint-config": "^0.1.1",
"assert": "^2.0.0",
"big.js": "^6.1.1",
"bs58": "^4.0.1",
@ -62,9 +63,17 @@
"@types/big.js": "^6.0.2",
"@types/long": "^4.0.1",
"@types/mocha": "^9.0.0",
"@types/node": "^17.0.35",
"npm-run-all": "^4.1.5",
"shx": "^0.3.4",
"typedoc": "^0.22.13",
"typescript": "^4.2.4"
},
"eslintConfig": {
"extends": "@switchboard-xyz",
"rules": {
"no-return-await": "off",
"quotes": "off"
}
}
}

4295
libraries/ts/src/index.ts
View File

File diff suppressed because it is too large Load Diff

4705
libraries/ts/src/protos.d.ts vendored Normal file
View File

File diff suppressed because it is too large Load Diff

10562
libraries/ts/src/protos.js Normal file
View File

File diff suppressed because it is too large Load Diff

4291
libraries/ts/src/sbv2.ts Normal file
View File

File diff suppressed because it is too large Load Diff

2
libraries/ts/tsconfig.json
View File

@ -22,6 +22,8 @@
"noEmit": false,
"emitDeclarationOnly": false,
"types": ["mocha", "node", "long"],
"allowJs": true,
"checkJs": false,
"sourceMap": true,
"inlineSources": true,
"lib": ["esnext"],

47
yarn.lock
View File

@ -4678,38 +4678,6 @@
"@svgr/plugin-jsx" "^6.2.1"
"@svgr/plugin-svgo" "^6.2.0"
"@switchboard-xyz/switchboard-api@^0.2.200":
version "0.2.200"
resolved "https://registry.npmjs.org/@switchboard-xyz/switchboard-api/-/switchboard-api-0.2.200.tgz#16c7d95390693e5992a7f96287143361b4d38cc9"
integrity sha512-JvH1HMB809GauOVdD4AhriFSVAq5yAlDtnyqEQhmr0r5WgcVinEZdY56c3fpUFN2DcFH4Gl3/PH3N73ektcmKQ==
dependencies:
"@solana/web3.js" "^1.17.0"
form-data "^4.0.0"
protobufjs "^6.10.2"
rpc-websockets "^7.4.12"
typedoc "^0.22.15"
ws "^7.4.6"
"@switchboard-xyz/switchboard-v2@^0.0.99":
version "0.0.99"
resolved "https://registry.npmjs.org/@switchboard-xyz/switchboard-v2/-/switchboard-v2-0.0.99.tgz#4e03c812bf4a4a90d2ea1bcc554e96cb6b18c63f"
integrity sha512-zZfZbi7KODZI617n9ndlRsvqOtM1ksuJBEWvhKzp9Ct//BtN2cij0yQNMtEse05y4fODRDfA0HHtS9ygS2mxjQ==
dependencies:
"@project-serum/anchor" "^0.24.2"
"@solana/spl-governance" "^0.0.34"
"@switchboard-xyz/switchboard-api" "^0.2.200"
assert "^2.0.0"
big.js "^6.1.1"
bs58 "^4.0.1"
buffer-layout "^1.2.0"
chalk "^4.1.2"
chan "^0.6.1"
crypto-js "^4.0.0"
dotenv "^16.0.0"
long "^4.0.0"
node-fetch "^3.2.3"
protobufjs "^6.10.2"
"@switchboard-xyz/v2-task-library@^0.1.1":
version "0.1.5"
resolved "https://registry.npmjs.org/@switchboard-xyz/v2-task-library/-/v2-task-library-0.1.5.tgz"
@ -6953,7 +6921,7 @@ combine-promises@^1.1.0:
resolved "https://registry.npmjs.org/combine-promises/-/combine-promises-1.1.0.tgz"
integrity sha512-ZI9jvcLDxqwaXEixOhArm3r7ReIivsXkpbyEWyeOhzz1QS0iSgBPnWvEqvIQtYyamGCYA88gFhmUrs9hrrQ0pg==
combined-stream@^1.0.6, combined-stream@^1.0.8, combined-stream@~1.0.6:
combined-stream@^1.0.6, combined-stream@~1.0.6:
version "1.0.8"
resolved "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz"
integrity sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==
@ -9300,15 +9268,6 @@ fork-ts-checker-webpack-plugin@^6.5.0:
semver "^7.3.2"
tapable "^1.0.0"
form-data@^4.0.0:
version "4.0.0"
resolved "https://registry.npmjs.org/form-data/-/form-data-4.0.0.tgz"
integrity sha512-ETEklSGi5t0QMZuiXoA/Q6vcnxcLQP5vdugSpuAyi6SVGi2clPPp+xgEhuMaHC+zGgn31Kd235W35f7Hykkaww==
dependencies:
asynckit "^0.4.0"
combined-stream "^1.0.8"
mime-types "^2.1.12"
form-data@~2.3.2:
version "2.3.3"
resolved "https://registry.npmjs.org/form-data/-/form-data-2.3.3.tgz"
@ -14769,7 +14728,7 @@ rimraf@^3.0.0, rimraf@^3.0.2:
dependencies:
glob "^7.1.3"
rpc-websockets@^7.4.12, rpc-websockets@^7.4.2:
rpc-websockets@^7.4.2:
version "7.4.18"
resolved "https://registry.npmjs.org/rpc-websockets/-/rpc-websockets-7.4.18.tgz"
integrity sha512-bVu+4qM5CkGVlTqJa6FaAxLbb5uRnyH4te7yjFvoCzbnif7PT4BcvXtNTprHlNvsH+/StB81zUQicxMrUrIomA==
@ -17119,7 +17078,7 @@ write-pkg@^4.0.0:
type-fest "^0.4.1"
write-json-file "^3.2.0"
ws@^7.0.0, ws@^7.3.1, ws@^7.4.5, ws@^7.4.6:
ws@^7.0.0, ws@^7.3.1, ws@^7.4.5:
version "7.5.7"
resolved "https://registry.npmjs.org/ws/-/ws-7.5.7.tgz"
integrity sha512-KMvVuFzpKBuiIXW3E4u3mySRO2/mCHSyZDJQM5NQ9Q9KHWHWh0NHgfbRMLLrceUK5qAL4ytALJbpRMjixFZh8A==