@p2pdotme/sdk 1.2.17 → 1.2.19

package/dist/react.d.cts

@@ -166,6 +166,7 @@ declare const ZodGetStakeBoostConfigParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -281,7 +282,7 @@ interface StakeClient {
     readonly claimUnstake: ClaimUnstakeAction;
 }
 
-type OrdersErrorCode = "VALIDATION_ERROR" | "INVALID_ORDER_ID" | "INVALID_GET_ORDERS_PARAMS" | "INVALID_FEE_CONFIG_PARAMS" | "ORDER_NOT_FOUND" | "CONTRACT_READ_FAILED" | "SUBGRAPH_REQUEST_FAILED" | "SUBGRAPH_VALIDATION_FAILED" | "MALFORMED_ORDER" | "CIRCLE_SELECTION_FAILED" | "ENCRYPTION_FAILED" | "RELAY_IDENTITY_CORRUPT" | "RELAY_IDENTITY_STORE_FAILED" | "TX_SUBMISSION_FAILED" | "RECEIPT_TIMEOUT" | "TX_REVERTED" | "EVENT_WATCH_FAILED";
+type OrdersErrorCode = "VALIDATION_ERROR" | "INVALID_ORDER_ID" | "INVALID_GET_ORDERS_PARAMS" | "INVALID_FEE_CONFIG_PARAMS" | "INVALID_PLACEMENT_LIMITS_PARAMS" | "ORDER_NOT_FOUND" | "CONTRACT_READ_FAILED" | "SUBGRAPH_REQUEST_FAILED" | "SUBGRAPH_VALIDATION_FAILED" | "MALFORMED_ORDER" | "CIRCLE_SELECTION_FAILED" | "ENCRYPTION_FAILED" | "RELAY_IDENTITY_CORRUPT" | "RELAY_IDENTITY_STORE_FAILED" | "TX_SUBMISSION_FAILED" | "RECEIPT_TIMEOUT" | "TX_REVERTED" | "EVENT_WATCH_FAILED";
 declare class OrdersError extends SdkError<OrdersErrorCode> {
     constructor(message: string, options: {
         code: OrdersErrorCode;
@@ -320,6 +321,7 @@ declare const ZodGetFeeConfigParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -331,6 +333,10 @@ declare const ZodGetFeeConfigParamsSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 type GetFeeConfigParams = z.infer<typeof ZodGetFeeConfigParamsSchema>;
+declare const ZodGetPlacementLimitsParamsSchema: z.ZodObject<{
+    userAddress: z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>;
+}, z.core.$strip>;
+type GetPlacementLimitsParams = z.infer<typeof ZodGetPlacementLimitsParamsSchema>;
 declare const ZodGetOrdersParamsSchema: z.ZodObject<{
     userAddress: z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>;
     skip: z.ZodDefault<z.ZodNumber>;
@@ -346,6 +352,7 @@ declare const ZodPlaceOrderParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -440,6 +447,40 @@ interface FeeConfig {
     /** Fixed fee applied to small orders (6 decimals). */
     smallOrderFixedFee: bigint;
 }
+/**
+ * Whether a daily placement cap is actually in force.
+ * - `enforced` — a cap is set and the contract will reject placements past it.
+ * - `unlimited` — the cap is explicitly zero, which the contract reads as no
+ *   cap at all (sell/pay only; a zero buy cap blocks every buy instead).
+ * - `unknown` — no cap has been indexed yet, so nothing here should be shown
+ *   as a limit. Let the contract be the judge.
+ */
+type PlacementLimitState = "enforced" | "unlimited" | "unknown";
+/**
+ * One daily placement bucket. `used` counts every order placed today INCLUDING
+ * ones that were later cancelled — the on-chain counter is never credited back,
+ * so cancelling does not free up an allowance.
+ */
+interface PlacementBucket {
+    used: number;
+    /** The cap itself. Null unless `state` is `enforced`. */
+    limit: number | null;
+    /** `limit - used`, floored at zero. Null unless `state` is `enforced`. */
+    remaining: number | null;
+    state: PlacementLimitState;
+}
+/**
+ * Per-user daily order placement allowances, read from the subgraph. SELL and
+ * PAY draw on one shared bucket; BUY has its own. Both reset at UTC midnight.
+ */
+interface PlacementLimits {
+    /** UTC day these counts belong to (unix seconds / 86400). */
+    dayIndex: number;
+    /** Unix seconds at which the buckets reset (the next UTC midnight). */
+    resetsAt: number;
+    buy: PlacementBucket;
+    sellPay: PlacementBucket;
+}
 interface PreparedTxMeta {
     readonly circleId?: bigint;
     readonly relayIdentity?: RelayIdentity;
@@ -548,6 +589,15 @@ interface OrdersClient {
      * fee itself. Both are 6-decimal bigints.
      */
     getFeeConfig(params: GetFeeConfigParams): ResultAsync<FeeConfig, OrdersError>;
+    /**
+     * Reads the user's daily order placement allowances from the subgraph — how
+     * many buy and sell/pay orders they have placed today and the caps in force.
+     * Cancelled orders still count; SELL and PAY share one bucket.
+     *
+     * Advisory only: the subgraph lags the chain, so use it to warn or disable a
+     * button, never as the final word on whether a placement will succeed.
+     */
+    getPlacementLimits(params: GetPlacementLimitsParams): ResultAsync<PlacementLimits, OrdersError>;
     readonly placeOrder: PlaceOrderAction;
     readonly cancelOrder: CancelOrderAction;
     readonly setSellOrderUpi: SetSellOrderUpiAction;
@@ -596,6 +646,7 @@ declare const ZodCurrencyScopedParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -665,6 +716,7 @@ declare const ZodGetBalancesParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -685,6 +737,7 @@ declare const ZodTxLimitsParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -922,6 +975,29 @@ declare function useZkkyc(): Zkkyc;
 /** Returns the FraudEngine instance from the nearest SdkProvider. */
 declare function useFraudEngine(): FraudEngine;
 
+interface UsePlacementLimitsParams {
+    /** Omit or pass undefined while no wallet is connected — no request is made. */
+    readonly userAddress?: Address;
+    /** Optional polling interval in ms. Omit for no polling. */
+    readonly pollMs?: number;
+}
+interface UsePlacementLimitsResult {
+    limits: PlacementLimits | null;
+    isLoading: boolean;
+    error: OrdersError | null;
+    /** Refetches immediately. Call after a placement lands so the count catches up. */
+    refresh: () => void;
+}
+/**
+ * Reads the user's daily order placement allowances and keeps them fresh:
+ * refetches on address change, on an optional interval, and once the UTC day
+ * rolls over so a form left open across midnight stops showing a spent bucket.
+ *
+ * Advisory only — the subgraph lags the chain, so use this to warn or disable a
+ * control, never to decide whether a placement is legal.
+ */
+declare function usePlacementLimits(params: UsePlacementLimitsParams): UsePlacementLimitsResult;
+
 /**
  * Subscribes to Diamond order lifecycle events for the lifetime of the
  * component. Unsubscribes automatically on unmount or when `user` changes.
@@ -942,4 +1018,4 @@ interface UseFingerprintResult {
 }
 declare function useFingerprint(enabled: boolean): UseFingerprintResult;
 
-export { type FraudEngineSdkConfig, type OrdersSdkConfig, type SdkConfig, SdkProvider, useFingerprint, useFraudEngine, useOrders, usePrices, useProfile, useSdk, useStake, useWatchOrders, useZkkyc };
+export { type FraudEngineSdkConfig, type OrdersSdkConfig, type SdkConfig, SdkProvider, type UsePlacementLimitsParams, type UsePlacementLimitsResult, useFingerprint, useFraudEngine, useOrders, usePlacementLimits, usePrices, useProfile, useSdk, useStake, useWatchOrders, useZkkyc };

package/dist/react.d.ts

@@ -166,6 +166,7 @@ declare const ZodGetStakeBoostConfigParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -281,7 +282,7 @@ interface StakeClient {
     readonly claimUnstake: ClaimUnstakeAction;
 }
 
-type OrdersErrorCode = "VALIDATION_ERROR" | "INVALID_ORDER_ID" | "INVALID_GET_ORDERS_PARAMS" | "INVALID_FEE_CONFIG_PARAMS" | "ORDER_NOT_FOUND" | "CONTRACT_READ_FAILED" | "SUBGRAPH_REQUEST_FAILED" | "SUBGRAPH_VALIDATION_FAILED" | "MALFORMED_ORDER" | "CIRCLE_SELECTION_FAILED" | "ENCRYPTION_FAILED" | "RELAY_IDENTITY_CORRUPT" | "RELAY_IDENTITY_STORE_FAILED" | "TX_SUBMISSION_FAILED" | "RECEIPT_TIMEOUT" | "TX_REVERTED" | "EVENT_WATCH_FAILED";
+type OrdersErrorCode = "VALIDATION_ERROR" | "INVALID_ORDER_ID" | "INVALID_GET_ORDERS_PARAMS" | "INVALID_FEE_CONFIG_PARAMS" | "INVALID_PLACEMENT_LIMITS_PARAMS" | "ORDER_NOT_FOUND" | "CONTRACT_READ_FAILED" | "SUBGRAPH_REQUEST_FAILED" | "SUBGRAPH_VALIDATION_FAILED" | "MALFORMED_ORDER" | "CIRCLE_SELECTION_FAILED" | "ENCRYPTION_FAILED" | "RELAY_IDENTITY_CORRUPT" | "RELAY_IDENTITY_STORE_FAILED" | "TX_SUBMISSION_FAILED" | "RECEIPT_TIMEOUT" | "TX_REVERTED" | "EVENT_WATCH_FAILED";
 declare class OrdersError extends SdkError<OrdersErrorCode> {
     constructor(message: string, options: {
         code: OrdersErrorCode;
@@ -320,6 +321,7 @@ declare const ZodGetFeeConfigParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -331,6 +333,10 @@ declare const ZodGetFeeConfigParamsSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 type GetFeeConfigParams = z.infer<typeof ZodGetFeeConfigParamsSchema>;
+declare const ZodGetPlacementLimitsParamsSchema: z.ZodObject<{
+    userAddress: z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>;
+}, z.core.$strip>;
+type GetPlacementLimitsParams = z.infer<typeof ZodGetPlacementLimitsParamsSchema>;
 declare const ZodGetOrdersParamsSchema: z.ZodObject<{
     userAddress: z.ZodString & z.ZodType<`0x${string}`, string, z.core.$ZodTypeInternals<`0x${string}`, string>>;
     skip: z.ZodDefault<z.ZodNumber>;
@@ -346,6 +352,7 @@ declare const ZodPlaceOrderParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -440,6 +447,40 @@ interface FeeConfig {
     /** Fixed fee applied to small orders (6 decimals). */
     smallOrderFixedFee: bigint;
 }
+/**
+ * Whether a daily placement cap is actually in force.
+ * - `enforced` — a cap is set and the contract will reject placements past it.
+ * - `unlimited` — the cap is explicitly zero, which the contract reads as no
+ *   cap at all (sell/pay only; a zero buy cap blocks every buy instead).
+ * - `unknown` — no cap has been indexed yet, so nothing here should be shown
+ *   as a limit. Let the contract be the judge.
+ */
+type PlacementLimitState = "enforced" | "unlimited" | "unknown";
+/**
+ * One daily placement bucket. `used` counts every order placed today INCLUDING
+ * ones that were later cancelled — the on-chain counter is never credited back,
+ * so cancelling does not free up an allowance.
+ */
+interface PlacementBucket {
+    used: number;
+    /** The cap itself. Null unless `state` is `enforced`. */
+    limit: number | null;
+    /** `limit - used`, floored at zero. Null unless `state` is `enforced`. */
+    remaining: number | null;
+    state: PlacementLimitState;
+}
+/**
+ * Per-user daily order placement allowances, read from the subgraph. SELL and
+ * PAY draw on one shared bucket; BUY has its own. Both reset at UTC midnight.
+ */
+interface PlacementLimits {
+    /** UTC day these counts belong to (unix seconds / 86400). */
+    dayIndex: number;
+    /** Unix seconds at which the buckets reset (the next UTC midnight). */
+    resetsAt: number;
+    buy: PlacementBucket;
+    sellPay: PlacementBucket;
+}
 interface PreparedTxMeta {
     readonly circleId?: bigint;
     readonly relayIdentity?: RelayIdentity;
@@ -548,6 +589,15 @@ interface OrdersClient {
      * fee itself. Both are 6-decimal bigints.
      */
     getFeeConfig(params: GetFeeConfigParams): ResultAsync<FeeConfig, OrdersError>;
+    /**
+     * Reads the user's daily order placement allowances from the subgraph — how
+     * many buy and sell/pay orders they have placed today and the caps in force.
+     * Cancelled orders still count; SELL and PAY share one bucket.
+     *
+     * Advisory only: the subgraph lags the chain, so use it to warn or disable a
+     * button, never as the final word on whether a placement will succeed.
+     */
+    getPlacementLimits(params: GetPlacementLimitsParams): ResultAsync<PlacementLimits, OrdersError>;
     readonly placeOrder: PlaceOrderAction;
     readonly cancelOrder: CancelOrderAction;
     readonly setSellOrderUpi: SetSellOrderUpiAction;
@@ -596,6 +646,7 @@ declare const ZodCurrencyScopedParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -665,6 +716,7 @@ declare const ZodGetBalancesParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -685,6 +737,7 @@ declare const ZodTxLimitsParamsSchema: z.ZodObject<{
         ARS: "ARS";
         MEX: "MEX";
         VEN: "VEN";
+        BOB: "BOB";
         EUR: "EUR";
         NGN: "NGN";
         USD: "USD";
@@ -922,6 +975,29 @@ declare function useZkkyc(): Zkkyc;
 /** Returns the FraudEngine instance from the nearest SdkProvider. */
 declare function useFraudEngine(): FraudEngine;
 
+interface UsePlacementLimitsParams {
+    /** Omit or pass undefined while no wallet is connected — no request is made. */
+    readonly userAddress?: Address;
+    /** Optional polling interval in ms. Omit for no polling. */
+    readonly pollMs?: number;
+}
+interface UsePlacementLimitsResult {
+    limits: PlacementLimits | null;
+    isLoading: boolean;
+    error: OrdersError | null;
+    /** Refetches immediately. Call after a placement lands so the count catches up. */
+    refresh: () => void;
+}
+/**
+ * Reads the user's daily order placement allowances and keeps them fresh:
+ * refetches on address change, on an optional interval, and once the UTC day
+ * rolls over so a form left open across midnight stops showing a spent bucket.
+ *
+ * Advisory only — the subgraph lags the chain, so use this to warn or disable a
+ * control, never to decide whether a placement is legal.
+ */
+declare function usePlacementLimits(params: UsePlacementLimitsParams): UsePlacementLimitsResult;
+
 /**
  * Subscribes to Diamond order lifecycle events for the lifetime of the
  * component. Unsubscribes automatically on unmount or when `user` changes.
@@ -942,4 +1018,4 @@ interface UseFingerprintResult {
 }
 declare function useFingerprint(enabled: boolean): UseFingerprintResult;
 
-export { type FraudEngineSdkConfig, type OrdersSdkConfig, type SdkConfig, SdkProvider, useFingerprint, useFraudEngine, useOrders, usePrices, useProfile, useSdk, useStake, useWatchOrders, useZkkyc };
+export { type FraudEngineSdkConfig, type OrdersSdkConfig, type SdkConfig, SdkProvider, type UsePlacementLimitsParams, type UsePlacementLimitsResult, useFingerprint, useFraudEngine, useOrders, usePlacementLimits, usePrices, useProfile, useSdk, useStake, useWatchOrders, useZkkyc };

package/dist/react.mjs

@@ -65,6 +65,7 @@ var CURRENCY = {
   ARS: "ARS",
   MEX: "MEX",
   VEN: "VEN",
+  BOB: "BOB",
   EUR: "EUR",
   NGN: "NGN",
   USD: "USD",
@@ -1678,6 +1679,9 @@ var ZodGetOrderParamsSchema = z3.object({
 var ZodGetFeeConfigParamsSchema = z3.object({
   currency: ZodCurrencySchema
 });
+var ZodGetPlacementLimitsParamsSchema = z3.object({
+  userAddress: ZodAddressSchema
+});
 var ZodGetOrdersParamsSchema = z3.object({
   userAddress: ZodAddressSchema,
   skip: z3.number().int().min(0).default(0),
@@ -1738,6 +1742,19 @@ var ZodSubgraphOrderSchema = z3.object({
 var ZodSubgraphOrdersResponseSchema = z3.object({
   orders_collection: z3.array(ZodSubgraphOrderSchema)
 });
+var ZodSubgraphPlacementLimitsResponseSchema = z3.object({
+  userDailyPlacements: z3.object({
+    dayIndex: z3.string(),
+    buyPlacements: z3.string(),
+    sellPlacements: z3.string()
+  }).nullish(),
+  orderPlacementLimitConfig: z3.object({
+    dailyBuyOrderPlacementLimit: z3.string(),
+    buyLimitConfigured: z3.boolean(),
+    dailySellOrderPlacementLimit: z3.string(),
+    sellLimitConfigured: z3.boolean()
+  }).nullish()
+});
 
 // src/orders/actions/approve-usdc.ts
 function createApproveUsdcAction(input) {
@@ -5111,6 +5128,10 @@ var contractErrors = {
   // Order limits
   DailyBuyOrderLimitExceeded: "DAILY_BUY_ORDER_LIMIT_EXCEEDED",
   MonthlyBuyOrderLimitExceeded: "MONTHLY_BUY_ORDER_LIMIT_EXCEEDED",
+  // Gross placement caps: counted when the order is placed and never given
+  // back when it is cancelled, unlike the volume limits above.
+  DailyBuyOrderPlacementLimitExceeded: "DAILY_BUY_ORDER_PLACEMENT_LIMIT_EXCEEDED",
+  DailySellOrderPlacementLimitExceeded: "DAILY_SELL_ORDER_PLACEMENT_LIMIT_EXCEEDED",
   SellOrderAmountLimitExceeded: "SELL_ORDER_AMOUNT_LIMIT_EXCEEDED",
   BuyOrderAmountExceedsLimit: "BUY_ORDER_AMOUNT_EXCEEDS_LIMIT",
   SellOrderAmountExceedsLimit: "SELL_ORDER_AMOUNT_EXCEEDS_LIMIT",
@@ -5322,6 +5343,8 @@ var hexContractErrors = {
   // Order limits
   "0xe595a7bf": contractErrors.DailyBuyOrderLimitExceeded,
   "0x675dbc86": contractErrors.MonthlyBuyOrderLimitExceeded,
+  "0x917c7aef": contractErrors.DailyBuyOrderPlacementLimitExceeded,
+  "0x4688ce73": contractErrors.DailySellOrderPlacementLimitExceeded,
   "0x64301cb8": contractErrors.SellOrderAmountLimitExceeded,
   "0x91da284f": contractErrors.BuyOrderAmountExceedsLimit,
   "0xb407b9ec": contractErrors.SellOrderAmountExceedsLimit,
@@ -6523,6 +6546,7 @@ function normalizeSubgraphOrder(raw) {
 
 // src/orders/subgraph/index.ts
 import { Result as Result4 } from "neverthrow";
+import { stringToHex as stringToHex8 } from "viem";
 
 // src/orders/subgraph/queries.ts
 var ORDERS_BY_USER_QUERY = (
@@ -6559,8 +6583,35 @@ var ORDERS_BY_USER_QUERY = (
   }
 `
 );
+var PLACEMENT_LIMITS_QUERY = (
+  /* GraphQL */
+  `
+  query PlacementLimits($placementsId: ID!, $configId: ID!) {
+    userDailyPlacements(id: $placementsId) {
+      dayIndex
+      buyPlacements
+      sellPlacements
+    }
+    orderPlacementLimitConfig(id: $configId) {
+      dailyBuyOrderPlacementLimit
+      buyLimitConfigured
+      dailySellOrderPlacementLimit
+      sellLimitConfigured
+    }
+  }
+`
+);
 
 // src/orders/subgraph/index.ts
+var SECONDS_PER_DAY = 86400;
+var PLACEMENT_LIMIT_CONFIG_ID = stringToHex8("placement-limits");
+function bucket(used, limit, configured, zeroMeansUnlimited) {
+  if (!configured) return { used, limit: null, remaining: null, state: "unknown" };
+  if (limit === 0 && zeroMeansUnlimited) {
+    return { used, limit: null, remaining: null, state: "unlimited" };
+  }
+  return { used, limit, remaining: Math.max(0, limit - used), state: "enforced" };
+}
 function getOrdersForUser(subgraphUrl, userAddress, skip, limit, logger = noopLogger) {
   const user = userAddress.toLowerCase();
   logger.debug("fetching orders from subgraph", { subgraphUrl, user, skip, limit });
@@ -6587,6 +6638,54 @@ function getOrdersForUser(subgraphUrl, userAddress, skip, limit, logger = noopLo
     )
   );
 }
+function getPlacementLimitsForUser(subgraphUrl, userAddress, nowSeconds, logger = noopLogger) {
+  const user = userAddress.toLowerCase();
+  const dayIndex = Math.floor(nowSeconds / SECONDS_PER_DAY);
+  const placementsId = stringToHex8(`${user}-${dayIndex}`);
+  logger.debug("fetching placement limits from subgraph", { subgraphUrl, user, dayIndex });
+  return querySubgraph(subgraphUrl, {
+    query: PLACEMENT_LIMITS_QUERY,
+    variables: { placementsId, configId: PLACEMENT_LIMIT_CONFIG_ID }
+  }).mapErr(
+    (e) => new OrdersError(e.message, {
+      code: "SUBGRAPH_REQUEST_FAILED",
+      cause: e.cause ?? e,
+      context: { user, dayIndex, ...e.context ?? {} }
+    })
+  ).andThen(
+    (data) => validate(
+      ZodSubgraphPlacementLimitsResponseSchema,
+      data,
+      (message, cause, d) => new OrdersError(message, {
+        code: "SUBGRAPH_VALIDATION_FAILED",
+        cause,
+        context: { data: d }
+      })
+    )
+  ).map((validated) => {
+    const placements = validated.userDailyPlacements;
+    const config = validated.orderPlacementLimitConfig;
+    const buyUsed = placements ? Number(placements.buyPlacements) : 0;
+    const sellUsed = placements ? Number(placements.sellPlacements) : 0;
+    return {
+      dayIndex,
+      resetsAt: (dayIndex + 1) * SECONDS_PER_DAY,
+      // A zero BUY cap is a hard block on-chain, not "unlimited".
+      buy: bucket(
+        buyUsed,
+        config ? Number(config.dailyBuyOrderPlacementLimit) : 0,
+        config?.buyLimitConfigured ?? false,
+        false
+      ),
+      sellPay: bucket(
+        sellUsed,
+        config ? Number(config.dailySellOrderPlacementLimit) : 0,
+        config?.sellLimitConfigured ?? false,
+        true
+      )
+    };
+  });
+}
 
 // src/orders/watch-events.ts
 var PLACED_CONFIG = {
@@ -6762,6 +6861,19 @@ function createOrders(config) {
         ({ userAddress, skip, limit }) => getOrdersForUser(subgraphUrl, userAddress, skip, limit, logger)
       );
     },
+    getPlacementLimits(params) {
+      return validate(
+        ZodGetPlacementLimitsParamsSchema,
+        params,
+        (message, cause, d) => new OrdersError(message, {
+          code: "INVALID_PLACEMENT_LIMITS_PARAMS",
+          cause,
+          context: { params: d }
+        })
+      ).asyncAndThen(
+        ({ userAddress }) => getPlacementLimitsForUser(subgraphUrl, userAddress, Math.floor(Date.now() / 1e3), logger)
+      );
+    },
     getFeeConfig(params) {
       return validate(
         ZodGetFeeConfigParamsSchema,
@@ -7245,16 +7357,74 @@ function useFraudEngine() {
   return fraudEngine;
 }
 
+// src/react/use-placement-limits.ts
+import { useCallback, useEffect as useEffect2, useRef as useRef2, useState } from "react";
+function usePlacementLimits(params) {
+  const orders = useOrders();
+  const { userAddress, pollMs } = params;
+  const [limits, setLimits] = useState(null);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const requestIdRef = useRef2(0);
+  const mountedRef = useRef2(true);
+  useEffect2(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+    };
+  }, []);
+  const refresh = useCallback(() => {
+    if (!userAddress) {
+      requestIdRef.current++;
+      setLimits(null);
+      setError(null);
+      setIsLoading(false);
+      return;
+    }
+    const requestId = ++requestIdRef.current;
+    setIsLoading(true);
+    orders.getPlacementLimits({ userAddress }).match(
+      (next) => {
+        if (!mountedRef.current || requestId !== requestIdRef.current) return;
+        setLimits(next);
+        setError(null);
+        setIsLoading(false);
+      },
+      (cause) => {
+        if (!mountedRef.current || requestId !== requestIdRef.current) return;
+        setError(cause);
+        setIsLoading(false);
+      }
+    );
+  }, [orders, userAddress]);
+  useEffect2(() => {
+    refresh();
+  }, [refresh]);
+  useEffect2(() => {
+    if (!pollMs || !userAddress) return;
+    const timer = setInterval(refresh, pollMs);
+    return () => clearInterval(timer);
+  }, [pollMs, userAddress, refresh]);
+  useEffect2(() => {
+    if (!limits || !userAddress) return;
+    const msUntilReset = limits.resetsAt * 1e3 - Date.now();
+    if (msUntilReset <= 0) return;
+    const timer = setTimeout(refresh, msUntilReset + 1e3);
+    return () => clearTimeout(timer);
+  }, [limits, userAddress, refresh]);
+  return { limits, isLoading, error, refresh };
+}
+
 // src/react/use-watch-orders.ts
-import { useEffect as useEffect2, useRef as useRef2 } from "react";
+import { useEffect as useEffect3, useRef as useRef3 } from "react";
 function useWatchOrders(params) {
   const orders = useOrders();
   const { user, onEvent, onError } = params;
-  const onEventRef = useRef2(onEvent);
-  const onErrorRef = useRef2(onError);
+  const onEventRef = useRef3(onEvent);
+  const onErrorRef = useRef3(onError);
   onEventRef.current = onEvent;
   onErrorRef.current = onError;
-  useEffect2(() => {
+  useEffect3(() => {
     const unsubscribe = orders.watchEvents({
       user,
       onEvent: (event) => onEventRef.current(event),
@@ -7265,12 +7435,12 @@ function useWatchOrders(params) {
 }
 
 // src/fraud-engine/react/use-fingerprint.ts
-import { useEffect as useEffect3, useState } from "react";
+import { useEffect as useEffect4, useState as useState2 } from "react";
 function useFingerprint(enabled) {
-  const [data, setData] = useState(null);
-  const [error, setError] = useState(null);
-  const [isLoading, setIsLoading] = useState(false);
-  useEffect3(() => {
+  const [data, setData] = useState2(null);
+  const [error, setError] = useState2(null);
+  const [isLoading, setIsLoading] = useState2(false);
+  useEffect4(() => {
     if (!enabled) return;
     let cancelled = false;
     setIsLoading(true);
@@ -7302,6 +7472,7 @@ export {
   useFingerprint,
   useFraudEngine,
   useOrders,
+  usePlacementLimits,
   usePrices,
   useProfile,
   useSdk,