Protocol changelog
Next (not deployed)
Program instruction WithdrawFundsFromPosition (discriminant 81) and @acta-markets/ts-sdk
0.8.1–0.8.2. Additive: no wire change.
- The holder of a
fundedcovered call or cash-secured put (maker of a sold position, buyer of a bought one) takes the deposit back strictly beforeexpiry_ts; the position isopenagain. New eventPositionUnfunded(kind 83). Layout. flows.buildWithdrawFundsIxsandflows.buildDepositFundsBatchIxs(several deposits of one holder per transaction) in@acta-markets/ts-sdk/chain.
acta-maker-sdk 0.11.0 and @acta-markets/ts-sdk 0.8.0. Breaking: one number
encoding on WS and HTTP. The protocol string stays 1.0.0, so an older
client passes Hello and then fails on the first amount.
- WS token amounts that were JSON numbers are decimal strings:
price,net_price,your_price, strikes intermsandorder_options,quantity,settlement_price, payoffs and received atoms,total_premium,size_rule,strike_tick,reference_price, caps and cap errors, balances, stats volumes, andnonce. Client messages send them as strings too. - HTTP fields that were decimal strings but are not amounts are numbers: vault times, slots,
counts, generations and
capital_fallback_delay_seconds; position, exposure, cycle and depositor times;cycle_number.
acta-maker-sdk 0.10.0 and @acta-markets/ts-sdk 0.7.0. Breaking: address and time fields are renamed after what they hold. The protocol string stays
1.0.0, so an older client passes Hello and then fails on the renamed fields. The program and
the order ID preimage are unchanged; signatures stay valid.
| Was | Now | Where |
|---|---|---|
market (address or filter) | market_pda | RfqRequest, PositionInfo, TradeInfo, ActiveRfqInfo, MyActiveRfqInfo, MakerQuoteInfo, indicative prices, GetPositions, GetMakerPositions, GetMyTrades, CancelAllQuotes, PositionOpened, MarketCreated, MarketFinalized |
market (descriptor object) | market_descriptor | RfqBroadcast, IndicativePricesRequest, MarketDescriptorInfo |
market_id | market_pda | RfqSkipped, CheckQuote, MarketCapInfo, cap error market_oi_cap_exceeded |
maker (owner wallet) | maker_owner | QuoteReceived, QuotesUpdate, AcceptQuote, RfqClosed.winner |
maker (maker PDA) | maker_pda | TradeInfo, PositionOpened |
owner | maker_owner | MakerRegistered |
owner | maker_owner | HTTP /makers |
taker | taker_owner | TradeInfo, MakerTradeInfo, RfqBroadcast, ActiveRfqInfo, QuoteFilled, QuoteSelected, PositionOpened |
tx_signature | transaction_signature | TradeInfo, MakerTradeInfo, QuoteFilled, OrderSubmitted |
vault | vault_pda | HTTP vault positions, depositors and depositor events |
counterparty | counterparty_owner | HTTP vault positions |
active_expiry | active_expiry_ts | HTTP vault |
position | position_pda | PositionSettled, PositionLiquidated, HTTP vault positions and exposure |
underlying, quote | underlying_mint, quote_mint | MarketInfo (WS and GET /markets) |
old_order_id | replaced_order_id | ReplaceQuote |
sent_at_unix_ms | sent_at_ms | RfqBroadcast |
server_time_unix_ms | server_now_at_ms | Welcome, Pong |
signature_deadline | signature_deadline_at | QuoteSelected, SponsoredTxToSign |
expiry | expiry_ts | HTTP vault cycles and exposure |
event_time | occurred_at | HTTP depositor events and vault cycles |
from_time, to_time | window_start_at, window_end_at | HTTP vault performance windows |
spot_time, price_time | spot_published_at, price_published_at | HTTP vault exposure, vault |
deposit_window_set_ts, last_hwm_reset_ts, last_hwm_update_ts, last_settlement_ts | *_at | HTTP vault |
capital_fallback_delay_secs | capital_fallback_delay_seconds | HTTP vault |
query underlying, quote, expiry | underlying_mint, quote_mint, expiry_ts | GET /markets; the old names return 400 instead of an unfiltered list |
RfqAlreadyLockedisreconcile: another of your orders holds the RFQ, andMyActiveRfqsshows it inlock.RfqNotFoundandRfqNotActivearerefresh. All three werestop.TokenInfo.protocol_feesisquote { … },not_quote_tokenorunavailable(wasnonefor both).unavailableis not a zero fee.TokenMarketsInfo.session:continuous,open { closes_at },closed { opens_at },closed_indefinitely(no session in two weeks) orunknown(no schedule published or loaded), from the underlying's price-feed schedule.- A settled physical position's
settlementsays what each side received:holderandwriter, each{ collateral_atoms, settlement_atoms }. Out of the money the holder gets its settlement deposit back only if it made one. SwapQuoteResult.valid_untilis a number of Unix seconds, like every othervalid_until.- HTTP vault routes no longer use
nullfor absent facts; each group is a tagged union:balances(observedorunobserved),deposit_window,staging(noneorstaged),tvl_usd(pricedorunpriced),stats(not_indexed,behindorcurrentwith itsgeneration),metadata(noneorset); derived amounts are{ "type": "available", "atoms" }orunavailable, windowed metricsavailableorinsufficient_history. Positions carryfunded_amount,close(openorclosed { closed_at, is_otm }) andtransaction; exposure rowsdecimals,spot,moneyness,intrinsic; cyclescapital_generationandstate(running,priced,finished); depositorsdeposit_request,withdraw_request(noneorpending),totals(noneorrecorded) andboundary_price.productis tagged bytype, notkind.nullremains only innext_cursorand the operator's free-text metadata. QuoteLocked { rfq_locked },QuoteNotFoundandUnknownOrderarerefresh(werestop): they are races with state that moved on.Welcome.rate_limitsno longer hasquotes: quote messages need maker or Vault authentication, after which the sharedliquidity_providerbucket is the only limit.TokenInfo.session(was the raw schedule) is now whether the feed trades now, the same union asTokenMarketsInfo.session:continuous,open { closes_at },closed { opens_at },closed_indefinitelyorunknown. The schedule moved toTokenInfo.schedule:unknown,continuousorpyth { spec }(waspyth_schedule { schedule }). The token list is rebuilt at each session change.
2026-11-11: 0.9.1 and 0.6.1
Additive; no client changes required.
GET /api/v1/venueaddsmax_batch_quotes, the most quotes oneBatchQuotesmessage may carry.acta-maker-sdk0.9.1 and@acta-markets/ts-sdk0.6.1 read it.- Vault deposit and withdraw request pages accept
limitup to 200, like every other list (was 100). - Docs: sell indicative requests reach only
rfqssubscribers, indicatives go stale 60 seconds after the last answered round, the writer bears the protocol fee on a taker buy, and address fields lists which name each message uses for market, maker and position addresses.
2026-11-11
acta-maker-sdk 0.9.0 and @acta-markets/ts-sdk 0.6.0. Breaking: absent facts are tagged unions
instead of null. The protocol string stays 1.0.0, so older clients pass Hello and then fail on
the changed messages. The program is unchanged.
AuthSuccess.role:{ type: "taker" }or{ type: "maker", maker_pda }(was nullablemaker_pda).- Indicatives:
freshnessisno_data,fresh { updated_at }orstale { updated_at }(wasupdated_at: 0andis_stale); each strike hasprice: { type: "none" } | { type: "quoted", price }(was nullablebest_price). ActiveRfqInfo.best_price,MyActiveRfqInfo.best_price,QuoteBestStatus.current_best_priceandQuoteOutbid.current_best_priceareQuotedPrice;MyActiveRfqInfo.lockisunlockedorlocked { order_id }(waslocked_order_id).RfqClosed.winnerisnoneorwinner { maker, price, transaction }withtransactionpendingorsent { signature };your_quoteisnoneorquoted { order_id, status, price }.QuoteAcknowledged.replacedisnoneorreplaced { order_id }(wasreplaced_order_id).MarketInfo.settlementispendingorfixed { price }(was nullablesettlement_price);GlobalStats.usdisunavailableoravailable { … }.MakerTradeInfo.positionispendingorconfirmed { position_pda }.SwapQuoteResult.stagingis"none","stage"or"unstage";RequestError.deliverygainsnot_applicableinstead ofnull.- Always set now:
RfqCreated.request_id(equalsrfq_id),QuoteFilled.expiry_ts,QuoteReceived.net_price(equalspricewithout a fee configuration). PositionInfocarriesunderlying_symbolandquote_symbol;MakerPositionInfois gone, maker reads returnPositionInfo.nullremains only fornext_cursoron the last page.
2026-11-10
acta-maker-sdk 0.8.3 and 0.8.4, @acta-markets/ts-sdk 0.5.3 to 0.5.5. The program is unchanged and every change is additive.
Welcome.rate_limitsadvertises the connection's message budgets:connection,wallet,rfqs,quotes,queries(eachunlimitedorbucketwithper_secondandburst) andliquidity_provider(sharedornot_applicable). See Rate limits and admission. The TS client paces its messages by them.- Every error has an action:
retry,reauthenticate,refresh,reconcile,fix_requestorstop, listed in the error catalogs. Rust:ServerError::action; TS:errorActionandActaWsRequestError.action. - TS:
createRfqOnceandsubmitOrderOnceresend a lost reply only when it is safe and reconcile otherwise;previewFillprices a fill locally;grossFromIndicative1e9turns a sell indicative into the gross pricepreviewFilltakes. See Agents and automation. - A repeated
RfqRequestwith an open RFQ's id is rejected withduplicate_rfq_id; the docs used to say it returned the RFQ.
2026-11-09 (later)
acta-maker-sdk 0.8.2 and @acta-markets/ts-sdk 0.5.2. The program is unchanged. One breaking change: /venue no longer carries protocol fees, so venue() in 0.8.1 and 0.5.1 fails; everything else is additive.
TokenInfo.session(/tokens, WSTokens):continuous, orpyth_schedulewith the Pyth trading-hours string of the token's feed, so a maker no longer configures TSLA or XAU hours by hand./venuereportsmax_page_size(200). The Rust SDK exportspaging::MAX_PAGE_SIZE.- Protocol fees moved from
/venueto each quote token:TokenInfo.protocol_fees(quotewithpremium_bpsandvolume_bps, ornone). Quote tokens can have different fees;/venueused to answer503when they did. - The indicative response window is 5 seconds (it was 800 ms). The indicative rules document timing, replacement, partial answers, units, fees and rate limits.
- Rust SDK:
build_maker_withdraw_native_sol_ixsunwraps exactly the withdrawn amount; other wSOL stays wrapped. - TS SDK: a
PositionUpdatedpush keeps the token symbols of a maker row in the client cache. - Taker-facing prices (
net_price, indicatives,MyActiveRfqs.best_price, earn APR) apply the protocol fee as the program does: the smaller of the premium fee and the volume fee on the strike or spread width. Spreads and cash puts now carrynet_price; before, it wasnullfor them and the volume cap was ignored.
2026-11-09
acta-maker-sdk 0.8.1 and @acta-markets/ts-sdk 0.5.1. The wire changes below are breaking; the protocol version string stays 1.0.0, so an older client passes Hello and then fails on the changed messages. acta-maker-sdk 0.8.0 and @acta-markets/ts-sdk 0.5.0 sent 1.1.0 and are refused at Hello; use 0.8.1 and 0.5.1. The program is unchanged.
- Indicatives are per taker side.
IndicativePricesRequest,IndicativePricesResponse,GetIndicativePrices,IndicativePricesand eachTokenMarketIndicativescarry a requiredside. Makers echo the request'sside. Buy requests reach onlytaker_buy_rfqssubscribers.best_priceis the median of maker prices: net of the protocol fee forsell, the gross price paid forbuy. PositionInfoinPositionsandPositionUpdatedcarries a requiredunderlying_price:{ type: "available", price, published_at }or{ type: "unavailable" }, the trusted oracle price the server prices RFQs with.MakerPositionInfo(MakerPositions,MmSummary) carries it too and isPositionInfoplus token symbols.RfqLocked { rfq_id, rfq_version, locked_at }tells every other maker on an RFQ that the taker accepted a quote. Their quotes stay as backups untilRfqAvailableAgainorRfqClosed.RfqClosed.reasongainsserver_shutdown: a graceful stop closes every RFQ whose order has not reached the keeper and cancels its quotes.- On a buy,
QuoteReceived.net_price,QuotesUpdatequotes andMyActiveRfqs.best_priceare the gross price the buyer pays; they were shown net of the fee. The TS client keeps the lowest quote as a buy RFQ's best price. - Query failures are
RequestErrorwith the request'srequest_id:GetIndicativePrices,GetTokenMarketsInfo,GetPositions,GetMyActiveRfqs,GetMakerPositions,GetMyTrades,GetMyCaps,CheckQuoteand maker market reads sent an uncorrelatedErrorfor some failures.GetTokenMarketsInfofor an underlying without active markets returnsmarket_not_foundinstead of no response. - Quoting races (
RfqNotActive,QuoteLockedand the like) are logged at debug, not error;ServerError::is_quote_racetells them apart. - Native SOL custody helpers:
chain::build_maker_deposit_native_sol_ixsandchain::build_maker_withdraw_native_sol_ixs. io_observercounts HTTP, WebSocket and RPC traffic. HTTP and RPC reuse connections and accept compressed responses.
2026-11-05
SDKs @acta-markets/ts-sdk 0.4.3 and acta-maker-sdk 0.7.3; the program is unchanged.
- A wallet can fund a physical option it bought from a vault (
flagsvault writer + taker buy). The SDK deposit builders refused any vault flag before; only a vault holder is refused, as on chain. Without the deposit such a buy settled asnot_exercised. - A funded buy from a vault can settle with a SOL unwrap to the wallet holder. The ts-sdk refused it before; the contract SDK adds
flows::build_settle_position_with_sol_unwrap, which places the owner after the vault accounts as the program reads it. - The RFQ close reason
ladder_timeoutis removed. The server never sent it; both SDKs now reject it like any unknown reason.
2026-11-04
Program upgrade; SDKs @acta-markets/ts-sdk 0.4.2 and acta-maker-sdk 0.7.2.
- Vaults write what wallets buy. A vault session receives
buyRFQs on thevaultschannel when its delegate holds the new permissionSIGN_WRITER_QUOTES(64), and quotes an ask. The buyer signsOpenPositionForVaultWriter(41) orOpenSpreadForVaultWriter(78) with holder byte1(data length 75 or 83); the vault's delegate signs only the order id. A holder byte0is the existing sale to a maker. No price floor applies. - A vault receives RFQs for any expiry while Idle and only its cycle expiry while Active, on both sides. A buy the vault's last observed collateral leg cannot cover is not sent.
- Names follow position roles; opcodes and bytes are unchanged:
OpenPositionForVaultHolder(42),OpenSpreadForVaultHolder(79),FundPositionForVaultHolder(43); delegate bitsOPEN_AS_WRITER(1),SIGN_HOLDER_QUOTES(2),FUND_HOLDER(4). - Program events are version 2.
PositionOpened(kind 11) is emitted once per open on every path, with writer, holder,flags(bit 0 vault writer, 1 vault holder, 2 taker buy), terms, gross and net premium and collateral;VaultCycleOpened(kind 48) once per vault side. They replaceOpenPosition,OpenSpread,OpenTakerBuy,OpenTakerBuySpread,VaultPositionOpenedandVaultSpreadOpened.SettleSpreadis kind 79,VaultSpreadClosed80,TakerBuyFunded81,TakerBuyNotExercised82. The SDKs do not decode version 1 events. - Program error
NotPositionHolder(1111): a deposit signer that is not the position holder.
2026-11-02
- Every list request takes required
limit(at most 200) and a taggedcursor(start, orafterwithid). Every list response has a required nullablenext_cursor. This replaces timestamp cursors,has_more, nested quote-scope paging and dual MM cursors. A larger limit is rejected withinvalid_limit, a bad cursor withinvalid_cursor. GetPositionSummaryreturns premium totals per quote mint across all products. It is cached for 5 seconds per wallet.- REST lists take optional
limit(default 50, at most 200, 100 for vault requests) and optional opaquecursor. Omit it for the first page. - Configuration-sized pushes are capped at 1000 items.
- RFQ admission: new RFQs are rejected before fan-out with
server_overloaded,insufficient_collateralortemporarily_unavailable. - The version stays 1.0.0, so a client built for the previous shapes passes Hello and fails on the changed requests.
2026-10-30
QuoteRefreshRequested.reasonandQuoteExpired.reasonare the closedQuoteExpiryReason(expired|expiring_soon).RfqSkippeddrops its stringreason;cap_detailis required and names the failing cap.total_premiumon position rows isBalance: net premium in quote atoms after the protocol fee.- Market rows list only the pair's products for the market's side; a market with none is not listed.
- SDK wire types drop
#[non_exhaustive].
2026-10-29
-
Required pair product policies are stored in PostgreSQL and edited through audited admin commands; catalog rows carry products and admission rejects disallowed products.
-
Adds cash_put {strike: K}, executed as the existing put-spread tag 3 with K1=0/K2=K, including user/vault opens and cash settlement. SOL/USDC enables all five products; call spreads still require a positive lower strike.
-
Every position row carries the last applied event revision {slot, transaction_index, instruction_index}; complete lifecycle updates merge only when newer. Migration 064 backfills canonical coordinates and aborts with unresolved PDAs; verified rows require complete coordinates.
-
/api/v1/venueadds required on-chainprotocol_fee_bps_premiumandprotocol_fee_bps_volume, refreshed with the config projection. -
PositionInfo and MakerPositionInfo flatten one required
state(open,funded,liquidated, orsettledwith physical/cash settlement), plus decimals and revision. Orphan rows are excluded in SQL. PositionUpdated coalesces full rows by PDA/revision for maker and taker sessions, independently of caps; caps_snapshot is removed. -
WS protocol
1.0.0removes feature negotiation. Hello requireson_disconnect,client_nameandclient_version; Subscribe requires nonemptyproductsand both mint lists. Spreads are base protocol, QuoteExpired is unconditional, and the raw Hello version is checked before strict decoding, so any other version receivesunsupported_protocol_versionand close 4006 promptly. -
The wire is closed: every field is always serialized; absent facts are explicit null; state-dependent shapes are tagged unions (
TokenInfo.role, liabilitypolicy,QuoteCheck.verdict,EarnAssetSummary.apr, venue limits, vault capacity). Queries useQueryFilter/TimeBound, typed status lists, requiredlimit(invalid_limitoutside range) andPageCursor;GetMyQuotes.scopeis tagged. Unknown types, codes and enum values are rejected by both SDKs. Never-populatedstats_delta/statsare removed. -
Wire addresses use validated base58
Address32(TypeScriptAddress); invalid addresses reject at decoding. Vault authentication records a typed actor identity. -
RFQ and quote commands carry required
OptionTermsthrough Core. Checked commands returnCoreError; failures do not mutate state, and the runtime maps errors to wire responses. -
Public products and chain tags are distinct; cash_put converts only through canonical terms conversion. Redis RFQ/quote cache v2 requires complete OptionTerms without legacy defaults. Subscribe decodes a validated ProductSet, and pair policy checks share the registry authority.
-
/maker/datais the read-only data plane: up to four concurrent sessions per maker owner, independent of its quote session.
2026-10-28
- Renamed capability
spreads_v2tospreads(order bytes unchanged). - All position opens use keeper-sponsored v0 transactions with address lookup tables (ALT).