# Bridged Finance

> Non-custodial any-to-any cross-chain liquidity and routing protocol supporting 57 blockchains and 7,400+ tokens.

Bridged Finance enables seamless cross-chain swaps, bridges, and automated multi-hop routing across EVM chains, Solana, Bitcoin, Cosmos, TON, and TRON. Swaps execute atomically via AMM Octopools and decentralized multi-party computation (MPC) threshold relayer nodes with 100% on-chain revert protection.

## Core Protocol Architecture

- **Meta On-Chain Aggregation (MOCA):** Integrates on-chain DEXs on source and destination chains with cross-chain Octopools to find optimal pricing and minimal slippage.
- **Relayer Quorum & MPC TSS:** Distributed consensus validates cross-chain transactions without centralized custody.
- **On-Chain Revert Protection:** If a destination swap fails due to extreme slippage, synthetic sTokens are minted to the user wallet on destination or refunded to source.
- **Shielded Private Mode:** Relays cross-chain transactions through privacy-preserving pool contracts, decoupling destination wallets from source history.

## Quickstart REST API

Base URL: `https://api.symbiosis.finance/crosschain/v1`

- `GET /quote`: Calculate real-time cross-chain swap rate, fees, gas costs, and estimated execution time.
- `POST /swap`: Generate signed calldata and execution transaction to execute the cross-chain swap.
- `GET /chains`: Retrieve active list of all 57 supported blockchain networks, chain IDs, and gateway configurations.
- `GET /tokens`: Search catalog of 7,400+ verified tokens across all chains.
- `GET /health-check`: Monitor live relayer and router availability (returns HTTP 200 OK).

## Model Context Protocol (MCP) Server

AI agents in Claude, Cursor, Windsurf, or VS Code can execute cross-chain swaps via the official Bridged MCP Server.

```json
{
  "mcpServers": {
    "bridged": {
      "command": "npx",
      "args": ["-y", "@bridged/mcp-server"]
    }
  }
}
```

Available Tools:
- `get_chains`: List all 57 supported blockchains with network IDs.
- `search_tokens`: Search token addresses by symbol, name, or contract on any chain.
- `get_swap_quote`: Get quotes with expected amounts, gas fees, and slippage bounds.
- `build_swap_tx`: Generate ready-to-sign calldata for user wallet approval.
- `track_tx_status`: Track real-time cross-chain settlement status by hash.

## Documentation Index

### Getting Started

- [Protocol Overview](https://bridged.finance/docs/getting-started/overview): Bridged Finance is a decentralized, non-custodial cross-chain interoperability protocol designed to move liquidity and execute arbitrary asset swaps across independent blockchain networks.
- [Developer Quickstart Guide](https://bridged.finance/docs/getting-started/quickstart): This guide walks you through integrating the Bridged Finance API to perform a cross-chain swap from start to finish.

### Bridged Cross-Chain API

- [API Endpoints Reference](https://bridged.finance/docs/api/endpoints): The Bridged Finance API provides high-performance, non-custodial cross-chain quote calculation, calldata generation, and transaction monitoring across 57+ blockchains.
- [Swap Workflow & Execution Lifecycle](https://bridged.finance/docs/api/swap-workflow): This document describes the complete technical lifecycle of a cross-chain swap executed via the Bridged Finance API.
- [Calldata & Token Approvals](https://bridged.finance/docs/api/calldata-and-approvals): This document outlines the security invariants, approval protocols, and calldata rules required for safely executing transactions with the Bridged Finance Protocol.
- [Token Address Formats Across Chains](https://bridged.finance/docs/api/token-address-formats): Except for native gas assets and Bitcoin, token addresses submitted to the Bridged Finance API are represented in standard EVM-style 0x... hexadecimal format.
- [Partner Fees & Attribution](https://bridged.finance/docs/api/partner-fees): The Bridged Finance API includes built-in mechanisms for integrators, wallets, and decentralized applications to track transaction volume and collect custom protocol fees on swaps.
- [Model Context Protocol (MCP) Server](https://bridged.finance/docs/api/mcp-server): The Bridged Model Context Protocol (MCP) Server connects AI agents, LLM applications, and coding assistants directly to 50+ blockchains and 6,000+ tokens. Through standard JSON-RPC over stdio or HTTP/SSE, agents can inspect token liquidity, calculate optimal cross-chain routes, verify balances, and autonomously execute swaps.

### Guides & Architecture

- [Cross-Chain Routing Engine Architecture](https://bridged.finance/docs/guides/cross-chain-swaps): The Bridged Finance Cross-Chain Routing Engine coordinates liquidity across isolated blockchains to deliver arbitrary token swaps in a single non-custodial transaction.
- [Native Bitcoin Cross-Chain Routing](https://bridged.finance/docs/guides/bitcoin-routing): Bridged Finance provides genuine, non-custodial swaps to and from Native Bitcoin (BTC). Users can exchange assets on Ethereum, Arbitrum, BNB Chain, Solana, and 50+ other networks directly for real satoshis on the Bitcoin blockchain without relying on synthetic or wrapped representations (such as WBTC, BTCB, or tBTC).
- [Slippage Tolerance & Distribution](https://bridged.finance/docs/guides/slippage-tolerance): In decentralized finance, slippage is the difference between the expected price of a trade and the actual execution price when the transaction confirms on-chain.
- [Security Audits & Threat Model](https://bridged.finance/docs/guides/security-and-audits): Security is the foremost design requirement of Bridged Finance. The protocol combines multi-firm external audits, formal contract verification, and multi-party computation to protect user liquidity.
- [Smart Contract Registry](https://bridged.finance/docs/guides/contract-registry): This registry provides the authoritative smart contract addresses deployed across all supported EVM blockchains.

### Support & FAQ

- [Frequently Asked Questions (FAQ)](https://bridged.finance/docs/faq/general-faq): Find answers to common questions about using and integrating the Bridged Finance cross-chain protocol.
- [Error Codes & Status Resolution](https://bridged.finance/docs/faq/error-codes-and-status): This guide provides error diagnostics, resolution steps, and status interpretations for integrating the Bridged Finance API.

## Supported Blockchains (57 Networks)

Ethereum (1), BNB Chain (56), Arbitrum One (42161), Base (8453), Polygon (137), Solana (5426), Bitcoin (3652501241), Avalanche (43114), Optimism (10), Linea (59144), Mantle (5000), Scroll (534352), Blast (81457), zkSync Era (324), TON (1100), Tron (728126428), Hyperliquid EVM (999), Gnosis (100), Taiko (167000), Sei (1329), Celo (42220), Cronos (25), Fantom (250), Metis (1088), Moonbeam (1284), Rootstock (30), Aurora (1313161554), Telos (40), Kava (2222), Core (1116), Merlin (4200), Botanix (3636), Boba (288), and 24 additional network gateways.

## Optional Links

- Web Application: https://bridged.finance/app
- Cross-Chain Explorer: https://bridged.finance/explorer
- Live System Status: https://bridged.finance/status
- Developer Portal: https://bridged.finance/devportal
- Documentation Hub: https://bridged.finance/docs
- Full Consolidated LLM Documentation: https://bridged.finance/llms-full.txt
- XML Sitemap: https://bridged.finance/sitemap.xml