Switchboard Aptos Feeds Skill

Purpose

Use Switchboard on-demand feeds on Aptos:

• crank/update feeds client-side (pull model)

• consume verified results in Move

• enforce freshness/deviation policies in app logic

Dependencies

Use exact pins from the SDK Version Matrix.

• @switchboard-xyz/aptos-sdk@0.1.5

• @switchboard-xyz/common@5.7.0

• @aptos-labs/ts-sdk@6.1.0

Preconditions

• OperatorPolicy exists (Aptos network, signer custody, RPC allowlist).

Inputs to Collect

• network (mainnet/testnet)

• RPC endpoint

• crossbarUrl (default: https://crossbar.switchboard.xyz)

• aggregator/feed identifiers (addresses/object IDs)

• safety policy (staleness/deviation/min responses) only if risk-sensitive

Invariants

• Pull-based: client must crank/update feeds to keep data fresh.

• Ensure update action is executed before reading within the same flow (where applicable).

Playbook (high-level)

• Off-chain:

  • fetch/update payload(s) for the feed/aggregator

  • submit transaction to run the update action (or include it in the same entry call if supported)

• On-chain:

  • read current result + timestamp

  • enforce staleness and deviation vs last stored value

Minimal Example

use aptos_framework::aptos_coin::AptosCoin;
use aptos_framework::object::{Self, Object};
use switchboard::aggregator::{Self, Aggregator, CurrentResult};
use switchboard::update_action;

public entry fun read_feed(account: &signer, update_data: vector<vector<u8>>) {
    update_action::run<AptosCoin>(account, update_data);
    let feed: Object<Aggregator> = object::address_to_object<Aggregator>(@0xSomeFeedAddress);
    let current: CurrentResult = aggregator::current_result(feed);
    let _price = aggregator::result(&current);
}

Outputs

Produce an AptosFeedIntegrationPlan including:

• identifiers and network alignment checks

• crank strategy (if requested)

• Move consumption point and validation policy (if requested)

References

• https://docs.switchboard.xyz/docs-by-chain/aptos

• https://docs.switchboard.xyz/tooling/crossbar