madeonsol-x402 3.0.0 → 3.2.0

package/dist/types.d.ts

@@ -97,7 +97,7 @@ export interface KolFeedParams {
     limit?: number;
     /** Poll cursor — only trades strictly newer than this ISO time (feed back next_since). */
     since?: string;
-    /** "token" embeds the /token/{mint} snapshot on each row (≤20 distinct mints per page). */
+    /** REST only: "token" embeds the /token/{mint} snapshot on each row (≤20 distinct mints per page). The x402 route rejects it before payment (400 param_not_supported_on_x402). */
     include?: "token";
     /** LEGACY cursor — ISO 8601 timestamp; returns trades strictly older than this (skips same-timestamp rows). Prefer `cursor`. */
     before?: string;
@@ -206,7 +206,7 @@ export interface KolCoordinationParams {
     unique_strategies?: boolean;
     /** v1.1 — include major memecoins (WIF/BONK/POPCAT). Default false. */
     include_majors?: boolean;
-    /** REST only: "risk" embeds /tokens/{mint}/risk per cluster (at most 20 distinct mints). The x402 route ignores it. */
+    /** REST only: "risk" embeds /tokens/{mint}/risk per cluster (at most 20 distinct mints). The x402 route rejects it before payment (400 param_not_supported_on_x402). */
     include?: "risk";
     /** v1.1 — peak-density window in minutes (1-60). Default 15. */
     window_minutes?: number;
@@ -466,7 +466,7 @@ export interface KolLeaderboardParams {
     /** Time window. 90d/180d fill up over time as kol_trades retention (180 days) accumulates. */
     period?: "today" | "7d" | "30d" | "90d" | "180d";
     limit?: number;
-    /** REST only (0-10000). The x402 route ignores it. */
+    /** REST only (0-10000). The x402 route rejects it before payment (400 param_not_supported_on_x402). */
     offset?: number;
     /** PRO+: sort axis (default "pnl") */
     sort?: KolLeaderboardSort;
@@ -561,7 +561,9 @@ export interface DeployerAlertsParams {
     min_kol_buys?: number;
 }
 /** v2.10: every event the registry accepts (src/lib/webhook-events.ts VALID_EVENTS); earlier types listed only the first four. */
-export type WebhookEvent = "kol:trade" | "kol:coordination" | "deployer:alert" | "deployer:bond" | "wallet_tracker:event" | "sniper:deploy" | "rhc:kol_trade" | "token:surge" | "token:revival";
+export type WebhookEvent = "kol:trade" | "kol:coordination" | "deployer:alert" | "deployer:bond" | "wallet_tracker:event" | "sniper:deploy" | "rhc:kol_trade" | "token:surge" | "token:revival"
+/** Realtime developer sells / buys / token transfers (PRO+; identity fields ULTRA+). Dedupe on payload `id`. */
+ | "dev:activity";
 export interface WebhookFilters {
     min_sol?: number;
     action?: "buy" | "sell";
@@ -575,6 +577,10 @@ export interface WebhookFilters {
     exclude_flags?: string[];
     min_mc_usd?: number;
     max_mc_usd?: number;
+    /** dev:activity only. */
+    types?: Array<"dev_sell" | "dev_buy" | "dev_token_transfer_out" | "dev_token_transfer_in">;
+    token_mints?: string[];
+    deployers?: string[];
     /** ULTRA/BUSINESS custom conditions (max 10). */
     conditions?: WebhookCondition[];
 }
@@ -735,7 +741,7 @@ export interface KolPairsParams {
     period?: "7d" | "30d";
     min_shared?: number;
     limit?: number;
-    /** REST only (0-10000). The x402 route ignores it. */
+    /** REST only (0-10000). The x402 route rejects it before payment (400 param_not_supported_on_x402). */
     offset?: number;
 }
 export interface KolTimingData {
@@ -813,7 +819,7 @@ export interface KolHotTokensParams {
     period?: "1h" | "6h";
     min_kols?: number;
     limit?: number;
-    /** REST only (0-10000): skip this many ranked tokens. The x402 route ignores it. */
+    /** REST only (0-10000): skip this many ranked tokens. The x402 route rejects it before payment (400 param_not_supported_on_x402). */
     offset?: number;
     /** PRO+: require average winrate_7d of buying KOLs >= N (0-100) */
     min_avg_winrate?: number;
@@ -2887,7 +2893,7 @@ export interface TokenTopTradersParams {
     window_days?: number;
     /** Minimum SOL bought to qualify (default 0.1). */
     min_bought_sol?: number;
-    /** REST only: skip this many ranked traders (bounded by the tier's row cap). The x402 route ignores it. */
+    /** REST only: skip this many ranked traders (bounded by the tier's row cap). The x402 route rejects it before payment (400 param_not_supported_on_x402). */
     offset?: number;
 }
 /** One wallet in a top-traders response, enriched with our own reputation data
@@ -2940,7 +2946,7 @@ export interface SniperRecentParams {
     min_bond_rate?: number;
     /** Max results, 1–200 (default 50). */
     limit?: number;
-    /** REST only, ULTRA: narrow to your custom deployer watchlist. The x402 route ignores it. */
+    /** REST only, ULTRA: narrow to your custom deployer watchlist. The x402 route rejects it before payment (400 param_not_supported_on_x402). */
     watchlist?: boolean;
 }
 /** One deshred-detected pump.fun deploy — surfaces ~500ms before on-chain
@@ -4490,6 +4496,142 @@ export interface DeployerRewardsResponse {
         note: string;
     };
 }
+export type DeployerActivityEventType = "launch" | "dev_buy" | "dev_sell" | "creator_transferred" | "fee_claim" | "funding_in" | "capital_out";
+/**
+ * One event of a deployer's activity timeline. Fields present depend on
+ * `type`; addresses are raw facts of the concrete event, never identity claims.
+ */
+export interface DeployerActivityEvent {
+    id: string;
+    type: DeployerActivityEventType;
+    /** Time of the event itself (the window applies to this). */
+    at: string;
+    time_basis: "chain" | "ingest" | "chain_or_ingest";
+    mint?: string | null;
+    name?: string | null;
+    symbol?: string | null;
+    launchpad?: string | null;
+    bonded_at?: string | null;
+    /** launch: whether the creator paid the create fee (null = unknown). The payer address is never in this response. */
+    fee_payer_is_creator?: boolean | null;
+    external_fee_payer?: boolean | null;
+    dev_buy_sol?: number | null;
+    dev_buy_tokens?: number | null;
+    dev_buy_supply_pct?: number | null;
+    own_token?: boolean;
+    sol?: number | null;
+    tokens?: number | null;
+    price_usd?: number | null;
+    first_at?: string | null;
+    last_at?: string | null;
+    aggregate?: boolean;
+    from?: string | null;
+    to?: string | null;
+    direction?: "in" | "out";
+    initiated_by?: "creator" | "platform_admin" | "other_signer" | "unknown";
+    tx?: string;
+    kind?: "direct" | "social";
+    amount_raw?: string | null;
+    quote_mint?: string | null;
+    source?: string;
+    recipient?: string;
+    asset?: string;
+    decimals?: number | null;
+    transfer_count?: number;
+    sample_tx_ids?: string[];
+    first_tx?: string | null;
+}
+export interface DeployerActivityFamilyCoverage {
+    source: string;
+    retention: string;
+    scope?: string;
+    truncated: boolean;
+    loaded: boolean;
+    /** false: part of the window lies outside the online store (trade months only in the archive), or the boundary is unknown. */
+    complete: boolean;
+    /** Earliest instant the online store answers this family completely. */
+    complete_from: string | null;
+    /** Before this instant events exist only in the archive (not served yet); null when the window does not cross it. */
+    archive_required_before: string | null;
+    boundary_known: boolean;
+    /** Set when the family was not queried because it cannot apply (a wallet with no attributed launch has no dev trades). */
+    skipped_reason?: "no_attributed_launch";
+}
+export interface DeployerActivityRange {
+    from: string | null;
+    to: string | null;
+}
+/** Requested vs online vs archive-only history (archive reads are a planned follow-up). */
+export interface DeployerActivityHistoryPlan {
+    requested: DeployerActivityRange & {
+        source: "since_param" | "plan_default";
+    };
+    effective: DeployerActivityRange & {
+        clamped: boolean;
+        max_days: number | null;
+    };
+    online: DeployerActivityRange & {
+        served: boolean;
+    };
+    archive_only: (DeployerActivityRange & {
+        served: boolean;
+        reason: "archive_reads_not_enabled";
+    }) | null;
+}
+/**
+ * GET /deployer-hunter/{wallet}/activity — PRO+, KEYED (v1) only. Feature-flagged
+ * server-side (503 `feature_disabled` until enabled).
+ */
+export interface DeployerActivityResponse {
+    wallet: string;
+    is_deployer: boolean;
+    deployer: {
+        tier: string | null;
+        first_deploy_at: string | null;
+        last_deploy_at: string | null;
+    } | null;
+    plan: {
+        entitlement: "pro" | "ultra" | "business";
+        window_days: number | null;
+        max_limit: number;
+        history: DeployerActivityHistoryPlan;
+    };
+    window: {
+        since: string | null;
+        until: string;
+        max_days: number | null;
+        applies_to: "event_time";
+    };
+    events: DeployerActivityEvent[];
+    pagination: {
+        limit: number;
+        requested_limit: number;
+        limit_capped: boolean;
+        next_cursor: string | null;
+        has_more: boolean;
+    };
+    coverage: {
+        status: "observed" | "partial";
+        families: Record<string, DeployerActivityFamilyCoverage>;
+        future_events_dropped: number;
+        note: string;
+    };
+    /** ULTRA/BUSINESS only, absent on PRO. Currently always not_available. */
+    identity?: {
+        status: "not_available";
+        reason: "identity_stitching_not_released";
+        note: string;
+    };
+}
+export interface DeployerActivityParams {
+    /** Clamped server-side to 100 (PRO, ULTRA) or 500 (BUSINESS). */
+    limit?: number;
+    cursor?: string;
+    /** Requested window start (ISO 8601); clamped to the plan window. */
+    since?: string;
+    /** Comma list of event types. */
+    types?: string;
+}
 /** Reputation grade — the deployers.tier CHECK set (migration 031). `unranked` = too few deploys to grade, not "bad". (Earlier types listed "neutral" / "spammer", which are Robinhood Chain tiers and never appear here.) */
 export type DeployerTier = "elite" | "good" | "moderate" | "rising" | "cold" | "unranked";
 export interface DeployerTierCounts {
@@ -4622,7 +4764,10 @@ export interface DeployerProfileResponse {
     };
     /** PRO+ funding evidence (see the funding docs); absent below PRO. */
     funding?: Record<string, unknown>;
+    /** PRO+ flat funding features, incl. `funding_to_first_deploy_seconds` (to `deployer.first_deploy_at`). */
     funding_features?: Record<string, unknown>;
+    /** PRO+ capital relationships from high-signal sources (`launched_at` = `deployer.first_deploy_at`); absent below PRO. */
+    capital_intelligence?: Record<string, unknown>;
 }
 /** The `deployers` row inside {@link DeployerProfileResponse}. */
 export interface DeployerProfile {
@@ -4648,6 +4793,9 @@ export interface DeployerProfile {
     post_bond_2x_rate: number | null;
     post_bond_labeled_count: number | null;
     first_seen_at: string | null;
+    /** Earliest deploy observed by MadeOnSol for this wallet — not proof of its first-ever on-chain launch. Only moves earlier. */
+    first_deploy_at: string | null;
+    /** Latest deploy observed by MadeOnSol for this wallet. Only moves later. */
     last_deploy_at: string | null;
     last_bond_at: string | null;
     label: string | null;
@@ -4657,7 +4805,7 @@ export interface DeployerTokensParams {
     limit?: number;
     /** 0–10000, default 0. */
     offset?: number;
-    /** Documented, but NOT applied by the route today (rows are not filtered). */
+    /** true = only tokens that graduated (bonded_at set); total / has_more count the bonded set. */
     only_bonded?: boolean;
 }
 /** `GET /deployer-hunter/{wallet}/tokens` — newest bond first. */