Skip to content
02 / 12

Quickstart

From nothing to a private deal on NEAR testnet in a few minutes. Everything here uses test tokens with no value.

You need
A browser
Sign in with
NEAR wallet or passkey
Costs
Test tokens only

What you need

A browser that supports passkeys, or a NEAR testnet wallet that NEAR Connect lists (HOT, Meteor, Intear and others). Nothing to install. If you use a wallet, keep a little testnet NEAR in it for the gas of your own deposit.

1. Sign in

Open the desk and pick one:

  • Connect a NEAR wallet. Then sign one fixed message (NEP-413). The seed of your private balance is derived from a hash of that signature: the signature never leaves the device, moves no funds, and the same wallet key opens the same balance on any device.
  • Create a passkey. The passkey's PRF output is the seed. It also derives a NEAR implicit account, which the relayer funds with a little testnet NEAR so it can sign its own deposits. No wallet and no seed phrase.

2. Get test tokens

Go to Add privately, pick USDC, wNEAR or BTC, and press Get test under the amount. The faucet gives a fixed amount to each account once an hour. With a passkey the relayer asks the faucet for you, since your new account has no gas yet.

3. Add privately

Enter an amount and press Add privately. Your account sends the tokens to the pool with ft_transfer_call. The pool builds your note from what it actually received, so a deposit can never claim more than it sends. A copy of the note is posted to the board, encrypted to you, so your seed alone recovers it on another device.

4. Ask the desk

Back on the desk, either describe the deal in your own words (for example, “Sell 500 USDC for BTC at the best price”) and let the model draft it, or fill the form:

  • Package: spot, or the experimental spot + hedge and cash and carry. On a hedged package you receive the spot leg, and the maker bonds a hedge order it places for its own account; it needs a bond of at least 1,000 USDC, so it makes sense from about 10,000 USDC. See packages.
  • You sell and you buy: the tokens and the amount you sell, from your private balance.
  • Least you accept: your limit. Only the enclave reads it. Leave it empty to take the best quote.
  • Quote window: how long makers have to answer (20, 45 or 90 seconds).

A drafted request always lands in the form first. Check every number there before you ask: the model only drafts. Then the desk shows each step as it happens: sealed to the enclave, committed on chain, makers quoting, matched, settling, settled.

5. Read the receipt

Deals lists the deals you took part in, with the terms only you can read, and the desk's public receipt for each: settled, recovered, failed or unresolved, with its evidence. Your balance now holds the note the maker made for you.

6. Prove it to one reader

In Prove, choose what to show (an exact payment, a payment of at least an amount, funds held, or desk volume), name the NEAR account that may read it, and how long it is valid. You get a link to /verify that the reader opens. See proofs.

If something goes wrong

  • No quotes. Makers quote only what they can fill from their own private balance. Try a smaller size or another pair.
  • No match. Every quote was below your limit. Your limit never left the enclave, and nothing was settled.
  • A deal that never settles expires, and its receipt says it failed. Neither side's notes were spent.
  • A cash out the token refuses (an account not registered for the token, say) comes back as a refund note in your private balance.

Next