Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Overview

Budokan

Budokan is an onchain tournament system designed to power competitive gaming experiences on Starknet. It provides a robust, modular, and extensible framework for:

  • Creating and managing tournaments with flexible schedules and rules
  • Supporting a variety of entry requirements and fee structures
  • Handling prize pools and distribution (ERC20, ERC721, and custom tokens)
  • Integrating with embeddable game standards for seamless game onboarding
  • Real-time indexing via native Starknet events, REST API, and WebSocket subscriptions
  • TypeScript SDK with React hooks for rapid frontend integration

Launch App

Table of Contents

Contracts

Mainnet

ContractMainnet Address
Budokan0x0596ced030e74ebc37f33607f07ecd5a62eff22cdc4ae31fe2d724040c1bdc0b
BudokanViewer0x013c8239361fdbd7ec26db2c83f4ff270c5bba83a0bc105b4005b676ff57fdbe

Sepolia

ContractSepolia Address
Budokan0x017750a167b7c4968249d7db06dccc8b3908ef8954cb40cfe4d3c651ca0dcd1d
BudokanViewer0x03d5febe0042b943967074f4ebd850a6b5d50850cd3fb84fbd0eb66dadd9ddec

Entry Requirement Validators

Preset extension validators from metagame-extensions that are deployed and ready to use as the entry_requirement argument to create_tournament. See Entry Requirements → Available Validators for what each one does, and the Metagame Extensions reference for the underlying component model.

Mainnet

ContractMainnet Address
ERC20 Balance0x05b46bedc2134e6e5bb4b28301fd03bb6c8ccc33bd63cd831230ed8f16f460a9
Tournament0x03b8a0c224dc393b8ea8dd51fe691b298977b27bf9926e01dc37ccbb7e25bd40
Merkle0x0570d41b66f0eea3c342d570e456e51194817b8eb563dc580c63c2f3d6e505ec
Opus Troves0x0391111c6c51a83e8ab3bf3c632377424c76e42cff571ac2f2c424e6077f49a3

Sepolia

ContractSepolia Address
ERC20 Balance0x0717524e75b53bfa3ebfb0a16014d4e6b873a22d0e979d1bcd0a3f41bd0e3523
Tournament0x062b54188ee532026d3151e564db8668b3587266c8c73ad2fef68c19bfd3e57e
Merkle0x0094393c9516f3a0cb16fd56aaa558d94c2da20a2f5074fd15e6f2624b5daf43
Opus Troves0x05c75a4a48f1fe37cdd49766a2b4317f4ae57e87504ac8879f150c0686490e59

Key Features

  • Modular Architecture: Components for tournaments, games, schedules, and prizes can be extended or replaced.
  • Secure and Permissionless: Anyone can create or enter tournaments, with robust checks for entry requirements and prize claims.
  • Flexible Entry and Prize Logic: Supports entry fees, qualification proofs, and multiple prize types.
  • Leaderboard and Scoring: Built-in leaderboard management and score submission.

Use Cases

  • Esports tournaments for onchain games
  • Community competitions and challenges
  • Automated prize distribution for game events
  • Open standards for game developers to integrate with tournament infrastructure

Budokan is designed to be the backbone for provable, transparent, and fair onchain competitions, enabling new forms of player engagement and game design.