← Back to Skills Marketplace
pearl799

DISTRICT9

by Pearl · GitHub ↗ · v0.2.0
cross-platform ⚠ suspicious
272
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install district9
Description
Autonomous meme token launcher on BNB Chain — sense trends, generate concepts, create logos, deploy tokens on-chain
README (SKILL.md)

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 — Flap Mode B — District9
Platform Flap.sh VaultPortal D9Portal (self-owned)
Token Suffix 0x...7777 0x...9999
Bonding Curve Fee 1% (Flap) + 1% (D9) 1% (D9 only)
Post-DEX Tax 1% via SplitVault 1% via SplitVault
Config platform: flap platform: 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

Usage Guidance
This skill will ask you to provide a raw private key (OPENCLAW_WALLET_KEY) and an LLM API key, then use them to create, upload, and deploy real tokens and make on-chain purchases. Before installing or running: - Do not use a mainnet/private-key with real funds. Test on BNB testnet or use an ephemeral wallet with minimal balance. - Inspect and understand the hardcoded tax behavior: 0.5% goes to a DISTRICT9 treasury address (hardcoded) and 0.5% to the agent — this is non-configurable and benefits the project author. If you don't consent to that revenue routing, do not use the skill. - The registry metadata omits the LLM API key requirement and there is no explicit install spec for Python dependencies; expect to run 'uv' to pull packages — review pyproject.toml and installed packages before running. - Review all network endpoints (RPC URLs, FLAP_UPLOAD_API, D9_BASE_URL) and confirm you trust them — the skill uploads metadata and images to an external IPFS endpoint and calls third-party LLM/image APIs. - If you decide to test, run in dry-run mode first and on testnet. Consider using a separate wallet/hardware wallet or multisig for any real deployment and monitor any outgoing network requests and transactions. Given the sensitive operations and undeclared mismatches, proceed only if you understand the financial and security risks and are willing to accept the hardcoded revenue split.
Capability Analysis
Type: OpenClaw Skill Name: district9 Version: 0.2.0 The bundle is a functional autonomous meme token launcher for the BNB Chain. It uses standard libraries (web3.py, openai, requests) to aggregate market signals, generate token concepts via LLMs, and deploy smart contracts. While it contains hardcoded credentials and API keys in the proof-of-concept scripts (poc/d9_launch.py and poc/flap_poc.py), these appear to be test artifacts rather than intentional malware. The core logic includes a hardcoded 1% transaction tax split (50% to the platform treasury, 50% to the agent owner), which is a transparently documented feature of the District9 platform's revenue model. No evidence of secret exfiltration or unauthorized remote control was found.
Capability Assessment
Purpose & Capability
The name/description (autonomous meme token launcher on BNB) aligns with the included Python code which senses trends, generates concepts, creates logos, uploads metadata, and deploys tokens. Required binary 'uv' matches the documented 'uv sync' workflow. However, the registry metadata only lists OPENCLAW_WALLET_KEY while SKILL.md and the code also require an LLM API key (OPENAI_API_KEY / OpenRouter) and many Python libraries — this environment/installation mismatch is unexpected.
Instruction Scope
SKILL.md instructs you to export a raw private key (OPENCLAW_WALLET_KEY) and an LLM API key and to run 'uv sync' and 'uv run openclaw start'. The code will read ~/.openclaw-agent/config.yaml, connect to remote RPC endpoints, upload metadata/images to an external IPFS endpoint (FLAP_UPLOAD_API), call LLM/image APIs, and sign/send on-chain transactions using the provided private key. These runtime actions go beyond passive analysis: they perform irreversible on-chain operations and external network uploads, which is coherent with the stated purpose but dangerous if you provide a real private key. Also the SKILL.md grants the agent autonomy (start/run) and suggests using the exec tool to run shell commands; the instructions are not vague but they instruct risky actions that users must consciously accept.
Install Mechanism
There is no install spec despite a sizable Python codebase listing dependencies (web3, eth-account, requests, openai/anthropic support, eth_abi, etc.). The skill expects 'uv' to run dependency sync, but the registry only declares 'uv' as a required binary — the lack of an explicit install specification in the registry is an inconsistency and increases risk because required packages and their versions aren't enumerated by the registry metadata.
Credentials
The primary required credential (OPENCLAW_WALLET_KEY) is expected and necessary for deploying and signing transactions, but it is highly sensitive. The registry metadata omits the LLM API key env (the SKILL.md and code expect OPENAI_API_KEY / OpenRouter key resolved via config), which is an undeclared requirement. Additionally, the code includes hardcoded revenue mechanics (DISTRICT9_TREASURY address and forced tax split) that route 0.5% of tax revenue to a fixed treasury and 0.5% to the agent wallet — this is a non-obvious, non-configurable financial behavior that materially affects users' deployed tokens.
Persistence & Privilege
The skill does not request always:true and doesn't modify other skills or system-wide configuration. It creates temporary files (logo images) and writes nothing to other skills' configs. Autonomous invocation is allowed (default) but is expected for an agent that runs continuously; no elevated persistence flags are present.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install district9
  3. After installation, invoke the skill by name or use /district9
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
district9 0.2.0 - Adds detailed setup and configuration instructions in the new SKILL.md. - Explains dual launch modes (Flap and District9) with clear platform, fee, and config differences. - Includes requirements, environment setup, architecture overview, and contract addresses. - Lists key commands for agent operation. - Provides project homepage and GitHub links.
Metadata
Slug district9
Version 0.2.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is DISTRICT9?

Autonomous meme token launcher on BNB Chain — sense trends, generate concepts, create logos, deploy tokens on-chain. It is an AI Agent Skill for Claude Code / OpenClaw, with 272 downloads so far.

How do I install DISTRICT9?

Run "/install district9" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is DISTRICT9 free?

Yes, DISTRICT9 is completely free (open-source). You can download, install and use it at no cost.

Which platforms does DISTRICT9 support?

DISTRICT9 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created DISTRICT9?

It is built and maintained by Pearl (@pearl799); the current version is v0.2.0.

💬 Comments