# ProofBridge

## Docs

- [Ads API: Create and Manage Liquidity Advertisements](https://docs.pfbridge.xyz/api/ads.md): Create, fund, update, and close ProofBridge liquidity advertisements. Ads are the on-chain liquidity pools that bridgers discover and trade against.
- [Authentication: Wallet-Based Sign-In for API Access](https://docs.pfbridge.xyz/api/authentication.md): Authenticate with ProofBridge using SIWE (EVM wallets) or SEP-10 (Stellar wallets). Exchange a signed challenge for JWT access and refresh tokens.
- [Chains API: Query Supported Blockchain Networks Info](https://docs.pfbridge.xyz/api/chains.md): Query supported chains and their smart contract addresses. Use these endpoints to discover which networks ProofBridge is deployed on.
- [API Reference: ProofBridge Relayer REST API Overview](https://docs.pfbridge.xyz/api/overview.md): Complete reference for the ProofBridge Relayer REST API. All endpoints are versioned under /v1/, require JSON bodies, and return JSON responses.
- [Routes API: Browse Supported Cross-Chain Token Pairs](https://docs.pfbridge.xyz/api/routes.md): Query ProofBridge cross-chain routes — the directional token pair mappings that define which tokens can be bridged between which chains.
- [Trades API: Manage the Cross-Chain Trade Lifecycle](https://docs.pfbridge.xyz/api/trades.md): Initiate cross-chain trades, retrieve order parameters, lock and unlock funds, and confirm on-chain actions through the ProofBridge Trades API.
- [Pre-auth MVP](https://docs.pfbridge.xyz/architecture/current-state.md): What ProofBridge looks like today: stateful pre-auth relayer, on-chain Poseidon2 MMR per chain, ZK-proof-gated unlocks, single-key admin.
- [Overview](https://docs.pfbridge.xyz/architecture/overview.md): How ProofBridge is built today, where it's going, and how each phase upgrades the trust model — with per-phase architecture diagrams.
- [BLS Auth](https://docs.pfbridge.xyz/architecture/phase-2-bls-auth.md): BLS-only authentication replaces the pre-auth relayer. Both parties sign the order once; one aggregated signature gates both unlocks.
- [Agents & Disputes](https://docs.pfbridge.xyz/architecture/phase-3-agents-disputes.md): Soroban custom-account agents under scoped policies, order deadlines and cancel paths, bonded disputes with arbiter resolution, multi-key BLS registry.
- [Mainnet](https://docs.pfbridge.xyz/architecture/phase-4-mainnet.md): Stellar + Ethereum mainnet, admin and arbiter handed off to multisigs, 24h timelock, protocol fee mechanism, USDC ↔ USDC launch route, reconciliation listener.
- [Follow-ups](https://docs.pfbridge.xyz/architecture/phase-5-followups.md): Post-mainnet roadmap: DAO governance for the arbiter, agent slashing, additional chains, RWA route partnerships, and protocol-level optimizations.
- [ProofBridge vs. other cross-chain bridges](https://docs.pfbridge.xyz/concepts/comparisons.md): Side-by-side comparison of ProofBridge against Allbridge, Wormhole, Stargate, and LayerZero across custody, validation, and settlement.
- [Decimal scaling across chains](https://docs.pfbridge.xyz/concepts/decimal-scaling.md): How ProofBridge moves value between tokens with different decimal representations without losing precision or trust.
- [Liquidity ads: how the ProofBridge marketplace works](https://docs.pfbridge.xyz/concepts/liquidity-ads.md): A liquidity ad is an on-chain offer from a Maker to provide cross-chain liquidity. Learn how ads are created, matched, and settled on ProofBridge.
- [Makers and Bridgers: understanding ProofBridge roles](https://docs.pfbridge.xyz/concepts/makers-and-bridgers.md): ProofBridge has two roles: Makers who provide cross-chain liquidity and Bridgers who transfer assets. Learn how each role works and how they interact.
- [Merkle Mountain Range: how deposits are recorded](https://docs.pfbridge.xyz/concepts/merkle-mountain-range.md): ProofBridge records every deposit in an append-only cryptographic structure called a Merkle Mountain Range, enabling efficient ZK inclusion proofs.
- [The canonical Order tuple and cross-chain digest](https://docs.pfbridge.xyz/concepts/order-hashing.md): ProofBridge uses a single EIP-712 Order tuple across EVM and Stellar so both chains compute the same digest by construction.
- [Supported networks, routes, and contract addresses](https://docs.pfbridge.xyz/concepts/supported-networks.md): ProofBridge is live on Ethereum Sepolia and Stellar Testnet, with more chains on the roadmap. View active routes and deployed contract addresses.
- [Zero-knowledge proofs for cross-chain verification](https://docs.pfbridge.xyz/concepts/zero-knowledge-proofs.md): ProofBridge uses zk-SNARKs as a succinct, on-chain-verifiable attestation that a deposit on one chain was correctly recorded — so the other chain can act on it directly, without trusting an oracle or validator set.
- [Run ProofBridge locally](https://docs.pfbridge.xyz/contribute/run-locally.md): Bootstrap the full ProofBridge stack on your machine — anvil, Stellar quickstart, postgres, relayer, contracts, and optional dev wallet funding — in a single command.
- [Bridge tokens across chains using ProofBridge transfers](https://docs.pfbridge.xyz/guides/bridge-tokens.md): Step-by-step guide to making a cross-chain transfer as a Bridger: browse liquidity ads, deposit funds, and receive destination tokens via ZK proof.
- [How to connect your wallet to ProofBridge securely](https://docs.pfbridge.xyz/guides/connect-wallet.md): Connect an EVM wallet (MetaMask or WalletConnect) or a Stellar wallet to ProofBridge and authenticate using a signed SIWE message.
- [Get testnet tokens from the ProofBridge faucet](https://docs.pfbridge.xyz/guides/faucet.md): Claim ERC-20 / SAC / SEP-41 test tokens directly in the ProofBridge app, per chain, for bridging and liquidity provision.
- [Integrate the ProofBridge SDK](https://docs.pfbridge.xyz/guides/integrate-the-sdk.md): How to integrate ProofBridge into your application — current REST API today, and the upcoming @proofbridge/sdk TypeScript package shipping with the mainnet release.
- [Managing your ProofBridge liquidity ads as a Maker](https://docs.pfbridge.xyz/guides/manage-ads.md): View, update, fund, withdraw from, and close your ProofBridge liquidity ads. Understand ad statuses and how to manage your capital as a Maker.
- [Provide liquidity and earn as a Maker on ProofBridge](https://docs.pfbridge.xyz/guides/provide-liquidity.md): Become a Maker: create liquidity ads on the destination chain, fund them with tokens, and earn source-chain assets when Bridgers complete transfers.
- [Track and monitor the status of your bridge orders](https://docs.pfbridge.xyz/guides/track-orders.md): Monitor a pending bridge transfer's status, understand order lifecycle states, find transaction hashes on both chains, and troubleshoot stuck orders.
- [How ProofBridge works](https://docs.pfbridge.xyz/how-it-works.md): The ProofBridge architecture, the 12-step cross-chain flow, and the role each component plays — from liquidity ads to ZK-verified settlement on both chains.
- [Introduction to ProofBridge: P2P Cross-Chain Bridge](https://docs.pfbridge.xyz/introduction.md): ProofBridge is a peer-to-peer cross-chain bridge secured by zero-knowledge proofs. Move assets across chains with no custodians or centralized relayers.
- [Quickstart: complete your first ProofBridge transfer](https://docs.pfbridge.xyz/quickstart.md): Connect your wallet and complete your first cross-chain transfer on ProofBridge in minutes. This guide walks you through the Bridger flow step by step.
- [Frequently asked questions about using ProofBridge](https://docs.pfbridge.xyz/reference/faq.md): Answers to common questions about ProofBridge: supported wallets, transfer times, fees, stuck transfers, token support, privacy, and future chains.
- [Off-chain signing: order digests and pre-auth requests](https://docs.pfbridge.xyz/reference/off-chain-signing.md): How to reproduce ProofBridge's on-chain order digest and pre-auth request hashes from JavaScript / TypeScript so your own tooling matches the contracts byte-for-byte.
- [Recipient address invariants](https://docs.pfbridge.xyz/reference/recipient-addresses.md): Per-chain rules for how recipient addresses are encoded inside the Order tuple, and the errors raised when they're wrong.
- [Roadmap](https://docs.pfbridge.xyz/reference/roadmap.md): How ProofBridge rolls out — from the pre-auth MVP to BLS auth, agent-managed liquidity, mainnet, and post-mainnet decentralization.
- [ProofBridge security model, proofs, and trust assumptions](https://docs.pfbridge.xyz/reference/security-model.md): Understand how ProofBridge protects your funds using EIP-712 signatures, ZK proofs, nullifiers, and on-chain Merkle trees — with no custodial risk.
- [ProofBridge smart contract reference and addresses](https://docs.pfbridge.xyz/reference/smart-contracts.md): Explore the four ProofBridge contracts, their key functions, deployed addresses on Ethereum Sepolia and Stellar Testnet, and the EIP-712 order structure.
- [Soroban verifier internals](https://docs.pfbridge.xyz/reference/soroban-verifier.md): How the ProofBridge Verifier contract on Stellar (Soroban) verifies UltraHonk proofs — exact BN254 host functions called, the verifier pipeline, the SRS used, and the open-source crate that implements the inner loop.
- [Why ProofBridge](https://docs.pfbridge.xyz/why-proofbridge.md): The problem with today's cross-chain bridges, and how ProofBridge's peer-to-peer, proof-based design fixes it.