Ember Plugin System

The Ember Plugin System is a standardized framework that enables developers to integrate any DeFi protocols into the Ember ecosystem. The system creates a unified layer that enables seamless, type-safe access to DeFi protocols across the entire network.

Features

Modular Plugin System: Extensible architecture for DeFi protocol integrations Multi-Protocol Support: Lending, liquidity, swap, perpetuals protocol, NFT Type Safety: Full TypeScript support with Zod validation schemas Multi-Chain: Support for multiple blockchain networks Action-Based: Define actions for supply, borrow, swap, and more Plugin for AAVE V3: Complete lending protocol with supply, borrow, repay, and withdraw

Installation

npm install @emberai/onchain-actions-registry

pnpm add @emberai/onchain-actions-registry

yarn add @emberai/onchain-actions-registry

Core Architecture

Ember Plugin Interface

Every plugin implements the standardized EmberPlugin<Type> interface that defines the contract between protocols and the ecosystem.


  interface EmberPlugin<Type extends PluginType> {
    id?: string;                    // Unique identifier
    type: Type;                     // Plugin category (lending, liquidity, swap, perpetuals)
    name: string;                   // Human-readable name
    description?: string;           // Protocol description
    website?: string;              // Official protocol website
    x?: string;                    // Social media presence
    actions: ActionDefinition[];   // Available protocol actions
    queries: AvailableQueries[];   // Data retrieval capabilities
  }

This interface ensures every plugin provides:Metadata: Essential information about the protocol and pluginActions: Executable operations (supply, borrow, swap, etc.) with input/output token specificationsQueries: Read-only data access (positions, markets, health factors)Type Safety: Compile-time guarantees through TypeScript generics

Action-Based Design

Each plugin exposes specific DeFi actions with standardized interfaces:Input/Output Tokens: Define supported token transformationsCallback Functions: Handle the actual protocol interactionsFlexible Action System: Implement multiple strategies for the same action type

Plugin Registry

Central discovery system that manages plugin registration and lazy loading:

  const registry = new PublicEmberPluginRegistry();
  registry.registerDeferredPlugin(getProtocolPlugin(chainConfig));

Plugin Types

The registry supports four main plugin types:

Lending Plugins

Supply, borrow, repay, and withdraw operations across lending protocols.

import type { EmberPlugin } from '@emberai/onchain-actions-registry';

const lendingPlugin: EmberPlugin<'lending'> = {
  type: 'lending',
  name: 'AAVE V3',
  actions: [
    // lending-supply, lending-borrow, lending-repay, lending-withdraw
  ],
  queries: {
    getPositions: async params => {
      /* Get user positions */
    },
  },
};

Liquidity Plugins

Add and remove liquidity from DEX pools and AMMs.

const liquidityPlugin: EmberPlugin<'liquidity'> = {
  type: 'liquidity',
  name: 'Camelot DEX',
  actions: [
    // liquidity-supply, liquidity-withdraw
  ],
  queries: {
    getWalletPositions: async params => {
      /* Get LP positions */
    },
    getPools: async () => {
      /* Get available pools */
    },
  },
};

Swap Plugins

Token exchange operations with slippage protection.

const swapPlugin: EmberPlugin<'swap'> = {
  type: 'swap',
  name: 'DEX Aggregator',
  actions: [
    // swap
  ],
  queries: {}, // Stateless operations
};

Perpetuals Plugins

Long, short, and close perpetual positions with leverage.

const perpetualsPlugin: EmberPlugin<'perpetuals'> = {
  type: 'perpetuals',
  name: 'GMX V2',
  actions: [
    // perpetuals-long, perpetuals-short, perpetuals-close
  ],
  queries: {
    getMarkets: async params => {
      /* Get available markets */
    },
    getPositions: async params => {
      /* Get open positions */
    },
    getOrders: async params => {
      /* Get pending orders */
    },
  },
};

Current Plugin Ecosystem

Plugin Discovery Flow

Registration: Plugins register with the central registry during initialization
Discovery: Agents query the registry for available actions by type
Execution: Registry routes requests to appropriate plugin callbacks
Validation: All inputs/outputs validated against TypeScript + Zod schemas

AAVE Lending Plugin Implementation

Complete reference implementation demonstrating all lending operations (supply, borrow, repay, withdraw) with comprehensive error handling and multi-strategy support.

Building Custom Plugins

The Plugin System is designed for rapid expansion. To get started, check out our contribution guidelines and our comprehensive guide on building custom plugins.

EmberAI

Workflow Library

Supported Chains & Protocols

Features

Installation

Core Architecture

Ember Plugin Interface

Action-Based Design

Plugin Registry

Plugin Types

Current Plugin Ecosystem

Plugin Discovery Flow

AAVE Lending Plugin Implementation

Building Custom Plugins

EmberAI

Workflow Library

Supported Chains & Protocols

​Features

​Installation

​Core Architecture

Ember Plugin Interface

Action-Based Design

Plugin Registry

​Plugin Types

​Current Plugin Ecosystem

​Plugin Discovery Flow

​AAVE Lending Plugin Implementation

​Building Custom Plugins

Features

Installation

Core Architecture

Plugin Types

Current Plugin Ecosystem

Plugin Discovery Flow

AAVE Lending Plugin Implementation

Building Custom Plugins