Vitez

Creator guide

Everything you need to launch a paid Telegram or Discord community on Vitez — from connecting your wallet to watching your first subscription land on-chain.

1. Connect your wallet

Go to /onboarding and click Connect wallet. Vitez uses Privy for authentication — you can sign in with MetaMask, Coinbase Wallet, WalletConnect, or any EIP-1193-compatible wallet. No email or social login is required.

Make sure your wallet is on Base (chainId 8453) or Base Sepolia (chainId 84532) for testnet. Vitez will prompt you to switch if you are on the wrong network.

2. Create a plan

In the onboarding wizard, fill in your plan details:

  • Title — shown on the checkout page and the /discover marketplace (max 80 chars).
  • Description — what subscribers get access to.
  • Price — USDC amount per billing period.
  • Period — billing cycle in days (e.g. 30 for monthly).
  • Category & tags — helps subscribers find your plan in /discover.
  • Visibility — Public (listed on /discover) or Unlisted (accessible by direct link only).

When you click Create plan your wallet opens a transaction to call SubscriptionRegistry.createPlan(). The plan is live on-chain as soon as the transaction confirms — there is no manual review step.

Multi-tier plans

After your first plan is created, click Add another tier on the Done step. The wizard resets the price, title, and tags while keeping the tier group, category, and token. Sign a second transaction for Bronze/Silver/Gold (or any other names you choose). Plans in the same tier group appear as a comparison grid on your public creator page (/c/<your-address>) and at checkout.

3. Bind your community

Telegram

  1. Add the @VitezBot to your Telegram group and promote it to admin (it needs permission to invite users and remove members).
  2. In the onboarding wizard, click Bind Telegram. You will be shown a challenge string — forward it to the bot in your group to prove ownership.
  3. Vitez verifies the challenge (signed against your wallet address) and links the group to your plan. From this point on, paying subscribers automatically receive a one-time invite link; expired subscribers are kicked.

Discord

  1. Click Install Discord bot — this opens a Discord OAuth screen. Authorize the bot for your server.
  2. Pick the role Vitez should grant to paying subscribers from the role picker that appears after install.
  3. Vitez will grant that role automatically when a subscriber pays and revoke it when their subscription lapses.

4. Share your plan

After binding, the wizard shows a shareable checkout link: vitez.app/p/<planId>. Post it in your bio, in a tweet, or in a pinned message. Anyone who visits the link can subscribe directly — no Vitez account needed.

You can also embed a subscribe button on your own site using the hosted widget at vitez.app/embed.js. Details are in the share dialog accessible from your dashboard.

5. Creator dashboard

The /dashboard page shows every plan you own, grouped by tier:

  • Active subscribers — wallets with a non-expired, non-cancelled subscription.
  • MRR estimate — active subscribers × plan price, normalised to 30-day periods. This is an estimate; actual income depends on successful auto-renew transactions.
  • Deactivate plan — stops new subscriptions and queues a “plan discontinued” email to all active subscribers. Does not cancel existing paid periods.

6. Auto-renew and payouts

Vitez runs a renewal cron every 15 minutes. For each subscription where auto-renew is on and the expiry is within the next hour, the Vitez relayer calls registry.renew(subId). This pulls the next period's USDC from the subscriber's wallet directly into yours — no withdrawal needed.

If a renewal fails (insufficient allowance or balance), Vitez sends the subscriber a dunning email, retries once, and auto-cancels after two failures. You will see the subscriber drop from your active count.

7. Fees

Vitez charges 2.5% per successful payment. The fee is taken on-chain at the time of the transaction and is always shown at checkout. There are no monthly platform fees, setup fees, or withdrawal fees.

Questions? founders@vitez.app. Also see the Subscriber guide.