# Darknyx

- [Overview](https://docs.darknyx.trade/documentation/get-started/overview.md): Darknyx is a privacy-preserving spot darkpool on Solana, with hidden orders matched inside an attested confidential VM and value movement proven on-chain.
- [Design thesis](https://docs.darknyx.trade/documentation/get-started/design-thesis.md): The product thesis behind Darknyx, the guarantees each layer provides, and the tradeoffs a technical evaluator should understand.
- [Programmatic access](https://docs.darknyx.trade/documentation/get-started/programmatic-access.md): The Darknyx API surface at a glance: the two-layer auth model, the REST and WebSocket endpoints, and a quick start.
- [Trade flow](https://docs.darknyx.trade/documentation/how-it-works/trade-flow.md): The end-to-end lifecycle of a Darknyx order, from deposit through hidden matching to on-chain settlement.
- [Settlement](https://docs.darknyx.trade/documentation/how-it-works/settlement.md): How private matches become final on Solana, what the proof guarantees, and how Darknyx handles partial or ambiguous outcomes.
- [Fee structure](https://docs.darknyx.trade/documentation/how-it-works/fee-structure.md): How trading fees work on Darknyx, a basis-point protocol fee both sides pay, collected as notes at settlement and pre-funded by each order's collateral.
- [Multi market](https://docs.darknyx.trade/documentation/how-it-works/multi-market.md): How one attested Darknyx venue serves several independently governed spot markets through one endpoint, session, and trust check.
- [Privacy and attestation](https://docs.darknyx.trade/documentation/how-it-works/privacy-and-attestation.md): What Darknyx hides, what remains public, and how clients verify the confidential matcher and its complete on-chain signer set.
- [Shielded pool](https://docs.darknyx.trade/documentation/how-it-works/shielded-pool.md): How balances are held as shielded notes, accumulated in Merkle-tree shards and protected from replay by path-specific on-chain records.
- [Tee architecture](https://docs.darknyx.trade/documentation/how-it-works/tee-architecture.md): Why Darknyx matches inside an attested Intel TDX confidential VM, how that identity reaches Solana, and where the trust boundary remains.
- [Order types](https://docs.darknyx.trade/documentation/trading-concepts/order-types.md): The order types Darknyx supports (limit, IOC, and FOK) plus the market and all-or-none conventions built on top of them.
- [Order compatibility](https://docs.darknyx.trade/documentation/trading-concepts/order-compatibility.md): Which combinations of order type, time in force, execution attribute, and price field are valid.
- [Execution attributes](https://docs.darknyx.trade/documentation/trading-concepts/execution-attributes.md): Constrain how an order fills (all-or-none and minimum fill size) independent of its type and time in force.
- [Clearing price](https://docs.darknyx.trade/documentation/trading-concepts/clearing-price.md): How the attested matcher selects one price for a batch and how the settlement proof constrains the resulting arithmetic.
- [Time in force](https://docs.darknyx.trade/documentation/trading-concepts/time-in-force.md): How long an order stays working (GTC, GTT, IOC, and FOK), expressed through the order type and a slot-based expiry.
- [Self trade prevention](https://docs.darknyx.trade/documentation/trading-concepts/self-trade-prevention.md): How Darknyx prevents accidental self-matches using note-bound owner identity plus trading-key equality.
- [Account model](https://docs.darknyx.trade/documentation/account/account-model.md): How balances work on Darknyx, as UTXO-style notes you own on-chain, reconstructed client-side from Merkle proofs and your own keys.
- [Deposit](https://docs.darknyx.trade/documentation/account/deposit.md): Move SPL tokens into the vault through a proof-gated deposit that hides the shielded note owner and remains recoverable from seed plus chain.
- [Withdraw](https://docs.darknyx.trade/documentation/account/withdraw.md): Move value out of the pool back to an SPL token account, proven in zero knowledge so the chain releases your tokens.
- [Typescript client](https://docs.darknyx.trade/documentation/sdk/typescript-client.md): A worked TypeScript client that authenticates, reads markets, builds and submits an order with the SDK's order builders, and streams order and fill events.
- [Glossary](https://docs.darknyx.trade/documentation/reference/glossary.md): Terms and acronyms used across the Darknyx documentation.
- [Authentication](https://docs.darknyx.trade/api-reference/getting-started/authentication.md): The two-layer Darknyx auth model, account bearer tokens plus per-order trading-key signatures, and how to obtain and use them.
- [Base urls](https://docs.darknyx.trade/api-reference/getting-started/base-urls.md): Where the Darknyx API lives, the common request and response conventions, and the health and time endpoints.
- [Error codes](https://docs.darknyx.trade/api-reference/getting-started/error-codes.md): How Darknyx signals failure, covering the HTTP status codes, the conditions that produce them, and how to handle them.
- [Transport and attestation](https://docs.darknyx.trade/api-reference/getting-started/transport-and-attestation.md): How HTTPS reaches the confidential VM and how a client verifies the quote-bound image and complete on-chain signer set.
- [Health](https://docs.darknyx.trade/api-reference/system/health.md): Process liveness and uptime. Public and unauthenticated.
- [Info](https://docs.darknyx.trade/api-reference/system/info.md): Application and instance metadata, including the enclave signer set.
- [System Status](https://docs.darknyx.trade/api-reference/system/system-status.md): How Darknyx signals readiness and degraded mode, so you can check it before trading and back off when subsystems are down.
- [Time](https://docs.darknyx.trade/api-reference/system/time.md): Server time: the current Solana slot and unix milliseconds. Public.
- [Get Open Orders](https://docs.darknyx.trade/api-reference/account/get-account.md): The caller's currently open orders.
- [Read Settings](https://docs.darknyx.trade/api-reference/account/get-settings.md): Read the caller's account settings.
- [Update Settings](https://docs.darknyx.trade/api-reference/account/update-settings.md): Replace the caller's account settings.
- [List Instruments](https://docs.darknyx.trade/api-reference/instruments/list-instruments.md): Every tradable instrument on this venue, with its tick size, minimum order size and price scale.
- [Get Instrument](https://docs.darknyx.trade/api-reference/instruments/get-instrument.md): Full detail for a single instrument, including mints, tick size, minimum size and current readiness.
- [Place Order](https://docs.darknyx.trade/api-reference/orders/place-order.md): Submit a hidden, fully-collateralized order, covering the request body, the cryptographic fields the SDK builds for you, and the response lifecycle.
- [Get Order](https://docs.darknyx.trade/api-reference/orders/get-order.md): Read the current live status and filled quantity of an order owned by the authenticated account.
- [Modify Order](https://docs.darknyx.trade/api-reference/orders/modify-order.md): Replace a resting order atomically with an in-place cancel-and-replace, leaving no window where you hold neither order.
- [Cancel Order](https://docs.darknyx.trade/api-reference/orders/cancel-order.md): Cancel a resting order with a signed cancel request from the owning trading key.
- [Settlement Status](https://docs.darknyx.trade/api-reference/settlement/settlement-status.md): Inspect the per-match jobs and Solana signatures associated with a TEE-local settlement batch handle.
- [Transparency](https://docs.darknyx.trade/api-reference/settlement/transparency.md): A public, unauthenticated proof-of-reserves covering per-mint outstanding liabilities versus vault balances, plus the engine's attested identity.
- [Tree Root](https://docs.darknyx.trade/api-reference/tree/root.md): The current Merkle root and leaf count of the on-chain note commitment tree.
- [Leaves](https://docs.darknyx.trade/api-reference/tree/leaves.md): Page through tree leaves to rebuild a local mirror from cold.
- [Inclusion Proof](https://docs.darknyx.trade/api-reference/tree/inclusion.md): A Merkle inclusion proof for one note commitment, for spending or withdrawing.
- [Session stream](https://docs.darknyx.trade/api-reference/websocket/session-stream.md): The sole authenticated WebSocket, with in-band login, order operations, and dynamic channel subscriptions.
- [Ws trading](https://docs.darknyx.trade/api-reference/websocket/ws-trading.md): Submit framed place, cancel, and modify requests on the multiplexed session stream.
- [Orders channel](https://docs.darknyx.trade/api-reference/websocket/orders-channel.md): A per-account stream of settlement reservations, confirmed fills, terminal failures, cancellations, and expiries.
- [Fills channel](https://docs.darknyx.trade/api-reference/websocket/fills-channel.md): A per-account stream of consumed-input-bound memos for verifying and storing change notes.

## OpenAPI Specs

- [darknyx-public](/api-reference/openapi/darknyx-public.yaml)