@agg-build/hooks 4.11.0 → 4.17.0

package/dist/index.d.mts

@@ -250,6 +250,51 @@ type OrderListItem = {
      * or a venue-specific tag.
      */
     partialFillReason: string | null;
+    /**
+     * Fee breakdown. Optional so paper-trading orders, which have no venue
+     * fees, no bridges and no app-fee charge, stay valid without fabricating
+     * a zeroed breakdown that would read as "this trade was free".
+     *
+     * `quoted` is what the route promised at accept time; `actual` is money
+     * that moved. `actual.appFee` and `actual.bridge` are TRADE-level and
+     * shared by every order under one `actual.dagRunId` — group by it before
+     * summing. `quoted.venueFeeRaw` and `actual.venueFeeRaw` are per-leg.
+     */
+    fees?: {
+        /**
+         * How the venue charges: `"fill"`, `"fill_in_game_only"`,
+         * `"winnings"`, `"exit"`, or null when the schedule cannot be
+         * expressed as a rate. Decides what the venue-fee figures mean.
+         */
+        venueFeeBasis: string | null;
+        quoted: {
+            /** 6-dec USD atoms. Null when the router emitted no fee for this leg. */
+            venueFeeRaw: string | null;
+            /** Worst-case partner fee if the route fills 100%. */
+            appFeeRaw: string | null;
+            appFeeBips: number | null;
+        };
+        actual: {
+            /** Null until the order reaches a DAG run. */
+            dagRunId: string | null;
+            /** Venue-reported fee, 6-dec USD atoms. Null = unknown, never free. */
+            venueFeeRaw: string | null;
+            appFee: {
+                bips: number;
+                /** floor(filled × bips / 10_000). */
+                dueRaw: string;
+                /** Below `dueRaw` on `under_collected`, "0" on skips. */
+                collectedRaw: string;
+                status: string;
+            } | null;
+            bridge: {
+                relayFeeUsd: string | null;
+                originGasCostUsd: string | null;
+                operationCount: number;
+                pricedOperationCount: number;
+            } | null;
+        };
+    } | undefined;
     txHash: string | null;
     errorMessage: string | null;
     dagRunId: string | null;
@@ -309,6 +354,8 @@ type VenueMarket = {
         title?: string | null | undefined;
         externalIdentifier?: string | null | undefined;
         winner?: boolean | null | undefined;
+        /** Per-share USDC payout of this outcome in [0, 1] once settled; source of truth over `winner` when set. */
+        payoutPerShare?: number | null | undefined;
         /** Counterpart outcomes on matched sibling markets — only populated
          *  on the parent (queried) market's outcomes. Each entry is a
          *  `{ venueMarketId, venueMarketOutcomeId }` ref into the same
@@ -348,6 +395,16 @@ type VenueMarket = {
     marketSubtype?: string | null | undefined;
     /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
     lineValue?: number | null | undefined;
+    /** Per-market minimum order size in shares/contracts, where AGG ingests one:
+     *  Polymarket (the market's own floor) and PRED (0.001); null elsewhere.
+     *  POST /execution/limit-orders validates `sizeRaw` against it on Polymarket.
+     *  `null` means no value was ingested — NOT that the market is unconstrained;
+     *  other venues enforce floors this field does not carry. */
+    minOrderSize?: number | null | undefined;
+    /** Price increment from venue metadata — a seed, not a guarantee. Prefer the
+     *  runtime-inferred `tick` from the orderbook endpoints when aligning a limit
+     *  price: the live grid can be finer than this. */
+    tickSize?: number | null | undefined;
     matchedVenueMarkets?: {
         id: string;
         venue: Venue;
@@ -365,6 +422,8 @@ type VenueMarket = {
             venueMarketId: string;
             label: string;
             winner?: boolean | null | undefined;
+            /** Per-share USDC payout of this outcome in [0, 1] once settled; source of truth over `winner` when set. */
+            payoutPerShare?: number | null | undefined;
         }[] | undefined;
         volume?: number | null | undefined;
         venueEvent?: {
@@ -475,6 +534,8 @@ type VenueMarketOutcome = {
     title?: string | null | undefined;
     externalIdentifier?: string | null | undefined;
     winner?: boolean | null | undefined;
+    /** Per-share USDC payout of this outcome in [0, 1] once settled; source of truth over `winner` when set. */
+    payoutPerShare?: number | null | undefined;
     /** Counterpart outcomes on matched sibling markets — only populated on
      *  the parent (queried) market's outcomes. */
     matchedVenueMarketOutcomes?: MatchedVenueMarketOutcomeRef[];

package/dist/index.d.ts

@@ -250,6 +250,51 @@ type OrderListItem = {
      * or a venue-specific tag.
      */
     partialFillReason: string | null;
+    /**
+     * Fee breakdown. Optional so paper-trading orders, which have no venue
+     * fees, no bridges and no app-fee charge, stay valid without fabricating
+     * a zeroed breakdown that would read as "this trade was free".
+     *
+     * `quoted` is what the route promised at accept time; `actual` is money
+     * that moved. `actual.appFee` and `actual.bridge` are TRADE-level and
+     * shared by every order under one `actual.dagRunId` — group by it before
+     * summing. `quoted.venueFeeRaw` and `actual.venueFeeRaw` are per-leg.
+     */
+    fees?: {
+        /**
+         * How the venue charges: `"fill"`, `"fill_in_game_only"`,
+         * `"winnings"`, `"exit"`, or null when the schedule cannot be
+         * expressed as a rate. Decides what the venue-fee figures mean.
+         */
+        venueFeeBasis: string | null;
+        quoted: {
+            /** 6-dec USD atoms. Null when the router emitted no fee for this leg. */
+            venueFeeRaw: string | null;
+            /** Worst-case partner fee if the route fills 100%. */
+            appFeeRaw: string | null;
+            appFeeBips: number | null;
+        };
+        actual: {
+            /** Null until the order reaches a DAG run. */
+            dagRunId: string | null;
+            /** Venue-reported fee, 6-dec USD atoms. Null = unknown, never free. */
+            venueFeeRaw: string | null;
+            appFee: {
+                bips: number;
+                /** floor(filled × bips / 10_000). */
+                dueRaw: string;
+                /** Below `dueRaw` on `under_collected`, "0" on skips. */
+                collectedRaw: string;
+                status: string;
+            } | null;
+            bridge: {
+                relayFeeUsd: string | null;
+                originGasCostUsd: string | null;
+                operationCount: number;
+                pricedOperationCount: number;
+            } | null;
+        };
+    } | undefined;
     txHash: string | null;
     errorMessage: string | null;
     dagRunId: string | null;
@@ -309,6 +354,8 @@ type VenueMarket = {
         title?: string | null | undefined;
         externalIdentifier?: string | null | undefined;
         winner?: boolean | null | undefined;
+        /** Per-share USDC payout of this outcome in [0, 1] once settled; source of truth over `winner` when set. */
+        payoutPerShare?: number | null | undefined;
         /** Counterpart outcomes on matched sibling markets — only populated
          *  on the parent (queried) market's outcomes. Each entry is a
          *  `{ venueMarketId, venueMarketOutcomeId }` ref into the same
@@ -348,6 +395,16 @@ type VenueMarket = {
     marketSubtype?: string | null | undefined;
     /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
     lineValue?: number | null | undefined;
+    /** Per-market minimum order size in shares/contracts, where AGG ingests one:
+     *  Polymarket (the market's own floor) and PRED (0.001); null elsewhere.
+     *  POST /execution/limit-orders validates `sizeRaw` against it on Polymarket.
+     *  `null` means no value was ingested — NOT that the market is unconstrained;
+     *  other venues enforce floors this field does not carry. */
+    minOrderSize?: number | null | undefined;
+    /** Price increment from venue metadata — a seed, not a guarantee. Prefer the
+     *  runtime-inferred `tick` from the orderbook endpoints when aligning a limit
+     *  price: the live grid can be finer than this. */
+    tickSize?: number | null | undefined;
     matchedVenueMarkets?: {
         id: string;
         venue: Venue;
@@ -365,6 +422,8 @@ type VenueMarket = {
             venueMarketId: string;
             label: string;
             winner?: boolean | null | undefined;
+            /** Per-share USDC payout of this outcome in [0, 1] once settled; source of truth over `winner` when set. */
+            payoutPerShare?: number | null | undefined;
         }[] | undefined;
         volume?: number | null | undefined;
         venueEvent?: {
@@ -475,6 +534,8 @@ type VenueMarketOutcome = {
     title?: string | null | undefined;
     externalIdentifier?: string | null | undefined;
     winner?: boolean | null | undefined;
+    /** Per-share USDC payout of this outcome in [0, 1] once settled; source of truth over `winner` when set. */
+    payoutPerShare?: number | null | undefined;
     /** Counterpart outcomes on matched sibling markets — only populated on
      *  the parent (queried) market's outcomes. */
     matchedVenueMarketOutcomes?: MatchedVenueMarketOutcomeRef[];

package/dist/index.js

@@ -8788,22 +8788,28 @@ var RECURRING_MARKET_STATUSES = [
 var RECURRING_DURATION_MS = {
   PT5M: 5 * 6e4,
   PT15M: 15 * 6e4,
+  PT30M: 30 * 6e4,
   PT1H: 60 * 6e4,
+  PT4H: 4 * 60 * 6e4,
   P1D: 24 * 60 * 6e4
 };
 var RECURRING_SLUG_DURATION = {
   "5m": "PT5M",
   "15m": "PT15M",
+  "30m": "PT30M",
   "1h": "PT1H",
+  "4h": "PT4H",
   "1d": "P1D"
 };
 var RECURRING_DURATION_AGG_KEY_SEGMENT = {
   PT5M: "5m",
   PT15M: "15m",
-  PT1H: "1h"
+  PT30M: "30m",
+  PT1H: "1h",
+  PT4H: "4h"
 };
-var RECURRING_CRYPTO_SLUG_PATTERN = /^([a-z0-9]+)-updown-(5m|15m|1h|1d)-(\d+)$/i;
-var RECURRING_CRYPTO_AGG_KEY_PATTERN = /^agg_ud_([a-z0-9]+)_(5m|15m|1h)_(\d{2})(\d{2})(\d{2})T(\d{2})(\d{2})$/i;
+var RECURRING_CRYPTO_SLUG_PATTERN = /^([a-z0-9]+)-updown-(5m|15m|30m|1h|4h|1d)-(\d+)$/i;
+var RECURRING_CRYPTO_AGG_KEY_PATTERN = /^agg_ud_([a-z0-9]+)_(5m|15m|30m|1h|4h)_(\d{2})(\d{2})(\d{2})T(\d{2})(\d{2})$/i;
 var RECURRING_CRYPTO_DAILY_AGG_KEY_PATTERN = /^agg_ud_([a-z0-9]+)_1d_(\d{2})(\d{2})(\d{2})$/i;
 var isRecurringCryptoDuration = (value) => value != null && Object.prototype.hasOwnProperty.call(RECURRING_DURATION_MS, value);
 var parseTimestamp = (value) => {

package/dist/index.mjs

@@ -2789,22 +2789,28 @@ var RECURRING_MARKET_STATUSES = [
 var RECURRING_DURATION_MS = {
   PT5M: 5 * 6e4,
   PT15M: 15 * 6e4,
+  PT30M: 30 * 6e4,
   PT1H: 60 * 6e4,
+  PT4H: 4 * 60 * 6e4,
   P1D: 24 * 60 * 6e4
 };
 var RECURRING_SLUG_DURATION = {
   "5m": "PT5M",
   "15m": "PT15M",
+  "30m": "PT30M",
   "1h": "PT1H",
+  "4h": "PT4H",
   "1d": "P1D"
 };
 var RECURRING_DURATION_AGG_KEY_SEGMENT = {
   PT5M: "5m",
   PT15M: "15m",
-  PT1H: "1h"
+  PT30M: "30m",
+  PT1H: "1h",
+  PT4H: "4h"
 };
-var RECURRING_CRYPTO_SLUG_PATTERN = /^([a-z0-9]+)-updown-(5m|15m|1h|1d)-(\d+)$/i;
-var RECURRING_CRYPTO_AGG_KEY_PATTERN = /^agg_ud_([a-z0-9]+)_(5m|15m|1h)_(\d{2})(\d{2})(\d{2})T(\d{2})(\d{2})$/i;
+var RECURRING_CRYPTO_SLUG_PATTERN = /^([a-z0-9]+)-updown-(5m|15m|30m|1h|4h|1d)-(\d+)$/i;
+var RECURRING_CRYPTO_AGG_KEY_PATTERN = /^agg_ud_([a-z0-9]+)_(5m|15m|30m|1h|4h)_(\d{2})(\d{2})(\d{2})T(\d{2})(\d{2})$/i;
 var RECURRING_CRYPTO_DAILY_AGG_KEY_PATTERN = /^agg_ud_([a-z0-9]+)_1d_(\d{2})(\d{2})(\d{2})$/i;
 var isRecurringCryptoDuration = (value) => value != null && Object.prototype.hasOwnProperty.call(RECURRING_DURATION_MS, value);
 var parseTimestamp = (value) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/hooks",
-  "version": "4.11.0",
+  "version": "4.17.0",
   "description": "React hooks and providers for the AGG prediction market aggregator. Wraps @agg-build/sdk with TanStack Query, shared session state, and live WebSocket data.",
   "sideEffects": false,
   "license": "MIT",
@@ -83,7 +83,7 @@
     "react": "^18.0.0 || ^19.0.0",
     "viem": "^2.0.0",
     "wagmi": "^3.0.0 || ^2.0.0",
-    "@agg-build/sdk": "^4.11.0"
+    "@agg-build/sdk": "^4.17.0"
   },
   "peerDependenciesMeta": {
     "@solana/wallet-adapter-react": {