@acta-markets/ts-sdk 0.0.5-beta → 0.0.6-beta

package/dist/cjs/events.test.js

@@ -184,6 +184,8 @@ describe("events parsing", () => {
                 Buffer.from(pk(3)),
                 u64(777),
                 Buffer.from([1]), // is_put
+                Buffer.from([6]), // underlying_decimals
+                Buffer.from([9]), // quote_decimals
             ]));
             const d = (0, events_1.decodeActaEventLine)(line);
             expect(d.kind).toBe(events_1.EventKind.CreateMarket);
@@ -194,6 +196,8 @@ describe("events parsing", () => {
                 expect(d.event.quoteMint).toBe(addr(3));
                 expect(d.event.expiryTs).toBe(777n);
                 expect(d.event.isPut).toBe(1);
+                expect(d.event.underlyingDecimals).toBe(6);
+                expect(d.event.quoteDecimals).toBe(9);
             }
         }
         // 9: FinalizeMarket
@@ -215,6 +219,7 @@ describe("events parsing", () => {
                 u64(222),
                 Buffer.from([1]),
                 Buffer.from(pk(3)),
+                Buffer.from(pk(9)),
             ]));
             const d = (0, events_1.decodeActaEventLine)(line);
             expect(d.kind).toBe(events_1.EventKind.CreateOracle);
@@ -225,6 +230,7 @@ describe("events parsing", () => {
                 expect(d.event.expiryTs).toBe(222n);
                 expect(d.event.oracleType).toBe(1);
                 expect(d.event.authority).toBe(addr(3));
+                expect(Buffer.from(d.event.feedId)).toEqual(Buffer.from(pk(9)));
             }
         }
         // 15: UpdateOraclePrice

package/dist/cjs/generated/types/actaEvent.js

@@ -89,6 +89,8 @@ function getActaEventEncoder() {
                 ["quoteMint", (0, kit_1.getAddressEncoder)()],
                 ["expiryTs", (0, kit_1.getU64Encoder)()],
                 ["isPut", (0, kit_1.getU8Encoder)()],
+                ["underlyingDecimals", (0, kit_1.getU8Encoder)()],
+                ["quoteDecimals", (0, kit_1.getU8Encoder)()],
             ]),
         ],
         [
@@ -142,6 +144,7 @@ function getActaEventEncoder() {
                 ["expiryTs", (0, kit_1.getU64Encoder)()],
                 ["oracleType", (0, kit_1.getU8Encoder)()],
                 ["authority", (0, kit_1.getAddressEncoder)()],
+                ["feedId", (0, kit_1.fixEncoderSize)((0, kit_1.getBytesEncoder)(), 32)],
             ]),
         ],
         [
@@ -247,6 +250,8 @@ function getActaEventDecoder() {
                 ["quoteMint", (0, kit_1.getAddressDecoder)()],
                 ["expiryTs", (0, kit_1.getU64Decoder)()],
                 ["isPut", (0, kit_1.getU8Decoder)()],
+                ["underlyingDecimals", (0, kit_1.getU8Decoder)()],
+                ["quoteDecimals", (0, kit_1.getU8Decoder)()],
             ]),
         ],
         [
@@ -300,6 +305,7 @@ function getActaEventDecoder() {
                 ["expiryTs", (0, kit_1.getU64Decoder)()],
                 ["oracleType", (0, kit_1.getU8Decoder)()],
                 ["authority", (0, kit_1.getAddressDecoder)()],
+                ["feedId", (0, kit_1.fixDecoderSize)((0, kit_1.getBytesDecoder)(), 32)],
             ]),
         ],
         [

package/dist/cjs/idl/acta_contract.json

@@ -1883,6 +1883,14 @@
                             {
                                 "name": "is_put",
                                 "type": "u8"
+                            },
+                            {
+                                "name": "underlying_decimals",
+                                "type": "u8"
+                            },
+                            {
+                                "name": "quote_decimals",
+                                "type": "u8"
                             }
                         ]
                     },
@@ -2030,6 +2038,15 @@
                             {
                                 "name": "authority",
                                 "type": "publicKey"
+                            },
+                            {
+                                "name": "feed_id",
+                                "type": {
+                                    "array": [
+                                        "u8",
+                                        32
+                                    ]
+                                }
                             }
                         ]
                     },

package/dist/cjs/idl/hash.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ACTA_IDL_SHA256 = void 0;
-exports.ACTA_IDL_SHA256 = "1466fbb647b4c33af315eefbb61e5e572ce14f22f16d050ac2894f8e017aaf66";
+exports.ACTA_IDL_SHA256 = "704677f7071ecbe98f442fb62468d882329b906950a707fc47aad0f38683636f";

package/dist/cjs/ws/client.js

@@ -108,6 +108,7 @@ class ActaWsClient extends TypedEventEmitter {
     subscribedChannels = new Set(["rfqs"]);
     subscribedMarkets = new Set();
     hasMarketScope = false;
+    marketDescriptorsByMarket = new Map();
     state = {
         stats: null,
         activeRfqs: new Map(),
@@ -196,6 +197,13 @@ class ActaWsClient extends TypedEventEmitter {
     }
     async createRfq(request) {
         this.ensureAuthenticated();
+        (0, wirePolicy_1.assertWsU64Safe)(request.strike, "strike");
+        (0, wirePolicy_1.assertWsU64Safe)(request.quantity, "quantity");
+        const marketDescriptor = this.marketDescriptorsByMarket.get(request.market);
+        if (!marketDescriptor) {
+            throw new Error(`Missing market descriptor for market=${request.market}; call getMarketDescriptors() before createRfq().`);
+        }
+        (0, wirePolicy_1.validateQuantityBySizeRule)(request.quantity, marketDescriptor.size_rule);
         this.send({
             type: "RfqRequest",
             data: {
@@ -500,7 +508,13 @@ class ActaWsClient extends TypedEventEmitter {
                 this.handleMarkets(message.data.markets ?? []);
                 break;
             case "MarketDescriptors":
-                this.emit("marketDescriptors", message.data.markets ?? []);
+                {
+                    const marketDescriptors = message.data.markets ?? [];
+                    for (const marketDescriptor of marketDescriptors) {
+                        this.marketDescriptorsByMarket.set(marketDescriptor.market.market_pda, marketDescriptor);
+                    }
+                    this.emit("marketDescriptors", marketDescriptors);
+                }
                 break;
             case "Expiries":
                 this.emit("expiries", message.data.expiries_ts ?? []);

package/dist/cjs/ws/client.test.js

@@ -13,6 +13,7 @@ const WELCOME_MESSAGE = {
         enabled_features: [],
     },
 };
+const createdClients = [];
 class MockWebSocket {
     url;
     readyState = WS_CONNECTING;
@@ -67,6 +68,7 @@ function makeHarness(overrides = {}) {
             return currentSocket;
         },
     });
+    createdClients.push(client);
     return {
         client,
         socket: () => {
@@ -83,6 +85,9 @@ async function flushMicrotasks() {
 }
 describe("ActaWsClient", () => {
     afterEach(() => {
+        for (const client of createdClients.splice(0, createdClients.length)) {
+            client.disconnect();
+        }
         jest.restoreAllMocks();
         jest.useRealTimers();
     });
@@ -287,6 +292,87 @@ describe("ActaWsClient", () => {
         expect(authRequests[3].data.request_id).toBe(cancelRfqId);
         expect(authRequests[4].data.request_id).toBe(cancelQuoteId);
     });
+    it("createRfq rejects when market descriptor is missing", async () => {
+        const { client, socket } = makeHarness();
+        client.connectAnonymous();
+        const ws = socket();
+        ws.triggerOpen();
+        ws.triggerMessage(WELCOME_MESSAGE);
+        client.handleMessage({
+            type: "AuthSuccess",
+            data: { session_id: "session-id", expires_at: 1_710_086_400 },
+        });
+        await expect(client.createRfq({
+            market: "market-1",
+            position_type: "covered_call",
+            strike: 100_000_000_000,
+            quantity: 2_000_000_000,
+        })).rejects.toThrow("Missing market descriptor");
+        const sentTypes = ws.sent.map((payload) => parseClientMessage(payload).type);
+        expect(sentTypes).not.toContain("RfqRequest");
+    });
+    it("createRfq validates quantity against market size rule", async () => {
+        const { client, socket } = makeHarness();
+        client.connectAnonymous();
+        const ws = socket();
+        ws.triggerOpen();
+        ws.triggerMessage(WELCOME_MESSAGE);
+        client.handleMessage({
+            type: "AuthSuccess",
+            data: { session_id: "session-id", expires_at: 1_710_086_400 },
+        });
+        client.handleMessage({
+            type: "MarketDescriptors",
+            data: {
+                request_id: "req-1",
+                markets: [
+                    {
+                        market: {
+                            chain_id: 1,
+                            program_id: "program-1",
+                            market_pda: "market-1",
+                            underlying_mint: "So11111111111111111111111111111111111111112",
+                            quote_mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                            expiry_ts: 1_800_000_000,
+                            is_put: false,
+                            collateral_mint: "So11111111111111111111111111111111111111112",
+                            settlement_mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                        },
+                        underlying_oracle_pda: "oracle-underlying",
+                        quote_oracle_pda: "oracle-quote",
+                        underlying_decimals: 9,
+                        quote_decimals: 6,
+                        size_rule: {
+                            min_size: 2_000_000_000,
+                            max_size: 10_000_000_000,
+                            step: 1_000_000_000,
+                        },
+                    },
+                ],
+            },
+        });
+        await expect(client.createRfq({
+            market: "market-1",
+            position_type: "covered_call",
+            strike: 100_000_000_000,
+            quantity: 2_500_000_000,
+        })).rejects.toThrow("(quantity - min_size) % step == 0");
+        await client.createRfq({
+            market: "market-1",
+            position_type: "covered_call",
+            strike: 100_000_000_000,
+            quantity: 3_000_000_000,
+        });
+        const sentMessages = ws.sent.map(parseClientMessage);
+        const rfqRequest = sentMessages
+            .filter((message) => message.type === "RfqRequest")
+            .at(-1);
+        expect(rfqRequest?.type).toBe("RfqRequest");
+        if (rfqRequest?.type === "RfqRequest") {
+            expect(rfqRequest.data.market).toBe("market-1");
+            expect(rfqRequest.data.quantity).toBe(3_000_000_000);
+        }
+    });
     it("drop_oldest policy keeps the latest queued messages", () => {
         const { client, socket } = makeHarness({
             maxPendingMessages: 2,

package/dist/cjs/ws/discovery.js

@@ -12,11 +12,13 @@ function deriveTokenLists(markets) {
         underlyings.set(uMint, {
             mint: m.market.underlying_mint,
             decimals: m.underlying_decimals,
+            size_rule: m.size_rule,
             symbol: m.underlying_symbol,
         });
         const q = {
             mint: m.market.quote_mint,
             decimals: m.quote_decimals,
+            size_rule: m.size_rule,
             symbol: m.quote_symbol,
         };
         const inner = quotesByUnderlying.get(uMint) ?? new Map();

package/dist/cjs/ws/wirePolicy.js

@@ -12,6 +12,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertWsU64Safe = assertWsU64Safe;
 exports.assertWsI64Safe = assertWsI64Safe;
+exports.validateQuantityBySizeRule = validateQuantityBySizeRule;
 function assertWsU64Safe(value, name) {
     if (!Number.isFinite(value) || !Number.isInteger(value)) {
         throw new Error(`${name} must be an integer number (u64 on wire)`);
@@ -32,3 +33,18 @@ function assertWsI64Safe(value, name) {
         throw new Error(`${name} exceeds JS safe integer range; WS wire requires safe integers`);
     }
 }
+function validateQuantityBySizeRule(quantity, rule, quantityName = "quantity") {
+    assertWsU64Safe(quantity, quantityName);
+    assertWsU64Safe(rule.min_size, "size_rule.min_size");
+    assertWsU64Safe(rule.max_size, "size_rule.max_size");
+    assertWsU64Safe(rule.step, "size_rule.step");
+    if (rule.max_size < rule.min_size) {
+        throw new Error(`invalid size_rule: max_size (${rule.max_size}) must be >= min_size (${rule.min_size})`);
+    }
+    if (quantity < rule.min_size || quantity > rule.max_size) {
+        throw new Error(`${quantityName} must be within [${rule.min_size}, ${rule.max_size}], got ${quantity}`);
+    }
+    if ((quantity - rule.min_size) % rule.step !== 0) {
+        throw new Error(`${quantityName} must satisfy (quantity - min_size) % step == 0 (quantity=${quantity}, min_size=${rule.min_size}, step=${rule.step})`);
+    }
+}

package/dist/cjs/ws/wirePolicy.test.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const wirePolicy_1 = require("./wirePolicy");
+describe("validateQuantityBySizeRule", () => {
+    const rule = {
+        min_size: 2_000_000_000,
+        max_size: 10_000_000_000,
+        step: 1_000_000_000,
+    };
+    it("accepts a valid quantity", () => {
+        expect(() => (0, wirePolicy_1.validateQuantityBySizeRule)(6_000_000_000, rule)).not.toThrow();
+    });
+    it("rejects quantity below min", () => {
+        expect(() => (0, wirePolicy_1.validateQuantityBySizeRule)(1_000_000_000, rule)).toThrow("must be within");
+    });
+    it("rejects quantity above max", () => {
+        expect(() => (0, wirePolicy_1.validateQuantityBySizeRule)(11_000_000_000, rule)).toThrow("must be within");
+    });
+    it("rejects quantity with invalid step", () => {
+        expect(() => (0, wirePolicy_1.validateQuantityBySizeRule)(2_500_000_000, rule)).toThrow("(quantity - min_size) % step == 0");
+    });
+});

package/dist/events.test.js

@@ -182,6 +182,8 @@ describe("events parsing", () => {
                 Buffer.from(pk(3)),
                 u64(777),
                 Buffer.from([1]), // is_put
+                Buffer.from([6]), // underlying_decimals
+                Buffer.from([9]), // quote_decimals
             ]));
             const d = decodeActaEventLine(line);
             expect(d.kind).toBe(EventKind.CreateMarket);
@@ -192,6 +194,8 @@ describe("events parsing", () => {
                 expect(d.event.quoteMint).toBe(addr(3));
                 expect(d.event.expiryTs).toBe(777n);
                 expect(d.event.isPut).toBe(1);
+                expect(d.event.underlyingDecimals).toBe(6);
+                expect(d.event.quoteDecimals).toBe(9);
             }
         }
         // 9: FinalizeMarket
@@ -213,6 +217,7 @@ describe("events parsing", () => {
                 u64(222),
                 Buffer.from([1]),
                 Buffer.from(pk(3)),
+                Buffer.from(pk(9)),
             ]));
             const d = decodeActaEventLine(line);
             expect(d.kind).toBe(EventKind.CreateOracle);
@@ -223,6 +228,7 @@ describe("events parsing", () => {
                 expect(d.event.expiryTs).toBe(222n);
                 expect(d.event.oracleType).toBe(1);
                 expect(d.event.authority).toBe(addr(3));
+                expect(Buffer.from(d.event.feedId)).toEqual(Buffer.from(pk(9)));
             }
         }
         // 15: UpdateOraclePrice

package/dist/generated/types/actaEvent.d.ts

@@ -55,6 +55,8 @@ export type ActaEvent = {
     quoteMint: Address;
     expiryTs: bigint;
     isPut: number;
+    underlyingDecimals: number;
+    quoteDecimals: number;
 } | {
     __kind: "FinalizeMarket";
     marketPda: Address;
@@ -95,6 +97,7 @@ export type ActaEvent = {
     expiryTs: bigint;
     oracleType: number;
     authority: Address;
+    feedId: ReadonlyUint8Array;
 } | {
     __kind: "UpdateOraclePrice";
     oraclePda: Address;
@@ -163,6 +166,8 @@ export type ActaEventArgs = {
     quoteMint: Address;
     expiryTs: number | bigint;
     isPut: number;
+    underlyingDecimals: number;
+    quoteDecimals: number;
 } | {
     __kind: "FinalizeMarket";
     marketPda: Address;
@@ -203,6 +208,7 @@ export type ActaEventArgs = {
     expiryTs: number | bigint;
     oracleType: number;
     authority: Address;
+    feedId: ReadonlyUint8Array;
 } | {
     __kind: "UpdateOraclePrice";
     oraclePda: Address;

package/dist/generated/types/actaEvent.js

@@ -82,6 +82,8 @@ export function getActaEventEncoder() {
                 ["quoteMint", getAddressEncoder()],
                 ["expiryTs", getU64Encoder()],
                 ["isPut", getU8Encoder()],
+                ["underlyingDecimals", getU8Encoder()],
+                ["quoteDecimals", getU8Encoder()],
             ]),
         ],
         [
@@ -135,6 +137,7 @@ export function getActaEventEncoder() {
                 ["expiryTs", getU64Encoder()],
                 ["oracleType", getU8Encoder()],
                 ["authority", getAddressEncoder()],
+                ["feedId", fixEncoderSize(getBytesEncoder(), 32)],
             ]),
         ],
         [
@@ -240,6 +243,8 @@ export function getActaEventDecoder() {
                 ["quoteMint", getAddressDecoder()],
                 ["expiryTs", getU64Decoder()],
                 ["isPut", getU8Decoder()],
+                ["underlyingDecimals", getU8Decoder()],
+                ["quoteDecimals", getU8Decoder()],
             ]),
         ],
         [
@@ -293,6 +298,7 @@ export function getActaEventDecoder() {
                 ["expiryTs", getU64Decoder()],
                 ["oracleType", getU8Decoder()],
                 ["authority", getAddressDecoder()],
+                ["feedId", fixDecoderSize(getBytesDecoder(), 32)],
             ]),
         ],
         [

package/dist/idl/acta_contract.json

@@ -1883,6 +1883,14 @@
                             {
                                 "name": "is_put",
                                 "type": "u8"
+                            },
+                            {
+                                "name": "underlying_decimals",
+                                "type": "u8"
+                            },
+                            {
+                                "name": "quote_decimals",
+                                "type": "u8"
                             }
                         ]
                     },
@@ -2030,6 +2038,15 @@
                             {
                                 "name": "authority",
                                 "type": "publicKey"
+                            },
+                            {
+                                "name": "feed_id",
+                                "type": {
+                                    "array": [
+                                        "u8",
+                                        32
+                                    ]
+                                }
                             }
                         ]
                     },

package/dist/idl/hash.d.ts

@@ -1 +1 @@
-export declare const ACTA_IDL_SHA256 = "1466fbb647b4c33af315eefbb61e5e572ce14f22f16d050ac2894f8e017aaf66";
+export declare const ACTA_IDL_SHA256 = "704677f7071ecbe98f442fb62468d882329b906950a707fc47aad0f38683636f";

package/dist/idl/hash.js

@@ -1 +1 @@
-export const ACTA_IDL_SHA256 = "1466fbb647b4c33af315eefbb61e5e572ce14f22f16d050ac2894f8e017aaf66";
+export const ACTA_IDL_SHA256 = "704677f7071ecbe98f442fb62468d882329b906950a707fc47aad0f38683636f";

package/dist/ws/client.d.ts

@@ -163,6 +163,7 @@ export declare class ActaWsClient extends TypedEventEmitter<ActaWsClientEvents>
     private subscribedChannels;
     private subscribedMarkets;
     private hasMarketScope;
+    private marketDescriptorsByMarket;
     readonly state: ClientState;
     constructor(options: ActaWsClientOptions);
     connectAnonymous(): void;

package/dist/ws/client.js

@@ -1,6 +1,6 @@
 /** Acta WebSocket client (rfq-server). */
 import { buildSignedQuoteMessage, buildAcceptQuoteMessage } from "./flows";
-import { assertWsU64Safe } from "./wirePolicy";
+import { assertWsU64Safe, validateQuantityBySizeRule } from "./wirePolicy";
 function formatServerError(error) {
     if (error.type === "generic") {
         return `${error.data.code}: ${error.data.message}`;
@@ -105,6 +105,7 @@ export class ActaWsClient extends TypedEventEmitter {
     subscribedChannels = new Set(["rfqs"]);
     subscribedMarkets = new Set();
     hasMarketScope = false;
+    marketDescriptorsByMarket = new Map();
     state = {
         stats: null,
         activeRfqs: new Map(),
@@ -193,6 +194,13 @@ export class ActaWsClient extends TypedEventEmitter {
     }
     async createRfq(request) {
         this.ensureAuthenticated();
+        assertWsU64Safe(request.strike, "strike");
+        assertWsU64Safe(request.quantity, "quantity");
+        const marketDescriptor = this.marketDescriptorsByMarket.get(request.market);
+        if (!marketDescriptor) {
+            throw new Error(`Missing market descriptor for market=${request.market}; call getMarketDescriptors() before createRfq().`);
+        }
+        validateQuantityBySizeRule(request.quantity, marketDescriptor.size_rule);
         this.send({
             type: "RfqRequest",
             data: {
@@ -497,7 +505,13 @@ export class ActaWsClient extends TypedEventEmitter {
                 this.handleMarkets(message.data.markets ?? []);
                 break;
             case "MarketDescriptors":
-                this.emit("marketDescriptors", message.data.markets ?? []);
+                {
+                    const marketDescriptors = message.data.markets ?? [];
+                    for (const marketDescriptor of marketDescriptors) {
+                        this.marketDescriptorsByMarket.set(marketDescriptor.market.market_pda, marketDescriptor);
+                    }
+                    this.emit("marketDescriptors", marketDescriptors);
+                }
                 break;
             case "Expiries":
                 this.emit("expiries", message.data.expiries_ts ?? []);

package/dist/ws/client.test.js

@@ -11,6 +11,7 @@ const WELCOME_MESSAGE = {
         enabled_features: [],
     },
 };
+const createdClients = [];
 class MockWebSocket {
     url;
     readyState = WS_CONNECTING;
@@ -65,6 +66,7 @@ function makeHarness(overrides = {}) {
             return currentSocket;
         },
     });
+    createdClients.push(client);
     return {
         client,
         socket: () => {
@@ -81,6 +83,9 @@ async function flushMicrotasks() {
 }
 describe("ActaWsClient", () => {
     afterEach(() => {
+        for (const client of createdClients.splice(0, createdClients.length)) {
+            client.disconnect();
+        }
         jest.restoreAllMocks();
         jest.useRealTimers();
     });
@@ -285,6 +290,87 @@ describe("ActaWsClient", () => {
         expect(authRequests[3].data.request_id).toBe(cancelRfqId);
         expect(authRequests[4].data.request_id).toBe(cancelQuoteId);
     });
+    it("createRfq rejects when market descriptor is missing", async () => {
+        const { client, socket } = makeHarness();
+        client.connectAnonymous();
+        const ws = socket();
+        ws.triggerOpen();
+        ws.triggerMessage(WELCOME_MESSAGE);
+        client.handleMessage({
+            type: "AuthSuccess",
+            data: { session_id: "session-id", expires_at: 1_710_086_400 },
+        });
+        await expect(client.createRfq({
+            market: "market-1",
+            position_type: "covered_call",
+            strike: 100_000_000_000,
+            quantity: 2_000_000_000,
+        })).rejects.toThrow("Missing market descriptor");
+        const sentTypes = ws.sent.map((payload) => parseClientMessage(payload).type);
+        expect(sentTypes).not.toContain("RfqRequest");
+    });
+    it("createRfq validates quantity against market size rule", async () => {
+        const { client, socket } = makeHarness();
+        client.connectAnonymous();
+        const ws = socket();
+        ws.triggerOpen();
+        ws.triggerMessage(WELCOME_MESSAGE);
+        client.handleMessage({
+            type: "AuthSuccess",
+            data: { session_id: "session-id", expires_at: 1_710_086_400 },
+        });
+        client.handleMessage({
+            type: "MarketDescriptors",
+            data: {
+                request_id: "req-1",
+                markets: [
+                    {
+                        market: {
+                            chain_id: 1,
+                            program_id: "program-1",
+                            market_pda: "market-1",
+                            underlying_mint: "So11111111111111111111111111111111111111112",
+                            quote_mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                            expiry_ts: 1_800_000_000,
+                            is_put: false,
+                            collateral_mint: "So11111111111111111111111111111111111111112",
+                            settlement_mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+                        },
+                        underlying_oracle_pda: "oracle-underlying",
+                        quote_oracle_pda: "oracle-quote",
+                        underlying_decimals: 9,
+                        quote_decimals: 6,
+                        size_rule: {
+                            min_size: 2_000_000_000,
+                            max_size: 10_000_000_000,
+                            step: 1_000_000_000,
+                        },
+                    },
+                ],
+            },
+        });
+        await expect(client.createRfq({
+            market: "market-1",
+            position_type: "covered_call",
+            strike: 100_000_000_000,
+            quantity: 2_500_000_000,
+        })).rejects.toThrow("(quantity - min_size) % step == 0");
+        await client.createRfq({
+            market: "market-1",
+            position_type: "covered_call",
+            strike: 100_000_000_000,
+            quantity: 3_000_000_000,
+        });
+        const sentMessages = ws.sent.map(parseClientMessage);
+        const rfqRequest = sentMessages
+            .filter((message) => message.type === "RfqRequest")
+            .at(-1);
+        expect(rfqRequest?.type).toBe("RfqRequest");
+        if (rfqRequest?.type === "RfqRequest") {
+            expect(rfqRequest.data.market).toBe("market-1");
+            expect(rfqRequest.data.quantity).toBe(3_000_000_000);
+        }
+    });
     it("drop_oldest policy keeps the latest queued messages", () => {
         const { client, socket } = makeHarness({
             maxPendingMessages: 2,

package/dist/ws/discovery.js

@@ -8,11 +8,13 @@ export function deriveTokenLists(markets) {
         underlyings.set(uMint, {
             mint: m.market.underlying_mint,
             decimals: m.underlying_decimals,
+            size_rule: m.size_rule,
             symbol: m.underlying_symbol,
         });
         const q = {
             mint: m.market.quote_mint,
             decimals: m.quote_decimals,
+            size_rule: m.size_rule,
             symbol: m.quote_symbol,
         };
         const inner = quotesByUnderlying.get(uMint) ?? new Map();

package/dist/ws/types.d.ts

@@ -469,13 +469,20 @@ export type MarketDescriptorInfo = {
     quote_oracle_pda: PubkeyBase58;
     underlying_decimals: number;
     quote_decimals: number;
-    underlying_symbol?: string;
-    quote_symbol?: string;
+    size_rule: PositionSizeRule;
+    underlying_symbol: string;
+    quote_symbol: string;
+};
+export type PositionSizeRule = {
+    min_size: WsU64;
+    max_size: WsU64;
+    step: WsU64;
 };
 export type TokenInfo = {
     mint: Address<string>;
     decimals: number;
-    symbol?: string;
+    size_rule: PositionSizeRule;
+    symbol: string;
 };
 export type RfqCreatedMessage = {
     rfq_id: UuidString;
@@ -711,8 +718,8 @@ export type MakerMarketInfo = {
     expiry_ts: WsU64;
     is_put: boolean;
     is_finalized: boolean;
-    underlying_symbol?: string;
-    quote_symbol?: string;
+    underlying_symbol: string;
+    quote_symbol: string;
     stats?: MarketStats;
 };
 export type MarketStats = {

package/dist/ws/wirePolicy.d.ts

@@ -10,3 +10,9 @@
  */
 export declare function assertWsU64Safe(value: number, name: string): void;
 export declare function assertWsI64Safe(value: number, name: string): void;
+export type QuantitySizeRuleLike = {
+    min_size: number;
+    max_size: number;
+    step: number;
+};
+export declare function validateQuantityBySizeRule(quantity: number, rule: QuantitySizeRuleLike, quantityName?: string): void;

package/dist/ws/wirePolicy.js

@@ -28,3 +28,18 @@ export function assertWsI64Safe(value, name) {
         throw new Error(`${name} exceeds JS safe integer range; WS wire requires safe integers`);
     }
 }
+export function validateQuantityBySizeRule(quantity, rule, quantityName = "quantity") {
+    assertWsU64Safe(quantity, quantityName);
+    assertWsU64Safe(rule.min_size, "size_rule.min_size");
+    assertWsU64Safe(rule.max_size, "size_rule.max_size");
+    assertWsU64Safe(rule.step, "size_rule.step");
+    if (rule.max_size < rule.min_size) {
+        throw new Error(`invalid size_rule: max_size (${rule.max_size}) must be >= min_size (${rule.min_size})`);
+    }
+    if (quantity < rule.min_size || quantity > rule.max_size) {
+        throw new Error(`${quantityName} must be within [${rule.min_size}, ${rule.max_size}], got ${quantity}`);
+    }
+    if ((quantity - rule.min_size) % rule.step !== 0) {
+        throw new Error(`${quantityName} must satisfy (quantity - min_size) % step == 0 (quantity=${quantity}, min_size=${rule.min_size}, step=${rule.step})`);
+    }
+}

package/dist/ws/wirePolicy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/ws/wirePolicy.test.js

@@ -0,0 +1,20 @@
+import { validateQuantityBySizeRule } from "./wirePolicy";
+describe("validateQuantityBySizeRule", () => {
+    const rule = {
+        min_size: 2_000_000_000,
+        max_size: 10_000_000_000,
+        step: 1_000_000_000,
+    };
+    it("accepts a valid quantity", () => {
+        expect(() => validateQuantityBySizeRule(6_000_000_000, rule)).not.toThrow();
+    });
+    it("rejects quantity below min", () => {
+        expect(() => validateQuantityBySizeRule(1_000_000_000, rule)).toThrow("must be within");
+    });
+    it("rejects quantity above max", () => {
+        expect(() => validateQuantityBySizeRule(11_000_000_000, rule)).toThrow("must be within");
+    });
+    it("rejects quantity with invalid step", () => {
+        expect(() => validateQuantityBySizeRule(2_500_000_000, rule)).toThrow("(quantity - min_size) % step == 0");
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acta-markets/ts-sdk",
-  "version": "0.0.5-beta",
+  "version": "0.0.6-beta",
   "description": "TypeScript SDK for Acta Protocol",
   "type": "module",
   "main": "dist/index.js",