Docs

Placing an Order

You don't need an account. You don't need to register. You need a Starknet wallet with the tokens you want to swap, and a few seconds.

Before you start

BlindMarkets currently runs on Starknet Sepolia testnet. To place an order you'll need:

  • An Argent X or Braavos wallet connected to Sepolia
  • STRK for gas fees — free from the Starknet faucet
  • The token you want to swap — it must be whitelisted in the AssetRegistry
✦

Getting testnet tokens

The Starknet faucet gives you STRK for gas. For test ERC-20 tokens (WBTC, USDC) on Sepolia, ask in the BlindMarkets Discord or use a Sepolia DEX to swap some STRK.

Step by step

1

Connect your wallet

Click Connect Wallet in the top right. Argent X and Braavos are both supported. Your address will appear in the nav once connected.

Nothing happens on-chain at this point — the connection is read-only until you submit an order.

2

Open the Intent Composer

Go to the Dashboard. The form on the left is where you build your order. Fill in:

  • Sell — the token you're giving up and how much
  • Receive — the token you want and the minimum amount you'll accept
  • Max fee — the most you'll pay the solver, in basis points (50 = 0.5%)
  • Deadline — how many minutes before the order expires if unfilled
  • Privacy — what solvers can see before the batch closes
3

Review and submit

Hit Submit Order. Two things happen in sequence:

  1. Your browser encrypts the order and sends it to the gateway. The gateway stores it but cannot read the amounts until the batch closes.
  2. Your wallet opens a signing prompt. This is the on-chain commitment — a transaction that records a fingerprint of your order on Starknet. Approve it.

Once the wallet transaction confirms, your order is live. It will sit in the current batch window until the window closes (up to 30 seconds).

4

Wait for settlement

You don't need to do anything else. The Dashboard shows your order's status in real time.

5

Verify on-chain

Every settlement is a real Starknet transaction. Go to Voyager and look up your wallet address to see the full history of your commits and settlements.

Order status reference

Pending — Submitted to gateway — wallet transaction not yet sent or confirmed
Committed — Wallet transaction confirmed on Starknet — order locked in
In Auction — Batch is closed — solvers are competing to fill it
Settled — Filled successfully — tokens are in your wallet
Failed — Batch failed — order will be moved to the next window automatically
Expired — Order deadline passed before it was settled — nothing moved
Cancelled — You cancelled the order before settlement started

Can I cancel an order?

Yes, while the order is still in Pending or Committedstatus and hasn't been included in an active auction yet. Go to the Audit Log page, find your order, and hit Cancel. Your wallet will sign a cancellation transaction.

⚠
WarningOnce an auction has started on a batch your order is in, cancellation is no longer possible. The process is already underway on-chain.

What if no solver fills my order?

If the batch your order is in fails — because no solver bid, or the settlement transaction failed — your order is automatically moved to the next batch window. Nothing moves from your wallet until a successful settlement. You can also cancel at that point if you'd rather not wait.

Privacy Modes →