Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.swarms.ai/llms.txt

Use this file to discover all available pages before exploring further.

Vault Mode lets creators gate access to their tokenized agents and prompts behind token ownership. When enabled, the listing page is locked for anyone who doesn’t hold the entity’s token — and instantly unlocked the moment they do. It is the first native, token-gated distribution model for the Swarms Marketplace, turning every tokenized product into a holders-only experience.
Vault Mode requires the entity to be tokenized first. Configure it from swarms.world/launch by toggling Tokenize → Vault Mode.

​
What is Vault Mode?

When Vault Mode is enabled on a tokenized agent or prompt:
  • The full listing (system prompt, agent code, metadata, etc.) is blurred and inaccessible to non-holders.
  • Visitors see a “Holders only” gate with a built-in Buy $TICKER widget.
  • Any non-zero balance of the entity’s token unlocks the page.
  • The creator always has access, regardless of holder status.
  • Holder status is cached for 5 minutes per wallet/token pair to keep the experience snappy.
This unlocks an entirely new monetization model for the agent economy — token-gated agents, premium prompts, exclusive tools, private swarms, and member-only AI products.

Token-Gated Access

Only holders of your agent’s token can view the system prompt, code, and metadata.

Built-In Buy Flow

Non-holders see a one-click buy widget — they can become holders without leaving the page.

Automatic Permissions

Holder verification runs onchain. No allowlists, no manual approvals.

Creator Bypass

The wallet that minted the agent always sees the unblurred listing.

​
Benefits

Vault Mode creates a direct alignment between holders and creators:
  • Token-gated access to agents and prompts.
  • New monetization models beyond subscriptions — your token is the product key.
  • Exclusive access for token holders who back you early.
  • Automated permission management with no offchain bookkeeping.
  • Premium AI products and experiences that scale with your token’s distribution.
When a non-holder buys $TICKER on the page, the gate animates into an “Access granted” confirmation and reveals the listing — no refresh required.

​
How to enable Vault Mode

1

Sign in or sign up

Create or sign into your Swarms account at swarms.world/signin.
2

Open the Launchpad

Go to swarms.world/launch and start a new agent or prompt listing. Vault Mode is currently supported for agents and prompts (not tools).
3

Select Tokenize

Fill in the required fields (name, description, image, etc.) and choose Tokenize as your monetization option. Vault Mode requires a tokenized product because the token is the access key.
4

Enable Vault Mode

In the Tokenize panel, toggle Vault Mode on. You’ll see a description confirming:
Only token holders can view this agent.
5

Launch

Submit your listing. Once your token is minted, the page is automatically gated. Your wallet (the creator) sees it unblurred; everyone else must hold $TICKER.
Vault Mode can be combined with Frenzy Mode for tokenized agents and prompts. Holders unlock the listing, and every trade on the bonding curve collects 2× fees. See the Frenzy Mode doc.

​
How it works under the hood

Vault Mode is a client-rendered gate backed by an onchain balance check.
1

The listing renders, blurred

The full entity page is rendered as a blurred, non-interactive layer underneath the gate. Nothing sensitive (system prompt, code, etc.) is shipped to the client for non-holders in plaintext that would otherwise be hidden — the gate is paired with a server-enforced check below.
2

The gate calls the holder endpoint

Once the visitor’s wallet is connected, the gate calls:
GET /api/vault-mode/check-holder?wallet={publicKey}&token_address={mint}
The endpoint returns:
{
  "is_holder": true,
  "balance": 12500
}
3

Holder cache (5-minute TTL)

The result is cached in-memory and in sessionStorage under vault-mode:holder:{wallet}:{mint} for 5 minutes. Subsequent visits within that window skip the network round-trip.
4

Unlock animation

When a holder is detected for the first time, the gate plays a brief “Access granted” → reveal animation, then renders the full listing. The creator and existing holders bypass the gate immediately.
5

In-gate buy flow

Non-holders can buy $TICKER directly from the gate without leaving the page:
  1. Enter a SOL amount — a live quote estimates how much $TICKER you’ll receive.
  2. Sign the swap in your wallet.
  3. On success, the holder cache is invalidated and re-checked.
  4. The page unlocks automatically with the “Access granted” animation.

​
Visual indicators

A purple VAULTED tag with a lock icon appears next to the entity title on any gated listing, so visitors immediately understand the access model. If the entity is also in Frenzy Mode, the orange FRENZY tag renders alongside it.

​
FAQ

No. Vault Mode is the access mechanism for tokenized products — the token itself is the key. If you want a paid-but-not-tokenized listing, use the standard paid monetization option instead.
Any non-zero balance unlocks the listing. There is no minimum threshold today.
No. The wallet that launched the agent is recognized as the owner and always has unblurred access, even with a zero balance.
Yes. Edit the listing from your profile and toggle Vault Mode off. The change applies immediately.
They lose access on the next holder check (within 5 minutes, or immediately on hard refresh). The gate reappears with the buy widget.
Not currently. Vault Mode is supported on agents and prompts because those are the entity types eligible for tokenization on the marketplace today.

​
See also