From a09a20b5b769ef21f76089a700cd5b6fddbda5ef Mon Sep 17 00:00:00 2001 From: Conner Gallagher Date: Tue, 24 May 2022 16:17:11 -0600 Subject: [PATCH] refactored documentation - updated IDL and API docs - refactored doc pages to be centered around resource - each resource gets its own top level heading with implementation details and examples wip idl updates fixed permissions idl cleanup wip oracle arch wip wip wip wip fixed metrics command wip fixed README paths fixed broken links cleanup updated docker version cleanup dev resource tables cleanup fixed broken pages --- cli/README.md | 52 + cli/src/commands/aggregator/create/index.ts | 106 ++ cli/src/commands/metrics/aggregator.ts | 6 +- config/eslint/.gitignore | 1 + config/eslint/README.md | 11 + config/eslint/index.js | 56 + config/eslint/package.json | 23 + lerna.json | 1 + libraries/ts/src/test/env.ts | 2 +- oracles/helm-deployment/build-helm.sh | 2 +- package.json | 2 + packages/README.md | 10 +- programs/README.md | 10 +- scripts/update-docker-version.js | 5 + website/api/overview.mdx | 78 +- website/api/python-overview.mdx | 8 + website/api/rust-overview.mdx | 8 + website/api/switchboard-tasks.md | 2 +- website/api/typescript-overview.mdx | 34 + .../architecture/_category_.json | 0 .../architecture/_queue-activities.mdx | 0 .../architecture/feeds/_category_.json | 0 .../architecture/feeds/activities.mdx | 0 .../feeds/activities/_data_feed_creation.mdx | 0 .../activities/_data_feed_update_request.mdx | 0 .../architecture/feeds/aggregator.mdx | 2 +- .../architecture/feeds/history.mdx | 0 .../architecture/feeds/job.mdx | 2 +- .../architecture/feeds/lease.mdx | 0 .../architecture/oracle-queue.mdx | 0 .../architecture/oracles/_category_.json | 0 .../architecture/oracles/activities.mdx | 0 .../architecture/oracles/oracle-buffer.mdx | 0 .../architecture/oracles/oracle.mdx | 0 .../architecture/permissions/_category_.json | 0 .../permissions/queue-permissions.mdx | 0 .../architecture/randomness/_category_.json | 0 .../architecture/randomness/activities.mdx | 0 .../architecture/randomness/vrf.mdx | 0 website/docs-1/dao.mdx | 9 + website/{docs => docs-1}/developers.mdx | 9 + .../{docs => docs-1}/feeds/_category_.json | 0 .../{docs => docs-1}/feeds/job-directory.mdx | 2 +- .../feeds/publisher/_category_.json | 0 .../feeds/publisher/custom-feeds.mdx | 2 +- .../feeds/publisher/overview.mdx | 0 website/docs-1/oracle/_category_.json | 4 + website/{docs => docs-1}/oracle/docker.mdx | 4 +- .../oracle/gcp/_category_.json | 0 .../{docs => docs-1}/oracle/gcp/automated.mdx | 0 .../{docs => docs-1}/oracle/gcp/deploy.mdx | 0 .../oracle/gcp/environment.mdx | 0 .../{docs => docs-1}/oracle/gcp/grafana.mdx | 0 .../{docs => docs-1}/oracle/gcp/manual.mdx | 0 .../{docs => docs-1}/oracle/gcp/overview.mdx | 0 .../{docs => docs-1}/oracle/introduction.mdx | 0 website/{docs => docs-1}/oracle/monitor.mdx | 0 .../oracle/oracle-account.mdx | 2 +- website/{docs => docs-1}/private-queues.mdx | 2 +- website/docs-1/program.mdx | 141 ++ website/{docs => docs-1}/randomness.mdx | 0 website/docs/buffer-relayer/_category_.json | 5 + website/docs/buffer-relayer/architecture.mdx | 30 + website/docs/dao.mdx | 111 +- website/docs/developers/_category_.json | 5 + website/docs/developers/_example_table.mdx | 25 + website/docs/developers/_idl.mdx | 18 + website/docs/developers/_library_table.mdx | 27 + website/docs/developers/_sdk.mdx | 22 + website/docs/developers/buffer-relayer.mdx | 96 ++ website/docs/developers/feed.mdx | 192 +++ website/docs/developers/localnet.mdx | 149 ++ website/docs/developers/oracle.mdx | 147 ++ website/docs/developers/queue.mdx | 102 ++ website/docs/developers/randomness.mdx | 106 ++ website/docs/developers/resources.mdx | 43 + website/docs/feed/_category_.json | 5 + website/docs/feed/architecture.mdx | 202 +++ website/docs/feed/directory.mdx | 1231 +++++++++++++++++ website/docs/feed/operator.mdx | 42 + website/docs/feed/publisher/_category_.json | 5 + website/docs/feed/publisher/_curation.mdx | 10 + website/docs/feed/publisher/_job-builder.mdx | 9 + website/docs/feed/publisher/overview.mdx | 275 ++++ website/docs/introduction.mdx | 2 - website/docs/oracle/_category_.json | 3 +- website/docs/oracle/architecture.mdx | 41 + website/docs/oracle/service/_category_.json | 5 + website/docs/oracle/service/docker.mdx | 74 + website/docs/oracle/service/gcp.mdx | 543 ++++++++ website/docs/oracle/service/monitoring.mdx | 86 ++ website/docs/oracle/service/requirements.mdx | 284 ++++ website/docs/program.mdx | 139 +- website/docs/queue/_category_.json | 5 + website/docs/queue/architecture.mdx | 141 ++ website/docs/queue/private-queues.mdx | 375 +++++ website/docs/randomness/_category_.json | 5 + website/docs/randomness/architecture.mdx | 93 ++ website/docusaurus.config.js | 28 +- website/idl/_full_toc.md | 46 +- website/idl/accounts/AggregatorAccountData.md | 61 +- .../idl/accounts/BufferRelayerAccountData.md | 13 + website/idl/accounts/CrankAccountData.md | 20 +- website/idl/accounts/JobAccountData.md | 21 +- website/idl/accounts/OracleAccountData.md | 22 +- .../idl/accounts/OracleQueueAccountData.md | 48 +- website/idl/accounts/PermissionAccountData.md | 2 +- website/idl/accounts/SbState.md | 3 +- website/idl/accounts/VrfAccountData.md | 18 +- website/idl/accounts/overview.md | 1 + website/idl/descriptions.json | 418 +++++- website/idl/errors.md | 162 ++- .../events/AggregatorCrankEvictionEvent.md | 8 + .../idl/events/AggregatorOpenRoundEvent.md | 14 +- .../idl/events/BufferRelayerOpenRoundEvent.md | 9 + website/idl/events/overview.md | 2 + website/idl/instructions/aggregatorAddJob.md | 9 +- website/idl/instructions/aggregatorInit.md | 14 +- website/idl/instructions/aggregatorLock.md | 6 +- .../idl/instructions/aggregatorOpenRound.md | 25 +- .../idl/instructions/aggregatorRemoveJob.md | 8 +- .../idl/instructions/aggregatorSaveResult.md | 29 +- .../instructions/aggregatorSetAuthority.md | 8 +- .../instructions/aggregatorSetBatchSize.md | 6 +- .../aggregatorSetForceReportPeriod.md | 11 + .../aggregatorSetHistoryBuffer.md | 8 +- .../idl/instructions/aggregatorSetMinJobs.md | 6 +- .../instructions/aggregatorSetMinOracles.md | 6 +- .../idl/instructions/aggregatorSetQueue.md | 8 +- .../aggregatorSetUpdateInterval.md | 6 +- .../aggregatorSetVarianceThreshold.md | 6 +- website/idl/instructions/bufferRelayerInit.md | 23 + .../instructions/bufferRelayerOpenRound.md | 16 + .../instructions/bufferRelayerSaveResult.md | 23 + website/idl/instructions/crankInit.md | 12 +- website/idl/instructions/crankPop.md | 40 +- website/idl/instructions/crankPush.md | 35 +- website/idl/instructions/jobInit.md | 10 +- website/idl/instructions/leaseExtend.md | 22 +- website/idl/instructions/leaseInit.md | 26 +- website/idl/instructions/leaseSetAuthority.md | 8 +- website/idl/instructions/leaseWithdraw.md | 21 +- website/idl/instructions/oracleHeartbeat.md | 16 +- website/idl/instructions/oracleInit.md | 18 +- website/idl/instructions/oracleQueueInit.md | 51 +- .../idl/instructions/oracleQueueSetRewards.md | 19 +- .../idl/instructions/oracleQueueVrfConfig.md | 6 +- website/idl/instructions/oracleWithdraw.md | 24 +- website/idl/instructions/overview.md | 4 + website/idl/instructions/permissionInit.md | 15 +- website/idl/instructions/permissionSet.md | 6 +- website/idl/instructions/programConfig.md | 8 +- website/idl/instructions/programInit.md | 19 +- website/idl/instructions/vaultTransfer.md | 14 +- website/idl/instructions/vrfInit.md | 14 +- website/idl/instructions/vrfProve.md | 8 +- website/idl/instructions/vrfProveAndVerify.md | 20 +- .../idl/instructions/vrfRequestRandomness.md | 26 +- website/idl/instructions/vrfVerify.md | 20 +- website/idl/overview.mdx | 15 + website/idl/page-last-updated.svg | 2 +- website/idl/types/BufferRelayerRound.md | 9 + website/idl/types/Error.md | 8 +- website/idl/types/Lanes.md | 12 +- website/idl/types/OracleResponseType.md | 8 +- website/idl/types/Shuffle.md | 20 +- website/idl/types/SwitchboardPermission.md | 12 +- website/idl/types/VrfStatus.md | 17 +- website/idl/types/_AggregatorAddJobParams.md | 1 + website/idl/types/_AggregatorInitParams.md | 3 +- .../idl/types/_AggregatorOpenRoundParams.md | 2 +- .../idl/types/_AggregatorSaveResultParams.md | 2 +- .../_AggregatorSetForceReportPeriodParams.md | 5 + website/idl/types/_BufferRelayerInitParams.md | 7 + .../types/_BufferRelayerOpenRoundParams.md | 6 + .../types/_BufferRelayerSaveResultParams.md | 8 + website/idl/types/_CrankPopParams.md | 2 +- website/idl/types/_CrankPushParams.md | 2 +- website/idl/types/_JobInitParams.md | 2 +- website/idl/types/_LeaseExtendParams.md | 3 +- website/idl/types/_LeaseInitParams.md | 3 +- website/idl/types/_LeaseWithdrawParams.md | 2 +- website/idl/types/_OracleInitParams.md | 2 +- website/idl/types/_OracleQueueInitParams.md | 1 + website/idl/types/_OracleWithdrawParams.md | 2 +- website/idl/types/_PermissionInitParams.md | 1 - website/idl/types/_ProgramConfigParams.md | 1 + website/idl/types/_ProgramInitParams.md | 2 +- website/idl/types/_VaultTransferParams.md | 2 +- website/idl/types/overview.md | 39 +- website/package.json | 7 +- website/sidebarsAPI.js | 34 +- website/src/components/CardSet.tsx | 172 +++ website/src/components/FeatureCard.tsx | 4 +- website/src/components/FeatureList.tsx | 19 +- website/src/components/HomepageFeatures.tsx | 6 - .../static/img/feeds/Aggregator_Accounts.png | Bin 0 -> 68913 bytes .../program/Program_State_Architecture.jpg | Bin 0 -> 40996 bytes .../img/queue/Oracle_Queue_Accounts.jpg | Bin 0 -> 34845 bytes yarn.lock | 93 +- 200 files changed, 6447 insertions(+), 914 deletions(-) create mode 100644 cli/src/commands/aggregator/create/index.ts create mode 100644 config/eslint/.gitignore create mode 100644 config/eslint/README.md create mode 100644 config/eslint/index.js create mode 100644 config/eslint/package.json create mode 100644 scripts/update-docker-version.js create mode 100644 website/api/python-overview.mdx create mode 100644 website/api/rust-overview.mdx create mode 100644 website/api/typescript-overview.mdx rename website/{docs => docs-1}/architecture/_category_.json (100%) rename website/{docs => docs-1}/architecture/_queue-activities.mdx (100%) rename website/{docs => docs-1}/architecture/feeds/_category_.json (100%) rename website/{docs => docs-1}/architecture/feeds/activities.mdx (100%) rename website/{docs => docs-1}/architecture/feeds/activities/_data_feed_creation.mdx (100%) rename website/{docs => docs-1}/architecture/feeds/activities/_data_feed_update_request.mdx (100%) rename website/{docs => docs-1}/architecture/feeds/aggregator.mdx (98%) rename website/{docs => docs-1}/architecture/feeds/history.mdx (100%) rename website/{docs => docs-1}/architecture/feeds/job.mdx (98%) rename website/{docs => docs-1}/architecture/feeds/lease.mdx (100%) rename website/{docs => docs-1}/architecture/oracle-queue.mdx (100%) rename website/{docs => docs-1}/architecture/oracles/_category_.json (100%) rename website/{docs => docs-1}/architecture/oracles/activities.mdx (100%) rename website/{docs => docs-1}/architecture/oracles/oracle-buffer.mdx (100%) rename website/{docs => docs-1}/architecture/oracles/oracle.mdx (100%) rename website/{docs => docs-1}/architecture/permissions/_category_.json (100%) rename website/{docs => docs-1}/architecture/permissions/queue-permissions.mdx (100%) rename website/{docs => docs-1}/architecture/randomness/_category_.json (100%) rename website/{docs => docs-1}/architecture/randomness/activities.mdx (100%) rename website/{docs => docs-1}/architecture/randomness/vrf.mdx (100%) create mode 100644 website/docs-1/dao.mdx rename website/{docs => docs-1}/developers.mdx (88%) rename website/{docs => docs-1}/feeds/_category_.json (100%) rename website/{docs => docs-1}/feeds/job-directory.mdx (99%) rename website/{docs => docs-1}/feeds/publisher/_category_.json (100%) rename website/{docs => docs-1}/feeds/publisher/custom-feeds.mdx (97%) rename website/{docs => docs-1}/feeds/publisher/overview.mdx (100%) create mode 100644 website/docs-1/oracle/_category_.json rename website/{docs => docs-1}/oracle/docker.mdx (94%) rename website/{docs => docs-1}/oracle/gcp/_category_.json (100%) rename website/{docs => docs-1}/oracle/gcp/automated.mdx (100%) rename website/{docs => docs-1}/oracle/gcp/deploy.mdx (100%) rename website/{docs => docs-1}/oracle/gcp/environment.mdx (100%) rename website/{docs => docs-1}/oracle/gcp/grafana.mdx (100%) rename website/{docs => docs-1}/oracle/gcp/manual.mdx (100%) rename website/{docs => docs-1}/oracle/gcp/overview.mdx (100%) rename website/{docs => docs-1}/oracle/introduction.mdx (100%) rename website/{docs => docs-1}/oracle/monitor.mdx (100%) rename website/{docs => docs-1}/oracle/oracle-account.mdx (96%) rename website/{docs => docs-1}/private-queues.mdx (99%) create mode 100644 website/docs-1/program.mdx rename website/{docs => docs-1}/randomness.mdx (100%) create mode 100644 website/docs/buffer-relayer/_category_.json create mode 100644 website/docs/buffer-relayer/architecture.mdx create mode 100644 website/docs/developers/_category_.json create mode 100644 website/docs/developers/_example_table.mdx create mode 100644 website/docs/developers/_idl.mdx create mode 100644 website/docs/developers/_library_table.mdx create mode 100644 website/docs/developers/_sdk.mdx create mode 100644 website/docs/developers/buffer-relayer.mdx create mode 100644 website/docs/developers/feed.mdx create mode 100644 website/docs/developers/localnet.mdx create mode 100644 website/docs/developers/oracle.mdx create mode 100644 website/docs/developers/queue.mdx create mode 100644 website/docs/developers/randomness.mdx create mode 100644 website/docs/developers/resources.mdx create mode 100644 website/docs/feed/_category_.json create mode 100644 website/docs/feed/architecture.mdx create mode 100644 website/docs/feed/directory.mdx create mode 100644 website/docs/feed/operator.mdx create mode 100644 website/docs/feed/publisher/_category_.json create mode 100644 website/docs/feed/publisher/_curation.mdx create mode 100644 website/docs/feed/publisher/_job-builder.mdx create mode 100644 website/docs/feed/publisher/overview.mdx create mode 100644 website/docs/oracle/architecture.mdx create mode 100644 website/docs/oracle/service/_category_.json create mode 100644 website/docs/oracle/service/docker.mdx create mode 100644 website/docs/oracle/service/gcp.mdx create mode 100644 website/docs/oracle/service/monitoring.mdx create mode 100644 website/docs/oracle/service/requirements.mdx create mode 100644 website/docs/queue/_category_.json create mode 100644 website/docs/queue/architecture.mdx create mode 100644 website/docs/queue/private-queues.mdx create mode 100644 website/docs/randomness/_category_.json create mode 100644 website/docs/randomness/architecture.mdx create mode 100644 website/idl/accounts/BufferRelayerAccountData.md create mode 100644 website/idl/events/AggregatorCrankEvictionEvent.md create mode 100644 website/idl/events/BufferRelayerOpenRoundEvent.md create mode 100644 website/idl/instructions/aggregatorSetForceReportPeriod.md create mode 100644 website/idl/instructions/bufferRelayerInit.md create mode 100644 website/idl/instructions/bufferRelayerOpenRound.md create mode 100644 website/idl/instructions/bufferRelayerSaveResult.md create mode 100644 website/idl/types/BufferRelayerRound.md create mode 100644 website/idl/types/_AggregatorSetForceReportPeriodParams.md create mode 100644 website/idl/types/_BufferRelayerInitParams.md create mode 100644 website/idl/types/_BufferRelayerOpenRoundParams.md create mode 100644 website/idl/types/_BufferRelayerSaveResultParams.md create mode 100644 website/src/components/CardSet.tsx create mode 100644 website/static/img/feeds/Aggregator_Accounts.png create mode 100644 website/static/img/program/Program_State_Architecture.jpg create mode 100644 website/static/img/queue/Oracle_Queue_Accounts.jpg diff --git a/cli/README.md b/cli/README.md index 2f24da4..8875b5e 100644 --- a/cli/README.md +++ b/cli/README.md @@ -13,6 +13,7 @@ npm install -g @switchboard-xyz/switchboardv2-cli * [`sbv2 aggregator:add:job AGGREGATORKEY`](#sbv2-aggregatoraddjob-aggregatorkey) +* [`sbv2 aggregator:create QUEUEKEY`](#sbv2-aggregatorcreate-queuekey) * [`sbv2 aggregator:create:copy AGGREGATORSOURCE`](#sbv2-aggregatorcreatecopy-aggregatorsource) * [`sbv2 aggregator:create:json DEFINITIONFILE`](#sbv2-aggregatorcreatejson-definitionfile) * [`sbv2 aggregator:lock AGGREGATORKEY`](#sbv2-aggregatorlock-aggregatorkey) @@ -124,6 +125,57 @@ EXAMPLE _See code: [src/commands/aggregator/add/job.ts](https://github.com/switchboard-xyz/switchboard-v2/blob/v0.1.21/src/commands/aggregator/add/job.ts)_ +## `sbv2 aggregator:create QUEUEKEY` + +create an aggregator account + +``` +USAGE + $ sbv2 aggregator:create QUEUEKEY + +ARGUMENTS + QUEUEKEY public key of the oracle queue account to create aggregator for + +OPTIONS + -a, --authority=authority alternate keypair that is the authority for the aggregator + -h, --help show CLI help + -j, --job=job filesystem path to job definition file + + -k, --keypair=keypair keypair that will pay for onchain transactions. defaults to new account + authority if no alternate authority provided + + -s, --silent suppress cli prompts + + -u, --rpcUrl=rpcUrl alternate RPC url + + -v, --verbose log everything + + --batchSize=batchSize number of oracles requested for each open round call + + --force skip job confirmation + + --forceReportPeriod=forceReportPeriod Number of seconds for which, even if the variance threshold is not passed, + accept new responses from oracles. + + --mainnetBeta WARNING: use mainnet-beta solana cluster + + --minJobs=minJobs number of jobs that must respond before an oracle responds + + --minOracles=minOracles number of oracles that must respond before a value is accepted on-chain + + --newQueue=newQueue public key of the new oracle queue + + --programId=programId alternative Switchboard program ID to interact with + + --updateInterval=updateInterval set an aggregator's minimum update delay + + --varianceThreshold=varianceThreshold percentage change between a previous accepted result and the next round before + an oracle reports a value on-chain. Used to conserve lease cost during low + volatility +``` + +_See code: [src/commands/aggregator/create/index.ts](https://github.com/switchboard-xyz/switchboard-v2/blob/v0.1.21/src/commands/aggregator/create/index.ts)_ + ## `sbv2 aggregator:create:copy AGGREGATORSOURCE` copy an aggregator account to a new oracle queue diff --git a/cli/src/commands/aggregator/create/index.ts b/cli/src/commands/aggregator/create/index.ts new file mode 100644 index 0000000..c46851c --- /dev/null +++ b/cli/src/commands/aggregator/create/index.ts @@ -0,0 +1,106 @@ +import { flags } from "@oclif/command"; +import { PublicKey } from "@solana/web3.js"; +import { + OracleJob, + OracleQueueAccount, + programWallet, +} from "@switchboard-xyz/switchboard-v2"; +import fs from "fs"; +import path from "path"; +import BaseCommand from "../../../BaseCommand"; +import { verifyProgramHasPayer } from "../../../utils"; + +export default class AggregatorCreate extends BaseCommand { + static description = "create an aggregator account"; + + static flags = { + ...BaseCommand.flags, + force: flags.boolean({ description: "skip job confirmation" }), + authority: flags.string({ + char: "a", + description: "alternate keypair that is the authority for the aggregator", + }), + forceReportPeriod: flags.string({ + description: + "Number of seconds for which, even if the variance threshold is not passed, accept new responses from oracles.", + }), + batchSize: flags.string({ + description: "number of oracles requested for each open round call", + }), + minJobs: flags.string({ + description: "number of jobs that must respond before an oracle responds", + }), + minOracles: flags.string({ + description: + "number of oracles that must respond before a value is accepted on-chain", + }), + newQueue: flags.string({ + description: "public key of the new oracle queue", + }), + updateInterval: flags.string({ + description: "set an aggregator's minimum update delay", + }), + varianceThreshold: flags.string({ + description: + "percentage change between a previous accepted result and the next round before an oracle reports a value on-chain. Used to conserve lease cost during low volatility", + }), + job: flags.string({ + char: "j", + description: "filesystem path to job definition file", + multiple: true, + }), + }; + + static args = [ + { + name: "queueKey", + required: true, + parse: (pubkey: string) => new PublicKey(pubkey), + description: + "public key of the oracle queue account to create aggregator for", + }, + ]; + + async run() { + verifyProgramHasPayer(this.program); + const { args, flags } = this.parse(AggregatorCreate); + + const payerKeypair = programWallet(this.program); + + const queueAccount = new OracleQueueAccount({ + program: this.program, + publicKey: args.queueKey, + }); + const switchTokenMint = await queueAccount.loadMint(); + const payerTokenWallet = ( + await switchTokenMint.getOrCreateAssociatedAccountInfo( + payerKeypair.publicKey + ) + ).address; + + const jobs = flags.job.map((jobDefinition) => { + const jobJson = JSON.parse( + fs.readFileSync( + jobDefinition.startsWith("/") + ? jobDefinition + : path.join(process.cwd(), jobDefinition), + "utf8" + ) + ); + if (!jobJson || !("tasks" in jobJson)) { + throw new Error("job definition missing tasks"); + } + const data = Buffer.from( + OracleJob.encodeDelimited( + OracleJob.create({ + tasks: jobJson.tasks, + }) + ).finish() + ); + }); + } + + async catch(error) { + super.catch(error, "Failed to create aggregator account"); + } +} diff --git a/cli/src/commands/metrics/aggregator.ts b/cli/src/commands/metrics/aggregator.ts index 871f843..58eff16 100644 --- a/cli/src/commands/metrics/aggregator.ts +++ b/cli/src/commands/metrics/aggregator.ts @@ -8,6 +8,7 @@ import bs58 from "bs58"; import fs from "fs"; import path from "path"; import BaseCommand from "../../BaseCommand"; +import { LogProvider } from "../../types"; export default class MetricsAggregator extends BaseCommand { static description = "get metrics on switchboard aggregators"; @@ -259,7 +260,7 @@ async function buildAggregators( .flat(); // store a map of job pubkeys and their definitions - const jobMap = await buildJobMap(program, jobPubkeys); + const jobMap = await buildJobMap(this.logger, program, jobPubkeys); const aggregators: Aggregator[] = []; for await (const account of aggregatorAccounts) { @@ -286,6 +287,7 @@ async function buildAggregators( } async function buildJobMap( + logger: LogProvider, program: anchor.Program, pubkeys: PublicKey[], max = 300 @@ -312,7 +314,7 @@ async function buildJobMap( // console.log(`jobKey: ${publicKey}, ${JSON.stringify(job)}`); jobMap.set(publicKey.toString(), job); } catch (error) { - this.logger.debug(`JobDecodeError: ${error}`); + this.logger.debug(`JobDecodeError: ${pubKeyBatch[index]} - ${error}`); } } } diff --git a/config/eslint/.gitignore b/config/eslint/.gitignore new file mode 100644 index 0000000..b512c09 --- /dev/null +++ b/config/eslint/.gitignore @@ -0,0 +1 @@ +node_modules \ No newline at end of file diff --git a/config/eslint/README.md b/config/eslint/README.md new file mode 100644 index 0000000..1a8de44 --- /dev/null +++ b/config/eslint/README.md @@ -0,0 +1,11 @@ +# Switchboard Eslint Config + +## Add to your project + +Create `.eslintrc.json` + +```json +{ + "extends": "@switchboard-xyz" +} +``` diff --git a/config/eslint/index.js b/config/eslint/index.js new file mode 100644 index 0000000..0ace4f5 --- /dev/null +++ b/config/eslint/index.js @@ -0,0 +1,56 @@ +// Google gts eslint-config https://github.com/google/gts/blob/main/.eslintrc.json +module.exports = { + extends: ["eslint:recommended", "plugin:node/recommended", "prettier"], + plugins: ["node", "prettier"], + rules: { + "prettier/prettier": "error", + "block-scoped-var": "error", + eqeqeq: "error", + "no-var": "error", + "prefer-const": "error", + "eol-last": "error", + "prefer-arrow-callback": "error", + "no-trailing-spaces": "error", + quotes: ["warn", "single", { avoidEscape: true }], + "no-restricted-properties": [ + "error", + { + object: "describe", + property: "only", + }, + { + object: "it", + property: "only", + }, + ], + }, + overrides: [ + { + files: ["**/*.ts", "**/*.tsx"], + parser: "@typescript-eslint/parser", + extends: ["plugin:@typescript-eslint/recommended"], + rules: { + "@typescript-eslint/no-non-null-assertion": "off", + "@typescript-eslint/no-use-before-define": "off", + "@typescript-eslint/no-warning-comments": "off", + "@typescript-eslint/no-empty-function": "off", + "@typescript-eslint/no-var-requires": "off", + "@typescript-eslint/explicit-function-return-type": "off", + "@typescript-eslint/explicit-module-boundary-types": "off", + "@typescript-eslint/ban-types": "off", + "@typescript-eslint/camelcase": "off", + "node/no-missing-import": "off", + "node/no-empty-function": "off", + "node/no-unsupported-features/es-syntax": "off", + "node/no-missing-require": "off", + "node/shebang": "off", + "no-dupe-class-members": "off", + "require-atomic-updates": "off", + }, + parserOptions: { + ecmaVersion: 2018, + sourceType: "module", + }, + }, + ], +}; diff --git a/config/eslint/package.json b/config/eslint/package.json new file mode 100644 index 0000000..fd954e4 --- /dev/null +++ b/config/eslint/package.json @@ -0,0 +1,23 @@ +{ + "name": "@switchboard-xyz/eslint-config", + "version": "0.1.0", + "author": "", + "license": "MIT", + "description": "Switchboard eslint-config", + "main": "index.js", + "scripts": { + "build": "echo \"No build script required for workspace eslint-config\" && exit 0", + "test": "echo \"No test script required for workspace eslint-config\" && exit 0" + }, + "peerDependencies": { + "eslint": "^6 || ^7.2.0", + "prettier": ">= 1.13" + }, + "dependencies": {}, + "devDependencies": { + "eslint-config-airbnb": "^19.0.4", + "eslint-config-prettier": "^8.5.0", + "eslint-plugin-import": "^2.26.0", + "eslint-plugin-prettier": "^4.0.0" + } +} diff --git a/lerna.json b/lerna.json index dca294f..406c322 100644 --- a/lerna.json +++ b/lerna.json @@ -1,5 +1,6 @@ { "packages": [ + "config/*", "libraries/sbv2-lite", "libraries/ts", "libraries/sbv2-utils", diff --git a/libraries/ts/src/test/env.ts b/libraries/ts/src/test/env.ts index 500cc7d..d577f82 100644 --- a/libraries/ts/src/test/env.ts +++ b/libraries/ts/src/test/env.ts @@ -8,7 +8,7 @@ import path from "path"; import * as sbv2 from "../"; import { getIdlAddress, getProgramDataAddress } from "./utils"; -const LATEST_DOCKER_VERSION = "dev-v2-4-12-22h"; +const LATEST_DOCKER_VERSION = "dev-v2-5-3-22"; export interface ISwitchboardTestEnvironment { programId: PublicKey; diff --git a/oracles/helm-deployment/build-helm.sh b/oracles/helm-deployment/build-helm.sh index 62b7336..030d218 100755 --- a/oracles/helm-deployment/build-helm.sh +++ b/oracles/helm-deployment/build-helm.sh @@ -90,7 +90,7 @@ if [[ -z "${GRAFANA_HOSTNAME}" ]]; then exit 1 fi if [[ -z "${GRAFANA_ADMIN_PASSWORD}" ]]; then - GRAFANA_ADMIN_PASSWORD="${GRAFANA_ADMIN_PASSWORD:-SbCongraph50!}" + GRAFANA_ADMIN_PASSWORD="${GRAFANA_ADMIN_PASSWORD:-Sbv2K8sPassword123@}" fi if [[ -z "${GRAFANA_TLS_CRT}" ]]; then echo "failed to set GRAFANA_TLS_CRT" diff --git a/package.json b/package.json index 59d512f..1faea3a 100644 --- a/package.json +++ b/package.json @@ -3,6 +3,7 @@ "description": "switchboard v2 repo containing type definitions, libraries, and examples", "private": true, "workspaces": [ + "config/*", "libraries/sbv2-lite", "libraries/ts", "libraries/sbv2-utils", @@ -29,6 +30,7 @@ "docs:build": "run-s docs:build:ts docs:build:sbv2-lite docs:build:site", "docs:deploy": "yarn workspace website deploy", "gen:idl": "rawrtools gen:anchor SW1TCH7qEPTdLsDHRgPuMQjbQxKdH2aBStViMFnt64f -o website/idl -p /idl", + "gen:idl:devnet": "rawrtools gen:anchor --devnet 2TfB33aLaneQb5TNVwyDz3jSZXS6jdW2ARw1Dgf84XCG -o website/idl -p /idl", "nuke": "shx rm -rf {./programs/*,./packages/*,./website,./libraries/*,.}/{node_modules,yarn*.log,build,dist,lib,.anchor,target,Cargo.lock,.docusaurus}" }, "devDependencies": { diff --git a/packages/README.md b/packages/README.md index 265beda..50b329c 100644 --- a/packages/README.md +++ b/packages/README.md @@ -1,7 +1,7 @@ # Switchboard V2 Client Examples -| Package | Description | -| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------- | -| [feed-parser](./packages/feed-parser) | Typescript example demonstrating how to read an aggregator account. | -| [feed-walkthrough](./packages/feed-walkthrough) | Typescript example demonstrating how to create and manage your own oracle queue. | -| [lease-observer](./packages/lease-observer) | Typescript example demonstrating how to send PagerDuty alerts when your aggregator lease is low on funds. | +| Package | Description | +| -------------------------------------- | --------------------------------------------------------------------------------------------------------- | +| [feed-parser](./feed-parser) | Typescript example demonstrating how to read an aggregator account. | +| [feed-walkthrough](./feed-walkthrough) | Typescript example demonstrating how to create and manage your own oracle queue. | +| [lease-observer](./lease-observer) | Typescript example demonstrating how to send PagerDuty alerts when your aggregator lease is low on funds. | diff --git a/programs/README.md b/programs/README.md index d736999..9a6d0a9 100644 --- a/programs/README.md +++ b/programs/README.md @@ -1,7 +1,7 @@ ### Sbv2 Program Examples -| Package | Description | -| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| [anchor-feed-parser](./programs/anchor-feed-parser) | Anchor example program demonstrating how to deserialize and read an onchain aggregator. | -| [spl-feed-parser](./programs/spl-feed-parser) | Solana Program Library example demonstrating how to deserialize and read an onchain aggregator. | -| [anchor-vrf-parser](./programs/anchor-vrf-parser) | Anchor example program demonstrating how to deserialize and read an onchain verifiable randomness function (VRF) account. | +| Package | Description | +| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | +| [anchor-feed-parser](./anchor-feed-parser) | Anchor example program demonstrating how to deserialize and read an onchain aggregator. | +| [spl-feed-parser](./spl-feed-parser) | Solana Program Library example demonstrating how to deserialize and read an onchain aggregator. | +| [anchor-vrf-parser](./anchor-vrf-parser) | Anchor example program demonstrating how to deserialize and read an onchain verifiable randomness function (VRF) account. | diff --git a/scripts/update-docker-version.js b/scripts/update-docker-version.js new file mode 100644 index 0000000..bb43725 --- /dev/null +++ b/scripts/update-docker-version.js @@ -0,0 +1,5 @@ +#!/usr/bin/env node + +// TODO + +// Regex: dev-v2-[0-9]{1,2}-[0-9]{1,2}-[0-9]{1,2}[A-Za-z]? diff --git a/website/api/overview.mdx b/website/api/overview.mdx index cacd640..92565da 100644 --- a/website/api/overview.mdx +++ b/website/api/overview.mdx @@ -5,10 +5,11 @@ slug: . title: API Overview --- +import LibraryTable from "/docs/developers/_library_table.mdx"; +import SDK from "/docs/developers/_sdk.mdx"; +import IDL from "/docs/developers/_idl.mdx"; +import ExampleTable from "/docs/developers/_example_table.mdx"; import MarkdownImage from "/src/components/MarkdownImage"; -import { Box, Typography, Grid } from "@mui/material"; -import Link from "@docusaurus/Link"; -import { VscGithubInverted } from "react-icons/vsc"; # Developer Resources @@ -16,77 +17,20 @@ import { VscGithubInverted } from "react-icons/vsc"; img="/img/Switchboard_v2_Live.png" sx={{ borderWidth: "thin", border: "1px solid #D3D3D3", borderRadius: 3 }} /> +
## SDK - - The Switchboard-V2 repository contains all of the libraries, examples, and - documentation to help you get started integrating Switchboard. - - -
- - - - - -  @switchboard-xyz/switchboard-v2  - - - - - -
+ ## Anchor IDL - - Switchboard's Anchor IDL contains a detailed description of the program - interfaces and schemas. - + - +## Libraries - - ⚓ Anchor IDL ⚓ - + - +## Examples -
- -## APIs - - - Switchboard's APIs provide a client interface to interact with Switchboard V2 - on-chain. - - -| Resource | Description | -| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- | -| switchboard-tasks | Protobuf definitions for the various supported task definitions to build job definitions from. | -| switchboardv2-api | A typescript library of utility functions to interact with the Switchboardv2 program. | -| switchboardpy | A python library of utility functions to interact with the Switchboardv2 program. | -| switchboardv2-cli | A Command Line Interface (CLI) to interact with the Switchboardv2 program. | -| switchboard-v2 | A rust library of utility functions to interact with the Switchboardv2 program on-chain. | - -
- - + diff --git a/website/api/python-overview.mdx b/website/api/python-overview.mdx new file mode 100644 index 0000000..1241100 --- /dev/null +++ b/website/api/python-overview.mdx @@ -0,0 +1,8 @@ +--- +id: python-overview +title: Python +--- + +## Usage + +## Examples diff --git a/website/api/rust-overview.mdx b/website/api/rust-overview.mdx new file mode 100644 index 0000000..477869f --- /dev/null +++ b/website/api/rust-overview.mdx @@ -0,0 +1,8 @@ +--- +id: rust-overview +title: Rust +--- + +## Usage + +## Examples diff --git a/website/api/switchboard-tasks.md b/website/api/switchboard-tasks.md index ab7d27f..f881abb 100644 --- a/website/api/switchboard-tasks.md +++ b/website/api/switchboard-tasks.md @@ -24,7 +24,7 @@ Switchboard tasks can be divided into the following categories: :::tip -Check out the [**Job Directory**](/job-directory) for examples! +Check out the [**Job Directory**](/feed/directory) for examples! ::: diff --git a/website/api/typescript-overview.mdx b/website/api/typescript-overview.mdx new file mode 100644 index 0000000..ef2662d --- /dev/null +++ b/website/api/typescript-overview.mdx @@ -0,0 +1,34 @@ +--- +id: typescript-overview +title: Typescript +--- + +import { styled, ThemeProvider } from "@mui/system"; +import { Box, CssBaseline } from "@mui/material"; +import { FeatureCard } from "/src/components/FeatureCard"; +import { CardSet } from "/src/components/CardSet"; +import { theme } from "/src/components/theme"; +import { Grid, Typography } from "@mui/material"; +import { useColorMode } from "@docusaurus/theme-common"; +import useDocusaurusContext from "@docusaurus/useDocusaurusContext"; +import Layout from "@theme/Layout"; +const LibrariesList = [ + { + title: "switchboard-v2", + image: "/img/icons/info.png", + description: "Switchboard V2 Typescript client", + linkTo: "https://docs.switchboard.xyz/api/ts", + }, + { + title: "sbv2-lite", + image: "/img/icons/info.png", + description: "Switchboard V2 Typescript client", + linkTo: "https://docs.switchboard.xyz/api/ts", + }, +]; + +## Libraries + + + +## Examples diff --git a/website/docs/architecture/_category_.json b/website/docs-1/architecture/_category_.json similarity index 100% rename from website/docs/architecture/_category_.json rename to website/docs-1/architecture/_category_.json diff --git a/website/docs/architecture/_queue-activities.mdx b/website/docs-1/architecture/_queue-activities.mdx similarity index 100% rename from website/docs/architecture/_queue-activities.mdx rename to website/docs-1/architecture/_queue-activities.mdx diff --git a/website/docs/architecture/feeds/_category_.json b/website/docs-1/architecture/feeds/_category_.json similarity index 100% rename from website/docs/architecture/feeds/_category_.json rename to website/docs-1/architecture/feeds/_category_.json diff --git a/website/docs/architecture/feeds/activities.mdx b/website/docs-1/architecture/feeds/activities.mdx similarity index 100% rename from website/docs/architecture/feeds/activities.mdx rename to website/docs-1/architecture/feeds/activities.mdx diff --git a/website/docs/architecture/feeds/activities/_data_feed_creation.mdx b/website/docs-1/architecture/feeds/activities/_data_feed_creation.mdx similarity index 100% rename from website/docs/architecture/feeds/activities/_data_feed_creation.mdx rename to website/docs-1/architecture/feeds/activities/_data_feed_creation.mdx diff --git a/website/docs/architecture/feeds/activities/_data_feed_update_request.mdx b/website/docs-1/architecture/feeds/activities/_data_feed_update_request.mdx similarity index 100% rename from website/docs/architecture/feeds/activities/_data_feed_update_request.mdx rename to website/docs-1/architecture/feeds/activities/_data_feed_update_request.mdx diff --git a/website/docs/architecture/feeds/aggregator.mdx b/website/docs-1/architecture/feeds/aggregator.mdx similarity index 98% rename from website/docs/architecture/feeds/aggregator.mdx rename to website/docs-1/architecture/feeds/aggregator.mdx index 2fa3c4f..452abf0 100644 --- a/website/docs/architecture/feeds/aggregator.mdx +++ b/website/docs-1/architecture/feeds/aggregator.mdx @@ -91,6 +91,6 @@ An aggregator uses a [Lease Contract](/architecture/feeds/lease) to reward oracl - ℹ️ Publisher -- +- ℹ️ Job Directory diff --git a/website/docs/architecture/feeds/history.mdx b/website/docs-1/architecture/feeds/history.mdx similarity index 100% rename from website/docs/architecture/feeds/history.mdx rename to website/docs-1/architecture/feeds/history.mdx diff --git a/website/docs/architecture/feeds/job.mdx b/website/docs-1/architecture/feeds/job.mdx similarity index 98% rename from website/docs/architecture/feeds/job.mdx rename to website/docs-1/architecture/feeds/job.mdx index b9d075a..ba952ac 100644 --- a/website/docs/architecture/feeds/job.mdx +++ b/website/docs-1/architecture/feeds/job.mdx @@ -72,6 +72,6 @@ The [ValueTask](/api/tasks#ValueTask) is used to return a static value. This is - ℹ️ Task Definitions -- +- ℹ️ Job Directory diff --git a/website/docs/architecture/feeds/lease.mdx b/website/docs-1/architecture/feeds/lease.mdx similarity index 100% rename from website/docs/architecture/feeds/lease.mdx rename to website/docs-1/architecture/feeds/lease.mdx diff --git a/website/docs/architecture/oracle-queue.mdx b/website/docs-1/architecture/oracle-queue.mdx similarity index 100% rename from website/docs/architecture/oracle-queue.mdx rename to website/docs-1/architecture/oracle-queue.mdx diff --git a/website/docs/architecture/oracles/_category_.json b/website/docs-1/architecture/oracles/_category_.json similarity index 100% rename from website/docs/architecture/oracles/_category_.json rename to website/docs-1/architecture/oracles/_category_.json diff --git a/website/docs/architecture/oracles/activities.mdx b/website/docs-1/architecture/oracles/activities.mdx similarity index 100% rename from website/docs/architecture/oracles/activities.mdx rename to website/docs-1/architecture/oracles/activities.mdx diff --git a/website/docs/architecture/oracles/oracle-buffer.mdx b/website/docs-1/architecture/oracles/oracle-buffer.mdx similarity index 100% rename from website/docs/architecture/oracles/oracle-buffer.mdx rename to website/docs-1/architecture/oracles/oracle-buffer.mdx diff --git a/website/docs/architecture/oracles/oracle.mdx b/website/docs-1/architecture/oracles/oracle.mdx similarity index 100% rename from website/docs/architecture/oracles/oracle.mdx rename to website/docs-1/architecture/oracles/oracle.mdx diff --git a/website/docs/architecture/permissions/_category_.json b/website/docs-1/architecture/permissions/_category_.json similarity index 100% rename from website/docs/architecture/permissions/_category_.json rename to website/docs-1/architecture/permissions/_category_.json diff --git a/website/docs/architecture/permissions/queue-permissions.mdx b/website/docs-1/architecture/permissions/queue-permissions.mdx similarity index 100% rename from website/docs/architecture/permissions/queue-permissions.mdx rename to website/docs-1/architecture/permissions/queue-permissions.mdx diff --git a/website/docs/architecture/randomness/_category_.json b/website/docs-1/architecture/randomness/_category_.json similarity index 100% rename from website/docs/architecture/randomness/_category_.json rename to website/docs-1/architecture/randomness/_category_.json diff --git a/website/docs/architecture/randomness/activities.mdx b/website/docs-1/architecture/randomness/activities.mdx similarity index 100% rename from website/docs/architecture/randomness/activities.mdx rename to website/docs-1/architecture/randomness/activities.mdx diff --git a/website/docs/architecture/randomness/vrf.mdx b/website/docs-1/architecture/randomness/vrf.mdx similarity index 100% rename from website/docs/architecture/randomness/vrf.mdx rename to website/docs-1/architecture/randomness/vrf.mdx diff --git a/website/docs-1/dao.mdx b/website/docs-1/dao.mdx new file mode 100644 index 0000000..f367212 --- /dev/null +++ b/website/docs-1/dao.mdx @@ -0,0 +1,9 @@ +--- +sidebar_position: 80 +slug: /dao +title: Switchboard DAO +--- + +# Switchboard DAO + +The Switchboard DAO will operate a set of oracle queues and provide the mechanisms for stakeholders to contribute, join, and vote on new proposals. More information coming soon. diff --git a/website/docs/developers.mdx b/website/docs-1/developers.mdx similarity index 88% rename from website/docs/developers.mdx rename to website/docs-1/developers.mdx index db15d1c..78a4f2b 100644 --- a/website/docs/developers.mdx +++ b/website/docs-1/developers.mdx @@ -8,6 +8,15 @@ import MarkdownImage from "/src/components/MarkdownImage"; import { Box, Typography, Grid } from "@mui/material"; import Link from "@docusaurus/Link"; import { VscGithubInverted } from "react-icons/vsc"; +import { FiType } from "react-icons/fi"; +import { SiTypescript } from "react-icons/si"; +import { SiJavascript } from "react-icons/si"; +import { SiPython } from "react-icons/si"; +import { SiRust } from "react-icons/si"; +import { SiPowershell } from "react-icons/si"; +import { VscJson } from "react-icons/vsc"; +import { GoLinkExternal } from "react-icons/go"; +import { SerumIcon } from "/src/components/icons/SerumIcon"; # Developer Resources diff --git a/website/docs/feeds/_category_.json b/website/docs-1/feeds/_category_.json similarity index 100% rename from website/docs/feeds/_category_.json rename to website/docs-1/feeds/_category_.json diff --git a/website/docs/feeds/job-directory.mdx b/website/docs-1/feeds/job-directory.mdx similarity index 99% rename from website/docs/feeds/job-directory.mdx rename to website/docs-1/feeds/job-directory.mdx index 72d6569..4036983 100644 --- a/website/docs/feeds/job-directory.mdx +++ b/website/docs-1/feeds/job-directory.mdx @@ -1,6 +1,6 @@ --- sidebar_position: 20 -slug: /job-directory +slug: /feed/directory --- # Job Directory diff --git a/website/docs/feeds/publisher/_category_.json b/website/docs-1/feeds/publisher/_category_.json similarity index 100% rename from website/docs/feeds/publisher/_category_.json rename to website/docs-1/feeds/publisher/_category_.json diff --git a/website/docs/feeds/publisher/custom-feeds.mdx b/website/docs-1/feeds/publisher/custom-feeds.mdx similarity index 97% rename from website/docs/feeds/publisher/custom-feeds.mdx rename to website/docs-1/feeds/publisher/custom-feeds.mdx index ec8f47d..0e089cc 100644 --- a/website/docs/feeds/publisher/custom-feeds.mdx +++ b/website/docs-1/feeds/publisher/custom-feeds.mdx @@ -68,7 +68,7 @@ import Link from "@docusaurus/Link"; /api/tasks
  • - Job Directory + Job Directory
  • diff --git a/website/docs/feeds/publisher/overview.mdx b/website/docs-1/feeds/publisher/overview.mdx similarity index 100% rename from website/docs/feeds/publisher/overview.mdx rename to website/docs-1/feeds/publisher/overview.mdx diff --git a/website/docs-1/oracle/_category_.json b/website/docs-1/oracle/_category_.json new file mode 100644 index 0000000..c7d3bd7 --- /dev/null +++ b/website/docs-1/oracle/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Oracles", + "position": 20 +} diff --git a/website/docs/oracle/docker.mdx b/website/docs-1/oracle/docker.mdx similarity index 94% rename from website/docs/oracle/docker.mdx rename to website/docs-1/oracle/docker.mdx index 9837132..a812172 100644 --- a/website/docs/oracle/docker.mdx +++ b/website/docs-1/oracle/docker.mdx @@ -24,7 +24,7 @@ import TabItem from "@theme/TabItem"; version: "3.3" services: switchboard: - image: "switchboardlabs/node:dev-v2" + image: "switchboardlabs/node:dev-v2-5-3-22 network_mode: host restart: always environment: @@ -47,7 +47,7 @@ secrets: version: "3.3" services: switchboard: - image: "switchboardlabs/node:dev-v2" + image: "switchboardlabs/node:dev-v2-5-3-22 network_mode: host restart: always environment: diff --git a/website/docs/oracle/gcp/_category_.json b/website/docs-1/oracle/gcp/_category_.json similarity index 100% rename from website/docs/oracle/gcp/_category_.json rename to website/docs-1/oracle/gcp/_category_.json diff --git a/website/docs/oracle/gcp/automated.mdx b/website/docs-1/oracle/gcp/automated.mdx similarity index 100% rename from website/docs/oracle/gcp/automated.mdx rename to website/docs-1/oracle/gcp/automated.mdx diff --git a/website/docs/oracle/gcp/deploy.mdx b/website/docs-1/oracle/gcp/deploy.mdx similarity index 100% rename from website/docs/oracle/gcp/deploy.mdx rename to website/docs-1/oracle/gcp/deploy.mdx diff --git a/website/docs/oracle/gcp/environment.mdx b/website/docs-1/oracle/gcp/environment.mdx similarity index 100% rename from website/docs/oracle/gcp/environment.mdx rename to website/docs-1/oracle/gcp/environment.mdx diff --git a/website/docs/oracle/gcp/grafana.mdx b/website/docs-1/oracle/gcp/grafana.mdx similarity index 100% rename from website/docs/oracle/gcp/grafana.mdx rename to website/docs-1/oracle/gcp/grafana.mdx diff --git a/website/docs/oracle/gcp/manual.mdx b/website/docs-1/oracle/gcp/manual.mdx similarity index 100% rename from website/docs/oracle/gcp/manual.mdx rename to website/docs-1/oracle/gcp/manual.mdx diff --git a/website/docs/oracle/gcp/overview.mdx b/website/docs-1/oracle/gcp/overview.mdx similarity index 100% rename from website/docs/oracle/gcp/overview.mdx rename to website/docs-1/oracle/gcp/overview.mdx diff --git a/website/docs/oracle/introduction.mdx b/website/docs-1/oracle/introduction.mdx similarity index 100% rename from website/docs/oracle/introduction.mdx rename to website/docs-1/oracle/introduction.mdx diff --git a/website/docs/oracle/monitor.mdx b/website/docs-1/oracle/monitor.mdx similarity index 100% rename from website/docs/oracle/monitor.mdx rename to website/docs-1/oracle/monitor.mdx diff --git a/website/docs/oracle/oracle-account.mdx b/website/docs-1/oracle/oracle-account.mdx similarity index 96% rename from website/docs/oracle/oracle-account.mdx rename to website/docs-1/oracle/oracle-account.mdx index ec81ab5..cfd6177 100644 --- a/website/docs/oracle/oracle-account.mdx +++ b/website/docs-1/oracle/oracle-account.mdx @@ -10,7 +10,7 @@ import CodeBlock from "@theme/CodeBlock"; ## Create Oracle -With the [Switchboard V2 CLI](../developers/cli/) installed, run the following command, where +With the [Switchboard V2 CLI](../../api/cli/) installed, run the following command, where - `QUEUEKEY` is the oracle queue you will be joining. See [Program](../program) for a list of available queues. - `PAYERKEYPAIR` is the filesystem path to your wallet that will pay for the new account. Keypair will default to the oracle authority if authority flag is not provided. diff --git a/website/docs/private-queues.mdx b/website/docs-1/private-queues.mdx similarity index 99% rename from website/docs/private-queues.mdx rename to website/docs-1/private-queues.mdx index fe272e8..13afb9b 100644 --- a/website/docs/private-queues.mdx +++ b/website/docs-1/private-queues.mdx @@ -60,7 +60,7 @@ Create a docker-compose file, replacing `ORACLE_KEY`, `RPC_URL`, and `PAYER_KEYP version: "3.3" services: oracle: - image: "switchboardlabs/node:dev-v2-3-7-22" + image: "switchboardlabs/node:dev-v2-5-3-22" network_mode: host restart: always secrets: diff --git a/website/docs-1/program.mdx b/website/docs-1/program.mdx new file mode 100644 index 0000000..447d08a --- /dev/null +++ b/website/docs-1/program.mdx @@ -0,0 +1,141 @@ +--- +sidebar_position: 5 +slug: /program +title: Program +--- + +import PublicKeyButton from "/src/components/PublicKeyButton"; +import MarkdownImage from "/src/components/MarkdownImage"; +import { Box, Typography, Grid } from "@mui/material"; +import ProgramStateAccountData from "/idl/accounts/SbState.md"; +import Link from "@docusaurus/Link"; + +## Program State + + + +
    + + The program state account governs the Switchboard V2 program and controls the + token mint used throughout for oracle rewards, aggregator leases, and + other incentives. + +
    + + The Switchboard V2 program can support many oracle queue's, each acting as + independent networks with their own oracles, configuration, and security + model. + +
    + +### 📦SbState + + + +     + + + +     + +## Mainnet-Beta + +Below is a list of public keys used in the Switchboard V2 mainnet deployment. + + + + + + + + + + + + + + + + + + + + + + +
    AccountPublic Key
    + Program ID + + +
    + Permissionless Queue + + Queue +
    + +
    + Crank +
    + +
    + Permissioned Queue + + Queue +
    + +
    + Crank +
    + +
    + +## Devnet + +Below is a list of public keys used in the Switchboard V2 devnet deployment. + + + + + + + + + + + + + + + + + + + + + + +
    AccountPublic Key
    + Program ID + + +
    + Permissionless Queue + + Queue +
    + +
    + Crank +
    + +
    + Permissioned Queue + + Queue +
    + +
    + Crank +
    + +
    diff --git a/website/docs/randomness.mdx b/website/docs-1/randomness.mdx similarity index 100% rename from website/docs/randomness.mdx rename to website/docs-1/randomness.mdx diff --git a/website/docs/buffer-relayer/_category_.json b/website/docs/buffer-relayer/_category_.json new file mode 100644 index 0000000..b83b1b0 --- /dev/null +++ b/website/docs/buffer-relayer/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Buffer Relayers", + "position": 50, + "collapsible": true +} diff --git a/website/docs/buffer-relayer/architecture.mdx b/website/docs/buffer-relayer/architecture.mdx new file mode 100644 index 0000000..a103c14 --- /dev/null +++ b/website/docs/buffer-relayer/architecture.mdx @@ -0,0 +1,30 @@ +--- +sidebar_position: 1 +slug: . +title: Architecture +--- + +# Buffer Relayer Architecture + +TODO + + diff --git a/website/docs/dao.mdx b/website/docs/dao.mdx index f367212..20256c6 100644 --- a/website/docs/dao.mdx +++ b/website/docs/dao.mdx @@ -1,9 +1,116 @@ --- sidebar_position: 80 -slug: /dao title: Switchboard DAO --- # Switchboard DAO -The Switchboard DAO will operate a set of oracle queues and provide the mechanisms for stakeholders to contribute, join, and vote on new proposals. More information coming soon. +The Switchboard DAO operates a set of oracle queues and provide the mechanisms for stakeholders to contribute, join, and vote on new proposals. More information coming soon. + +import PublicKeyButton from "/src/components/PublicKeyButton"; +import MarkdownImage from "/src/components/MarkdownImage"; +import { Box, Typography, Grid } from "@mui/material"; +import ProgramStateAccountData from "/idl/accounts/SbState.md"; +import Link from "@docusaurus/Link"; + +## Mainnet-Beta + +Below is a list of public keys used in the Switchboard V2 mainnet deployment. + + + + + + + + + + + + + + + + + + + + + + +
    AccountPublic Key
    + Program ID + + +
    + Permissionless Queue + + Queue +
    + +
    + Crank +
    + +
    + Permissioned Queue + + Queue +
    + +
    + Crank +
    + +
    + +## Devnet + +Below is a list of public keys used in the Switchboard V2 devnet deployment. + + + + + + + + + + + + + + + + + + + + + + +
    AccountPublic Key
    + Program ID + + +
    + Permissionless Queue + + Queue +
    + +
    + Crank +
    + +
    + Permissioned Queue + + Queue +
    + +
    + Crank +
    + +
    diff --git a/website/docs/developers/_category_.json b/website/docs/developers/_category_.json new file mode 100644 index 0000000..3cbbc5f --- /dev/null +++ b/website/docs/developers/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Developers", + "position": 60, + "collapsible": true +} diff --git a/website/docs/developers/_example_table.mdx b/website/docs/developers/_example_table.mdx new file mode 100644 index 0000000..669899a --- /dev/null +++ b/website/docs/developers/_example_table.mdx @@ -0,0 +1,25 @@ +import MarkdownImage from "/src/components/MarkdownImage"; +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; +import { VscGithubInverted } from "react-icons/vsc"; +import { FiType } from "react-icons/fi"; +import { SiTypescript } from "react-icons/si"; +import { SiJavascript } from "react-icons/si"; +import { SiPython } from "react-icons/si"; +import { SiRust } from "react-icons/si"; +import { SiPowershell } from "react-icons/si"; +import { VscJson } from "react-icons/vsc"; +import { GoLinkExternal } from "react-icons/go"; +import { SerumIcon } from "/src/components/icons/SerumIcon"; + + + Example repos showing how to integrate Switchboard V2 into your on-chain + programs or off-chain applications + + +| Example | Description | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | +| anchor-feed-parser | Anchor example program demonstrating how to deserialize and read an onchain aggregator. | +| anchor-vrf-parser | Anchor example program demonstrating how to deserialize and read an onchain verifiable randomness function (VRF) account. | +| feed-parser | Typescript example demonstrating how to read an aggregator account. | +| feed-walkthrough | Typescript example demonstrating how to create and manage your own oracle queue. | diff --git a/website/docs/developers/_idl.mdx b/website/docs/developers/_idl.mdx new file mode 100644 index 0000000..14fbf9d --- /dev/null +++ b/website/docs/developers/_idl.mdx @@ -0,0 +1,18 @@ +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; + + + + Switchboard's Anchor IDL contains a detailed description of the program + interfaces and schemas + + + + + + ⚓ Anchor IDL ⚓ + + + + +
    \ No newline at end of file diff --git a/website/docs/developers/_library_table.mdx b/website/docs/developers/_library_table.mdx new file mode 100644 index 0000000..b122c7c --- /dev/null +++ b/website/docs/developers/_library_table.mdx @@ -0,0 +1,27 @@ +import MarkdownImage from "/src/components/MarkdownImage"; +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; +import { VscGithubInverted } from "react-icons/vsc"; +import { FiType } from "react-icons/fi"; +import { SiTypescript } from "react-icons/si"; +import { SiJavascript } from "react-icons/si"; +import { SiPython } from "react-icons/si"; +import { SiRust } from "react-icons/si"; +import { SiPowershell } from "react-icons/si"; +import { VscJson } from "react-icons/vsc"; +import { GoLinkExternal } from "react-icons/go"; +import { SerumIcon } from "/src/components/icons/SerumIcon"; + + + Switchboard's libraries provide a client interface to interact with + Switchboard V2 on-chain + + +| Library | Description | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | +| switchboard-tasks | Protobuf definitions for the various supported task definitions to build job definitions from. | +| switchboardv2-cli | A Command Line Interface (CLI) to interact with the Switchboardv2 program. | +| switchboardv2-api | A typescript library of utility functions to interact with the Switchboardv2 program. | +| sbv2-lite | A typescript "Lite" client to deserialize aggregator accounts. | +| switchboardpy | A python library of utility functions to interact with the Switchboardv2 program. | +| switchboard-v2 | A rust library of utility functions to interact with the Switchboardv2 program on-chain. | diff --git a/website/docs/developers/_sdk.mdx b/website/docs/developers/_sdk.mdx new file mode 100644 index 0000000..7e51b89 --- /dev/null +++ b/website/docs/developers/_sdk.mdx @@ -0,0 +1,22 @@ +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; +import { VscGithubInverted } from "react-icons/vsc"; + + + The Switchboard-V2 repository contains all of the libraries, examples, and + documentation to help you get started integrating Switchboard + + +
    + + + + + +  @switchboard-xyz/switchboard-v2  + + + + + +
    diff --git a/website/docs/developers/buffer-relayer.mdx b/website/docs/developers/buffer-relayer.mdx new file mode 100644 index 0000000..522dbf5 --- /dev/null +++ b/website/docs/developers/buffer-relayer.mdx @@ -0,0 +1,96 @@ +--- +sidebar_position: 50 +title: Buffer Relayers +--- + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + +## Read a Buffer Relayer + + + + +```rust +// Rust code +``` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Create a Buffer Relayer + +- `bufferRelayerInit` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Request a Buffer Relayer Update + +- `bufferRelayerOpenRound` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + diff --git a/website/docs/developers/feed.mdx b/website/docs/developers/feed.mdx new file mode 100644 index 0000000..9605e08 --- /dev/null +++ b/website/docs/developers/feed.mdx @@ -0,0 +1,192 @@ +--- +sidebar_position: 30 +title: Data Feeds +--- + +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + + + + # anchor-feed-parser + + + +## Reading a Data Feed + + + + +```rust +// Rust code +``` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Creating a Data Feed + +- `aggregatorInit` +- `leaseInit` +- `jobInit` +- `permissionInit` +- `aggregatorAddJob` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Funding a Data Feed + +- `leeaseExtend` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Requesting a Feed Update + +- `openRound` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Push to Crank + +- `crankPush` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Add History Buffer + +- `aggregatorSetHistoryBuffer` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + diff --git a/website/docs/developers/localnet.mdx b/website/docs/developers/localnet.mdx new file mode 100644 index 0000000..ef25a6d --- /dev/null +++ b/website/docs/developers/localnet.mdx @@ -0,0 +1,149 @@ +--- +sidebar_position: 5 +title: Localnet Integration +--- + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + +You may wish to run a localnet version of Switchboard to watch how your program reacts to data feed updates. The following will walk through how to create your own Oracle Queue and Oracle and output some helper scripts to quickly load the environment in your tests. + +## Setup Switchboard Test Environment + +The following will create an Oracle Queue and Oracle with the provided keypair as the authority + + + + +```shell +sbv2 localnet:env \ + --keypair "../payer-keypair.json" \ + --outputDir ".switchboard" +``` + + + + +```typescript +import { SwitchboardTestEnvironment } from "@switchboard-xyz/sbv2-utils"; + +const testEnvironment = await SwitchboardTestEnvironment.create( + "../payer-keypair.json" +); +testEnvironment.writeAll(".switchboard"); +``` + + + + +In the specified `outputDir`, you will find: + +- **start-local-validator.sh**: Bash script which starts a local Solana validator with the Switchboard program, IDL, and our devnet environment pre-loaded +- **start-oracle.sh**: Bash script which starts a Switchboard oracle and start heartbeating on the localnet queue +- **docker-compose.switchboard.yml**: docker file with the Switchboard oracle environment +- **switchboard.env**: Env file with your Switchboard account public keys +- **switchboard.json**: JSON file with your Switchboard account public keys + +## Switchboard Test Context + +In your tests, you will need to load the `switchboard.env` file to build the SwitchboardTestContext. + +### Starting Test + +Before you run your test you will need a localnet Solana validator running with the Switchboard-V2 program loaded and your Switchboard oracle running and heartbeating. + +**_In Shell #1_** + +```bash +./.switchboard/start-local-validator.sh +``` + +**_In Shell #2_** + +```bash +./.switchboard/start-oracle.sh +``` + +**_In Shell #3_** + +```bash +anchor test --skip-local-validator +``` + +### loadFromEnv + +`SwitchboardTestContext.loadFromEnv` will look for `switchboard.env` or a `.switchboard` directory in the current directory or three levels up before throwing an error. + + + + +```typescript +import * as anchor from "@project-serum/anchor"; +import { SwitchboardTestContext } from "@switchboard-xyz/sbv2-utils"; +import chai from "chai"; +import "mocha"; + +describe("switchboard integration test", async () => { + const provider = anchor.AnchorProvider.env(); + anchor.setProvider(provider); + + let switchboard: SwitchboardTestContext; + + before(async () => { + // Optional, attempt to load the switchboard devnet PID + // If successful, then we can assume we're on devnet and can use the public permissionless queue + try { + switchboard = await SwitchboardTestContext.loadDevnetQueue(provider); + console.log("devnet detected"); + return; + } catch (error: any) { + console.log("Error: SBV2 Devnet - ", error.message); + } + + // Attempt to load switchboard.env or .switchboard directory + // Will look 3 levels up before failing + try { + switchboard = await SwitchboardTestContext.loadFromEnv(provider); + console.log("localnet detected"); + return; + } catch (error: any) { + console.log("Error: SBV2 Localnet - ", error.message); + } + + // If fails, throw error + throw new Error( + "Failed to load the SwitchboardTestContext from devnet or from a switchboard.env file" + ); + }); + + it("Your test here", async () => {}); +}); +``` + + + + +### createStaticFeed + + + + +```typescript +import * as anchor from "@project-serum/anchor"; +import { SwitchboardTestContext } from "@switchboard-xyz/sbv2-utils"; +import { AggregatorAccount } from "@switchboard-xyz/switchboard-v2"; + +// load the Switchboard env to dictate which queue to create feed for +const switchboard = await SwitchboardTestContext.loadFromEnv( + anchor.AnchorProvider.env() +); + +// create a static feed that will always resolve to 100 +// then call openRound and wait for the oracle to process the update +const aggregatorAccount: AggregatorAccount = await switchboard.createStaticFeed( + 100 +); +``` + + + diff --git a/website/docs/developers/oracle.mdx b/website/docs/developers/oracle.mdx new file mode 100644 index 0000000..2043977 --- /dev/null +++ b/website/docs/developers/oracle.mdx @@ -0,0 +1,147 @@ +--- +sidebar_position: 20 +title: Oracles +--- + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + +## Create + +- `oracleInit` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Oracle Deposit + +- `tokenTransfer` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Oracle Heartbeat + +- `oracleHeartbeat` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Save Result + +- `aggregatorSaveResult` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Oracle Withdraw + +- `oracleWithdraw` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + diff --git a/website/docs/developers/queue.mdx b/website/docs/developers/queue.mdx new file mode 100644 index 0000000..a868974 --- /dev/null +++ b/website/docs/developers/queue.mdx @@ -0,0 +1,102 @@ +--- +sidebar_position: 10 +title: Oracle Queue +--- + + + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + +## Create an Oracle Queue + +- `oracleQueueInit` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Assign Queue Permissions + +- `permissionSet` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Create a Crank + +- `crankInit` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + diff --git a/website/docs/developers/randomness.mdx b/website/docs/developers/randomness.mdx new file mode 100644 index 0000000..5a4d9b5 --- /dev/null +++ b/website/docs/developers/randomness.mdx @@ -0,0 +1,106 @@ +--- +sidebar_position: 40 +title: Randomness +--- + +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + + + + # anchor-vrf-parser + + + +## Reading a VRF Account + + + + +```rust +// Rust code +``` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Define Callback + +## Creating a VRF Account + +- `vrfInit` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + + +## Request Randomness + +- `vrfRequestRandomness` + + + + +```ts +// Typescript code +``` + + + + +```python +# Python code +``` + + + + +```bash +# CLI command +``` + + + diff --git a/website/docs/developers/resources.mdx b/website/docs/developers/resources.mdx new file mode 100644 index 0000000..062df1b --- /dev/null +++ b/website/docs/developers/resources.mdx @@ -0,0 +1,43 @@ +--- +sidebar_position: 1 +slug: . +title: Developer Resources +--- + +import LibraryTable from "./_library_table.mdx"; +import SDK from "./_sdk.mdx"; +import IDL from "./_idl.mdx"; +import ExampleTable from "./_example_table.mdx"; +import MarkdownImage from "/src/components/MarkdownImage"; + +# Developer Resources + + +
    + +## SDK + + + +## Anchor IDL + + + +## Getting Help + +- [Discord](http://discord.switchboard.xyz/) +- [Telegram](https://t.me/switchboardxyz) +- [Twitter @switchboard-xyz](https://twitter.com/switchboardxyz) + +
    + +## Libraries + + + +## Examples + + diff --git a/website/docs/feed/_category_.json b/website/docs/feed/_category_.json new file mode 100644 index 0000000..483c75b --- /dev/null +++ b/website/docs/feed/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Data Feeds", + "position": 30, + "collapsible": true +} diff --git a/website/docs/feed/architecture.mdx b/website/docs/feed/architecture.mdx new file mode 100644 index 0000000..1b39690 --- /dev/null +++ b/website/docs/feed/architecture.mdx @@ -0,0 +1,202 @@ +--- +sidebar_position: 1 +slug: . +title: Architecture +--- + +# Data Feed Architecture + +import MarkdownImage from "/src/components/MarkdownImage"; +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; + +An aggregator or data feed is what on-chain developers use when building smart contracts. A data feed is a collection of jobs that get aggregated to produce a single, deterministic result. Typically the first task in a job will fetch external data with subsequent tasks responsible for parsing the response and transforming the value into a single data type, like an integer or decimal. + +When an oracle is assigned to process a data feed update, the oracle executes the defined jobs, computes the weighted median of the job responses, and publishes the result on-chain. If sufficient oracles respond, the on-chain program computes the final result as the median of the assigned oracle responses. + +Data feeds published on Solana are public and there is no mechanism to prevent other users from reading and consuming the data. Because of this, Switchboard, by default, treats feeds as public utilities allowing anyone to contribute. This is by design as data feeds should be community controlled. If a program is relying on an oracle and the lease expires, any user is allowed to extend the lease, push on a crank, and keep the feed updating, but only if the feed config allows it. Switchboard envisions data feeds being community governed by the protocols supporting them. As a feed grows in popularity and is used across protocols, the feed maintenance cost can be spread across the protocols to reduce the economic burden on a single entity. + +## Configuration + + + +
      +
    • + Aggregator: Contains the data feed configuration, dictating how + data feed updates get requested, updated, and resolved on-chain. +
      • +
    • + Job Account: Stores the blueprints for how data is fetched + off-chain for a particular data source. +
      • +
    • + Permission Account: Permits a data feed to join an oracle queue. +
      • +
    • + Lease Contract: Pre-funded escrow contract to reward oracles for + their work. +
      • +
    • + Crank: Optional, owned by the queue and allows a data feed to be + updated at a regular interval. +
      • +
    • + History Buffer: Optional, allows a feed to store the last N + values. +
      • +
    +     + + + +     + +
    + +:::tip + +See [/idl/accounts/AggregatorAccountData](/idl/accounts/AggregatorAccountData) for the full list of an AggregatorAccount's configuration parameters. + +::: + +## Job Definitions + +An Aggregator Account stores a collection of Job Account public keys along with the hashes of the job definitions. This is to prevent malicious RPC nodes from providing incorrect task definitions to oracles before fulfillment. + +A Job Account is a collection of [Switchboard Tasks](/api/tasks) that get executed by an oracle sequentially. Each Job Account typically corresponds to a single data source. A data feed requires at least one job account and at most 16 job accounts. Switchboard Job Accounts can be used to source data from: + +- HTTP endpoints, public or private$^{[1]}$ +- Websockets +- On-Chain data from Solana, Ethereum, etc + - Anchor programs + - JupiterSwap + - Uniswap + - SushiSwap + - Saber + - ... and more + +$^{[1]}$ Endpoints requiring an API key require a [Private Queue](../queue/private-queues.mdx) to prevent leaking the API key on-chain + +### Job Weights + +A data feed can assign job weights to a job account which will be used when the oracle calculates the median across the job responses. This is useful to weight data sources by some metric such as liquidity or a reliability score. + +It is **strongly** recommended to utilize job weights as _not all data sources are created equally_. + +:::info + +Currently the only way to set a job weight is to remove and re-add the job account to a feed. + +::: + +### Lease Contract + +The LeaseContract is a pre-funded escrow account to reward oracles for fulfilling update request. The LeaseContract has a pre-specified `lease.withdrawAuthority` which is the only wallet allowed to withdraw funds from the lease escrow. Any user is able to contribute to a LeaseContract and keep the feed updating. + +When a new openRound is successfully requested for a data feed, the user who requested it is transferred `queue.reward` tokens from the feeds LeaseContract. This is to incentivize users and crank turners to keep feeds updating based on a feeds config. + +When a data feed result is accepted on-chain by a batch of oracles, the oracle rewards, as specified by `queue.reward`, are automatically deducted from the `lease.escrow` and transferred to an `oracle.tokenAccount`. + +## Requesting Updates + +A feed is updated when someone calls `aggregatorOpenRound` on-chain. If openRound is called before `aggregator.minUpdateDelaySeconds` have elapsed, the openRound call will fail and the user will forfeit their transaction fees. If successful, the user is rewarded for keeping the feed updating. + +### Periodic Updates + +Any data feed permitted to request updates on a queue is also permitted to join a queue's existing Crank, `aggregator.crankPubkey`. A Crank is the scheduling mechanism behind feeds that allow them to be periodically updated. The Crank is a buffer account that stores a collection of aggregator public keys, ordered by their next available update, with some level of jitter added to prevent a predictable oracle allocation cycle + +When a feeds Lease Contract is low on funds, it is automatically removed from the crank and must be manually repushed upon refunding the LeaseContract. + +A feed can set `aggregator.disableCrank` to prevent being pushed onto a Crank and draining it's lease. + +## Data Feed Cost + +Each data feed update cost can be calculated by the following equation: + +$Cost_{perUpdate}=(1 + numSuccess) × queue.reward$ + +where, + +- _`+1`_ is to reward the update requester for keeping the feed updating +- `numSuccess` is the number of successful oracle responses, which will always be between `[aggregator.minOracleResults, aggregator.oracleRequestBatchSize]` +- `queue.reward` is the queue's set oracle reward + +If an update round fails to receive `minOracleResults`, only the update requester receives funds from the lease escrow. + +### Variance Threshold + +A feed can set an `aggregator.varianceThreshold` to instruct an oracle to skip reporting a value on-chain if the percentage change between the current result and the `aggregator.previousConfirmedRoundResult` is not exceeded. This is a cost saving tool to conserve lease cost during low volatility. + +A feeds `aggregator.forceReportPeriod` is the compliment and instructs an oracle to always report a result if `aggregator.forceReportPeriod` seconds have elapsed since the last successful confirmed round. This can be thought of as the maximum allowable staleness for a feed. + +The two settings above can greatly increase the lifespan of a feed's lease but also makes it difficult to estimate the remaining time on a lease. + +Check out [@switchboard-xyz/lease-observer](https://github.com/switchboard-xyz/switchboard-v2/tree/main/packages/lease-observer) to get PagerDuty alerts when a lease crosses a low balance threshold. + +## History Buffer + +A history buffer account stores a set number of accepted results for an aggregator, and given Solana’s maximum account size of 10MB, the maximum number of samples a single history buffer can support is ~350,000 samples. An aggregator can only have a single history buffer associated with it. + +A history buffer has a static account size when it is initialized, equal to: `12 Bytes + (28 Bytes × Num Samples)`. Each time an aggregator value is updated on-chain, the associated history buffer is shifted to the right, and the last value is dropped. + +This feature allows Switchboard tasks to parse a history buffer and perform a set of calculations, such as the TwapTask. This allows feeds to reference other feeds and perform complex calculations based on historical samples. + +## Update Lifecycle + +Let's walk through what the feed update lifecycle looks like. + +### Update Request + +- Any user calls [aggregatorOpenRound](/idl/instructions/aggregatorOpenRound), either manually or via a crank turn +- sbv2 program checks if `aggregator.minUpdateDelaySeconds` have passed since the last openRound call +- sbv2 program checks if a LeaseContract has enough funds to reward the oracles for the next round +- sbv2 program assigns the next `aggregator.oracleRequestBatchSize` oracles to the update request and emits an [AggregatorOpenRoundEvent](/idl/events/AggregatorOpenRoundEvent) + +### Oracle Execution + +- Oracle watches the chain for an [AggregatorOpenRoundEvent](/idl/events/AggregatorOpenRoundEvent) with the oracle's public key assigned to the update +- Oracle fetches the feed and job account definitions from its RPC Provider +- Oracle verifies the job account definitions match the feeds `aggregator.jobHashes` +- Oracle executes the job definitions in parallel +- When an oracle receives `aggregator.minJobResults`, it calculates the weighted median based on the feeds `aggregator.jobWeights`. Note, this is not enforced on-chain and is purely up to the oracle to respect +- If a feed has configured a `aggregator.varianceThreshold` and `aggregator.forceReportPeriod` has not elapsed, the oracle calculates the percentage change between its calculated result and the previous confirmed round. If it does not exceed the feeds `aggregator.varianceThreshold`, the oracle drops the update request and waits for new update request +- If a feeds configuration dictate a new on-chain result, the oracle submits an [aggregatorSaveResult](https://docs.switchboard.xyz/idl/instructions/aggregatorSaveResult) transaction + +### Oracle Consensus + +- sbv2 program waits for `aggregator.minOracleResults` to be submitted by the assigned oracles +- When sufficient oracle responses, the sbv2 program computes the accepted value from the median of the oracle responses +- If a feed has a history buffer account, the accepted result is pushed onto the buffer +- Oracles that responded within `queue.varianceToleranceMultiplier` are rewarded `queue.reward` from the feed's LeaseContract +- If `queue.slashingEnabled`, oracles that responded outside the `queue.varianceToleranceMultiplier` are slashed `queue.reward` tokens from it's `oracle.tokenAccount` and transferred to the feed's `lease.escrow` +- If additional oracle responses are submitted after a value has been accepted, the median is recalculated based on the new response set, oracle rewards are redistributed, and the history buffer value is updated + +## Data Feed Composability + +Data feeds may reference other data feeds and build upon each other. It is **_strongly_** recommended that you own any feed that you reference in case of downstream impacts out of your control. While anyone can extend another feeds lease, a lease owner can always withdraw any lease funds and prevent future updates. + +As an example, you could construct the following feed definition: + +- Create a Switchboard feed that sources SOL/USD prices from a variety of exchanges, each weighted by their 7d volume, along with a history buffer +- Create a Switchboard feed that uses an OracleTask to fetch the Pyth SOL/USD price every 10 seconds, along with a history buffer +- Create a Switchboard feed that uses an OracleTask to fetch the Chainlink SOL/USD price every 10 seconds, along with a history buffer +- Finally, create a Switchboard feed that calculates the 1min TWAP of each source above and returns the median of the results + +This is just a small window into how Switchboard feeds can build on each other and let the downstream consumer configure their feeds to meet their own use cases. + +## More Information + +- [/api/tasks](/api/tasks) +- [/idl/accounts/AggregatorAccountData](/idl/accounts/AggregatorAccountData) +- [/idl/accounts/CrankAccountData](/idl/accounts/CrankAccountData) +- [/idl/accounts/AggregatorHistoryBuffer](/idl/accounts/AggregatorHistoryBuffer) +- [/idl/accounts/PermissionAccountData](/idl/accounts/PermissionAccountData) +- [/idl/accounts/JobAccountData](/idl/accounts/JobAccountData) +- [/idl/accounts/LeaseAccountData](/idl/accounts/LeaseAccountData) +- [feed-parser Typescript Example](https://github.com/switchboard-xyz/switchboard-v2/tree/main/packages/feed-parser) +- [feed-walkthrough Typescript Example](https://github.com/switchboard-xyz/switchboard-v2/tree/main/packages/feed-walkthrough) diff --git a/website/docs/feed/directory.mdx b/website/docs/feed/directory.mdx new file mode 100644 index 0000000..ac64bb3 --- /dev/null +++ b/website/docs/feed/directory.mdx @@ -0,0 +1,1231 @@ +--- +sidebar_position: 30 +title: Directory +--- + +This page includes some example jobs for building a data feed. You can view the expected JSON schema at **[/api/tasks](/api/tasks)**. + +Live on-chain examples can be found on our **[explorer](https://switchboard.xyz/explorer)**. + +import { IoPricetags } from "react-icons/io5"; +import { SerumIcon } from "/src/components/icons/SerumIcon"; +import { MangoIcon } from "/src/components/icons/MangoIcon"; +import { JupiterIcon } from "/src/components/icons/JupiterIcon"; +import { OrcaIcon } from "/src/components/icons/OrcaIcon"; +import { BiCylinder } from "react-icons/bi"; +import { MdOutlineSportsBasketball } from "react-icons/md"; +import { SiJpeg } from "react-icons/si"; +import { MdOutlineAccessTimeFilled } from "react-icons/md"; +import { FcMultipleInputs } from "react-icons/fc"; +import { GiPiggyBank } from "react-icons/gi"; +import { GiGrainBundle } from "react-icons/gi"; + +## Exchange APIs + +Switchboard oracles can fetch the price of assets listed on various exchanges by using a combination of the httpTask, websocketTask, and the jsonParseTask. If the data is on a public API, Switchboard oracles can return it. + +
    + + +### FtxUs + + + +```json title="FtxUs_BTC_USD.json" +{ + "name": "FtxUs BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://ftx.us/api/markets/btc/usd" + } + }, + { + "jsonParseTask": { + "path": "$.result.price" + } + } + ] +} +``` + +
    + +
    + + +### FtxCom + + + +```json title="FtxCom_BTC_USD.json" +{ + "name": "FtxCom BTC/USD", + "tasks": [ + { + "websocketTask": { + "url": "wss://ftx.com/ws/", + "subscription": "{\"op\":\"subscribe\",\"channel\":\"ticker\",\"market\":\"BTC/USD\"}", + "maxDataAgeSeconds": 15, + "filter": "$[?(@.type == 'update' && @.channel == 'ticker' && @.market == 'BTC/USD')]" + } + }, + { + "medianTask": { + "tasks": [ + { + "jsonParseTask": { + "path": "$.data.bid" + } + }, + { + "jsonParseTask": { + "path": "$.data.ask" + } + }, + { + "jsonParseTask": { + "path": "$.data.last" + } + } + ] + } + } + ] +} +``` + +
    + +
    + + +### Coinbase + + + +```json title="Coinbase_BTC_USD.json" +{ + "name": "Coinbase BTC/USD", + "tasks": [ + { + "websocketTask": { + "url": "wss://ws-feed.pro.coinbase.com", + "subscription": "{\"type\":\"subscribe\",\"product_ids\":[\"BTC-USD\"],\"channels\":[\"ticker\",{\"name\":\"ticker\",\"product_ids\":[\"BTC-USD\"]}]}", + "maxDataAgeSeconds": 15, + "filter": "$[?(@.type == 'ticker' && @.product_id == 'BTC-USD')]" + } + }, + { + "jsonParseTask": { + "path": "$.price" + } + } + ] +} +``` + +
    + +
    + + +### BinanceUs + + + +```json title="BinanceUs_BTC_USD.json" +{ + "name": "BinanceUs BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://www.binance.us/api/v3/ticker/price?symbol=BTCUSD" + } + }, + { + "jsonParseTask": { + "path": "$.price" + } + } + ] +} +``` + +
    + +
    + + +### BinanceCom + + + +```json title="BinanceCom_BTC_USD.json" +{ + "name": "BinanceCom BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://www.binance.com/api/v3/ticker/price?symbol=BTCUSDT" + } + }, + { + "jsonParseTask": { + "path": "$.price" + } + }, + { + "multiplyTask": { + /* Mainnet USDT/USD Feed */ + "aggregatorPubkey": "5mp8kbkTYwWWCsKSte8rURjTuyinsqBpJ9xAQsewPDD" + } + } + ] +} +``` + +
    + +
    + + +### Bitfinex + + + +```json title="Bitfinex_BTC_USD.json" +{ + "name": "Bitfinex BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://api-pub.bitfinex.com/v2/tickers?symbols=tBTCUSD" + } + }, + { + "medianTask": { + "tasks": [ + { + "jsonParseTask": { + "path": "$[0][1]" + } + }, + { + "jsonParseTask": { + "path": "$[0][3]" + } + }, + { + "jsonParseTask": { + "path": "$[0][7]" + } + } + ] + } + } + ] +} +``` + +
    + +
    + + +### Bitstamp + + + +```json title="Bitstamp_BTC_USD.json" +{ + "name": "Bitstamp BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://www.bitstamp.net/api/v2/ticker/btcusd" + } + }, + { + "medianTask": { + "tasks": [ + { + "jsonParseTask": { + "path": "$.ask" + } + }, + { + "jsonParseTask": { + "path": "$.bid" + } + }, + { + "jsonParseTask": { + "path": "$.last" + } + } + ] + } + } + ] +} +``` + +
    + +
    + + +### Kraken + + + +```json title="Kraken_BTC_USD.json" +{ + "name": "Kraken BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://api.kraken.com/0/public/Ticker?pair=XXBTZUSD" + } + }, + { + "medianTask": { + "tasks": [ + { + "jsonParseTask": { + "path": "$.result.XXBTZUSD.a[0]" + } + }, + { + "jsonParseTask": { + "path": "$.result.XXBTZUSD.b[0]" + } + }, + { + "jsonParseTask": { + "path": "$.result.XXBTZUSD.c[0]" + } + } + ] + } + } + ] +} +``` + +
    + +
    + + +### Okex + + + +```json title="Okex_BTC_USD.json" +{ + "name": "Okex BTC/USD", + "tasks": [ + { + "websocketTask": { + "url": "wss://ws.okex.com:8443/ws/v5/public", + "subscription": "{\"op\":\"subscribe\",\"args\":[{\"channel\":\"tickers\",\"instId\":\"BTC-USDT\"}]}", + "maxDataAgeSeconds": 15, + "filter": "$[?(@.event != 'subscribe' && @.arg.channel == 'tickers' && @.arg.instId == 'BTC-USDT' && @.data[0].instType == 'SPOT' && @.data[0].instId == 'BTC-USDT')]" + } + }, + { + "medianTask": { + "tasks": [ + { + "jsonParseTask": { + "path": "$.data[0].bidPx" + } + }, + { + "jsonParseTask": { + "path": "$.data[0].askPx" + } + }, + { + "jsonParseTask": { + "path": "$.data[0].last" + } + } + ] + } + }, + { + "multiplyTask": { + /* Mainnet USDT/USD Feed */ + "aggregatorPubkey": "5mp8kbkTYwWWCsKSte8rURjTuyinsqBpJ9xAQsewPDD" + } + } + ] +} +``` + +
    + +
    + + +### Huobi + + + +```json title="Huobi_BTC_USD.json" +{ + "name": "Huobi BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://api.huobi.pro/market/detail/merged?symbol=btcusdt" + } + }, + { + "medianTask": { + "tasks": [ + { + "jsonParseTask": { + "path": "$.tick.bid[0]" + } + }, + { + "jsonParseTask": { + "path": "$.tick.ask[0]" + } + } + ] + } + }, + { + "multiplyTask": { + /* Mainnet USDT/USD Feed */ + "aggregatorPubkey": "5mp8kbkTYwWWCsKSte8rURjTuyinsqBpJ9xAQsewPDD" + } + } + ] +} +``` + +
    + +
    + + +### Mxc + + + +```json title="Mxc_BTC_USD.json" +{ + "name": "Mxc BTC/USD", + "tasks": [ + { + "httpTask": { + "url": "https://www.mxc.com/open/api/v2/market/ticker?symbol=BTC_USDT" + } + }, + { + "medianTask": { + "tasks": [ + { + "jsonParseTask": { + "path": "$.data[0].ask" + } + }, + { + "jsonParseTask": { + "path": "$.data[0].bid" + } + }, + { + "jsonParseTask": { + "path": "$.data[0].last" + } + } + ] + } + }, + { + "multiplyTask": { + /* Mainnet USDT/USD Feed */ + "aggregatorPubkey": "5mp8kbkTYwWWCsKSte8rURjTuyinsqBpJ9xAQsewPDD" + } + } + ] +} +``` + +
    + +## Serum + +Switchboard can fetch the price of any asset listed on Serum's decentralized exchange. The Serum task will fetch the lowest ask, highest bid, and last fill price and return the median. If no last fill price is found, the Serum task will return the average of the lowest ask and highest bid. + +
    + + +### BTC/USD Pool + + + +```json title="Serum_BTC_USD.json" +{ + "name": "Serum BTC/USD", + "tasks": [ + { + "serumSwapTask": { + /* Mainnet Serum BTC/USDC Pool */ + "serumPoolAddress": "A8YFbxQYFVqKZaoYJLLUVcQiWP7G2MeEgW5wsAQgMvFw" + } + } + ] +} +``` + +
    + +
    + + +### MNGO/USD Pool + + + +```json title="Serum_MNGO_USD.json" +{ + "name": "Serum MNGO/USD", + "tasks": [ + { + "serumSwapTask": { + /* Mainnet Serum MNGO/USDC Pool */ + "serumPoolAddress": "3d4rzwpy9iGdCZvgxcu7B1YocYffVLsQXPXkBZKt2zLc" + } + } + ] +} +``` + +
    + +## OracleTask + +Switchboard can fetch the current price of a Solana oracle protocol + +
    + + +### Switchboard SOL/USDC + + + +```json title="Serum_MNGO_USD.json" +{ + "name": "JupiterSwap JSOL to USDC", + "tasks": [ + { + "jupiterSwapTask": { + /* JSOL mint address */ + "inTokenAddress": "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn", + /* USDC mint address */ + "outTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" + } + } + ] +} +``` + +
    + +## JupiterSwap + +Switchboard can be used to fetch the best swap price using JupiterSwap. + +
    + + +### JSOL to USDC Swap + + + +```json title="Jupiter_JSOL_to_USDC.json" +{ + "name": "JupiterSwap JSOL to USDC", + "tasks": [ + { + "jupiterSwapTask": { + /* JSOL mint address */ + "inTokenAddress": "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn", + /* USDC mint address */ + "outTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" + } + } + ] +} +``` + +
    + +## OrcaSwap + +Switchboard can be used to fetch the best swap price using OrcaSwap. + +
    + + +### GMT to USD Swap + + + +```json title="Orca_GMT_USD.json" +{ + "name": "OrcaSwap GMT to USD", + "tasks": [ + { + "lpExchangeRateTask": { + "orcaPoolTokenMintAddress": "CFxQF5kNAtbbDj298Xr47Sf4mkSyuzWpRH97hrdQ6kxi" + } + }, + { + "multiplyTask": { + "aggregatorPubkey": "BjUgj6YCnFBZ49wF54ddBVA9qu8TeqkFtkbqmZcee8uW" + } + } + ] +} +``` + +
    + +## TWAP + +Aggregators can be initialized with a history buffer to store a buffer of accepted results. The TWAP task will parse the history buffer, filter the results within the specified period, and return the average. + +
    + + +### BTC/USD 15min TWAP + + + +```json title="BTC_USD_15m_TWAP.json" +{ + "name": "BTC/USD 15min TWAP", + "tasks": [ + { + "twapTask": { + /* Mainnet BTC/USD Feed */ + "aggregatorPubkey": "8SXvChNYFhRq4EZuZvnhjrB3jJRQCv4k3P4W6hesH3Ee", + "period": 900 + } + } + ] +} +``` + +
    + +
    + + +### SOL/USD 30min TWAP + + + +```json title="SOL_USD_30m_TWAP.json" +{ + "name": "SOL/USD 30min TWAP", + "tasks": [ + { + "twapTask": { + /* Mainnet SOL/USD Feed */ + "aggregatorPubkey": "GvDMxPzN1sCj7L26YDK2HnMRXEQmQ2aemov8YBtPS7vR", + "period": 1800 + } + } + ] +} +``` + +
    + +## Lending Rates + +Switchboard oracles can resolve the lending and borrow rates for the following Solana lending programs: + +- Jet +- Solend +- Mango +- 01 +- Apricot +- Larix +- Port +- Tulip + +Thanks to JetProtocol for their work building the [defi-yield-ts](https://github.com/jet-lab/defi-yield-ts) library. + +A `field` of 1 represents a borrow rate and a `field` of 0 represents a lending rate. + +
    + + +### Solend StSOL Borrow Rate + + + +```json title="Solend_StSol_Borrow_Rate.json" +{ + "name": "Solend stSOL Borrow Rate", + "tasks": [ + { + "lendingRateTask": { + "protocol": "solend", + "assetMint": "7dHbWXmci3dT8UFYWYZweBLXgycu7Y3iL6trKn1Y7ARj", + "field": 1 + } + } + ] +} +``` + +
    + +
    + + +### Jet BTC Lending Rate + + + +```json title="Jet_Btc_Lending_Rate.json" +{ + "name": "JET BTC Lend Rate", + "tasks": [ + { + "lendingRateTask": { + "protocol": "jet", + "assetMint": "9n4nbM75f5Ui33ZbPYXn59EwSgE8CGsHtAeTH5YFeJ9E", + "field": 0 + } + } + ] +} +``` + +
    + +## Mango Perps + +Switchboard oracles can be used to resolve the price on Mango's perpetual markets. You can find a list of market addresses in their [mango-client-v3](https://github.com/blockworks-foundation/mango-client-v3/blob/main/src/ids.json) repo. + +
    + + +### Mango BTC Perps + + + +```json title="Mango_Perps_Btc.json" +{ + "tasks": [ + { + "mangoPerpMarketTask": { + "perpMarketAddress": "DtEcjPLyD4YtTBB4q8xwFZ9q49W89xZCZtJyrGebi5t8" + } + } + ] +} +``` + +
    + +## LP Token Prices + +Switchboard oracles can fetch the price of LP tokens from Mercurial, Saber, Orca, and Raydium. If the `useFairPrice` flag is provided with a list of mainnet aggregators, the oracles will return the fair LP token price. See our [blog post](https://switchboardxyz.medium.com/fair-lp-token-oracles-94a457c50239) for more details on how this value is calculated. + +
    + + +### Mercurial USDC/USDT/wUST + + + +```json title="Mercurial_USDC_USDT_wUST.json" +{ + "name": "LP Mercurial USDC/USDT/wUST", + "tasks": [ + { + "lpTokenPriceTask": { + /* Mainnet Mercurial 3Pool wUST Pool Address */ + "mercurialPoolAddress": "USD6kaowtDjwRkN5gAjw1PDMQvc9xRp8xW9GK8Z5HBA" + } + } + ] +} +``` + +You have the option of using the fair LP token price by providing the `useFairPrice` flag and providing a list of aggregators to use for the pool member prices. + +```json title="FairPrice_Mercurial_USDC_USDT_wUST.json" +{ + "name": "Fair Price LP Mercurial USDC/USDT/wUST", + "tasks": [ + { + "lpTokenPriceTask": { + "useFairPrice": true, + /* Mainnet Mercurial 3Pool wUST Pool Address */ + "mercurialPoolAddress": "USD6kaowtDjwRkN5gAjw1PDMQvc9xRp8xW9GK8Z5HBA", + "priceFeedAddresses": [ + /* Mainnet USDC/USD Feed */ + "BjUgj6YCnFBZ49wF54ddBVA9qu8TeqkFtkbqmZcee8uW", + /* Mainnet USDT/USD Feed */ + "ETAaeeuQBwsh9mC2gCov9WdhJENZuffRMXY2HgjCcSL9", + /* Mainnet wUST/USD Feed */ + "3RfJxApwV2tYB5mArdD7aRbBk7P6BQCSSFQzR2GXUzA2" + ] + } + } + ] +} +``` + +
    + +
    + + +### Saber USDT/USDC + + + +```json title="Saber_LP_Token_USDT_USDC.json" +{ + "name": "Saber USDT/USDC", + "tasks": [ + { + "lpTokenPriceTask": { + /* Mainnet Saber USDT/USDC Pool Address */ + "saberPoolAddress": "YAkoNb6HKmSxQN9L8hiBE5tPJRsniSSMzND1boHmZxe", + "priceFeedAddresses": [ + /* Mainnet USDT/USD Feed */ + "ETAaeeuQBwsh9mC2gCov9WdhJENZuffRMXY2HgjCcSL9", + /* Mainnet USDC/USD Feed */ + "BjUgj6YCnFBZ49wF54ddBVA9qu8TeqkFtkbqmZcee8uW" + ] + } + } + ] +} +``` + +You have the option of using the fair LP token price by providing the `useFairPrice` flag and providing a list of aggregators to use for the pool member prices. + +```json title="FairPrice_Saber_LP_Token_USDT_USDC.json" +{ + "name": "Fair Price Saber USDT/USDC", + "tasks": [ + { + "lpTokenPriceTask": { + "useFairPrice": true, + /* Mainnet Saber USDT/USDC Pool Address */ + "saberPoolAddress": "YAkoNb6HKmSxQN9L8hiBE5tPJRsniSSMzND1boHmZxe", + "priceFeedAddresses": [ + /* Mainnet USDT/USD Feed */ + "ETAaeeuQBwsh9mC2gCov9WdhJENZuffRMXY2HgjCcSL9", + /* Mainnet USDC/USD Feed */ + "BjUgj6YCnFBZ49wF54ddBVA9qu8TeqkFtkbqmZcee8uW" + ] + } + } + ] +} +``` + +
    + +
    + + +### Orca USDT/USDC + + + +```json title="Orca_USDT_USDC_LP.json" +{ + "name": "Orca LP USDT/USDC", + "tasks": [ + { + "lpTokenPriceTask": { + /* Mainnet Orca USDT/USDC Pool Address */ + "orcaPoolAddress": "H2uzgruPvonVpCRhwwdukcpXK8TG17swFNzYFr2rtPxy", + "priceFeedAddresses": [ + /* Mainnet USDC/USD Feed */ + "BjUgj6YCnFBZ49wF54ddBVA9qu8TeqkFtkbqmZcee8uW", + /* Mainnet USDT/USD Feed */ + "ETAaeeuQBwsh9mC2gCov9WdhJENZuffRMXY2HgjCcSL9" + ] + } + } + ] +} +``` + +
    + +
    + + +### Raydium SOL/USDC + + + +```json title="Raydium_SOL_USDC_LP.json" +{ + "name": "Raydium SOL/USDC", + "tasks": [ + { + "lpTokenPriceTask": { + /* Mainnet Raydium SOL/USDC Pool Address */ + "raydiumPoolAddress": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2", + "priceFeedAddresses": [ + /* Mainnet SOL/USD Feed */ + "GvDMxPzN1sCj7L26YDK2HnMRXEQmQ2aemov8YBtPS7vR", + /* Mainnet USDC/USD Feed */ + "BjUgj6YCnFBZ49wF54ddBVA9qu8TeqkFtkbqmZcee8uW" + ] + } + } + ] +} +``` + +
    + +## Commodities + +
    + + +### Unleaded Fuel + + + +```json title="Average_Price_Unleaded_Fuel.json" +{ + "tasks": [ + { + "httpTask": { + "url": "https://gasprices.aaa.com/wp-admin/admin-ajax.php", + "method": 2, + "headers": [ + { + "key": "Content-Type", + "value": "application/x-www-form-urlencoded" + } + ], + "body": "action=states_cost_data&data%5BlocL%5D=US&data%5BlocR%5D=US" + } + }, + { + "jsonParseTask": { + "path": "$.data.unleaded.[0]" + } + } + ] +} +``` + +
    + +
    + + +### Gold + + + +```json title="Metals_live_Gold.json" +{ + "tasks": [ + { "httpTask": { "url": "https://api.metals.live/v1/spot/gold" } }, + { "jsonParseTask": { "path": "$[(@.length-1)].price" } } + ] +} +``` + +```json title="Asg_Gold.json" +{ + "tasks": [ + { "httpTask": { "url": "https://data-asg.goldprice.org/dbXRates/USD" } }, + { "jsonParseTask": { "path": "$.items[?(@.curr == \"USD\")].xauPrice" } } + ] +} +``` + +
    + +
    + + +### Silver + + + +```json title="Metals_live_Silver.json" +{ + "tasks": [ + { "httpTask": { "url": "https://api.metals.live/v1/spot/silver" } }, + { "jsonParseTask": { "path": "$[(@.length-1)].price" } } + ] +} +``` + +```json title="Asg_Silver.json" +{ + "tasks": [ + { "httpTask": { "url": "https://data-asg.goldprice.org/dbXRates/USD" } }, + { "jsonParseTask": { "path": "$.items[?(@.curr == \"USD\")].xagPrice" } } + ] +} +``` + +
    + +## NFTs + +Switchboard oracles can be used to fetch the floor price of various NFTs. + +
    + + +### Solana Monkey Business + + + +```json title="NFT_Solana_Monkey_Business.json" +{ + "name": "SMB Floor Price", + "tasks": [ + { + "httpTask": { + "url": "https://market.solanamonkey.business/api/fetchOffers?full=true" + } + }, + { + "jsonParseTask": { + "path": "$.offers[?(@.price)].price", + "aggregationMethod": "MIN" + } + } + ] +} +``` + +```json title="NFT_Solana_Monkey_Business.json" +{ + "name": "SMB Floor Price", + "tasks": [ + { + "httpTask": { + "url": "https://api.solanafloor.com/collections", + "method": "METHOD_POST" + } + }, + { + "jsonParseTask": { + "path": "$[?(@.code == 'SMB')].tokenFloor" + } + } + ] +} +``` + +
    + +
    + + +### DegenApe + + + +```json title="NFT_DegenApe_Floor_Price.json" +{ + "name": "DegenApe Floor Price", + "tasks": [ + { + "httpTask": { + "url": "https://qzlsklfacc.medianetwork.cloud/nft_for_sale?collection=degenape" + } + }, + { + "jsonParseTask": { + "path": "$[?(@.price)].price", + "aggregationMethod": "MIN" + } + } + ] +} +``` + +
    + +## Sports + +Switchboard oracles can be used to resolve the outcome of events. The following examples will resolve to the following values: + +- **0** - No Result +- **1** - Home Team Win +- **2** - Away Team Win + +
    + + +### European Premier League + + + +**ESPN** + +```json title="EPL_Man_United_v_Leicester_City_10_16_21.json" +{ + "name": "EPL MAN v LEI 10/16/2021", + "tasks": [ + { + "httpTask": { + "url": "https://site.api.espn.com/apis/site/v2/sports/soccer/eng.1/scoreboard/605965" + } + }, + { + "conditionalTask": { + "attempt": [ + { + "conditionalTask": { + "attempt": [ + { + "jsonParseTask": { + "path": "$.competitions[?(@.status.type.completed && @.id == '605965')].competitors[?(@.winner && @.homeAway == 'home')].id" + } + }, + { + "valueTask": { + "value": 1 + } + } + ], + "onFailure": [ + { + "jsonParseTask": { + "path": "$.competitions[?(@.status.type.completed && @.id == '605965')].competitors[?(@.winner && @.homeAway == 'away')].id" + } + }, + { + "valueTask": { + "value": 2 + } + } + ] + } + } + ], + "onFailure": [ + { + "conditionalTask": { + "attempt": [ + { + "jsonParseTask": { + "path": "$.competitions[?(@.status.type.completed && @.id == '605965')].id" + } + }, + { + "valueTask": { + "value": 0 + } + } + ] + } + } + ] + } + } + ] +} +``` + +**Yahoo** + +```json title="EPL_Man_United_v_Leicester_City_10_16_21.json" +{ + "name": "EPL MAN v LEI 10/16/2021", + "tasks": [ + { + "httpTask": { + "url": "https://sports.yahoo.com/soccer/premier-league/leicester-city-manchester-united-2247085" + } + }, + { + "regexExtractTask": { + "pattern": "root.App.main\\s+=\\s+(\\{.*\\})", + "groupNumber": 1 + } + }, + { + "conditionalTask": { + "attempt": [ + { + "conditionalTask": { + "attempt": [ + { + "jsonParseTask": { + "path": "$.context.dispatcher.stores.GamesStore.games[?(@.gameid == 'soccer.g.2247085' && @.status_type == 'final' && @.winning_team_id == @.home_team_id)].attendance" + } + }, + { + "valueTask": { + "value": 1 + } + } + ], + "onFailure": [ + { + "jsonParseTask": { + "path": "$.context.dispatcher.stores.GamesStore.games[?(@.gameid == 'soccer.g.2247085' && @.status_type == 'final' && @.winning_team_id == @.away_team_id)].attendance" + } + }, + { + "valueTask": { + "value": 2 + } + } + ] + } + } + ], + "onFailure": [ + { + "conditionalTask": { + "attempt": [ + { + "jsonParseTask": { + "path": "$.context.dispatcher.stores.GamesStore.games[?(@.gameid == 'soccer.g.2247085' && @.status_type == 'final')].attendance" + } + }, + { + "valueTask": { + "value": 0 + } + } + ] + } + } + ] + } + } + ] +} +``` + +
    diff --git a/website/docs/feed/operator.mdx b/website/docs/feed/operator.mdx new file mode 100644 index 0000000..ec49c0a --- /dev/null +++ b/website/docs/feed/operator.mdx @@ -0,0 +1,42 @@ +--- +sidebar_position: 15 +title: Feed Operator +--- + +This page gives an overview on how to configure and operate a Switchboard feed. + +## Job Consensus + +Job consensus refers to how individual oracles calculate their result from a feeds assigned job accounts. + +**_Job Diversity_** + +Data feeds should source data from a variety of sources when applicable. A feed relying on a single source is at the mercy of that sources uptime and responsiveness. + +**_Job Weights_** + +Data feeds should use job weights to calculate the weighted median, which is what the oracle submits on-chain as its final result. A data source that has the majority of an assets price action should be weighted higher than a dead exchange with questionable volume metrics. + +## Oracle Consensus + +Oracle consensus refers to how the final on-chain result is calculated from a batch of oracle responses. A feed's `aggregator.oracleRequestBatchSize` is the number of oracles assigned to a request, while `aggregator.minOracleResults` is the number of responses needed to accept a result. + +**_Increase oracleRequestBatchSize_** + +The quickest way to increase feed security is to request more oracles each update round because this requires a higher degree of oracle collusion in order to affect the accepted result. In reality, this increases the overall cost of a feed so its a careful consideration for feed operators when configuring a feed. + +**_ oracleRequestBatchSize $\neq$ minOracleResults _** + +The number of oracles assigned to an update request should always be less than the number of oracles required to respond. There are a variety of reasons that may cause an oracle response to fail, such as Solana network degradation, individual oracle network issues, or transaction spamming. Your feed's lease is only deducted when an oracle successfully responds and there is no penalty for an oracle who has timed out. + +## Feed Maintenance + +The primary maintenance for a feed is ensuring the lease contract has sufficient funds. The [@switchboard-xyz/lease-observer](https://github.com/switchboard-xyz/switchboard-v2/tree/main/packages/lease-observer) demonstrates how to emit PagerDuty events when a lease is low on funds. + +:::caution + +When a data feed's lease contract does not have enough funds, it will be automatically removed from its crank. When extending a feed's lease, make sure to also repush the feed back onto any cranks for updates to continue. + +::: + +You should also monitor the feed for staleness in case of downstream changes to a data sources endpoint. diff --git a/website/docs/feed/publisher/_category_.json b/website/docs/feed/publisher/_category_.json new file mode 100644 index 0000000..55d69cc --- /dev/null +++ b/website/docs/feed/publisher/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Publisher", + "position": 50, + "collapsible": false +} diff --git a/website/docs/feed/publisher/_curation.mdx b/website/docs/feed/publisher/_curation.mdx new file mode 100644 index 0000000..43e257a --- /dev/null +++ b/website/docs/feed/publisher/_curation.mdx @@ -0,0 +1,10 @@ +--- +sidebar_position: 30 +title: Curation +--- + +# Job Curation + +- Job Accounts include an author wallet +- When a job account is used by a data feed, the job account creator is rewarded +- Curators rewarded for populating publisher catalog diff --git a/website/docs/feed/publisher/_job-builder.mdx b/website/docs/feed/publisher/_job-builder.mdx new file mode 100644 index 0000000..6459490 --- /dev/null +++ b/website/docs/feed/publisher/_job-builder.mdx @@ -0,0 +1,9 @@ +--- +sidebar_position: 20 +title: Job Builder +--- + +# Job Builder + +- Build jobs +- [/api/tasks](/api/tasks) diff --git a/website/docs/feed/publisher/overview.mdx b/website/docs/feed/publisher/overview.mdx new file mode 100644 index 0000000..ed360f8 --- /dev/null +++ b/website/docs/feed/publisher/overview.mdx @@ -0,0 +1,275 @@ +--- +sidebar_position: 10 +slug: . +title: Overview +--- + +import MarkdownImage from "/src/components/MarkdownImage"; +import { Box, Typography, Grid } from "@mui/material"; +import Link from "@docusaurus/Link"; + + + # publish.switchboard.xyz + + +The publisher site is a decentralized marketplace that allows anyone to build a data feed and deploy it on-chain. The site includes a directory of pre-defined feeds from popular sources such as FTX, Coinbase, or any permissionless Serum market. The publisher site streamlines the on-chain workflow and allows a user to configure a data feed from a convienent UI. + +## Connect + + + + + + + + The publisher site contains a Connect Wallet button in the top + right corner that allows you to connect your web wallet to Devnet or + Mainnet. + +
    + + The publisher site currently supports the following wallets: + + +     +     + +## Directory + +The publisher site includes some pre-defined sources to help developers publish data feeds. Pre-defined sources can be added to your basket by selecting them in the directory, from there you can toggle individual data sources to meet your on-chain needs. + +**Coming Soon:** Users will soon have the ability to publish their own sources to the site and help grow the catalog. + + + +## Checkout + +During checkout, the publisher will create the necessary accounts for your data feed. + +### Lease + + + + + Automatic Updates + + + The Enable automatic updates checkbox determines whether your data + feed will be added to a crank. A crank allows data feeds to be updated at + regular intervals. Event based feeds should uncheck this box. + +
    + + Update Interval + + + The update interval lets you configure how often and how long a data feed + should be updated for. This derives the total cost deposited into the + lease contract escrow account, which is used to fund oracles each time a + feed is updated. You can extend or terminate a lease at anytime. + +
    +     + + + +     + +### Account Creation + + + + + + + + The Account Creation modal gives you a summary of your balance + changes before any on-chain transactions occur. Once you have verified the + total cost, hit Create Feed to submit the transactions. + +
    + + After the accounts have been created, you will be redirected to the My + Feeds page to view your newly created data feeds. + +
    + + By default, data feeds are added to the permissionless queue, where they + can begin updating immediately. Data feeds can be upgraded to the + permissioned queue by submitting a request to the Switchboard DAO. + +     +     + +## My Feeds + +The My Feeds page shows you a list of active data feeds associated with your wallet. + + + +
    + +The publisher site lets you manage your on-chain feeds and currently lets you: + + + + + + +
      +
    • + View Feed Details: View the Aggregator configuration such as + current accepted result, oracle batch size, and associated Job account + public keys. +
      • +
    • + View In Explorer: View the Aggregator in the Solana block + explorer. +
      • +
    • + Track Feed History: Optionally, add an{" "} + aggregator history buffer to + track the last N recorded samples. +
      • +
    • + Extend Lease: Deposit funds in the feeds lease contract. +
      • +
    • + Terminate Lease: Withdraw remaining funds from a feeds lease + contract and if present, remove it from its crank. +
      • +
    +     +     + +## Custom Feeds + + + + + The Custom Feed button lets you build a custom feed from a JSON + definition: + + +
    + + You should see the Custom Feed Modal to the right. Give your feed a + name, then for each job you require, select Add Job +. + +
    + A data feed must have at least one job. +     + + + +     + +### Custom Jobs + + + + + + + + The Custom Job modal lets you build a custom job from a JSON + definition or Public Key. + +
    + + JSON Definition + + + You can find example job definitions at: +
      +
    • + /api/tasks +
      • +
    • + Job Directory +
      • +
    • + + Switchboard Explorer + +
      • +
    +     +
    + + Paste in your JSON definition, then select Test to simulate the job + and view the result. + +
    + + Public Key + + + You can use an existing JobAccount public key to build your data feed. + This is useful if you are building multiple feeds that share job + definitions. + +     +     + +When done, select _Add Job_ to return to the _Custom Feed_ modal. diff --git a/website/docs/introduction.mdx b/website/docs/introduction.mdx index 4861862..b664d0e 100644 --- a/website/docs/introduction.mdx +++ b/website/docs/introduction.mdx @@ -6,8 +6,6 @@ slug: /introduction # Introduction -import MarkdownImage from "../src/components/MarkdownImage"; - > Switchboard is a community-driven, decentralized oracle network built on Solana that allows anyone to publish on-chain data for smart contract developers to reliably build upon. Switchboard is a community governed protocol — if additional on-chain data is needed, you will be able to publish it yourself after reading through these docs. diff --git a/website/docs/oracle/_category_.json b/website/docs/oracle/_category_.json index c7d3bd7..6126258 100644 --- a/website/docs/oracle/_category_.json +++ b/website/docs/oracle/_category_.json @@ -1,4 +1,5 @@ { "label": "Oracles", - "position": 20 + "position": 20, + "collapsible": true } diff --git a/website/docs/oracle/architecture.mdx b/website/docs/oracle/architecture.mdx new file mode 100644 index 0000000..d35a4d6 --- /dev/null +++ b/website/docs/oracle/architecture.mdx @@ -0,0 +1,41 @@ +--- +sidebar_position: 1 +slug: . +title: Architecture +--- + +import OracleMetrics from "/idl/types/OracleMetrics.md"; + +# Oracle Architecture + +A Switchboard oracle is a Node.js container that sits between the Solana blockchain and the internet and waits for update requests from an oracle queue. An oracle queue assigns updates to oracles in a round robin fashion. + +An oracle account is a program derived address (PDA) between the oracle queue it’s being initialized for, as well as the authority public key which will control it. Before an oracle is granted permissions to use a queue, it must transfer the minimum stake amount, set by the queue, to its escrow wallet. + +## Staking + +An oracle is required to transfer `queue.minStake` tokens to its staking wallet, `oracle.tokenAccount`, before being granted queue permissions. The minStake acts as an insurance policy to entice honest oracle behavior. + +## Heartbeat + +An oracle is required to heartbeat on-chain, `oracle.lastHeartbeat`, in order to join the queue and be assigned update request. An oracle must heartbeat before the queue's specified `queue.oracleTimeout` or it will be removed from the queue. + +## Metrics + +The oracle also tracks its performance, `oracle.metrics`. + + + +## Cost & Reward Estimations + +An oracle is required to submit an [aggregatorSaveResult](/idl/instructions/aggregatorSaveResult) transaction each time it updates a feed, which incurs a cost of 5000 lamports. This fee is set by the Solana network and is subject to change. + +$Reward_{perUpdate}=queue.reward - 5000$ + +To estimate an oracles cost basis, you will need to know a queue's capacity (Oracles, Feeds, VRFs) and the average number of update request an oracle is assigned over a given time period. + +You will also need to factor in the oracle's heartbeat cost, which is 5000 lamports each. The number of heartbeats is dependent on its `queue.oracleTimeout`, which determines how often an oracle is required to heartbeat. + +## More Information + +- [/idl/accounts/OracleAccountData](/idl/accounts/OracleAccountData) diff --git a/website/docs/oracle/service/_category_.json b/website/docs/oracle/service/_category_.json new file mode 100644 index 0000000..0ba7a98 --- /dev/null +++ b/website/docs/oracle/service/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Oracle Service", + "position": 10, + "collapsible": false +} diff --git a/website/docs/oracle/service/docker.mdx b/website/docs/oracle/service/docker.mdx new file mode 100644 index 0000000..9a03993 --- /dev/null +++ b/website/docs/oracle/service/docker.mdx @@ -0,0 +1,74 @@ +--- +sidebar_position: 10 +title: Docker +--- + +# Docker + +You can run an oracle locally and assign it to your own oracle queue to test how your program may operate in production. Mainnet oracles should always be run in high availability environments with some set of monitoring capabilities. + +## Requirements + +- [Docker-Compose](https://docs.docker.com/compose/install/) or another container orchestration pipeline + +## Setup + +Create a docker-compose.yml file with the required environment variables, as defined in [Oracle Config](./#config). + +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + + + + +```yaml title="docker-compose.yml" +version: "3.3" +services: + switchboard: + image: "switchboardlabs/node:dev-v2-5-3-22" + network_mode: host + restart: always + environment: + - LIVE=1 + - CLUSTER=devnet + - RPC_URL=${RPC_URL} + - ORACLE_KEY=${ORACLE_KEY} + - HEARTBEAT_INTERVAL=15 + volumes: + - ./configs.json:/configs.json +secrets: + PAYER_SECRETS: + file: /filesystem/path/to/keypair.json +``` + + + + +```yaml title="docker-compose.yml" +version: "3.3" +services: + switchboard: + image: "switchboardlabs/node:dev-v2-5-3-22 + network_mode: host + restart: always + environment: + - LIVE=1 + - CLUSTER=devnet + - RPC_URL=${RPC_URL} + - ORACLE_KEY=${ORACLE_KEY} + - HEARTBEAT_INTERVAL=15 + - GOOGLE_PAYER_SECRET_PATH=${GOOGLE_PAYER_SECRET_PATH} + - GCP_CONFIG_BUCKET=${GCP_CONFIG_BUCKET} +``` + + + + + +## Running + +Run the following command to start the container + +```bash +docker-compose up +``` diff --git a/website/docs/oracle/service/gcp.mdx b/website/docs/oracle/service/gcp.mdx new file mode 100644 index 0000000..e06ebd9 --- /dev/null +++ b/website/docs/oracle/service/gcp.mdx @@ -0,0 +1,543 @@ +--- +sidebar_position: 20 +title: Google Cloud Platform +--- + +Before deploying the application, you must first provision a kubernetes cluster with the relevant credentials. There are no exotic requirements for this cluster and to date, it has be able to run on an auto pilot GKE cluster without issue. + +A Switchboard oracle can be run on any cloud provider who offers kubernetes services but this guide will currently be focused on Google Cloud. Feel free to contribute to our documentation if you are running an oracle on another provider. Here's some extra reading to learn more about kubernetes: + +- [What is Kubernetes?](https://cloud.google.com/learn/what-is-kubernetes) +- [Kubernetes Engine Quickstart](https://cloud.google.com/kubernetes-engine/docs/quickstart) + +## Requirements + +### Switchboard Helm Charts + +The repo below contains the kubernetes manifest to streamline the deployment. Clone the repo below to get started: + +```bash +git clone https://github.com/switchboard-xyz/switchboard-v2 +cd switchboard-v2/oracles/helm-deployment +``` + +### gcloud SDK + +You will need to install the google cloud SDK and have a Google Cloud Platform account + +- [Install gcloud SDK](https://cloud.google.com/sdk/docs/install) +- [Google Cloud Platform Registration](https://console.cloud.google.com/freetrial/signup/tos) + +Verify it installed correctly with the following command: + +```bash +gcloud --version +``` + +### Grafana Domain Name + +You will need a domain name to point your grafana instance at to monitor your oracle's metrics. During setup, you will create an external IP, which you will need to add to your domains DNS records. Finally we will provision a TLS certificate for your domain for enhanced security. + +## Environment + +You will need to collect the following environment variables to inject into the helm charts before deploying to Google Cloud Project. If you chose to use the automated deployment, an env file will be populated with most of these variables populated. + +
    + + + GCP Environment Variables + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Env VariableDefinition
    CLUSTER + + Required + +
    + Type - String (devnet / mainnet-beta) +
    + Description - Solana cluster you will be running an oracle on + (mainnet-beta/devnet) +
    RPC_URL + + Required + +
    + Type - URL +
    + Description - Solana RPC URL that must be capable of supporting + websockets. The default RPC pools should be avoided at all cost as you + will quickly hit the rate limits and risk being slashed +
    WS_URL + + Optional + +
    + Type - URL +
    + Default - RPC_URL +
    + Description - Websocket URL to connect to a Solana RPC server. If + not provided, oracle will fallback to RPC_URL +
    BACKUP_MAINNET_RPC + + Optional + +
    + Type - URL +
    + Default - https://api.mainnet-beta.solana.com +
    + Description - Backup RPC URL in case of network congestion +
    ORACLE_KEY + + Required + +
    + Type - Public Key +
    + Description - Public key of the oracle account that has been + granted permissions to use an oracle queue
    +
    HEARTBEAT_INTERVAL + + Optional + +
    + Type - Number (seconds) +
    + Default - 15 +
    + Description - Seconds between oracle heartbeats. Queues have + different oracle heartbeat requirements. Recommended value is 15 +
    SERVICE_ACCOUNT_BASE64 + + Required + +
    + Type - Base64 encoded JSON file +
    + Description - Base64 encoded JSON file containing the private key + for your service account that has access to your google secret keypair + and config bucket +
    GOOGLE_PAYER_SECRET_PATH + + Required + +
    + Type - GCP Resource Path +
    + Description - Google cloud resource to manage your keypair + securely. +
    GCP_CONFIG_BUCKET + + Optional + +
    + Type - GCP Resource Path +
    + Default - oracle-configs:configs.json +
    + Description - Contains API keys for private API endpoints +
    EXTERNAL_IP + + Required + +
    + Type - IPv4 Address +
    + Description - IP Address where your grafana instance will be + hosted to view metrics and oracle operating status +
    GRAFANA_HOSTNAME + + Required + +
    + Type - Fully Qualified Domain Name +
    + Description - Hostname where your grafana instance will point to +
    GRAFANA_PASSWORD + + Optional + +
    + Type - String / Password +
    + Default - Sbv2K8sPassword123@ +
    + Description - Password to admin account that allows access to + your grafana instance. You can set this to whatever value you want. +
    +
    GRAFANA_TLS_CRT + + Required + +
    + Type - Base64 encoded CRT file +
    + Description - Base64 encoded string of your TLS certificate to + secure your grafana instance +
    GRAFANA_TLS_KEY + + Required + +
    + Type - Base64 encoded private key file +
    + Description - Base64 encoded string of the private key used to + create your TLS certificate +
    + +
    + +## Setup + +The `oracles/helm-deployment` directory in the [Switchboard-V2 SDK](https://github.com/switchboard-xyz/switchboard-v2) contains a bash script to walk through the GCP setup and output the required variables to an env file. This script is provided as a convenience tool, you should understand all of the commands in the script before running. To automate the GCP setup, run the following command: + +```bash +./setup-gcloud.sh PROJECTNAME + +# ./setup-gcloud.sh Sbv2-Devnet-Oracle +``` + +- `PROJECTNAME` will be the name of your GCP project and must contain no spaces or special characters + +The script will walk-through the google cloud setup, create your gcp project, add your oracle keypair as a secret, create a service account and give it access to your keypair, then spin up a kubernetes cluster. The script will periodically prompt you for more information. + +Upon completion you will have a file `PROJECTNAME.env` containing: + +- PROJECT +- DEFAULT_REGION +- DEFAULT_ZONE +- CLUSTER_NAME +- EXTERNAL_IP +- SECRET_NAME +- GOOGLE_PAYER_SECRET_PATH +- GCP_CONFIG_BUCKET +- SERVICE_ACCOUNT_EMAIL +- SERVICE_ACCOUNT_BASE64 + +You will need to manually add: + +- CLUSTER +- RPC_URL +- BACKUP_MAINNET_RPC +- ORACLE_KEY +- GRAFANA_HOSTNAME +- GRAFANA_PASSWORD +- GRAFANA_TLS_CRT +- GRAFANA_TLS_KEY + +
    + Manual GCP Setup Steps + +Login + +Login to your google cloud account: + +```bash +gcloud auth login +``` + +Project + +Create a new project + +```bash +gcloud projects create switchboard-oracle-cluster --name="Switchboard Oracle" +``` + +Set it as your default project + +```bash +gcloud config set project switchboard-oracle-cluster +``` + +[Google - gcloud projects create](https://cloud.google.com/sdk/gcloud/reference/projects/create) + +gCloud Conifg + +Set the default zone using [list of regions and zones](https://cloud.google.com/compute/docs/regions-zones#available) + +```bash +gcloud config set compute/zone us-west1-a # replace with your closest region +``` + +Set the default region using [list of regions and zones](https://cloud.google.com/compute/docs/regions-zones#available) + +```bash +gcloud config set compute/region us-west1 # replace with your closest region +``` + +[Google - Set default settings for the gcloud tool](https://cloud.google.com/kubernetes-engine/docs/quickstart#autopilot) + +Billing + +You will need to enable billing for the project before enabling any services: + +- https://console.cloud.google.com/billing/enable?project=switchboard-oracle-cluster + +[Google - APIs and billing](https://support.google.com/googleapi/answer/6158867?hl=en) + +Services + +Enable the relevant services: + +```bash +gcloud services enable compute.googleapis.com +gcloud services enable container.googleapis.com +gcloud services enable iamcredentials.googleapis.com +gcloud services enable secretmanager.googleapis.com +``` + +External IP + +You will need to reserve a static IP address for your grafana instance + +```bash +gcloud compute addresses create load-balancer --project=switchboard-oracle-cluster +gcloud compute addresses list +# NAME ADDRESS/RANGE +# load-balancer 123.123.123.123 ($LOADBALANCER_IP) +``` + +This will be your `$EXTERNAL_IP` + +[Google - Reserve a new static external IP address](https://cloud.google.com/compute/docs/ip-addresses/reserve-static-external-ip-address#reserve_new_static) + +Service Account + +You will need to create a service account to access our resources. + +```bash +gcloud iam service-accounts create svc-account --display-name="Oracle Service Account" +gcloud iam service-accounts list +``` + +Now save it to our filesystem + +```bash +gcloud iam service-accounts keys create secrets/svc-account.json --iam-account=svc-account@switchboard-oracle-cluster.iam.gserviceaccount.com +``` + +Now convert the json file to a base64 string to store in `$SERVICE_ACCOUNT_BASE64` + +```bash +base64 secrets/svc-account.json +``` + +[Google - Creating service account keys](https://cloud.google.com/iam/docs/creating-managing-service-account-keys) + +OraclePayerSecret + +You will need to store your solana keypair in Google Secret Manager for enhanced security. If you are using another keypair replace `--data-file` with your relevant path. + +```bash +gcloud secrets create oracle-payer-secret --replication-policy="automatic" --data-file=secrets/authority-keypair.json +``` + +You can view your `$GOOGLE_PAYER_SECRET_PATH` in the [GCP console](https://console.cloud.google.com/security/secret-manager/secret/oracle-payer-secret/versions&project=switchboard-oracle-cluster) or by running the command + +```bash +echo "$(gcloud secrets list --uri --filter=oracle-payer-secret | \ +cut -c41- | tr -d '\n')/versions/latest" +``` + +[Google - Creating a secret](https://cloud.google.com/secret-manager/docs/creating-and-accessing-secrets) + +Storage Bucket + +You can create a GCP storage bucket to store API keys. The following command will create a new storage bucket and give your service account permissions to read from it. You will need to use a unique name as storage bucket names are global to the entire GCP platform. + +```bash +gsutil mb -p switchboard-oracle-cluster -l us-west1 gs://switchboard-oracle-cluster-bucket +gsutil iam ch serviceAccount:svc-account@switchboard-oracle-cluster.iam.gserviceaccount.com:legacyBucketReader gs://switchboard-oracle-cluster-bucket +gsutil ls +# gs://switchboard-oracle-cluster-bucket/ +``` + +You can view your `$GCP_CONFIG_BUCKET` by running the command + +```bash +echo "$(gsutil ls | grep 'switchboard-oracle-cluster-bucket' | \ +sed -e 's/.*gs:\/\/\(.*\)\/.*/\1/' ):configs.json" +# switchboard-oracle-cluster-bucket:configs.json +``` + +[Google - Create storage buckets](https://cloud.google.com/storage/docs/creating-buckets#storage-create-bucket-gsutil) + +Kubernetes Cluster + +Finally you will need to create a new kubernetes cluster + +```bash +gcloud container clusters create-auto switchboard-cluster \ +--service-account=svc-account@switchboard-oracle-cluster.iam.gserviceaccount.com \ +--region us-west1 +``` + +then connect to it and store your credentials in your gCloud config + +```bash +gcloud container clusters get-credentials switchboard-cluster \ +--project switchboard-oracle-cluster \ +--region us-west1 +``` + +:::note +Remember to update the region to the same region you used for your static IP. +::: + +[Google - Create a GKE cluster](https://cloud.google.com/kubernetes-engine/docs/quickstart#autopilot) + +Wrapping Up + +You should now have an `PROJECTNAME.env` file containing + +- EXTERNAL_IP +- GOOGLE_PAYER_SECRET_PATH +- GCP_CONFIG_BUCKET +- SERVICE_ACCOUNT_BASE64 + +You will need to manually add: + +- CLUSTER +- RPC_URL +- BACKUP_MAINNET_RPC +- ORACLE_KEY +- GRAFANA_HOSTNAME +- GRAFANA_PASSWORD +- GRAFANA_TLS_CRT +- GRAFANA_TLS_KEY + +
    + +## Grafana + +Grafana is a visualization tool to view your cluster's metrics. While this step is optional, it is recommended if you have no other monitoring or metric suite in place. + +### Domain Name + +You will need a domain name to host your grafana instance. In your domain management tool, add a DNS A record with a value of `$EXTERNAL_IP`. + +This value will be your `$GRAFANA_HOSTNAME` (i.e. grafana.switchboard.com) and will be used to provision a TLS certificate. + +### TLS Certificate + +The following steps will walk you through provisioning a TLS certificate for your domain from letsencrypt. The [helm-manifest repo](https://github.com/switchboard-xyz/helm-manifests) contains a script to walk through creating the neccessary keys and certificate signing request (CSR). + +```bash +./setup-grafana.sh PROJECTNAME DOMAIN EMAIL +``` + +- PROJECTNAME is the name of the env file to store variables +- DOMAIN is your $GRAFANA_HOSTNAME from above +- EMAIL is the email you will use for your certificate signing request + +When the necessary keys and CSR are generated, head over to [gethttpsforfree.com](https://gethttpsforfree.com.com) and walk through their steps to sign your certificate. Save the final output to the filename given by the script, then rerun the script. The script will save the env variables to `PROJECTNAME.env` and also output them to the console. + +Your `PROJECTNAME.env` file should now contain + +- GRAFANA_HOSTNAME +- GRAFANA_PASSWORD (You can set this to whatever value you want) +- GRAFANA_TLS_CRT +- GRAFANA_TLS_KEY + +## Deploy + +After completing the steps on this page you should have a `PROJECTNAME.env` file with each of the required variables defined. See [Google Cloud / Environment](#environment) for a list of all required variables that must be set. + +Run the following command to build the helm charts with your environment variables injected into the manifests: + +```bash +./build-helm.sh PROJECTNAME +``` + +### Deploy Helm Charts + +Run the command + +```bash +./deploy-helm.sh PROJECTNAME +``` + +When complete, you should see your cluster running in the Google Cloud Console. + +[Google - Observing your GKE clusters](https://cloud.google.com/stackdriver/docs/solutions/gke/observing) + +### Update + +If necessary, rebuild the charts to update any environment variables: + +```bash +./build-helm.sh PROJECTNAME +``` + +then redeploy the helm charts: + +```bash +./deploy-helm.sh PROJECTNAME +``` diff --git a/website/docs/oracle/service/monitoring.mdx b/website/docs/oracle/service/monitoring.mdx new file mode 100644 index 0000000..4ece216 --- /dev/null +++ b/website/docs/oracle/service/monitoring.mdx @@ -0,0 +1,86 @@ +--- +sidebar_position: 30 +title: Monitoring +--- + +## Metrics + +The oracle uses open telemetry for emitting metrics. +As such, at the time of this writing, the oracle supports prometheus (as well as any wire-compatible solution like cortex, thanos or victoria metrics) and GCP monitoring. +This can be configured via the `$METRICS_EXPORTER` environmental variable ('prometheus' and 'gcp') + +If GCP monitoring is used, all data collection and visualization is handled by the platform although users are advised to closely watch billing. + +For users that are either not running on GCP or want a more cost effective solution, grafana and victoria metrics (prometheus compatible scraping+storage) manifests are provided in the kubernetes-manifests repo. + +
    + List of metrics + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Metric NameDescription
    switchboard_aggregator_variance + the ratio between the largest and smallest value from all aggregated + responses for a given job +
    switchboard_heartbeat_failure_totala counter for every time there is a heartbeat failure
    switchboard_job_failure_totala counter for every time there is a job failure
    switchboard_job_success_total + a counter for every time there is a successful completion of a job +
    switchboard_job_posting_totala counter for every time there is a job posting
    switchboard_log_agea value recorder for the age of the job logs when processed
    switchboard_node_aggregation_insufficient_responses_total + a counter for every time there is an insufficient number of aggregated + responses for a job +
    switchboard_node_balance + each oracle will report its balance with a label indicating the public + key +
    switchboard_save_result_failure_total + a counter for the number of times an oracle is unable to commit a + transaction to the blockchain +
    scheduler_node_balancemost recent balance of the scheduler wallet
    +
    + +## Alerts + +Pagerduty allows you to get real time alerts on your oracle. You will need to sign up for an account and get an API key for access. + +`$PAGERDUTY_EVENT_KEY` is an optional environment variable to help you manage your cluster. You may wish to ignore this variable if you are comfortable with your own monitoring solutions + +- [Pagerduty - Generating API Keys](https://support.pagerduty.com/docs/generating-api-keys#section-events-api-keys) diff --git a/website/docs/oracle/service/requirements.mdx b/website/docs/oracle/service/requirements.mdx new file mode 100644 index 0000000..234b663 --- /dev/null +++ b/website/docs/oracle/service/requirements.mdx @@ -0,0 +1,284 @@ +--- +sidebar_position: 1 +slug: . +title: Requirements +--- + +# Background + +A Switchboard oracle is a Node.js container that sits between the Solana blockchain and the internet and waits for update requests from its assigned oracle queue. + +You can find the latest Switchboard oracle image on [DockerHub](https://hub.docker.com/r/switchboardlabs/node/tags). + +## Hardware Requirements + +A Switchboard oracle should be hosted in a highly available environment with some level of redundancy and fail over to prevent outages, although oracles are not deducted for being offline. + +Currently the Switchboard oracle is a single threaded Node.js application with no strict hardware requirements. At the very minimum a node should have: + +- 4gb RAM +- 3.0 Ghz CPU +- 100+ Mbps connection + +## RPC Endpoint + +A Switchboard oracle should have a reliable RPC endpoint with no rate limiting in order to respond in a timely manner. RPC providers will need to have `--full-rpc-api` enabled in their validator config, along with the ability to support fetching 100 program accounts in a single getProgramAccounts request. + +Switchboard recommendeds the following RPC providers: + +- RPC Pool +- GenesysGo +- Syndica + +## Environment Variables + +```bash env title=".env" +# Solana Config +CLUSTER="" +RPC_URL="" +WS_URL="" +BACKUP_MAINNET_RPC="" +# Oracle Config +ORACLE_KEY="" +HEARTBEAT_INTERVAL=15 +GCP_CONFIG_BUCKET="" +# Keypair Config +PAYER_SECRET_PATH="" +PAYER_SECRETS="" +GOOGLE_PAYER_SECRET_PATH="" +# Monitoring Config +METRICS_EXPORTER +PAGERDUTY_EVENT_KEY="" +VERBOSE=1 +``` + +### Solana Config + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Env VariableDefinition
    CLUSTER + + Required + +
    + Type - String (devnet / mainnet-beta) +
    + Description - Solana cluster you will be running an oracle on + (mainnet-beta/devnet) +
    RPC_URL + + Required + +
    + Type - URL +
    + Description - Solana RPC URL that must be capable of supporting + websockets. The default RPC pools should be avoided at all cost as you + will quickly hit the rate limits and risk being slashed +
    WS_URL + + Optional + +
    + Type - URL +
    + Default - RPC_URL +
    + Description - Websocket URL to connect to a Solana RPC server. If + not provided, oracle will fallback to RPC_URL +
    BACKUP_MAINNET_RPC + + Optional + +
    + Type - URL +
    + Default - https://api.mainnet-beta.solana.com +
    + Description - Backup RPC URL in case of network congestion +
    + +### Oracle Config + + + + + + + + + + + + + + + + + + + + + + +
    Env VariableDefinition
    ORACLE_KEY + + Required + +
    + Type - Public Key +
    + Description - Public key of the oracle account that has been + granted permissions to use an oracle queue
    +
    HEARTBEAT_INTERVAL + + Optional + +
    + Type - Number (seconds) +
    + Default - 30 +
    + Description - Seconds between oracle heartbeats. Queues have + different oracle heartbeat requirements. Recommended value is 15 +
    GCP_CONFIG_BUCKET + + Optional + +
    + Type - GCP Resource Path +
    + Default - Looks for configs.json in the current working + directory. If not found, no config is loaded. +
    + Description - Contains API keys for private API endpoints +
    + +### Keypair Config + +You must provide one of the following environment variables, which is the same keypair that is the authority for the given `$ORACLE_KEY` and will pay for any on-chain transactions. + + + + + + + + + + + + + + + + + + + + + + +
    Env VariableDefinition
    PAYER_SECRET_PATH + Type - Filesystem Path +
    + Description - Local filesystem path to keypair file that will pay + for on-chain transactions and is the authority for the oracle +
    PAYER_SECRETS + Type - Docker Secret +
    + Description - Docker Secret path to keypair file that will pay + for on-chain transactions and is the authority for the oracle +
    GOOGLE_PAYER_SECRET_PATH + Type - GCP Resource Path +
    + Description - Google cloud resource to manage your keypair + securely. +
    + +### Monitoring Config + + + + + + + + + + + + + + + + + + + + + + +
    Env VariableDefinition
    METRICS_EXPORTER + + Optional + +
    + Type - prometheus / gcp / opentelemetry-collector* +
    + Default - prometheus +
    + Description - Dictates which metric suite to aggregate resource + metrics, as defined in: +
    + Oracle - Monitoring +
    + *opentelemetry-collector only supports the default endpoint + localhost:55681/v1/metric +
    PAGERDUTY_EVENT_KEY + + Optional + +
    + Type - String +
    + Default - Paging disabled +
    + Description - Token provided by pagerduty for sending pages about + various alerts. +
    + Oracle - Alerts +
    VERBOSE + + Optional + +
    + Type - Flag (0 or 1) +
    + Default - 0, normal logging +
    + Description - Set to 1 to increase the level of logging +
    diff --git a/website/docs/program.mdx b/website/docs/program.mdx index 97a8e4a..0315ae2 100644 --- a/website/docs/program.mdx +++ b/website/docs/program.mdx @@ -1,24 +1,24 @@ --- sidebar_position: 5 +id: program slug: /program -title: Program --- -import PublicKeyButton from "/src/components/PublicKeyButton"; import MarkdownImage from "/src/components/MarkdownImage"; import { Box, Typography, Grid } from "@mui/material"; -import ProgramStateAccountData from "/idl/accounts/SbState.md"; import Link from "@docusaurus/Link"; +import ProgramStateAccountData from "/idl/accounts/SbState.md"; -## Program State +# Program + +## Program State Account - +
    - The program state account governs the Switchboard V2 program and controls the - token mint used throughout for oracle rewards, aggregator leases, and - other incentives. + The Program State Account is the top level account that is used to connect + independent oracle queues.
    @@ -27,115 +27,24 @@ import Link from "@docusaurus/Link"; model.
    - -### 📦SbState - - - + {/* + Oracle queue's support: +
      +
    • + Data Feeds +
      • +
    • + Randomness +
      • +
    • + Buffer Relayers +
      • +
    +     */}     - + -## Mainnet-Beta - -Below is a list of public keys used in the Switchboard V2 mainnet deployment. - - - - - - - - - - - - - - - - - - - - - - -
    AccountPublic Key
    - Program ID - - -
    - Permissionless Queue - - Queue -
    - -
    - Crank -
    - -
    - Permissioned Queue - - Queue -
    - -
    - Crank -
    - -
    - -## Devnet - -Below is a list of public keys used in the Switchboard V2 devnet deployment. - - - - - - - - - - - - - - - - - - - - - - -
    AccountPublic Key
    - Program ID - - -
    - Permissionless Queue - - Queue -
    - -
    - Crank -
    - -
    - Permissioned Queue - - Queue -
    - -
    - Crank -
    - -
    + diff --git a/website/docs/queue/_category_.json b/website/docs/queue/_category_.json new file mode 100644 index 0000000..a28b265 --- /dev/null +++ b/website/docs/queue/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Oracle Queue", + "position": 10, + "collapsible": true +} diff --git a/website/docs/queue/architecture.mdx b/website/docs/queue/architecture.mdx new file mode 100644 index 0000000..649ae61 --- /dev/null +++ b/website/docs/queue/architecture.mdx @@ -0,0 +1,141 @@ +--- +sidebar_position: 1 +slug: . +title: Architecture +--- + +import { Box, Typography, Grid } from "@mui/material"; +import MarkdownImage from "/src/components/MarkdownImage"; +import SwitchboardPermission from "/idl/types/SwitchboardPermission.md"; + +# Oracle Queue Architecture + +An oracle queue allocates and protects a set of oracles, which act as a resource pool for on-chain programs to utilize. Oracle queues currently support fulfilling update request for the following: + +| Resource Type | Description | +| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **Data Feeds** | Utilize a batch of oracles to resolve a data point from a variety of source and determine the final result as the median of oracle responses
    _Can be a price feed, sport result, or any data point found on the internet_ | +| **Randomness** | Utilize an oracle to publish and verify a Verifiable Randomness Function on-chain.
    _Can be used for fair NFT launches, decentralized lottery, or any random assignment_ | +| **Buffer Relayer** | Utilize an oracle to relay and publish a buffer on-chain
    _Can be used by programs needing a way to quickly source data on-chain that may not need as many security guarantees as a price feed _ | + +## Configuration + + + +
      +
    • + Oracle Queue: Contains the Oracle Queue's configuration + parameters that influence its security model. +
      • +
      +
    • + Oracle Queue Buffer: Stores the current list of oracles actively + heartbeating on-chain. +
      • +
      +
    • + Oracle: Off-chain resource used by a queue to fulfill update + request. +
      • +
      +
    • + Crank: Optional, Crank Account that permits data feeds to join + and request periodic updates. +
      • +
      +
    • + Crank Buffer: Stores the list of data feeds on a crank along with + their next allowed update time. +
      • +
    +     + + + +     + +
    + +:::tip + +See [/idl/accounts/OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) for the full list of an OracleQueueAccount's configuration parameters. + +::: + +## Oracle Queue + +When creating a queue, an OracleQueueBuffer account must also be initialized with a size of 8 Bytes + (32 Bytes × `queue.maxSize`), where `queue.maxSize` is the maximum number of oracles the queue can support. The OracleQueueBuffer account `queue.dataBuffer` stores a list of oracle public keys in a round robin fashion, using `queue.currIdx` to track its position on the queue for allocating resource update request. Once a buffer is full, oracles must be removed before new oracles can join the network. An oracle can be assigned to many update request simultaneously but must continuously heartbeat on-chain to signal readiness. + +An oracle with **PermitOracleHeartbeat** permissions _MUST_ periodically heartbeat on the queue to signal readiness, which adds the oracle to the queue and allows it to be assigned resource update requests. Oracle positions are periodically swapped in the OracleQueueBuffer account to mitigate oracles being assigned the same update requests on each iteration of the queue. + +The queue uses `queue.gcIdx` to track its garbage collection index. When an oracle heartbeats on-chain, it passes the oracle account at index `queue.gcIdx`. If the oracle account has failed to heartbeat before `queue.oracleTimeout`, it is removed from the queue until its next successful heartbeat and will no longer be assigned resource update requests. + +## Access Control + +Oracle queue resources, such as oracles, aggregators, VRF accounts, or buffer relayer accounts, _MUST_ have an associated [PermissionAccount](/idl/accounts/PermissionAccountData) initialized before interacting with a queue. Permissions are granted by `queue.authority`, which could be a DAO controlled account to allow network participants to vote on new entrants. + +Oracles _MUST_ have **PermitOracleHeartbeat** permissions before heartbeating on a queue. This is to prevent a malicous actor from spinning up a plethora of oracles until it obtains the super majority, at which point it could misreport data feed results and cause honest oracles to be slashed. + +See the table below for the minimum required permissions for a resource based on the queues settings: + +| Queue Setting | False | True | +| ---------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- | +| `unpermissionedFeedsEnabled` | Aggregators & Buffer Relayers _MUST_ have **PermitOracleQueueUsage** permissions before requesting an update | Aggregators & Buffer Relayers require no explicit permissions before requesting an update | +| `unpermissionedVrfEnabled` | VRF Accounts _MUST_ have **PermitVrfRequests** permissions before requesting an update | VRF Accounts require no explicit permissions before requesting an update | +| `enableBufferRelayers` | Buffer Relayers are _NOT_ permitted to request updates | Buffer Relayers are permitted to request updates | + + + +## Crank + +A queue can choose to create one or many cranks. A crank is a scheduling mechanism that allows data feeds to request periodic updates. A crank can be turned by anyone, and if successful, the crank turner will be rewarded for jump starting the system. + +A data feed is only permitted to join a crank if it has sufficient permissions (as detailed above) and the crank has available capacity. Data feeds on a crank are ordered by their next available update time with some level of jitter, providing a maximum update interval of 2 × a data feed's `aggregator.minUpdateDelaySeconds`. This is to mitigate oracles being assigned to the same aggregator update request, making a feed vulnerable to a malicious oracle. + +## Economic Security + +An oracle queue uses economic incentives to entice oracles to act honestly, which dictate a queue's security model. + +### Stake + +The queue's `queue.minStake` is the number of tokens required by an oracle to heartbeat on a queue. If an oracle's staking wallet falls below the minStake requirement, it is removed from the queue. + +DeFi protocols with a significant Total Value Locked (TVL) should require oracles with a higher minimum stake to fulfill their update request. Oracles with a higher degree of _skin-in-the-game_ have a greater incentive to respond honestly. + +### Reward + +The queue's specified `queue.reward` is the number of tokens an oracle or crank turner receives for successfully completing an on-chain action. For a crank turner this is turning the crank and invoking a data feed update. For an oracle this is responding to an update request within the reliable margin from the accepted result. + +Queues should reward oracles enough such that the economic incentive over the lifecycle of the feed exceeds the opportunity cost to attack a protocol consuming the feed. + +### Slashing + +A queue may set `queue.slashingEnabled` to true in order to dissuade oracles from responding to update request outside a set margin of error. + +A queue's `queue.varianceToleranceMultiplier` determines how many standard deviations an oracle must respond within before being slashed and forfeiting a portion of their stake. [Defaults to 2 std deviations] + +DeFi protocols with a significant TVL should require their feeds to be on a queue with slashing enabled. + +## Governance + +An oracle queue can be governed by its network participants to control the various queue configuration parameters, such as: + +- `queue.minStake` - require a higher up-front cost for oracles to entice honest behavior +- `queue.reward` - control the oracle reward payout for successfully fulfilling update request +- `queue.slashingEnabled` - to disincentivize malcious oracle behavior +- Permit new oracles to join the network + +## More Information + +- [/idl/accounts/OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) +- [/idl/accounts/OracleQueueBuffer](/idl/accounts/OracleQueueBuffer) diff --git a/website/docs/queue/private-queues.mdx b/website/docs/queue/private-queues.mdx new file mode 100644 index 0000000..e6ba9f0 --- /dev/null +++ b/website/docs/queue/private-queues.mdx @@ -0,0 +1,375 @@ +--- +sidebar_position: 10 +title: Private Queues +--- + +A private queue is any Oracle Queue not controlled by the Switchboard DAO. + +Switchboard is architected to route off-chain data to an on-chain account. A publisher is responsible for building the job definition, which defines the task(s) the oracles must perform to fetch and transform external data. Sometimes a publisher may wish to bring private data on-chain using an API key which poses a set of challenges. In order for the oracle to retrieve the data, they need access to the publisher's API key. Blockchains are public so there is no easy way to conceal the API key on-chain. + +Switchboard provides the ability to create your own queue with your own set of oracles, allowing the oracles access to your API key so they can resolve the private endpoints. + +## Variable Expansion + +Oracles can be provided a `configs.json` file to store various configurations needed to execute job definitions. If an oracle encounters a job definition with a variable, it will parse the `configs.json` and embed the value in the job definition. + +Oracles can embed API Keys on a per job basis by specifying the jobAccount public key or by using an asterik character to use the variable for multiple job definitions. **_Wildcard variables should use a unique name to prevent incorrect substitution._** + +```json title="configs.json" +{ + "jobVariables": { + // Pubkey of the Job account for which this variable expansion applies + "HtB62K71H49RJbATYpmB6UCMBXLK6G3Q5JtGveTMR8Mt": { + "VARIABLE_NAME": "abc123" + }, + // Global variable expansion that applies to any Job account. SEE CAUTION BELOW + "*": { + "GLOBAL_VARIABLE_NAME": "abc123" + } + } +} +``` + +:::caution + +Private queue's should **_ALWAYS_** have `unpermissionedFeedsEnabled` set to false. Allowing unpermitted feeds could result in a malicous actor creating a job definition that leaks your sensitive API keys. + +::: + +## Example + +We'll be using [commodities-api](https://www.commodities-api.com) to resolve our data for this example. You will need to signup for an account to get a `COMMODITIES_API_KEY`. + +### Create a Queue + +First, we will need to create our own queue. The following command will create a queue with a single oracle and crank. + +```bash +sbv2 queue:create \ + --name "Private Queue" \ + --keypair ../payer-keypair.json \ + --authority ../payer-keypair.json \ + --numOracles 1 \ + --reward 0 \ + --outputFile "Private_Queue.json" +``` + +### Start Oracle + +Create a docker-compose file, replacing `ORACLE_KEY`, `RPC_URL`, and `PAYER_KEYPAIR` with the appropriate values. + +```yml title="docker-compose.yml" +version: "3.3" +services: + oracle: + image: "switchboardlabs/node:dev-v2-5-3-22" + network_mode: host + restart: always + secrets: + - PAYER_SECRETS + environment: + - LIVE=1 + - CLUSTER=devnet + - HEARTBEAT_INTERVAL=30 # Seconds + - ORACLE_KEY=${ORACLE_KEY} + - RPC_URL=${RPC_URL} + volumes: + - ./configs.json:/configs.json +secrets: + PAYER_SECRETS: + file: ${PAYER_KEYPAIR} +``` + +We need to embed the commodities-api key in our oracle's configs.json file. + +```json title="configs.json" +{ + "jobVariables": { + // Pubkey of the OracleJob account for which this variable expansion applies or *. + "*": { + "COMMODITIES_API_KEY": "YOUR_API_KEY_HERE" + } + } +} +``` + +Start the oracle + +```bash +docker-compose up +``` + +### Create WHEAT Aggregator + +Looking at their docs, we'll need to fetch data from the following endpoint and take the inverse. The aggregator definition will look like this: + +```json title="Wheat.json" +{ + "name": "WHEAT", + "metadata": "", + "oracleRequestBatchSize": 1, + "minOracleResults": 1, + "minJobResults": 1, + "minUpdateDelaySeconds": 900, + "jobs": [ + { + "name": "commodities-api WHEAT", + "tasks": [ + { + "httpTask": { + "url": "https://www.commodities-api.com/api/latest?access_key=${COMMODITIES_API_KEY}&base=USD&symbols=WHEAT" + } + }, + { + "jsonParseTask": { + "path": "$.data.rates.WHEAT" + } + }, + { + "powTask": { + "scalar": -1 + } + } + ] + } + ] +} +``` + +Now we need to create an aggregator and add this job definition to it. + +```bash +sbv2 aggregator:create:json wheat.json \ + --keypair ../payer-keypair.json \ + --queueKey QUEUE_KEY_OUTPUTTED_ABOVE \ + --outputFile Wheat_Aggregator.json +``` + +Now we can request an update from our running oracle + +```bash +sbv2 aggregator:update AGGREGATORKEY --keypair PAYERKEYPAIR +``` + +We should see the oracle respond to the job and update the on-chain value + +```bash +sbv2 aggregator:print AGGREGATORKEY +``` + +### Other Aggregator Definitions + +
    + + + +#### Crude + + + +```json title="Crude.json" +{ + "name": "Crude WTIOIL", + "metadata": "", + "oracleRequestBatchSize": 1, + "minOracleResults": 1, + "minJobResults": 1, + "minUpdateDelaySeconds": 900, + "jobs": [ + { + "name": "commodities-api WTIOIL", + "tasks": [ + { + "httpTask": { + "url": "https://www.commodities-api.com/api/latest?access_key=${COMMODITIES_API_KEY}&base=USD&symbols=WTIOIL" + } + }, + { + "jsonParseTask": { + "path": "$.data.rates.WTIOIL" + } + }, + { + "powTask": { + "scalar": -1 + } + } + ] + } + ] +} +``` + +
    + +
    + + + +#### Gold + + + +```json title="Gold.json" +{ + "name": "Gold", + "metadata": "", + "oracleRequestBatchSize": 1, + "minOracleResults": 1, + "minJobResults": 1, + "minUpdateDelaySeconds": 900, + "jobs": [ + { + "name": "commodities-api XAU", + "tasks": [ + { + "httpTask": { + "url": "https://www.commodities-api.com/api/latest?access_key=${COMMODITIES_API_KEY}&base=USD&symbols=XAU" + } + }, + { + "jsonParseTask": { + "path": "$.data.rates.XAU" + } + }, + { + "powTask": { + "scalar": -1 + } + } + ] + } + ] +} +``` + +
    + +
    + + + +#### Silver + + + +```json title="Silver.json" +{ + "name": "Silver", + "metadata": "", + "oracleRequestBatchSize": 1, + "minOracleResults": 1, + "minJobResults": 1, + "minUpdateDelaySeconds": 900, + "jobs": [ + { + "name": "commodities-api XAG", + "tasks": [ + { + "httpTask": { + "url": "https://www.commodities-api.com/api/latest?access_key=${COMMODITIES_API_KEY}&base=USD&symbols=XAG" + } + }, + { + "jsonParseTask": { + "path": "$.data.rates.XAG" + } + }, + { + "powTask": { + "scalar": -1 + } + } + ] + } + ] +} +``` + +
    + +
    + + + +#### Nickel + + + +```json title="Nickel.json" +{ + "name": "Nickel", + "metadata": "", + "oracleRequestBatchSize": 1, + "minOracleResults": 1, + "minJobResults": 1, + "minUpdateDelaySeconds": 900, + "jobs": [ + { + "name": "commodities-api NI", + "tasks": [ + { + "httpTask": { + "url": "https://www.commodities-api.com/api/latest?access_key=${COMMODITIES_API_KEY}&base=USD&symbols=NI" + } + }, + { + "jsonParseTask": { + "path": "$.data.rates.NI" + } + }, + { + "powTask": { + "scalar": -1 + } + } + ] + } + ] +} +``` + +
    + +
    + + + +#### Coffee + + + +```json title="Coffee.json" +{ + "name": "Coffee", + "metadata": "", + "oracleRequestBatchSize": 1, + "minOracleResults": 1, + "minJobResults": 1, + "minUpdateDelaySeconds": 900, + "jobs": [ + { + "name": "commodities-api COFFEE", + "tasks": [ + { + "httpTask": { + "url": "https://www.commodities-api.com/api/latest?access_key=${COMMODITIES_API_KEY}&base=USD&symbols=COFFEE" + } + }, + { + "jsonParseTask": { + "path": "$.data.rates.COFFEE" + } + }, + { + "powTask": { + "scalar": -1 + } + } + ] + } + ] +} +``` + +
    diff --git a/website/docs/randomness/_category_.json b/website/docs/randomness/_category_.json new file mode 100644 index 0000000..5135793 --- /dev/null +++ b/website/docs/randomness/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Randomness", + "position": 40, + "collapsible": true +} diff --git a/website/docs/randomness/architecture.mdx b/website/docs/randomness/architecture.mdx new file mode 100644 index 0000000..c458822 --- /dev/null +++ b/website/docs/randomness/architecture.mdx @@ -0,0 +1,93 @@ +--- +sidebar_position: 1 +slug: . +title: Architecture +description: Learn how to use Switchboard's Verifiable Random Functions +keywords: [Switchboard, Solana, VRF, randomness, verifiable, proof] +--- + +# Randomness Architecture + +import MarkdownImage from "/src/components/MarkdownImage"; +import RandomnessInstructions from "/idl/_randomness_instructions.mdx"; +import { + Typography, + IconButton, + Box, + CardActionArea, + Card, + CardContent, +} from "@mui/material"; +import Link from "@docusaurus/Link"; +import GitHubIcon from "@mui/icons-material/GitHub"; +import VrfAccountData from "/idl/accounts/VrfAccountData.md"; +import VrfInit from "/idl/instructions/vrfInit.md"; +import VrfProve from "/idl/instructions/vrfProve.md"; +import VrfVerify from "/idl/instructions/vrfVerify.md"; +import VrfRequestRandomness from "/idl/instructions/vrfRequestRandomness.md"; + +import CallbackZC from "/idl/types/CallbackZC.md"; + +:::caution + +While Switchboard V2's oracle network is fully audited, the VRF implementation is currently unaudited software. Please use at your own risk. + +::: + +A VRF account is an on-chain account that holds the latest VRF value, as well as its owners specified callback function. When a VRF account owner requests a new randomness value, the oracle queue delegates the update request to an oracle based on its round robin ordering of oracles heartbeating on-chain. The oracle submits its VRF seed on-chain, then must submit 276 transactions to turn the state machine, which computes the proof. When the proof is computed and successfully validates the pseudo-random value, the oracle invokes the account owner’s callback instruction. + +The VRF function return a **_u8[32]_** buffer that can be transmuted to most data types using the [bytemuck crate](https://crates.io/crates/bytemuck). + +```rust +let result_buffer: [u8; 32]; +// get result buffer from parsed VRF Account +msg!("Result buffer is {:?}", result_buffer); +let value: &[u128] = bytemuck::cast_slice(&result_buffer[..]); +msg!("u128 buffer {:?}", value); +let result = value[0] % max_result as u128; +msg!("Current VRF Value [0 - {}) = {}!", max_result, result); +``` + +## Configuration + +:::tip + +See [/idl/accounts/VrfAccountData](/idl/accounts/VrfAccountData) for the full list of an AggregatorAccount's configuration parameters. + +::: + +## Callback + +When creating a VRF Account, the VRF `authority` should specify a `callback` function that will be called by the oracle. VRF Accounts should ensure their `callback` function consumes less than ~160k compute units or it may fail to complete. + + + +## Reward Oracles + +When a VRF Account requests a new random value from a queue, it transfers 0.1 wSOL to it's `escrow` wallet. An oracle receives 90% of the reward when it verifies the proof on-chain and the remaining 10% if the callback succeeds. + +## Update Lifecycle + +- `vrfRequestRandomness` +- check `vrfStatus` +- `tokenTransfer` +- increment counter +- set status to _StatusRequesting_ +- emit `VrfRequestEvent` +- oracle fulfills VRF request +- `vrfProve` +- set status to _StatusVerifying_ +- `vrfVerify` x 277 +- set status to _StatusVerified_ +- 90% `tokenTransfer` +- invoke VRF Callback +- if success + - 10% `tokenTransfer` + - set status to _StatusCallbackSuccess_ +- if failure + - set status to _StatusVerifyFailure_ + +## More Information + +- [/idl/accounts/VrfAccountData](/idl/accounts/VrfAccountData) +- [/developers/randomness](/developers/randomness) diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js index deb54a5..91328bc 100644 --- a/website/docusaurus.config.js +++ b/website/docusaurus.config.js @@ -1,6 +1,9 @@ // @ts-check // Note: type annotations allow type checking and IDEs autocompletion +const math = require("remark-math"); +const katex = require("rehype-katex"); + /** @type {import('@docusaurus/types').Config} */ const config = { title: "Switchboard", @@ -29,6 +32,8 @@ const config = { remarkPlugins: [ [require("@docusaurus/remark-plugin-npm2yarn"), { sync: true }], ], + remarkPlugins: [math], + rehypePlugins: [katex], // editUrl: // process.env.NODE_ENV === "production" // ? process.env.CI_PROJECT_URL + "/-/edit/main/" @@ -48,6 +53,15 @@ const config = { }), ], ], + stylesheets: [ + { + href: "https://cdn.jsdelivr.net/npm/katex@0.13.24/dist/katex.min.css", + type: "text/css", + integrity: + "sha384-odtC+0UGzzFL/6PNoE8rX/SPcQDXBJ+uRepguP4QkPCm2LBxH3FA3y+fKSiJ+AmM", + crossorigin: "anonymous", + }, + ], plugins: [ "my-loaders", [ @@ -115,24 +129,20 @@ const config = { label: "Docs", }, { - to: "idl/", + to: "/idl/", position: "left", label: "IDL", // activeBaseRegex: "docs/(next|v8)", }, { type: "dropdown", - label: "Developers", + label: "APIs", position: "left", - to: "api", + to: "/api/", items: [ - { - label: "Overview", - to: "api/", - }, { label: "Task Protobufs", - to: "api/tasks", + to: "/api/tasks", }, { label: "Typescript", @@ -152,7 +162,7 @@ const config = { }, { label: "CLI", - to: "api/cli", + to: "/api/cli", }, ], }, diff --git a/website/idl/_full_toc.md b/website/idl/_full_toc.md index 9d1ae12..d6c940c 100644 --- a/website/idl/_full_toc.md +++ b/website/idl/_full_toc.md @@ -1,5 +1,6 @@ - [Accounts](/program/accounts/) - [AggregatorAccountData](/idl/accounts/AggregatorAccountData) + - [BufferRelayerAccountData](/idl/accounts/BufferRelayerAccountData) - [CrankAccountData](/idl/accounts/CrankAccountData) - [JobAccountData](/idl/accounts/JobAccountData) - [LeaseAccountData](/idl/accounts/LeaseAccountData) @@ -17,12 +18,16 @@ - [aggregatorSaveResult](/idl/instructions/aggregatorSaveResult) - [aggregatorSetAuthority](/idl/instructions/aggregatorSetAuthority) - [aggregatorSetBatchSize](/idl/instructions/aggregatorSetBatchSize) + - [aggregatorSetForceReportPeriod](/idl/instructions/aggregatorSetForceReportPeriod) - [aggregatorSetHistoryBuffer](/idl/instructions/aggregatorSetHistoryBuffer) - [aggregatorSetMinJobs](/idl/instructions/aggregatorSetMinJobs) - [aggregatorSetMinOracles](/idl/instructions/aggregatorSetMinOracles) - [aggregatorSetQueue](/idl/instructions/aggregatorSetQueue) - [aggregatorSetUpdateInterval](/idl/instructions/aggregatorSetUpdateInterval) - [aggregatorSetVarianceThreshold](/idl/instructions/aggregatorSetVarianceThreshold) + - [bufferRelayerInit](/idl/instructions/bufferRelayerInit) + - [bufferRelayerOpenRound](/idl/instructions/bufferRelayerOpenRound) + - [bufferRelayerSaveResult](/idl/instructions/bufferRelayerSaveResult) - [crankInit](/idl/instructions/crankInit) - [crankPop](/idl/instructions/crankPop) - [crankPush](/idl/instructions/crankPush) @@ -48,9 +53,11 @@ - [vrfRequestRandomness](/idl/instructions/vrfRequestRandomness) - [vrfVerify](/idl/instructions/vrfVerify) - [Events](/program/events) + - [AggregatorCrankEvictionEvent](/idl/events/AggregatorCrankEvictionEvent) - [AggregatorInitEvent](/idl/events/AggregatorInitEvent) - [AggregatorOpenRoundEvent](/idl/events/AggregatorOpenRoundEvent) - [AggregatorValueUpdateEvent](/idl/events/AggregatorValueUpdateEvent) + - [BufferRelayerOpenRoundEvent](/idl/events/BufferRelayerOpenRoundEvent) - [CrankLeaseInsufficientFundsEvent](/idl/events/CrankLeaseInsufficientFundsEvent) - [CrankPopExpectedFailureEvent](/idl/events/CrankPopExpectedFailureEvent) - [FeedPermissionRevokedEvent](/idl/events/FeedPermissionRevokedEvent) @@ -70,29 +77,13 @@ - [Types](/program/types) - [AccountMetaBorsh](/idl/types/AccountMetaBorsh) - [AccountMetaZC](/idl/types/AccountMetaZC) - - AggregatorAddJobParams - [AggregatorHistoryRow](/idl/types/AggregatorHistoryRow) - - AggregatorInitParams - - AggregatorLockParams - - AggregatorOpenRoundParams - - AggregatorRemoveJobParams - [AggregatorRound](/idl/types/AggregatorRound) - - AggregatorSaveResultParams - - AggregatorSetAuthorityParams - - AggregatorSetBatchSizeParams - - AggregatorSetHistoryBufferParams - - AggregatorSetMinJobsParams - - AggregatorSetMinOraclesParams - - AggregatorSetQueueParams - - AggregatorSetUpdateIntervalParams - - AggregatorSetVarianceThresholdParams - [BorshDecimal](/idl/types/BorshDecimal) + - [BufferRelayerRound](/idl/types/BufferRelayerRound) - [Callback](/idl/types/Callback) - [CallbackZC](/idl/types/CallbackZC) - [CompletedPointZC](/idl/types/CompletedPointZC) - - CrankInitParams - - CrankPopParams - - CrankPushParams - [CrankRow](/idl/types/CrankRow) - [EcvrfIntermediate](/idl/types/EcvrfIntermediate) - [EcvrfProofZC](/idl/types/EcvrfProofZC) @@ -100,38 +91,17 @@ - [Error](/idl/types/Error) - [FieldElementZC](/idl/types/FieldElementZC) - [Hash](/idl/types/Hash) - - JobInitParams - [Lanes](/idl/types/Lanes) - [Lanes](/idl/types/Lanes) - - LeaseExtendParams - - LeaseInitParams - - LeaseSetAuthorityParams - - LeaseWithdrawParams - - OracleHeartbeatParams - - OracleInitParams - [OracleMetrics](/idl/types/OracleMetrics) - - OracleQueueInitParams - - OracleQueueSetRewardsParams - - OracleQueueVrfConfigParams - [OracleResponseType](/idl/types/OracleResponseType) - - OracleWithdrawParams - - PermissionInitParams - - PermissionSetParams - - ProgramConfigParams - - ProgramInitParams - [ProjectivePointZC](/idl/types/ProjectivePointZC) - [Scalar](/idl/types/Scalar) - [Shuffle](/idl/types/Shuffle) - [Shuffle](/idl/types/Shuffle) - [SwitchboardDecimal](/idl/types/SwitchboardDecimal) - [SwitchboardPermission](/idl/types/SwitchboardPermission) - - VaultTransferParams - [VrfBuilder](/idl/types/VrfBuilder) - - VrfInitParams - - VrfProveAndVerifyParams - - VrfProveParams - - VrfRequestRandomnessParams - [VrfRound](/idl/types/VrfRound) - [VrfStatus](/idl/types/VrfStatus) - - VrfVerifyParams - [Errors](/program/errors) diff --git a/website/idl/accounts/AggregatorAccountData.md b/website/idl/accounts/AggregatorAccountData.md index 3d7b2fc..83f96da 100644 --- a/website/idl/accounts/AggregatorAccountData.md +++ b/website/idl/accounts/AggregatorAccountData.md @@ -1,32 +1,33 @@ Size: 3851 Bytes
    Rent Exemption: 0.027693840 SOL

    -| Field | Type | Description | -|--|--|--| -| name | u8[32] | Name of the aggregator to store on-chain. | -| metadata | u8[128] | Metadata of the aggregator to store on-chain. | -| authorWallet | publicKey | An optional wallet for receiving kickbacks from job usage in feeds. Defaults to token vault. | -| queuePubkey | publicKey | Pubkey of the queue the aggregator belongs to | -| oracleRequestBatchSize | u32 | Number of oracles assigned to an update request | -| minOracleResults | u32 | Minimum number of oracle responses required before a round is validated. | -| minJobResults | u32 | Minimum number of job results before an oracle accepts a result | -| minUpdateDelaySeconds | u32 | Minimum number of seconds required between aggregator rounds. | -| startAfter | i64 | unix_timestamp for which no feed update will occur before. | -| varianceThreshold | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | Change percentage required between a previous round and the current round. If variance percentage is not met, reject new oracle responses. | -| forceReportPeriod | i64 | Number of seconds for which, even if the variance threshold is not passed, accept new responses from oracles. | -| expiration | i64 | Timestamp when the feed is no longer needed | -| consecutiveFailureCount | u64 | Counter for the number of consecutive failures before a feed is removed from a queue. If set to 0, failed feeds will remain on the queue. | -| nextAllowedUpdateTime | i64 | Timestamp when the next update request will be available | -| isLocked | bool | Flag for whether an aggregators configuration is locked for editing | -| crankPubkey | publicKey | Optional, public key of the crank the aggregator is currently using. Event based feeds do not need a crank. | -| latestConfirmedRound | [AggregatorRound](/idl/types/AggregatorRound) | Latest confirmed update request result that has been accepted as valid. | -| currentRound | [AggregatorRound](/idl/types/AggregatorRound) | Oracle results from the current round of update request that has not been accepted as valid yet | -| jobPubkeysData | publicKey[16] | List of public keys containing the job definitions for how data is sourced off-chain by oracles | -| jobHashes | [Hash](/idl/types/Hash)[16] | Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment | -| jobPubkeysSize | u32 | Number of jobs assigned to an oracle | -| jobsChecksum | u8[32] | Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment | -| authority | publicKey | The account delegated as the authority to for changing configs or withdrawing from a lease. | -| historyBuffer | publicKey | Optional, public key of a history buffer account storing the last N accepted results and their timestamps. | -| previousConfirmedRoundResult | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | | -| previousConfirmedRoundSlot | u64 | | -| disableCrank | bool | | -| ebuf | u8[163] | Reserved | +| Field | Type | Description | +| ---------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | +| name | u8[32] | Name of the aggregator to store on-chain. | +| metadata | u8[128] | Metadata of the aggregator to store on-chain. | +| reserved1 | u8[32] | Reserved. | +| queuePubkey | publicKey | Pubkey of the queue the aggregator belongs to. | +| oracleRequestBatchSize | u32 | Number of oracles assigned to an update request. | +| minOracleResults | u32 | Minimum number of oracle responses required before a round is validated. | +| minJobResults | u32 | Minimum number of job results before an oracle accepts a result. | +| minUpdateDelaySeconds | u32 | Minimum number of seconds required between aggregator rounds. | +| startAfter | i64 | unix_timestamp for which no feed update will occur before. | +| varianceThreshold | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | Change percentage required between a previous round and the current round. If variance percentage is not met, reject new oracle responses. | +| forceReportPeriod | i64 | Number of seconds for which, even if the variance threshold is not passed, accept new responses from oracles. | +| expiration | i64 | Timestamp when the feed is no longer needed. | +| consecutiveFailureCount | u64 | Counter for the number of consecutive failures before a feed is removed from a queue. If set to 0, failed feeds will remain on the queue. | +| nextAllowedUpdateTime | i64 | Timestamp when the next update request will be available. | +| isLocked | bool | Flag for whether an aggregators configuration is locked for editing. | +| crankPubkey | publicKey | Optional, public key of the crank the aggregator is currently using. Event based feeds do not need a crank. | +| latestConfirmedRound | [AggregatorRound](/idl/types/AggregatorRound) | Latest confirmed update request result that has been accepted as valid. | +| currentRound | [AggregatorRound](/idl/types/AggregatorRound) | Oracle results from the current round of update request that has not been accepted as valid yet. | +| jobPubkeysData | publicKey[16] | List of public keys containing the job definitions for how data is sourced off-chain by oracles. | +| jobHashes | [Hash](/idl/types/Hash)[16] | Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment. | +| jobPubkeysSize | u32 | Number of jobs assigned to an oracle. | +| jobsChecksum | u8[32] | Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment. | +| authority | publicKey | The account delegated as the authority for making account changes or withdrawing funds from a lease. | +| historyBuffer | publicKey | Optional, public key of a history buffer account storing the last N accepted results and their timestamps. | +| previousConfirmedRoundResult | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | The previous confirmed round result. | +| previousConfirmedRoundSlot | u64 | The slot when the previous confirmed round was opened. | +| disableCrank | bool | Whether an aggregator is permitted to join a crank. | +| jobWeights | u8[16] | Job weights used for the weighted median of the aggregator's assigned job accounts. | +| ebuf | u8[147] | Reserved. | diff --git a/website/idl/accounts/BufferRelayerAccountData.md b/website/idl/accounts/BufferRelayerAccountData.md new file mode 100644 index 0000000..16b5cd7 --- /dev/null +++ b/website/idl/accounts/BufferRelayerAccountData.md @@ -0,0 +1,13 @@ +| Field | Type | Description | +| --------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| name | u8[32] | Name of the buffer account to store on-chain. | +| queuePubkey | publicKey | Public key of the [OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) that is currently assigned to fulfill buffer relayer update request | +| escrow | publicKey | Token account to reward oracles for completing update request | +| authority | publicKey | The account delegated as the authority for making account changes. | +| jobPubkey | publicKey | Public key of the [JobAccountData](/idl/accounts/JobAccountData) that defines how the buffer relayer is updated | +| jobHash | u8[32] | Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment | +| minUpdateDelaySeconds | u32 | Minimum delay between update request | +| isLocked | bool | Whether buffer relayer config is locked for further changes | +| currentRound | [BufferRelayerRound](/idl/types/BufferRelayerRound) | The current buffer relayer update round that is yet to be confirmed | +| latestConfirmedRound | [BufferRelayerRound](/idl/types/BufferRelayerRound) | The latest confirmed buffer relayer update round | +| result | bytes | The buffer holding the latest confirmed result | diff --git a/website/idl/accounts/CrankAccountData.md b/website/idl/accounts/CrankAccountData.md index 35cbf23..ac6c6b0 100644 --- a/website/idl/accounts/CrankAccountData.md +++ b/website/idl/accounts/CrankAccountData.md @@ -1,12 +1,12 @@ Size: 432 Bytes
    Rent Exemption: 0.003897600 SOL

    -| Field | Type | Description | -|--|--|--| -| name | u8[32] | Name of the crank to store on-chain. | -| metadata | u8[64] | Metadata of the crank to store on-chain. | -| queuePubkey | publicKey | Public key of the oracle queue who owns the crank | -| pqSize | u32 | Number of aggregators added to the crank | -| maxRows | u32 | Maximum number of aggregators allowed to be added to a crank | -| jitterModifier | u8 | Pseudorandom value added to next aggregator update time | -| ebuf | u8[255] | Reserved | -| dataBuffer | publicKey | Public key of the buffer account holding the list of aggregators | +| Field | Type | Description | +| -------------- | --------- | ------------------------------------------------------------------------------------------------------ | +| name | u8[32] | Name of the crank to store on-chain. | +| metadata | u8[64] | Metadata of the crank to store on-chain. | +| queuePubkey | publicKey | Public key of the oracle queue who owns the crank | +| pqSize | u32 | Number of aggregators added to the crank | +| maxRows | u32 | Maximum number of aggregators allowed to be added to a crank | +| jitterModifier | u8 | Pseudorandom value added to next aggregator update time | +| ebuf | u8[255] | Reserved | +| dataBuffer | publicKey | The public key of the CrankBuffer account holding a collection of Aggregator pubkeys and their next allowed update time. | diff --git a/website/idl/accounts/JobAccountData.md b/website/idl/accounts/JobAccountData.md index 57b967a..2ebc331 100644 --- a/website/idl/accounts/JobAccountData.md +++ b/website/idl/accounts/JobAccountData.md @@ -1,12 +1,13 @@ Size: 181 Bytes
    Rent Exemption: 0.002150640 SOL

    -| Field | Type | Description | -|--|--|--| -| name | u8[32] | Name of the job to store on-chain. | -| metadata | u8[64] | Metadata of the job to store on-chain. | -| authorWallet | publicKey | An optional wallet for receiving kickbacks from job usage in feeds. Defaults to token vault. | -| expiration | i64 | Timestamp when the job is considered invalid | -| hash | u8[32] | [Hash](/idl/types/Hash) of the serialized data to prevent tampering | -| data | bytes | Serialized protobuf containing the collection of task to retrieve data off-chain | -| referenceCount | u32 | | -| totalSpent | u128 | | +| Field | Type | Description | +| -------------- | --------- | -------------------------------------------------------------------------------- | +| name | u8[32] | Name of the job to store on-chain. | +| metadata | u8[64] | Metadata of the job to store on-chain. | +| authority | publicKey | The account delegated as the authority for making account changes. | +| expiration | i64 | Timestamp when the job is considered invalid | +| hash | u8[32] | [Hash](/idl/types/Hash) of the serialized data to prevent tampering | +| data | bytes | Serialized protobuf containing the collection of task to retrieve data off-chain | +| referenceCount | u32 | | +| totalSpent | u64 | | +| createdAt | i64 | | diff --git a/website/idl/accounts/OracleAccountData.md b/website/idl/accounts/OracleAccountData.md index 6d50f94..9d71630 100644 --- a/website/idl/accounts/OracleAccountData.md +++ b/website/idl/accounts/OracleAccountData.md @@ -1,13 +1,13 @@ Size: 636 Bytes
    Rent Exemption: 0.00531744 SOL

    -| Field | Type | Description | -|--|--|--| -| name | u8[32] | Name of the oracle to store on-chain. | -| metadata | u8[128] | Metadata of the oracle to store on-chain. | -| oracleAuthority | publicKey | Public key of the authority who owns the oracle account | -| lastHeartbeat | i64 | Timestamp when the oracle last heartbeated | -| numInUse | u32 | Flag dictating if an oracle is active and has heartbeated before the queue's oracle timeout parameter | -| tokenAccount | publicKey | Stake account and reward/slashing wallet | -| queuePubkey | publicKey | Public key of the oracle queue who has granted it permission to use its resources | -| metrics | [OracleMetrics](/idl/types/OracleMetrics) | Oracle track record | -| ebuf | u8[256] | Reserved | +| Field | Type | Description | +| --------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------- | +| name | u8[32] | Name of the oracle to store on-chain. | +| metadata | u8[128] | Metadata of the oracle to store on-chain. | +| oracleAuthority | publicKey | The account delegated as the authority for making account changes or withdrawing funds from a staking wallet. | +| lastHeartbeat | i64 | Timestamp when the oracle last heartbeated | +| numInUse | u32 | Flag dictating if an oracle is active and has heartbeated before the queue's oracle timeout parameter | +| tokenAccount | publicKey | Stake account and reward/slashing wallet | +| queuePubkey | publicKey | Public key of the oracle queue who has granted it permission to use its resources | +| metrics | [OracleMetrics](/idl/types/OracleMetrics) | Oracle track record | +| ebuf | u8[256] | Reserved | diff --git a/website/idl/accounts/OracleQueueAccountData.md b/website/idl/accounts/OracleQueueAccountData.md index 35ace8f..c53de4c 100644 --- a/website/idl/accounts/OracleQueueAccountData.md +++ b/website/idl/accounts/OracleQueueAccountData.md @@ -1,25 +1,27 @@ Size: 1269 Bytes
    Rent Exemption: 0.009723120 SOL

    -| Field | Type | Description | -|--|--|--| -| name | u8[32] | Name of the queue to store on-chain. | -| metadata | u8[64] | Metadata of the queue to store on-chain. | -| authority | publicKey | The account delegated as the authority to for creating permissions targeted at the queue. | -| oracleTimeout | u32 | Time period we should remove an oracle after if no response. | -| reward | u64 | Rewards to provide oracles and round openers on this queue. | -| minStake | u64 | The minimum amount of stake oracles must present to remain on the queue. | -| slashingEnabled | bool | Whether slashing is enabled on this queue. | -| varianceToleranceMultiplier | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | The tolerated variance amount oracle results can have from the accepted round result before being slashed. slashBound = varianceToleranceMultiplier * stdDeviation Default: 2 | -| feedProbationPeriod | u32 | After a feed lease is funded or re-funded, it must consecutively succeed N amount of times or its authorization to use the queue is auto-revoked. | -| currIdx | u32 | Current index of the oracle rotation. | -| size | u32 | Current number of oracles on a queue. | -| gcIdx | u32 | Garbage collection index. | -| consecutiveFeedFailureLimit | u64 | Consecutive failure limit for a feed before feed permission is revoked. | -| consecutiveOracleFailureLimit | u64 | Consecutive failure limit for an oracle before oracle permission is revoked. | -| unpermissionedFeedsEnabled | bool | Enabling this setting means data feeds do not need explicit permission to join the queue and request new values from its oracles. | -| unpermissionedVrfEnabled | bool | Enabling this setting means VRF accounts do not need explicit permission to join the queue and request new values from its oracles. | -| curatorRewardCut | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | | -| lockLeaseFunding | bool | | -| ebuf | u8[1001] | Reserved. | -| maxSize | u32 | Maximum number of oracles a queue can support. | -| dataBuffer | publicKey | Pubkey of the on-chain account holding the queue data. | +| Field | Type | Description | +| ----------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| name | u8[32] | Name of the queue to store on-chain. | +| metadata | u8[64] | Metadata of the queue to store on-chain. | +| authority | publicKey | The account delegated as the authority for making account changes or assigning permissions targeted at the queue. | +| oracleTimeout | u32 | Time period we should remove an oracle after if no response. | +| reward | u64 | Rewards to provide oracles and round openers on this queue. | +| minStake | u64 | The minimum amount of stake oracles must present to remain on the queue. | +| slashingEnabled | bool | Whether slashing is enabled on this queue. | +| varianceToleranceMultiplier | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | The tolerated variance amount oracle results can have from the accepted round result before being slashed. slashBound = varianceToleranceMultiplier \* stdDeviation Default: 2 | +| feedProbationPeriod | u32 | After a feed lease is funded or re-funded, it must consecutively succeed N amount of times or its authorization to use the queue is auto-revoked. | +| currIdx | u32 | Current index of the oracle rotation. | +| size | u32 | Current number of oracles on a queue. | +| gcIdx | u32 | Garbage collection index. | +| consecutiveFeedFailureLimit | u64 | Consecutive failure limit for a feed before feed permission is revoked. | +| consecutiveOracleFailureLimit | u64 | Consecutive failure limit for an oracle before oracle permission is revoked. | +| unpermissionedFeedsEnabled | bool | Enabling this setting means data feeds do not need explicit permission to join the queue and request new values from its oracles. | +| unpermissionedVrfEnabled | bool | Enabling this setting means VRF accounts do not need explicit permission to join the queue and request new values from its oracles. | +| curatorRewardCut | [SwitchboardDecimal](/idl/types/SwitchboardDecimal) | | +| lockLeaseFunding | bool | | +| mint | publicKey | Token mint used for the oracle queue rewards and slashing. | +| enableBufferRelayers | bool | Whether oracles are permitted to fulfill buffer relayer update request. | +| ebuf | u8[968] | Reserved. | +| maxSize | u32 | Maximum number of oracles a queue can support. | +| dataBuffer | publicKey | The public key of the OracleQueueBuffer account holding a collection of Oracle pubkeys that haver succesfully heartbeated before the queues `oracleTimeout`. | diff --git a/website/idl/accounts/PermissionAccountData.md b/website/idl/accounts/PermissionAccountData.md index f9a54e3..8e95232 100644 --- a/website/idl/accounts/PermissionAccountData.md +++ b/website/idl/accounts/PermissionAccountData.md @@ -3,7 +3,7 @@ | Field | Type | Description | |--|--|--| | authority | publicKey | The authority that is allowed to set permissions for this account. | -| permissions | u32 | The current assigned permission enumeration | +| permissions | u32 | The [SwitchboardPermission](/idl/types/SwitchboardPermission) enumeration assigned by the `granter` to the `grantee`. | | granter | publicKey | Public key of account that is granting permissions to use its resources. | | grantee | publicKey | Public key of account that is being assigned permissions to use a granters resources. | | expiration | i64 | Timestamp when the permissions expire. | diff --git a/website/idl/accounts/SbState.md b/website/idl/accounts/SbState.md index ea96e66..e0d0848 100644 --- a/website/idl/accounts/SbState.md +++ b/website/idl/accounts/SbState.md @@ -5,4 +5,5 @@ | authority | publicKey | The account authority permitted to make account changes. | | tokenMint | publicKey | The token mint used for oracle rewards, aggregator leases, and other reward incentives. | | tokenVault | publicKey | Token vault used by the program to receive kickbacks. | -| ebuf | u8[1024] | Reserved. | +| daoMint | publicKey | The token mint used by the DAO. | +| ebuf | u8[992] | Reserved. | diff --git a/website/idl/accounts/VrfAccountData.md b/website/idl/accounts/VrfAccountData.md index b0c5a79..5c71a5a 100644 --- a/website/idl/accounts/VrfAccountData.md +++ b/website/idl/accounts/VrfAccountData.md @@ -2,15 +2,15 @@ | Field | Type | Description | |--|--|--| -| status | [VrfStatus](/idl/types/VrfStatus) | | -| counter | u128 | Incremental counter for current round. | -| authority | publicKey | | -| oracleQueue | publicKey | | -| escrow | publicKey | | -| callback | [CallbackZC](/idl/types/CallbackZC) | | -| batchSize | u32 | | -| builders | [VrfBuilder](/idl/types/VrfBuilder)[8] | | -| buildersLen | u32 | | +| status | [VrfStatus](/idl/types/VrfStatus) | The current status of the VRF account. | +| counter | u128 | Incremental counter for tracking VRF rounds. | +| authority | publicKey | On-chain account delegated for making account changes. | +| oracleQueue | publicKey | The [OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) that is assigned to fulfill VRF update request. | +| escrow | publicKey | The token account used to hold funds for VRF update request. | +| callback | [CallbackZC](/idl/types/CallbackZC) | The callback that is invoked when an update request is succesfully verified. | +| batchSize | u32 | The number of oracles assigned to a VRF update request. | +| builders | [VrfBuilder](/idl/types/VrfBuilder)[8] | Struct containing the intermediate state between VRF crank actions. | +| buildersLen | u32 | The number of builders. | | testMode | bool | | | currentRound | [VrfRound](/idl/types/VrfRound) | Oracle results from the current round of update request that has not been accepted as valid yet | | ebuf | u8[1024] | Reserved. | diff --git a/website/idl/accounts/overview.md b/website/idl/accounts/overview.md index 104e264..313b92e 100644 --- a/website/idl/accounts/overview.md +++ b/website/idl/accounts/overview.md @@ -5,6 +5,7 @@ slug: . --- - [AggregatorAccountData](/idl/accounts/AggregatorAccountData) +- [BufferRelayerAccountData](/idl/accounts/BufferRelayerAccountData) - [CrankAccountData](/idl/accounts/CrankAccountData) - [JobAccountData](/idl/accounts/JobAccountData) - [LeaseAccountData](/idl/accounts/LeaseAccountData) diff --git a/website/idl/descriptions.json b/website/idl/descriptions.json index d3fbe05..0c102c8 100644 --- a/website/idl/descriptions.json +++ b/website/idl/descriptions.json @@ -13,16 +13,16 @@ "description": "Metadata of the aggregator to store on-chain." }, { - "name": "authorWallet", - "description": "An optional wallet for receiving kickbacks from job usage in feeds. Defaults to token vault." + "name": "reserved1", + "description": "Reserved." }, { "name": "queuePubkey", - "description": "Pubkey of the queue the aggregator belongs to" + "description": "Pubkey of the queue the aggregator belongs to." }, { "name": "oracleRequestBatchSize", - "description": "Number of oracles assigned to an update request" + "description": "Number of oracles assigned to an update request." }, { "name": "minOracleResults", @@ -30,7 +30,7 @@ }, { "name": "minJobResults", - "description": "Minimum number of job results before an oracle accepts a result" + "description": "Minimum number of job results before an oracle accepts a result." }, { "name": "minUpdateDelaySeconds", @@ -50,7 +50,7 @@ }, { "name": "expiration", - "description": "Timestamp when the feed is no longer needed" + "description": "Timestamp when the feed is no longer needed." }, { "name": "consecutiveFailureCount", @@ -58,11 +58,11 @@ }, { "name": "nextAllowedUpdateTime", - "description": "Timestamp when the next update request will be available" + "description": "Timestamp when the next update request will be available." }, { "name": "isLocked", - "description": "Flag for whether an aggregators configuration is locked for editing" + "description": "Flag for whether an aggregators configuration is locked for editing." }, { "name": "crankPubkey", @@ -74,35 +74,101 @@ }, { "name": "currentRound", - "description": "Oracle results from the current round of update request that has not been accepted as valid yet" + "description": "Oracle results from the current round of update request that has not been accepted as valid yet." }, { "name": "jobPubkeysData", - "description": "List of public keys containing the job definitions for how data is sourced off-chain by oracles" + "description": "List of public keys containing the job definitions for how data is sourced off-chain by oracles." }, { "name": "jobHashes", - "description": "Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment" + "description": "Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment." }, { "name": "jobPubkeysSize", - "description": "Number of jobs assigned to an oracle" + "description": "Number of jobs assigned to an oracle." }, { "name": "jobsChecksum", - "description": "Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment" + "description": "Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment." }, { "name": "authority", - "description": "The account delegated as the authority to for changing configs or withdrawing from a lease." + "description": "The account delegated as the authority for making account changes or withdrawing funds from a lease." }, { "name": "historyBuffer", "description": "Optional, public key of a history buffer account storing the last N accepted results and their timestamps." }, + { + "name": "previousConfirmedRoundResult", + "description": "The previous confirmed round result." + }, + { + "name": "previousConfirmedRoundSlot", + "description": "The slot when the previous confirmed round was opened." + }, + { + "name": "disableCrank", + "description": "Whether an aggregator is permitted to join a crank." + }, + { + "name": "jobWeights", + "description": "Job weights used for the weighted median of the aggregator's assigned job accounts." + }, { "name": "ebuf", - "description": "Reserved" + "description": "Reserved." + } + ] + }, + { + "name": "BufferRelayerAccountData", + "description": "", + "children": [ + { + "name": "name", + "description": "Name of the buffer account to store on-chain." + }, + { + "name": "queuePubkey", + "description": "Public key of the OracleQueueAccountData that is currently assigned to fulfill buffer relayer update request" + }, + { + "name": "escrow", + "description": "Token account to reward oracles for completing update request" + }, + { + "name": "authority", + "description": "The account delegated as the authority for making account changes." + }, + { + "name": "jobPubkey", + "description": "Public key of the JobAccountData that defines how the buffer relayer is updated" + }, + { + "name": "jobHash", + "description": "Used to protect against malicious RPC nodes providing incorrect task definitions to oracles before fulfillment" + }, + { + "name": "minUpdateDelaySeconds", + "description": "Minimum delay between update request" + }, + { + "name": "isLocked", + "description": "Whether buffer relayer config is locked for further changes" + }, + { + "name": "currentRound", + "description": "The current buffer relayer update round that is yet to be confirmed" + }, + { + "name": "latestConfirmedRound", + "description": "The latest confirmed buffer relayer update round" + }, + { + "name": "result", + "description": "The buffer holding the latest confirmed result" } ] }, @@ -140,7 +206,7 @@ }, { "name": "dataBuffer", - "description": "Public key of the buffer account holding the list of aggregators" + "description": " The public key of the CrankBuffer account holding a collection of Aggregator pubkeys and their next allowed update time." } ] }, @@ -156,6 +222,10 @@ "name": "metadata", "description": "Metadata of the job to store on-chain." }, + { + "name": "authority", + "description": "The account delegated as the authority for making account changes." + }, { "name": "authorWallet", "description": "An optional wallet for receiving kickbacks from job usage in feeds. Defaults to token vault." @@ -238,7 +308,7 @@ }, { "name": "oracleAuthority", - "description": "Public key of the authority who owns the oracle account" + "description": "The account delegated as the authority for making account changes or withdrawing funds from a staking wallet." }, { "name": "lastHeartbeat", @@ -280,7 +350,7 @@ }, { "name": "authority", - "description": "The account delegated as the authority to for creating permissions targeted at the queue." + "description": "The account delegated as the authority for making account changes or assigning permissions targeted at the queue." }, { "name": "oracleTimeout", @@ -334,6 +404,22 @@ "name": "unpermissionedVrfEnabled", "description": "Enabling this setting means VRF accounts do not need explicit permission to join the queue and request new values from its oracles." }, + { + "name": "curatorRewardCut", + "description": "" + }, + { + "name": "lockLeaseFunding", + "description": "" + }, + { + "name": "mint", + "description": "Token mint used for the oracle queue rewards and slashing." + }, + { + "name": "enableBufferRelayers", + "description": "Whether oracles are permitted to fulfill buffer relayer update request." + }, { "name": "ebuf", "description": "Reserved." @@ -344,7 +430,7 @@ }, { "name": "dataBuffer", - "description": "Pubkey of the on-chain account holding the queue data." + "description": "The public key of the OracleQueueBuffer account holding a collection of Oracle pubkeys that haver succesfully heartbeated before the queues `oracleTimeout`." } ] }, @@ -358,7 +444,7 @@ }, { "name": "permissions", - "description": "The current assigned permission enumeration" + "description": "The SwitchboardPermission enumeration assigned by the `granter` to the `grantee`." }, { "name": "granter", @@ -394,6 +480,10 @@ "name": "tokenVault", "description": "Token vault used by the program to receive kickbacks." }, + { + "name": "daoMint", + "description": "The token mint used by the DAO." + }, { "name": "ebuf", "description": "Reserved." @@ -405,12 +495,40 @@ "description": "Size: 29058 Bytes
    Rent Exemption: 0.203134560SOL

    ", "children": [ { - "name": "counter", - "description": "Incremental counter for current round." + "name": "status", + "description": "The current status of the VRF account." }, { - "name": "latestFinalizedRound", - "description": "Latest confirmed update request result that has been accepted as valid." + "name": "counter", + "description": "Incremental counter for tracking VRF rounds." + }, + { + "name": "authority", + "description": "On-chain account delegated for making account changes." + }, + { + "name": "oracleQueue", + "description": "The OracleQueueAccountData that is assigned to fulfill VRF update request." + }, + { + "name": "escrow", + "description": "The token account used to hold funds for VRF update request." + }, + { + "name": "callback", + "description": "The callback that is invoked when an update request is succesfully verified." + }, + { + "name": "batchSize", + "description": "The number of oracles assigned to a VRF update request." + }, + { + "name": "builders", + "description": "Struct containing the intermediate state between VRF crank actions." + }, + { + "name": "buildersLen", + "description": "The number of builders." }, { "name": "currentRound", @@ -489,7 +607,7 @@ }, { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." } ] }, @@ -504,7 +622,7 @@ "children": [ { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "leaseBump", @@ -634,7 +752,7 @@ }, { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." } ] }, @@ -707,6 +825,32 @@ } ] }, + { + "name": "BufferRelayerRound", + "description": "", + "children": [ + { + "name": "numSuccess", + "description": "Number of successful responses" + }, + { + "name": "numError", + "description": "Number of error responses" + }, + { + "name": "roundOpenSlot", + "description": "Slot when the buffer relayer round was opened" + }, + { + "name": "roundOpenTimestamp", + "description": "Timestamp when the buffer relayer round was opened" + }, + { + "name": "oraclePubkey", + "description": "The public key of the oracle fulfilling the buffer relayer update request" + } + ] + }, { "name": "CallbackZC", "description": "", @@ -757,7 +901,7 @@ "children": [ { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "leaseBumps", @@ -783,7 +927,7 @@ "children": [ { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "permissionBump", @@ -865,7 +1009,7 @@ }, { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "data", @@ -887,7 +1031,7 @@ }, { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." } ] }, @@ -909,7 +1053,7 @@ }, { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." } ] }, @@ -919,7 +1063,7 @@ "children": [ { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "leaseBump", @@ -955,7 +1099,7 @@ }, { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "oracleBump", @@ -1097,7 +1241,7 @@ "children": [ { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "permissionBump", @@ -1153,7 +1297,7 @@ "children": [ { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." } ] }, @@ -1199,7 +1343,7 @@ "children": [ { "name": "stateBump", - "description": "" + "description": "The SbState bump used to derive its public key." }, { "name": "amount", @@ -1207,6 +1351,194 @@ } ] }, + { + "name": "VrfBuilder", + "description": "", + "children": [ + { + "name": "producer", + "description": "" + }, + { + "name": "status", + "description": "" + }, + { + "name": "reprProof", + "description": "" + }, + { + "name": "proof", + "description": "" + }, + { + "name": "yPoint", + "description": "" + }, + { + "name": "stage", + "description": "" + }, + { + "name": "stage1Out", + "description": "" + }, + { + "name": "r1", + "description": "" + }, + { + "name": "r2", + "description": "" + }, + { + "name": "stage3Out", + "description": "" + }, + { + "name": "hPoint", + "description": "" + }, + { + "name": "sReduced", + "description": "" + }, + { + "name": "yPointBuilder", + "description": "" + }, + { + "name": "yRistrettoPoint", + "description": "" + }, + { + "name": "mulRound", + "description": "" + }, + { + "name": "hashPointsRound", + "description": "" + }, + { + "name": "mulTmp1", + "description": "" + }, + { + "name": "uPoint1", + "description": "" + }, + { + "name": "uPoint2", + "description": "" + }, + { + "name": "vPoint1", + "description": "" + }, + { + "name": "vPoint2", + "description": "" + }, + { + "name": "uPoint", + "description": "" + }, + { + "name": "vPoint", + "description": "" + }, + { + "name": "u1", + "description": "" + }, + { + "name": "u2", + "description": "" + }, + { + "name": "invertee", + "description": "" + }, + { + "name": "y", + "description": "" + }, + { + "name": "z", + "description": "" + }, + { + "name": "p1Bytes", + "description": "" + }, + { + "name": "p2Bytes", + "description": "" + }, + { + "name": "p3Bytes", + "description": "" + }, + { + "name": "p4Bytes", + "description": "" + }, + { + "name": "cPrimeHashbuf", + "description": "" + }, + { + "name": "m1", + "description": "" + }, + { + "name": "m2", + "description": "" + }, + { + "name": "txRemaining", + "description": "" + }, + { + "name": "verified", + "description": "" + }, + { + "name": "result", + "description": "" + } + ] + }, + { + "name": "VrfStatus", + "description": "", + "children": [ + { + "name": "StatusNone", + "description": "" + }, + { + "name": "StatusRequesting", + "description": "" + }, + { + "name": "StatusVerifying", + "description": "" + }, + { + "name": "StatusVerified", + "description": "" + }, + { + "name": "StatusCallbackSuccess", + "description": "" + }, + { + "name": "StatusVerifyFailure", + "description": "" + } + ] + }, { "name": "VrfRound", "description": "", @@ -1355,7 +1687,7 @@ }, { "name": "dataBuffer", - "description": "The OracleQueueBuffer account holding a collection of Oracle pubkeys." + "description": "The public key of the OracleQueueBuffer account holding a collection of Oracle pubkeys that haver succesfully heartbeated before the queues `oracleTimeout`." }, { "name": "tokenProgram", @@ -1629,7 +1961,7 @@ }, { "name": "queueAuthority", - "description": "The account delegated as the authority to for creating permissions targeted at the queue." + "description": "The account delegated as the authority for making account changes or assigning permissions targeted at the queue." }, { "name": "programState", @@ -1675,7 +2007,7 @@ }, { "name": "queueAuthority", - "description": "The account delegated as the authority to for creating permissions targeted at the queue." + "description": "The account delegated as the authority for making account changes or assigning permissions targeted at the queue." }, { "name": "permission", @@ -1959,7 +2291,7 @@ }, { "name": "authority", - "description": "The account delegated as the authority to for creating permissions targeted at the queue." + "description": "The account delegated as the authority for making account changes or assigning permissions targeted at the queue." }, { "name": "buffer", @@ -1989,7 +2321,7 @@ }, { "name": "authority", - "description": "The account delegated as the authority to for creating permissions targeted at the queue." + "description": "The account delegated as the authority for making account changes or assigning permissions targeted at the queue." }, { "name": "params", @@ -2375,7 +2707,7 @@ }, { "name": "queueAuthority", - "description": "The account delegated as the authority to for creating permissions targeted at the queue." + "description": "The account delegated as the authority for making account changes or assigning permissions targeted at the queue." } ] }, diff --git a/website/idl/errors.md b/website/idl/errors.md index 6de314d..a5e6d28 100644 --- a/website/idl/errors.md +++ b/website/idl/errors.md @@ -5,82 +5,92 @@ title: Errors ## Anchor Errors -See [docs.rs/anchor-lang/latest/anchor_lang/error](https://docs.rs/anchor-lang/latest/anchor_lang/error/enum.ErrorCode.html) for a list of built-in Anchor errors. +See [@project-serum/anchor/src/error.ts#L53](https://github.com/project-serum/anchor/blob/HEAD/ts/src/error.ts#L53) for a list of built-in Anchor errors. ## Switchboard Errors -| Code | Hex | Name | Message | -| ---- | -------- | -------------------------------- | --------------------------------------------------------------------------- | -| 6000 | 0x0x1770 | ArrayOperationError | Illegal operation on a Switchboard array. | -| 6001 | 0x0x1771 | QueueOperationError | Illegal operation on a Switchboard queue. | -| 6002 | 0x0x1772 | IncorrectProgramOwnerError | An account required to be owned by the program has a different owner. | -| 6003 | 0x0x1773 | InvalidAggregatorRound | Aggregator is not currently populated with a valid round. | -| 6004 | 0x0x1774 | TooManyAggregatorJobs | Aggregator cannot fit any more jobs. | -| 6005 | 0x0x1775 | AggregatorCurrentRoundClosed | Aggregator's current round is closed. No results are being accepted. | -| 6006 | 0x0x1776 | AggregatorInvalidSaveResult | Aggregator received an invalid save result instruction. | -| 6007 | 0x0x1777 | InvalidStrDecimalConversion | Failed to convert string to decimal format. | -| 6008 | 0x0x1778 | AccountLoaderMissingSignature | AccountLoader account is missing a required signature. | -| 6009 | 0x0x1779 | MissingRequiredSignature | Account is missing a required signature. | -| 6010 | 0x0x177a | ArrayOverflowError | The attempted action will overflow a zero-copy account array. | -| 6011 | 0x0x177b | ArrayUnderflowError | The attempted action will underflow a zero-copy account array. | -| 6012 | 0x0x177c | PubkeyNotFoundError | The queried public key was not found. | -| 6013 | 0x0x177d | AggregatorIllegalRoundOpenCall | Aggregator round open called too early. | -| 6014 | 0x0x177e | AggregatorIllegalRoundCloseCall | Aggregator round close called too early. | -| 6015 | 0x0x177f | AggregatorClosedError | Aggregator is closed. Illegal action. | -| 6016 | 0x0x1780 | IllegalOracleIdxError | Illegal oracle index. | -| 6017 | 0x0x1781 | OracleAlreadyRespondedError | The provided oracle has already responded this round. | -| 6018 | 0x0x1782 | ProtoDeserializeError | Failed to deserialize protocol buffer. | -| 6019 | 0x0x1783 | UnauthorizedStateUpdateError | Unauthorized program state modification attempted. | -| 6020 | 0x0x1784 | MissingOracleAccountsError | Not enough oracle accounts provided to closeRounds. | -| 6021 | 0x0x1785 | OracleMismatchError | An unexpected oracle account was provided for the transaction. | -| 6022 | 0x0x1786 | CrankMaxCapacityError | Attempted to push to a Crank that's at capacity | -| 6023 | 0x0x1787 | AggregatorLeaseInsufficientFunds | Aggregator update call attempted but attached lease has insufficient funds. | -| 6024 | 0x0x1788 | IncorrectTokenAccountMint | The provided token account does not point to the Switchboard token mint. | -| 6025 | 0x0x1789 | InvalidEscrowAccount | An invalid escrow account was provided. | -| 6026 | 0x0x178a | CrankEmptyError | Crank empty. Pop failed. | -| 6027 | 0x0x178b | PdaDeriveError | Failed to derive a PDA from the provided seed. | -| 6028 | 0x0x178c | AggregatorAccountNotFound | Aggregator account missing from provided account list. | -| 6029 | 0x0x178d | PermissionAccountNotFound | Permission account missing from provided account list. | -| 6030 | 0x0x178e | LeaseAccountDeriveFailure | Failed to derive a lease account. | -| 6031 | 0x0x178f | PermissionAccountDeriveFailure | Failed to derive a permission account. | -| 6032 | 0x0x1790 | EscrowAccountNotFound | Escrow account missing from provided account list. | -| 6033 | 0x0x1791 | LeaseAccountNotFound | Lease account missing from provided account list. | -| 6034 | 0x0x1792 | DecimalConversionError | Decimal conversion method failed. | -| 6035 | 0x0x1793 | PermissionDenied | Permission account is missing required flags for the given action. | -| 6036 | 0x0x1794 | QueueAtCapacity | Oracle queue is at lease capacity. | -| 6037 | 0x0x1795 | ExcessiveCrankRowsError | Data feed is already pushed on a crank. | -| 6038 | 0x0x1796 | AggregatorLockedError | Aggregator is locked, no setting modifications or job additions allowed. | -| 6039 | 0x0x1797 | AggregatorInvalidBatchSizeError | Aggregator invalid batch size. | -| 6040 | 0x0x1798 | AggregatorJobChecksumMismatch | Oracle provided an incorrect aggregator job checksum. | -| 6041 | 0x0x1799 | IntegerOverflowError | An integer overflow occurred. | -| 6042 | 0x0x179a | InvalidUpdatePeriodError | Minimum update period is 5 seconds. | -| 6043 | 0x0x179b | NoResultsError | Aggregator round evaluation attempted with no results. | -| 6044 | 0x0x179c | InvalidExpirationError | An expiration constraint was broken. | -| 6045 | 0x0x179d | InsufficientStakeError | An account provided insufficient stake for action. | -| 6046 | 0x0x179e | LeaseInactiveError | The provided lease account is not active. | -| 6047 | 0x0x179f | NoAggregatorJobsFound | No jobs are currently included in the aggregator. | -| 6048 | 0x0x17a0 | IntegerUnderflowError | An integer underflow occurred. | -| 6049 | 0x0x17a1 | OracleQueueMismatch | An invalid oracle queue account was provided. | -| 6050 | 0x0x17a2 | OracleWalletMismatchError | An unexpected oracle wallet account was provided for the transaction. | -| 6051 | 0x0x17a3 | InvalidBufferAccountError | An invalid buffer account was provided. | -| 6052 | 0x0x17a4 | InsufficientOracleQueueError | Insufficient oracle queue size. | -| 6053 | 0x0x17a5 | InvalidAuthorityError | Invalid authority account provided. | -| 6054 | 0x0x17a6 | InvalidTokenAccountMintError | A provided token wallet is associated with an incorrect mint. | -| 6055 | 0x0x17a7 | ExcessiveLeaseWithdrawlError | You must leave enough funds to perform at least 1 update in the lease. | -| 6056 | 0x0x17a8 | InvalideHistoryAccountError | Invalid history account provided. | -| 6057 | 0x0x17a9 | InvalidLeaseAccountEscrowError | Invalid lease account escrow. | -| 6058 | 0x0x17aa | InvalidCrankAccountError | Invalid crank provided. | -| 6059 | 0x0x17ab | CrankNoElementsReadyError | No elements ready to be popped. | -| 6060 | 0x0x17ac | IndexOutOfBoundsError | Index out of bounds | -| 6061 | 0x0x17ad | VrfInvalidRequestError | Invalid vrf request params | -| 6062 | 0x0x17ae | VrfInvalidProofSubmissionError | Vrf proof failed to verify | -| 6063 | 0x0x17af | VrfVerifyError | Error in verifying vrf proof. | -| 6064 | 0x0x17b0 | VrfCallbackError | Vrf callback function failed. | -| 6065 | 0x0x17b1 | VrfCallbackParamsError | Invalid vrf callback params provided. | -| 6066 | 0x0x17b2 | VrfCallbackAlreadyCalledError | Vrf callback has already been triggered. | -| 6067 | 0x0x17b3 | VrfInvalidPubkeyError | The provided pubkey is invalid to use in ecvrf proofs | -| 6068 | 0x0x17b4 | VrfTooManyVerifyCallsError | Number of required verify calls exceeded | -| 6069 | 0x0x17b5 | VrfRequestAlreadyLaunchedError | Vrf request is already pending | -| 6070 | 0x0x17b6 | VrfInsufficientVerificationError | Insufficient amount of proofs collected for VRF callback | -| 6071 | 0x0x17b7 | InvalidVrfProducerError | An incorrect oracle attempted to submit a proof | -| 6072 | 0x0x17b8 | NoopError | Noop error | +| Code | Hex | Name | Message | +| ---- | ------ | -------------------------------- | --------------------------------------------------------------------------- | +| 6000 | 0x1770 | ArrayOperationError | Illegal operation on a Switchboard array. | +| 6001 | 0x1771 | QueueOperationError | Illegal operation on a Switchboard queue. | +| 6002 | 0x1772 | IncorrectProgramOwnerError | An account required to be owned by the program has a different owner. | +| 6003 | 0x1773 | InvalidAggregatorRound | Aggregator is not currently populated with a valid round. | +| 6004 | 0x1774 | TooManyAggregatorJobs | Aggregator cannot fit any more jobs. | +| 6005 | 0x1775 | AggregatorCurrentRoundClosed | Aggregator's current round is closed. No results are being accepted. | +| 6006 | 0x1776 | AggregatorInvalidSaveResult | Aggregator received an invalid save result instruction. | +| 6007 | 0x1777 | InvalidStrDecimalConversion | Failed to convert string to decimal format. | +| 6008 | 0x1778 | AccountLoaderMissingSignature | AccountLoader account is missing a required signature. | +| 6009 | 0x1779 | MissingRequiredSignature | Account is missing a required signature. | +| 6010 | 0x177a | ArrayOverflowError | The attempted action will overflow a zero-copy account array. | +| 6011 | 0x177b | ArrayUnderflowError | The attempted action will underflow a zero-copy account array. | +| 6012 | 0x177c | PubkeyNotFoundError | The queried public key was not found. | +| 6013 | 0x177d | AggregatorIllegalRoundOpenCall | Aggregator round open called too early. | +| 6014 | 0x177e | AggregatorIllegalRoundCloseCall | Aggregator round close called too early. | +| 6015 | 0x177f | AggregatorClosedError | Aggregator is closed. Illegal action. | +| 6016 | 0x1780 | IllegalOracleIdxError | Illegal oracle index. | +| 6017 | 0x1781 | OracleAlreadyRespondedError | The provided oracle has already responded this round. | +| 6018 | 0x1782 | ProtoDeserializeError | Failed to deserialize protocol buffer. | +| 6019 | 0x1783 | UnauthorizedStateUpdateError | Unauthorized program state modification attempted. | +| 6020 | 0x1784 | MissingOracleAccountsError | Not enough oracle accounts provided to closeRounds. | +| 6021 | 0x1785 | OracleMismatchError | An unexpected oracle account was provided for the transaction. | +| 6022 | 0x1786 | CrankMaxCapacityError | Attempted to push to a Crank that's at capacity | +| 6023 | 0x1787 | AggregatorLeaseInsufficientFunds | Aggregator update call attempted but attached lease has insufficient funds. | +| 6024 | 0x1788 | IncorrectTokenAccountMint | The provided token account does not point to the Switchboard token mint. | +| 6025 | 0x1789 | InvalidEscrowAccount | An invalid escrow account was provided. | +| 6026 | 0x178a | CrankEmptyError | Crank empty. Pop failed. | +| 6027 | 0x178b | PdaDeriveError | Failed to derive a PDA from the provided seed. | +| 6028 | 0x178c | AggregatorAccountNotFound | Aggregator account missing from provided account list. | +| 6029 | 0x178d | PermissionAccountNotFound | Permission account missing from provided account list. | +| 6030 | 0x178e | LeaseAccountDeriveFailure | Failed to derive a lease account. | +| 6031 | 0x178f | PermissionAccountDeriveFailure | Failed to derive a permission account. | +| 6032 | 0x1790 | EscrowAccountNotFound | Escrow account missing from provided account list. | +| 6033 | 0x1791 | LeaseAccountNotFound | Lease account missing from provided account list. | +| 6034 | 0x1792 | DecimalConversionError | Decimal conversion method failed. | +| 6035 | 0x1793 | PermissionDenied | Permission account is missing required flags for the given action. | +| 6036 | 0x1794 | QueueAtCapacity | Oracle queue is at lease capacity. | +| 6037 | 0x1795 | ExcessiveCrankRowsError | Data feed is already pushed on a crank. | +| 6038 | 0x1796 | AggregatorLockedError | Aggregator is locked, no setting modifications or job additions allowed. | +| 6039 | 0x1797 | AggregatorInvalidBatchSizeError | Aggregator invalid batch size. | +| 6040 | 0x1798 | AggregatorJobChecksumMismatch | Oracle provided an incorrect aggregator job checksum. | +| 6041 | 0x1799 | IntegerOverflowError | An integer overflow occurred. | +| 6042 | 0x179a | InvalidUpdatePeriodError | Minimum update period is 5 seconds. | +| 6043 | 0x179b | NoResultsError | Aggregator round evaluation attempted with no results. | +| 6044 | 0x179c | InvalidExpirationError | An expiration constraint was broken. | +| 6045 | 0x179d | InsufficientStakeError | An account provided insufficient stake for action. | +| 6046 | 0x179e | LeaseInactiveError | The provided lease account is not active. | +| 6047 | 0x179f | NoAggregatorJobsFound | No jobs are currently included in the aggregator. | +| 6048 | 0x17a0 | IntegerUnderflowError | An integer underflow occurred. | +| 6049 | 0x17a1 | OracleQueueMismatch | An invalid oracle queue account was provided. | +| 6050 | 0x17a2 | OracleWalletMismatchError | An unexpected oracle wallet account was provided for the transaction. | +| 6051 | 0x17a3 | InvalidBufferAccountError | An invalid buffer account was provided. | +| 6052 | 0x17a4 | InsufficientOracleQueueError | Insufficient oracle queue size. | +| 6053 | 0x17a5 | InvalidAuthorityError | Invalid authority account provided. | +| 6054 | 0x17a6 | InvalidTokenAccountMintError | A provided token wallet is associated with an incorrect mint. | +| 6055 | 0x17a7 | ExcessiveLeaseWithdrawlError | You must leave enough funds to perform at least 1 update in the lease. | +| 6056 | 0x17a8 | InvalideHistoryAccountError | Invalid history account provided. | +| 6057 | 0x17a9 | InvalidLeaseAccountEscrowError | Invalid lease account escrow. | +| 6058 | 0x17aa | InvalidCrankAccountError | Invalid crank provided. | +| 6059 | 0x17ab | CrankNoElementsReadyError | No elements ready to be popped. | +| 6060 | 0x17ac | IndexOutOfBoundsError | Index out of bounds | +| 6061 | 0x17ad | VrfInvalidRequestError | Invalid vrf request params | +| 6062 | 0x17ae | VrfInvalidProofSubmissionError | Vrf proof failed to verify | +| 6063 | 0x17af | VrfVerifyError | Error in verifying vrf proof. | +| 6064 | 0x17b0 | VrfCallbackError | Vrf callback function failed. | +| 6065 | 0x17b1 | VrfCallbackParamsError | Invalid vrf callback params provided. | +| 6066 | 0x17b2 | VrfCallbackAlreadyCalledError | Vrf callback has already been triggered. | +| 6067 | 0x17b3 | VrfInvalidPubkeyError | The provided pubkey is invalid to use in ecvrf proofs | +| 6068 | 0x17b4 | VrfTooManyVerifyCallsError | Number of required verify calls exceeded | +| 6069 | 0x17b5 | VrfRequestAlreadyLaunchedError | Vrf request is already pending | +| 6070 | 0x17b6 | VrfInsufficientVerificationError | Insufficient amount of proofs collected for VRF callback | +| 6071 | 0x17b7 | InvalidVrfProducerError | An incorrect oracle attempted to submit a proof | +| 6072 | 0x17b8 | InvalidGovernancePidError | Invalid SPLGovernance Account Supplied | +| 6073 | 0x17b9 | InvalidGovernanceAccountError | An Invalid Governance Account was supplied | +| 6074 | 0x17ba | MissingOptionalAccount | Expected an optional account | +| 6075 | 0x17bb | InvalidSpawnRecordOwner | Invalid Owner for Spawn Record | +| 6076 | 0x17bc | NoopError | Noop error | +| 6077 | 0x17bd | MissingRequiredAccountsError | A required instruction account was not included | +| 6078 | 0x17be | InvalidMintError | Invalid mint account passed for instruction | +| 6079 | 0x17bf | InvalidTokenAccountKeyError | An invalid token account was passed into the instruction | +| 6080 | 0x17c0 | InvalidJobAccountError | | +| 6081 | 0x17c1 | VoterStakeRegistryError | | +| 6082 | 0x17c2 | AccountDiscriminatorMismatch | Account discriminator did not match. | diff --git a/website/idl/events/AggregatorCrankEvictionEvent.md b/website/idl/events/AggregatorCrankEvictionEvent.md new file mode 100644 index 0000000..1296635 --- /dev/null +++ b/website/idl/events/AggregatorCrankEvictionEvent.md @@ -0,0 +1,8 @@ + + +| Name | Type | Description | +|--|--|--| +| crankPubkey | publicKey | | +| aggregatorPubkey | publicKey | | +| reason | Option<u32> | | +| timestamp | i64 | | diff --git a/website/idl/events/AggregatorOpenRoundEvent.md b/website/idl/events/AggregatorOpenRoundEvent.md index 39b68b9..a2bd9c7 100644 --- a/website/idl/events/AggregatorOpenRoundEvent.md +++ b/website/idl/events/AggregatorOpenRoundEvent.md @@ -1,9 +1,9 @@ OpenRound successfully called on an aggregator -| Name | Type | Description | -|--|--|--| -| feedPubkey | publicKey | Public key of the aggregator requesting a new result | -| oraclePubkeys | publicKey[] | Oracles assigned to the update request | -| jobPubkeys | publicKey[] | Job accounts associated with an aggregator containing the job definitions | -| remainingFunds | u64 | Remaining funds in the aggregators lease contract | -| queueAuthority | publicKey | The account delegated as the authority to for creating permissions targeted at the queue. | +| Name | Type | Description | +| -------------- | ----------- | ----------------------------------------------------------------------------------------------------------------- | +| feedPubkey | publicKey | Public key of the aggregator requesting a new result | +| oraclePubkeys | publicKey[] | Oracles assigned to the update request | +| jobPubkeys | publicKey[] | Job accounts associated with an aggregator containing the job definitions | +| remainingFunds | u64 | Remaining funds in the aggregators lease contract | +| queueAuthority | publicKey | The account delegated as the authority for making account changes or assigning permissions targeted at the queue. | diff --git a/website/idl/events/BufferRelayerOpenRoundEvent.md b/website/idl/events/BufferRelayerOpenRoundEvent.md new file mode 100644 index 0000000..29fbaa8 --- /dev/null +++ b/website/idl/events/BufferRelayerOpenRoundEvent.md @@ -0,0 +1,9 @@ + + +| Name | Type | Description | +|--|--|--| +| relayerPubkey | publicKey | | +| jobPubkey | publicKey | | +| oraclePubkeys | publicKey[] | | +| remainingFunds | u64 | | +| queue | publicKey | | diff --git a/website/idl/events/overview.md b/website/idl/events/overview.md index 5705a6a..620a966 100644 --- a/website/idl/events/overview.md +++ b/website/idl/events/overview.md @@ -4,9 +4,11 @@ title: Overview slug: . --- +- [AggregatorCrankEvictionEvent](/idl/events/AggregatorCrankEvictionEvent) - [AggregatorInitEvent](/idl/events/AggregatorInitEvent) - [AggregatorOpenRoundEvent](/idl/events/AggregatorOpenRoundEvent) - [AggregatorValueUpdateEvent](/idl/events/AggregatorValueUpdateEvent) +- [BufferRelayerOpenRoundEvent](/idl/events/BufferRelayerOpenRoundEvent) - [CrankLeaseInsufficientFundsEvent](/idl/events/CrankLeaseInsufficientFundsEvent) - [CrankPopExpectedFailureEvent](/idl/events/CrankPopExpectedFailureEvent) - [FeedPermissionRevokedEvent](/idl/events/FeedPermissionRevokedEvent) diff --git a/website/idl/instructions/aggregatorAddJob.md b/website/idl/instructions/aggregatorAddJob.md index 05883b7..ae31478 100644 --- a/website/idl/instructions/aggregatorAddJob.md +++ b/website/idl/instructions/aggregatorAddJob.md @@ -3,9 +3,10 @@ Add a new job to an aggregator to be performed on feed updates ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -| job | true | false | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +| job | TRUE | FALSE | | +## Params |Field|Type|Description| |--|--|--| +| weight | Option<u8> | | diff --git a/website/idl/instructions/aggregatorInit.md b/website/idl/instructions/aggregatorInit.md index 678e780..216dbe1 100644 --- a/website/idl/instructions/aggregatorInit.md +++ b/website/idl/instructions/aggregatorInit.md @@ -3,12 +3,11 @@ Create and initialize the AggregatorAccount. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | false | | -| queue | false | false | | -| authorWallet | false | false | | -| programState | false | false | | -## Args +| aggregator | TRUE | FALSE | The [AggregatorAccountData](/idl/accounts/AggregatorAccountData) being initialized. | +| authority | FALSE | FALSE | The aggregator authority delegated to make account changes. | +| queue | FALSE | FALSE | The [OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) the aggregator is being created for. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +## Params |Field|Type|Description| |--|--|--| | name | u8[32] | Name of the aggregator to store on-chain. | @@ -21,4 +20,5 @@ Create and initialize the AggregatorAccount. | varianceThreshold | [BorshDecimal](/idl/types/BorshDecimal) | Change percentage required between a previous round and the current round. If variance percentage is not met, reject new oracle responses. | | forceReportPeriod | i64 | Number of seconds for which, even if the variance threshold is not passed, accept new responses from oracles. | | expiration | i64 | unix_timestamp after which funds may be withdrawn from the aggregator. null/undefined/0 means the feed has no expiration. | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| disableCrank | bool | | diff --git a/website/idl/instructions/aggregatorLock.md b/website/idl/instructions/aggregatorLock.md index 2973cd5..9ca245b 100644 --- a/website/idl/instructions/aggregatorLock.md +++ b/website/idl/instructions/aggregatorLock.md @@ -3,8 +3,8 @@ Prevent new jobs from being added to the feed. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | true | true | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params |Field|Type|Description| |--|--|--| diff --git a/website/idl/instructions/aggregatorOpenRound.md b/website/idl/instructions/aggregatorOpenRound.md index 3a4070c..681690f 100644 --- a/website/idl/instructions/aggregatorOpenRound.md +++ b/website/idl/instructions/aggregatorOpenRound.md @@ -3,20 +3,21 @@ Opens a new round for the aggregator and will provide an incentivize reward to t ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| lease | true | false | | -| oracleQueue | true | false | | -| queueAuthority | false | false | | -| permission | true | false | | -| escrow | true | false | | -| programState | false | false | | -| payoutWallet | true | false | | -| tokenProgram | false | false | | -| dataBuffer | false | false | | -## Args +| aggregator | TRUE | FALSE | The [AggregatorAccountData](/idl/accounts/AggregatorAccountData) that is requesting a new result. | +| lease | TRUE | FALSE | The [LeaseAccountData](/idl/accounts/LeaseAccountData) for an aggregator that is funding oracle rewards if a new value is successfully accepted on-chain. | +| oracleQueue | TRUE | FALSE | The [OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) that an aggregator has permissions for. | +| queueAuthority | FALSE | FALSE | The account delegated as the authority for the queue that can create permissions targeted at the queue. | +| permission | TRUE | FALSE | The [PermissionAccountData](/idl/accounts/PermissionAccountData) that grants an aggregator permissions to use an oracle queue. | +| escrow | TRUE | FALSE | The escrow token account holding the oracle's reward if a new value is accepted on-chain successfully. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| payoutWallet | TRUE | FALSE | The token wallet that will receive a reward if an aggregator's config permits a new update request. | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| dataBuffer | FALSE | FALSE | The OracleQueueBuffer account holding a collection of Oracle pubkeys. | +| mint | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | leaseBump | u8 | | | permissionBump | u8 | | | jitter | u8 | | diff --git a/website/idl/instructions/aggregatorRemoveJob.md b/website/idl/instructions/aggregatorRemoveJob.md index 2192210..9734cc3 100644 --- a/website/idl/instructions/aggregatorRemoveJob.md +++ b/website/idl/instructions/aggregatorRemoveJob.md @@ -3,10 +3,10 @@ Remove a job from an aggregator. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -| job | true | false | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +| job | TRUE | FALSE | | +## Params |Field|Type|Description| |--|--|--| | jobIdx | u32 | | diff --git a/website/idl/instructions/aggregatorSaveResult.md b/website/idl/instructions/aggregatorSaveResult.md index 2088d80..9220da8 100644 --- a/website/idl/instructions/aggregatorSaveResult.md +++ b/website/idl/instructions/aggregatorSaveResult.md @@ -3,19 +3,20 @@ Oracle saving result for a feed update request to an aggregator round. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| oracle | true | false | | -| oracleAuthority | false | true | | -| oracleQueue | false | false | | -| queueAuthority | false | false | | -| feedPermission | true | false | | -| oraclePermission | false | false | | -| lease | true | false | | -| escrow | true | false | | -| tokenProgram | false | false | | -| programState | false | false | | -| historyBuffer | true | false | | -## Args +| aggregator | TRUE | FALSE | | +| oracle | TRUE | FALSE | | +| oracleAuthority | FALSE | TRUE | | +| oracleQueue | FALSE | FALSE | | +| queueAuthority | FALSE | FALSE | | +| feedPermission | TRUE | FALSE | | +| oraclePermission | FALSE | FALSE | | +| lease | TRUE | FALSE | | +| escrow | TRUE | FALSE | | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| historyBuffer | TRUE | FALSE | | +| mint | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| | oracleIdx | u32 | | @@ -27,4 +28,4 @@ Oracle saving result for a feed update request to an aggregator round. | feedPermissionBump | u8 | | | oraclePermissionBump | u8 | | | leaseBump | u8 | | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | diff --git a/website/idl/instructions/aggregatorSetAuthority.md b/website/idl/instructions/aggregatorSetAuthority.md index 5336d34..e317177 100644 --- a/website/idl/instructions/aggregatorSetAuthority.md +++ b/website/idl/instructions/aggregatorSetAuthority.md @@ -3,9 +3,9 @@ Change the aggregator authority. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -| newAuthority | false | false | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +| newAuthority | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| diff --git a/website/idl/instructions/aggregatorSetBatchSize.md b/website/idl/instructions/aggregatorSetBatchSize.md index 54ba84f..cb60720 100644 --- a/website/idl/instructions/aggregatorSetBatchSize.md +++ b/website/idl/instructions/aggregatorSetBatchSize.md @@ -3,9 +3,9 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params |Field|Type|Description| |--|--|--| | batchSize | u32 | Number of oracles to request on aggregator update. | diff --git a/website/idl/instructions/aggregatorSetForceReportPeriod.md b/website/idl/instructions/aggregatorSetForceReportPeriod.md new file mode 100644 index 0000000..56aeeb4 --- /dev/null +++ b/website/idl/instructions/aggregatorSetForceReportPeriod.md @@ -0,0 +1,11 @@ + + +## Accounts +|Name|isMut|isSigner|Description| +|--|--|--|--| +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params +|Field|Type|Description| +|--|--|--| +| forceReportPeriod | u32 | | diff --git a/website/idl/instructions/aggregatorSetHistoryBuffer.md b/website/idl/instructions/aggregatorSetHistoryBuffer.md index ad68a02..5189c59 100644 --- a/website/idl/instructions/aggregatorSetHistoryBuffer.md +++ b/website/idl/instructions/aggregatorSetHistoryBuffer.md @@ -3,9 +3,9 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -| buffer | true | false | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +| buffer | TRUE | FALSE | | +## Params |Field|Type|Description| |--|--|--| diff --git a/website/idl/instructions/aggregatorSetMinJobs.md b/website/idl/instructions/aggregatorSetMinJobs.md index 3695ce8..36f99eb 100644 --- a/website/idl/instructions/aggregatorSetMinJobs.md +++ b/website/idl/instructions/aggregatorSetMinJobs.md @@ -3,9 +3,9 @@ Set the minimum number of feed jobs suggested to be successful before an oracle ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params |Field|Type|Description| |--|--|--| | minJobResults | u32 | Minimum number of feed jobs suggested to be successful before an oracle sends a response. | diff --git a/website/idl/instructions/aggregatorSetMinOracles.md b/website/idl/instructions/aggregatorSetMinOracles.md index c001925..602b2aa 100644 --- a/website/idl/instructions/aggregatorSetMinOracles.md +++ b/website/idl/instructions/aggregatorSetMinOracles.md @@ -3,9 +3,9 @@ Set the minimum number of oracle responses required before a round is validated. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params |Field|Type|Description| |--|--|--| | minOracleResults | u32 | Minimum number of oracle responses required before a round is validated. | diff --git a/website/idl/instructions/aggregatorSetQueue.md b/website/idl/instructions/aggregatorSetQueue.md index 1d7526c..af180aa 100644 --- a/website/idl/instructions/aggregatorSetQueue.md +++ b/website/idl/instructions/aggregatorSetQueue.md @@ -3,9 +3,9 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -| queue | false | false | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +| queue | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| diff --git a/website/idl/instructions/aggregatorSetUpdateInterval.md b/website/idl/instructions/aggregatorSetUpdateInterval.md index da9206f..d400abb 100644 --- a/website/idl/instructions/aggregatorSetUpdateInterval.md +++ b/website/idl/instructions/aggregatorSetUpdateInterval.md @@ -3,9 +3,9 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params |Field|Type|Description| |--|--|--| | newInterval | u32 | | diff --git a/website/idl/instructions/aggregatorSetVarianceThreshold.md b/website/idl/instructions/aggregatorSetVarianceThreshold.md index 774e1b0..2a5eb52 100644 --- a/website/idl/instructions/aggregatorSetVarianceThreshold.md +++ b/website/idl/instructions/aggregatorSetVarianceThreshold.md @@ -3,9 +3,9 @@ Set the change percentage required between a previous round and the current roun ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| aggregator | true | false | | -| authority | false | true | | -## Args +| aggregator | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params |Field|Type|Description| |--|--|--| | varianceThreshold | [BorshDecimal](/idl/types/BorshDecimal) | Change percentage required between a previous round and the current round. If variance percentage is not met, reject new oracle responses. | diff --git a/website/idl/instructions/bufferRelayerInit.md b/website/idl/instructions/bufferRelayerInit.md new file mode 100644 index 0000000..52f0e82 --- /dev/null +++ b/website/idl/instructions/bufferRelayerInit.md @@ -0,0 +1,23 @@ + + +## Accounts +|Name|isMut|isSigner|Description| +|--|--|--|--| +| bufferRelayer | TRUE | FALSE | | +| escrow | TRUE | FALSE | | +| authority | FALSE | FALSE | | +| queue | FALSE | FALSE | | +| job | FALSE | FALSE | | +| programState | FALSE | FALSE | | +| mint | FALSE | FALSE | | +| payer | TRUE | TRUE | | +| tokenProgram | FALSE | FALSE | | +| associatedTokenProgram | FALSE | FALSE | | +| systemProgram | FALSE | FALSE | | +| rent | FALSE | FALSE | | +## Params +|Field|Type|Description| +|--|--|--| +| name | u8[32] | | +| minUpdateDelaySeconds | u32 | | +| stateBump | u8 | | diff --git a/website/idl/instructions/bufferRelayerOpenRound.md b/website/idl/instructions/bufferRelayerOpenRound.md new file mode 100644 index 0000000..d6b6917 --- /dev/null +++ b/website/idl/instructions/bufferRelayerOpenRound.md @@ -0,0 +1,16 @@ + + +## Accounts +|Name|isMut|isSigner|Description| +|--|--|--|--| +| bufferRelayer | TRUE | FALSE | | +| oracleQueue | TRUE | FALSE | | +| dataBuffer | TRUE | FALSE | | +| permission | TRUE | FALSE | | +| escrow | TRUE | FALSE | | +| programState | FALSE | FALSE | | +## Params +|Field|Type|Description| +|--|--|--| +| stateBump | u8 | | +| permissionBump | u8 | | diff --git a/website/idl/instructions/bufferRelayerSaveResult.md b/website/idl/instructions/bufferRelayerSaveResult.md new file mode 100644 index 0000000..1d3d22e --- /dev/null +++ b/website/idl/instructions/bufferRelayerSaveResult.md @@ -0,0 +1,23 @@ + + +## Accounts +|Name|isMut|isSigner|Description| +|--|--|--|--| +| bufferRelayer | TRUE | FALSE | | +| oracleAuthority | FALSE | TRUE | | +| oracle | FALSE | FALSE | | +| oracleQueue | TRUE | FALSE | | +| dataBuffer | TRUE | FALSE | | +| queueAuthority | FALSE | FALSE | | +| permission | TRUE | FALSE | | +| escrow | TRUE | FALSE | | +| oracleWallet | TRUE | FALSE | | +| programState | FALSE | FALSE | | +| tokenProgram | FALSE | FALSE | | +## Params +|Field|Type|Description| +|--|--|--| +| stateBump | u8 | | +| permissionBump | u8 | | +| result | bytes | | +| success | bool | | diff --git a/website/idl/instructions/crankInit.md b/website/idl/instructions/crankInit.md index c5f27a9..00a830f 100644 --- a/website/idl/instructions/crankInit.md +++ b/website/idl/instructions/crankInit.md @@ -3,12 +3,12 @@ Create and initialize the CrankAccount. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| crank | true | true | | -| queue | false | false | | -| buffer | true | false | | -| payer | true | false | | -| systemProgram | false | false | | -## Args +| crank | TRUE | TRUE | | +| queue | FALSE | FALSE | | +| buffer | TRUE | FALSE | | +| payer | TRUE | TRUE | | +| systemProgram | FALSE | FALSE | The Solana system program account. | +## Params |Field|Type|Description| |--|--|--| | name | bytes | | diff --git a/website/idl/instructions/crankPop.md b/website/idl/instructions/crankPop.md index adb629a..793273e 100644 --- a/website/idl/instructions/crankPop.md +++ b/website/idl/instructions/crankPop.md @@ -1,21 +1,25 @@ Pops an aggregator from the crank. ## Accounts -|Name|isMut|isSigner|Description| -|--|--|--|--| -| crank | true | false | | -| oracleQueue | true | false | | -| queueAuthority | false | false | | -| programState | false | false | | -| payoutWallet | true | false | | -| tokenProgram | false | false | | -| crankDataBuffer | true | false | | -| queueDataBuffer | false | false | | -## Args -|Field|Type|Description| -|--|--|--| -| stateBump | u8 | | -| leaseBumps | bytes | | -| permissionBumps | bytes | | -| nonce | Option<u32> | | -| failOpenOnAccountMismatch | Option<bool> | | + +| Name | isMut | isSigner | Description | +| --------------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------- | +| crank | TRUE | FALSE | | +| oracleQueue | TRUE | FALSE | | +| queueAuthority | FALSE | FALSE | The account delegated as the authority for making account changes or assigning permissions targeted at the queue. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| payoutWallet | TRUE | FALSE | | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| crankDataBuffer | TRUE | FALSE | | +| queueDataBuffer | FALSE | FALSE | | +| mint | FALSE | FALSE | | + +## Params + +| Field | Type | Description | +| ------------------------- | ------------------ | ------------------------------------------------------------------------ | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| leaseBumps | bytes | | +| permissionBumps | bytes | | +| nonce | Option<u32> | | +| failOpenOnAccountMismatch | Option<bool> | | diff --git a/website/idl/instructions/crankPush.md b/website/idl/instructions/crankPush.md index 8651c7a..4fd67cc 100644 --- a/website/idl/instructions/crankPush.md +++ b/website/idl/instructions/crankPush.md @@ -1,19 +1,22 @@ Pushes a new aggregator onto the crank. ## Accounts -|Name|isMut|isSigner|Description| -|--|--|--|--| -| crank | true | false | | -| aggregator | true | false | | -| oracleQueue | true | false | | -| queueAuthority | false | false | | -| permission | false | false | | -| lease | true | false | | -| escrow | true | false | | -| programState | false | false | | -| dataBuffer | true | false | | -## Args -|Field|Type|Description| -|--|--|--| -| stateBump | u8 | | -| permissionBump | u8 | | + +| Name | isMut | isSigner | Description | +| -------------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------- | +| crank | TRUE | FALSE | The crank to add a new aggregator to. | +| aggregator | TRUE | FALSE | The aggregator being pushed onto the crank. | +| oracleQueue | TRUE | FALSE | The crank and aggregators assigned oracle queue. | +| queueAuthority | FALSE | FALSE | The account delegated as the authority for making account changes or assigning permissions targeted at the queue. | +| permission | FALSE | FALSE | The aggregator's permission account. | +| lease | TRUE | FALSE | The aggregator's lease contract. | +| escrow | TRUE | FALSE | | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| dataBuffer | TRUE | FALSE | The crank buffer account holding an array of CrankRows. | + +## Params + +| Field | Type | Description | +| -------------- | ---- | ------------------------------------------------------------------------ | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| permissionBump | u8 | | diff --git a/website/idl/instructions/jobInit.md b/website/idl/instructions/jobInit.md index f19e0b6..41fa723 100644 --- a/website/idl/instructions/jobInit.md +++ b/website/idl/instructions/jobInit.md @@ -3,13 +3,13 @@ Create and initialize the JobAccount. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| job | true | false | | -| authorWallet | false | false | | -| programState | false | false | | -## Args +| job | TRUE | FALSE | | +| authority | FALSE | FALSE | | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +## Params |Field|Type|Description| |--|--|--| | name | u8[32] | An optional name to apply to the job account. | | expiration | i64 | unix_timestamp of when funds can be withdrawn from this account. | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | data | bytes | A serialized protocol buffer holding the schema of the job. | diff --git a/website/idl/instructions/leaseExtend.md b/website/idl/instructions/leaseExtend.md index 6150ae1..3e89458 100644 --- a/website/idl/instructions/leaseExtend.md +++ b/website/idl/instructions/leaseExtend.md @@ -3,17 +3,19 @@ Adds fund to a LeaseAccount. Note that funds can always be withdrawn by the with ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| lease | true | false | | -| aggregator | false | false | | -| queue | false | false | | -| funder | true | false | | -| owner | true | true | | -| escrow | true | false | | -| tokenProgram | false | false | | -| programState | false | false | | -## Args +| lease | TRUE | FALSE | | +| aggregator | FALSE | FALSE | | +| queue | FALSE | FALSE | | +| funder | TRUE | FALSE | | +| owner | TRUE | TRUE | | +| escrow | TRUE | FALSE | | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| mint | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| | loadAmount | u64 | | | leaseBump | u8 | | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| walletBumps | bytes | | diff --git a/website/idl/instructions/leaseInit.md b/website/idl/instructions/leaseInit.md index a27ea16..6b07d9a 100644 --- a/website/idl/instructions/leaseInit.md +++ b/website/idl/instructions/leaseInit.md @@ -3,20 +3,22 @@ Create and initialize the LeaseAccount. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| lease | true | false | | -| queue | true | false | | -| aggregator | false | false | | -| funder | true | false | | -| payer | true | true | | -| systemProgram | false | false | | -| tokenProgram | false | false | | -| owner | true | true | | -| escrow | true | false | | -| programState | false | false | | -## Args +| lease | TRUE | FALSE | | +| queue | TRUE | FALSE | | +| aggregator | FALSE | FALSE | | +| funder | TRUE | FALSE | | +| payer | TRUE | TRUE | | +| systemProgram | FALSE | FALSE | The Solana system program account. | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| owner | TRUE | TRUE | | +| escrow | TRUE | FALSE | | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| mint | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| | loadAmount | u64 | Token amount to load into the lease escrow | | withdrawAuthority | publicKey | This authority will be permitted to withdraw funds from this lease. | | leaseBump | u8 | | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| walletBumps | bytes | | diff --git a/website/idl/instructions/leaseSetAuthority.md b/website/idl/instructions/leaseSetAuthority.md index 9f2e7d2..097931b 100644 --- a/website/idl/instructions/leaseSetAuthority.md +++ b/website/idl/instructions/leaseSetAuthority.md @@ -3,9 +3,9 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| lease | true | false | | -| authority | false | true | | -| newAuthority | false | false | | -## Args +| lease | TRUE | FALSE | | +| withdrawAuthority | FALSE | TRUE | | +| newAuthority | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| diff --git a/website/idl/instructions/leaseWithdraw.md b/website/idl/instructions/leaseWithdraw.md index 704ac1c..8d5df48 100644 --- a/website/idl/instructions/leaseWithdraw.md +++ b/website/idl/instructions/leaseWithdraw.md @@ -3,17 +3,18 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| lease | true | false | | -| escrow | true | false | | -| aggregator | false | false | | -| queue | false | false | | -| withdrawAuthority | false | true | | -| withdrawAccount | true | false | | -| tokenProgram | false | false | | -| programState | false | false | | -## Args +| lease | TRUE | FALSE | | +| escrow | TRUE | FALSE | | +| aggregator | FALSE | FALSE | | +| queue | FALSE | FALSE | | +| withdrawAuthority | FALSE | TRUE | | +| withdrawAccount | TRUE | FALSE | | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| mint | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | leaseBump | u8 | | | amount | u64 | Token amount to withdraw from the lease escrow | diff --git a/website/idl/instructions/oracleHeartbeat.md b/website/idl/instructions/oracleHeartbeat.md index 08f44c8..5d48e62 100644 --- a/website/idl/instructions/oracleHeartbeat.md +++ b/website/idl/instructions/oracleHeartbeat.md @@ -3,14 +3,14 @@ Initiates a heartbeat for an OracleAccount, signifying oracle is still healthy. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| oracle | true | false | | -| oracleAuthority | false | true | | -| tokenAccount | false | false | | -| gcOracle | true | false | | -| oracleQueue | true | false | | -| permission | false | false | | -| dataBuffer | true | false | | -## Args +| oracle | TRUE | FALSE | The [OracleAccountData](/idl/accounts/OracleAccountData) that is heartbeating on-chain. | +| oracleAuthority | FALSE | TRUE | The [OracleAccountData](/idl/accounts/OracleAccountData) authority that is permitted to heartbeat. | +| tokenAccount | FALSE | FALSE | The token wallet for the oracle. | +| gcOracle | TRUE | FALSE | The current garbage collection oracle that may be swapped in the buffer periodically. | +| oracleQueue | TRUE | FALSE | The [OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) that an oracle is heartbeating for. | +| permission | FALSE | FALSE | The [PermissionAccountData](/idl/accounts/PermissionAccountData) that grants an oracle heartbeat permissions. | +| dataBuffer | TRUE | FALSE | The OracleQueueBuffer account holding a collection of Oracle pubkeys. | +## Params |Field|Type|Description| |--|--|--| | permissionBump | u8 | | diff --git a/website/idl/instructions/oracleInit.md b/website/idl/instructions/oracleInit.md index 5c4163c..b31d8a8 100644 --- a/website/idl/instructions/oracleInit.md +++ b/website/idl/instructions/oracleInit.md @@ -3,17 +3,17 @@ Create and initialize the OracleAccount.
    Size: 636 Bytes
    Ren ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| oracle | true | false | | -| oracleAuthority | false | false | | -| wallet | false | false | | -| programState | false | false | | -| queue | false | false | | -| payer | true | false | | -| systemProgram | false | false | | -## Args +| oracle | TRUE | FALSE | | +| oracleAuthority | FALSE | FALSE | | +| wallet | FALSE | FALSE | | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| queue | FALSE | FALSE | | +| payer | TRUE | TRUE | | +| systemProgram | FALSE | FALSE | The Solana system program account. | +## Params |Field|Type|Description| |--|--|--| | name | bytes | Name of the oracle to store on-chain. | | metadata | bytes | Metadata of the oracle to store on-chain. | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | oracleBump | u8 | | diff --git a/website/idl/instructions/oracleQueueInit.md b/website/idl/instructions/oracleQueueInit.md index 8050865..985c3b0 100644 --- a/website/idl/instructions/oracleQueueInit.md +++ b/website/idl/instructions/oracleQueueInit.md @@ -1,26 +1,31 @@ Create and initialize the OracleQueueAccount. ## Accounts -|Name|isMut|isSigner|Description| -|--|--|--|--| -| oracleQueue | true | true | | -| authority | false | false | | -| buffer | true | false | | -| payer | true | false | | -| systemProgram | false | false | | -## Args -|Field|Type|Description| -|--|--|--| -| name | u8[32] | Name of the queue to store on-chain. | -| metadata | u8[64] | Metadata of the queue to store on-chain. | -| reward | u64 | Rewards to provide oracles and round openers on this queue. | -| minStake | u64 | The minimum amount of stake oracles must present to remain on the queue. | -| feedProbationPeriod | u32 | After a feed lease is funded or re-funded, it must consecutively succeed N amount of times or its authorization to use the queue is auto-revoked. | -| oracleTimeout | u32 | Time period we should remove an oracle after if no response. | -| slashingEnabled | bool | Whether slashing is enabled on this queue. | -| varianceToleranceMultiplier | [BorshDecimal](/idl/types/BorshDecimal) | The tolerated variance amount oracle results can have from the accepted round result before being slashed. slashBound = varianceToleranceMultiplier * stdDeviation Default: 2 | -| consecutiveFeedFailureLimit | u64 | Consecutive failure limit for a feed before feed permission is revoked. | -| consecutiveOracleFailureLimit | u64 | Consecutive failure limit for an oracle before oracle permission is revoked. | -| queueSize | u32 | The size of the queue. | -| unpermissionedFeeds | bool | Enabling this setting means data feeds do not need explicit permission to join the queue. | -| unpermissionedVrf | bool | | + +| Name | isMut | isSigner | Description | +| ------------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------- | +| oracleQueue | TRUE | TRUE | | +| authority | FALSE | FALSE | The account delegated as the authority for making account changes or assigning permissions targeted at the queue. | +| buffer | TRUE | FALSE | | +| payer | TRUE | TRUE | | +| systemProgram | FALSE | FALSE | The Solana system program account. | +| mint | FALSE | FALSE | | + +## Params + +| Field | Type | Description | +| ----------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| name | u8[32] | Name of the queue to store on-chain. | +| metadata | u8[64] | Metadata of the queue to store on-chain. | +| reward | u64 | Rewards to provide oracles and round openers on this queue. | +| minStake | u64 | The minimum amount of stake oracles must present to remain on the queue. | +| feedProbationPeriod | u32 | After a feed lease is funded or re-funded, it must consecutively succeed N amount of times or its authorization to use the queue is auto-revoked. | +| oracleTimeout | u32 | Time period we should remove an oracle after if no response. | +| slashingEnabled | bool | Whether slashing is enabled on this queue. | +| varianceToleranceMultiplier | [BorshDecimal](/idl/types/BorshDecimal) | The tolerated variance amount oracle results can have from the accepted round result before being slashed. slashBound = varianceToleranceMultiplier \* stdDeviation Default: 2 | +| consecutiveFeedFailureLimit | u64 | Consecutive failure limit for a feed before feed permission is revoked. | +| consecutiveOracleFailureLimit | u64 | Consecutive failure limit for an oracle before oracle permission is revoked. | +| queueSize | u32 | The size of the queue. | +| unpermissionedFeeds | bool | Enabling this setting means data feeds do not need explicit permission to join the queue. | +| unpermissionedVrf | bool | | +| enableBufferRelayers | bool | | diff --git a/website/idl/instructions/oracleQueueSetRewards.md b/website/idl/instructions/oracleQueueSetRewards.md index 080f2ac..6e285eb 100644 --- a/website/idl/instructions/oracleQueueSetRewards.md +++ b/website/idl/instructions/oracleQueueSetRewards.md @@ -1,11 +1,14 @@ Set the rewards to provide oracles and round openers on this queue. ## Accounts -|Name|isMut|isSigner|Description| -|--|--|--|--| -| queue | true | false | | -| authority | false | true | | -## Args -|Field|Type|Description| -|--|--|--| -| rewards | u64 | Rewards to provide oracles and round openers on this queue. | + +| Name | isMut | isSigner | Description | +| --------- | ----- | -------- | ----------------------------------------------------------------------------------------------------------------- | +| queue | TRUE | FALSE | | +| authority | FALSE | TRUE | The account delegated as the authority for making account changes or assigning permissions targeted at the queue. | + +## Params + +| Field | Type | Description | +| ------- | ---- | ----------------------------------------------------------- | +| rewards | u64 | Rewards to provide oracles and round openers on this queue. | diff --git a/website/idl/instructions/oracleQueueVrfConfig.md b/website/idl/instructions/oracleQueueVrfConfig.md index ddca050..cb3522e 100644 --- a/website/idl/instructions/oracleQueueVrfConfig.md +++ b/website/idl/instructions/oracleQueueVrfConfig.md @@ -3,9 +3,9 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| queue | true | false | | -| authority | false | true | | -## Args +| queue | TRUE | FALSE | | +| authority | FALSE | TRUE | | +## Params |Field|Type|Description| |--|--|--| | unpermissionedVrfEnabled | bool | | diff --git a/website/idl/instructions/oracleWithdraw.md b/website/idl/instructions/oracleWithdraw.md index a5af502..05599ad 100644 --- a/website/idl/instructions/oracleWithdraw.md +++ b/website/idl/instructions/oracleWithdraw.md @@ -3,19 +3,19 @@ Withdraw stake and/or rewards from an OracleAccount. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| oracle | true | false | | -| oracleAuthority | false | true | | -| tokenAccount | true | false | | -| withdrawAccount | true | false | | -| oracleQueue | true | false | | -| permission | true | false | | -| tokenProgram | false | false | | -| programState | false | false | | -| payer | true | true | | -| systemProgram | false | false | | -## Args +| oracle | TRUE | FALSE | | +| oracleAuthority | FALSE | TRUE | | +| tokenAccount | TRUE | FALSE | | +| withdrawAccount | TRUE | FALSE | | +| oracleQueue | TRUE | FALSE | | +| permission | TRUE | FALSE | | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| payer | TRUE | TRUE | | +| systemProgram | FALSE | FALSE | The Solana system program account. | +## Params |Field|Type|Description| |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | permissionBump | u8 | | | amount | u64 | | diff --git a/website/idl/instructions/overview.md b/website/idl/instructions/overview.md index e983663..57b6d5e 100644 --- a/website/idl/instructions/overview.md +++ b/website/idl/instructions/overview.md @@ -12,12 +12,16 @@ slug: . - [aggregatorSaveResult](/idl/instructions/aggregatorSaveResult) - [aggregatorSetAuthority](/idl/instructions/aggregatorSetAuthority) - [aggregatorSetBatchSize](/idl/instructions/aggregatorSetBatchSize) +- [aggregatorSetForceReportPeriod](/idl/instructions/aggregatorSetForceReportPeriod) - [aggregatorSetHistoryBuffer](/idl/instructions/aggregatorSetHistoryBuffer) - [aggregatorSetMinJobs](/idl/instructions/aggregatorSetMinJobs) - [aggregatorSetMinOracles](/idl/instructions/aggregatorSetMinOracles) - [aggregatorSetQueue](/idl/instructions/aggregatorSetQueue) - [aggregatorSetUpdateInterval](/idl/instructions/aggregatorSetUpdateInterval) - [aggregatorSetVarianceThreshold](/idl/instructions/aggregatorSetVarianceThreshold) +- [bufferRelayerInit](/idl/instructions/bufferRelayerInit) +- [bufferRelayerOpenRound](/idl/instructions/bufferRelayerOpenRound) +- [bufferRelayerSaveResult](/idl/instructions/bufferRelayerSaveResult) - [crankInit](/idl/instructions/crankInit) - [crankPop](/idl/instructions/crankPop) - [crankPush](/idl/instructions/crankPush) diff --git a/website/idl/instructions/permissionInit.md b/website/idl/instructions/permissionInit.md index 79731de..a605cfc 100644 --- a/website/idl/instructions/permissionInit.md +++ b/website/idl/instructions/permissionInit.md @@ -3,13 +3,12 @@ Create and initialize the PermissionAccount. ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| permission | true | false | | -| authority | false | false | | -| granter | false | false | | -| grantee | false | false | | -| payer | true | true | | -| systemProgram | false | false | | -## Args +| permission | TRUE | FALSE | The permission account being initialized. | +| authority | FALSE | FALSE | The [PermissionAccountData](/idl/accounts/PermissionAccountData) authority that can update an account's permissions. | +| granter | FALSE | FALSE | The account receiving the assigned permissions. | +| grantee | FALSE | FALSE | The account granting the assigned permissions. | +| payer | TRUE | TRUE | The account paying for the new permission account on-chain. | +| systemProgram | FALSE | FALSE | The Solana system program account. | +## Params |Field|Type|Description| |--|--|--| -| permissionBump | u8 | | diff --git a/website/idl/instructions/permissionSet.md b/website/idl/instructions/permissionSet.md index 6da11ff..91cb537 100644 --- a/website/idl/instructions/permissionSet.md +++ b/website/idl/instructions/permissionSet.md @@ -3,9 +3,9 @@ Sets the permission in the PermissionAccount ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| permission | true | false | | -| authority | false | true | | -## Args +| permission | TRUE | FALSE | The [PermissionAccountData](/idl/accounts/PermissionAccountData) that is being updated. | +| authority | FALSE | TRUE | The [PermissionAccountData](/idl/accounts/PermissionAccountData) authority that can update an account's permissions. | +## Params |Field|Type|Description| |--|--|--| | permission | [SwitchboardPermission](/idl/types/SwitchboardPermission) | The [SwitchboardPermission](/idl/types/SwitchboardPermission) enumeration to set. | diff --git a/website/idl/instructions/programConfig.md b/website/idl/instructions/programConfig.md index 87575de..16fc351 100644 --- a/website/idl/instructions/programConfig.md +++ b/website/idl/instructions/programConfig.md @@ -3,10 +3,12 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| authority | false | true | | -| programState | false | false | | -## Args +| authority | FALSE | TRUE | The [SbState](/idl/accounts/SbState) authority that permits account changes. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| daoMint | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| | token | publicKey | | | bump | u8 | | +| daoMint | publicKey | | diff --git a/website/idl/instructions/programInit.md b/website/idl/instructions/programInit.md index 1892fe4..70f92b8 100644 --- a/website/idl/instructions/programInit.md +++ b/website/idl/instructions/programInit.md @@ -3,14 +3,15 @@ Create and initialize the [SbState](/idl/accounts/SbState). ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| state | true | false | | -| authority | false | false | | -| tokenMint | true | false | | -| vault | true | false | | -| payer | true | false | | -| systemProgram | false | false | | -| tokenProgram | false | false | | -## Args +| state | TRUE | FALSE | The [SbState](/idl/accounts/SbState) account being initialized. | +| authority | FALSE | FALSE | The account delegated as the program authority. | +| tokenMint | TRUE | FALSE | The token mint that is used for oracle rewards, aggregator leases, and other reward incentives. | +| vault | TRUE | FALSE | The token wallet for the program state account. | +| payer | TRUE | TRUE | The account paying for the new on-chain account. | +| systemProgram | FALSE | FALSE | The Solana system program account. | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +| daoMint | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | diff --git a/website/idl/instructions/vaultTransfer.md b/website/idl/instructions/vaultTransfer.md index 60c7120..f030c01 100644 --- a/website/idl/instructions/vaultTransfer.md +++ b/website/idl/instructions/vaultTransfer.md @@ -3,13 +3,13 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| state | false | false | | -| authority | false | true | | -| to | true | false | | -| vault | true | false | | -| tokenProgram | false | false | | -## Args +| state | FALSE | FALSE | | +| authority | FALSE | TRUE | | +| to | TRUE | FALSE | | +| vault | TRUE | FALSE | | +| tokenProgram | FALSE | FALSE | The Solana token program account. | +## Params |Field|Type|Description| |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | amount | u64 | | diff --git a/website/idl/instructions/vrfInit.md b/website/idl/instructions/vrfInit.md index 9bfd370..e3a38e8 100644 --- a/website/idl/instructions/vrfInit.md +++ b/website/idl/instructions/vrfInit.md @@ -3,13 +3,13 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| vrf | true | false | | -| authority | false | false | | -| oracleQueue | false | false | | -| escrow | true | false | | -| programState | false | false | | -| tokenProgram | false | false | | -## Args +| vrf | TRUE | FALSE | The [VrfAccountData](/idl/accounts/VrfAccountData) that is being initialized. | +| authority | FALSE | FALSE | The [VrfAccountData](/idl/accounts/VrfAccountData) authority that can request new VRF results. | +| oracleQueue | FALSE | FALSE | The [OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) that the VRF account is joining. | +| escrow | TRUE | FALSE | The escrow token account for the programState's mint holding the oracle rewards for VRF update request. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| tokenProgram | FALSE | FALSE | The Solana token Program ID. | +## Params |Field|Type|Description| |--|--|--| | callback | [Callback](/idl/types/Callback) | | diff --git a/website/idl/instructions/vrfProve.md b/website/idl/instructions/vrfProve.md index 7def926..6b005ec 100644 --- a/website/idl/instructions/vrfProve.md +++ b/website/idl/instructions/vrfProve.md @@ -3,10 +3,10 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| vrf | true | false | | -| oracle | false | false | | -| randomnessProducer | false | true | | -## Args +| vrf | TRUE | FALSE | The [VrfAccountData](/idl/accounts/VrfAccountData) that requested a new randomness result. | +| oracle | FALSE | FALSE | The [OracleAccountData](/idl/accounts/OracleAccountData) that is assigned to the VRF request. | +| randomnessProducer | FALSE | TRUE | The randomness producer for the VRF request, specific to the Oracle assigned to the VRF request. | +## Params |Field|Type|Description| |--|--|--| | proof | bytes | | diff --git a/website/idl/instructions/vrfProveAndVerify.md b/website/idl/instructions/vrfProveAndVerify.md index 7597b2c..3ae5f69 100644 --- a/website/idl/instructions/vrfProveAndVerify.md +++ b/website/idl/instructions/vrfProveAndVerify.md @@ -3,16 +3,16 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| vrf | true | false | | -| callbackPid | false | false | | -| tokenProgram | false | false | | -| escrow | true | false | | -| programState | false | false | | -| oracle | false | false | | -| oracleAuthority | false | true | | -| oracleWallet | true | false | | -| instructionsSysvar | false | false | | -## Args +| vrf | TRUE | FALSE | | +| callbackPid | FALSE | FALSE | | +| tokenProgram | FALSE | FALSE | | +| escrow | TRUE | FALSE | | +| programState | FALSE | FALSE | | +| oracle | FALSE | FALSE | | +| oracleAuthority | FALSE | TRUE | | +| oracleWallet | TRUE | FALSE | | +| instructionsSysvar | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| | nonce | Option<u32> | | diff --git a/website/idl/instructions/vrfRequestRandomness.md b/website/idl/instructions/vrfRequestRandomness.md index 1b2c432..cb18ea5 100644 --- a/website/idl/instructions/vrfRequestRandomness.md +++ b/website/idl/instructions/vrfRequestRandomness.md @@ -3,19 +3,19 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| authority | false | true | | -| vrf | true | false | | -| oracleQueue | true | false | | -| queueAuthority | false | false | | -| dataBuffer | false | false | | -| permission | true | false | | -| escrow | true | false | | -| payerWallet | true | false | | -| payerAuthority | false | true | | -| recentBlockhashes | false | false | | -| programState | false | false | | -| tokenProgram | false | false | | -## Args +| authority | FALSE | TRUE | The [VrfAccountData](/idl/accounts/VrfAccountData) authority that is permitted to request randomness. | +| vrf | TRUE | FALSE | The [VrfAccountData](/idl/accounts/VrfAccountData) that is requesting a new randomness result. | +| oracleQueue | TRUE | FALSE | The [OracleQueueAccountData](/idl/accounts/OracleQueueAccountData) that the VRF Account is assigned to. | +| queueAuthority | FALSE | FALSE | The Oracle Queue's authority. | +| dataBuffer | FALSE | FALSE | The OracleQueueBuffer account holding a collection of Oracle pubkeys. | +| permission | TRUE | FALSE | The permission account that allows a VRF Account to request randomness. | +| escrow | TRUE | FALSE | The escrow token account holding the oracle's reward if successful. | +| payerWallet | TRUE | FALSE | The payer wallet who is funding the VRF request. | +| payerAuthority | FALSE | TRUE | The payer wallet's authority who can approve token transfers. | +| recentBlockhashes | FALSE | FALSE | The Solana account holding the most recent blockhashes for the VRF proof. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| tokenProgram | FALSE | FALSE | The Solana token Program ID. | +## Params |Field|Type|Description| |--|--|--| | permissionBump | u8 | | diff --git a/website/idl/instructions/vrfVerify.md b/website/idl/instructions/vrfVerify.md index 676cda0..166868f 100644 --- a/website/idl/instructions/vrfVerify.md +++ b/website/idl/instructions/vrfVerify.md @@ -3,16 +3,16 @@ ## Accounts |Name|isMut|isSigner|Description| |--|--|--|--| -| vrf | true | false | | -| callbackPid | false | false | | -| tokenProgram | false | false | | -| escrow | true | false | | -| programState | false | false | | -| oracle | false | false | | -| oracleAuthority | false | false | | -| oracleWallet | true | false | | -| instructionsSysvar | false | false | | -## Args +| vrf | TRUE | FALSE | The VRF Account to verify the proof for. | +| callbackPid | FALSE | FALSE | The VRF Account's callback program ID. | +| tokenProgram | FALSE | FALSE | The Solana token Program ID. | +| escrow | TRUE | FALSE | The escrow token account holding the oracle's reward if successful. | +| programState | FALSE | FALSE | The Switchboard [SbState](/idl/accounts/SbState) account. | +| oracle | FALSE | FALSE | The Oracle Account verifying the VRF proof. | +| oracleAuthority | FALSE | FALSE | The Oracle authority who is permitted to make on-chain transactions. | +| oracleWallet | TRUE | FALSE | The Oracle's token wallet receiving the VRF reward if successful. | +| instructionsSysvar | FALSE | FALSE | | +## Params |Field|Type|Description| |--|--|--| | nonce | Option<u32> | | diff --git a/website/idl/overview.mdx b/website/idl/overview.mdx index 9d943cf..6720a18 100644 --- a/website/idl/overview.mdx +++ b/website/idl/overview.mdx @@ -11,6 +11,7 @@ title: Overview ## [Accounts](/idl/accounts) - [AggregatorAccountData](/idl/accounts/AggregatorAccountData) +- [BufferRelayerAccountData](/idl/accounts/BufferRelayerAccountData) - [CrankAccountData](/idl/accounts/CrankAccountData) - [JobAccountData](/idl/accounts/JobAccountData) - [LeaseAccountData](/idl/accounts/LeaseAccountData) @@ -30,17 +31,23 @@ title: Overview - [aggregatorSaveResult](/idl/instructions/aggregatorSaveResult) - [aggregatorSetAuthority](/idl/instructions/aggregatorSetAuthority) - [aggregatorSetBatchSize](/idl/instructions/aggregatorSetBatchSize) +- [aggregatorSetForceReportPeriod](/idl/instructions/aggregatorSetForceReportPeriod) - [aggregatorSetHistoryBuffer](/idl/instructions/aggregatorSetHistoryBuffer) - [aggregatorSetMinJobs](/idl/instructions/aggregatorSetMinJobs) - [aggregatorSetMinOracles](/idl/instructions/aggregatorSetMinOracles) - [aggregatorSetQueue](/idl/instructions/aggregatorSetQueue) +- [aggregatorSetUpdateInterval](/idl/instructions/aggregatorSetUpdateInterval) - [aggregatorSetVarianceThreshold](/idl/instructions/aggregatorSetVarianceThreshold) +- [bufferRelayerInit](/idl/instructions/bufferRelayerInit) +- [bufferRelayerOpenRound](/idl/instructions/bufferRelayerOpenRound) +- [bufferRelayerSaveResult](/idl/instructions/bufferRelayerSaveResult) - [crankInit](/idl/instructions/crankInit) - [crankPop](/idl/instructions/crankPop) - [crankPush](/idl/instructions/crankPush) - [jobInit](/idl/instructions/jobInit) - [leaseExtend](/idl/instructions/leaseExtend) - [leaseInit](/idl/instructions/leaseInit) +- [leaseSetAuthority](/idl/instructions/leaseSetAuthority) - [leaseWithdraw](/idl/instructions/leaseWithdraw) - [oracleHeartbeat](/idl/instructions/oracleHeartbeat) - [oracleInit](/idl/instructions/oracleInit) @@ -55,14 +62,17 @@ title: Overview - [vaultTransfer](/idl/instructions/vaultTransfer) - [vrfInit](/idl/instructions/vrfInit) - [vrfProve](/idl/instructions/vrfProve) +- [vrfProveAndVerify](/idl/instructions/vrfProveAndVerify) - [vrfRequestRandomness](/idl/instructions/vrfRequestRandomness) - [vrfVerify](/idl/instructions/vrfVerify) ## [Events](/idl/events) +- [AggregatorCrankEvictionEvent](/idl/events/AggregatorCrankEvictionEvent) - [AggregatorInitEvent](/idl/events/AggregatorInitEvent) - [AggregatorOpenRoundEvent](/idl/events/AggregatorOpenRoundEvent) - [AggregatorValueUpdateEvent](/idl/events/AggregatorValueUpdateEvent) +- [BufferRelayerOpenRoundEvent](/idl/events/BufferRelayerOpenRoundEvent) - [CrankLeaseInsufficientFundsEvent](/idl/events/CrankLeaseInsufficientFundsEvent) - [CrankPopExpectedFailureEvent](/idl/events/CrankPopExpectedFailureEvent) - [FeedPermissionRevokedEvent](/idl/events/FeedPermissionRevokedEvent) @@ -87,6 +97,7 @@ title: Overview - [AggregatorHistoryRow](/idl/types/AggregatorHistoryRow) - [AggregatorRound](/idl/types/AggregatorRound) - [BorshDecimal](/idl/types/BorshDecimal) +- [BufferRelayerRound](/idl/types/BufferRelayerRound) - [Callback](/idl/types/Callback) - [CallbackZC](/idl/types/CallbackZC) - [CompletedPointZC](/idl/types/CompletedPointZC) @@ -97,10 +108,14 @@ title: Overview - [Error](/idl/types/Error) - [FieldElementZC](/idl/types/FieldElementZC) - [Hash](/idl/types/Hash) +- [Lanes](/idl/types/Lanes) +- [Lanes](/idl/types/Lanes) - [OracleMetrics](/idl/types/OracleMetrics) - [OracleResponseType](/idl/types/OracleResponseType) - [ProjectivePointZC](/idl/types/ProjectivePointZC) - [Scalar](/idl/types/Scalar) +- [Shuffle](/idl/types/Shuffle) +- [Shuffle](/idl/types/Shuffle) - [SwitchboardDecimal](/idl/types/SwitchboardDecimal) - [SwitchboardPermission](/idl/types/SwitchboardPermission) - [VrfBuilder](/idl/types/VrfBuilder) diff --git a/website/idl/page-last-updated.svg b/website/idl/page-last-updated.svg index f664c7e..9569677 100644 --- a/website/idl/page-last-updated.svg +++ b/website/idl/page-last-updated.svg @@ -1 +1 @@ -Page LastUpdated: Apr-14-2022Page LastUpdatedApr-14-2022 \ No newline at end of file +Page LastUpdated: May-22-2022Page LastUpdatedMay-22-2022 \ No newline at end of file diff --git a/website/idl/types/BufferRelayerRound.md b/website/idl/types/BufferRelayerRound.md new file mode 100644 index 0000000..a8a0947 --- /dev/null +++ b/website/idl/types/BufferRelayerRound.md @@ -0,0 +1,9 @@ + + +| Field | Type | Description | +|--|--|--| +| numSuccess | u32 | Number of successful responses | +| numError | u32 | Number of error responses | +| roundOpenSlot | u64 | Slot when the buffer relayer round was opened | +| roundOpenTimestamp | i64 | Timestamp when the buffer relayer round was opened | +| oraclePubkey | publicKey | The public key of the oracle fulfilling the buffer relayer update request | diff --git a/website/idl/types/Error.md b/website/idl/types/Error.md index e24607e..43919d3 100644 --- a/website/idl/types/Error.md +++ b/website/idl/types/Error.md @@ -1,7 +1,7 @@ | Name | Value | Description | |--|--|--| -| InvalidPublicKey | 1 | | -| SerializationError | 2 | | -| DeserializationError | 3 | | -| InvalidDataError | 4 | | +| InvalidPublicKey | 0 | | +| SerializationError | 1 | | +| DeserializationError | 2 | | +| InvalidDataError | 3 | | diff --git a/website/idl/types/Lanes.md b/website/idl/types/Lanes.md index 2e7fd24..35cf24e 100644 --- a/website/idl/types/Lanes.md +++ b/website/idl/types/Lanes.md @@ -1,9 +1,9 @@ | Name | Value | Description | |--|--|--| -| D | 1 | | -| C | 2 | | -| AB | 3 | | -| AC | 4 | | -| AD | 5 | | -| BCD | 6 | | +| D | 0 | | +| C | 1 | | +| AB | 2 | | +| AC | 3 | | +| AD | 4 | | +| BCD | 5 | | diff --git a/website/idl/types/OracleResponseType.md b/website/idl/types/OracleResponseType.md index e8f7d5c..011eb80 100644 --- a/website/idl/types/OracleResponseType.md +++ b/website/idl/types/OracleResponseType.md @@ -1,7 +1,7 @@ | Name | Value | Description | |--|--|--| -| TypeSuccess | 1 | | -| TypeError | 2 | | -| TypeDisagreement | 3 | | -| TypeNoResponse | 4 | | +| TypeSuccess | 0 | | +| TypeError | 1 | | +| TypeDisagreement | 2 | | +| TypeNoResponse | 3 | | diff --git a/website/idl/types/Shuffle.md b/website/idl/types/Shuffle.md index 5a32848..cc97035 100644 --- a/website/idl/types/Shuffle.md +++ b/website/idl/types/Shuffle.md @@ -1,13 +1,13 @@ | Name | Value | Description | |--|--|--| -| AAAA | 1 | | -| BBBB | 2 | | -| BADC | 3 | | -| BACD | 4 | | -| ADDA | 5 | | -| CBCB | 6 | | -| ABDC | 7 | | -| ABAB | 8 | | -| DBBD | 9 | | -| CACA | 10 | | +| AAAA | 0 | | +| BBBB | 1 | | +| BADC | 2 | | +| BACD | 3 | | +| ADDA | 4 | | +| CBCB | 5 | | +| ABDC | 6 | | +| ABAB | 7 | | +| DBBD | 8 | | +| CACA | 9 | | diff --git a/website/idl/types/SwitchboardPermission.md b/website/idl/types/SwitchboardPermission.md index d0e3382..c743c80 100644 --- a/website/idl/types/SwitchboardPermission.md +++ b/website/idl/types/SwitchboardPermission.md @@ -1,6 +1,6 @@ - -| Name | Value | Description | -|--|--|--| -| PermitOracleHeartbeat | 1 | queue `authority` has permitted an Oracle Account to heartbeat on it's queue and receive update requests. Oracles _always_ need permissions to join a queue. | -| PermitOracleQueueUsage | 2 | queue `authority` has permitted an Aggregator Account to request updates from it's oracles or join an existing crank. **Note:** Not required if a queue has `unpermissionedFeedsEnabled`. | -| PermitVrfRequests | 3 | queue `authority` has permitted a VRF Account to request randomness from it's oracles. **Note:** Not required if a queue has `unpermissionedVrfEnabled`. | +| Name | Value | Description | +| ---------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| None | 0 | No assigned permissions. | +| PermitOracleHeartbeat | 1 | queue `authority` has permitted an Oracle Account to heartbeat on it's queue and receive update requests. Oracles _always_ need permissions to join a queue. | +| PermitOracleQueueUsage | 2 | queue `authority` has permitted an Aggregator Account to request updates from it's oracles or join an existing crank. **Note:** Not required if a queue has `unpermissionedFeedsEnabled`. | +| PermitVrfRequests | 4 | queue `authority` has permitted a VRF Account to request randomness from it's oracles. **Note:** Not required if a queue has `unpermissionedVrfEnabled`. | diff --git a/website/idl/types/VrfStatus.md b/website/idl/types/VrfStatus.md index 49fb4c3..ac8acb1 100644 --- a/website/idl/types/VrfStatus.md +++ b/website/idl/types/VrfStatus.md @@ -1,8 +1,9 @@ -| Name | Value | Description | -| --------------------- | ----- | ----------- | -| StatusNone | 0 | | -| StatusRequesting | 1 | | -| StatusVerifying | 2 | | -| StatusVerified | 3 | | -| StatusCallbackSuccess | 4 | | -| StatusVerifyFailure | 5 | | + +| Name | Value | Description | +|--|--|--| +| StatusNone | 0 | | +| StatusRequesting | 1 | | +| StatusVerifying | 2 | | +| StatusVerified | 3 | | +| StatusCallbackSuccess | 4 | | +| StatusVerifyFailure | 5 | | diff --git a/website/idl/types/_AggregatorAddJobParams.md b/website/idl/types/_AggregatorAddJobParams.md index 5a60111..6f50b25 100644 --- a/website/idl/types/_AggregatorAddJobParams.md +++ b/website/idl/types/_AggregatorAddJobParams.md @@ -2,3 +2,4 @@ | Field | Type | Description | |--|--|--| +| weight | Option<u8> | | diff --git a/website/idl/types/_AggregatorInitParams.md b/website/idl/types/_AggregatorInitParams.md index 0ead30f..ac72196 100644 --- a/website/idl/types/_AggregatorInitParams.md +++ b/website/idl/types/_AggregatorInitParams.md @@ -12,4 +12,5 @@ Parameters to create and initialize the AggregatorAccount. | varianceThreshold | [BorshDecimal](/idl/types/BorshDecimal) | Change percentage required between a previous round and the current round. If variance percentage is not met, reject new oracle responses. | | forceReportPeriod | i64 | Number of seconds for which, even if the variance threshold is not passed, accept new responses from oracles. | | expiration | i64 | unix_timestamp after which funds may be withdrawn from the aggregator. null/undefined/0 means the feed has no expiration. | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| disableCrank | bool | | diff --git a/website/idl/types/_AggregatorOpenRoundParams.md b/website/idl/types/_AggregatorOpenRoundParams.md index 19db062..91e43af 100644 --- a/website/idl/types/_AggregatorOpenRoundParams.md +++ b/website/idl/types/_AggregatorOpenRoundParams.md @@ -2,7 +2,7 @@ | Field | Type | Description | |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | leaseBump | u8 | | | permissionBump | u8 | | | jitter | u8 | | diff --git a/website/idl/types/_AggregatorSaveResultParams.md b/website/idl/types/_AggregatorSaveResultParams.md index 8b1b026..dfb5bf0 100644 --- a/website/idl/types/_AggregatorSaveResultParams.md +++ b/website/idl/types/_AggregatorSaveResultParams.md @@ -11,4 +11,4 @@ | feedPermissionBump | u8 | | | oraclePermissionBump | u8 | | | leaseBump | u8 | | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | diff --git a/website/idl/types/_AggregatorSetForceReportPeriodParams.md b/website/idl/types/_AggregatorSetForceReportPeriodParams.md new file mode 100644 index 0000000..3307523 --- /dev/null +++ b/website/idl/types/_AggregatorSetForceReportPeriodParams.md @@ -0,0 +1,5 @@ + + +| Field | Type | Description | +|--|--|--| +| forceReportPeriod | u32 | | diff --git a/website/idl/types/_BufferRelayerInitParams.md b/website/idl/types/_BufferRelayerInitParams.md new file mode 100644 index 0000000..a6e2bb9 --- /dev/null +++ b/website/idl/types/_BufferRelayerInitParams.md @@ -0,0 +1,7 @@ + + +| Field | Type | Description | +|--|--|--| +| name | u8[32] | | +| minUpdateDelaySeconds | u32 | | +| stateBump | u8 | | diff --git a/website/idl/types/_BufferRelayerOpenRoundParams.md b/website/idl/types/_BufferRelayerOpenRoundParams.md new file mode 100644 index 0000000..b3d8695 --- /dev/null +++ b/website/idl/types/_BufferRelayerOpenRoundParams.md @@ -0,0 +1,6 @@ + + +| Field | Type | Description | +|--|--|--| +| stateBump | u8 | | +| permissionBump | u8 | | diff --git a/website/idl/types/_BufferRelayerSaveResultParams.md b/website/idl/types/_BufferRelayerSaveResultParams.md new file mode 100644 index 0000000..fb5e656 --- /dev/null +++ b/website/idl/types/_BufferRelayerSaveResultParams.md @@ -0,0 +1,8 @@ + + +| Field | Type | Description | +|--|--|--| +| stateBump | u8 | | +| permissionBump | u8 | | +| result | bytes | | +| success | bool | | diff --git a/website/idl/types/_CrankPopParams.md b/website/idl/types/_CrankPopParams.md index 581d40e..68e87d5 100644 --- a/website/idl/types/_CrankPopParams.md +++ b/website/idl/types/_CrankPopParams.md @@ -2,7 +2,7 @@ Pops an aggregator from the crank. | Field | Type | Description | |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | leaseBumps | bytes | | | permissionBumps | bytes | | | nonce | Option<u32> | | diff --git a/website/idl/types/_CrankPushParams.md b/website/idl/types/_CrankPushParams.md index 9a2c0a1..b169fac 100644 --- a/website/idl/types/_CrankPushParams.md +++ b/website/idl/types/_CrankPushParams.md @@ -2,5 +2,5 @@ Pushes a new aggregator onto the crank. | Field | Type | Description | |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | permissionBump | u8 | | diff --git a/website/idl/types/_JobInitParams.md b/website/idl/types/_JobInitParams.md index 10926ae..0602d1c 100644 --- a/website/idl/types/_JobInitParams.md +++ b/website/idl/types/_JobInitParams.md @@ -4,5 +4,5 @@ |--|--|--| | name | u8[32] | An optional name to apply to the job account. | | expiration | i64 | unix_timestamp of when funds can be withdrawn from this account. | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | data | bytes | A serialized protocol buffer holding the schema of the job. | diff --git a/website/idl/types/_LeaseExtendParams.md b/website/idl/types/_LeaseExtendParams.md index b70e524..0668885 100644 --- a/website/idl/types/_LeaseExtendParams.md +++ b/website/idl/types/_LeaseExtendParams.md @@ -4,4 +4,5 @@ Adds fund to a LeaseAccount. Note that funds can always be withdrawn by the with |--|--|--| | loadAmount | u64 | | | leaseBump | u8 | | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| walletBumps | bytes | | diff --git a/website/idl/types/_LeaseInitParams.md b/website/idl/types/_LeaseInitParams.md index 7a10dbf..21bcb51 100644 --- a/website/idl/types/_LeaseInitParams.md +++ b/website/idl/types/_LeaseInitParams.md @@ -5,4 +5,5 @@ Parameters for initializing a LeaseAccount | loadAmount | u64 | Token amount to load into the lease escrow | | withdrawAuthority | publicKey | This authority will be permitted to withdraw funds from this lease. | | leaseBump | u8 | | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | +| walletBumps | bytes | | diff --git a/website/idl/types/_LeaseWithdrawParams.md b/website/idl/types/_LeaseWithdrawParams.md index a6c1ae2..2c310a3 100644 --- a/website/idl/types/_LeaseWithdrawParams.md +++ b/website/idl/types/_LeaseWithdrawParams.md @@ -2,6 +2,6 @@ Parameters for withdrawing from a LeaseAccount | Field | Type | Description | |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | leaseBump | u8 | | | amount | u64 | Token amount to withdraw from the lease escrow | diff --git a/website/idl/types/_OracleInitParams.md b/website/idl/types/_OracleInitParams.md index 4cf8fef..0f64b88 100644 --- a/website/idl/types/_OracleInitParams.md +++ b/website/idl/types/_OracleInitParams.md @@ -4,5 +4,5 @@ |--|--|--| | name | bytes | Name of the oracle to store on-chain. | | metadata | bytes | Metadata of the oracle to store on-chain. | -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | oracleBump | u8 | | diff --git a/website/idl/types/_OracleQueueInitParams.md b/website/idl/types/_OracleQueueInitParams.md index c90d416..74d7d14 100644 --- a/website/idl/types/_OracleQueueInitParams.md +++ b/website/idl/types/_OracleQueueInitParams.md @@ -15,3 +15,4 @@ | queueSize | u32 | The size of the queue. | | unpermissionedFeeds | bool | Enabling this setting means data feeds do not need explicit permission to join the queue. | | unpermissionedVrf | bool | | +| enableBufferRelayers | bool | | diff --git a/website/idl/types/_OracleWithdrawParams.md b/website/idl/types/_OracleWithdrawParams.md index f65a685..f208f7a 100644 --- a/website/idl/types/_OracleWithdrawParams.md +++ b/website/idl/types/_OracleWithdrawParams.md @@ -2,6 +2,6 @@ Parameters to withdraw stake and/or rewards from an OracleAccount. | Field | Type | Description | |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | permissionBump | u8 | | | amount | u64 | | diff --git a/website/idl/types/_PermissionInitParams.md b/website/idl/types/_PermissionInitParams.md index b51289c..5a60111 100644 --- a/website/idl/types/_PermissionInitParams.md +++ b/website/idl/types/_PermissionInitParams.md @@ -2,4 +2,3 @@ | Field | Type | Description | |--|--|--| -| permissionBump | u8 | | diff --git a/website/idl/types/_ProgramConfigParams.md b/website/idl/types/_ProgramConfigParams.md index 1695182..594e4c0 100644 --- a/website/idl/types/_ProgramConfigParams.md +++ b/website/idl/types/_ProgramConfigParams.md @@ -4,3 +4,4 @@ |--|--|--| | token | publicKey | | | bump | u8 | | +| daoMint | publicKey | | diff --git a/website/idl/types/_ProgramInitParams.md b/website/idl/types/_ProgramInitParams.md index 8c0801e..5271504 100644 --- a/website/idl/types/_ProgramInitParams.md +++ b/website/idl/types/_ProgramInitParams.md @@ -2,4 +2,4 @@ | Field | Type | Description | |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | diff --git a/website/idl/types/_VaultTransferParams.md b/website/idl/types/_VaultTransferParams.md index 82aa1d2..ac0d78c 100644 --- a/website/idl/types/_VaultTransferParams.md +++ b/website/idl/types/_VaultTransferParams.md @@ -2,5 +2,5 @@ | Field | Type | Description | |--|--|--| -| stateBump | u8 | | +| stateBump | u8 | The [SbState](/idl/accounts/SbState) bump used to derive its public key. | | amount | u64 | | diff --git a/website/idl/types/overview.md b/website/idl/types/overview.md index 0f9babe..e78465c 100644 --- a/website/idl/types/overview.md +++ b/website/idl/types/overview.md @@ -6,29 +6,13 @@ slug: . - [AccountMetaBorsh](/idl/types/AccountMetaBorsh) - [AccountMetaZC](/idl/types/AccountMetaZC) -- AggregatorAddJobParams - [AggregatorHistoryRow](/idl/types/AggregatorHistoryRow) -- AggregatorInitParams -- AggregatorLockParams -- AggregatorOpenRoundParams -- AggregatorRemoveJobParams - [AggregatorRound](/idl/types/AggregatorRound) -- AggregatorSaveResultParams -- AggregatorSetAuthorityParams -- AggregatorSetBatchSizeParams -- AggregatorSetHistoryBufferParams -- AggregatorSetMinJobsParams -- AggregatorSetMinOraclesParams -- AggregatorSetQueueParams -- AggregatorSetUpdateIntervalParams -- AggregatorSetVarianceThresholdParams - [BorshDecimal](/idl/types/BorshDecimal) +- [BufferRelayerRound](/idl/types/BufferRelayerRound) - [Callback](/idl/types/Callback) - [CallbackZC](/idl/types/CallbackZC) - [CompletedPointZC](/idl/types/CompletedPointZC) -- CrankInitParams -- CrankPopParams -- CrankPushParams - [CrankRow](/idl/types/CrankRow) - [EcvrfIntermediate](/idl/types/EcvrfIntermediate) - [EcvrfProofZC](/idl/types/EcvrfProofZC) @@ -36,37 +20,16 @@ slug: . - [Error](/idl/types/Error) - [FieldElementZC](/idl/types/FieldElementZC) - [Hash](/idl/types/Hash) -- JobInitParams - [Lanes](/idl/types/Lanes) - [Lanes](/idl/types/Lanes) -- LeaseExtendParams -- LeaseInitParams -- LeaseSetAuthorityParams -- LeaseWithdrawParams -- OracleHeartbeatParams -- OracleInitParams - [OracleMetrics](/idl/types/OracleMetrics) -- OracleQueueInitParams -- OracleQueueSetRewardsParams -- OracleQueueVrfConfigParams - [OracleResponseType](/idl/types/OracleResponseType) -- OracleWithdrawParams -- PermissionInitParams -- PermissionSetParams -- ProgramConfigParams -- ProgramInitParams - [ProjectivePointZC](/idl/types/ProjectivePointZC) - [Scalar](/idl/types/Scalar) - [Shuffle](/idl/types/Shuffle) - [Shuffle](/idl/types/Shuffle) - [SwitchboardDecimal](/idl/types/SwitchboardDecimal) - [SwitchboardPermission](/idl/types/SwitchboardPermission) -- VaultTransferParams - [VrfBuilder](/idl/types/VrfBuilder) -- VrfInitParams -- VrfProveAndVerifyParams -- VrfProveParams -- VrfRequestRandomnessParams - [VrfRound](/idl/types/VrfRound) - [VrfStatus](/idl/types/VrfStatus) -- VrfVerifyParams diff --git a/website/package.json b/website/package.json index 0cede2d..d9c091e 100644 --- a/website/package.json +++ b/website/package.json @@ -42,6 +42,7 @@ "@svgr/webpack": "^5.5.0", "clsx": "^1.1.1", "file-loader": "^6.2.0", + "hast-util-is-element": "1.1.0", "my-loaders": "file:plugins/my-loaders", "prism-react-renderer": "^1.2.1", "react": "^17.0.1", @@ -49,11 +50,13 @@ "react-icons": "^4.3.1", "react-player": "^2.9.0", "react-spring": "^9.3.2", + "rehype-katex": "5", + "remark-math": "3", "url-loader": "^4.1.1" }, "devDependencies": { - "@docusaurus/module-type-aliases": "^2.0.0-beta.18", - "@docusaurus/types": "^2.0.0-beta.18", + "@docusaurus/module-type-aliases": "^2.0.0-beta.20", + "@docusaurus/types": "^2.0.0-beta.20", "@tsconfig/docusaurus": "^1.0.4", "@types/eslint": "^8.4.1", "babel-plugin-import": "^1.13.3", diff --git a/website/sidebarsAPI.js b/website/sidebarsAPI.js index fa7caf3..67a1ed9 100644 --- a/website/sidebarsAPI.js +++ b/website/sidebarsAPI.js @@ -1,29 +1,4 @@ -/** - * Creating a sidebar enables you to: - - create an ordered group of docs - - render a sidebar for each doc of that group - - provide next/previous navigation - - The sidebars can be generated from the filesystem, or explicitly defined here. - - Create as many sidebars as you want. - */ - module.exports = { - // By default, Docusaurus generates a sidebar from the docs folder structure - // tutorialSidebar: [{ type: "autogenerated", dirName: "." }], - - // But you can create a sidebar manually - /* - tutorialSidebar: [ - { - type: 'category', - label: 'Tutorial', - items: ['hello'], - }, - ], - */ - tutorialSidebar: [ { type: "doc", @@ -37,24 +12,23 @@ module.exports = { }, { type: "category", - label: "Libraries", - collapsed: true, + label: "Clients", collapsible: false, items: [ { type: "link", label: "Typescript", - href: "https://docs.switchboard.xyz/api/ts", + href: "https://docs.switchboard.xyz/api/ts/", }, { type: "link", label: "Typescript Lite", - href: "https://docs.switchboard.xyz/api/ts-lite", + href: "https://docs.switchboard.xyz/api/ts-lite/", }, { type: "link", label: "Python", - href: "https://docs.switchboard.xyz/api/py", + href: "https://docs.switchboard.xyz/api/py/", }, { type: "link", diff --git a/website/src/components/CardSet.tsx b/website/src/components/CardSet.tsx new file mode 100644 index 0000000..250198e --- /dev/null +++ b/website/src/components/CardSet.tsx @@ -0,0 +1,172 @@ +import Link from "@docusaurus/Link"; +import { useColorMode } from "@docusaurus/theme-common"; +import useBaseUrl from "@docusaurus/useBaseUrl"; +import { Card, CardContent, Divider, Grid, Typography } from "@mui/material"; +import { useTheme } from "@mui/material/styles"; +import useMediaQuery from "@mui/material/useMediaQuery"; +import { styled, ThemeProvider } from "@mui/system"; +import { default as React } from "react"; +import theme from "../components/theme"; +import { FeatureItem } from "./FeatureList"; + +export type CardSetFeatureItem = { + title: string; + image: string; + description: string; + linkTo: string; +}; + +const StyledCard = styled(Card)<{ dark: number }>(({ theme, dark }) => ({ + display: "flex", + flexDirection: "column", + justifyContent: "flex-start", + alignItems: "stretch", + textAlign: "left", + backgroundColor: dark ? theme.palette.footer.background : theme.palette.white, + position: "relative", + borderRadius: "13.2px", + boxShadow: `0 6px 7px 5px rgba(${dark ? "107 107 107" : "86, 86, 86"}, 0.03)`, + [theme.breakpoints.down(300)]: { + paddingLeft: "", + }, +})); + +const StyledTitle = styled(Typography)(({ theme }) => ({ + whiteSpace: "nowrap", + fontSize: 22, + marginLeft: "22px", + fontWeight: 600, + letterSpacing: "0.16px", + + [theme.breakpoints.down(300)]: { + marginLeft: "10px", + }, +})); + +const StyledDescription = styled(Typography)(({ theme }) => ({ + fontSize: 18.5, + margin: "20px 0px 0px", + height: "110px", + lineHeight: 1.29, + letterSpacing: "0.44px", + [theme.breakpoints.down(400)]: { + fontSize: "17px", + }, + [theme.breakpoints.down(300)]: { + fontSize: 13, + }, +})); + +const StyledCardContent = styled(CardContent)(({ theme }) => ({ + padding: "21px", + [theme.breakpoints.down(300)]: { + paddingLeft: "10px", + paddingRight: "10px", + }, +})); + +export function CardSet(props: { items: FeatureItem[] }): JSX.Element { + const isMobile = useMediaQuery(theme.breakpoints.down("sm"), { + defaultMatches: true, + }); + const { colorMode } = useColorMode(); + + return ( + <> + + + {props.items.map((props, idx) => ( + + + + ))} + + + + ); +} + +export function FeatureCard({ + title, + image, + description, + linkTo, +}: CardSetFeatureItem) { + const { colorMode } = useColorMode(); + const theme = useTheme(); + + return ( + + +
    +
    + feature card +
    + + {title} + +
    + + {description} + +
    + + + View More + +
    +     +     + ); +} diff --git a/website/src/components/FeatureCard.tsx b/website/src/components/FeatureCard.tsx index 3864c6a..81897b9 100644 --- a/website/src/components/FeatureCard.tsx +++ b/website/src/components/FeatureCard.tsx @@ -2,6 +2,7 @@ import Link from "@docusaurus/Link"; import { useColorMode } from "@docusaurus/theme-common"; import useBaseUrl from "@docusaurus/useBaseUrl"; import { Card, CardContent, Divider, Typography } from "@mui/material"; +import { useTheme } from "@mui/material/styles"; import { styled } from "@mui/system"; import React from "react"; import { FeatureItem } from "./FeatureList"; @@ -55,13 +56,14 @@ const StyledCardContent = styled(CardContent)(({ theme }) => ({ }, })); -export function FeatureCard({ +export function FeatureCard({ title, image, description, linkTo, }: FeatureItem) { const { colorMode } = useColorMode(); + const theme = useTheme(); return ( diff --git a/website/src/components/FeatureList.tsx b/website/src/components/FeatureList.tsx index fe73cd9..f1c2df6 100644 --- a/website/src/components/FeatureList.tsx +++ b/website/src/components/FeatureList.tsx @@ -17,17 +17,9 @@ export const FeatureList: FeatureItem[] = [ title: "Architecture", image: "/img/icons/arc.png", description: - "Learn about the different Switchboard components and how they interact.", + "Learn about Switchboard Oracle Queues and how they allocate oracle resources on-chain.", - linkTo: "/architecture", - }, - { - title: "On-Chain", - image: "/img/icons/sol.png", - description: - "Learn how to read Switchboard data on-chain and resolve data feed updates.", - - linkTo: "/developers/js", + linkTo: "/queue", }, { title: "Oracle", @@ -36,6 +28,13 @@ export const FeatureList: FeatureItem[] = [ "Learn how to contribute to the network and process data feed updates.", linkTo: "/oracle", }, + { + title: "Data Feeds", + image: "/img/icons/sol.png", + description: "Learn how Switchboard data feeds work.", + + linkTo: "/feed", + }, { title: "Develop", image: "/img/icons/developers.png", diff --git a/website/src/components/HomepageFeatures.tsx b/website/src/components/HomepageFeatures.tsx index b4e33f7..471c015 100644 --- a/website/src/components/HomepageFeatures.tsx +++ b/website/src/components/HomepageFeatures.tsx @@ -29,12 +29,6 @@ const StyledHeaderTitle = styled(Typography)<{ dark: number }>( }) ); -export type FeatureItem = { - title: string; - image: string; - description: JSX.Element; - linkTo: string; -}; export function HomepageFeatures(): JSX.Element { const theme = useTheme(); diff --git a/website/static/img/feeds/Aggregator_Accounts.png b/website/static/img/feeds/Aggregator_Accounts.png new file mode 100644 index 0000000000000000000000000000000000000000..684f111954f5e9539222e3137e0caab4664da109 GIT binary patch literal 68913 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�_aQUBnpjO+>LHLmOib#_%Ipw~0yAt3RI5Bf37 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 NB#%o|Ir@+3{{sNTXAl4Y literal 0 HcmV?d00001 diff --git a/website/static/img/queue/Oracle_Queue_Accounts.jpg b/website/static/img/queue/Oracle_Queue_Accounts.jpg new file mode 100644 index 0000000000000000000000000000000000000000..833f849a3710851bea25f52c0156e45db5e7b253 GIT binary patch literal 34845 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