ALPHA TESTER GUIDE

Everything you need to know to use stash.fun vaults

Alpha Software

stash.fun is in alpha. Smart contracts are unaudited. Only deposit amounts you can afford to lose entirely. By using this protocol you accept the Terms of Service.

WHAT IS COMRAIL?

stash.fun is a commodity index protocol on Hyperliquid. You deposit USDC into thematic vaults (Metals, Energy, Broad Commodities) and the protocol automatically trades commodity perpetual futures to match each index's target allocation.

How it works

Your USDC is held in an ERC-4626 vault on HyperEVM. The executor bridges funds to Hyperliquid L1 and opens positions via an Agent Wallet that can only trade — it cannot withdraw your funds. Profits and losses are reported back to the vault, updating your share price.

GETTING STARTED

1 Connect your wallet

Click CONNECT in the top-right corner. You can use MetaMask, WalletConnect, or sign in with email (via Privy). Make sure you're on the Hyperliquid EVM network (Chain ID 999).

2 Get USDC on HyperEVM

You need USDC on HyperEVM. The easiest route:

Bridge USDC from Arbitrum to Hyperliquid L1 (via app.hyperliquid.xyz/bridge, min $5)
On Hyperliquid, go to More → HyperEVM and transfer USDC from L1 to your EVM address

You'll also need a tiny amount of HYPE for gas on HyperEVM.

3 Choose a vault

Navigate to the DISCOVER tab to see available vaults. Each vault tracks a different commodity index:

Metals — Gold (60%), Silver (30%), Platinum (10%)
Energy — Oil/WTI (70%), Natural Gas (30%)
Broad Commodities — Oil, Gold, Silver, Natural Gas, Platinum (diversified)

4 Deposit USDC

Click a vault, enter an amount (minimum varies, recommend $50+), and click DEPOSIT. You'll receive vault shares (ERC-20 tokens) representing your proportional claim on the vault's assets.

5 Monitor your position

Switch to the TERMINAL tab to see live market data, your positions, and unrealized PnL. Share prices update as the executor reports trading results back to the vault.

6 Withdraw

To withdraw, select your vault and click WITHDRAW. There is a 60-second lockup after depositing. If the vault has sufficient USDC reserves (10% is kept on-chain), your withdrawal is instant. Otherwise, a withdrawal request is queued and processed on the next sync cycle.

KEY DETAILS

Fees

Management fee: 1.5% annualized (accrued continuously)
Performance fee: 15% of profits (high-water mark)
Fees are split between the protocol treasury and the vault creator

Security Model

Vault contracts are UUPS-upgradeable with a 2-day timelock on governance actions
A guardian (separate from governance) can instantly pause deposits/withdrawals in an emergency
The Agent Wallet used for trading has trade-only permissions — it cannot withdraw funds from Hyperliquid
PnL reports are bounded to ±10% per update to prevent manipulation
Strategist withdrawals are rate-limited to 90% of vault assets per 24-hour window

Risks

Important Risks

Smart contract risk: Contracts are unaudited alpha software
Market risk: Commodity prices can be volatile; you may lose money
Bridge risk: Funds are bridged between HyperEVM and Hyperliquid L1
Execution risk: The executor is centralized during alpha
Liquidity risk: If vault reserves are low, withdrawals may be delayed

FAQ

Q: What network do I need to be on?

HyperEVM (Chain ID 999). Add it to MetaMask: RPC URL https://rpc.hyperliquid.xyz/evm, Currency: HYPE.

Q: What's the minimum deposit?

There's no hard minimum, but deposits under $50 may result in some positions being too small to trade (Hyperliquid requires $10 minimum order value). We recommend $50+ for best results.

Q: How often does the vault rebalance?

The executor runs a sync loop approximately every 60 seconds, checking positions against targets and rebalancing as needed.

Q: Can the executor steal my funds?

The Agent Wallet has trade-only permissions on Hyperliquid — it can open/close positions but cannot withdraw funds. Additionally, the strategist withdrawal rate is capped at 90% per 24h window, and all governance changes require a 2-day timelock.

Q: What tokens do I receive when I deposit?

You receive ERC-20 vault shares (e.g., comMETALS, comENERGY). These are standard tokens you can hold, transfer, or use in other protocols. Their value increases/decreases with the vault's trading performance.

Q: How do I report a bug?

Join our community channels or contact the team directly. During alpha, your feedback is critical for improving the protocol.