@dimes-dot-fi/sdk 1.5.0 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dimes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -9,7 +9,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/@dimes-dot-fi/sdk"><img src="https://img.shields.io/npm/v/@dimes-dot-fi/sdk.svg" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/@dimes-dot-fi/sdk"><img src="https://img.shields.io/npm/dm/@dimes-dot-fi/sdk.svg" alt="npm downloads"></a>
-  <a href="https://github.com/nicktids"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license"></a>
+  <a href="https://github.com/dimes-fi/dimes-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="license"></a>
   <a href="https://docs.dimes.fi"><img src="https://img.shields.io/badge/docs-dimes.fi-black.svg" alt="docs"></a>
 </p>
 
@@ -93,7 +93,7 @@ const result = await executeQuote(client, {
   slippageBps: 300,
 });
 
-console.log(result.offer.entryPriceUsd);
+console.log(result.quote.entryPriceUsd);
 console.log(result.corrections); // auto-applied adjustments, if any
 ```
 
@@ -110,20 +110,75 @@ const result = await executeQuote(client, params, {
 
 ### Open a position on-chain
 
-```typescript
-import { buildCreatePositionTx, buildApproveTx, verifyOfferSignature } from "@dimes-dot-fi/sdk/contract";
+**Always verify the quote's signature before submitting.** The quote is signed by
+the Dimes authority over every term (size, leverage, fees, expiry); the vault
+enforces it on-chain (`InvalidSignature` / `SignatureExpired`), so verifying
+client-side just lets a tampered or stale quote fail fast instead of reverting.
 
-// Verify the quote signature
-await verifyOfferSignature(client, result.offer, userAddress);
+#### Recommended (mirrors the [dimes-demo-ui](https://github.com/dimes-fi/dimes-demo-ui) demo)
 
-// Build viem-compatible transactions
-const approveTx = buildApproveTx(usdcAddress, vaultAddress, amount);
-const createTx = buildCreatePositionTx(result.offer);
+Fetch `contract-info` once (it's cached), check the recovered signer with
+`assertQuoteSigner`, then build and submit the tx however your wallet stack
+requires. This keeps full control of your own UX and tx path while the SDK owns
+the crypto:
 
+```typescript
+import {
+  assertQuoteSigner,
+  resolveExpectedSigner,
+  getCachedContractInfo,
+  buildApproveTx,
+  buildCreatePositionTx,
+} from "@dimes-dot-fi/sdk/contract";
+import { getAddress } from "viem";
+
+const quote = result.quote;
+
+// The signed `user` is bound to msg.sender on-chain, so the submitting wallet
+// must be the one the quote was created for.
+const user = getAddress(quote.authorityPublicKey);
+if (getAddress(walletAddress) !== user) throw new Error("Wrong wallet for this quote.");
+
+// contract-info is cached per-client (staleTime: Infinity in React via useContractInfo()).
+const { polygonSignerAddress } = await getCachedContractInfo(client);
+const expectedSigner = resolveExpectedSigner(polygonSignerAddress);
+if (!expectedSigner) throw new Error("No signer address from /contract-info.");
+
+// Recover + compare. Throws DimesContractError("invalid_signer") on mismatch.
+await assertQuoteSigner(quote, user, expectedSigner);
+
+// Build viem-compatible transactions and submit them your way.
+const approveTx = buildApproveTx(usdcAddress, vaultAddress, BigInt(quote.totalUserAmountUsdcUnits));
+const createTx = buildCreatePositionTx(quote);
 await walletClient.writeContract(approveTx);
 await walletClient.writeContract(createTx);
 ```
 
+#### Primitives (build it differently)
+
+- `recoverCreatePositionSigner(quote, user)` — pure EIP-712 recovery; compare the
+  returned address yourself.
+- `buildCreatePositionTx`, `buildApproveTx`, `buildRequestCloseTx`,
+  `buildPushFundedCreateCalls`, `buildDepositWalletBatch` — raw call/tx builders
+  for EOA, smart-wallet (ERC-4337) batching, or deposit-wallet relayer flows. See
+  the three create-position hooks in dimes-ui for worked examples of each.
+
+#### Headless one-liners (no custom UX needed)
+
+For a bot or server that holds a `DimesClient` and doesn't need bespoke checks,
+these verify against the client's cached `contract-info` for you:
+
+```typescript
+import { buildVerifiedCreatePositionTx, buildVerifiedPushFundedCreateCalls } from "@dimes-dot-fi/sdk/contract";
+
+// verify-then-build in one call (throws on a bad signature):
+const createTx = await buildVerifiedCreatePositionTx(client, quote, user);
+const calls = await buildVerifiedPushFundedCreateCalls(client, quote, depositWallet); // pUSD address from contract-info
+```
+
+`verifyQuoteSignature(client, quote, user)` is the standalone verify if you want
+to build separately. (`verifyOfferSignature` is a deprecated alias.)
+
 ### Close a position
 
 ```typescript
@@ -215,17 +270,36 @@ Same API, same contracts, fake USDC. Get a sandbox key via the [Telegram link on
 | `GET /markets/:ticker` | `client.getMarket(ticker)` | `useMarket(ticker)` |
 | `GET /contract-info` | `client.getContractInfo()` | `useContractInfo()` |
 | `GET /positions` | `client.getPositions()` | `usePositions()` |
-| `GET /limits` | `client.getLimits()` | `useLimits()` |
+| `GET /user-limits` | `client.getUserLimits()` | `useUserLimits()` |
+| `GET /partner-limits` | `client.getPartnerLimits()` | `usePartnerLimits()` |
 | `POST /draft-quotes` | `client.createDraftQuote()` | — |
 | `POST /promoted-quotes/:id` | `client.promoteDraftQuote()` | — |
 | `POST /quotes` | `client.createQuote()` | — |
 | Draft → Promote (full flow) | `executeQuote()` | `useQuote()` |
 | Cancel position | `client.cancelPosition()` | `useCancelPosition()` |
 
+## Examples
+
+Runnable, type-checked examples live in [`examples/`](examples) — they're verified
+against the SDK source in CI (`pnpm examples:typecheck`), so they never drift from
+the real API:
+
+| File | Shows |
+| --- | --- |
+| [`01-quickstart.ts`](examples/01-quickstart.ts) | Auth, list markets, fetch an executable quote |
+| [`02-quote-engine.ts`](examples/02-quote-engine.ts) | `executeQuote` auto-correction + market-moved retries |
+| [`03-open-position-onchain.ts`](examples/03-open-position-onchain.ts) | EOA flow: approve → verify signature → `createPosition` (viem) |
+| [`04-positions-and-close.ts`](examples/04-positions-and-close.ts) | List positions, request an on-chain close |
+| [`05-websocket.ts`](examples/05-websocket.ts) | Stream live position events over Socket.IO |
+| [`react/trade-panel.tsx`](examples/react/trade-panel.tsx) | Provider + `useMarkets` + `useQuote` |
+| [`react/streams.tsx`](examples/react/streams.tsx) | `usePositions` with live WebSocket reconciliation |
+
 ## Documentation
 
 - [**Quickstart**](https://docs.dimes.fi/for-developers/quickstart) — end-to-end in 6 steps
 - [**SDK Installation**](https://docs.dimes.fi/for-developers/sdk-installation) — setup, auth, and peer deps
+- [**React Hooks**](https://docs.dimes.fi/for-developers/react-hooks) — provider, data hooks, quote state machine
+- [**WebSocket Events**](https://docs.dimes.fi/for-developers/websocket) — live position & market streams
 - [**API Reference**](https://docs.dimes.fi/for-developers/api-reference) — full endpoint documentation
 - [**Error Handling**](https://docs.dimes.fi/for-developers/error-handling) — error codes and structured hints
 - [**On-Chain Integration**](https://docs.dimes.fi/for-developers/on-chain-integration) — wallet patterns and contract ABIs
@@ -234,18 +308,13 @@ Same API, same contracts, fake USDC. Get a sandbox key via the [Telegram link on
 ## Publishing
 
 ```bash
-# Bump version
+# Bump version, then publish
 pnpm version patch   # or minor/major
-
-# Publish (pass the auth token inline to bypass 2FA requirement)
-npm publish --access public --registry https://registry.npmjs.org/ --//registry.npmjs.org/:_authToken=npm_XXXX
+npm publish --access public
 ```
 
-Then update the UI:
-```bash
-cd ~/bl/dimes-ui && pnpm add @dimes-dot-fi/sdk@<version>
-```
+The `prepublishOnly` hook runs lint, typecheck, tests, and build before publishing.
 
 ## License
 
-MIT
+[MIT](./LICENSE)

package/dist/{aliases-ByZ2DcA5.d.cts → aliases-BJyM8ydu.d.cts}

@@ -32,6 +32,11 @@ interface components {
              * @example 0x70997970C51812dc3A010C7d01b50e0d17dc79C8
              */
             polygon_signer_address: string;
+            /**
+             * @description Checksummed address of the stablecoin (pUSD) token that collateral must be transferred in. Use this when building the push deposit transfer — sending any other token (e.g. USDC.e) will fail.
+             * @example 0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB
+             */
+            polygon_usdc_token_address: string;
             /**
              * @description Checksummed address of the vault contract on Polygon
              * @example 0x9965507D1a55bcC2695C58ba16FB37d819B0A4dc
@@ -656,6 +661,11 @@ interface components {
              * @example 50
              */
             effective_slippage_bps?: number | null;
+            /**
+             * @description Original position token units delivered when the position opened (1000000 units = 1 token). Unlike `current.positionTokenUnits` (the live, possibly partially-closed survivor), this is the fixed size credited at open and is the basis for the partial-close minimum. Null until the open fill is recorded on chain.
+             * @example 10000000
+             */
+            position_token_units?: string | null;
         };
         CustomerPositionFailure: {
             /**
@@ -718,6 +728,24 @@ interface components {
              */
             deferred_at: string;
         };
+        CustomerPendingOperation: {
+            /**
+             * @description The lifecycle operation currently in flight on this position. Present whenever the position is mid-operation (open, close, partial close, unwind, liquidate, or settle); null when the position is at rest. Note `status` stays `open` throughout a `partial_close`, so this is the only signal a slice is in flight after a reload.
+             * @enum {string}
+             */
+            type: "open" | "close" | "partial_close" | "unwind" | "liquidate" | "settle";
+            /**
+             * @description Sub-state of the operation: `requested` (submitted, not yet executing), `initiated` (executing on the venue), `pending` (tokens withdrawn, finalizing on chain), `awaiting_settlement` (a close deferred until the market settles). Null when the operation has no distinct phase.
+             * @example initiated
+             * @enum {string|null}
+             */
+            phase?: "requested" | "initiated" | "pending" | "awaiting_settlement" | null;
+            /**
+             * @description Token units involved in the in-flight operation (1000000 units = 1 token). For `partial_close` this is the slice being closed; for `close`/`liquidate` the units withdrawn; for the awaiting-settlement close the remaining tokens. Null when the operation carries no specific token amount.
+             * @example 5000000
+             */
+            token_units?: string | null;
+        };
         CustomerPositionCurrent: {
             /**
              * @description Current book-value leverage in basis points (20000 = 2x)
@@ -790,6 +818,16 @@ interface components {
              * @example 55000
              */
             notional_usd_pips: string;
+            /**
+             * @description Smallest partial-close slice the contract will accept right now, in token units (1000000 units = 1 token): `max(5 tokens, 20% of the original opened size)`. Null when the position is not partial-closeable (an operation is already in flight, the open fill isn't recorded yet, or the survivor is below the minimum).
+             * @example 5000000
+             */
+            min_partial_close_token_units?: string | null;
+            /**
+             * @description Largest partial-close slice allowed right now, in token units (1000000 units = 1 token): the full survivor size currently held (`positionTokenUnits`). Null when the position is not partial-closeable.
+             * @example 10000000
+             */
+            max_partial_close_token_units?: string | null;
             /**
              * @description Position token units held (1000000 units = 1 token)
              * @example 10000000
@@ -981,8 +1019,13 @@ interface components {
              * @example 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
              */
             wallet_address: string;
-            /** @description Details of a close request that could not complete and was deferred. Null unless the customer requested a close that is now waiting on market settlement to redeem the remaining tokens. */
+            /**
+             * @deprecated
+             * @description Deprecated — use `pendingOperation` (a deferred close now surfaces as `{ type: 'close', phase: 'awaiting_settlement' }`). Details of a close request that could not complete and was deferred. Null unless the customer requested a close that is now waiting on market settlement to redeem the remaining tokens.
+             */
             close_attempt?: components["schemas"]["CustomerCloseAttempt"] | null;
+            /** @description The lifecycle operation currently in flight on this position, or null when the position is at rest. Survives reload (unlike the ephemeral websocket events), so a UI can show that a close / partial close / unwind / settle is in progress after re-fetching REST. */
+            pending_operation?: components["schemas"]["CustomerPendingOperation"] | null;
         };
         CustomerPositionClosedFees: {
             /**
@@ -1587,7 +1630,9 @@ interface MarketPolymarket {
     yesTokenId: string;
 }
 type OriginationTier = CamelizeKeys<Raw["CustomerOriginationTier"]>;
-type Offer = CamelizeKeys<Raw["CustomerOffer"]>;
+type Quote = CamelizeKeys<Raw["CustomerOffer"]>;
+/** @deprecated Use {@link Quote}. Back-compat alias; removed in a future major. */
+type Offer = Quote;
 type OpenPosition = CamelizeKeys<Raw["CustomerOpenPosition"]>;
 type ClosedPosition = CamelizeKeys<Raw["CustomerClosedPosition"]>;
 type Position = OpenPosition | ClosedPosition;
@@ -1600,6 +1645,7 @@ type PositionResult = CamelizeKeys<Raw["CustomerPositionResult"]>;
 type PositionTiming = CamelizeKeys<Raw["CustomerPositionTiming"]>;
 type PositionFailure = CamelizeKeys<Raw["CustomerPositionFailure"]>;
 type CloseAttempt = CamelizeKeys<Raw["CustomerCloseAttempt"]>;
+type PendingOperation = CamelizeKeys<Raw["CustomerPendingOperation"]>;
 type PositionUnwind = CamelizeKeys<Raw["CustomerPositionUnwind"]>;
 type PositionUnwindList = CamelizeKeys<Raw["CustomerPositionUnwindList"]>;
 type PositionTransactions = CamelizeKeys<Raw["PositionTransactions"]>;
@@ -1610,14 +1656,18 @@ type FeeRatesOriginationTier = CamelizeKeys<Raw["CustomerOriginationFeeTier"]>;
 type FeeRatesMarket = CamelizeKeys<Raw["CustomerFeeRatesMarket"]>;
 type FeeRates = CamelizeKeys<Raw["CustomerFeeRates"]>;
 type FeeReport = CamelizeKeys<Raw["CustomerFeeReport"]>;
-interface CreateOfferParams {
+interface CreateQuoteParams {
     marketTicker: string;
     effectiveSide: "yes" | "no";
     leverageBps: number;
     notionalAmountUsdPips: string;
     slippageBps: number;
     pmProvider?: "polymarket" | "kalshi";
+    allowPartialFill?: boolean;
+    minFillBps?: number;
 }
+/** @deprecated Renamed to {@link CreateQuoteParams}. Kept as an alias for backward compatibility. */
+type CreateOfferParams = CreateQuoteParams;
 interface FeeReportParams {
     marketTicker: string;
     effectiveSide: "yes" | "no";
@@ -1629,4 +1679,4 @@ declare function isOpenPosition(p: Position): p is OpenPosition;
 declare function isClosedPosition(p: Position): p is ClosedPosition;
 declare function leverageMaxBps(lev: MarketLeverage, side: "yes" | "no"): number;
 
-export { type PositionUnwind as A, type PositionUnwindList as B, type CreateOfferParams as C, isClosedPosition as D, isOpenPosition as E, type FeeRates as F, leverageMaxBps as G, type PositionTransactions as H, type MarketPolymarket as I, type Market as M, type Offer as O, type Position as P, type CamelizeKeys as a, type CloseAttempt as b, type ClosedPosition as c, type ContractInfo as d, type CreateTokenResult as e, type CustomerLimit as f, type FeeRatesMarket as g, type FeeRatesOriginationTier as h, type FeeReport as i, type FeeReportParams as j, type MarketFees as k, type MarketLeverage as l, type MarketMaxLeveragePerNotional as m, type MarketPrices as n, type MarketSidedEligibility as o, type MarketSidedMaxLeveragePerNotional as p, type OpenPosition as q, type OriginationTier as r, type PositionClosedFees as s, type PositionCurrent as t, type PositionEntry as u, type PositionFailure as v, type PositionOpenFees as w, type PositionResult as x, type PositionRisk as y, type PositionTiming as z };
+export { type PositionOpenFees as A, type PositionResult as B, type CreateQuoteParams as C, type PositionRisk as D, type PositionTiming as E, type FeeRates as F, type PositionUnwind as G, type PositionUnwindList as H, isClosedPosition as I, isOpenPosition as J, leverageMaxBps as K, type Market as M, type Offer as O, type Position as P, type Quote as Q, type MarketPolymarket as a, type MarketLeverage as b, type PositionTransactions as c, type ContractInfo as d, type CustomerLimit as e, type FeeReportParams as f, type FeeReport as g, type CamelizeKeys as h, type CloseAttempt as i, type ClosedPosition as j, type CreateOfferParams as k, type CreateTokenResult as l, type FeeRatesMarket as m, type FeeRatesOriginationTier as n, type MarketFees as o, type MarketMaxLeveragePerNotional as p, type MarketPrices as q, type MarketSidedEligibility as r, type MarketSidedMaxLeveragePerNotional as s, type OpenPosition as t, type OriginationTier as u, type PendingOperation as v, type PositionClosedFees as w, type PositionCurrent as x, type PositionEntry as y, type PositionFailure as z };

package/dist/{aliases-ByZ2DcA5.d.ts → aliases-BJyM8ydu.d.ts}

@@ -32,6 +32,11 @@ interface components {
              * @example 0x70997970C51812dc3A010C7d01b50e0d17dc79C8
              */
             polygon_signer_address: string;
+            /**
+             * @description Checksummed address of the stablecoin (pUSD) token that collateral must be transferred in. Use this when building the push deposit transfer — sending any other token (e.g. USDC.e) will fail.
+             * @example 0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB
+             */
+            polygon_usdc_token_address: string;
             /**
              * @description Checksummed address of the vault contract on Polygon
              * @example 0x9965507D1a55bcC2695C58ba16FB37d819B0A4dc
@@ -656,6 +661,11 @@ interface components {
              * @example 50
              */
             effective_slippage_bps?: number | null;
+            /**
+             * @description Original position token units delivered when the position opened (1000000 units = 1 token). Unlike `current.positionTokenUnits` (the live, possibly partially-closed survivor), this is the fixed size credited at open and is the basis for the partial-close minimum. Null until the open fill is recorded on chain.
+             * @example 10000000
+             */
+            position_token_units?: string | null;
         };
         CustomerPositionFailure: {
             /**
@@ -718,6 +728,24 @@ interface components {
              */
             deferred_at: string;
         };
+        CustomerPendingOperation: {
+            /**
+             * @description The lifecycle operation currently in flight on this position. Present whenever the position is mid-operation (open, close, partial close, unwind, liquidate, or settle); null when the position is at rest. Note `status` stays `open` throughout a `partial_close`, so this is the only signal a slice is in flight after a reload.
+             * @enum {string}
+             */
+            type: "open" | "close" | "partial_close" | "unwind" | "liquidate" | "settle";
+            /**
+             * @description Sub-state of the operation: `requested` (submitted, not yet executing), `initiated` (executing on the venue), `pending` (tokens withdrawn, finalizing on chain), `awaiting_settlement` (a close deferred until the market settles). Null when the operation has no distinct phase.
+             * @example initiated
+             * @enum {string|null}
+             */
+            phase?: "requested" | "initiated" | "pending" | "awaiting_settlement" | null;
+            /**
+             * @description Token units involved in the in-flight operation (1000000 units = 1 token). For `partial_close` this is the slice being closed; for `close`/`liquidate` the units withdrawn; for the awaiting-settlement close the remaining tokens. Null when the operation carries no specific token amount.
+             * @example 5000000
+             */
+            token_units?: string | null;
+        };
         CustomerPositionCurrent: {
             /**
              * @description Current book-value leverage in basis points (20000 = 2x)
@@ -790,6 +818,16 @@ interface components {
              * @example 55000
              */
             notional_usd_pips: string;
+            /**
+             * @description Smallest partial-close slice the contract will accept right now, in token units (1000000 units = 1 token): `max(5 tokens, 20% of the original opened size)`. Null when the position is not partial-closeable (an operation is already in flight, the open fill isn't recorded yet, or the survivor is below the minimum).
+             * @example 5000000
+             */
+            min_partial_close_token_units?: string | null;
+            /**
+             * @description Largest partial-close slice allowed right now, in token units (1000000 units = 1 token): the full survivor size currently held (`positionTokenUnits`). Null when the position is not partial-closeable.
+             * @example 10000000
+             */
+            max_partial_close_token_units?: string | null;
             /**
              * @description Position token units held (1000000 units = 1 token)
              * @example 10000000
@@ -981,8 +1019,13 @@ interface components {
              * @example 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
              */
             wallet_address: string;
-            /** @description Details of a close request that could not complete and was deferred. Null unless the customer requested a close that is now waiting on market settlement to redeem the remaining tokens. */
+            /**
+             * @deprecated
+             * @description Deprecated — use `pendingOperation` (a deferred close now surfaces as `{ type: 'close', phase: 'awaiting_settlement' }`). Details of a close request that could not complete and was deferred. Null unless the customer requested a close that is now waiting on market settlement to redeem the remaining tokens.
+             */
             close_attempt?: components["schemas"]["CustomerCloseAttempt"] | null;
+            /** @description The lifecycle operation currently in flight on this position, or null when the position is at rest. Survives reload (unlike the ephemeral websocket events), so a UI can show that a close / partial close / unwind / settle is in progress after re-fetching REST. */
+            pending_operation?: components["schemas"]["CustomerPendingOperation"] | null;
         };
         CustomerPositionClosedFees: {
             /**
@@ -1587,7 +1630,9 @@ interface MarketPolymarket {
     yesTokenId: string;
 }
 type OriginationTier = CamelizeKeys<Raw["CustomerOriginationTier"]>;
-type Offer = CamelizeKeys<Raw["CustomerOffer"]>;
+type Quote = CamelizeKeys<Raw["CustomerOffer"]>;
+/** @deprecated Use {@link Quote}. Back-compat alias; removed in a future major. */
+type Offer = Quote;
 type OpenPosition = CamelizeKeys<Raw["CustomerOpenPosition"]>;
 type ClosedPosition = CamelizeKeys<Raw["CustomerClosedPosition"]>;
 type Position = OpenPosition | ClosedPosition;
@@ -1600,6 +1645,7 @@ type PositionResult = CamelizeKeys<Raw["CustomerPositionResult"]>;
 type PositionTiming = CamelizeKeys<Raw["CustomerPositionTiming"]>;
 type PositionFailure = CamelizeKeys<Raw["CustomerPositionFailure"]>;
 type CloseAttempt = CamelizeKeys<Raw["CustomerCloseAttempt"]>;
+type PendingOperation = CamelizeKeys<Raw["CustomerPendingOperation"]>;
 type PositionUnwind = CamelizeKeys<Raw["CustomerPositionUnwind"]>;
 type PositionUnwindList = CamelizeKeys<Raw["CustomerPositionUnwindList"]>;
 type PositionTransactions = CamelizeKeys<Raw["PositionTransactions"]>;
@@ -1610,14 +1656,18 @@ type FeeRatesOriginationTier = CamelizeKeys<Raw["CustomerOriginationFeeTier"]>;
 type FeeRatesMarket = CamelizeKeys<Raw["CustomerFeeRatesMarket"]>;
 type FeeRates = CamelizeKeys<Raw["CustomerFeeRates"]>;
 type FeeReport = CamelizeKeys<Raw["CustomerFeeReport"]>;
-interface CreateOfferParams {
+interface CreateQuoteParams {
     marketTicker: string;
     effectiveSide: "yes" | "no";
     leverageBps: number;
     notionalAmountUsdPips: string;
     slippageBps: number;
     pmProvider?: "polymarket" | "kalshi";
+    allowPartialFill?: boolean;
+    minFillBps?: number;
 }
+/** @deprecated Renamed to {@link CreateQuoteParams}. Kept as an alias for backward compatibility. */
+type CreateOfferParams = CreateQuoteParams;
 interface FeeReportParams {
     marketTicker: string;
     effectiveSide: "yes" | "no";
@@ -1629,4 +1679,4 @@ declare function isOpenPosition(p: Position): p is OpenPosition;
 declare function isClosedPosition(p: Position): p is ClosedPosition;
 declare function leverageMaxBps(lev: MarketLeverage, side: "yes" | "no"): number;
 
-export { type PositionUnwind as A, type PositionUnwindList as B, type CreateOfferParams as C, isClosedPosition as D, isOpenPosition as E, type FeeRates as F, leverageMaxBps as G, type PositionTransactions as H, type MarketPolymarket as I, type Market as M, type Offer as O, type Position as P, type CamelizeKeys as a, type CloseAttempt as b, type ClosedPosition as c, type ContractInfo as d, type CreateTokenResult as e, type CustomerLimit as f, type FeeRatesMarket as g, type FeeRatesOriginationTier as h, type FeeReport as i, type FeeReportParams as j, type MarketFees as k, type MarketLeverage as l, type MarketMaxLeveragePerNotional as m, type MarketPrices as n, type MarketSidedEligibility as o, type MarketSidedMaxLeveragePerNotional as p, type OpenPosition as q, type OriginationTier as r, type PositionClosedFees as s, type PositionCurrent as t, type PositionEntry as u, type PositionFailure as v, type PositionOpenFees as w, type PositionResult as x, type PositionRisk as y, type PositionTiming as z };
+export { type PositionOpenFees as A, type PositionResult as B, type CreateQuoteParams as C, type PositionRisk as D, type PositionTiming as E, type FeeRates as F, type PositionUnwind as G, type PositionUnwindList as H, isClosedPosition as I, isOpenPosition as J, leverageMaxBps as K, type Market as M, type Offer as O, type Position as P, type Quote as Q, type MarketPolymarket as a, type MarketLeverage as b, type PositionTransactions as c, type ContractInfo as d, type CustomerLimit as e, type FeeReportParams as f, type FeeReport as g, type CamelizeKeys as h, type CloseAttempt as i, type ClosedPosition as j, type CreateOfferParams as k, type CreateTokenResult as l, type FeeRatesMarket as m, type FeeRatesOriginationTier as n, type MarketFees as o, type MarketMaxLeveragePerNotional as p, type MarketPrices as q, type MarketSidedEligibility as r, type MarketSidedMaxLeveragePerNotional as s, type OpenPosition as t, type OriginationTier as u, type PendingOperation as v, type PositionClosedFees as w, type PositionCurrent as x, type PositionEntry as y, type PositionFailure as z };

package/dist/{chunk-UHQZSMUD.cjs → chunk-53U53KZ2.cjs}

@@ -8,6 +8,10 @@ var positionEventTypes = [
   "position.liquidated",
   "position.opened",
   "position.opening",
+  "position.partial_close_requested",
+  "position.partial_close_initiated",
+  "position.partial_closed",
+  "position.partial_close_aborted",
   "position.reverted",
   "position.settled"
 ];
@@ -25,4 +29,4 @@ var notificationCodes = {
 
 
 exports.positionEventTypes = positionEventTypes; exports.marketEventTypes = marketEventTypes; exports.notificationCodes = notificationCodes;
-//# sourceMappingURL=chunk-UHQZSMUD.cjs.map
+//# sourceMappingURL=chunk-53U53KZ2.cjs.map

package/dist/chunk-53U53KZ2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/alexemery/bl/dimes-sdk/dist/chunk-53U53KZ2.cjs","../src/ws/types.ts"],"names":[],"mappings":"AAAA;ACEO,IAAM,mBAAA,EAAqB;AAAA,EAChC,oBAAA;AAAA,EACA,0BAAA;AAAA,EACA,iBAAA;AAAA,EACA,kBAAA;AAAA,EACA,wBAAA;AAAA,EACA,qBAAA;AAAA,EACA,iBAAA;AAAA,EACA,kBAAA;AAAA,EACA,kCAAA;AAAA,EACA,kCAAA;AAAA,EACA,yBAAA;AAAA,EACA,gCAAA;AAAA,EACA,mBAAA;AAAA,EACA;AACF,CAAA;AAkBO,IAAM,iBAAA,EAAmB;AAAA,EAC9B,mBAAA;AAAA,EACA,4BAAA;AAAA,EACA;AACF,CAAA;AA6CO,IAAM,kBAAA,EAAoB;AAAA,EAC/B,wBAAA,EAA0B;AAC5B,CAAA;AD7DA;AACA;AACE;AACA;AACA;AACF,4IAAC","file":"/Users/alexemery/bl/dimes-sdk/dist/chunk-53U53KZ2.cjs","sourcesContent":[null,"import type { Market, MarketLeverage, MarketPolymarket, Position } from \"../types\";\n\nexport const positionEventTypes = [\n  \"position.cancelled\",\n  \"position.close_requested\",\n  \"position.closed\",\n  \"position.created\",\n  \"position.force_unwound\",\n  \"position.liquidated\",\n  \"position.opened\",\n  \"position.opening\",\n  \"position.partial_close_requested\",\n  \"position.partial_close_initiated\",\n  \"position.partial_closed\",\n  \"position.partial_close_aborted\",\n  \"position.reverted\",\n  \"position.settled\",\n] as const;\n\nexport type PositionEventType = (typeof positionEventTypes)[number];\n\nexport interface PositionEventEnvelope {\n  id: string;\n  type: PositionEventType;\n  created_at: string;\n  data: Record<string, unknown>;\n}\n\nexport interface PositionEvent {\n  id: string;\n  type: PositionEventType;\n  createdAt: string;\n  data: Position;\n}\n\nexport const marketEventTypes = [\n  \"market.discovered\",\n  \"market.eligibility_changed\",\n  \"market.max_leverage_changed\",\n] as const;\n\nexport type MarketEventType = (typeof marketEventTypes)[number];\n\nexport type MarketDelta = Pick<Market, \"id\"> & {\n  polymarket: MarketPolymarket;\n  leverage?: MarketLeverage;\n} & Partial<Omit<Market, \"id\" | \"leverage\">>;\n\nexport interface MarketEventEnvelope {\n  id: string;\n  type: MarketEventType;\n  created_at: string;\n  data: Record<string, unknown>[];\n}\n\nexport interface MarketEvent {\n  id: string;\n  type: MarketEventType;\n  createdAt: string;\n  data: Market[] | MarketDelta[];\n}\n\nexport interface NotificationEventEnvelope {\n  id: string;\n  type: \"notification\";\n  created_at: string;\n  data: {\n    code: string;\n    message: string;\n    params?: Record<string, unknown>;\n  };\n}\n\nexport interface NotificationEvent {\n  id: string;\n  type: \"notification\";\n  createdAt: string;\n  data: {\n    code: string;\n    message: string;\n    params?: Record<string, unknown>;\n  };\n}\n\nexport const notificationCodes = {\n  orderFulfillmentRetrying: \"ORDER_FULFILLMENT_RETRYING\",\n} as const;\n\nexport type NotificationCode = (typeof notificationCodes)[keyof typeof notificationCodes];\n"]}