Quick Start
There are two ways to use zkde.fi right now — mainnet (the live product) and Sepolia (the full proof pipeline).
Mainnet: /portfolio and /passport
These are live on Starknet mainnet. Real capital, real transactions.
1. Connect your wallet
Open zkde.fi and connect with ArgentX or Braavos. Make sure your wallet is on Starknet mainnet (not Sepolia).
2. Check your passport
Open /passport.
This is your portable reputation profile. It reads your on-chain activity across Starknet — bridge deposits, protocol interactions, transaction history — and compiles it into a reputation score with tier progression and gate unlocks. Even if you've never used zkde.fi before, you'll see data here if you've been active on Starknet.
3. Open the portfolio rebalancer
Open /portfolio.
You'll see your current balances across ETH, STRK, USDC, and WBTC. The system shows:
- Current allocation — where your capital is right now
- Target allocation — what the AI recommends
- Drift indicator — how far you've drifted from target (aligned / watch / rebalance)
- AI recommendation — specific rebalance plan factoring yields from Ekubo, Vesu, staking
To execute a rebalance: review the recommendation, run the risk check, and sign the transaction. The system handles adapter routing, calldata construction, and receipt recording.
More detail: Portfolio Rebalancer
Sepolia: full proof pipeline
The Sepolia deployment has the full Capital OS and Trade Desk with five-lane proof verification, zkML circuits, privacy rails, and selective disclosure. This is the advanced proving experience — coming to mainnet.
What you need
- Wallet: ArgentX or Braavos, switched to Starknet Sepolia
- Funds: Testnet ETH for gas (use a Starknet faucet or
POST /api/v1/zkdefi/orchestration/faucet/eth) - Browser: Chrome or Firefox. Hard-refresh if you've visited before.
1. Check your trust context
Open /profile?tab=trust.
This shows whether you're gate-ready — meaning the system has enough context about your wallet to let you into controlled execution flows. Look for identity/binding status, reputation tier, and any blocking items. Do this before trying to trade or deploy.
2. Explore Capital OS
Open /agent?v=vault.
Three surfaces live here:
- Vault (
?v=vault) — portfolio, deployment controls, yield views - Oracle (
?v=oracle) — market signals, risk radar, analytics - Brain (
?v=brain) — automation controls, session keys, pipeline status
3. Make your first trade
Open /trade.
The Trade Desk shows a stream of opportunities. The workflow:
- Pick an opportunity from the stream
- Select the adapter route — Ekubo swap, LP add, etc. (don't skip — it defaults to a fallback builder)
- Set slippage —
0.5%,1%, or2% - Simulate first — check price impact, fees, expected output
- Execute — sign with your wallet
4. Verify
Check /profile to confirm your trust context updated and the transaction shows in history.
From here: rebalancing, session keys, or deploying to Ekubo.
Things that trip people up
| Mistake | What happens | Fix |
|---|---|---|
| Wallet on wrong network | Nothing works | Mainnet for /portfolio + /passport, Sepolia for /agent + /trade |
| Executing before checking profile | Gate blocks with no clear error | Check /profile?tab=trust first |
| Skipping adapter route selection | Fallback builder, unexpected behavior | Explicitly select the adapter |
| Forgetting to simulate | Unexpected slippage | Always simulate before executing |
Using old ?tab= bookmarks | Wrong surface loads | Use the canonical URLs from this guide |