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 $VAULT in-app (or on 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 is set by the token's Bags launch config. $VAULT uses Bags' 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.
Auto-compounding LP fees
- • Earns while locked: the locked LP position keeps earning trading fees on Meteora. Those fees are claimed once they reach 0.05 SOL.
- • Reinvested, not extracted: claimed fees are swapped and re-deposited into the same position as new liquidity, then locked again. Nothing is ever withdrawn.
- • Compounds over time: the locked liquidity grows on its own, deepening the pool cycle after cycle. Live and verifiable on-chain.
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 $VAULT in-app (or on StreamFlow) for at least 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. It also earns trading fees, which are automatically claimed and reinvested back into the position, so the locked liquidity compounds over time. 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 $VAULT (in-app on the Lock page, or on StreamFlow directly) 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 $VAULT in-app on the Lock page (or on StreamFlow directly) 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.
Why StreamFlow
StreamFlow is an established Solana locking and vesting protocol, running for years and used across the ecosystem. Locks live fully on-chain and are verifiable by anyone, and explorers and trading tools recognize StreamFlow escrows, so locked tokens are accurately reflected and kept out of circulating supply. VaultBags uses this proven infrastructure instead of a lock contract of its own: less risk, and nothing new to trust.
Holder raffle
The holder raffle is an occasional, operator-funded giveaway to $VAULT holders. Just holding $VAULT earns you raffle tickets. No purchase necessary, holding is your entry. A draw can put up a single prize or several places (for example a collectible card for first place, gold for second, S&P 500 for third), each going to a different winner. Prizes are funded by the operator or by anything donated into the raffle wallet, today kept separate from the 70/20/10 distribution. If the raffle proves itself, a future governance vote could allocate a share of fees to it. Draws are sporadic and not on a fixed schedule.
How tickets work
Time-weighted. Your tickets depend on how much $VAULT you hold and how long you hold it across a rolling 7 day window. A token held the whole window counts in full; held half the window it counts about half. Holding earlier means more tickets.
Capped by your current balance. Your tickets can never exceed what you actually hold at the draw, so selling beforehand lowers them and dumping leaves you at zero. What you do not hold at the draw does not count.
Locked counts 1.5x. A StreamFlow lock counts at 1.5x, but only on the locked tokens, not your whole balance. To qualify, the lock must still have at least 7 days left when the raffle ends, so locking only for the raffle week earns nothing extra. Near-expiry locks count at 1x.
Linear and fair. Tickets scale straight with amount, so splitting one wallet into several gives the exact same total. There is no sybil advantage.
Formula
tickets = ( min(twab_unlocked, balance_now_unlocked) + 1.5 × min(twab_locked, balance_now_locked) ) / ticket_unittwab is your time-weighted average balance over the window: the balance you held integrated across the 7 days, divided by the window length. The unlocked (wallet) and locked (StreamFlow) parts are weighted separately.
The cap takes the smaller of your time-weighted average and your current balance for each part, which closes the gap where a high past average but a sold-off balance could win.
ticket_unit is how much time-weighted $VAULT equals one ticket (currently 100,000). It only scales the displayed number; your odds are always your tickets divided by the total tickets in play.
Entering and eligibility
When a draw is open you opt in with a single free signature (no SOL, no transaction). Only wallets that opted in are eligible, so passively holding is not enough once a draw is live; you have to enter it.
You also need tickets at the close: the ticket list is frozen when the draw closes, using your balance at that moment. Entering and then selling before the close leaves you with zero tickets.
The 1.5x lock boost applies only if your StreamFlow lock still has at least 7 days remaining when the draw closes, and only on the locked amount. A lock created just for the raffle week, or one about to expire, counts at 1x.
Fair randomness
Before any randomness is drawn, the full ticket list is frozen and its hash is published. The randomness comes from the drand public randomness beacon (run by the League of Entropy: Cloudflare, EPFL, Kudelski Security, Protocol Labs and others), a verifiable, unbiasable beacon. Each draw uses the beacon round fixed by its window-close time, set days in advance when that round does not yet exist, and the signature is verified before use.
It is fully automatic: when the window closes, the winners are selected by a scheduled job, not by the operator, so the draw cannot be timed or influenced and runs even if nobody is watching. The selection is reproducible: anyone can take the published ticket list, hash it to confirm it matches, and re-run the same cumulative-weight walk with the published beacon value to verify each winner. When a draw has several places, the winners are distinct: each place excludes the wallets that already won an earlier place. The committed hash, the beacon round and value, and each prize transfer are all published in the Verify draw details next to every past winner.
Claiming your prize
Prizes are claimed, not airdropped, the same as RWA rewards. If you win, a Claim button appears on this page for each prize you won. You sign one transaction per prize and pay only the network fee; the prize transfers from the prize wallet straight to your wallet.
You have 3 days from the draw to claim. If a winner does not claim a place within that window, it is re-drawn automatically (same beacon) to a new wallet, excluding everyone who already won or passed. Places already claimed are never touched.
For a re-draw your tickets are recomputed by how much you keep holding after the raffle ends, time-weighted like the main draw: selling shrinks them and selling then re-buying right before the re-draw does not count. You cannot game a re-draw by holding for just a moment.
Example
Holding 1,000,000 $VAULT for the full 7 days is worth about 10 tickets. Locking that same amount is worth about 15. Buying it halfway through the window is worth about 5, and buying it minutes before the draw is worth almost nothing. Selling everything before the draw drops you to zero.
For creators
Any Bags token creator can activate VaultBags. Your holders get an autonomous treasury of 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. Add a name, ticker, image, optional socials and an optional initial buy, then launch. Bags now uses a single launch model: a 2% trade fee that eases toward ~0.5% as the token's market cap grows, with most of the supply locked at launch. 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. Add metadata, set your fee share, 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.
Launch model: Bags now uses a single default model, IPO mode: a 2% trade fee that eases toward ~0.5% as the token's market cap grows, 25% compounding liquidity, and most of the supply locked at launch (low float). The wizard launches every token under this model, matching what bags.fm's own launch page does today, so there is no mode picker to choose.
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, entered in USD with a live ownership % (same as bags.fm). 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 30 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.
Holder delegation
Worried that connecting your main wallet could put your funds at risk? You never have to. Holder delegation lets you use every holder tool from a throwaway burner wallet while your main wallet stays offline. Rewards always land in your main wallet, and a delegate can never move your funds.
Two ways to set it up
No connect (dust): from your main wallet, using any wallet or device, send the exact tiny amount the page shows (under one cent) to the VaultBags address. Your main wallet never touches the site; we detect the transfer and link the burner.
Sign a message: connect your main wallet, sign one short readable message (it cannot move funds or authorize any transaction), then disconnect right away. The burner is linked.
What the burner can and cannot do
Can claim your rewards (lock-boost rewards included), vote in governance, enter the raffle, and use Vault Intelligence and cards, all acting as your main wallet.
Can only ever send rewards and prizes to your main wallet.
Pays the gas and token-account rent itself, so your main wallet never needs SOL.
Cannot move, spend, transfer or lock your funds (creating a new lock still needs your main wallet, since it moves your tokens), and gets no control over your wallet.
Manage or revoke
Open the Delegate tool any time to see the active delegation or revoke it. Revoking asks the burner to sign a message (no funds move) and takes effect immediately. Establishing a new delegation replaces the previous one, so you can rotate burners freely.
Why not just move tokens to a burner? You can, but transferring your $VAULT to a fresh wallet resets your rewards and holding time. Delegation keeps both on your main wallet while you operate from the burner.
$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 your tokens (in-app on the Lock page, or on StreamFlow directly) 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 launch model does Bags use?
Bags now uses a single default launch model, IPO mode: a 2% trade fee that eases toward ~0.5% as the token's market cap grows, with most of the supply locked at launch. The amount that reaches VaultBags depends on the fee-share split the creator sets. $VAULT itself launched earlier under Bags' Founder Mode, where 1% of each trade flows 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. The position also earns trading fees, which are automatically claimed (once they reach 0.05 SOL) and reinvested back into it, so the locked liquidity compounds over time. 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?
The easiest way is the in-app Lock page: connect your wallet, choose an amount and an unlock date at least 7 days out, and sign in your wallet. You can also lock on StreamFlow directly if you prefer. Either way, VaultBags detects your lock automatically within 15 minutes, no extra steps.
Open the Lock page↑Ready to start?
Hold $VAULT to claim real-world assets, or activate VaultBags for your own token.