Docs

Quickstart

From sign-in to your first settled round.

Before you start

  • An email address, or a wallet such as MetaMask, Trust Wallet, Binance Wallet or OKX Wallet.
  • Some bStocks or USDT on BNB Chain. You can finish setup without them and add assets later.
  • A little BNB for gas, until gas sponsorship goes live.

Your first round

  1. 01

    Sign in

    Open sama and continue with email (you get an embedded wallet) or connect your own wallet. Sama never sees your keys.

  2. 02

    Check your portfolio

    Sama reads your balances straight from BNB Chain and lists every asset it supports.

  3. 03

    Set a target

    Pick a preset or type a percentage per token. The total must be exactly 100%. Sama previews what it would take to get there before you save.

  4. 04

    Join a Circle

    Pick a Circle that trades the assets you hold, or start your own and invite people.

  5. 05

    Sign into the round

    One free signature adds your rebalance to the open round. Nothing moves yet.

  6. 06

    Approve your match

    When the round closes, Sama shows exactly what you send and receive. Approve the plan and allow those exact amounts.

  7. 07

    Settle and decide the rest

    Anyone in the round can submit the settlement. Afterwards, choose what happens to anything that didn't match, then open your receipt.

What your wallet will ask

Sama tells you before each prompt how many times your wallet will open and what each one does.

StepKindCost
Join a roundEIP-712 signature (intent)Free
Approve the planEIP-712 signature (plan approval)Free
Allow tokensapprove for the exact amountGas
Settlesettle() transaction, one participant sends itGas
Swap leftoversPancakeSwap swap from your own walletGas + pool fee

Next

  1. 1Read how targets turn into what you sign.
  2. 2Learn the round lifecycle and what each state means.