How onflow/defiactions works
Project type and purpose
• DeFiActions is an open-source, composable DeFi primitives framework built in Cadence for the Flow blockchain.
• It defines standard interfaces (Source, Sink, Swapper, PriceOracle, Flasher) and supplies plug-in “connector” implementations to adapt protocols (FungibleToken vaults, IncrementFi DEX, Band oracle, Flow-EVM, etc.).
• Goal: let developers assemble multi-step on-chain financial workflows (“money LEGOs”) without writing low-level protocol glue.
File structure
• Top‐level:
• cadence/ — all Cadence smart contracts, scripts, transactions, and tests
– contracts/interfaces/ — core DeFiActions interface definitions
– contracts/connectors/ — protocol‐specific connector implementations
– scripts/ & transactions/ — client entry points for on‐chain calls
– tests/ — mock contracts, unit tests, and transaction tests
• solidity/ — auxiliary EVM connector adapters and supporting libraries (Forge, OpenZeppelin, flow-sol-utils)
• config & CI: flow.json, Makefile, foundry.toml, GitHub workflows
• Patterns:
• Interface→Implementation layering
• Modular connectors grouped by protocol
• Transaction and script folders mirror connector categories for example usage
• Test harness uses Flow emulator accounts, mock oracles, and CI pipelines