Eve library

Cross-chain Bridge Service

Other

Revision 1

On this page

Deterministic orchestration layer that coordinates multi-chain bridging flows across Ethereum-compatible networks and Solana. The service consumes deterministic dependencies (route planner, EVM/Solana bridge operators, audit trail) and produces a canonical execution log for lock-and-mint, burn-and-release, and message-passing routes.

Features#

  • Selects the proper bridge route for EVM↔EVM, EVM↔Solana, and Solana↔EVM flows via an injected BridgeRoutePlanner.
  • Executes per-step actions (lock, mint, burn, release, message, execute) against specialized EVM and Solana operators.
  • Emits a normalized execution report containing the ordered transaction hashes for downstream analytics and auditing.

Usage#

ts
import {
  createCrossChainBridgeService,
  type BridgeRequest
} from "./service";
import { createDefaultBridgeRoutePlanner } from "./planner";

const bridge = createCrossChainBridgeService({
  planner: createDefaultBridgeRoutePlanner(),
  evmOperator: /* implementation that talks to EVM bridge contracts */,
  solanaOperator: /* implementation invoking Solana CPI/cross-program instructions */,
  auditTrail: {
    async recordExecution(result) {
      console.log("Bridge execution", result);
    }
  },
  idGenerator: () => `route-${Date.now()}`
});

const request: BridgeRequest = {
  sourceChain: "ethereum",
  targetChain: "polygon",
  adapter: "layerzero",
  operation: "lock-and-mint",
  assetAddress: "0xAsset",
  tokenId: "1",
  recipient: "0xRecipient"
};

await bridge.bridgeAsset(request);

Testing#

bash
timeout -k 5 60s npx jest --config apps/lilith/svc-cross-chain-bridge/jest.config.cjs --runInBand