How superform-xyz/v2-core-public-cantina works
Project type and purpose
• This is a blockchain-based, modular DeFi protocol (“Superform v2”) for yield abstraction.
• It provides on-chain smart-contract modules (hooks, executors, validators, accounting) and an off-chain bundler (SuperBundler) to batch, sign, and relay user operations (ERC-7579 / ERC-4337).
File structure
• src/core/: the on-chain “Core Components” broken down into layers:
• accounting/ (SuperLedger, oracles)
• adapters/ (bridge adapters)
• executors/ (SuperExecutor, SuperDestinationExecutor)
• hooks/ (bridges, claim, loan, stake, swappers, tokens, vaults…)
• interfaces/, libraries/, paymaster/, validators/
• lib/: external submodules (OpenZeppelin, Solady, Pendle, etc.)
• test/ mirrors the core structure for unit/integration testing
• audits/, foundry.toml, Makefile: build, test, audit artifacts
README for architecture insights
• Core components: SmartAccount layer, Execution layer, Validation layer, Accounting layer
• Cross-chain infrastructure: bridge adapters + destination executors/validators
• Off-chain: SuperBundler generates Merkle trees, collects signatures, batches UserOps
Detail without over-fragmentation
• Smart-contract layers (executors, validators, paymaster, registry)
• Enumerate major hook categories (bridges, claim, stake, swap, token, vault modules)
• External dependencies (EntryPoint, oracles, off-chain merkle-js)