https://github.com/speedrun-hq/speedrun

Monorepo containing frontend, api and documentation for Speedrun
https://github.com/speedrun-hq/speedrun

cross-chain crypto intent nextjs react

Last synced: about 2 months ago
JSON representation

Monorepo containing frontend, api and documentation for Speedrun

• Host: GitHub
• URL: https://github.com/speedrun-hq/speedrun
• Owner: speedrun-hq
• Created: 2025-03-31T17:40:29.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-08-23T16:39:50.000Z (7 months ago)
• Last Synced: 2025-08-24T06:21:35.191Z (7 months ago)
• Topics: cross-chain, crypto, intent, nextjs, react
• Language: Go
• Homepage: https://speedrun.exchange/
• Size: 12.3 MB
• Stars: 4
• Watchers: 2
• Forks: 0
• Open Issues: 10
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Speedrun

A permissionless intent-based token transfer system built on ZetaChain that enables fast cross-chain transfers through incentivized third-party fulfillers.

This repository is a monorepo that contains the source for the following components of Speedrun:

- `api`: the backend that listens to and index intents for fulfillers

- `documentation`: general documentation for Speedrun

- `frontend`: the frontend interface for the Speedrun Exchange platform

- `landing-page`: landing page for Speedrun platform

## Overview

Speedrun is a novel cross-chain transfer system that leverages ZetaChain's infrastructure while providing faster transfer execution through a market-driven fulfillment mechanism. Users can initiate transfers with intent fees, allowing third-party agents (fulfillers) to execute transfers early on the destination chain in exchange for compensation.

### Key Features

- **Permissionless Fulfillment**: Anyone can participate as a fulfiller

- **Market-Driven Speed**: Faster transfers through incentivized early execution

- **Partial Fulfillment Support**: Multiple fulfillers can split a single transfer

- **Simple Interface**: Clean, intuitive web interface for transfer initiation

- **Extensible Architecture**: Ready for future features like intent-based swaps

## Smart Contracts

[Learn more about the smart contracts](https://github.com/speedrun-hq/contracts-core)

## Architecture

### Core Components

1. **Smart Contracts**

   - Intent-based transfers witht routing on ZetaChain

   - Smart contracts for each supported VMs

1. **Web Interface (React)**

   - Transfer initiation form

   - Real-time status tracking

   - Transaction history

1. **Backend API**

   - Intent registration

   - Fulfillment tracking

   - CCTX monitoring

1. **Fulfiller Tooling**

   - Intent scanning

   - Fulfillment execution

   - Fee calculation

### Workflow

1. **Transfer Creation**

   - User specifies:

     - Source Chain

     - Destination Chain

     - Token

     - Amount

     - Intent Fee

   - System creates CCTX and registers Intent ID

2. **Fulfillment Process**

   - Fulfillers monitor intents

   - Early execution on destination chain

   - Partial fulfillment support

   - Proportional fee distribution

3. **Reconciliation**

   - CCTX arrival processing

   - Fulfiller compensation

   - Original transfer completion

## Getting Started

### Prerequisites

- Node.js (v16 or higher)

- Go (v1.20 or higher)

- Access to ZetaChain network

## Fee Structure

- **Intent Fee**: Set by the platform (configurable)

- **Fulfiller Compensation**: Proportional to fulfilled amount

- **Refund Policy**: Full refund if no fulfillment occurs