charcoin-private-sale-bot

Python

Automated Python bot to manage and execute staged token sales for CHAR Coin private investors. Tracks real-time price, enforces sale stages, and performs on-chain swaps via Jupiter once conditions are met. Designed for post-launch supply control and fair distribution.

Last updated Jul 1, 2026

Stars

Forks

Issues

Stars/day

Attention Score

View on GitHub ↗ Open in github.dev

Topics

#blockchain #charcoin #cryptocurrency #defi #jupiter #python #solana #token-sale

Language breakdown

Python 100.0%

▸ Files click to expand

README

CharCoin Private Sale Bot

An automated Python bot to control and execute private sale token releases for CHAR Coin. Designed to enforce structured, price-based selling post-launch to protect token value and ensure fair distribution.

🚀 Features

Load investor wallet info, token allocation, and staking percentage
Multi-stage sell plan with customizable target prices
Sell in 20 fractions per stage for smoother release
Real-time price tracking (CoinGecko or Pyth)
On-chain swap execution via Jupiter Aggregator
Dry-run simulation and live execution modes
Secure handling of wallet private keys (encrypted JSON)

📁 Repository Structure

charcoin-private-sale-bot/
├── investors.json           # Investor wallet + stage config
├── private_keys.json        # Secure wallet key storage (never commit)
├── .env                     # API keys, Solana RPC
├── bot.py                   # Main bot logic
├── utils/
│   ├── pricing.py           # Price feed handlers
│   └── jupiter.py           # Swap execution via Jupiter
└── logs/                    # Execution logs

⚙️ Configuration

investors.json

[
     {
       "wallet": "InakiZubizarreta.sol",
       "total_tokens": 50400000,
       "staking_percentage": 0.30,
       "stages": [
         { "stagenumber": 1, "percentagetosell": 0.06, "targetprice_usd": 0.0024 },
         { "stagenumber": 2, "percentagetosell": 0.06, "targetprice_usd": 0.0030 }
       ]
     }
   ]

.env

RPC_URL=https://api.mainnet-beta.solana.com
   COINGECKOAPIKEY=yourapikey

private\_keys.json

{
     "InakiZubizarreta.sol": "private-key-string-here"
   }

🧪 Bot Modes

| Mode | Description | | --------- | ------------------------------------------------ | | dry-run | Simulates selling logic, no transactions sent | | live | Executes swaps on Jupiter when price targets hit |

📌 Example Log Output

✅ Stage 2 triggered at $0.0030 for InakiZubizarreta.sol
🔁 Selling 30240 CHAR in 20 parts (~1512 per swap)
✅ Remaining CHAR: 201600

🔐 Security Notice

Never commit or upload private_keys.json to any public repo.
Use per-investor wallets to limit exposure.
Production deployments should encrypt and lock access to key files.

📅 Development Timeline

✅ Phase 1: Simulation logic + CLI alerts
✅ Phase 2: Real price feeds + Jupiter integration
🔜 Phase 3: Admin dashboard / monitoring panel

🤝 Credits

Lead Developer: Nadir Ali Khan Bot Strategy & Oversight: Jorge Martinez Developed By: Team NAK (Blockchain | Automation | AI)

📄 License

MIT License — intended for internal use by the CharCoin Foundation.

🔗 More in this category