Skip to main content

Quickstart — Sepolia smoke in 25 minutes

Prerequisites

ItemNotes
Browser walletMetaMask or Rabby with Ethereum Sepolia network
Sepolia ETHFor gas on public motions
Test USDC (or supported asset)Sepolia faucet or team testnet fund
Tenebrae clienttenebrae.xyz

Time: ~25 minutes including proof generation on first deposit.


Step 1 — Connect wallet

  1. Open tenebrae.xyz.
  2. Connect your wallet (bring-your-own-wallet — Tenebrae does not custody keys).
  3. Confirm the client shows Ethereum Sepolia as the active host chain.

If the network is wrong, switch in your wallet before continuing.


Step 2 — Deposit (public → private)

  1. Open Deposit in the client.
  2. Select asset and amount.
  3. Review the disclosure: deposit amount is visible on-chain.
  4. Sign the transaction in your wallet.
  5. Wait for proof generation and Gateway submission to confirm.

Expected: Private balance appears after indexer and wallet-receipt sync catches up (may take seconds to minutes on testnet).

Detail: deposit into Tenebrae.


  1. Open Send / private transfer.
  2. Enter recipient details per the transfer-link flow (ECDH + asset index — recipient does not need to be online at send time).
  3. Sign and submit.

Expected: Sender balance decreases; recipient can discover inbound commitment via transfer link when they connect.

Detail: private transfer · transfer links guide.


Step 4 — Withdraw (private → public)

  1. Open Withdraw.
  2. Select amount to unshield.
  3. Review disclosure: withdraw amount is public on-chain.
  4. Sign and submit.

Expected: Public wallet balance increases after confirmation.

Detail: withdraw from Tenebrae.


Verify success

CheckHow
On-chain depositSepolia explorer — Gateway deposit event
Private balanceTenebrae client portfolio tab
Transfer consumedRecipient wallet shows inbound private balance
WithdrawExplorer shows public transfer to your address

Operator QA reference: Sepolia deposit · transfer · withdraw QA.


Next steps

GoalPage
Embed in your appTenebrae SDK V2 · Embed patterns
Co-brand / white-labelHow to adopt · co-brand / white-label
Other testnetsHow to adopt — Base Sepolia · Tempo Testnet
Compliance framingCompliance two-layer
What you may claimStack

Troubleshooting

SymptomLikely cause
Proof hangsTestnet prover load — retry; check browser console
Balance not updatingWallet-receipt sync lag — refresh portfolio tab
Wrong networkWallet on mainnet — switch to Sepolia
Tempo sequential signingExpected on Tempo BYOW today — use Sepolia for this tutorial

A dedicated troubleshooting page is planned for a later docs release.