Skip to content

yash0501/1inch-tezos

BranchesTags

Repository files navigation

Tezra

Category: DeFi
Emoji: 😎
Demo: https://hackathon.project.io

Short Description

Tezra: The first trustless portal between Ethereum and Tezos ecosystems 🌉

Overview

Tezra is a cross-chain DeFi protocol that enables trustless, atomic swaps between Ethereum and Tezos. Users can securely exchange assets across both ecosystems without relying on centralized bridges or custodians. Tezra leverages advanced smart contracts and a resolver mechanism to ensure swaps are either completed on both chains or safely refunded, eliminating counterparty risk.

Table of Contents

Key Features

  • Atomic Swaps: Uses hash time-locked contracts (HTLCs) and a resolver for true cross-chain atomicity.
  • Ethereum ↔ Tezos: Swap tokens between Ethereum (including ERC-20s) and Tezos (XTZ), supporting both native and token assets.
  • Non-Custodial: Users always control their funds; no third party ever holds user assets.
  • Open Source & Auditable: All smart contracts and backend code are public for maximum transparency.
  • Modern UI: Inspired by leading DeFi protocols, with a smooth, intuitive user experience.
  • Robust Security: Safety deposits, time locks, and on-chain validation protect against malicious actors and failures.
  • Extensible: Designed for future multi-chain support.

Architecture

Tezra is a full-stack protocol with the following components:

  • Smart Contracts:
    • Ethereum (Solidity): Escrow contracts (EscrowSrc, EscrowDst) using OpenZeppelin, 1inch Limit Order Protocol, and HTLCs.
    • Tezos (SmartPy/Michelson): Escrow contract in SmartPy, mirroring Ethereum logic.
  • Backend Resolver:
    • Node.js/TypeScript: Orchestrates swaps, deploys escrows, monitors funding, and triggers secret revelation.
  • Frontend:
    • React + Next.js + TailwindCSS: Modern SPA for user interaction, wallet connection, and swap flow.
  • SDKs & Libraries:
    • @1inch/cross-chain-sdk, Ethers.js, Taquito: For blockchain interactions and cross-chain logic.

How Tezra Works (Step-by-Step)

1. User Connects Wallets

  • The user connects their Ethereum wallet (MetaMask) and Tezos wallet (Temple/Beacon/Kukai) via the frontend.
  • The frontend verifies connections and displays balances.

2. Order Creation

  • The user specifies the asset, amount, and destination address for the swap.
  • The frontend generates a random secret and computes its hash (hashlock).
  • An order object is created and signed by the user using EIP-712 (on Ethereum).

3. Order Submission

  • The signed order is sent to the backend resolver.
  • The resolver validates the order and deploys the source escrow contract on Ethereum using the 1inch Limit Order Protocol.
  • The resolver also prepares the destination escrow contract for Tezos.

4. Escrow Deployment

  • On Ethereum, the source escrow contract is deployed and funded by the user (locking their tokens).
  • On Tezos, the resolver deploys and funds the destination escrow contract (locking the resolver's tokens).

5. Funding Verification

  • The backend monitors both chains to ensure both escrows are funded.
  • The frontend displays real-time status updates to the user.

6. Secret Revelation

  • Once both escrows are funded, the user reveals the secret via the frontend.
  • The secret is submitted to both contracts:
    • On Tezos, the user withdraws their tokens from the destination escrow using the secret.
    • On Ethereum, the resolver uses the revealed secret to withdraw the user's tokens from the source escrow.

7. Settlement or Refund

  • If the swap completes successfully, both parties receive their assets.
  • If any party fails to fund or reveal the secret in time, the contracts allow for refunds after a timeout, ensuring no funds are lost.

Project Structure

backend/
  src/
contracts/
  ethereum/
    compiled/
    interfaces/
    libraries/
    BaseEscrow.sol
    Escrow.sol
    EscrowDst.sol
    EscrowSrc.sol
  solidity-utils/
    contracts/
      interfaces/
      libraries/
      mixins/
      mocks/
      tests/
  tezos/
    compiled/
    EscrowFactory_v2.py
    EscrowFactory.py
    EscrowFactoryAdvanced.py
    EscrowSrc.py
  package.json
swap-ui/
  app/
    components/
    resolver/
    globals.css
    layout.tsx
    page.tsx
  public/
.env.example

Requirements

  • Node.js (v18+ recommended): For backend and frontend development.
  • Yarn or npm: For managing JavaScript/TypeScript dependencies.
  • Python 3.8+: For SmartPy (Tezos contract development).
  • SmartPy CLI: For compiling and testing Tezos contracts.
  • Hardhat: For Ethereum contract development and testing.
  • MetaMask: For Ethereum wallet connection in the frontend.
  • Temple/Beacon/Kukai: For Tezos wallet connection in the frontend.
  • Docker (optional): For running local blockchain nodes (Ethereum/Tezos) for full local testing.

Setup & Installation

  1. Clone the repository:

    git clone https://github.com/yash0501/1inch-tezos.git
cd tezra

  2. Install backend dependencies:

    cd backend
npm install

  3. Install frontend dependencies:

    cd ../../swap-ui
npm install

  4. Ethereum and Tezos contract compilation: Compiled contracts bytecode is present in /contracts/ethereum/compiled and /contracts/tezos/compiled

  5. Configure environment variables:

    • Copy .env.example to .env in both /swap-ui and /backend and fill in the required values (RPC URLs, private keys, etc).

Building & Running Locally

  1. Run the backend resolver:

    cd ../../backend
npm start

    Server started on http://localhost:3000

  2. Run the frontend:

    cd ../../swap-ui
npm run dev

    Open http://localhost:3000 in your browser.

Notable Integrations

  • 1inch Limit Order Protocol: Used for secure, non-custodial order matching and settlement on Ethereum.
  • OpenZeppelin: For secure contract patterns and utilities.
  • Taquito & Beacon: For seamless Tezos wallet integration and contract interaction.
  • @1inch/cross-chain-sdk: For order creation, signing, serialization, and hashlock management.

Why we are applying for the 1inch prize

Tezra's innovative use of the 1inch Limit Order Protocol for cross-chain atomic swaps exemplifies the future of DeFi interoperability. Our protocol not only enhances liquidity access across Ethereum and Tezos but also sets a foundation for multi-chain DeFi ecosystems. By participating in the 1inch prize, we aim to further refine our integration, contribute to the 1inch community, and accelerate the advent of a truly interconnected blockchain finance landscape.

Join us in bridging the Ethereum and Tezos ecosystems!

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages