Quickstart

Pick a vault

Fetch all available SuperVaults on Base:

curl https://persephone.superform.xyz/v1/supervaults?chain_id=8453

Filter to availability: "available" and is_supervault_v_2: true. Pick a vault address and note its assets[0].address (the token your user will deposit).Example (NVDA SuperVault):

Vault: 0xc441a2cc3a528b6312740448a70cc4d40f4d7bfc
Underlying token (NVDAc): 0xb20000000000000000000078ee7ce2fe4908108c
Decimals: 8

Check user balance

The Bundler validates balance on-chain and returns 400 if the user’s balance is insufficient. Check first:

curl https://persephone.superform.xyz/v1/balances/0xUSER_ADDRESS

Build the deposit

Replace 100000000 with the actual token amount scaled to the underlying token’s decimals. bStock tokens (NVDAc, TSLAc, SPCXc, etc.) use 8 decimals — 100000000 = 1 token. USDC uses 6, WETH and UP use 18. Read the assets[0].decimals field from the vault response.

curl -X POST https://bundler.superform.xyz/hooks/suggest/non-smart-account \
  -H "Content-Type: application/json" \
  -d '{
    "account": "0xUSER_WALLET_ADDRESS",
    "action": {
      "type": "DEPOSIT",
      "slippage": 50,
      "sources": [
        {
          "address": "0xb20000000000000000000078ee7ce2fe4908108c",
          "chain_id": 8453,
          "amount": "100000000"
        }
      ],
      "targets": [
        {
          "address": "0xc441a2cc3a528b6312740448a70cc4d40f4d7bfc",
          "chain_id": 8453,
          "vault_type": "SUPERVAULT",
          "amount_proportion": 1
        }
      ],
      "route_type": "OUTPUT",
      "outputs": []
    }
  }'

The response is an ordered executions[] array.

Broadcast

Send each transaction in order. Wait for on-chain confirmation before sending the next.

executions[0] — ERC20.approve(vault, amount)   selector: 0x095ea7b3
executions[1] — ERC4626.deposit(amount, user)  selector: 0x6e553f65

Both carry type: "DEPOSIT". Use array index, not type, to determine order.After executions[1] confirms, the user holds superNVDA shares.

Earn

Hooks

SuperVaults Validator Network