@p2pdotme/sdk 1.2.18 → 1.2.19

package/README.md

@@ -25,7 +25,7 @@ bun add @zkpassport/sdk                  # only for zkkyc ZK Passport flow
 | Import | Description |
 |--------|-------------|
 | `@p2pdotme/sdk` | Shared types, `SdkError`, `VERSION` |
-| `@p2pdotme/sdk/orders` | [Order reads + writes](./src/orders/README.md) — `getOrder`, `getOrders`, `getFeeConfig`, and `prepare`/`execute` pairs for `placeOrder`, `cancelOrder`, `setSellOrderUpi`, `raiseDispute`, `approveUsdc` |
+| `@p2pdotme/sdk/orders` | [Order reads + writes](./src/orders/README.md) — `getOrder`, `getOrders`, `getFeeConfig`, `getPlacementLimits`, and `prepare`/`execute` pairs for `placeOrder`, `cancelOrder`, `setSellOrderUpi`, `raiseDispute`, `approveUsdc` |
 | `@p2pdotme/sdk/prices` | [Currency price config](./src/prices/README.md) — `getPriceConfig`, `getReputationPerUsdcLimit` |
 | `@p2pdotme/sdk/profile` | [User-scoped reads](./src/profile/README.md) — USDC balance, USDC allowance, fiat conversion, tx limits |
 | `@p2pdotme/sdk/qr-parsers` | [QR code parsers](./src/qr-parsers/README.md) for UPI, QRIS, PIX, MercadoPago, Pago Movil |

package/dist/index.cjs

@@ -69,7 +69,7 @@ var ZodAddressSchema = import_zod.z.string().refine((s) => (0, import_viem.isAdd
 var ZodCurrencySchema = import_zod.z.enum(CURRENCY_CODES);
 
 // src/index.ts
-var VERSION = "1.2.18";
+var VERSION = "1.2.19";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SdkError,

package/dist/index.mjs

@@ -42,7 +42,7 @@ var ZodAddressSchema = z.string().refine((s) => isAddress(s), { message: "Invali
 var ZodCurrencySchema = z.enum(CURRENCY_CODES);
 
 // src/index.ts
-var VERSION = "1.2.18";
+var VERSION = "1.2.19";
 export {
   SdkError,
   VERSION

package/dist/orders.cjs

@@ -1231,6 +1231,9 @@ var ZodGetOrderParamsSchema = import_zod2.z.object({
 var ZodGetFeeConfigParamsSchema = import_zod2.z.object({
   currency: ZodCurrencySchema
 });
+var ZodGetPlacementLimitsParamsSchema = import_zod2.z.object({
+  userAddress: ZodAddressSchema
+});
 var ZodGetOrdersParamsSchema = import_zod2.z.object({
   userAddress: ZodAddressSchema,
   skip: import_zod2.z.number().int().min(0).default(0),
@@ -1291,6 +1294,19 @@ var ZodSubgraphOrderSchema = import_zod2.z.object({
 var ZodSubgraphOrdersResponseSchema = import_zod2.z.object({
   orders_collection: import_zod2.z.array(ZodSubgraphOrderSchema)
 });
+var ZodSubgraphPlacementLimitsResponseSchema = import_zod2.z.object({
+  userDailyPlacements: import_zod2.z.object({
+    dayIndex: import_zod2.z.string(),
+    buyPlacements: import_zod2.z.string(),
+    sellPlacements: import_zod2.z.string()
+  }).nullish(),
+  orderPlacementLimitConfig: import_zod2.z.object({
+    dailyBuyOrderPlacementLimit: import_zod2.z.string(),
+    buyLimitConfigured: import_zod2.z.boolean(),
+    dailySellOrderPlacementLimit: import_zod2.z.string(),
+    sellLimitConfigured: import_zod2.z.boolean()
+  }).nullish()
+});
 
 // src/orders/actions/approve-usdc.ts
 function createApproveUsdcAction(input) {
@@ -4681,6 +4697,8 @@ var contractErrorMessages = {
   CASHBACK_TRANSFER_FAILED: "Cashback transfer failed",
   // Order limits
   DAILY_BUY_ORDER_LIMIT_EXCEEDED: "Daily buy order count limit exceeded",
+  DAILY_BUY_ORDER_PLACEMENT_LIMIT_EXCEEDED: "You've reached today's buy order limit. Cancelled orders still count towards it \u2014 try again tomorrow.",
+  DAILY_SELL_ORDER_PLACEMENT_LIMIT_EXCEEDED: "You've reached today's sell and pay order limit. Cancelled orders still count towards it \u2014 try again tomorrow.",
   MONTHLY_BUY_ORDER_LIMIT_EXCEEDED: "Monthly buy order count limit exceeded",
   SELL_ORDER_AMOUNT_LIMIT_EXCEEDED: "Sell order amount limit exceeded",
   BUY_ORDER_AMOUNT_EXCEEDS_LIMIT: "Buy order amount exceeds limit",
@@ -4899,6 +4917,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",
@@ -5110,6 +5132,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,
@@ -5902,6 +5926,7 @@ function normalizeSubgraphOrder(raw) {
 
 // src/orders/subgraph/index.ts
 var import_neverthrow15 = require("neverthrow");
+var import_viem19 = require("viem");
 
 // src/orders/subgraph/queries.ts
 var ORDERS_BY_USER_QUERY = (
@@ -5938,8 +5963,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 = (0, import_viem19.stringToHex)("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 });
@@ -5966,6 +6018,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 = (0, import_viem19.stringToHex)(`${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 = {
@@ -6141,6 +6241,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,