Concepts
Understand Enso’s core concepts and how they work.
Projects
A project in Enso represents an overarching blockchain platform or financial service with multiple protocol implementations. Projects serve as the top-level categorization in Enso’s data model, grouping related protocols
Example: The “Aave” project encompasses protocols “aave-v2” and “aave-v3”.
API Reference:
- GET
/projects
- Returns all available projects - GET
/projects/protocols
- Returns protocols available for a specific project
Protocols
A protocol is a specific implementation or version of a project deployed on one or more blockchain networks. Each protocol has a unique identifier (slug), defined functionality, and standardized interfaces.
For example, “uniswap-v3” specifies the exact smart contract implementations, supported chains, and available actions for that particular version of Uniswap.
API Reference:
- GET
/projects/protocols
- Returns all supported protocols and their metadata - GET
/standards/{slug}
- Returns details for a specific protocol by slug
Standards
A standard defines the interface specifications and methods for interacting with protocols. Standards document the common patterns across similar protocols, including required inputs, function signatures, and expected outputs.
This standardization layer enables Enso to abstract implementation details and provide consistent interfaces across varied DeFi protocols.
API Reference:
- GET
/standards
- Returns all available standards and their methods - GET
/actions
- Returns all standardized actions available for protocols
Actions
An action is a discrete operation performed on a protocol (e.g., “deposit”, “withdraw”, “swap”, “borrow”). Actions specify the required input parameters and expected outputs for each operation type.
Enso’s action abstraction allows developers to execute the same conceptual operation across different protocols without handling protocol-specific implementation details. Actions can be bundled into atomic multi-step transactions.
API Reference:
- GET
/actions
- Returns all available actions and their input parameters - POST
/shortcuts/bundle
- Allows bundling multiple actions into a single transaction
Tokens
Enso recognizes two primary token types:
-
Base Token: Standard cryptocurrency assets without DeFi positioning (e.g., ETH, WETH, USDC, DAI). These tokens serve as the building blocks for DeFi operations.
-
DeFi Token: Tokens representing positions in DeFi protocols (e.g., yvWETH for Yearn-deposited WETH, aDAI for Aave-deposited DAI). These tokens contain metadata about their protocol association, underlying assets, APY, and TVL metrics.
API Reference:
- GET
/metadata/tokens
- Returns all supported tokens with filtering options for type, protocol, etc. - GET
/metadata/prices
- Returns price data for a specific token
Both token types include core properties (address, chainId, decimals, symbol, name, logoUri), with DeFi tokens containing additional protocol-specific metadata.
Updated
Was this page helpful?