Switchboard Iota Feeds Skill

Purpose

Use Switchboard on-demand feeds on Iota:

• store job definitions and create aggregators

• crank updates using Iota transactions (pull model)

• consume results in Move with freshness/deviation checks

Dependencies

Use exact pins from the SDK Version Matrix.

• @switchboard-xyz/iota-sdk@0.0.3

• @switchboard-xyz/common@5.8.2

• @iota/iota-sdk@1.11.0

Preconditions

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

Inputs to Collect

• network (mainnet/testnet)

• RPC endpoint

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

• aggregator/feed object IDs

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

Invariants

• Pull-based: updates must be executed client-side.

• Transaction ordering matters: update before consume.

Playbook (high-level)

1. Resolve Switchboard state/queue for the network.

2. Store jobs (if creating a new feed) and initialize aggregator.

3. Fetch update transaction/actions and execute them.

4. Call consumer Move function after update actions.

5. Enforce staleness/deviation in Move.

Minimal Example

import { Aggregator, SwitchboardClient } from "@switchboard-xyz/iota-sdk";
import { Transaction } from "@iota/iota-sdk/transactions";

const sb = new SwitchboardClient(iotaClient);
const aggregator = new Aggregator(sb, aggregatorId);

const tx = new Transaction();
await aggregator.fetchUpdateTx(tx);
await iotaClient.signAndExecuteTransaction({ signer: keypair, transaction: tx });

References

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

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