@acta-markets/ts-sdk 0.0.21-beta → 0.0.23-beta

package/dist/chain/instructions.position.d.ts

@@ -57,6 +57,7 @@ export declare function buildSettlePositionIx(input: {
     tokenProgram?: Address<string>;
     underlyingTokenProgram?: Address<string>;
     quoteTokenProgram?: Address<string>;
+    flags?: number;
     rpc?: Rpc;
 }): Promise<Instruction>;
 export declare function buildLiquidatePositionIx(input: {

package/dist/chain/instructions.position.js

@@ -175,6 +175,7 @@ export async function buildSettlePositionIx(input) {
         makerDestAta: toAddress(input.makerDestAta),
         underlyingTokenProgram,
         quoteTokenProgram,
+        flags: input.flags ?? 0,
     }, { programAddress: getActaProgramId() });
 }
 export async function buildLiquidatePositionIx(input) {

package/dist/cjs/chain/instructions.position.js

@@ -182,6 +182,7 @@ async function buildSettlePositionIx(input) {
         makerDestAta: (0, instructions_shared_1.toAddress)(input.makerDestAta),
         underlyingTokenProgram,
         quoteTokenProgram,
+        flags: input.flags ?? 0,
     }, { programAddress: (0, index_1.getActaProgramId)() });
 }
 async function buildLiquidatePositionIx(input) {

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__ORACLE_NOT_EXPIRED_YET = exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 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.ACTA_CONTRACT_ERROR__INVALID_UNWRAP_DESTINATION = exports.ACTA_CONTRACT_ERROR__ORACLE_NOT_EXPIRED_YET = exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 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");
@@ -104,6 +104,8 @@ exports.ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = 0x433; // 1075
 exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 0x434; // 1076
 /** OracleNotExpiredYet: Oracle has not expired yet (cannot update price before expiry) */
 exports.ACTA_CONTRACT_ERROR__ORACLE_NOT_EXPIRED_YET = 0x435; // 1077
+/** InvalidUnwrapDestination: Unwrap SOL destination does not match position taker */
+exports.ACTA_CONTRACT_ERROR__INVALID_UNWRAP_DESTINATION = 0x436; // 1078
 let actaContractErrorMessages;
 if (process.env.NODE_ENV !== "production") {
     actaContractErrorMessages = {
@@ -123,6 +125,7 @@ if (process.env.NODE_ENV !== "production") {
         [exports.ACTA_CONTRACT_ERROR__INVALID_PROGRAM_ID]: `Wrong program ID`,
         [exports.ACTA_CONTRACT_ERROR__INVALID_SIGNATURE_COUNT]: `Ed25519 instruction has wrong signature count`,
         [exports.ACTA_CONTRACT_ERROR__INVALID_TIMESTAMP]: `Clock timestamp invalid`,
+        [exports.ACTA_CONTRACT_ERROR__INVALID_UNWRAP_DESTINATION]: `Unwrap SOL destination does not match position taker`,
         [exports.ACTA_CONTRACT_ERROR__MAKER_ALREADY_REGISTERED]: `Maker PDA already exists`,
         [exports.ACTA_CONTRACT_ERROR__MAKER_NOT_OWNER]: `Caller is not the maker owner`,
         [exports.ACTA_CONTRACT_ERROR__MAKER_NOT_REGISTERED]: `Maker PDA not found`,

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

@@ -22,10 +22,16 @@ function getSettlePositionDiscriminatorBytes() {
     return (0, kit_1.getU8Encoder)().encode(exports.SETTLE_POSITION_DISCRIMINATOR);
 }
 function getSettlePositionInstructionDataEncoder() {
-    return (0, kit_1.transformEncoder)((0, kit_1.getStructEncoder)([["discriminator", (0, kit_1.getU8Encoder)()]]), (value) => ({ ...value, discriminator: exports.SETTLE_POSITION_DISCRIMINATOR }));
+    return (0, kit_1.transformEncoder)((0, kit_1.getStructEncoder)([
+        ["discriminator", (0, kit_1.getU8Encoder)()],
+        ["flags", (0, kit_1.getU8Encoder)()],
+    ]), (value) => ({ ...value, discriminator: exports.SETTLE_POSITION_DISCRIMINATOR }));
 }
 function getSettlePositionInstructionDataDecoder() {
-    return (0, kit_1.getStructDecoder)([["discriminator", (0, kit_1.getU8Decoder)()]]);
+    return (0, kit_1.getStructDecoder)([
+        ["discriminator", (0, kit_1.getU8Decoder)()],
+        ["flags", (0, kit_1.getU8Decoder)()],
+    ]);
 }
 function getSettlePositionInstructionDataCodec() {
     return (0, kit_1.combineCodec)(getSettlePositionInstructionDataEncoder(), getSettlePositionInstructionDataDecoder());
@@ -58,6 +64,8 @@ function getSettlePositionInstruction(input, config) {
         },
     };
     const accounts = originalAccounts;
+    // Original args.
+    const args = { ...input };
     const getAccountMeta = (0, shared_1.getAccountMetaFactory)(programAddress, "programId");
     return Object.freeze({
         accounts: [
@@ -71,7 +79,7 @@ function getSettlePositionInstruction(input, config) {
             getAccountMeta(accounts.underlyingTokenProgram),
             getAccountMeta(accounts.quoteTokenProgram),
         ],
-        data: getSettlePositionInstructionDataEncoder().encode({}),
+        data: getSettlePositionInstructionDataEncoder().encode(args),
         programAddress,
     });
 }

package/dist/cjs/idl/acta_contract.json

@@ -751,7 +751,12 @@
                     ]
                 }
             ],
-            "args": [],
+            "args": [
+                {
+                    "name": "flags",
+                    "type": "u8"
+                }
+            ],
             "discriminant": {
                 "type": "u8",
                 "value": 10
@@ -2317,6 +2322,11 @@
             "code": 1077,
             "name": "OracleNotExpiredYet",
             "msg": "Oracle has not expired yet (cannot update price before expiry)"
+        },
+        {
+            "code": 1078,
+            "name": "InvalidUnwrapDestination",
+            "msg": "Unwrap SOL destination does not match position taker"
         }
     ]
 }

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 = "2ccf0a77f682ff60b8201e2bca7f4bd026500a2fb9637d46dad7a8de3b2ee313";
+exports.ACTA_IDL_SHA256 = "e2fc8ff5fad4cb5691f27082fae3cc004a9116133c6eb64558905dbb946e3b33";

package/dist/cjs/ws/auth.js

@@ -7,6 +7,9 @@
  * - Client signs UTF-8 bytes of that text and responds:
  *   `AuthChallenge { challenge, signature: base58(ed25519(utf8(challenge))), pubkey }`
  *
+ * The same `signMessage` primitive is reused for any UTF-8-bytes signing
+ * (e.g. `acta:redeem:v1:{pubkey}:{code}` for invite redemption).
+ *
  * Source of truth (server):
  * - rust-backend/rfq-server/src/server/ws.rs
  * - rust-backend/rfq-server/src/session/handler.rs
@@ -52,9 +55,9 @@ class KeypairAuthProvider {
     async getPublicKey() {
         return this.address;
     }
-    async signChallenge(challenge) {
-        const challengeBytes = utf8ToBytes(challenge);
-        const signatureBytes = await (0, keys_1.signBytes)(this.privateKey, challengeBytes);
+    async signMessage(message) {
+        const messageBytes = utf8ToBytes(message);
+        const signatureBytes = await (0, keys_1.signBytes)(this.privateKey, messageBytes);
         return bytesToBase58(signatureBytes);
     }
 }
@@ -76,10 +79,10 @@ class WalletAuthProvider {
             throw new Error("Wallet not connected (missing public key)");
         return pk;
     }
-    async signChallenge(challenge) {
-        const challengeBytes = utf8ToBytes(challenge);
+    async signMessage(message) {
+        const messageBytes = utf8ToBytes(message);
         // Some wallet APIs expect a mutable `Uint8Array`; codecs return `ReadonlyUint8Array`.
-        const sig = await this.wallet.signMessage(new Uint8Array(challengeBytes));
+        const sig = await this.wallet.signMessage(new Uint8Array(messageBytes));
         return bytesToBase58(sig);
     }
 }
@@ -89,16 +92,16 @@ exports.WalletAuthProvider = WalletAuthProvider;
  */
 class CustomAuthProvider {
     getPublicKeyFn;
-    signChallengeFn;
-    constructor(getPublicKey, signChallenge) {
+    signMessageFn;
+    constructor(getPublicKey, signMessage) {
         this.getPublicKeyFn = getPublicKey;
-        this.signChallengeFn = signChallenge;
+        this.signMessageFn = signMessage;
     }
     async getPublicKey() {
         return this.getPublicKeyFn();
     }
-    async signChallenge(challenge) {
-        return this.signChallengeFn(challenge);
+    async signMessage(message) {
+        return this.signMessageFn(message);
     }
 }
 exports.CustomAuthProvider = CustomAuthProvider;

package/dist/cjs/ws/client.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActaWsClient = void 0;
 const flows_1 = require("./flows");
 const wirePolicy_1 = require("./wirePolicy");
+const referral_1 = require("./referral");
 function toGenericServerError(err) {
     const message = err instanceof Error ? err.message : String(err);
     return { type: "generic", data: { code: "client_error", message } };
@@ -406,6 +407,51 @@ class ActaWsClient extends TypedEventEmitter {
     logout() {
         this.send({ type: "Logout" });
     }
+    // ========================================================================
+    // Referral / invite
+    // ========================================================================
+    /**
+     * Redeem an invite code. Authentication is proven by the session;
+     * no additional signature is required. Validation runs client-side —
+     * invalid inputs throw `ReferralCodeError` without a round-trip.
+     */
+    redeemInvite(rawCode) {
+        this.ensureAuthenticated();
+        const parsed = (0, referral_1.parseReferralCode)(rawCode);
+        if (!parsed.ok)
+            throw new referral_1.ReferralCodeError(parsed.error);
+        const requestId = this.nextRequestId();
+        this.send({
+            type: "RedeemInvite",
+            data: { request_id: requestId, code: parsed.code },
+        });
+        return requestId;
+    }
+    /**
+     * Claim a vanity referral code (one-shot per taker). Validation
+     * runs client-side — invalid inputs throw `ReferralCodeError`.
+     */
+    async claimReferralCode(rawCode) {
+        this.ensureAuthenticated();
+        const parsed = (0, referral_1.parseReferralCode)(rawCode);
+        if (!parsed.ok)
+            throw new referral_1.ReferralCodeError(parsed.error);
+        const requestId = this.nextRequestId();
+        this.send({
+            type: "ClaimReferralCode",
+            data: { request_id: requestId, code: parsed.code },
+        });
+        return requestId;
+    }
+    getMyReferralInfo() {
+        this.ensureAuthenticated();
+        const requestId = this.nextRequestId();
+        this.send({
+            type: "GetMyReferralInfo",
+            data: { request_id: requestId },
+        });
+        return requestId;
+    }
     getOrderStatus(orderIdHex) {
         this.ensureAuthenticated();
         const requestId = this.nextRequestId();
@@ -450,6 +496,40 @@ class ActaWsClient extends TypedEventEmitter {
         });
         this.submitQuote(quote);
     }
+    /**
+     * Replace an in-flight quote on the same RFQ. Server treats this as
+     * cancel-old + place-new atomically; maker signs the NEW `order_id`.
+     */
+    submitReplaceQuote(msg) {
+        this.ensureAuthenticated();
+        this.send({ type: "ReplaceQuote", data: msg });
+    }
+    /** Convenience: compute new `order_id`, sign it, and send `ReplaceQuote`. */
+    async submitReplaceQuoteSigned(args) {
+        (0, wirePolicy_1.assertWsU64Safe)(args.strike, "strike");
+        (0, wirePolicy_1.assertWsU64Safe)(args.price, "price");
+        (0, wirePolicy_1.assertWsU64Safe)(args.validUntil, "validUntil");
+        (0, wirePolicy_1.assertWsU64Safe)(args.nonce, "nonce");
+        const msg = await (0, flows_1.buildSignedReplaceQuoteMessage)({
+            oldOrderId: args.oldOrderId,
+            rfqId: args.rfqId,
+            strike: args.strike,
+            price: args.price,
+            validUntil: args.validUntil,
+            nonce: args.nonce,
+            orderId: args.orderId,
+            makerSigner: args.makerSigner,
+        });
+        this.submitReplaceQuote(msg);
+    }
+    /**
+     * Send multiple signed quotes in one WS frame. Each entry must already be
+     * a fully-built `QuoteMessage` (use `buildSignedQuoteMessage` per quote).
+     */
+    submitBatchQuotes(quotes) {
+        this.ensureAuthenticated();
+        this.send({ type: "BatchQuotes", data: { quotes } });
+    }
     cancelQuote(rfqId) {
         this.ensureAuthenticated();
         const requestId = this.nextRequestId();
@@ -543,6 +623,13 @@ class ActaWsClient extends TypedEventEmitter {
         this.send({ type: "RemoveChannels", data: { request_id, channels } });
         return request_id;
     }
+    /** Query the server's view of this session's subscriptions. Response: `subscriptions` event. */
+    getSubscriptions() {
+        this.ensureAuthenticated();
+        const request_id = this.nextRequestId();
+        this.send({ type: "GetSubscriptions", data: { request_id } });
+        return request_id;
+    }
     ping() {
         if (this.ws?.readyState === WS_OPEN) {
             this.send({ type: "Ping" });
@@ -877,6 +964,18 @@ class ActaWsClient extends TypedEventEmitter {
                     this.emit("subscriptionUpdated", d);
                 }
                 break;
+            case "RequireInvite":
+                this.emit("requireInvite");
+                break;
+            case "InviteRedeemed":
+                this.emit("inviteRedeemed", message.data);
+                break;
+            case "ReferralCodeClaimed":
+                this.emit("referralCodeClaimed", message.data);
+                break;
+            case "MyReferralInfo":
+                this.emit("myReferralInfo", message.data);
+                break;
         }
     }
     /** Taker-only: request current indicative prices for a market + position_type. */
@@ -902,7 +1001,7 @@ class ActaWsClient extends TypedEventEmitter {
         try {
             const [pubkey, signature] = await Promise.all([
                 this.authProvider.getPublicKey(),
-                this.authProvider.signChallenge(challenge),
+                this.authProvider.signMessage(challenge),
             ]);
             this.send({
                 type: "AuthChallenge",

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

@@ -53,7 +53,7 @@ function parseClientMessage(payload) {
 function makeAuthProvider(pubkey = "pubkey", signature = "signature") {
     return {
         getPublicKey: jest.fn().mockResolvedValue(pubkey),
-        signChallenge: jest.fn().mockResolvedValue(signature),
+        signMessage: jest.fn().mockResolvedValue(signature),
     };
 }
 function makeHarness(overrides = {}) {

package/dist/cjs/ws/flows.js

@@ -6,6 +6,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildSignedQuoteMessage = buildSignedQuoteMessage;
+exports.buildSignedReplaceQuoteMessage = buildSignedReplaceQuoteMessage;
 exports.buildSignedQuoteFromRfq = buildSignedQuoteFromRfq;
 exports.buildAcceptQuoteMessage = buildAcceptQuoteMessage;
 const orders_1 = require("../chain/orders");
@@ -29,6 +30,25 @@ async function buildSignedQuoteMessage(args) {
         signature: signatureBase58,
     };
 }
+async function buildSignedReplaceQuoteMessage(args) {
+    (0, wirePolicy_1.assertWsU64Safe)(args.strike, "strike");
+    (0, wirePolicy_1.assertWsU64Safe)(args.price, "price");
+    (0, wirePolicy_1.assertWsU64Safe)(args.validUntil, "validUntil");
+    (0, wirePolicy_1.assertWsU64Safe)(args.nonce, "nonce");
+    (0, orderId_1.assertOrderId32)(args.oldOrderId);
+    (0, orderId_1.assertOrderId32)(args.orderId);
+    const { signatureBase58 } = await (0, orders_1.signOrderIdBase58)(args.makerSigner, args.orderId);
+    return {
+        old_order_id: (0, orderId_1.orderIdToHex)(args.oldOrderId),
+        rfq_id: args.rfqId,
+        strike: args.strike,
+        price: args.price,
+        valid_until: args.validUntil,
+        nonce: args.nonce,
+        order_id: (0, orderId_1.orderIdToHex)(args.orderId),
+        signature: signatureBase58,
+    };
+}
 function positionTypeToU8(positionType) {
     switch (positionType) {
         case "covered_call":

package/dist/cjs/ws/index.js

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

package/dist/cjs/ws/referral.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Referral / invite redemption helpers.
+ *
+ * Mirrors the server-side validation defined in
+ * rust-backend/acta-types/src/invite.rs (ReferralCode::parse).
+ * Client-side validation must stay bit-identical to the server on
+ * the same input. A hardcoded fixture table is kept here and on the
+ * rust side; if either drifts, the cross-impl test will catch it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferralCodeError = exports.REFERRAL_CODE_MAX_LEN = exports.REFERRAL_CODE_MIN_LEN = void 0;
+exports.normalizeReferralCode = normalizeReferralCode;
+exports.parseReferralCode = parseReferralCode;
+exports.REFERRAL_CODE_MIN_LEN = 4;
+exports.REFERRAL_CODE_MAX_LEN = 16;
+class ReferralCodeError extends Error {
+    detail;
+    constructor(detail) {
+        super(detail.kind === "length"
+            ? `code length must be between ${detail.min} and ${detail.max}`
+            : "code must contain only ASCII letters and digits");
+        this.detail = detail;
+        this.name = "ReferralCodeError";
+    }
+}
+exports.ReferralCodeError = ReferralCodeError;
+/**
+ * Trim + ASCII uppercase. No length or charset check. Useful for
+ * showing a live preview as the user types.
+ */
+function normalizeReferralCode(input) {
+    return input.trim().toUpperCase();
+}
+/**
+ * Parse + validate + normalize a user-supplied referral code.
+ * Mirrors `ReferralCode::parse` on the server. A successful result
+ * carries the canonical branded `ReferralCode`.
+ */
+function parseReferralCode(input) {
+    const normalized = normalizeReferralCode(input);
+    if (normalized.length < exports.REFERRAL_CODE_MIN_LEN ||
+        normalized.length > exports.REFERRAL_CODE_MAX_LEN) {
+        return {
+            ok: false,
+            error: {
+                kind: "length",
+                min: exports.REFERRAL_CODE_MIN_LEN,
+                max: exports.REFERRAL_CODE_MAX_LEN,
+            },
+        };
+    }
+    if (!/^[A-Z0-9]+$/.test(normalized)) {
+        return { ok: false, error: { kind: "charset" } };
+    }
+    return { ok: true, code: normalized };
+}

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

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const referral_1 = require("./referral");
+// =============================================================================
+// Cross-impl fixture.
+//
+// Bit-for-bit identical to the fixture in
+//   rust-backend/acta-types/src/invite.rs::tests
+// If either side changes, update both.
+// =============================================================================
+const ACCEPT_FIXTURES = [
+    ["NIKITA", "NIKITA"],
+    ["nikita", "NIKITA"],
+    ["  abc1 ", "ABC1"],
+    ["ABCD", "ABCD"],
+    ["1234567890ABCDEF", "1234567890ABCDEF"],
+];
+describe("parseReferralCode", () => {
+    test.each(ACCEPT_FIXTURES)("accepts %j → %j", (input, expected) => {
+        const res = (0, referral_1.parseReferralCode)(input);
+        expect(res.ok).toBe(true);
+        if (res.ok)
+            expect(res.code).toBe(expected);
+    });
+    test("rejects too short", () => {
+        const res = (0, referral_1.parseReferralCode)("abc");
+        expect(res.ok).toBe(false);
+        if (!res.ok)
+            expect(res.error.kind).toBe("length");
+    });
+    test("rejects too long", () => {
+        const res = (0, referral_1.parseReferralCode)("A".repeat(17));
+        expect(res.ok).toBe(false);
+        if (!res.ok)
+            expect(res.error.kind).toBe("length");
+    });
+    test("rejects non-ascii", () => {
+        const res = (0, referral_1.parseReferralCode)("абвгд");
+        expect(res.ok).toBe(false);
+        // Cyrillic passes length but fails charset.
+        if (!res.ok)
+            expect(res.error.kind).toBe("charset");
+    });
+    test("rejects punctuation", () => {
+        const res = (0, referral_1.parseReferralCode)("ABC-12");
+        expect(res.ok).toBe(false);
+        if (!res.ok)
+            expect(res.error.kind).toBe("charset");
+    });
+});
+describe("normalizeReferralCode", () => {
+    test("trims and uppercases", () => {
+        expect((0, referral_1.normalizeReferralCode)("  nikita ")).toBe("NIKITA");
+    });
+});

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

@@ -98,7 +98,9 @@ export declare const ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = 1075;
 export declare const ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 1076;
 /** OracleNotExpiredYet: Oracle has not expired yet (cannot update price before expiry) */
 export declare const ACTA_CONTRACT_ERROR__ORACLE_NOT_EXPIRED_YET = 1077;
-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_EXPIRED | 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_NOT_EXPIRED_YET | 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;
+/** InvalidUnwrapDestination: Unwrap SOL destination does not match position taker */
+export declare const ACTA_CONTRACT_ERROR__INVALID_UNWRAP_DESTINATION = 1078;
+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__INVALID_UNWRAP_DESTINATION | 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_EXPIRED | 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_NOT_EXPIRED_YET | 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

@@ -99,6 +99,8 @@ export const ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = 0x433; // 1075
 export const ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 0x434; // 1076
 /** OracleNotExpiredYet: Oracle has not expired yet (cannot update price before expiry) */
 export const ACTA_CONTRACT_ERROR__ORACLE_NOT_EXPIRED_YET = 0x435; // 1077
+/** InvalidUnwrapDestination: Unwrap SOL destination does not match position taker */
+export const ACTA_CONTRACT_ERROR__INVALID_UNWRAP_DESTINATION = 0x436; // 1078
 let actaContractErrorMessages;
 if (process.env.NODE_ENV !== "production") {
     actaContractErrorMessages = {
@@ -118,6 +120,7 @@ if (process.env.NODE_ENV !== "production") {
         [ACTA_CONTRACT_ERROR__INVALID_PROGRAM_ID]: `Wrong program ID`,
         [ACTA_CONTRACT_ERROR__INVALID_SIGNATURE_COUNT]: `Ed25519 instruction has wrong signature count`,
         [ACTA_CONTRACT_ERROR__INVALID_TIMESTAMP]: `Clock timestamp invalid`,
+        [ACTA_CONTRACT_ERROR__INVALID_UNWRAP_DESTINATION]: `Unwrap SOL destination does not match position taker`,
         [ACTA_CONTRACT_ERROR__MAKER_ALREADY_REGISTERED]: `Maker PDA already exists`,
         [ACTA_CONTRACT_ERROR__MAKER_NOT_OWNER]: `Caller is not the maker owner`,
         [ACTA_CONTRACT_ERROR__MAKER_NOT_REGISTERED]: `Maker PDA not found`,

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

@@ -23,8 +23,11 @@ export type SettlePositionInstruction<TProgram extends string = typeof ACTA_CONT
 ]>;
 export type SettlePositionInstructionData = {
     discriminator: number;
+    flags: number;
+};
+export type SettlePositionInstructionDataArgs = {
+    flags: number;
 };
-export type SettlePositionInstructionDataArgs = {};
 export declare function getSettlePositionInstructionDataEncoder(): FixedSizeEncoder<SettlePositionInstructionDataArgs>;
 export declare function getSettlePositionInstructionDataDecoder(): FixedSizeDecoder<SettlePositionInstructionData>;
 export declare function getSettlePositionInstructionDataCodec(): FixedSizeCodec<SettlePositionInstructionDataArgs, SettlePositionInstructionData>;
@@ -47,6 +50,7 @@ export type SettlePositionInput<TAccountSettler extends string = string, TAccoun
     underlyingTokenProgram: Address<TAccountUnderlyingTokenProgram>;
     /** Token program for quote mint */
     quoteTokenProgram: Address<TAccountQuoteTokenProgram>;
+    flags: SettlePositionInstructionDataArgs["flags"];
 };
 export declare function getSettlePositionInstruction<TAccountSettler extends string, TAccountPositionPda extends string, TAccountMarketPda extends string, TAccountPosCollateralAta extends string, TAccountPosSettlementAta extends string, TAccountUserDestAta extends string, TAccountMakerDestAta extends string, TAccountUnderlyingTokenProgram extends string, TAccountQuoteTokenProgram extends string, TProgramAddress extends Address = typeof ACTA_CONTRACT_PROGRAM_ADDRESS>(input: SettlePositionInput<TAccountSettler, TAccountPositionPda, TAccountMarketPda, TAccountPosCollateralAta, TAccountPosSettlementAta, TAccountUserDestAta, TAccountMakerDestAta, TAccountUnderlyingTokenProgram, TAccountQuoteTokenProgram>, config?: {
     programAddress?: TProgramAddress;

package/dist/generated/instructions/settlePosition.js

@@ -13,10 +13,16 @@ export function getSettlePositionDiscriminatorBytes() {
     return getU8Encoder().encode(SETTLE_POSITION_DISCRIMINATOR);
 }
 export function getSettlePositionInstructionDataEncoder() {
-    return transformEncoder(getStructEncoder([["discriminator", getU8Encoder()]]), (value) => ({ ...value, discriminator: SETTLE_POSITION_DISCRIMINATOR }));
+    return transformEncoder(getStructEncoder([
+        ["discriminator", getU8Encoder()],
+        ["flags", getU8Encoder()],
+    ]), (value) => ({ ...value, discriminator: SETTLE_POSITION_DISCRIMINATOR }));
 }
 export function getSettlePositionInstructionDataDecoder() {
-    return getStructDecoder([["discriminator", getU8Decoder()]]);
+    return getStructDecoder([
+        ["discriminator", getU8Decoder()],
+        ["flags", getU8Decoder()],
+    ]);
 }
 export function getSettlePositionInstructionDataCodec() {
     return combineCodec(getSettlePositionInstructionDataEncoder(), getSettlePositionInstructionDataDecoder());
@@ -49,6 +55,8 @@ export function getSettlePositionInstruction(input, config) {
         },
     };
     const accounts = originalAccounts;
+    // Original args.
+    const args = { ...input };
     const getAccountMeta = getAccountMetaFactory(programAddress, "programId");
     return Object.freeze({
         accounts: [
@@ -62,7 +70,7 @@ export function getSettlePositionInstruction(input, config) {
             getAccountMeta(accounts.underlyingTokenProgram),
             getAccountMeta(accounts.quoteTokenProgram),
         ],
-        data: getSettlePositionInstructionDataEncoder().encode({}),
+        data: getSettlePositionInstructionDataEncoder().encode(args),
         programAddress,
     });
 }

package/dist/idl/acta_contract.json

@@ -751,7 +751,12 @@
                     ]
                 }
             ],
-            "args": [],
+            "args": [
+                {
+                    "name": "flags",
+                    "type": "u8"
+                }
+            ],
             "discriminant": {
                 "type": "u8",
                 "value": 10
@@ -2317,6 +2322,11 @@
             "code": 1077,
             "name": "OracleNotExpiredYet",
             "msg": "Oracle has not expired yet (cannot update price before expiry)"
+        },
+        {
+            "code": 1078,
+            "name": "InvalidUnwrapDestination",
+            "msg": "Unwrap SOL destination does not match position taker"
         }
     ]
 }

package/dist/idl/hash.d.ts

@@ -1 +1 @@
-export declare const ACTA_IDL_SHA256 = "2ccf0a77f682ff60b8201e2bca7f4bd026500a2fb9637d46dad7a8de3b2ee313";
+export declare const ACTA_IDL_SHA256 = "e2fc8ff5fad4cb5691f27082fae3cc004a9116133c6eb64558905dbb946e3b33";

package/dist/idl/hash.js

@@ -1 +1 @@
-export const ACTA_IDL_SHA256 = "2ccf0a77f682ff60b8201e2bca7f4bd026500a2fb9637d46dad7a8de3b2ee313";
+export const ACTA_IDL_SHA256 = "e2fc8ff5fad4cb5691f27082fae3cc004a9116133c6eb64558905dbb946e3b33";