VaultBags Documentation
VaultBags is an autonomous treasury protocol for the Bags ecosystem. It auto-converts trading fees into diversified real-world assets (gold, S&P 500, and US Treasury bonds) that holders claim directly to their wallet. Any Bags token creator can activate it with zero code.
70/20/10
Distribution
3
RWA assets
15 min
Cycle
Hold to earn
Every trade generates fees that flow into the treasury. Fees are automatically swapped into 3 real-world assets every 15 minutes. Holders claim their proportional share directly to their wallet. No staking required.
Lock for extra rewards
Lock tokens via StreamFlow for 7+ days and earn up to 50% extra rewards from the lock boost pool. The boost adjusts dynamically based on how much of the circulating supply is locked.
Treasury-as-a-service
Any Bags token creator can activate VaultBags for their token. Each project gets isolated wallets, automatic distribution, and the same 70/20/10 model. 5% protocol fee from external projects strengthens $VAULT liquidity.
How it works
The treasury agent runs autonomously every 15 minutes. No manual intervention required.
Activate
Token creator adds VaultBags as a fee sharing recipient on Bags. One-time setup, no code required. Works with any fee mode.
Collect
Every trade generates fees. VaultBags claims accumulated fees automatically every 15 minutes via the Bags SDK.
Convert
The fee rate depends on the token's fee mode on Bags (Founder Mode, Paper Hand Tax Mode, ~0% Mode). $VAULT uses Founder Mode (2% total per trade, 1% goes to VaultBags). 1% covers operational costs. Of the remaining 99%: 90% is swapped to 3 real-world assets (GOLD, SPYx, USDY) via Jupiter, and 10% stays as SOL for permanent liquidity. For external projects, an additional 5% goes to $VAULT LP before the split.
Distribute
RWAs are sent atomically to each project's dedicated wallets: 70% to the holder claim pool, 20% to the lock boost pool. 10% SOL goes to the LP wallet for Meteora deposits.
Claim
Holders connect their wallet, see their proportional share of RWAs, and claim directly. No staking, no lockups required.
The entire flow is automated and on-chain verifiable. Each step generates transactions visible on Solscan. The treasury agent handles fee claiming, swapping, distribution, lock boost calculation, LP deposits, and snapshot recording.
Thresholds & mechanics
Swap to RWAs
- • Minimum swap threshold: 0.03 SOL per project. If accumulated fees are below this, SOL stays pending until the next cycle.
- • Treasury SOL reserve: 0.05 SOL always kept in the treasury wallet for transaction fees. Never spent on swaps.
- • Price impact cap: 3% maximum per swap. Swaps that would exceed this are skipped.
- • Split: 90% of the swap amount goes to RWAs (33/33/33 between GOLD, SPYx, USDY). 10% stays as SOL for the LP wallet.
LP deposit on Meteora
- • Minimum LP deposit: 0.05 SOL + 0.02 SOL gas reserve = 0.07 SOL total in the LP wallet.
- • Gas reserve: 0.02 SOL permanently kept in the LP wallet to cover swap + deposit + future fee claim transactions.
- • Below threshold: SOL accumulates until 0.07 SOL is reached, then deposits in the next cycle.
- • Pool requirement: Token must have a DAMM v2 pool on Meteora. For projects still in the DBC bonding curve, SOL accumulates until the token bonds.
How LP deposit works
- 1. The agent reads the LP wallet SOL balance minus 0.02 SOL gas reserve (the usable amount).
- 2. Half of the usable SOL is swapped to the project's token via the Meteora pool. If the wallet already has tokens from a previous cycle, the swap amount is adjusted to use both balanced.
- 3. The remaining SOL + tokens are deposited as liquidity into the Meteora DAMM v2 pool (50/50 at current price).
- 4. The LP position is permanently locked on-chain. It cannot be withdrawn.
Distribution model
Every fee collected follows the 70/20/10 distribution. After 1% operational costs, the remaining 99% is split. For external projects, a 5% protocol fee is deducted first and deposited as $VAULT LP on Meteora.
All holders claim their proportional share of GOLD, SPYx, and USDY directly to their wallet. Share is calculated based on circulating supply (excludes Meteora DAMM v2 LP and Meteora DBC bonding curve tokens). Minimum claim threshold: ~$2.
Holders who lock tokens via StreamFlow (minimum 7 days) earn up to 50% extra rewards from this pool. Boost is calculated on locked tokens only, not total holdings. The boost percentage adjusts dynamically: the less circulating supply is locked, the higher the boost (up to 50% max). As more holders lock, the boost decreases for everyone.
SOL is swapped to the project's token and deposited as liquidity on Meteora DAMM v2. The position is permanently locked and never withdrawn. Deeper liquidity means better trading conditions for everyone.
Fee flow example ($VAULT)
$10,000 daily volume → $100 fees (1%) → $1 ops → $99 distributed:
Fee flow for external projects
Same structure, but a 5% protocol fee is deducted first. This 5% becomes permanently locked LP in the $VAULT Meteora pool, strengthening $VAULT liquidity. The remaining 95% follows the same 70/20/10 distribution for the project's holders.
Treasury portfolio
Three uncorrelated real-world assets provide diversification across market conditions. When one drops, another tends to rise.
Store of value for thousands of years. Hedges against inflation. Tends to rise when stocks drop.
GoLDppdjB1vDTPSGxyMJFqdnj134yH6Prg9eqsGDiw6AExposure to the 500 largest US companies (Apple, Microsoft, Amazon, Google). Dividends auto-reinvested via rebasing.
XsoCS1TfEyfFhfvj8EtZ528L3CaKBDBRqRapnBbDF2WBacked by US government bonds, the safest financial instrument. Provides steady yield and stability. Price is ~$1.10, not $1.00 (yield accrues in price).
A1KLoBrKBde8Ty9qtNQUtq3C2ortoC3u7twggz7sEto6Why all three?
These assets are uncorrelated. Gold hedges during crashes, SPYx captures growth during bull markets, and USDY provides steady yield regardless of conditions. Together they protect the treasury in any market environment.
Lock boost
Lock your tokens via StreamFlow for at least 7 days to earn up to 50% extra rewards from the 20% lock boost pool. Boost is calculated on your locked tokens only.
How it works
- 1.Lock tokens on StreamFlow (streamflow.finance) for 7+ days
- 2.VaultBags detects your lock automatically every 15 minutes
- 3.Boost rewards accumulate alongside your regular holder rewards
- 4.Claim both regular + boost rewards together on the claim page
Boost formula
boost_multiplier = min(1.5, 1 + 1 / (3.5 × fractionLocked))fractionLocked = total locked tokens / circulating supply
Max boost: 50% extra (1.5x) when less than ~57% of circulating supply is locked
Key principle: Boost applies only to locked tokens, not total holdings. A holder with 50M in wallet + 1 token locked gets boost on 1 token only.
Early advantage: The fewer tokens locked overall, the higher the individual boost. As more holders lock, the boost decreases for everyone.
Example
You hold 10M tokens and lock 5M via StreamFlow for 30 days. If fractionLocked is 10%, your boost multiplier is 1.5x (max). Your 5M locked tokens earn their normal holder reward + 50% extra from the lock pool. Your 5M unlocked tokens earn normal holder rewards only.
For creators
Any Bags token creator can activate VaultBags. Your holders get an autonomous treasury backed by real-world assets with zero code.
Two ways to launch
Option A. Launch via VaultBags
Use vaultbags.app/launch. The wizard runs the Bags launch flow with VaultBags pre-configured as a fee-share recipient. Pick the fee mode (Founder, Paper Hand Tax, Company), name + ticker + image, optional initial buy. Minimum 10% to VaultBags; the rest is your call. Full ownership of your token stays with the creator wallet.
Option B. Launch on Bags directly
Prefer the native Bags launcher? Launch on bags.fm as usual and add @VaultBags as a fee-share recipient during setup. Same end result, you just go through the Bags interface instead of ours. Your token gets picked up automatically as soon as fees start flowing.
Already have a token?
Add @VaultBags as a fee-share recipient on the Bags app and your existing token will start funneling fees into a treasury automatically. Same flow, no relaunch needed.
Isolated wallets
Each project gets 3 dedicated wallets (claim, lock boost, LP). Your RWAs are separate and never mixed with other projects. All wallets are verifiable on Solscan.
Automatic detection
New tokens are detected when their first fee arrives. 3 wallets are generated, the creator is identified via Bags SDK, and the pool status is tracked automatically through the bonding curve and Meteora migration.
Same benefits
Your holders get the same 70/20/10 distribution: claimable RWAs, lock boost rewards, and permanently locked LP on Meteora.
Manage panel
Creators get a dedicated dashboard to monitor their project's treasury, distribution history, holder count, and LP status.
5% protocol fee
5% of external project fees become permanently locked LP in the $VAULT Meteora pool, strengthening $VAULT liquidity and funding protocol development. The remaining 95% follows the 70/20/10 split for your holders.
Vault Intelligence
Real-time analytics dashboard available at vaultbags.app/intelligence. 7 specialized tabs covering treasury performance, risk, market conditions, community metrics, personal analytics, projections, and AI-powered analysis.
Access tiers
Public: Performance, Community, top of Risk.
Any holder: My Vault, Predictive.
100K+ $VAULT: Market, full Risk.
500K+ $VAULT: AI Analyst.
Holdings are checked server-side on every request; locked tokens count toward the minimum.
Performance
Treasury value with 24h/7d/30d changes and percentage movements. Fee inflow tracking per period (how much SOL entered the treasury). Asset price comparison showing how GOLD, SPYx, and USDY performed vs SOL. Cumulative fees chart over time. Best and worst days for the treasury.
Risk
Treasury health score (Healthy/Caution/Alert) based on asset volatility, concentration, and treasury state. Active alerts for unusual conditions like volatility spikes, high asset concentration, or low trading volume. Asset correlation analysis and drawdown tracking.
Market
Crypto Fear & Greed Index with current sentiment classification. RWA token prices compared against their real-world counterparts (GOLD vs gold spot price, SPYx vs S&P 500, USDY vs 10-Year Treasury yield), each surfaced with a Bullish / Neutral / Bearish signal pill computed from recent price action. Federal Reserve funds rate, CPI data, scheduled macro events (FOMC, CPI release dates), and a crypto news feed. RWA issuer health indicators surface attestation status and reserve backing for Ondo and the tokenized gold custodian.
Community
Active holder count, total locked tokens, number of active locks, current boost multiplier, percentage of circulating supply locked, and top lockers with their lock details.
My Vault
Personal dashboard (requires wallet connection). Shows your token holdings, claimable RWAs broken down by asset (GOLD, SPYx, USDY), lock status and boost multiplier, claim history, and your rank among all holders.
Predictive
Rewards pool projection with three scenarios (bull, base, bear) based on current volume trends. Estimated daily and monthly rewards at different volume levels. Monte Carlo simulation for probability distribution of outcomes.
AI Analyst
Chat interface where you can ask questions about the treasury, market conditions, and your position. The analyst has access to real-time data from the treasury, Federal Reserve, CoinGecko, and DexScreener. Provides data-driven analysis, not financial advice. Limited to 10 messages per hour per wallet. Requires wallet connection.
Tools
Additional tools for holders and creators. All available at vaultbags.app.
Token Launcher
One-page launch flow at vaultbags.app/launch. Configure metadata, pick a fee mode, optionally seed an initial buy, and the launcher routes everything through Bags with VaultBags pre-attached as a fee-share recipient. The token launches under the creator's wallet, not VaultBags.
Fee modes (in-wizard): Founder Mode (1% of trading volume to fee-share recipients, recommended for tokens that want VaultBags-fueled rewards), ~0% Mode (near-zero post-bond fees), Paper Hand Tax Mode (10% sell tax with half added back to LP). Company Mode and Drop Mode launch on bags.fm directly. The redirect carries our partner referral so VaultBags still earns credit on the launch.
Fee-share split: minimum 10% goes to @VaultBags so your token gets the full treasury cycle (RWA claims, lock boost, LP). The remaining percentage is the creator's choice across any wallets they want to add.
Initial buy (optional): the creator can seed a buy at launch in the same transaction. Useful to set the opening price floor and avoid a hostile snipe in the first block.
After launch: token starts trading on Bags + Meteora bonding curve immediately. The first time fees arrive, VaultBags auto-provisions three wallets for the project (claim, lock, LP), starts swapping fees into RWAs, and the project appears on /explore.
Swap Widget
Built-in multi-asset swap at vaultbags.app/swap. Trade $VAULT, GOLD, SPYx, or USDY against SOL or USDC, or directly between each other. Lets holders rebalance claimed RWAs without leaving the site.
Routing: Jupiter Lite API picks the best path across every Solana DEX (Meteora, Raydium, Orca, Lifinity, Whirlpool, etc) and shows the expected output, price impact, and route legs before you sign.
Slippage: editable per-trade, default sane for the asset pair. Tight slippage on USDC pairs, looser on illiquid RWA-RWA legs. The widget warns if your input would exceed the safe price impact ceiling so you don't accidentally blow up a trade on thin liquidity.
Live chart: DexScreener embed for the input or output token, updates in real time so you can time entries against the actual order book instead of trading blind.
Transaction safety: the swap transaction is built server-side from a quoted route; the browser only signs the result. Removes a class of front-end tampering risk where a compromised page could mutate amounts or destinations between quote and sign.
Telegram Bot
@VaultBagsBOT brings vault stats, your personal claimables, lock status, milestone alerts, shareable cards, and the AI Analyst into Telegram DMs. Free, read-only by build-time guarantee, gated to linked $VAULT holders for personal commands. Linking takes one wallet signature.
Public commands: /treasury (vault stats and RWA breakdown), /cycles (recent treasury cycles), /card vault (vault stats PNG), /card performance (RWA vs SOL/BTC/ETH PNG), /help (full menu).
Personal commands (linked holders): /me (your held + locked, holding %, boost, lifetime claimed), /claim (your claimable RWAs right now), /locks (your active StreamFlow locks with days remaining), /card me (your holder card PNG).
AI Analyst (500K $VAULT held or locked): /ask <question> runs the same model, system prompt, and tool set as the web Vault Intelligence. Multi-turn (24h sliding session window), 50 questions per day shared budget with the web. The bot can fetch your live position, recent claims, top holders, market data, macro indicators, and news to ground each answer.
Notifications: /notify shows your prefs and lets you toggle each type (claim ready, lock expiring, vault paid milestones, marketcap milestones, daily digest, daily AI briefing). /snooze 1h | 6h | 24h | 7d mutes all notifications for the chosen window. /unsnooze resumes them. Premium tiers (claim_ready, daily_briefing) gate at the moment of send so a holder who drops below threshold simply stops receiving them.
Wallet linking: /link issues a single-use 10-minute deep link to vaultbags.app/link. You sign a one-time message with your wallet, and the bot binds your Telegram identity to that wallet. Replay-protected (signature is unique per session, the pending row is consumed on confirm). /linked shows the currently linked wallet (truncated). /unlink confirm removes the link.
Security: the bot lives in a separate code path that physically cannot import any signing, key-decryption, or fund-handling library. The check runs at build time so even an accidental future commit gets rejected before deploy. The bot can read your data and message you. It cannot move anything.
Report Cards
Shareable PNG cards generated on-demand. Connect your wallet and download:
Holder Card - Your holdings, claimable RWAs per asset, lock status, boost multiplier, rank among all holders, holding-tier badge (New Holder / Early Supporter / Committed Holder / Diamond Hands / OG Holder) based on days holding, and days remaining on your longest active lock
Vault Stats - Treasury snapshot with total value, GOLD/SPYx/USDY breakdown, total distributed to holders, volume, locked supply percentage
Performance Card - Compares RWA rewards over a chosen period (7d/30d/90d) against what you would have earned holding SOL, BTC, or ETH instead
Leaderboard
Top 20 holders ranked by holdings. Shows lock badges with duration, locked percentage of circulating supply, and individual lock details. Drives competition and retention among holders.
Reward Simulator
Calculator that estimates your potential RWA rewards based on investment amount, daily volume, and lock duration. Shows the 70/20/10 distribution breakdown with real-time boost multiplier and circulating supply data.
Governance
Voting and community proposals for holders. Every vote and proposal carries a cryptographic signature from the wallet that cast it, so any third party can verify authenticity without trusting our database.
Voting eligibility: 1M $VAULT minimum. Hold for 3+ days OR lock via StreamFlow for 7+ days (original lock duration, not remaining). Wallet and active locks both count toward the minimum.
Community proposals: holders with at least 10M $VAULT locked and 30+ days remaining on each qualifying lock can submit a proposal. Proposals run 15 days fixed and each wallet can only have one active at a time.
Moderation: proposals are attributed to the proposer wallet on the Vote page. Only the protocol admin can close or delete proposals, reserved for spam or obvious errors.
Audit trail: every vote and proposal stores the signed message + ed25519 signature, verifiable via the wallet pubkey.
Explore
Browse all projects using VaultBags. See each project's vault value, fee history, distribution split, and on-chain wallet addresses. $VAULT is featured as the first project.
Treasury Chart
Historical treasury USD value plotted over time on the Treasury page. Range selector for 7D, 30D, 90D, and all-time. Driven by periodic on-chain snapshots (every 15 minutes), downsampled for responsive rendering.
Milestones
Public progress badges shown on the $VAULT section of the landing page. Covers total RWA processed, amounts claimed by holders, trading volume, holder count, and supply locked. Shows the highest tier achieved plus the next upcoming milestone with percentage progress.
Manage Panel
Dedicated dashboard for token creators at vaultbags.app/manage. Monitor your project's treasury, distribution history, holder count, LP status, and redistribute unclaimed funds. Only accessible to the creator wallet detected via Bags SDK. Wallets without a project see a dual CTA: launch a new token via our wizard, or attach @VaultBags to an existing Bags token.
Live Activity Ticker
Floating notification bubble that surfaces on-chain activity in real time: vault fills, holder claims, $VAULT buys/sells, and new locks. Powered by a Helius webhook that pipes events into Supabase Realtime, so any open page sees activity within ~1 second. Click any event to open the transaction on Solscan.
$VAULT on-chain wallets
All wallets are on-chain and verifiable. Every transaction is public on Solscan. External projects get their own set of isolated wallets when they activate VaultBags.
$VAULT project wallets
Holds RWAs (GOLD, SPYx, USDY) for holder claims
diFYiC7u6ASvDSPA72EXEH3U26Jwm6C4p7iRKhVAULTHolds RWAs (GOLD, SPYx, USDY) for lock boost rewards
FJz6AspxTNiDhcfq7qTvLW8Y6qQkqyGEMXPRH3VAULTSOL for Meteora LP deposits + protocol fee from external projects
mqEusNbCTwAqJuWJbPEYRnAJ3spVk8muwvHE54VAULTProtocol wallets
Claims fees from all projects, executes swaps to RWAs, and distributes the assets to each project's claim, lock, and LP wallets.
Bd7PmDUuvpGjFvHmoi59YCLGvjsShXrsopebg8kjaDWGCatches some fees when a creator adds @VaultBags as fee-share via bags.fm directly. Funds are claimed and forwarded to the main ops wallet automatically, so the regular swap and distribution flow runs unchanged.
d18pVHsSAV5k9TMBvqh5tXYajGBB66aD8XKYnLVAULT$VAULT token contract
4iCRYJHvwUE21duaQ1nQcUXkh7wYNQai9aBihd3FBAGSSecurity
On-chain verifiable
Every swap, distribution, and claim generates on-chain transactions. Anyone can verify balances and flows on Solscan at any time.
Isolated project wallets
Each project's funds are stored in separate, dedicated wallets. Funds are never mixed between projects.
Authenticated claims
Claims require wallet ownership verification. The holder signs the transaction, pays gas, and RWAs go directly to their wallet. No intermediaries.
Watermark system
A dividend-per-share watermark prevents exploit scenarios. New buyers only earn rewards from fees generated after they bought. Selling resets the watermark.
Double-claim prevention
Pending claims have a unique constraint per wallet. Boost rewards are marked atomically to prevent double payouts. Expired claims are cleaned safely every cycle.
API protection
All endpoints are protected against abuse and unauthorized access. Cron endpoints require authenticated requests.
FAQ
How often are rewards distributed?
The treasury agent runs every 15 minutes. It claims any accumulated fees from Bags, then swaps to RWAs per project when that project's pending SOL exceeds 0.03 SOL. Below that threshold, SOL accumulates until the next cycle. Distribution to project wallets (claim, lock, LP) happens atomically right after each swap.
What's the minimum amount to claim?
Around $2 in total claimable RWAs.
How much does it cost to claim?
The holder pays the SOL cost of every claim (the vault co-signs the transaction but never funds it). Two components: (1) Network gas, ~0.000005 SOL per claim. (2) ATA rent, a one-time ~0.002 SOL per RWA token to create the sub-account in your wallet. Your very first claim creates 3 sub-accounts (GOLD, SPYx, USDY) for ~0.006 SOL one-time. Subsequent claims only pay gas. This design keeps project wallets free of SOL, since they only hold RWAs.
Do I need to stake my tokens?
No. Simply holding tokens in your wallet earns rewards proportional to your share of the circulating supply. Locking via StreamFlow is optional for the extra boost.
What happens when I sell some tokens?
Your share of future rewards decreases proportionally. Already accumulated rewards remain claimable. If you sell 100%, your watermark is deleted.
Does the founder get a cut?
No. $VAULT sends 100% of fee sharing to VaultBags. There is no founder allocation or team vault. The founder holds and locks tokens like any other holder, earning regular rewards and lock boost through the same system.
How is circulating supply calculated?
Total supply minus tokens in the Meteora DBC bonding curve and Meteora DAMM v2 LP pool. These are non-circulating tokens that don't earn rewards.
What's the 5% protocol fee?
Only applies to external projects (not $VAULT). 5% of their fees become permanently locked LP in the $VAULT Meteora pool, strengthening $VAULT liquidity.
Is USDY a stablecoin?
Not exactly. USDY's price is ~$1.10 and rises daily as US Treasury yield accrues into the token price. It's yield-bearing, not pegged to $1.00.
What fee modes does Bags support?
Bags supports several fee modes: Founder Mode (2% per trade), Paper Hand Tax Mode (higher fee on sells), and ~0% Mode. VaultBags works with any fee mode. The amount that reaches VaultBags depends on what the creator configures in fee sharing. $VAULT uses Founder Mode where 1% of each trade goes to VaultBags.
How does LP deposit work?
10% of each distribution stays as SOL in the project's LP wallet. When the wallet has at least 0.07 SOL (0.05 minimum + 0.02 gas reserve) and the token has a Meteora DAMM v2 pool, the agent swaps half the usable SOL to the project's token and deposits both as permanently locked liquidity. The LP position cannot be withdrawn. For tokens still in the DBC bonding curve, SOL accumulates until the token bonds.
Can I claim if I bought recently?
Yes, but you only earn rewards from fees generated after your purchase. The watermark system ensures you can't claim rewards that were accumulated before you bought. This prevents buy-claim-sell exploits.
What happens if no one trades?
No trades means no fees, and no fees means no new RWAs in the treasury. The treasury only grows with trading volume. Already accumulated rewards remain claimable regardless of current volume.
Where can I lock my tokens for the boost?
Go to the $VAULT token dashboard on StreamFlow, connect your wallet, choose a lock duration of at least 7 days, and confirm. VaultBags detects your lock automatically within 15 minutes. No additional steps needed.
Open StreamFlow↑Ready to start?
Hold $VAULT to claim real-world assets, or activate VaultBags for your own token.