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