switchboard-v2

A monorepo containing APIs, Utils, and examples for Switchboard V2.

Table of Contents

Libraries

Package	Description
Typescript	Typescript client to interact with Switchboard V2.
Typescript Lite	Typescript "Lite" client to deserialize aggregator accounts
Sbv2 Utils	Typescript library with helpful utility functions
Python	Python client to interact with Switchboard V2.
Rust	Rust client to interact with Switchboard V2.
CLI	Command Line Interface (CLI) to interact with Switchboard V2.

Program Examples

Package	Description
anchor-feed-parser	Anchor example program demonstrating how to deserialize and read an onchain aggregator.
spl-feed-parser	Solana Program Library example 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.

Client Examples

Package	Description
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.
lease-observer	Typescript example demonstrating how to send PagerDuty alerts when your aggregator lease is low on funds.

Dependencies

• Node and Yarn
• Docker Compose
• Rust
• Solana
• Anchor
• Python3

Setup

yarn install
yarn workspaces run build
yarn workspace @switchboard-xyz/switchboardv2-cli link
anchor build && node ./scripts/setup-example-programs.js

Localnet Testing Setup

You may wish to run your own oracle for integration test. The following command will create a devnet Switchboard environment and output a Switchboard.env file to assist copying

sbv2 localnet:env --keypair ../payer-keypair.json -o .switchboard

Set the [provider.cluster] in Anchor.toml to localnet.

Run each of the commands in a separate shell

• ./.switchboard/start-local-validator.sh
• ./.switchboard/start-oracle.sh
• anchor test --skip-local-validator

Website

yarn workspace website start