Bitcoin Registry Orchestrates Like Yesterday (B.R.O.L.Y)

Order on Starknet, write on Bitcoin, get money trustlessly, repeat

Broly is a decentralized Bitcoin inscription service that uses Starknet for orderbook management and escrow. It enables trustless Bitcoin inscriptions with guaranteed payments through smart contracts.

Architecture

flowchart TB
    subgraph Frontend
        UI[React UI]
        BW[Bitcoin Wallet]
        SW[Starknet Wallet]
    end

    subgraph Backend
        API[REST API]
        DB[(Database)]
    end

    subgraph Starknet
        OB[Orderbook Contract]
        ES[Escrow Contract]
    end

    subgraph Bitcoin
        BTC[Bitcoin Network]
    end

    subgraph Inscribor
        IS[Inscription Service]
        OM[Order Monitor]
    end

    UI --> API
    UI <--> BW
    UI <--> SW
    API --> DB
    SW <--> OB
    SW <--> ES
    IS --> BTC
    OM --> OB
    OM --> ES
    API --> IS
    IS --> API

Flow

User connects both Bitcoin and Starknet wallets
User creates an inscription order:
- Specifies inscription content and reward amount
- Order is created on Starknet orderbook
- Funds are locked in escrow contract
Inscribor service:
- Monitors pending orders
- Creates Bitcoin inscriptions
- Triggers escrow release on successful inscription
User receives inscription, inscribor receives reward

Project Structure

broly/
├── apps/
│   ├── web/               # Frontend React application
│   └── backend/           # REST API service
├── packages/
│   ├── inscribor/         # Bitcoin inscription service
│   └── onchain/           # Starknet smart contracts
├── package.json
└── turbo.json

Technology Stack

Frontend:
- React + TypeScript
- Vite
- TailwindCSS
- Starknet.js
- BitcoinJS-lib
Backend:
- Node.js
- Express
- REST API
Smart Contracts:
- Cairo (Starknet)
- Scarb
Inscribor:
- Node.js
- BitcoinJS-lib
- Starknet.js

Getting Started

Install dependencies:

pnpm install

Start development environment:

pnpm dev

Components

Frontend (web)

Dashboard view for pending inscriptions
New inscription order form
Wallet connections (Bitcoin + Starknet)
Order status tracking

Backend (backend)

REST API for order management
Status tracking endpoints
Order history

Smart Contracts (onchain)

Orderbook contract
Escrow contract
Payment handling

Inscribor Service

Order monitoring
Bitcoin inscription creation
Transaction verification
Starknet interaction for escrow release

License

Broly is licensed under the MIT License. See the LICENSE file for details.

luvnft/broly