Skip to content

Builder Dashboard

The builder dashboard at dashboard.sweepster.xyz is the self-serve home for integrators. Sign up, get an API key, watch your earnings, and rotate your key — all by signing in with your wallet. No admin step.

Self-signup

  1. Go to dashboard.sweepster.xyz.
  2. Connect the wallet that will own your payout address. (Your payoutAddress is this wallet's address; it controls login.)
  3. Sign in with SIWE (Sign-In With Ethereum, EIP-4361) — sign the login message in your wallet. This is off-chain and free.
  4. If the wallet isn't a builder yet, you'll see a "Create a builder account" form. Pick a display name and submit (one more SIWE signature).
  5. You receive your API key once — copy and store it now, it won't be shown again — then land in the dashboard.

That's it. No emails, no approval queue. The builder account is created with a deterministic id (bld_<your address>) and is owned by the wallet you signed up with.

Backed by the public POST /builders/self endpoint (SIWE-gated). Self-signup is gated by the SELF_SIGNUP_ENABLED flag on the backend; if signup is closed you'll see a "contact Sweepster" message instead.

Zero commission to start

New builders are created at zero commission: builderBps = 0 and maxBuilderBps = 0. You can integrate, attribute sweeps, and view your dashboard immediately — but you earn a markup only once an admin raises your cap.

To earn a markup, contact Sweepster to request a higher maxBuilderBps. Markup changes are admin-set; the dashboard shows your config read-only (you cannot change builderBps or payoutAddress yourself).

What you can do in the dashboard

View your account

Your name and attribution config — builderBps, maxBuilderBps, and payoutAddress — shown read-only. (Powered by GET /me.)

View earnings

  • Payable balances — per-token amounts currently owed to you (not yet paid out).
  • Lifetime totals — per-token cumulative earnings.
  • Per-sweep activity — a ledger of each attributed sweep (sweep id, token, amount, paid flag, timestamp).

(Powered by GET /me/accruals and GET /me/activity.)

Rotate your API key

Generate a fresh API key from the dashboard. The new key is shown once; the old key is immediately invalidated. Use this if a key is leaked or on a rotation schedule.

(Powered by POST /me/apikey/rotate.)

Sign-in vs. sign-up

  • If your connecting wallet is already a builder's payout address, SIWE login drops you straight into the dashboard.
  • If it isn't, you get the "Create a builder account" form (self-signup).

Sessions are delivered as an httpOnly, Secure, cross-subdomain cookie — the SPA never reads the token, so it's XSS-safe. All dashboard API calls authenticate via that cookie.

Non-custodial · Atomic · Audit + bug bounty planned before mainnet value.