Sandbox / Devnet Guide

Endpoints

ServiceDevnetMainnet
Maker quote WebSocketwss://devnet-api.acta.markets/makerwss://beta-api.acta.markets/maker
Maker data WebSocketwss://devnet-api.acta.markets/maker/datawss://beta-api.acta.markets/maker/data
Taker WebSocketwss://devnet-api.acta.markets/takerwss://beta-api.acta.markets/taker
HTTP APIhttps://devnet-api.acta.marketshttps://beta-api.acta.markets
Solana clusterDevnet (https://api.devnet.solana.com)Mainnet-beta (https://api.mainnet-beta.solana.com)

Both environments use the same message envelope and encodings. See WS common conventions. The getting-started walkthrough below uses Devnet (free test tokens); Mainnet uses real SOL/USDC and live markets — the registration flow and protocol are identical, see Differences from production.

Getting started

1. Generate keypairs

Two Ed25519 keypairs are required:

# Maker owner wallet (on-chain transactions)
solana-keygen new -o maker-owner.json

# Quote signing key (signs order_id values)
solana-keygen new -o quote-signing.json

quote_signing can be the same key as maker_owner, but use a separate key for production-like testing.

2. Request maker registration

Maker registration is admin-gated. Contact the Acta team with:

  • maker_owner pubkey (base58)
  • quote_signing pubkey (base58)

The Acta admin executes the RegisterMaker on-chain instruction, which creates a maker PDA.

3. Get test tokens

You need devnet SOL (for tx fees) and devnet USDC (for premium/collateral).

Devnet SOL:

Get free devnet SOL from the Solana faucet: https://faucet.solana.com/

Select Devnet, paste your wallet address, request an airdrop. Fund both maker_owner and quote_signing wallets if they are separate.

Or via CLI:

solana airdrop 2 --url devnet

Devnet USDC:

Get USDC-Dev tokens from the SPL Token Faucet: https://spl-token-faucet.com/?token-name=USDC-Dev

Connect your wallet, select USDC-Dev, and mint tokens to your address.

These are devnet tokens with no real value.

If you have trouble claiming tokens, contact the Acta team.

4. Deposit premium

Deposit quote token (devnet USDC) into the maker PDA via the MakerDeposit on-chain instruction.

  • The maker_owner wallet signs this transaction.
  • maker_owner needs an associated token account (ATA) for the quote mint, and so does the maker PDA.

The layout is under On-chain maker instructions.

5. Connect

wss://devnet-api.acta.markets/maker
wss://devnet-api.acta.markets/maker/data

Authentication uses the same Ed25519 challenge-response as production.

What's available on devnet

FeatureDetails
MarketsCreated by the Acta team; SOL/USDC pairs are typical. Each market row lists the products it accepts, including spreads and cash puts
Rate limitsSame as production. See Rate limits and admission
CapsTest values; may differ from production
Indicative pricingSupported
Sponsored tx signingSupported
OracleBackend reads its configured Pyth/Hermes feeds; settlement publication writes Acta oracle accounts. Oracle readiness is checked independently of Solana cluster selection
HTTP APIPublic read endpoints available under /api/v1 (/venue, /tokens, /markets, /makers, /vaults, /stats); participant RFQs/orders require an authenticated session

Differences from production

AspectDevnetProduction
Token mintsDevnet test mints (contact team)Mainnet SPL tokens
Oracle feedsBackend-configured feed IDs and oracle mappingBackend-configured feed IDs and oracle mapping
SettlementSame logic, test tokensReal assets
MarketsCreated on requestDynamic
SOLFree via airdropReal SOL required

The devnet program build differs from production in two vault paths: vault swaps go through a mock router instead of Jupiter, and vault Pyth checks allow older and less aligned prices. See Vault operator guide: devnet differences. Everything else differs only externally: mints, oracles, and environment config.

Browsers obtain current reference prices from the selected backend through GetTokenMarketsInfo. They do not need Pyth credentials. Solana devnet selection does not itself choose a different Hermes endpoint or guarantee feed freshness.

Program addresses

AddressValue
Program ID33Ezs5eoa16QyPW8wifnyz2nCyMEcq2crqkVBNjnTE8U (the same on devnet and mainnet)

PDA derivation

PDASeeds
Maker account["maker", maker_owner_pubkey]
Position["position", order_id]

GET /api/v1/venue returns program_id, which is authoritative. PDA derivation follows on-chain program logic. See the Maker API reference and Maker quickstart.

On-chain maker instructions

The instruction data starts with a one-byte discriminant. Integers are little-endian. The full IDL ships in @acta-markets/ts-sdk as ACTA_IDL.

Install @acta-markets/ts-sdk@0.7.0 and import the IDL from the package root:

import { ACTA_IDL } from "@acta-markets/ts-sdk";

The package also contains the JSON file at node_modules/@acta-markets/ts-sdk/dist/idl/acta_contract.json. Raw clients can read that file without using the TypeScript builders.

Builders: buildMakerDepositIx and buildDepositFundsToPositionIx from @acta-markets/ts-sdk/chain, or ChainClient::maker_deposit, ChainClient::fund_position and ChainClient::withdraw_position_funds (chain::build_withdraw_position_funds_ixs, acta-maker-sdk 0.11.1) in the Rust SDK (chain-rpc feature). For a position holder, flows.buildDepositFundsIxs, flows.buildDepositFundsBatchIxs and flows.buildWithdrawFundsIxs from @acta-markets/ts-sdk/chain also create the token accounts and wrap native SOL.

MakerDeposit

Moves quote tokens from the owner's wallet to the maker PDA's custody account. Fills debit this balance.

Data, 9 bytes: discriminant 4, then amount as u64. amount must not be 0.

#AccountWritableSignerRule
0maker_ownernoyesThe registered owner
1maker_pdanono["maker", maker_owner]
2maker_owner_premium_atayesnoSource token account owned by maker_owner
3maker_custody_atayesnoThe maker PDA's ATA for the same mint. It must already exist
4token_programnonoThe mint's token program

DepositFundsToPosition

Funds the settlement leg of an open covered call or cash-secured put; the position becomes funded. Spreads, cash puts and vault-held positions are rejected. The signer is the position holder: the maker owner of a sold position, or the buyer of a bought one. A buyer deposits strictly before expiry_ts; a maker has no deadline while the position is open.

Data, 1 byte: discriminant 9. There are no arguments: the program computes the amount. A covered call takes scaled_quote_amount(strike, quantity) of the quote mint, and a cash-secured put takes quantity of the underlying mint.

#AccountWritableSignerRule
0holdernoyesThe position's holder
1holder_maker_pdanono["maker", holder] for a sold position; not read for a bought one (the SDK passes the System Program)
2position_pdayesno["position", order_id]
3market_pdanonoThe position's market
4holder_funding_atayesnoSource token account owned by holder, for the settlement mint
5pos_settlement_atayesnoThe position PDA's ATA for the settlement mint. It must already exist
6settlement_token_programnonoThe settlement mint's token program

The program emits TakerBuyFunded for a bought position and DepositFundsToPosition for a sold one.

WithdrawFundsFromPosition

Returns the deposit of a funded covered call or cash-secured put to its holder strictly before expiry_ts; the position is open again and can be funded again. Vault-held positions are rejected.

Data, 1 byte: discriminant 81. The accounts are those of DepositFundsToPosition; holder_funding_ata receives the deposit. The program emits PositionUnfunded with holder, market_pda, position_pda, amount and is_taker_buy.

Program events are written to the transaction log, which the runtime cuts at 10 KB. Keep a funding transaction to these instructions and their token-account setup; flows.buildDepositFundsBatchIxs fills each transaction up to its size limit (nine deposits on one market, fewer across markets).

Support

Contact the Acta team for:

  • Devnet access and maker registration
  • Test token mints and faucet
  • Market creation requests
  • Integration support