@shroudfi/chain-adapters

Multi-chain adapters for the ShroudFi MEV protection protocol. Provides a unified interface for sending MEV-protected transactions across EVM chains, Solana, and more.

Installation

npm install @shroudfi/chain-adapters

Quick Start

import { EthereumAdapter, SolanaAdapter } from '@shroudfi/chain-adapters';

// EVM chain — routes through Flashbots/MEV Blocker
const eth = new EthereumAdapter();
const txHash = await eth.sendProtectedTransaction(signedTx);

// Solana — routes through Jito bundles
const sol = new SolanaAdapter();
const bundleId = await sol.sendProtectedTransaction(serializedTx);

Supported Chains

EVM Chains (Full Support)

| Chain | Adapter | MEV Protection | |---|---|---| | Ethereum | EthereumAdapter | Flashbots + MEV Blocker | | Base | BaseAdapter | Flashbots + MEV Blocker | | Arbitrum | ArbitrumAdapter | Flashbots + MEV Blocker | | Optimism | OptimismAdapter | Flashbots + MEV Blocker | | Polygon | PolygonAdapter | Flashbots + MEV Blocker | | BNB Chain | BnbAdapter | Flashbots + MEV Blocker | | Avalanche | AvalancheAdapter | Flashbots + MEV Blocker | | zkSync Era | ZkSyncAdapter | Flashbots + MEV Blocker | | Linea | LineaAdapter | Flashbots + MEV Blocker | | Scroll | ScrollAdapter | Flashbots + MEV Blocker |

Non-EVM Chains

| Chain | Adapter | MEV Protection | |---|---|---| | Solana | SolanaAdapter | Jito Bundles (Beta) | | Cosmos | CosmosAdapter | Skip Protocol (Phase 2) | | Sui | SuiAdapter | Coming (Phase 2) | | Aptos | AptosAdapter | Coming (Phase 2) |

Architecture

All EVM adapters extend the base EvmAdapter class which implements a 3-tier MEV protection cascade:

1. Flashbots Protect — Direct builder submission (fastest, most private)
2. MEV Blocker — CoW Protocol's relay (backup, broader builder set)
3. Public RPC — Standard submission (fallback only)

The Solana adapter uses Jito's block engine for atomic bundle submission, making transactions invisible to sandwich bots.

License

MIT — Astra Fintech Labs Pvt. Ltd.