compass-tss

Compass-TSS (CrossX)

A multi-party secure validation node for cross-chain transactions on mainnet.

Compass-TSS (CrossX) is forked from THORChain's Bifrost, adapted for the MAP Protocol ecosystem. It serves as a core component of cross-chain infrastructure, participating in cross-chain transaction validation through Threshold Signature Scheme (TSS) technology. Multiple CrossX nodes form a validation network that jointly signs and confirms cross-chain messages, ensuring secure and trustworthy asset transfers between different blockchains while eliminating single points of failure and private key exposure risks.

Supported Chains

Prerequisites

• Go 1.23.4+
• Access to chain RPC endpoints for the chains you want to monitor
• TSS bootstrap peers for joining the validator network

Configuration

Compass-TSS uses a default configuration file at config/default.yaml. Most settings can be overridden via environment variables.

See docs/configuration.md for the full environment variable reference.

Required Environment Variables

Before running, you must set the following environment variables:

# Chain RPC endpoints (at least one chain is required)
export BTC_HOST=<btc_rpc_host>
export ETH_HOST=<eth_rpc_host>
# ... see docs/configuration.md for all chains

Optional Environment Variables

# Block scanner retry backoff
export BLOCK_SCANNER_BACKOFF=<seconds>

# btc rpc auth
export BTC_USERNAME = ''
export BTC_PASSWORD = ''

# Start block heights
export BTC_START_BLOCK_HEIGHT=<height>
export ETH_START_BLOCK_HEIGHT=<height>

Build & Run

git clone https://github.com/mapprotocol/compass-tss.git
cd compass-tss/cmd/compass
go mod tidy
go build -o compass .
./compass

Command-Line Flags

Project Structure

compass-tss/
├── cmd/compass/     # Application entry point
├── blockscanner/    # Multi-chain block scanning
├── observer/        # Chain event observation
├── signer/          # Transaction signing
├── tss/             # TSS key management
├── p2p/             # P2P network communication
├── mapclient/       # MAP Relay Chain client
├── config/          # Default configuration (default.yaml)
├── common/          # Shared types and utilities
├── txscript/        # Transaction script handling (BTC/DOGE/LTC/BCH)
└── docs/            # Documentation

License

MIT