@webacy-xyz/sdk-threat 1.2.6 → 1.3.0

package/dist/types/resources/vaults.d.ts

@@ -0,0 +1,126 @@
+import { BaseResource } from '@webacy-xyz/sdk-core';
+import { VaultListResponse, VaultCursorListResponse, VaultDetailResponse, VaultListOptions, VaultCursorListOptions, VaultDetailOptions } from '../types';
+/**
+ * Resource for DeFi vault risk analysis
+ *
+ * Provides access to risk data for ERC-4626 vaults including risk scoring,
+ * looping detection, TVL analysis, and underlying asset risk assessment.
+ *
+ * @example
+ * ```typescript
+ * // List all vaults
+ * const vaults = await client.vaults.list();
+ *
+ * // Filter by protocol and risk tier
+ * const morphoHigh = await client.vaults.list({
+ *   protocol: 'morpho',
+ *   tier: 'high',
+ * });
+ *
+ * // Get detailed vault risk analysis
+ * const detail = await client.vaults.get('0x...', { chain: Chain.ETH });
+ * ```
+ */
+export declare class VaultsResource extends BaseResource {
+    /**
+     * List all rated ERC-4626 vaults with risk scores and aggregates
+     *
+     * Returns a paginated list of vaults using offset-based pagination.
+     * For cursor-based pagination, use {@link listCursor}.
+     *
+     * @param options - Filter, sort, and pagination options
+     * @returns Paginated vault list with aggregates
+     *
+     * @example
+     * ```typescript
+     * // Get all vaults
+     * const result = await client.vaults.list();
+     * console.log(`Total vaults: ${result.pagination.total}`);
+     * console.log(`Total TVL: $${result.aggregates.total_tvl_usd}`);
+     *
+     * // Filter by protocol, chain, and risk
+     * const risky = await client.vaults.list({
+     *   protocol: 'morpho',
+     *   chain: Chain.ETH,
+     *   tier: 'high',
+     *   sort: 'score_desc',
+     * });
+     *
+     * // Filter by underlying asset and attention needed
+     * const urgent = await client.vaults.list({
+     *   underlying: 'USDC',
+     *   attentionNeeded: true,
+     * });
+     *
+     * // Search and filter by risk flags
+     * const looping = await client.vaults.list({
+     *   riskFlags: 'vault-high-looping,vault-upgradeable',
+     *   riskFlagsMode: 'any',
+     * });
+     * ```
+     */
+    list(options?: VaultListOptions): Promise<VaultListResponse>;
+    /**
+     * List vaults with cursor-based pagination
+     *
+     * Returns vaults using an opaque cursor for efficient sequential pagination.
+     * Pass the `next_cursor` from a previous response to get the next page.
+     *
+     * @param options - Filter options with required cursor
+     * @returns Cursor-paginated vault list with aggregates
+     *
+     * @example
+     * ```typescript
+     * // First page
+     * const first = await client.vaults.list({ pageSize: 100 });
+     *
+     * // Subsequent pages using cursor
+     * const second = await client.vaults.listCursor({
+     *   cursor: 'opaque-cursor-from-previous-response',
+     *   limit: 100,
+     * });
+     *
+     * if (second.next_cursor) {
+     *   const third = await client.vaults.listCursor({
+     *     cursor: second.next_cursor,
+     *     limit: 100,
+     *   });
+     * }
+     * ```
+     */
+    listCursor(options: VaultCursorListOptions): Promise<VaultCursorListResponse>;
+    /**
+     * Get detailed risk data for a specific vault
+     *
+     * Returns comprehensive vault detail including metadata, risk breakdown,
+     * looping markets, composition, Morpho-specific data, and Webacy findings.
+     *
+     * @param address - Vault contract address
+     * @param options - Query options (chain is required)
+     * @returns Detailed vault risk data
+     *
+     * @example
+     * ```typescript
+     * const detail = await client.vaults.get('0x...', { chain: Chain.ETH });
+     *
+     * console.log(`Score: ${detail.risk.score}`);
+     * console.log(`TVL: $${detail.metadata.tvl_usd}`);
+     * console.log(`Protocol: ${detail.metadata.protocol}`);
+     * console.log(`Listing verdict: ${detail.metadata.listing_verdict}`);
+     *
+     * // Check Morpho-specific data
+     * if (detail.morpho) {
+     *   console.log(`Morpho liquidity: $${detail.morpho.liquidity_usd}`);
+     * }
+     *
+     * // Check risk issues
+     * for (const issue of detail.risk.issues) {
+     *   console.log(`Risk score: ${issue.score}, tags: ${issue.tags.join(', ')}`);
+     * }
+     * ```
+     */
+    get(address: string, options: VaultDetailOptions): Promise<VaultDetailResponse>;
+    /** Append filter params shared between offset and cursor list methods */
+    private appendSharedListParams;
+}
+//# sourceMappingURL=vaults.d.ts.map

package/dist/types/resources/vaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaults.d.ts","sourceRoot":"","sources":["../../../src/resources/vaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,IAAI,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkBtE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAiBnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBrF,yEAAyE;IACzE,OAAO,CAAC,sBAAsB;CAoB/B"}

package/dist/types/types/index.d.ts

@@ -8,4 +8,6 @@ export type { UsageData, CurrentUsageResponse, UsagePlan, UsagePlansResponse, Us
 export type { TransactionChain, TransactionRiskResponse, TxRiskDetails, TrustFlag, TransactionOptions, } from './transaction';
 export type { ScanChainId, ScanTransactionRequest, EIP712TypeDefinition, EIP712Domain, ScanEIP712TypedData, ScanEIP712Request, ScanRiskLevel, ScanWarning, AssetChange, ScanResponse, ScanEIP712Response, ScanOptions, RiskScanOptions, RiskScanResponse, RiskScanStatusResponse, } from './scan';
 export type { BatchContractsRequest, BatchContractsResponse, BatchAddressesRequest, BatchAddressesResponse, BatchTransactionsRequest, BatchTransactionsResponse, BatchOptions, } from './batch';
+export type { RiskTier, DisplayTier, TokenType, LiquidityTier, RwaSortField, ScoreDriver, DenominationSummary, RwaTokenListItem, DepegSummary, RwaRiskSummary, RwaPagination, RwaAggregates, RwaTokenListResponse, RwaTokenIdentity, RwaDepegSnapshot, RwaHistoryPoint, RwaHistory, RwaDepegEvent, DepegEventEntry, RwaTokenDetailResponse, RwaListOptions, RwaDetailOptions, } from './rwa';
+export type { VaultTier, VaultContractType, VaultProtocol, ListingVerdict, WithdrawalRisk, UnderlyingRiskTier, VaultSortKey, VaultContextItem, VaultListMetadata, VaultDetailMetadata, VaultRiskCategory, VaultRiskIssue, VaultRiskResponse, VaultTokenRisk, VaultLoopingMarket, VaultCompositionItem, VaultLstCollateralMarket, VaultMorphoData, VaultWebacyData, VaultListItem, VaultAggregateSummary, VaultAggregates, VaultPagination, VaultListResponse, VaultCursorListResponse, VaultDetailResponse, VaultListOptions, VaultCursorListOptions, VaultDetailOptions, } from './vault';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAG9E,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,SAAS,EACT,oBAAoB,EACpB,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,GACb,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/types/rwa.d.ts

@@ -0,0 +1,301 @@
+import { Chain } from '@webacy-xyz/sdk-core';
+import { AddressRiskResponse } from './address';
+/** Base risk tiers matching depeg_event.new_tier values */
+export type RiskTier = 'critical' | 'warning' | 'watch' | 'ok';
+/** Extended tier including the premium override for positive signed deviation */
+export type DisplayTier = RiskTier | 'premium';
+/** Pipeline-assigned token sub-classification */
+export type TokenType = 'standard' | 'yield' | 'rwa' | 'gold' | 'bridged' | 'vault';
+/** Liquidity tier based on 60-minute DEX volume thresholds */
+export type LiquidityTier = 'high' | 'medium' | 'low' | 'very_low';
+/** Sort fields for the RWA list endpoint */
+export type RwaSortField = 'score' | 'symbol' | 'chain' | 'tier' | 'abs_dev_clean' | 'market_cap_usd' | 'ts';
+/** A single component of the 12-factor depeg risk score decomposition */
+export interface ScoreDriver {
+    name: string;
+    raw: number | string | boolean | null;
+    normalized: number | null;
+    weight: number;
+    contribution: number | null;
+}
+/** Summary of a token's denomination peg configuration */
+export interface DenominationSummary {
+    /** Denomination code (e.g. USD, EUR, XAU) */
+    code: string;
+    /** Human-readable denomination name */
+    name: string;
+    /** Denomination category */
+    category: string;
+    /** Ratio of token units per denomination unit (e.g. "1.0") */
+    pegRatio: string;
+    /** Peg mechanism (e.g. "direct", "collateralized", "algorithmic") */
+    pegType: string;
+}
+/** Single token row in the paginated list response */
+export interface RwaTokenListItem {
+    address: string;
+    chain: string;
+    symbol: string;
+    name: string | null;
+    assetType: string;
+    denomination: DenominationSummary | null;
+    ts: string | null;
+    score: number | null;
+    tier: DisplayTier | null;
+    drivers: ScoreDriver[] | null;
+    price: number | null;
+    peg_value: number | null;
+    abs_dev_clean: number | null;
+    reference_price: number | null;
+    within_expected_range: boolean | null;
+    token_type: TokenType | null;
+    token_labels: string[];
+    peg_range: [number, number] | null;
+    is_collapsed: boolean;
+    market_cap_usd: number | null;
+    volume_24h: number | null;
+    circulating_supply: number | null;
+    volume_mcap_ratio: number | null;
+    liquidity_tier: LiquidityTier | null;
+    slippage_bps_100k: number | null;
+    liquidity_available_100k: boolean | null;
+    liquidity_decay_pct: number | null;
+    liquidity_decay_flag: boolean | null;
+    volume_60m: number | null;
+    volatility_burst: boolean | null;
+    volatility_ratio: number | null;
+    max_drawdown_5m: number | null;
+    mins_over_50bp_60m: number | null;
+    mins_over_100bp_60m: number | null;
+    streak_over_50bp_min: number | null;
+    streak_over_100bp_min: number | null;
+    chain_spread_5m: number | null;
+    chain_spread_60m: number | null;
+    price_source_deviation: number | null;
+    volume_z_5m: number | null;
+    volume_z_60m: number | null;
+    oracle_price: number | null;
+    oracle_deviation_bps: number | null;
+    oracle_deviation_flag: boolean | null;
+    risk: AddressRiskResponse | null;
+}
+/** Summary of a token's depeg status for aggregate leaderboards */
+export interface DepegSummary {
+    symbol: string;
+    chain: string;
+    address: string;
+    price: number | null;
+    peg_value: number | null;
+    abs_dev_clean: number;
+    score: number;
+    tier: RiskTier;
+}
+/** Summary of a token's risk for aggregate leaderboards */
+export interface RwaRiskSummary {
+    symbol: string;
+    chain: string;
+    address: string;
+    score: number;
+    tier: RiskTier;
+    market_cap_usd: number | null;
+}
+/** Pagination metadata */
+export interface RwaPagination {
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+/** Ecosystem-wide aggregates computed pre-filter */
+export interface RwaAggregates {
+    generated_at: string | null;
+    tier_counts: Record<RiskTier, number>;
+    total_mcap: number;
+    total_volume_24h: number;
+    at_peg_count: number;
+    at_peg_total: number;
+    stability_index: number;
+    biggest_depegs: DepegSummary[];
+    highest_risk: RwaRiskSummary[];
+    most_stable: RwaRiskSummary[];
+}
+/** Response for GET /rwa — paginated list with aggregates */
+export interface RwaTokenListResponse {
+    items: RwaTokenListItem[];
+    pagination: RwaPagination;
+    aggregates: RwaAggregates;
+    tier_counts: Record<RiskTier, number>;
+    stale: boolean;
+}
+/** Token identity + classification + market data */
+export interface RwaTokenIdentity {
+    address: string;
+    chain: string;
+    symbol: string;
+    name: string | null;
+    assetType: string;
+    assetTypeReason: string | null;
+    denomination: DenominationSummary | null;
+    token_type: TokenType | null;
+    token_labels: string[];
+    peg_range: [number, number] | null;
+    is_collapsed: boolean;
+    is_rwa_nav: boolean;
+    market_cap_usd: number | null;
+    volume_24h: number | null;
+    circulating_supply: number | null;
+}
+/** Full point-in-time depeg snapshot with 50+ fields from the pipeline */
+export interface RwaDepegSnapshot {
+    ts: string | null;
+    score: number | null;
+    tier: DisplayTier | null;
+    drivers: ScoreDriver[] | null;
+    price: number | null;
+    peg_value: number | null;
+    abs_dev_clean: number | null;
+    dev_clean: number | null;
+    reference_price: number | null;
+    reference_prices: Record<string, number>;
+    price_source: string | null;
+    price_sources_agree: boolean | null;
+    price_source_deviation: number | null;
+    within_expected_range: boolean | null;
+    vwap_1m: number | null;
+    vwap_5m: number | null;
+    vwap_60m: number | null;
+    vwap_clean_1m: number | null;
+    vwap_clean_5m: number | null;
+    vwap_clean_60m: number | null;
+    volume_usd_5m: number | null;
+    volume_usd_60m: number | null;
+    volume_z_5m: number | null;
+    volume_z_60m: number | null;
+    volatility_5m: number | null;
+    volatility_60m: number | null;
+    volatility_ratio: number | null;
+    volatility_burst: boolean | null;
+    volatility_burst_magnitude: number | null;
+    max_drawdown_5m: number | null;
+    max_spike_5m: number | null;
+    liquidity_tier: LiquidityTier | null;
+    slippage_bps_10k: number | null;
+    slippage_bps_100k: number | null;
+    liquidity_available_10k: boolean | null;
+    liquidity_available_100k: boolean | null;
+    liquidity_decay_pct: number | null;
+    liquidity_decay_flag: boolean | null;
+    route_hhi_10k: number | null;
+    route_hhi_100k: number | null;
+    oracle_price: number | null;
+    oracle_deviation_bps: number | null;
+    oracle_deviation_flag: boolean | null;
+    mins_over_50bp_60m: number | null;
+    mins_over_100bp_60m: number | null;
+    streak_over_50bp_min: number | null;
+    streak_over_100bp_min: number | null;
+    chain_spread_5m: number | null;
+    chain_spread_60m: number | null;
+    data_alerts: string[];
+}
+/** Compact history point for time series charting */
+export interface RwaHistoryPoint {
+    ts: string;
+    score: number | null;
+    tier: DisplayTier | null;
+    abs_dev_clean: number | null;
+    price: number | null;
+    peg_value: number | null;
+}
+/** History container with time series points */
+export interface RwaHistory {
+    hours: number;
+    series: RwaHistoryPoint[];
+    consecutive_days_below_peg: number | null;
+}
+/** Curated narrative events (editorially maintained) */
+export interface RwaDepegEvent {
+    id: string;
+    name: string;
+    symbol: string;
+    chain: string;
+    address: string;
+    start: string;
+    end: string;
+    notes: string;
+}
+/** Live DB-tracked depeg events */
+export interface DepegEventEntry {
+    eventType: string;
+    oldTier: string | null;
+    newTier: string;
+    riskScore: number;
+    deviationPct: number;
+    detectedAt: string;
+}
+/** Response for GET /rwa/:address — full token detail with history and events */
+export interface RwaTokenDetailResponse {
+    token: RwaTokenIdentity;
+    snapshot: RwaDepegSnapshot;
+    risk: AddressRiskResponse | null;
+    history: RwaHistory;
+    depegEvents: DepegEventEntry[];
+    events: RwaDepegEvent[];
+    stale: boolean;
+}
+/**
+ * Options for listing pegged tokens
+ *
+ * All parameters are optional. When none are provided, returns the first page
+ * of all tracked pegged tokens sorted by default ordering.
+ */
+export interface RwaListOptions {
+    /** Filter by blockchain network */
+    chain?: Chain;
+    /** Filter by denomination code (e.g. USD, EUR, XAU) */
+    denomination?: string;
+    /** Filter by risk tier */
+    tier?: RiskTier;
+    /** Filter by token labels (OR logic). e.g. ['standard', 'yield', 'rwa'] */
+    tags?: TokenType[];
+    /** Minimum risk score (0-100) */
+    minScore?: number;
+    /** Maximum risk score (0-100) */
+    maxScore?: number;
+    /** Minimum market cap in USD */
+    minMcap?: number;
+    /** Filter by liquidity tier */
+    liquidity?: LiquidityTier;
+    /** Search by symbol, name, or address (max 100 chars) */
+    q?: string;
+    /** Sort field */
+    sort?: RwaSortField;
+    /** Sort direction */
+    order?: 'asc' | 'desc';
+    /** Include excluded/problematic tokens that are normally hidden */
+    showAll?: boolean;
+    /** Return only collapsed/dead tokens (graveyard view). Overrides showAll */
+    collapsedOnly?: boolean;
+    /** Page number (1-indexed, default 1) */
+    page?: number;
+    /** Items per page (default 50, max 500) */
+    pageSize?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+/**
+ * Options for getting detailed depeg risk data for a specific pegged token
+ */
+export interface RwaDetailOptions {
+    /** Chain to query. Auto-resolved when address exists on one chain only */
+    chain?: Chain;
+    /** Hours of history to return (default 24, max 168 = 7 days) */
+    hours?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=rwa.d.ts.map

package/dist/types/types/rwa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rwa.d.ts","sourceRoot":"","sources":["../../../src/types/rwa.ts"],"names":[],"mappings":"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"}