11Guard

Insight Guard SDK · Oracle intelligence for DeFi agents

Bring oracle evidence into agent decisions.

Assess oracle risk without submitting a transaction, monitor conditions with Oracle Watch, or use the optional gated swap workflow. Insight supplies assessments and price/fill evidence; your application owns its decisions, signer, and execution.

01Oracle assessment
02Ongoing monitoring
03Signed price/fill evidence

Guarded execution03 / 03

Gate the intentTwo-sided pre-trade proof
Observe the runWatch · pause · resume
Prove settlementTransaction · signed receipt

Responsibility boundary / 01

Evidence in. Your policy out.

Insight Guard providesAssessments, watch signals, and signed receipts.

Observe oracle conditions before and during an execution workflow.

Your application controlsPolicy, signer, and transaction submission.

Decide which verdicts halt the strategy and what to submit on-chain.

01 — One guarded workflow · npm v0.5.1

Start with an assessment. Choose how to act on it.

Use REST, MCP, or assessSwap() for oracle assessments. Use executeSwap() when you want the SDK to gate your transaction callback and request execution evidence.

Assess before submitting

Run source and destination Pre-Trade checks. DANGER and BLOCK stop the workflow before your transaction function is called.

Watch while running

Poll Oracle Watch at a bounded cadence and bind its halt signal to the strategy pause operation.

Retain price/fill evidence

Bind signed source and destination assessments to observed settlement and report price/fill fidelity in a signed execution receipt.

02 — Quickstart

Choose the optional gated swap workflow.

Install the package in a trusted agent runtime. Never expose an Insight API key in a browser bundle.

Use v3 pre-trade attestations by default.

Pass both sides of a swap to receive a VERIFIED receipt.

Bind Oracle Watch onHalt to your strategy pause operation.

Install

npm install oracle-insight-guard

Guarded swap

import { InsightGuard } from 'oracle-insight-guard';

const guard = new InsightGuard({ apiKey: process.env.INSIGHT_API_KEY! });

const result = await guard.executeSwap({
  source: {
    asset: 'ETH', destinationAsset: 'USDC', chainId: 1,
    action: 'swap', tradeAmountUsd: 100_000,
  },
  destination: {
    asset: 'USDC', destinationAsset: 'ETH', chainId: 1,
    action: 'swap', tradeAmountUsd: 100_000,
  },
  watchTarget: { symbol: 'ETH', chain: 'ethereum' },
  receipt: { settlementChainId: 1, maxSlippageBps: 50 },
  submitTransaction: async () => ({ txHash: await submitSwap() }),
});

if (result.status === 'blocked') return; // no transaction was submitted
console.log(result.receipt.executionStatus);

03 — Between trades

Treat a halt signal as an operational event.

Guard defaults to a 15-minute Watch cadence. A halt is remembered for that target; pass the same target to executeSwap to prevent a new submission while the halt is active.

Oracle Watch

const watch = guard.watch(
  { symbol: 'ETH', chain: 'ethereum' },
  {
    onHalt: async (signal) => strategy.pause(signal.reason),
    onError: (error) => logger.error(error),
  }
);

Keep your existing API access. Add the guarded path on top.

Guard uses the same API key and the existing C3/C4 credit meter: pre-trade and Watch calls are C3; execution receipt issuance is C4. A successful two-sided guarded swap uses 20 credits at current prices (two C3 gates plus one C4 receipt), excluding Watch polling. There is no second billing model.

Create an API key Read integration docs

A translucent blue glacier sculpture revealing deep layers beneath its surface

INSIGHT / ORACLE INTELLIGENCEFIELD NOTE 001 — BENEATH THE PRICE

Transparency for decisions that matter

Go beneath
the price.

A price is a surface. Insight reveals the oracle sources, their agreement, their freshness, and the risk of acting on them — and returns a signed pre-trade verdict for AI agents that act on prices without a human in the loop.

Explore the evidence Run a safety check

SCROLL TO EXAMINE

Bring oracle evidence into agent decisions.

01Oracle assessment

02Ongoing monitoring

03Signed price/fill evidence

import { InsightGuard } from 'oracle-insight-guard'; const guard = new InsightGuard({ apiKey: process.env.INSIGHT_API_KEY! }); const result = await guard.executeSwap({ source: { asset: 'ETH', destinationAsset: 'USDC', chainId: 1, action: 'swap', tradeAmountUsd: 100_000, }, destination: { asset: 'USDC', destinationAsset: 'ETH', chainId: 1, action: 'swap', tradeAmountUsd: 100_000, }, watchTarget: { symbol: 'ETH', chain: 'ethereum' }, receipt: { settlementChainId: 1, maxSlippageBps: 50 }, submitTransaction: async () => ({ txHash: await submitSwap() }), }); if (result.status === 'blocked') return; // no transaction was submitted console.log(result.receipt.executionStatus);

Keep your existing API access. Add the guarded path on top.

Evidence in. Your policy out.

Start with an assessment. Choose how to act on it.

Assess before submitting

Watch while running

Retain price/fill evidence

Choose the optional gated swap workflow.

Treat a halt signal as an operational event.

Keep your existing API access. Add the guarded path on top.

Go beneaththe price.

Evidence in. Your policy out.

Start with an assessment. Choose how to act on it.

Assess before submitting

Watch while running

Retain price/fill evidence

Choose the optional gated swap workflow.

Treat a halt signal as an operational event.

Keep your existing API access. Add the guarded path on top.

Go beneath
the price.