Rise Blackjack

Sub-second on-chain Blackjack powered by Rise Chain's 10ms block times

Rise Blackjack is a fully on-chain casino game that leverages Rise Chain's ultra-fast block production to deliver a seamless, Web2-like gaming experience while maintaining full transparency and provable fairness.

---

⚡ Powered by Rise Chain

Technology	Usage
Shreds	Real-time event streaming for live wins ticker and auto-refresh leaderboard
Fast VRF	Provably fair random card generation with sub-second response
Rise Wallet	Passkey-based authentication - no seed phrases, instant onboarding
Session Keys	Gasless gameplay - players never sign individual transactions

Shreds Integration

The frontend subscribes to on-chain GameEnded events via Shreds WebSocket:

• LiveWinsTicker - Shows real-time wins across all players
• LeaderboardPreview - Auto-refreshes when activity is detected
• < 100ms latency from on-chain event to UI update

---

📚 Documentation

Detailed documentation is available in the docs/ directory:

• 🗺️ Roadmap - Feature timeline and milestones
• 🏗️ System Architecture - Full system design and stack
• 🔒 Security Model - Session keys, VRF, audits
• 🪙 Tokenomics - CHIP token and staking
• ⚖️ Legal & Business - Revenue model and risks

---

🚀 Getting Started

Prerequisites

• Bun v1.1 or later
• Foundry
• Git

Installation

# Clone the repository
git clone https://github.com/edsphinx/risejack.git
cd risejack

# Install all dependencies
bun install

# Initialize Foundry dependencies (first time only)
cd packages/contracts
forge install
cd ../..

Environment Setup

# Copy environment template
cp .env.example .env

# Configure variables:
# - RISE_RPC_URL: Rise Chain RPC endpoint
# - PRIVATE_KEY: Deployer private key (for contract deployment)
# - CONTRACT_ADDRESS: Deployed Blackjack contract address

---

🛠 Development

Start All Services

# Start frontend and backend with Turborepo
bun run dev

Individual Workspaces

# Frontend (https://localhost:5173)
cd apps/web && bun run dev

# Backend (http://localhost:3000)
cd apps/api && bun run dev

Test Commands

cd packages/contracts
bun run test:defi         # Unit tests
bun run test:invariant    # Invariant tests
bun run test:fork         # Rise testnet fork

See Security Documentation for full testing details.

---

📂 Project Structure

risejack/
├── apps/
│   ├── web/                    # Frontend Application (Preact + Vite)
│   └── api/                    # Backend API (Hono + Bun)
├── packages/
│   ├── contracts/              # Smart Contracts (Foundry)
│   └── shared/                 # Shared Types & Utils
├── docs/                       # Project Documentation
├── turbo.json                  # Build pipeline
└── package.json                # Workspace configuration

---

💱 DeFi Integration (Uniswap V2)

The project uses official Uniswap V2 contracts deployed in separate repositories:

Repository	Purpose	Contracts
risecasinoswap/	AMM Core	UniswapV2Factory, UniswapV2Pair
risecasinorouter/	Periphery	UniswapV2Router02

Deployed Addresses (Rise Testnet)

# Check deployment-router-rise_testnet.json for current addresses
cat ../risecasinorouter/deployment-router-rise_testnet.json

CHIP/USDC Swap (1:1 Stablecoin Peg)

• CHIP is designed to trade at ~$1 (pegged to USDC via LP)
• Swaps available via in-app widget
• 0.3% swap fee (standard Uniswap)

---

---

License

This project is licensed under the Business Source License 1.1 (BSL).

• Change License: Apache 2.0 (effective 2028-04-01)
• Commercial Use: Restricted until the Change Date

See LICENSE for full details.

---

Author

Developed by @edsphinx

Built for Rise Chain | Powered by Bun | Secured by Foundry