Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vela.monolithsystematic.com/llms.txt

Use this file to discover all available pages before exploring further.

Vela uses your Ethereum wallet as your identity. There are no usernames, passwords, or API keys. Your wallet signs every order you place, and the engine verifies each signature before accepting it.
Vela is currently in public beta. All features are functional, but on-chain settlement is not yet live. See the Trust Model for what is and is not trustless in the current release.

Supported Wallets

Any wallet that supports personal_sign (EIP-191) works with Vela. Tested wallets:
WalletBrowser ExtensionMobileWalletConnect
MetaMaskYesYesYes
Coinbase WalletYesYesYes
RainbowYesYes
RabbyYes
FrameYes
Hardware wallets (Ledger, Trezor) connected through MetaMask also work. Signing may be slower due to device confirmation steps.

Connection Flow

1

Click Connect Wallet

In the top navigation bar of the Vela UI, click the Connect Wallet button in the upper right corner. A wallet selection modal will appear.
2

Select your wallet

Choose your wallet provider from the list. If your wallet is not shown, select WalletConnect to connect via QR code or deep link.
3

Approve the connection

Your wallet extension or app will show a connection request from vela.monolithsystematic.com. Review the permissions and click Connect or Approve.
Vela only requests access to your public address. It cannot initiate transactions without your signature.
4

Sign the challenge nonce

After connecting, the Vela server issues a one-time challenge nonce. Your wallet will prompt you to sign a message that looks like:
Vela Exchange Authentication
Nonce: 7f3a91c2e8d40b56
Timestamp: 2026-04-15T12:00:00Z
This is an off-chain signature — no gas is spent. Click Sign in your wallet.
5

Session established

The server recovers your Ethereum address from the signature and establishes a session. Your address appears in the top navigation bar and your balances load in the sidebar.Your session remains active as long as your browser tab is open. Refreshing the page requires re-signing.

What the Signature Proves

When you sign the challenge nonce, you prove that you control the private key corresponding to your Ethereum address. This is the same mechanism used by Ethereum itself — personal_sign prepends a standard prefix (\x19Ethereum Signed Message:\n) to the message before hashing, preventing replay attacks across different applications. Your private key is never shared. The signature is a one-way proof. Vela can verify your address from the signature, but cannot recover your private key from it.

After Connecting

Once connected, you can:
  • View your balances across all supported assets
  • Deposit funds to start trading (see Deposit Funds)
  • Place orders on any of the 11 live markets
  • View your open orders and trade history
If you want to use the API directly instead of the UI, see API Authentication for how to implement the signing flow programmatically.

Disconnecting

To disconnect your wallet, click your address in the top navigation and select Disconnect. This clears your session on the server side. Your funds remain safe — disconnecting does not affect your balances.