Hakata Finance - Perpetuals Protocol

Monorepo for Hakata Finance's open‑source perpetual‑trading protocol on Solana.

Overview

Hakata Perpetuals is Core Perpetual Futures Engine for Real-World Asset Trading on Solana

Architecture Foundation

Hakata Finance is built on the proven foundation of solana-labs/perpetuals, Solana's reference implementation for perpetual futures trading. We've extended this battle-tested infrastructure specifically for Real-World Asset (RWA) trading.

Key Extensions:

• RWA oracle integration with traditional market hours handling
• Custom synthetic asset mechanisms for stocks/forex/commodities
• Enhanced risk management for TradFi asset volatility patterns
• Simplified UX layer optimized for cross-ecosystem trading

This approach allows us to focus innovation on the RWA layer while leveraging Solana's most robust perpetuals infrastructure.

Deployment Addresses

Hakata Finance is deployed on Solana Devnet.

The following programs are deployed:

Program	Address
Registry	CkawHJw5TVjUt1ggAZtuo3hgHBMptJHtxXk6A6nY5RWg

Repository Structure

hakata-perps/
├─ packages/
│  ├─ core/        # Anchor program(s) and on-chain Solana code
│  │  └─ README.md # Details about core implementation
│  └─ ui/          # Next.js front-end application
│     └─ README.md # UI development documentation
└─ README.md       # This file

Getting Started

Prerequisites

• Solana CLI tools
• Rust (latest stable version)
• Anchor Framework
• Node.js (for UI development)

Installation

1. Clone the repository

   git clone https://github.com/hakata-finance/hakata-perps
   cd hakata-perps

2. Install dependencies

   # For core development
   cd packages/core
   npm install
   
   # For UI development
   cd packages/ui
   npm install

3. See the individual READMEs in each package for specific setup instructions:

   • Core README
   • UI README
   • Architecture Documentation

Development

Running the UI locally

cd packages/ui
npm run dev

Then open http://localhost:3000 in your browser.

Testing the core

cd packages/core
npm test

Contributing

We welcome contributions to Hakata Finance's perpetual trading protocol!

1. Fork the repository and create a feature branch
2. Keep PRs focused on a single issue or feature
3. Include tests for any new functionality
4. Ensure your code adheres to the project's style guidelines
5. Submit a pull request with a clear description of the changes

For major changes or architectural decisions, please open an issue first to discuss.

License

This project is licensed under the Apache License 2.0.

Security

If you discover a security vulnerability in this project, please report it privately to admin@hakata.fi instead of opening a public issue.

Acknowledgments

This project builds upon solana-labs/perpetuals under the Apache 2.0 License.