# ChainCash
🚀 **ChainCash** — A Python library for building crypto payment solutions on Binance Smart Chain (BEP20).
With ChainCash, you can easily create wallets for your users, monitor deposits (BNB & USDT), and process outgoing transactions asynchronously.
---
## ✨ Features
✅ Create unique wallets for each user
✅ Monitor incoming deposits with a callback mechanism
✅ Transfer BNB and USDT tokens
✅ Fully async, built on top of `AsyncWeb3`
✅ Default support for BSC Mainnet
---
## 📦 Installation
Install the package:
```bash
pip install chaincash
```
---
## 🔷 Requirements
- Python >= 3.9
## Usage/Examples
```python
from chaincash.core.blockchain_client import BlockchainClient
from chaincash.core.wallet_manager import WalletManager
from chaincash.core.monitor import Monitor
from chaincash.core.transfer_service import TransferService
# Initialize blockchain client
client = BlockchainClient()
# Create a wallet
wallet = WalletManager.create_wallet(user_id=1)
print(wallet)
# Monitor deposits
async def on_deposit(event):
print(f"📥 Deposit detected: {event}")
monitor = Monitor(client, address_map={1: wallet.address})
await monitor.start(on_deposit)
# Send BNB
transfer_service = TransferService(client, wallet.private_key)
await transfer_service.send_bnb(to_address="0x...", amount=0.1)
```
## 🤝 Contributing
Pull requests and issues are welcome!
If you have ideas, improvements, or bug reports — feel free to open a PR or issue. 🌟
## Support
For support, email noroozisaeed7@gmail.com.
## License
[MIT](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": "https://github.com/SaeedNoroozi/ChainCash",
"name": "chaincash",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "crypto, payments, bep20, web3, usdt, bnb",
"author": "Saeed Noroozi",
"author_email": "Saeed Noroozi <Noroozisaeed7@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/72/3f/518cf79fdb5043dd7be7056fd90db459b0cca5c50a0327ce4bfcd882aa60/chaincash-0.1.2.tar.gz",
"platform": null,
"description": "# ChainCash\r\n\r\n\ud83d\ude80 **ChainCash** \u2014 A Python library for building crypto payment solutions on Binance Smart Chain (BEP20). \r\n\r\nWith ChainCash, you can easily create wallets for your users, monitor deposits (BNB & USDT), and process outgoing transactions asynchronously.\r\n\r\n---\r\n\r\n## \u2728 Features\r\n\r\n\u2705 Create unique wallets for each user \r\n\u2705 Monitor incoming deposits with a callback mechanism \r\n\u2705 Transfer BNB and USDT tokens \r\n\u2705 Fully async, built on top of `AsyncWeb3` \r\n\u2705 Default support for BSC Mainnet\r\n\r\n---\r\n\r\n## \ud83d\udce6 Installation\r\n\r\nInstall the package:\r\n```bash\r\npip install chaincash\r\n```\r\n---\r\n\r\n## \ud83d\udd37 Requirements\r\n\r\n\r\n- Python >= 3.9\r\n\r\n## Usage/Examples\r\n\r\n```python\r\nfrom chaincash.core.blockchain_client import BlockchainClient\r\nfrom chaincash.core.wallet_manager import WalletManager\r\nfrom chaincash.core.monitor import Monitor\r\nfrom chaincash.core.transfer_service import TransferService\r\n\r\n# Initialize blockchain client\r\nclient = BlockchainClient()\r\n\r\n# Create a wallet\r\nwallet = WalletManager.create_wallet(user_id=1)\r\nprint(wallet)\r\n\r\n# Monitor deposits\r\nasync def on_deposit(event):\r\n print(f\"\ud83d\udce5 Deposit detected: {event}\")\r\n\r\nmonitor = Monitor(client, address_map={1: wallet.address})\r\nawait monitor.start(on_deposit)\r\n\r\n# Send BNB\r\ntransfer_service = TransferService(client, wallet.private_key)\r\nawait transfer_service.send_bnb(to_address=\"0x...\", amount=0.1)\r\n\r\n```\r\n\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nPull requests and issues are welcome!\r\nIf you have ideas, improvements, or bug reports \u2014 feel free to open a PR or issue. \ud83c\udf1f\r\n\r\n## Support\r\n\r\nFor support, email noroozisaeed7@gmail.com.\r\n\r\n\r\n## License\r\n\r\n[MIT](https://choosealicense.com/licenses/mit/)\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "ChainCash - Crypto payments library for BEP20",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/SaeedNoroozi/ChainCash"
},
"split_keywords": [
"crypto",
" payments",
" bep20",
" web3",
" usdt",
" bnb"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "53f9118288a0839f328359071f2243596976915739db9a2bd8da893787a610d4",
"md5": "62819642255068b50048afc85c253910",
"sha256": "e4c94cd62faaa3759c6fc4fada02c69054d925192746041fb8bcc1b0268b023c"
},
"downloads": -1,
"filename": "chaincash-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "62819642255068b50048afc85c253910",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 11670,
"upload_time": "2025-07-27T14:47:57",
"upload_time_iso_8601": "2025-07-27T14:47:57.915553Z",
"url": "https://files.pythonhosted.org/packages/53/f9/118288a0839f328359071f2243596976915739db9a2bd8da893787a610d4/chaincash-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "723f518cf79fdb5043dd7be7056fd90db459b0cca5c50a0327ce4bfcd882aa60",
"md5": "6eedf4b8e342490df1501a91b6b562eb",
"sha256": "5c99d29c08d634b33c67f0161abbd6c6cc3d20ba518c334a3a30fae4a0fc2d49"
},
"downloads": -1,
"filename": "chaincash-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "6eedf4b8e342490df1501a91b6b562eb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9663,
"upload_time": "2025-07-27T14:47:59",
"upload_time_iso_8601": "2025-07-27T14:47:59.207390Z",
"url": "https://files.pythonhosted.org/packages/72/3f/518cf79fdb5043dd7be7056fd90db459b0cca5c50a0327ce4bfcd882aa60/chaincash-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-27 14:47:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SaeedNoroozi",
"github_project": "ChainCash",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "chaincash"
}
JSON
