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

package/README.md

@@ -8,7 +8,7 @@ Generated by Codama.
 
 ## Package
 
-Published package: **`@acta-markets/ts-sdk@0.0.6-beta`** (ESM-first, CJS fallback)
+Published package: `@acta-markets/ts-sdk@0.0.6-beta` (ESM-first, CJS fallback)
 
 ```bash
 yarn add @acta-markets/ts-sdk@0.0.6-beta
@@ -49,7 +49,7 @@ const c2 = new ActaClient({ chain: { rpc, rpcSubscriptions, payer } });
 
 ## Web app quickstart (taker-only)
 
-### 1) Connect to WS anonymously, then authenticate on “Connect wallet”
+### 1) Connect to WS anonymously, then authenticate on "Connect wallet"
 
 ```ts
 import { ActaClient } from "@acta-markets/ts-sdk";
@@ -64,7 +64,7 @@ const auth = new WalletAuthProvider({
 // No wallet prompt:
 client.ws!.connectAnonymous();
 
-// Later, on “Connect wallet” button:
+// Later, on "Connect wallet" button:
 await client.ws!.authenticate(auth);
 client.ws!.on("snapshot", (s) => console.log("snapshot", s));
 client.ws!.on("chainEvent", (e) => console.log("chain event", e));
@@ -72,11 +72,11 @@ client.ws!.on("chainEvent", (e) => console.log("chain event", e));
 
 #### Auth providers (why there are multiple)
 
-- **`WalletAuthProvider`**: browser wallets (Phantom/Privy/etc.) that support `signMessage` (typical web integration).
-- **`KeypairAuthProvider`**: Node scripts/CI/bots where you load a local keypair (e.g. from `KEYPAIR_PATH`).
-- **`CustomAuthProvider`**: advanced integrations (remote signers, hardware wallets, nonstandard wallet APIs).
-- **`AuthProvider` (type)**: shared interface the WS client accepts.
-- **`WalletLike` (type)**: minimal wallet adapter shape (no dependency on wallet-adapter / web3.js types).
+- `WalletAuthProvider`: browser wallets (Phantom/Privy/etc.) that support `signMessage`.
+- `KeypairAuthProvider`: Node scripts/CI/bots where you load a local keypair (e.g. from `KEYPAIR_PATH`).
+- `CustomAuthProvider`: advanced integrations (remote signers, hardware wallets, nonstandard wallet APIs).
+- `AuthProvider` (type): shared interface the WS client accepts.
+- `WalletLike` (type): minimal wallet adapter shape (no dependency on wallet-adapter / web3.js types).
 
 ### Markets + positions without on-chain RPC (WS convenience)
 
@@ -152,7 +152,7 @@ client.ws!.on("message", (m) => {
   if (m.type !== "Error") return;
   switch (m.data.code) {
     case "rfq_expired":
-      // show “quotes expired” and offer a “Retry RFQ” button
+      // show "quotes expired" and offer a "Retry RFQ" button
       break;
     case "quote_expired":
     case "quote_refresh_required":
@@ -164,7 +164,7 @@ client.ws!.on("message", (m) => {
 
 ### APR/APY (annualized premium yield) from quotes
 
-Frontends often want to display a simple “premium yield” as an annualized percentage.
+Frontends often want to display a simple "premium yield" as an annualized percentage.
 Given:
 
 - `price` = gross premium per 1 underlying (1e9 scale)
@@ -188,7 +188,7 @@ import { ws } from "@acta-markets/ts-sdk";
 
 const secondsToExpiry = rfq.market.expiry_ts - Math.floor(Date.now() / 1000);
 
-// Example: if you already render quantity as “10 SOL”, pass underlyingAmount=10.
+// Example: if you already render quantity as "10 SOL", pass underlyingAmount=10.
 const { apr, apy, premiumNotional } = ws.computeApyFromScaledPrices({
   positionType: "cash_secured_put",
   underlyingAmount: 10,
@@ -199,7 +199,7 @@ const { apr, apy, premiumNotional } = ws.computeApyFromScaledPrices({
 ```
 
 Note:
-- This is a **display metric** (premium / collateral annualized), not a promise of “guaranteed yield”.
+- This is a display metric (premium / collateral annualized), not a promise of "guaranteed yield".
 - For covered calls you also need `spotPrice1e9` (from your own spot feed) to value collateral in quote units.
 
 ### Chain flow helpers
@@ -305,9 +305,9 @@ const openIx = await buildOpenPositionIx({
 
 ## OrderId rules (SDK-wide)
 
-- **Canonical**: `orderId` is always **32 bytes** (`sha256(preimage182)`), same as the on-chain program expects.
-- **In code**: use `Uint8Array(32)` everywhere.
-- **JSON / WS wire**: when `order_id` must be a string, it is **64-char hex** (32 bytes). SDK flow helpers handle encoding/decoding for you.
+- Canonical: `orderId` is always 32 bytes (`sha256(preimage182)`), same as the on-chain program expects.
+- In code: use `Uint8Array(32)` everywhere.
+- JSON / WS wire: when `order_id` must be a string, it is 64-char hex (32 bytes). SDK flow helpers handle encoding/decoding for you.
 
 ## WS order status events
 

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__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__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");
@@ -100,6 +100,8 @@ exports.ACTA_CONTRACT_ERROR__ORACLE_SOURCE_LOCKED = 0x431; // 1073
 exports.ACTA_CONTRACT_ERROR__ORACLE_HAS_ACTIVE_MARKETS = 0x432; // 1074
 /** DuplicateAccount: Duplicate account passed to instruction */
 exports.ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = 0x433; // 1075
+/** MarketNotExpired: Market has not expired yet */
+exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 0x434; // 1076
 let actaContractErrorMessages;
 if (process.env.NODE_ENV !== "production") {
     actaContractErrorMessages = {
@@ -125,6 +127,7 @@ if (process.env.NODE_ENV !== "production") {
         [exports.ACTA_CONTRACT_ERROR__MARKET_EXPIRED]: `Market expired`,
         [exports.ACTA_CONTRACT_ERROR__MARKET_FINALIZED]: `Market already finalized`,
         [exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EMPTY]: `Market has open positions (cannot close)`,
+        [exports.ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED]: `Market has not expired yet`,
         [exports.ACTA_CONTRACT_ERROR__MARKET_NOT_FINALIZED]: `Market not yet finalized`,
         [exports.ACTA_CONTRACT_ERROR__MATH_OVERFLOW]: `Arithmetic overflow`,
         [exports.ACTA_CONTRACT_ERROR__MINT_MISMATCH]: `Mint mismatch between token accounts`,

package/dist/cjs/idl/acta_contract.json

@@ -2363,6 +2363,11 @@
             "code": 1075,
             "name": "DuplicateAccount",
             "msg": "Duplicate account passed to instruction"
+        },
+        {
+            "code": 1076,
+            "name": "MarketNotExpired",
+            "msg": "Market has not expired yet"
         }
     ]
 }

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

package/dist/cjs/ws/client.js

@@ -319,6 +319,14 @@ class ActaWsClient extends TypedEventEmitter {
         });
         return requestId;
     }
+    getEarnSummary() {
+        const requestId = this.nextRequestId();
+        this.send({
+            type: "GetEarnSummary",
+            data: { request_id: requestId },
+        });
+        return requestId;
+    }
     logout() {
         this.send({ type: "Logout" });
     }
@@ -558,6 +566,9 @@ class ActaWsClient extends TypedEventEmitter {
             case "StatsUpdate":
                 this.handleStatsUpdate(message.data.stats);
                 break;
+            case "EarnSummary":
+                this.emit("earnSummary", message.data);
+                break;
             case "RfqBroadcast":
                 // Keep local RFQ state reasonably fresh even without a new snapshot.
                 if (!this.state.activeRfqs.has(message.data.rfq_id)) {
@@ -801,17 +812,6 @@ class ActaWsClient extends TypedEventEmitter {
         this.emit("error", new Error(`Authentication failed: ${details}`));
     }
     handleSnapshot(snapshot) {
-        this.state.stats = snapshot.stats;
-        this.state.activeRfqs.clear();
-        for (const rfq of snapshot.active_rfqs) {
-            this.state.activeRfqs.set(rfq.rfq_id, rfq);
-        }
-        this.state.myActiveRfqs.clear();
-        this.state.positions.clear();
-        for (const position of snapshot.positions ?? []) {
-            this.state.positions.set(position.pda, position);
-        }
-        this.state.recentTrades = snapshot.recent_trades ?? [];
         this.state.markets.clear();
         for (const market of snapshot.markets) {
             this.state.markets.set(market.pda, market);

package/dist/cjs/ws/types.js

@@ -1,14 +1,2 @@
 "use strict";
-/**
- * WebSocket protocol types for Acta RFQ server.
- *
- * Source of truth:
- * - docs/state-machines-eng.md (protocol spec)
- * - rust-backend/shared/src/types/ws.rs (as-built reference)
- *
- * Notes:
- * - UUIDs are represented as strings in JSON.
- * - Rust uses u64 in many places; we model them as `number` for now.
- *   If/when we need precision beyond JS safe integer, we can migrate to `bigint | string`.
- */
 Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -94,7 +94,9 @@ 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__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;
+/** MarketNotExpired: Market has not expired yet */
+export declare const ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 1076;
+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_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

@@ -95,6 +95,8 @@ export const ACTA_CONTRACT_ERROR__ORACLE_SOURCE_LOCKED = 0x431; // 1073
 export const ACTA_CONTRACT_ERROR__ORACLE_HAS_ACTIVE_MARKETS = 0x432; // 1074
 /** DuplicateAccount: Duplicate account passed to instruction */
 export const ACTA_CONTRACT_ERROR__DUPLICATE_ACCOUNT = 0x433; // 1075
+/** MarketNotExpired: Market has not expired yet */
+export const ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED = 0x434; // 1076
 let actaContractErrorMessages;
 if (process.env.NODE_ENV !== "production") {
     actaContractErrorMessages = {
@@ -120,6 +122,7 @@ if (process.env.NODE_ENV !== "production") {
         [ACTA_CONTRACT_ERROR__MARKET_EXPIRED]: `Market expired`,
         [ACTA_CONTRACT_ERROR__MARKET_FINALIZED]: `Market already finalized`,
         [ACTA_CONTRACT_ERROR__MARKET_NOT_EMPTY]: `Market has open positions (cannot close)`,
+        [ACTA_CONTRACT_ERROR__MARKET_NOT_EXPIRED]: `Market has not expired yet`,
         [ACTA_CONTRACT_ERROR__MARKET_NOT_FINALIZED]: `Market not yet finalized`,
         [ACTA_CONTRACT_ERROR__MATH_OVERFLOW]: `Arithmetic overflow`,
         [ACTA_CONTRACT_ERROR__MINT_MISMATCH]: `Mint mismatch between token accounts`,

package/dist/idl/acta_contract.json

@@ -2363,6 +2363,11 @@
             "code": 1075,
             "name": "DuplicateAccount",
             "msg": "Duplicate account passed to instruction"
+        },
+        {
+            "code": 1076,
+            "name": "MarketNotExpired",
+            "msg": "Market has not expired yet"
         }
     ]
 }

package/dist/idl/hash.d.ts

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

package/dist/idl/hash.js

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

package/dist/ws/client.d.ts

@@ -2,7 +2,7 @@
 import type { AuthProvider } from "./auth";
 import type { SignerLike } from "../chain/orders";
 import type { Address } from "@solana/addresses";
-import type { ActiveRfqInfo, ChainEventMessage, GlobalStats, MarketDescriptorInfo, MarketInfo, MyActiveRfqInfo, MyActiveRfqsMessage, OrderStatusMessage, PositionInfo, QuoteAcknowledgedMessage, QuoteBestStatusMessage, QuoteCancelledMessage, QuoteMessage, QuoteRefreshRequestedMessage, QuoteOutbidMessage, QuoteReceivedMessage, QuoteSelectedMessage, QuotesUpdateMessage, RfqBroadcastMessage, RfqClosedMessage, RfqCreatedMessage, RfqSkippedMessage, RfqRequestMessage, RfqAvailableAgainMessage, QuoteExpiredMessage, QuoteFilledMessage, IndicativePricesMessage, IndicativePricesRequestMessage, IndicativePricesResponseMessage, GetIndicativePricesMessage, RequestId, ServerMessage, SnapshotMessage, StatsDelta, SubscriptionsMessage, TokenInfo, TradeInfo, UuidString, VersionMismatchMessage, WelcomeMessage, WsChannel } from "./types";
+import type { ActiveRfqInfo, ChainEventMessage, EarnSummaryData, GlobalStats, MarketDescriptorInfo, MarketInfo, MyActiveRfqInfo, MyActiveRfqsMessage, OrderStatusMessage, PositionInfo, QuoteAcknowledgedMessage, QuoteBestStatusMessage, QuoteCancelledMessage, QuoteMessage, QuoteRefreshRequestedMessage, QuoteOutbidMessage, QuoteReceivedMessage, QuoteSelectedMessage, QuotesUpdateMessage, RfqBroadcastMessage, RfqClosedMessage, RfqCreatedMessage, RfqSkippedMessage, RfqRequestMessage, RfqAvailableAgainMessage, QuoteExpiredMessage, QuoteFilledMessage, IndicativePricesMessage, IndicativePricesRequestMessage, IndicativePricesResponseMessage, GetIndicativePricesMessage, RequestId, ServerMessage, SnapshotMessage, StatsDelta, SubscriptionsMessage, TokenInfo, TradeInfo, UuidString, VersionMismatchMessage, WelcomeMessage, WsChannel } from "./types";
 export type ConnectionState = "disconnected" | "connecting" | "authenticating" | "authenticated" | "error";
 export type ClientRole = "taker" | "maker";
 export type PendingMessagesOverflowPolicy = "drop_oldest" | "drop_newest" | "throw";
@@ -73,6 +73,7 @@ export type ActaWsClientEvents = {
         quotesByUnderlying: Record<string, TokenInfo[]>;
     }) => void;
     statsUpdate: (stats: GlobalStats) => void;
+    earnSummary: (data: EarnSummaryData) => void;
     subscriptions: (msg: SubscriptionsMessage) => void;
     activeRfqs: (rfqs: ActiveRfqInfo[]) => void;
     rfqBroadcast: (rfq: RfqBroadcastMessage) => void;
@@ -217,6 +218,7 @@ export declare class ActaWsClient extends TypedEventEmitter<ActaWsClientEvents>
     getTokenCaps(args?: {
         include_markets?: boolean;
     }): RequestId;
+    getEarnSummary(): RequestId;
     logout(): void;
     getOrderStatus(orderIdHex: string): RequestId;
     cancelRfq(rfqId: string): RequestId;

package/dist/ws/client.js

@@ -316,6 +316,14 @@ export class ActaWsClient extends TypedEventEmitter {
         });
         return requestId;
     }
+    getEarnSummary() {
+        const requestId = this.nextRequestId();
+        this.send({
+            type: "GetEarnSummary",
+            data: { request_id: requestId },
+        });
+        return requestId;
+    }
     logout() {
         this.send({ type: "Logout" });
     }
@@ -555,6 +563,9 @@ export class ActaWsClient extends TypedEventEmitter {
             case "StatsUpdate":
                 this.handleStatsUpdate(message.data.stats);
                 break;
+            case "EarnSummary":
+                this.emit("earnSummary", message.data);
+                break;
             case "RfqBroadcast":
                 // Keep local RFQ state reasonably fresh even without a new snapshot.
                 if (!this.state.activeRfqs.has(message.data.rfq_id)) {
@@ -798,17 +809,6 @@ export class ActaWsClient extends TypedEventEmitter {
         this.emit("error", new Error(`Authentication failed: ${details}`));
     }
     handleSnapshot(snapshot) {
-        this.state.stats = snapshot.stats;
-        this.state.activeRfqs.clear();
-        for (const rfq of snapshot.active_rfqs) {
-            this.state.activeRfqs.set(rfq.rfq_id, rfq);
-        }
-        this.state.myActiveRfqs.clear();
-        this.state.positions.clear();
-        for (const position of snapshot.positions ?? []) {
-            this.state.positions.set(position.pda, position);
-        }
-        this.state.recentTrades = snapshot.recent_trades ?? [];
         this.state.markets.clear();
         for (const market of snapshot.markets) {
             this.state.markets.set(market.pda, market);

package/dist/ws/types.d.ts

@@ -1,15 +1,3 @@
-/**
- * WebSocket protocol types for Acta RFQ server.
- *
- * Source of truth:
- * - docs/state-machines-eng.md (protocol spec)
- * - rust-backend/shared/src/types/ws.rs (as-built reference)
- *
- * Notes:
- * - UUIDs are represented as strings in JSON.
- * - Rust uses u64 in many places; we model them as `number` for now.
- *   If/when we need precision beyond JS safe integer, we can migrate to `bigint | string`.
- */
 import type { Address } from "@solana/addresses";
 export type UuidString = string;
 export type RequestId = string;
@@ -163,6 +151,9 @@ export type ClientMessage = {
 } | {
     type: "GetMyCaps";
     data: GetMyCapsMessage;
+} | {
+    type: "GetEarnSummary";
+    data: GetEarnSummaryMessage;
 } | {
     type: "GetSubscriptions";
     data: GetSubscriptionsMessage;
@@ -466,6 +457,9 @@ export type ServerMessage = {
 } | {
     type: "StatsUpdate";
     data: StatsUpdateMessage;
+} | {
+    type: "EarnSummary";
+    data: EarnSummaryData;
 } | {
     type: "RfqSkipped";
     data: RfqSkippedMessage;
@@ -741,7 +735,7 @@ 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;
@@ -949,10 +943,6 @@ export type TokensMessage = {
     quotes_by_underlying: Record<Address<string>, TokenInfo[]>;
 };
 export type SnapshotMessage = {
-    stats: GlobalStats;
-    active_rfqs: ActiveRfqInfo[];
-    positions?: PositionInfo[];
-    recent_trades?: TradeInfo[];
     markets: MarketInfo[];
 };
 export type MyActiveRfqsMessage = {
@@ -1014,7 +1004,7 @@ 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;
@@ -1052,6 +1042,28 @@ export type PositionUpdateType = string;
 export type StatsUpdateMessage = {
     stats: GlobalStats;
 };
+export type GetEarnSummaryMessage = {
+    request_id: RequestId;
+};
+export type EarnAssetSummary = {
+    underlying_mint: string;
+    underlying_symbol: string;
+    quote_mint: string;
+    quote_symbol: string;
+    position_type: PositionType;
+    min_apr: number | null;
+    max_apr: number | null;
+    cap_filled_pct: number;
+    cap_total: WsU64;
+    cap_used: WsU64;
+    strikes_count: number;
+    nearest_expiry_ts: number;
+};
+export type EarnSummaryData = {
+    request_id: RequestId;
+    assets: EarnAssetSummary[];
+    computed_at: number;
+};
 export type StatsDelta = {
     volume_added?: WsU64 | null;
     trades_added?: WsU32 | null;

package/dist/ws/types.js

@@ -1,13 +1 @@
-/**
- * WebSocket protocol types for Acta RFQ server.
- *
- * Source of truth:
- * - docs/state-machines-eng.md (protocol spec)
- * - rust-backend/shared/src/types/ws.rs (as-built reference)
- *
- * Notes:
- * - UUIDs are represented as strings in JSON.
- * - Rust uses u64 in many places; we model them as `number` for now.
- *   If/when we need precision beyond JS safe integer, we can migrate to `bigint | string`.
- */
 export {};

package/package.json

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