@acta-markets/ts-sdk 0.0.12-beta → 0.0.14-beta

package/dist/chain/fetch.d.ts

@@ -37,7 +37,7 @@ export declare const MAKER_ACCOUNT_DISCRIMINATOR = 2;
 export declare const CONFIG_ACCOUNT_DISCRIMINATOR = 3;
 export declare const MARKET_ACCOUNT_DISCRIMINATOR = 4;
 export declare const ORACLE_ACCOUNT_DISCRIMINATOR = 5;
-export declare const POSITION_ACCOUNT_SIZE_BYTES = 416;
+export declare const POSITION_ACCOUNT_SIZE_BYTES = 424;
 export declare const MAKER_ACCOUNT_SIZE_BYTES = 328;
 export declare const CONFIG_ACCOUNT_SIZE_BYTES = 392;
 export declare const MARKET_ACCOUNT_SIZE_BYTES = 416;

package/dist/chain/fetch.js

@@ -41,7 +41,7 @@ export const CONFIG_ACCOUNT_DISCRIMINATOR = 3;
 export const MARKET_ACCOUNT_DISCRIMINATOR = 4;
 export const ORACLE_ACCOUNT_DISCRIMINATOR = 5;
 // Account sizes (bytes). Note: Maker includes 4 bytes of padding on-chain.
-export const POSITION_ACCOUNT_SIZE_BYTES = 416;
+export const POSITION_ACCOUNT_SIZE_BYTES = 424;
 export const MAKER_ACCOUNT_SIZE_BYTES = 328;
 export const CONFIG_ACCOUNT_SIZE_BYTES = 392;
 export const MARKET_ACCOUNT_SIZE_BYTES = 416;

package/dist/cjs/chain/fetch.js

@@ -80,7 +80,7 @@ exports.CONFIG_ACCOUNT_DISCRIMINATOR = 3;
 exports.MARKET_ACCOUNT_DISCRIMINATOR = 4;
 exports.ORACLE_ACCOUNT_DISCRIMINATOR = 5;
 // Account sizes (bytes). Note: Maker includes 4 bytes of padding on-chain.
-exports.POSITION_ACCOUNT_SIZE_BYTES = 416;
+exports.POSITION_ACCOUNT_SIZE_BYTES = 424;
 exports.MAKER_ACCOUNT_SIZE_BYTES = 328;
 exports.CONFIG_ACCOUNT_SIZE_BYTES = 392;
 exports.MARKET_ACCOUNT_SIZE_BYTES = 416;

package/dist/cjs/events.test.js

@@ -354,7 +354,8 @@ describe("events parsing", () => {
                 Buffer.from(pk(2)),
                 Buffer.from(pk(3)),
                 Buffer.from(pk(4)),
-                Buffer.from([5]),
+                Buffer.from([5]), // finalStatus
+                Buffer.from([1]), // isOtm
             ]));
             const d = (0, events_1.decodeActaEventLine)(line);
             expect(d.kind).toBe(events_1.EventKind.SettlePosition);
@@ -365,6 +366,7 @@ describe("events parsing", () => {
                 expect(d.event.positionPda).toBe(addr(3));
                 expect(d.event.marketPda).toBe(addr(4));
                 expect(d.event.finalStatus).toBe(5);
+                expect(d.event.isOtm).toBe(1);
             }
         }
     });

package/dist/cjs/generated/errors/actaContract.js

@@ -7,7 +7,7 @@
  * @see https://github.com/codama-idl/codama
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = exports.ACTA_CONTRACT_ERROR__ORACLE_HAS_ACTIVE_MARKETS = exports.ACTA_CONTRACT_ERROR__ORACLE_SOURCE_LOCKED = exports.ACTA_CONTRACT_ERROR__ORACLE_ALREADY_UPDATED = exports.ACTA_CONTRACT_ERROR__ORACLE_CLOSE_TOO_EARLY = exports.ACTA_CONTRACT_ERROR__UNAUTHORIZED = exports.ACTA_CONTRACT_ERROR__INVALID_TIMESTAMP = exports.ACTA_CONTRACT_ERROR__INVALID_PROGRAM_ID = exports.ACTA_CONTRACT_ERROR__INSUFFICIENT_FUNDS = exports.ACTA_CONTRACT_ERROR__MINT_MISMATCH = exports.ACTA_CONTRACT_ERROR__MATH_OVERFLOW = exports.ACTA_CONTRACT_ERROR__INVALID_INSTRUCTION_DATA = exports.ACTA_CONTRACT_ERROR__SIGNED_MESSAGE_MISMATCH = exports.ACTA_CONTRACT_ERROR__SIGNER_MISMATCH = exports.ACTA_CONTRACT_ERROR__INVALID_SIGNATURE_COUNT = exports.ACTA_CONTRACT_ERROR__INVALID_ORDER_ID = exports.ACTA_CONTRACT_ERROR__POSITION_TYPE_MISMATCH = exports.ACTA_CONTRACT_ERROR__POSITION_NOT_ITM = exports.ACTA_CONTRACT_ERROR__POSITION_ALREADY_SETTLED = exports.ACTA_CONTRACT_ERROR__POSITION_NOT_FUNDED = exports.ACTA_CONTRACT_ERROR__POSITION_ALREADY_FUNDED = exports.ACTA_CONTRACT_ERROR__POSITION_NOT_OPEN = exports.ACTA_CONTRACT_ERROR__POSITION_ALREADY_OPEN = exports.ACTA_CONTRACT_ERROR__ORACLE_INVALID_PRICE = exports.ACTA_CONTRACT_ERROR__ORACLE_INACTIVE = exports.ACTA_CONTRACT_ERROR__ORACLE_STALE = exports.ACTA_CONTRACT_ERROR__ORACLE_EXPIRY_MISMATCH = exports.ACTA_CONTRACT_ERROR__INVALID_ORACLE_ACCOUNT = exports.ACTA_CONTRACT_ERROR__INVALID_ORACLE_TYPE = exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EMPTY = exports.ACTA_CONTRACT_ERROR__MARKET_EXPIRED = exports.ACTA_CONTRACT_ERROR__MARKET_NOT_FINALIZED = exports.ACTA_CONTRACT_ERROR__MARKET_FINALIZED = exports.ACTA_CONTRACT_ERROR__MAKER_NOT_OWNER = exports.ACTA_CONTRACT_ERROR__MAKER_NOT_REGISTERED = exports.ACTA_CONTRACT_ERROR__MAKER_ALREADY_REGISTERED = exports.ACTA_CONTRACT_ERROR__ACCOUNT_ALREADY_INITIALIZED = exports.ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_DATA = exports.ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_COUNT = exports.ACTA_CONTRACT_ERROR__ACCOUNT_NOT_INITIALIZED = exports.ACTA_CONTRACT_ERROR__INVALID_PDA = exports.ACTA_CONTRACT_ERROR__INVALID_OWNER = exports.ACTA_CONTRACT_ERROR__NOT_SIGNED = void 0;
+exports.ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = exports.ACTA_CONTRACT_ERROR__ORACLE_HAS_ACTIVE_MARKETS = exports.ACTA_CONTRACT_ERROR__ORACLE_SOURCE_LOCKED = exports.ACTA_CONTRACT_ERROR__ORACLE_ALREADY_UPDATED = exports.ACTA_CONTRACT_ERROR__ORACLE_CLOSE_TOO_EARLY = exports.ACTA_CONTRACT_ERROR__UNAUTHORIZED = exports.ACTA_CONTRACT_ERROR__INVALID_TIMESTAMP = exports.ACTA_CONTRACT_ERROR__INVALID_PROGRAM_ID = exports.ACTA_CONTRACT_ERROR__INSUFFICIENT_FUNDS = exports.ACTA_CONTRACT_ERROR__MINT_MISMATCH = exports.ACTA_CONTRACT_ERROR__MATH_OVERFLOW = exports.ACTA_CONTRACT_ERROR__INVALID_INSTRUCTION_DATA = exports.ACTA_CONTRACT_ERROR__SIGNED_MESSAGE_MISMATCH = exports.ACTA_CONTRACT_ERROR__SIGNER_MISMATCH = exports.ACTA_CONTRACT_ERROR__INVALID_SIGNATURE_COUNT = exports.ACTA_CONTRACT_ERROR__INVALID_ORDER_ID = exports.ACTA_CONTRACT_ERROR__CANNOT_LIQUIDATE_FUNDED = exports.ACTA_CONTRACT_ERROR__POSITION_TYPE_MISMATCH = exports.ACTA_CONTRACT_ERROR__POSITION_NOT_ITM = exports.ACTA_CONTRACT_ERROR__POSITION_ALREADY_SETTLED = exports.ACTA_CONTRACT_ERROR__POSITION_NOT_FUNDED = exports.ACTA_CONTRACT_ERROR__POSITION_ALREADY_FUNDED = exports.ACTA_CONTRACT_ERROR__POSITION_NOT_OPEN = exports.ACTA_CONTRACT_ERROR__POSITION_ALREADY_OPEN = exports.ACTA_CONTRACT_ERROR__ORACLE_INVALID_PRICE = exports.ACTA_CONTRACT_ERROR__ORACLE_INACTIVE = exports.ACTA_CONTRACT_ERROR__ORACLE_STALE = exports.ACTA_CONTRACT_ERROR__ORACLE_EXPIRY_MISMATCH = exports.ACTA_CONTRACT_ERROR__INVALID_ORACLE_ACCOUNT = exports.ACTA_CONTRACT_ERROR__INVALID_ORACLE_TYPE = exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EMPTY = exports.ACTA_CONTRACT_ERROR__MARKET_EXPIRED = exports.ACTA_CONTRACT_ERROR__MARKET_NOT_FINALIZED = exports.ACTA_CONTRACT_ERROR__MARKET_FINALIZED = exports.ACTA_CONTRACT_ERROR__MAKER_NOT_OWNER = exports.ACTA_CONTRACT_ERROR__MAKER_NOT_REGISTERED = exports.ACTA_CONTRACT_ERROR__MAKER_ALREADY_REGISTERED = exports.ACTA_CONTRACT_ERROR__ACCOUNT_ALREADY_INITIALIZED = exports.ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_DATA = exports.ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_COUNT = exports.ACTA_CONTRACT_ERROR__ACCOUNT_NOT_INITIALIZED = exports.ACTA_CONTRACT_ERROR__INVALID_PDA = exports.ACTA_CONTRACT_ERROR__INVALID_OWNER = exports.ACTA_CONTRACT_ERROR__NOT_SIGNED = void 0;
 exports.getActaContractErrorMessage = getActaContractErrorMessage;
 exports.isActaContractError = isActaContractError;
 const kit_1 = require("@solana/kit");
@@ -66,6 +66,8 @@ exports.ACTA_CONTRACT_ERROR__POSITION_ALREADY_SETTLED = 0x40a; // 1034
 exports.ACTA_CONTRACT_ERROR__POSITION_NOT_ITM = 0x40b; // 1035
 /** PositionTypeMismatch: Position type doesn't match market (call vs put) */
 exports.ACTA_CONTRACT_ERROR__POSITION_TYPE_MISMATCH = 0x40c; // 1036
+/** CannotLiquidateFunded: Cannot liquidate a funded position (use settle instead) */
+exports.ACTA_CONTRACT_ERROR__CANNOT_LIQUIDATE_FUNDED = 0x40d; // 1037
 /** InvalidOrderId: order_id != sha256(preimage) */
 exports.ACTA_CONTRACT_ERROR__INVALID_ORDER_ID = 0x410; // 1040
 /** InvalidSignatureCount: Ed25519 instruction has wrong signature count */
@@ -103,6 +105,7 @@ if (process.env.NODE_ENV !== "production") {
     actaContractErrorMessages = {
         [exports.ACTA_CONTRACT_ERROR__ACCOUNT_ALREADY_INITIALIZED]: `Account already initialized`,
         [exports.ACTA_CONTRACT_ERROR__ACCOUNT_NOT_INITIALIZED]: `Account not initialized`,
+        [exports.ACTA_CONTRACT_ERROR__CANNOT_LIQUIDATE_FUNDED]: `Cannot liquidate a funded position (use settle instead)`,
         [exports.ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT]: `Duplicate account passed to instruction`,
         [exports.ACTA_CONTRACT_ERROR__INSUFFICIENT_FUNDS]: `Balance is below the required amount`,
         [exports.ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_COUNT]: `Wrong number of accounts`,

package/dist/cjs/generated/instructions/closeMarket.js

@@ -35,7 +35,7 @@ function getCloseMarketInstruction(input, config) {
     const programAddress = config?.programAddress ?? programs_1.ACTA_CONTRACT_PROGRAM_ADDRESS;
     // Original accounts.
     const originalAccounts = {
-        admin: { value: input.admin ?? null, isWritable: false },
+        admin: { value: input.admin ?? null, isWritable: true },
         configPda: { value: input.configPda ?? null, isWritable: false },
         marketPda: { value: input.marketPda ?? null, isWritable: true },
         oracleUnderlying: {

package/dist/cjs/generated/instructions/createMarket.js

@@ -43,7 +43,7 @@ function getCreateMarketInstruction(input, config) {
     const programAddress = config?.programAddress ?? programs_1.ACTA_CONTRACT_PROGRAM_ADDRESS;
     // Original accounts.
     const originalAccounts = {
-        admin: { value: input.admin ?? null, isWritable: false },
+        admin: { value: input.admin ?? null, isWritable: true },
         configPda: { value: input.configPda ?? null, isWritable: false },
         marketPda: { value: input.marketPda ?? null, isWritable: true },
         underlyingMint: { value: input.underlyingMint ?? null, isWritable: false },

package/dist/cjs/generated/instructions/openPosition.js

@@ -60,7 +60,7 @@ function getOpenPositionInstruction(input, config) {
             isWritable: true,
         },
         userQuoteAta: { value: input.userQuoteAta ?? null, isWritable: true },
-        makerPda: { value: input.makerPda ?? null, isWritable: true },
+        makerPda: { value: input.makerPda ?? null, isWritable: false },
         makerPremiumAta: { value: input.makerPremiumAta ?? null, isWritable: true },
         marketPda: { value: input.marketPda ?? null, isWritable: true },
         positionPda: { value: input.positionPda ?? null, isWritable: true },

package/dist/cjs/generated/instructions/withdrawPremium.js

@@ -42,7 +42,7 @@ function getWithdrawPremiumInstruction(input, config) {
     // Original accounts.
     const originalAccounts = {
         makerOwner: { value: input.makerOwner ?? null, isWritable: false },
-        makerPda: { value: input.makerPda ?? null, isWritable: true },
+        makerPda: { value: input.makerPda ?? null, isWritable: false },
         makerPremiumAta: { value: input.makerPremiumAta ?? null, isWritable: true },
         makerOwnerPremiumAta: {
             value: input.makerOwnerPremiumAta ?? null,

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

@@ -135,6 +135,7 @@ function getActaEventEncoder() {
                 ["positionPda", (0, kit_1.getAddressEncoder)()],
                 ["marketPda", (0, kit_1.getAddressEncoder)()],
                 ["finalStatus", (0, kit_1.getU8Encoder)()],
+                ["isOtm", (0, kit_1.getU8Encoder)()],
             ]),
         ],
         [
@@ -297,6 +298,7 @@ function getActaEventDecoder() {
                 ["positionPda", (0, kit_1.getAddressDecoder)()],
                 ["marketPda", (0, kit_1.getAddressDecoder)()],
                 ["finalStatus", (0, kit_1.getU8Decoder)()],
+                ["isOtm", (0, kit_1.getU8Decoder)()],
             ]),
         ],
         [

package/dist/cjs/idl/acta_contract.json

@@ -270,7 +270,7 @@
                 },
                 {
                     "name": "makerPda",
-                    "isMut": true,
+                    "isMut": false,
                     "isSigner": false,
                     "docs": [
                         "Maker PDA for signer seeds"
@@ -317,7 +317,7 @@
             "accounts": [
                 {
                     "name": "admin",
-                    "isMut": false,
+                    "isMut": true,
                     "isSigner": true,
                     "docs": [
                         "Protocol admin authority"
@@ -448,7 +448,7 @@
                 },
                 {
                     "name": "makerPda",
-                    "isMut": true,
+                    "isMut": false,
                     "isSigner": false,
                     "docs": [
                         "Maker PDA authority"
@@ -994,7 +994,7 @@
             "accounts": [
                 {
                     "name": "admin",
-                    "isMut": false,
+                    "isMut": true,
                     "isSigner": true,
                     "docs": [
                         "Protocol admin authority"
@@ -2021,6 +2021,10 @@
                             {
                                 "name": "final_status",
                                 "type": "u8"
+                            },
+                            {
+                                "name": "is_otm",
+                                "type": "u8"
                             }
                         ]
                     },
@@ -2270,6 +2274,11 @@
             "name": "PositionNotItm",
             "msg": "Position not ITM (cannot liquidate OTM)"
         },
+        {
+            "code": 1037,
+            "name": "CannotLiquidateFunded",
+            "msg": "Cannot liquidate a funded position (use settle instead)"
+        },
         {
             "code": 1036,
             "name": "PositionTypeMismatch",

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 = "a86d779d49761e2979103c9ebd3eeb10f85fc9c4fc5848d78d11326e3eedab83";
+exports.ACTA_IDL_SHA256 = "85637746c4aabc7c4638de439ca8cf3cf6dfda58b2e26e5347077abdb78958dc";

package/dist/cjs/ws/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./flows"), exports);
 __exportStar(require("./sponsoredTx"), exports);
 __exportStar(require("./apy"), exports);
 __exportStar(require("./discovery"), exports);
+__exportStar(require("./sizing"), exports);

package/dist/cjs/ws/sizing.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * CSP quantity / size-rule conversion helpers.
+ *
+ * On the wire, `quantity` is always in underlying atomic units (e.g. SOL lamports).
+ * For covered calls the user thinks in underlying (SOL), so no conversion is needed.
+ * For cash-secured puts the user thinks in quote (USDC), so the frontend must convert
+ * between the user's USDC input and the wire's underlying quantity.
+ *
+ * These helpers handle that conversion and let the frontend display size_rule
+ * constraints in quote terms.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quoteAmountToQuantity = quoteAmountToQuantity;
+exports.quantityToQuoteAmount = quantityToQuoteAmount;
+exports.sizeRuleInQuoteTerms = sizeRuleInQuoteTerms;
+const apy_1 = require("./apy");
+/**
+ * Convert a user's quote-denominated deposit (e.g. 450 USDC) to the wire
+ * quantity in underlying atomic units.
+ *
+ * Formula: `round(quoteAmount * 10^underlyingDecimals * PRICE_SCALE / strike1e9)`
+ *
+ * @param quoteAmount     Human-readable quote amount (e.g. 450 for "450 USDC")
+ * @param strike1e9       Strike price, 1e9-scaled (e.g. 90_000_000_000 for $90)
+ * @param underlyingDecimals  Decimals of the underlying mint (e.g. 9 for SOL)
+ * @returns Wire quantity (underlying atomic units)
+ */
+function quoteAmountToQuantity(quoteAmount, strike1e9, underlyingDecimals) {
+    if (!Number.isFinite(quoteAmount) || quoteAmount < 0) {
+        throw new Error("quoteAmount must be a non-negative finite number");
+    }
+    if (!Number.isFinite(strike1e9) || strike1e9 <= 0) {
+        throw new Error("strike1e9 must be a positive finite number");
+    }
+    const atomicFactor = Math.pow(10, underlyingDecimals);
+    return Math.round(quoteAmount * atomicFactor * apy_1.PRICE_SCALE / strike1e9);
+}
+/**
+ * Convert a wire quantity (underlying atomic units) to a human-readable
+ * quote-denominated amount.
+ *
+ * Formula: `quantity * strike1e9 / PRICE_SCALE / 10^underlyingDecimals`
+ *
+ * @param quantity            Wire quantity (underlying atomic units)
+ * @param strike1e9           Strike price, 1e9-scaled
+ * @param underlyingDecimals  Decimals of the underlying mint
+ * @returns Human-readable quote amount (e.g. 450 for "450 USDC")
+ */
+function quantityToQuoteAmount(quantity, strike1e9, underlyingDecimals) {
+    if (!Number.isFinite(quantity) || quantity < 0) {
+        throw new Error("quantity must be a non-negative finite number");
+    }
+    if (!Number.isFinite(strike1e9) || strike1e9 <= 0) {
+        throw new Error("strike1e9 must be a positive finite number");
+    }
+    const atomicFactor = Math.pow(10, underlyingDecimals);
+    return quantity * strike1e9 / apy_1.PRICE_SCALE / atomicFactor;
+}
+/**
+ * Convert a size_rule (underlying atomic units) to human-readable quote terms.
+ *
+ * Example: SOL/USDC CSP, strike $90, rule {min: 1e9, max: 10e9, step: 1e8}
+ * → returns {min: 90, max: 900, step: 9} (USDC)
+ *
+ * @param rule                Size rule from MarketDescriptorInfo
+ * @param strike1e9           Strike price, 1e9-scaled
+ * @param underlyingDecimals  Decimals of the underlying mint
+ */
+function sizeRuleInQuoteTerms(rule, strike1e9, underlyingDecimals) {
+    if (!Number.isFinite(strike1e9) || strike1e9 <= 0) {
+        throw new Error("strike1e9 must be a positive finite number");
+    }
+    return {
+        min: quantityToQuoteAmount(rule.min_size, strike1e9, underlyingDecimals),
+        max: quantityToQuoteAmount(rule.max_size, strike1e9, underlyingDecimals),
+        step: quantityToQuoteAmount(rule.step, strike1e9, underlyingDecimals),
+    };
+}

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

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sizing_1 = require("./sizing");
+describe("ws sizing helpers", () => {
+    // SOL: 9 decimals, strike $90 = 90_000_000_000 (1e9-scaled)
+    const SOL_DECIMALS = 9;
+    const STRIKE_90 = 90_000_000_000;
+    describe("quoteAmountToQuantity", () => {
+        it("converts 450 USDC at $90 strike to 5 SOL in lamports", () => {
+            expect((0, sizing_1.quoteAmountToQuantity)(450, STRIKE_90, SOL_DECIMALS)).toBe(5_000_000_000);
+        });
+        it("converts 90 USDC (min) to 1 SOL in lamports", () => {
+            expect((0, sizing_1.quoteAmountToQuantity)(90, STRIKE_90, SOL_DECIMALS)).toBe(1_000_000_000);
+        });
+        it("converts 9 USDC (one step) to 0.1 SOL in lamports", () => {
+            expect((0, sizing_1.quoteAmountToQuantity)(9, STRIKE_90, SOL_DECIMALS)).toBe(100_000_000);
+        });
+        it("returns 0 for 0 input", () => {
+            expect((0, sizing_1.quoteAmountToQuantity)(0, STRIKE_90, SOL_DECIMALS)).toBe(0);
+        });
+        it("throws on negative quoteAmount", () => {
+            expect(() => (0, sizing_1.quoteAmountToQuantity)(-1, STRIKE_90, SOL_DECIMALS)).toThrow("quoteAmount");
+        });
+        it("throws on zero strike", () => {
+            expect(() => (0, sizing_1.quoteAmountToQuantity)(100, 0, SOL_DECIMALS)).toThrow("strike1e9");
+        });
+        it("throws on negative strike", () => {
+            expect(() => (0, sizing_1.quoteAmountToQuantity)(100, -1, SOL_DECIMALS)).toThrow("strike1e9");
+        });
+    });
+    describe("quantityToQuoteAmount", () => {
+        it("converts 5 SOL lamports at $90 strike to 450 USDC", () => {
+            expect((0, sizing_1.quantityToQuoteAmount)(5_000_000_000, STRIKE_90, SOL_DECIMALS)).toBeCloseTo(450, 10);
+        });
+        it("converts 1 SOL lamports to 90 USDC", () => {
+            expect((0, sizing_1.quantityToQuoteAmount)(1_000_000_000, STRIKE_90, SOL_DECIMALS)).toBeCloseTo(90, 10);
+        });
+        it("converts 0.1 SOL lamports to 9 USDC", () => {
+            expect((0, sizing_1.quantityToQuoteAmount)(100_000_000, STRIKE_90, SOL_DECIMALS)).toBeCloseTo(9, 10);
+        });
+        it("returns 0 for 0 quantity", () => {
+            expect((0, sizing_1.quantityToQuoteAmount)(0, STRIKE_90, SOL_DECIMALS)).toBe(0);
+        });
+        it("throws on negative quantity", () => {
+            expect(() => (0, sizing_1.quantityToQuoteAmount)(-1, STRIKE_90, SOL_DECIMALS)).toThrow("quantity");
+        });
+    });
+    describe("round-trip", () => {
+        it("quoteAmount -> quantity -> quoteAmount is stable", () => {
+            const original = 450;
+            const quantity = (0, sizing_1.quoteAmountToQuantity)(original, STRIKE_90, SOL_DECIMALS);
+            const restored = (0, sizing_1.quantityToQuoteAmount)(quantity, STRIKE_90, SOL_DECIMALS);
+            expect(restored).toBeCloseTo(original, 6);
+        });
+        it("round-trips at step granularity (9 USDC)", () => {
+            const original = 9;
+            const quantity = (0, sizing_1.quoteAmountToQuantity)(original, STRIKE_90, SOL_DECIMALS);
+            const restored = (0, sizing_1.quantityToQuoteAmount)(quantity, STRIKE_90, SOL_DECIMALS);
+            expect(restored).toBeCloseTo(original, 6);
+        });
+        it("round-trips with different strike ($150)", () => {
+            const strike150 = 150_000_000_000;
+            const original = 300;
+            const quantity = (0, sizing_1.quoteAmountToQuantity)(original, strike150, SOL_DECIMALS);
+            expect(quantity).toBe(2_000_000_000); // 2 SOL
+            const restored = (0, sizing_1.quantityToQuoteAmount)(quantity, strike150, SOL_DECIMALS);
+            expect(restored).toBeCloseTo(original, 6);
+        });
+    });
+    describe("sizeRuleInQuoteTerms", () => {
+        const rule = { min_size: 1_000_000_000, max_size: 10_000_000_000, step: 100_000_000 };
+        it("converts SOL size_rule to USDC terms at $90 strike", () => {
+            const result = (0, sizing_1.sizeRuleInQuoteTerms)(rule, STRIKE_90, SOL_DECIMALS);
+            expect(result.min).toBeCloseTo(90, 6);
+            expect(result.max).toBeCloseTo(900, 6);
+            expect(result.step).toBeCloseTo(9, 6);
+        });
+        it("converts at $150 strike", () => {
+            const strike150 = 150_000_000_000;
+            const result = (0, sizing_1.sizeRuleInQuoteTerms)(rule, strike150, SOL_DECIMALS);
+            expect(result.min).toBeCloseTo(150, 6);
+            expect(result.max).toBeCloseTo(1500, 6);
+            expect(result.step).toBeCloseTo(15, 6);
+        });
+        it("throws on zero strike", () => {
+            expect(() => (0, sizing_1.sizeRuleInQuoteTerms)(rule, 0, SOL_DECIMALS)).toThrow("strike1e9");
+        });
+    });
+    describe("non-9-decimal underlying", () => {
+        // ETH: 8 decimals
+        const ETH_DECIMALS = 8;
+        const STRIKE_3000 = 3_000_000_000_000; // $3000
+        it("converts 6000 USDC at $3000 strike to 2 ETH (8 decimals)", () => {
+            expect((0, sizing_1.quoteAmountToQuantity)(6000, STRIKE_3000, ETH_DECIMALS)).toBe(200_000_000);
+        });
+        it("converts 2 ETH back to 6000 USDC", () => {
+            expect((0, sizing_1.quantityToQuoteAmount)(200_000_000, STRIKE_3000, ETH_DECIMALS)).toBeCloseTo(6000, 6);
+        });
+    });
+});

package/dist/events.test.js

@@ -352,7 +352,8 @@ describe("events parsing", () => {
                 Buffer.from(pk(2)),
                 Buffer.from(pk(3)),
                 Buffer.from(pk(4)),
-                Buffer.from([5]),
+                Buffer.from([5]), // finalStatus
+                Buffer.from([1]), // isOtm
             ]));
             const d = decodeActaEventLine(line);
             expect(d.kind).toBe(EventKind.SettlePosition);
@@ -363,6 +364,7 @@ describe("events parsing", () => {
                 expect(d.event.positionPda).toBe(addr(3));
                 expect(d.event.marketPda).toBe(addr(4));
                 expect(d.event.finalStatus).toBe(5);
+                expect(d.event.isOtm).toBe(1);
             }
         }
     });

package/dist/generated/errors/actaContract.d.ts

@@ -60,6 +60,8 @@ export declare const ACTA_CONTRACT_ERROR__POSITION_ALREADY_SETTLED = 1034;
 export declare const ACTA_CONTRACT_ERROR__POSITION_NOT_ITM = 1035;
 /** PositionTypeMismatch: Position type doesn't match market (call vs put) */
 export declare const ACTA_CONTRACT_ERROR__POSITION_TYPE_MISMATCH = 1036;
+/** CannotLiquidateFunded: Cannot liquidate a funded position (use settle instead) */
+export declare const ACTA_CONTRACT_ERROR__CANNOT_LIQUIDATE_FUNDED = 1037;
 /** InvalidOrderId: order_id != sha256(preimage) */
 export declare const ACTA_CONTRACT_ERROR__INVALID_ORDER_ID = 1040;
 /** InvalidSignatureCount: Ed25519 instruction has wrong signature count */
@@ -92,7 +94,7 @@ export declare const ACTA_CONTRACT_ERROR__ORACLE_SOURCE_LOCKED = 1073;
 export declare const ACTA_CONTRACT_ERROR__ORACLE_HAS_ACTIVE_MARKETS = 1074;
 /** DuplicateAccount: Duplicate account passed to instruction */
 export declare const ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = 1075;
-export type ActaContractError = typeof ACTA_CONTRACT_ERROR__ACCOUNT_ALREADY_INITIALIZED | typeof ACTA_CONTRACT_ERROR__ACCOUNT_NOT_INITIALIZED | typeof ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT | typeof ACTA_CONTRACT_ERROR__INSUFFICIENT_FUNDS | typeof ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_COUNT | typeof ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_DATA | typeof ACTA_CONTRACT_ERROR__INVALID_INSTRUCTION_DATA | typeof ACTA_CONTRACT_ERROR__INVALID_ORACLE_ACCOUNT | typeof ACTA_CONTRACT_ERROR__INVALID_ORACLE_TYPE | typeof ACTA_CONTRACT_ERROR__INVALID_ORDER_ID | typeof ACTA_CONTRACT_ERROR__INVALID_OWNER | typeof ACTA_CONTRACT_ERROR__INVALID_PDA | typeof ACTA_CONTRACT_ERROR__INVALID_PROGRAM_ID | typeof ACTA_CONTRACT_ERROR__INVALID_SIGNATURE_COUNT | typeof ACTA_CONTRACT_ERROR__INVALID_TIMESTAMP | typeof ACTA_CONTRACT_ERROR__MAKER_ALREADY_REGISTERED | typeof ACTA_CONTRACT_ERROR__MAKER_NOT_OWNER | typeof ACTA_CONTRACT_ERROR__MAKER_NOT_REGISTERED | typeof ACTA_CONTRACT_ERROR__MARKET_EXPIRED | typeof ACTA_CONTRACT_ERROR__MARKET_FINALIZED | typeof ACTA_CONTRACT_ERROR__MARKET_NOT_EMPTY | typeof ACTA_CONTRACT_ERROR__MARKET_NOT_FINALIZED | typeof ACTA_CONTRACT_ERROR__MATH_OVERFLOW | typeof ACTA_CONTRACT_ERROR__MINT_MISMATCH | typeof ACTA_CONTRACT_ERROR__NOT_SIGNED | typeof ACTA_CONTRACT_ERROR__ORACLE_ALREADY_UPDATED | typeof ACTA_CONTRACT_ERROR__ORACLE_CLOSE_TOO_EARLY | typeof ACTA_CONTRACT_ERROR__ORACLE_EXPIRY_MISMATCH | typeof ACTA_CONTRACT_ERROR__ORACLE_HAS_ACTIVE_MARKETS | typeof ACTA_CONTRACT_ERROR__ORACLE_INACTIVE | typeof ACTA_CONTRACT_ERROR__ORACLE_INVALID_PRICE | typeof ACTA_CONTRACT_ERROR__ORACLE_SOURCE_LOCKED | typeof ACTA_CONTRACT_ERROR__ORACLE_STALE | typeof ACTA_CONTRACT_ERROR__POSITION_ALREADY_FUNDED | typeof ACTA_CONTRACT_ERROR__POSITION_ALREADY_OPEN | typeof ACTA_CONTRACT_ERROR__POSITION_ALREADY_SETTLED | typeof ACTA_CONTRACT_ERROR__POSITION_NOT_FUNDED | typeof ACTA_CONTRACT_ERROR__POSITION_NOT_ITM | typeof ACTA_CONTRACT_ERROR__POSITION_NOT_OPEN | typeof ACTA_CONTRACT_ERROR__POSITION_TYPE_MISMATCH | typeof ACTA_CONTRACT_ERROR__SIGNED_MESSAGE_MISMATCH | typeof ACTA_CONTRACT_ERROR__SIGNER_MISMATCH | typeof ACTA_CONTRACT_ERROR__UNAUTHORIZED;
+export type ActaContractError = typeof ACTA_CONTRACT_ERROR__ACCOUNT_ALREADY_INITIALIZED | typeof ACTA_CONTRACT_ERROR__ACCOUNT_NOT_INITIALIZED | typeof ACTA_CONTRACT_ERROR__CANNOT_LIQUIDATE_FUNDED | typeof ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT | typeof ACTA_CONTRACT_ERROR__INSUFFICIENT_FUNDS | typeof ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_COUNT | typeof ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_DATA | typeof ACTA_CONTRACT_ERROR__INVALID_INSTRUCTION_DATA | typeof ACTA_CONTRACT_ERROR__INVALID_ORACLE_ACCOUNT | typeof ACTA_CONTRACT_ERROR__INVALID_ORACLE_TYPE | typeof ACTA_CONTRACT_ERROR__INVALID_ORDER_ID | typeof ACTA_CONTRACT_ERROR__INVALID_OWNER | typeof ACTA_CONTRACT_ERROR__INVALID_PDA | typeof ACTA_CONTRACT_ERROR__INVALID_PROGRAM_ID | typeof ACTA_CONTRACT_ERROR__INVALID_SIGNATURE_COUNT | typeof ACTA_CONTRACT_ERROR__INVALID_TIMESTAMP | typeof ACTA_CONTRACT_ERROR__MAKER_ALREADY_REGISTERED | typeof ACTA_CONTRACT_ERROR__MAKER_NOT_OWNER | typeof ACTA_CONTRACT_ERROR__MAKER_NOT_REGISTERED | typeof ACTA_CONTRACT_ERROR__MARKET_EXPIRED | typeof ACTA_CONTRACT_ERROR__MARKET_FINALIZED | typeof ACTA_CONTRACT_ERROR__MARKET_NOT_EMPTY | typeof ACTA_CONTRACT_ERROR__MARKET_NOT_FINALIZED | typeof ACTA_CONTRACT_ERROR__MATH_OVERFLOW | typeof ACTA_CONTRACT_ERROR__MINT_MISMATCH | typeof ACTA_CONTRACT_ERROR__NOT_SIGNED | typeof ACTA_CONTRACT_ERROR__ORACLE_ALREADY_UPDATED | typeof ACTA_CONTRACT_ERROR__ORACLE_CLOSE_TOO_EARLY | typeof ACTA_CONTRACT_ERROR__ORACLE_EXPIRY_MISMATCH | typeof ACTA_CONTRACT_ERROR__ORACLE_HAS_ACTIVE_MARKETS | typeof ACTA_CONTRACT_ERROR__ORACLE_INACTIVE | typeof ACTA_CONTRACT_ERROR__ORACLE_INVALID_PRICE | typeof ACTA_CONTRACT_ERROR__ORACLE_SOURCE_LOCKED | typeof ACTA_CONTRACT_ERROR__ORACLE_STALE | typeof ACTA_CONTRACT_ERROR__POSITION_ALREADY_FUNDED | typeof ACTA_CONTRACT_ERROR__POSITION_ALREADY_OPEN | typeof ACTA_CONTRACT_ERROR__POSITION_ALREADY_SETTLED | typeof ACTA_CONTRACT_ERROR__POSITION_NOT_FUNDED | typeof ACTA_CONTRACT_ERROR__POSITION_NOT_ITM | typeof ACTA_CONTRACT_ERROR__POSITION_NOT_OPEN | typeof ACTA_CONTRACT_ERROR__POSITION_TYPE_MISMATCH | typeof ACTA_CONTRACT_ERROR__SIGNED_MESSAGE_MISMATCH | typeof ACTA_CONTRACT_ERROR__SIGNER_MISMATCH | typeof ACTA_CONTRACT_ERROR__UNAUTHORIZED;
 export declare function getActaContractErrorMessage(code: ActaContractError): string;
 export declare function isActaContractError<TProgramErrorCode extends ActaContractError>(error: unknown, transactionMessage: {
     instructions: Record<number, {

package/dist/generated/errors/actaContract.js

@@ -61,6 +61,8 @@ export const ACTA_CONTRACT_ERROR__POSITION_ALREADY_SETTLED = 0x40a; // 1034
 export const ACTA_CONTRACT_ERROR__POSITION_NOT_ITM = 0x40b; // 1035
 /** PositionTypeMismatch: Position type doesn't match market (call vs put) */
 export const ACTA_CONTRACT_ERROR__POSITION_TYPE_MISMATCH = 0x40c; // 1036
+/** CannotLiquidateFunded: Cannot liquidate a funded position (use settle instead) */
+export const ACTA_CONTRACT_ERROR__CANNOT_LIQUIDATE_FUNDED = 0x40d; // 1037
 /** InvalidOrderId: order_id != sha256(preimage) */
 export const ACTA_CONTRACT_ERROR__INVALID_ORDER_ID = 0x410; // 1040
 /** InvalidSignatureCount: Ed25519 instruction has wrong signature count */
@@ -98,6 +100,7 @@ if (process.env.NODE_ENV !== "production") {
     actaContractErrorMessages = {
         [ACTA_CONTRACT_ERROR__ACCOUNT_ALREADY_INITIALIZED]: `Account already initialized`,
         [ACTA_CONTRACT_ERROR__ACCOUNT_NOT_INITIALIZED]: `Account not initialized`,
+        [ACTA_CONTRACT_ERROR__CANNOT_LIQUIDATE_FUNDED]: `Cannot liquidate a funded position (use settle instead)`,
         [ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT]: `Duplicate account passed to instruction`,
         [ACTA_CONTRACT_ERROR__INSUFFICIENT_FUNDS]: `Balance is below the required amount`,
         [ACTA_CONTRACT_ERROR__INVALID_ACCOUNT_COUNT]: `Wrong number of accounts`,

package/dist/generated/instructions/closeMarket.d.ts

@@ -5,12 +5,12 @@
  *
  * @see https://github.com/codama-idl/codama
  */
-import { type AccountMeta, type AccountSignerMeta, type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type Instruction, type InstructionWithAccounts, type InstructionWithData, type ReadonlyAccount, type ReadonlySignerAccount, type ReadonlyUint8Array, type TransactionSigner, type WritableAccount } from "@solana/kit";
+import { type AccountMeta, type AccountSignerMeta, type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type Instruction, type InstructionWithAccounts, type InstructionWithData, type ReadonlyAccount, type ReadonlyUint8Array, type TransactionSigner, type WritableAccount, type WritableSignerAccount } from "@solana/kit";
 import { ACTA_CONTRACT_PROGRAM_ADDRESS } from "../programs";
 export declare const CLOSE_MARKET_DISCRIMINATOR = 14;
 export declare function getCloseMarketDiscriminatorBytes(): ReadonlyUint8Array;
 export type CloseMarketInstruction<TProgram extends string = typeof ACTA_CONTRACT_PROGRAM_ADDRESS, TAccountAdmin extends string | AccountMeta<string> = string, TAccountConfigPda extends string | AccountMeta<string> = string, TAccountMarketPda extends string | AccountMeta<string> = string, TAccountOracleUnderlying extends string | AccountMeta<string> = string, TAccountOracleQuote extends string | AccountMeta<string> = string, TRemainingAccounts extends readonly AccountMeta<string>[] = []> = Instruction<TProgram> & InstructionWithData<ReadonlyUint8Array> & InstructionWithAccounts<[
-    TAccountAdmin extends string ? ReadonlySignerAccount<TAccountAdmin> & AccountSignerMeta<TAccountAdmin> : TAccountAdmin,
+    TAccountAdmin extends string ? WritableSignerAccount<TAccountAdmin> & AccountSignerMeta<TAccountAdmin> : TAccountAdmin,
     TAccountConfigPda extends string ? ReadonlyAccount<TAccountConfigPda> : TAccountConfigPda,
     TAccountMarketPda extends string ? WritableAccount<TAccountMarketPda> : TAccountMarketPda,
     TAccountOracleUnderlying extends string ? WritableAccount<TAccountOracleUnderlying> : TAccountOracleUnderlying,

package/dist/generated/instructions/closeMarket.js

@@ -26,7 +26,7 @@ export function getCloseMarketInstruction(input, config) {
     const programAddress = config?.programAddress ?? ACTA_CONTRACT_PROGRAM_ADDRESS;
     // Original accounts.
     const originalAccounts = {
-        admin: { value: input.admin ?? null, isWritable: false },
+        admin: { value: input.admin ?? null, isWritable: true },
         configPda: { value: input.configPda ?? null, isWritable: false },
         marketPda: { value: input.marketPda ?? null, isWritable: true },
         oracleUnderlying: {

package/dist/generated/instructions/createMarket.d.ts

@@ -5,12 +5,12 @@
  *
  * @see https://github.com/codama-idl/codama
  */
-import { type AccountMeta, type AccountSignerMeta, type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type Instruction, type InstructionWithAccounts, type InstructionWithData, type ReadonlyAccount, type ReadonlySignerAccount, type ReadonlyUint8Array, type TransactionSigner, type WritableAccount } from "@solana/kit";
+import { type AccountMeta, type AccountSignerMeta, type Address, type FixedSizeCodec, type FixedSizeDecoder, type FixedSizeEncoder, type Instruction, type InstructionWithAccounts, type InstructionWithData, type ReadonlyAccount, type ReadonlyUint8Array, type TransactionSigner, type WritableAccount, type WritableSignerAccount } from "@solana/kit";
 import { ACTA_CONTRACT_PROGRAM_ADDRESS } from "../programs";
 export declare const CREATE_MARKET_DISCRIMINATOR = 6;
 export declare function getCreateMarketDiscriminatorBytes(): ReadonlyUint8Array;
 export type CreateMarketInstruction<TProgram extends string = typeof ACTA_CONTRACT_PROGRAM_ADDRESS, TAccountAdmin extends string | AccountMeta<string> = string, TAccountConfigPda extends string | AccountMeta<string> = string, TAccountMarketPda extends string | AccountMeta<string> = string, TAccountUnderlyingMint extends string | AccountMeta<string> = string, TAccountQuoteMint extends string | AccountMeta<string> = string, TAccountUnderlyingMintAcc extends string | AccountMeta<string> = string, TAccountQuoteMintAcc extends string | AccountMeta<string> = string, TAccountOracleUnderlying extends string | AccountMeta<string> = string, TAccountOracleQuote extends string | AccountMeta<string> = string, TAccountSystemProgram extends string | AccountMeta<string> = "11111111111111111111111111111111", TRemainingAccounts extends readonly AccountMeta<string>[] = []> = Instruction<TProgram> & InstructionWithData<ReadonlyUint8Array> & InstructionWithAccounts<[
-    TAccountAdmin extends string ? ReadonlySignerAccount<TAccountAdmin> & AccountSignerMeta<TAccountAdmin> : TAccountAdmin,
+    TAccountAdmin extends string ? WritableSignerAccount<TAccountAdmin> & AccountSignerMeta<TAccountAdmin> : TAccountAdmin,
     TAccountConfigPda extends string ? ReadonlyAccount<TAccountConfigPda> : TAccountConfigPda,
     TAccountMarketPda extends string ? WritableAccount<TAccountMarketPda> : TAccountMarketPda,
     TAccountUnderlyingMint extends string ? ReadonlyAccount<TAccountUnderlyingMint> : TAccountUnderlyingMint,

package/dist/generated/instructions/createMarket.js

@@ -34,7 +34,7 @@ export function getCreateMarketInstruction(input, config) {
     const programAddress = config?.programAddress ?? ACTA_CONTRACT_PROGRAM_ADDRESS;
     // Original accounts.
     const originalAccounts = {
-        admin: { value: input.admin ?? null, isWritable: false },
+        admin: { value: input.admin ?? null, isWritable: true },
         configPda: { value: input.configPda ?? null, isWritable: false },
         marketPda: { value: input.marketPda ?? null, isWritable: true },
         underlyingMint: { value: input.underlyingMint ?? null, isWritable: false },

package/dist/generated/instructions/openPosition.d.ts

@@ -14,7 +14,7 @@ export type OpenPositionInstruction<TProgram extends string = typeof ACTA_CONTRA
     TAccountUser extends string ? ReadonlySignerAccount<TAccountUser> & AccountSignerMeta<TAccountUser> : TAccountUser,
     TAccountUserUnderlyingAta extends string ? WritableAccount<TAccountUserUnderlyingAta> : TAccountUserUnderlyingAta,
     TAccountUserQuoteAta extends string ? WritableAccount<TAccountUserQuoteAta> : TAccountUserQuoteAta,
-    TAccountMakerPda extends string ? WritableAccount<TAccountMakerPda> : TAccountMakerPda,
+    TAccountMakerPda extends string ? ReadonlyAccount<TAccountMakerPda> : TAccountMakerPda,
     TAccountMakerPremiumAta extends string ? WritableAccount<TAccountMakerPremiumAta> : TAccountMakerPremiumAta,
     TAccountMarketPda extends string ? WritableAccount<TAccountMarketPda> : TAccountMarketPda,
     TAccountPositionPda extends string ? WritableAccount<TAccountPositionPda> : TAccountPositionPda,

package/dist/generated/instructions/openPosition.js

@@ -51,7 +51,7 @@ export function getOpenPositionInstruction(input, config) {
             isWritable: true,
         },
         userQuoteAta: { value: input.userQuoteAta ?? null, isWritable: true },
-        makerPda: { value: input.makerPda ?? null, isWritable: true },
+        makerPda: { value: input.makerPda ?? null, isWritable: false },
         makerPremiumAta: { value: input.makerPremiumAta ?? null, isWritable: true },
         marketPda: { value: input.marketPda ?? null, isWritable: true },
         positionPda: { value: input.positionPda ?? null, isWritable: true },

package/dist/generated/instructions/withdrawPremium.d.ts

@@ -11,7 +11,7 @@ export declare const WITHDRAW_PREMIUM_DISCRIMINATOR = 5;
 export declare function getWithdrawPremiumDiscriminatorBytes(): ReadonlyUint8Array;
 export type WithdrawPremiumInstruction<TProgram extends string = typeof ACTA_CONTRACT_PROGRAM_ADDRESS, TAccountMakerOwner extends string | AccountMeta<string> = string, TAccountMakerPda extends string | AccountMeta<string> = string, TAccountMakerPremiumAta extends string | AccountMeta<string> = string, TAccountMakerOwnerPremiumAta extends string | AccountMeta<string> = string, TAccountTokenProgram extends string | AccountMeta<string> = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", TRemainingAccounts extends readonly AccountMeta<string>[] = []> = Instruction<TProgram> & InstructionWithData<ReadonlyUint8Array> & InstructionWithAccounts<[
     TAccountMakerOwner extends string ? ReadonlySignerAccount<TAccountMakerOwner> & AccountSignerMeta<TAccountMakerOwner> : TAccountMakerOwner,
-    TAccountMakerPda extends string ? WritableAccount<TAccountMakerPda> : TAccountMakerPda,
+    TAccountMakerPda extends string ? ReadonlyAccount<TAccountMakerPda> : TAccountMakerPda,
     TAccountMakerPremiumAta extends string ? WritableAccount<TAccountMakerPremiumAta> : TAccountMakerPremiumAta,
     TAccountMakerOwnerPremiumAta extends string ? WritableAccount<TAccountMakerOwnerPremiumAta> : TAccountMakerOwnerPremiumAta,
     TAccountTokenProgram extends string ? ReadonlyAccount<TAccountTokenProgram> : TAccountTokenProgram,

package/dist/generated/instructions/withdrawPremium.js

@@ -33,7 +33,7 @@ export function getWithdrawPremiumInstruction(input, config) {
     // Original accounts.
     const originalAccounts = {
         makerOwner: { value: input.makerOwner ?? null, isWritable: false },
-        makerPda: { value: input.makerPda ?? null, isWritable: true },
+        makerPda: { value: input.makerPda ?? null, isWritable: false },
         makerPremiumAta: { value: input.makerPremiumAta ?? null, isWritable: true },
         makerOwnerPremiumAta: {
             value: input.makerOwnerPremiumAta ?? null,

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

@@ -91,6 +91,7 @@ export type ActaEvent = {
     positionPda: Address;
     marketPda: Address;
     finalStatus: number;
+    isOtm: number;
 } | {
     __kind: "CreateOracle";
     oraclePda: Address;
@@ -203,6 +204,7 @@ export type ActaEventArgs = {
     positionPda: Address;
     marketPda: Address;
     finalStatus: number;
+    isOtm: number;
 } | {
     __kind: "CreateOracle";
     oraclePda: Address;

package/dist/generated/types/actaEvent.js

@@ -128,6 +128,7 @@ export function getActaEventEncoder() {
                 ["positionPda", getAddressEncoder()],
                 ["marketPda", getAddressEncoder()],
                 ["finalStatus", getU8Encoder()],
+                ["isOtm", getU8Encoder()],
             ]),
         ],
         [
@@ -290,6 +291,7 @@ export function getActaEventDecoder() {
                 ["positionPda", getAddressDecoder()],
                 ["marketPda", getAddressDecoder()],
                 ["finalStatus", getU8Decoder()],
+                ["isOtm", getU8Decoder()],
             ]),
         ],
         [

package/dist/idl/acta_contract.json

@@ -270,7 +270,7 @@
                 },
                 {
                     "name": "makerPda",
-                    "isMut": true,
+                    "isMut": false,
                     "isSigner": false,
                     "docs": [
                         "Maker PDA for signer seeds"
@@ -317,7 +317,7 @@
             "accounts": [
                 {
                     "name": "admin",
-                    "isMut": false,
+                    "isMut": true,
                     "isSigner": true,
                     "docs": [
                         "Protocol admin authority"
@@ -448,7 +448,7 @@
                 },
                 {
                     "name": "makerPda",
-                    "isMut": true,
+                    "isMut": false,
                     "isSigner": false,
                     "docs": [
                         "Maker PDA authority"
@@ -994,7 +994,7 @@
             "accounts": [
                 {
                     "name": "admin",
-                    "isMut": false,
+                    "isMut": true,
                     "isSigner": true,
                     "docs": [
                         "Protocol admin authority"
@@ -2021,6 +2021,10 @@
                             {
                                 "name": "final_status",
                                 "type": "u8"
+                            },
+                            {
+                                "name": "is_otm",
+                                "type": "u8"
                             }
                         ]
                     },
@@ -2270,6 +2274,11 @@
             "name": "PositionNotItm",
             "msg": "Position not ITM (cannot liquidate OTM)"
         },
+        {
+            "code": 1037,
+            "name": "CannotLiquidateFunded",
+            "msg": "Cannot liquidate a funded position (use settle instead)"
+        },
         {
             "code": 1036,
             "name": "PositionTypeMismatch",

package/dist/idl/hash.d.ts

@@ -1 +1 @@
-export declare const ACTA_IDL_SHA256 = "a86d779d49761e2979103c9ebd3eeb10f85fc9c4fc5848d78d11326e3eedab83";
+export declare const ACTA_IDL_SHA256 = "85637746c4aabc7c4638de439ca8cf3cf6dfda58b2e26e5347077abdb78958dc";

package/dist/idl/hash.js

@@ -1 +1 @@
-export const ACTA_IDL_SHA256 = "a86d779d49761e2979103c9ebd3eeb10f85fc9c4fc5848d78d11326e3eedab83";
+export const ACTA_IDL_SHA256 = "85637746c4aabc7c4638de439ca8cf3cf6dfda58b2e26e5347077abdb78958dc";

package/dist/ws/index.d.ts

@@ -5,3 +5,4 @@ export * from "./flows";
 export * from "./sponsoredTx";
 export * from "./apy";
 export * from "./discovery";
+export * from "./sizing";

package/dist/ws/index.js

@@ -5,3 +5,4 @@ export * from "./flows";
 export * from "./sponsoredTx";
 export * from "./apy";
 export * from "./discovery";
+export * from "./sizing";

package/dist/ws/sizing.d.ts

@@ -0,0 +1,52 @@
+/**
+ * CSP quantity / size-rule conversion helpers.
+ *
+ * On the wire, `quantity` is always in underlying atomic units (e.g. SOL lamports).
+ * For covered calls the user thinks in underlying (SOL), so no conversion is needed.
+ * For cash-secured puts the user thinks in quote (USDC), so the frontend must convert
+ * between the user's USDC input and the wire's underlying quantity.
+ *
+ * These helpers handle that conversion and let the frontend display size_rule
+ * constraints in quote terms.
+ */
+import type { QuantitySizeRuleLike } from "./wirePolicy";
+/**
+ * Convert a user's quote-denominated deposit (e.g. 450 USDC) to the wire
+ * quantity in underlying atomic units.
+ *
+ * Formula: `round(quoteAmount * 10^underlyingDecimals * PRICE_SCALE / strike1e9)`
+ *
+ * @param quoteAmount     Human-readable quote amount (e.g. 450 for "450 USDC")
+ * @param strike1e9       Strike price, 1e9-scaled (e.g. 90_000_000_000 for $90)
+ * @param underlyingDecimals  Decimals of the underlying mint (e.g. 9 for SOL)
+ * @returns Wire quantity (underlying atomic units)
+ */
+export declare function quoteAmountToQuantity(quoteAmount: number, strike1e9: number, underlyingDecimals: number): number;
+/**
+ * Convert a wire quantity (underlying atomic units) to a human-readable
+ * quote-denominated amount.
+ *
+ * Formula: `quantity * strike1e9 / PRICE_SCALE / 10^underlyingDecimals`
+ *
+ * @param quantity            Wire quantity (underlying atomic units)
+ * @param strike1e9           Strike price, 1e9-scaled
+ * @param underlyingDecimals  Decimals of the underlying mint
+ * @returns Human-readable quote amount (e.g. 450 for "450 USDC")
+ */
+export declare function quantityToQuoteAmount(quantity: number, strike1e9: number, underlyingDecimals: number): number;
+export type QuoteDenominatedSizeRule = {
+    min: number;
+    max: number;
+    step: number;
+};
+/**
+ * Convert a size_rule (underlying atomic units) to human-readable quote terms.
+ *
+ * Example: SOL/USDC CSP, strike $90, rule {min: 1e9, max: 10e9, step: 1e8}
+ * → returns {min: 90, max: 900, step: 9} (USDC)
+ *
+ * @param rule                Size rule from MarketDescriptorInfo
+ * @param strike1e9           Strike price, 1e9-scaled
+ * @param underlyingDecimals  Decimals of the underlying mint
+ */
+export declare function sizeRuleInQuoteTerms(rule: QuantitySizeRuleLike, strike1e9: number, underlyingDecimals: number): QuoteDenominatedSizeRule;

package/dist/ws/sizing.js

@@ -0,0 +1,74 @@
+/**
+ * CSP quantity / size-rule conversion helpers.
+ *
+ * On the wire, `quantity` is always in underlying atomic units (e.g. SOL lamports).
+ * For covered calls the user thinks in underlying (SOL), so no conversion is needed.
+ * For cash-secured puts the user thinks in quote (USDC), so the frontend must convert
+ * between the user's USDC input and the wire's underlying quantity.
+ *
+ * These helpers handle that conversion and let the frontend display size_rule
+ * constraints in quote terms.
+ */
+import { PRICE_SCALE } from "./apy";
+/**
+ * Convert a user's quote-denominated deposit (e.g. 450 USDC) to the wire
+ * quantity in underlying atomic units.
+ *
+ * Formula: `round(quoteAmount * 10^underlyingDecimals * PRICE_SCALE / strike1e9)`
+ *
+ * @param quoteAmount     Human-readable quote amount (e.g. 450 for "450 USDC")
+ * @param strike1e9       Strike price, 1e9-scaled (e.g. 90_000_000_000 for $90)
+ * @param underlyingDecimals  Decimals of the underlying mint (e.g. 9 for SOL)
+ * @returns Wire quantity (underlying atomic units)
+ */
+export function quoteAmountToQuantity(quoteAmount, strike1e9, underlyingDecimals) {
+    if (!Number.isFinite(quoteAmount) || quoteAmount < 0) {
+        throw new Error("quoteAmount must be a non-negative finite number");
+    }
+    if (!Number.isFinite(strike1e9) || strike1e9 <= 0) {
+        throw new Error("strike1e9 must be a positive finite number");
+    }
+    const atomicFactor = Math.pow(10, underlyingDecimals);
+    return Math.round(quoteAmount * atomicFactor * PRICE_SCALE / strike1e9);
+}
+/**
+ * Convert a wire quantity (underlying atomic units) to a human-readable
+ * quote-denominated amount.
+ *
+ * Formula: `quantity * strike1e9 / PRICE_SCALE / 10^underlyingDecimals`
+ *
+ * @param quantity            Wire quantity (underlying atomic units)
+ * @param strike1e9           Strike price, 1e9-scaled
+ * @param underlyingDecimals  Decimals of the underlying mint
+ * @returns Human-readable quote amount (e.g. 450 for "450 USDC")
+ */
+export function quantityToQuoteAmount(quantity, strike1e9, underlyingDecimals) {
+    if (!Number.isFinite(quantity) || quantity < 0) {
+        throw new Error("quantity must be a non-negative finite number");
+    }
+    if (!Number.isFinite(strike1e9) || strike1e9 <= 0) {
+        throw new Error("strike1e9 must be a positive finite number");
+    }
+    const atomicFactor = Math.pow(10, underlyingDecimals);
+    return quantity * strike1e9 / PRICE_SCALE / atomicFactor;
+}
+/**
+ * Convert a size_rule (underlying atomic units) to human-readable quote terms.
+ *
+ * Example: SOL/USDC CSP, strike $90, rule {min: 1e9, max: 10e9, step: 1e8}
+ * → returns {min: 90, max: 900, step: 9} (USDC)
+ *
+ * @param rule                Size rule from MarketDescriptorInfo
+ * @param strike1e9           Strike price, 1e9-scaled
+ * @param underlyingDecimals  Decimals of the underlying mint
+ */
+export function sizeRuleInQuoteTerms(rule, strike1e9, underlyingDecimals) {
+    if (!Number.isFinite(strike1e9) || strike1e9 <= 0) {
+        throw new Error("strike1e9 must be a positive finite number");
+    }
+    return {
+        min: quantityToQuoteAmount(rule.min_size, strike1e9, underlyingDecimals),
+        max: quantityToQuoteAmount(rule.max_size, strike1e9, underlyingDecimals),
+        step: quantityToQuoteAmount(rule.step, strike1e9, underlyingDecimals),
+    };
+}

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

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

package/dist/ws/sizing.test.js

@@ -0,0 +1,98 @@
+import { quoteAmountToQuantity, quantityToQuoteAmount, sizeRuleInQuoteTerms, } from "./sizing";
+describe("ws sizing helpers", () => {
+    // SOL: 9 decimals, strike $90 = 90_000_000_000 (1e9-scaled)
+    const SOL_DECIMALS = 9;
+    const STRIKE_90 = 90_000_000_000;
+    describe("quoteAmountToQuantity", () => {
+        it("converts 450 USDC at $90 strike to 5 SOL in lamports", () => {
+            expect(quoteAmountToQuantity(450, STRIKE_90, SOL_DECIMALS)).toBe(5_000_000_000);
+        });
+        it("converts 90 USDC (min) to 1 SOL in lamports", () => {
+            expect(quoteAmountToQuantity(90, STRIKE_90, SOL_DECIMALS)).toBe(1_000_000_000);
+        });
+        it("converts 9 USDC (one step) to 0.1 SOL in lamports", () => {
+            expect(quoteAmountToQuantity(9, STRIKE_90, SOL_DECIMALS)).toBe(100_000_000);
+        });
+        it("returns 0 for 0 input", () => {
+            expect(quoteAmountToQuantity(0, STRIKE_90, SOL_DECIMALS)).toBe(0);
+        });
+        it("throws on negative quoteAmount", () => {
+            expect(() => quoteAmountToQuantity(-1, STRIKE_90, SOL_DECIMALS)).toThrow("quoteAmount");
+        });
+        it("throws on zero strike", () => {
+            expect(() => quoteAmountToQuantity(100, 0, SOL_DECIMALS)).toThrow("strike1e9");
+        });
+        it("throws on negative strike", () => {
+            expect(() => quoteAmountToQuantity(100, -1, SOL_DECIMALS)).toThrow("strike1e9");
+        });
+    });
+    describe("quantityToQuoteAmount", () => {
+        it("converts 5 SOL lamports at $90 strike to 450 USDC", () => {
+            expect(quantityToQuoteAmount(5_000_000_000, STRIKE_90, SOL_DECIMALS)).toBeCloseTo(450, 10);
+        });
+        it("converts 1 SOL lamports to 90 USDC", () => {
+            expect(quantityToQuoteAmount(1_000_000_000, STRIKE_90, SOL_DECIMALS)).toBeCloseTo(90, 10);
+        });
+        it("converts 0.1 SOL lamports to 9 USDC", () => {
+            expect(quantityToQuoteAmount(100_000_000, STRIKE_90, SOL_DECIMALS)).toBeCloseTo(9, 10);
+        });
+        it("returns 0 for 0 quantity", () => {
+            expect(quantityToQuoteAmount(0, STRIKE_90, SOL_DECIMALS)).toBe(0);
+        });
+        it("throws on negative quantity", () => {
+            expect(() => quantityToQuoteAmount(-1, STRIKE_90, SOL_DECIMALS)).toThrow("quantity");
+        });
+    });
+    describe("round-trip", () => {
+        it("quoteAmount -> quantity -> quoteAmount is stable", () => {
+            const original = 450;
+            const quantity = quoteAmountToQuantity(original, STRIKE_90, SOL_DECIMALS);
+            const restored = quantityToQuoteAmount(quantity, STRIKE_90, SOL_DECIMALS);
+            expect(restored).toBeCloseTo(original, 6);
+        });
+        it("round-trips at step granularity (9 USDC)", () => {
+            const original = 9;
+            const quantity = quoteAmountToQuantity(original, STRIKE_90, SOL_DECIMALS);
+            const restored = quantityToQuoteAmount(quantity, STRIKE_90, SOL_DECIMALS);
+            expect(restored).toBeCloseTo(original, 6);
+        });
+        it("round-trips with different strike ($150)", () => {
+            const strike150 = 150_000_000_000;
+            const original = 300;
+            const quantity = quoteAmountToQuantity(original, strike150, SOL_DECIMALS);
+            expect(quantity).toBe(2_000_000_000); // 2 SOL
+            const restored = quantityToQuoteAmount(quantity, strike150, SOL_DECIMALS);
+            expect(restored).toBeCloseTo(original, 6);
+        });
+    });
+    describe("sizeRuleInQuoteTerms", () => {
+        const rule = { min_size: 1_000_000_000, max_size: 10_000_000_000, step: 100_000_000 };
+        it("converts SOL size_rule to USDC terms at $90 strike", () => {
+            const result = sizeRuleInQuoteTerms(rule, STRIKE_90, SOL_DECIMALS);
+            expect(result.min).toBeCloseTo(90, 6);
+            expect(result.max).toBeCloseTo(900, 6);
+            expect(result.step).toBeCloseTo(9, 6);
+        });
+        it("converts at $150 strike", () => {
+            const strike150 = 150_000_000_000;
+            const result = sizeRuleInQuoteTerms(rule, strike150, SOL_DECIMALS);
+            expect(result.min).toBeCloseTo(150, 6);
+            expect(result.max).toBeCloseTo(1500, 6);
+            expect(result.step).toBeCloseTo(15, 6);
+        });
+        it("throws on zero strike", () => {
+            expect(() => sizeRuleInQuoteTerms(rule, 0, SOL_DECIMALS)).toThrow("strike1e9");
+        });
+    });
+    describe("non-9-decimal underlying", () => {
+        // ETH: 8 decimals
+        const ETH_DECIMALS = 8;
+        const STRIKE_3000 = 3_000_000_000_000; // $3000
+        it("converts 6000 USDC at $3000 strike to 2 ETH (8 decimals)", () => {
+            expect(quoteAmountToQuantity(6000, STRIKE_3000, ETH_DECIMALS)).toBe(200_000_000);
+        });
+        it("converts 2 ETH back to 6000 USDC", () => {
+            expect(quantityToQuoteAmount(200_000_000, STRIKE_3000, ETH_DECIMALS)).toBeCloseTo(6000, 6);
+        });
+    });
+});

package/dist/ws/types.d.ts

@@ -741,10 +741,11 @@ export type MakerPositionInfo = {
     quantity: WsU64;
     price: WsU64;
     /** Net premium amount from on-chain position state (quote token base units). */
-    total_premium: WsU64;
+    total_premium?: WsU64;
     collateral_locked: WsU64;
     created_at: WsU64;
     expiry_ts: WsU64;
+    is_otm?: boolean;
 };
 export type MyQuotesMessage = {
     request_id: RequestId;
@@ -1013,10 +1014,11 @@ export type PositionInfo = {
     quantity: WsU64;
     price: WsU64;
     /** Net premium amount from on-chain position state (quote token base units). */
-    total_premium: WsU64;
+    total_premium?: WsU64;
     created_at: WsU64;
     /** Market expiry timestamp (unix seconds), sourced from markets table join. */
     expiry_ts: WsU64;
+    is_otm?: boolean;
 };
 export type TradeInfo = {
     id: UuidString;

package/package.json

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