xmr-btc-swap/AGENT.md
2025-05-26 21:05:28 +02:00

2.5 KiB
Raw Blame History

Repo Overview

This repository hosts the core of the UnstoppableSwap project. The code base is a Rust workspace with multiple crates and a Tauri based GUI.

Important directories

  • swap/ contains the main Rust crate with two binaries:
    • swap command line interface for performing swaps.
    • asb Automated Swap Backend for market makers. It also hosts library code shared between the binaries and integration tests.
  • src-tauri/ Rust crate that exposes the swap functionality to the Tauri front end and bundles the application.
  • src-gui/ The frontend written in TypeScript/React and bundled by Tauri. Communicates with src-tauri via Tauri commands.
  • monero-rpc/ and monero-wallet/ helper crates for interacting with the Monero ecosystem.
  • docs/ Next.js documentation site.
  • dev-docs/ additional markdown documentation for CLI and ASB.

Frequently edited files

Looking at the latest ten pull requests in git log, the following files appear most often:

File Times Changed
src-tauri/Cargo.toml 7
Cargo.lock 7
CHANGELOG.md 7
swap/Cargo.toml 6
src-tauri/tauri.conf.json 5
.github/workflows/ci.yml 3

Other files such as swap/src/bin/asb.rs, swap/src/cli/api.rs, and src-gui/package.json showed up less frequently.

Component interaction

  • The swap crate implements the atomic swap logic and provides a CLI. The binaries under swap/src/bin (swap.rs and asb.rs) start the client and maker services respectively.
  • src-tauri wraps the swap crate and exposes its functionality to the GUI via Tauri commands. It also bundles the application with the src-gui assets.
  • src-gui is the TypeScript/React interface. It communicates with the Rust back end through the commands defined in src-tauri.
  • Helper crates like monero-rpc and monero-wallet provide abstractions over external services. They are used by the swap crate to interact with Monero.
  • Continuous integration and release workflows live in .github/workflows. They build binaries, create releases and lint the code base.

Pull request titles

Use descriptive titles following the <type>(<scope>): <description> format. Examples include:

  • feat(gui): New feature
  • fix(swap): Issue fixed
  • refactor(ci): Ci changes