DISTRICT9

v0.2.0

Autonomous meme token launcher on BNB Chain — sense trends, generate concepts, create logos, deploy tokens on-chain

1· 272· 1 versions· 0 current· 0 all-time· Updated 1mo ago· MIT-0
byPearl@pearl799

DISTRICT9 Agent Token Launcher

Autonomous meme token launcher on BNB Chain. Agents sense trending topics, generate meme concepts via LLM, create logos, and deploy tokens on-chain.

Requirements

  • Python 3.12 (uv managed)
  • BNB Chain wallet with BNB for gas
  • OpenRouter or OpenAI API key

Setup

cd {baseDir}
uv sync

Set environment variables:

export OPENCLAW_WALLET_KEY=0x_your_private_key
export OPENAI_API_KEY=sk-or-v1-your_openrouter_key

Initialize config:

cd {baseDir} && uv run openclaw init

Edit ~/.openclaw-agent/config.yaml:

agent:
  name: MyAgent
  chain: bnb
  wallet:
    private_key_env: OPENCLAW_WALLET_KEY

strategy:
  sources: [crypto, news]
  style: cultural
  risk_level: medium
  max_daily_launches: 3
  llm:
    provider: openrouter
    model: anthropic/claude-haiku-4.5
    api_key_env: OPENAI_API_KEY
    base_url: https://openrouter.ai/api/v1

launch:
  platform: district9
  initial_buy: '0.001'
  auto_generate_logo: true

runtime:
  scan_interval: 1800
  testnet: false

Commands

Use the exec tool, NOT the browser tool, to run these commands.

Dry Run (no actual launch)

cd {baseDir} && uv run openclaw dry-run

Start Agent

cd {baseDir} && uv run openclaw start

Check Status

cd {baseDir} && uv run openclaw status

Two Launch Modes

Mode A — FlapMode B — District9
PlatformFlap.sh VaultPortalD9Portal (self-owned)
Token Suffix0x...77770x...9999
Bonding Curve Fee1% (Flap) + 1% (D9)1% (D9 only)
Post-DEX Tax1% via SplitVault1% via SplitVault
Configplatform: flapplatform: district9

Set launch.platform in config to switch modes.

Architecture

Sensing --> Brain --> Creator --> Launcher
  |           |          |           |
  +- Crypto   +- Synth   +- Logo     +- FlapLauncher (Mode A)
  +- News     +- Eval    +- Meta     +- District9Launcher (Mode B)
  +- Trends

Contract Addresses (BNB Chain)

  • D9Portal: 0x65f1DC16D3821cD78E9517372b469a544b58DC76
  • SplitVault Impl: 0x25477CF486D84B8d10CE54f780fD80b51f8C320f
  • D9 Treasury: 0x9BAe1a391f979e92200027684a73591FD83C9EFD

Links

Version tags

latestvk97cab0h3yb2gr30e0c2qz6b218291bx

Runtime requirements

9️⃣ Clawdis
Binsuv
EnvOPENCLAW_WALLET_KEY
Primary envOPENCLAW_WALLET_KEY