{"id":31589435,"url":"https://github.com/abba-platforms/cillar","last_synced_at":"2025-10-06T02:52:54.924Z","repository":{"id":301562051,"uuid":"1009639608","full_name":"abba-platforms/cillar","owner":"abba-platforms","description":"CillarCoin ($CILLAR) is a programmable BEP-20 utility token powering fare payments and seamless ticketing for AfrailX and ArailX smart mobility networks via the Abba App. It features audited smart contracts for fares, rewards, refunds, KYC, vesting, and CO₂ tracking — built for scale deployment and governed by Cillar DAO at https://cillar.org.","archived":false,"fork":false,"pushed_at":"2025-09-13T15:30:29.000Z","size":1134,"stargazers_count":13,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-13T15:34:16.000Z","etag":null,"topics":["abba-platforms","bnb-smart-chain","cillar","cillarcoin","erc20","fintech","mobility","payments","ticketing-system","token","transportation","utility-token","web3"],"latest_commit_sha":null,"homepage":"https://cillar.io/","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abba-platforms.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":"AUDIT.md","citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-27T13:11:49.000Z","updated_at":"2025-09-13T15:30:32.000Z","dependencies_parsed_at":"2025-07-16T22:25:08.039Z","dependency_job_id":"c682a6c7-5987-46a5-9e28-f5a3a0283f9f","html_url":"https://github.com/abba-platforms/cillar","commit_stats":null,"previous_names":["abba-platforms/cillar"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/abba-platforms/cillar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba-platforms%2Fcillar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba-platforms%2Fcillar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba-platforms%2Fcillar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba-platforms%2Fcillar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abba-platforms","download_url":"https://codeload.github.com/abba-platforms/cillar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abba-platforms%2Fcillar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278551493,"owners_count":26005388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["abba-platforms","bnb-smart-chain","cillar","cillarcoin","erc20","fintech","mobility","payments","ticketing-system","token","transportation","utility-token","web3"],"created_at":"2025-10-06T02:52:51.831Z","updated_at":"2025-10-06T02:52:54.897Z","avatar_url":"https://github.com/abba-platforms.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CillarCoin Utility Token (CILLAR)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) ![Built with Solidity](https://img.shields.io/badge/built%20with-Solidity-363636) ![ERC-20 Compliant](https://img.shields.io/badge/ERC--20-Compliant-brightgreen) [![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](SECURITY.md)\n![LP Locked ✅](https://img.shields.io/badge/LP-Locked%20for%2060%20Months-brightgreen)\n\n## Liquidity Pool (LP) Lock\n\nThe CILLAR team has locked all PancakeSwap V2 LP tokens for the **CILLAR/WBNB** pair for **60 months (5 years)** using [Unicrypt](https://app.unicrypt.network/), a trusted decentralized liquidity locking platform. This ensures long-term market stability and guarantees that liquidity cannot be withdrawn prematurely, while allowing investors to continue trading normally.  \n\nFor full details, verification links, and a statement of our team’s commitment to the CILLAR ecosystem, see the dedicated documentation:  \n📄 [CILLAR/WBNB LP Lock Documentation](docs/CILLAR_WBNB_LP_LOCK.md)\n\n----------\n\n## 🚀 Initial Exchange Offering (IEO) on P2B Exchange\n\nCillarCoin is launching its Initial Exchange Offering (IEO) on [P2B Exchange](https://p2pb2b.com), one of the leading global crypto platforms. The IEO will feature an allocation of **2,500,000,000 $CILLAR tokens** at **$0.15 USD per token**, aiming to raise **$375 million USD** to support AfrailX™ and ArailX™ smart mobility deployment, liquidity, staking, and DAO treasury.\n\n\u003e All IEO participants will be eligible to vote in the [Cillar DAO](https://cillar.org) and access smart mobility platforms (AfrailX \u0026 ArailX) via [Abba App](https://abbapp.com).\n\n📖 [View Full IEO Details](./IEO.md)\n\n----------\n\n## 📄 IEO Allocation Plan\n\nView the full breakdown of the $375 million funding allocation from the upcoming $CILLAR IEO:\n\n➡️ [View IEO Allocation Plan](./IEO_ALLOCATION_PLAN.md)\n\n### 📘 CillarCoin IEO FAQ\n\nGet answers to the most common questions about our Initial Exchange Offering (IEO).  \n[View IEO FAQ →](./IEO_FAQ.md)\n\n----------\n\n### 🥞 Buy on PancakeSwap\n\nSwap BNB for $CILLAR via PancakeSwap:  \n🔗 [https://pancakeswap.finance/swap?outputCurrency=0x4364a697bB204C8239b40d038F500971f6fe4D37](https://pancakeswap.finance/swap?outputCurrency=0x4364a697bB204C8239b40d038F500971f6fe4D37)\n\n🔐 **Verified Contract on BscScan**: [0x4364a697bB204C8239b40d038F500971f6fe4D37](https://bscscan.com/token/0x4364a697bB204C8239b40d038F500971f6fe4D37)\n\n----------\n\n## What's CillarCoin?\n\n**CillarCoin** ($CILLAR) is a programmable BEP-20 utility token created and developed by **Simon Kapenda**, the creator of **Abba App**, and maintained by **Abba Platforms Inc.** It is built to facilitate transit fare payments on **AfrailX** and **ArailX** smart mobility systems exclusively through the **Abba App**.\n\nCillarCoin is designed to enable secure, flexible, and user-centric mobility payments within a decentralized infrastructure ecosystem, with future support for **community governance via DAO mechanisms** over key parameters such as rewards, pricing, and treasury allocation. See Cillar DAO website at cillar.org.\n\n----------\n\n## 🚇 Purpose\n\nCillarCoin is designed to:\n\n-   Pay for transit rides via Abba App on AfrailX and ArailX smart mobility systems\n-   Earn ride rewards and loyalty bonuses\n-   Enable regional, children and senior fare discounts\n-   Track ride-based CO₂ emissions savings\n-   Allow refundable transactions within defined windows\n-   Support KYC-based user eligibility\n\nThese smart mobility systems—AfrailX in Africa and the Middle East, and ArailX in the U.S. and beyond—represent the future of clean, efficient, and scalable urban transit. CillarCoin enables seamless payments across these networks through a unified token ecosystem.\n\n----------\n\n### Implementation Roadmap\n\nFor the detailed CillarCoin implementation roadmap, see the [ROADMAP](./ROADMAP.md) document.\n\n----------\n\n## 📄 Smart Contracts – LP Staking \u0026 Utility\n\nThis repository now includes the upgraded LP staking contract for $CILLAR:\n\n### CillarLPStakingV2.sol\n\n-   Upgraded LP staking contract with multisig governance, reward pool safety, timestamp-based staking, and early-bird bonus rewards.\n-   Fully audit-ready, mainnet-safe, and designed to encourage LP participation while maintaining transparency and investor confidence.\n-   Preserves original deposit, withdraw, pending reward calculation, and emergency withdrawal functionality.\n\nFor deployment instructions, see [`CillarLPStakingV2.sol`](contracts/CillarLPStakingV2.sol) and usage details in the README.\n\n----------\n\n## Documentation\n\n-   [Whitepaper](docs/WHITEPAPER.md)\n-   [Infrastructure \u0026 DAO Plan](docs/CILLARCOIN.md)\n-   [Initial Exchange Offering (IEO)](IEO.md)\n-   [IEO Demand Summary](docs/IEO_Demand_Summary.md)\n-   [IEO Allocation Plan](./IEO_ALLOCATION_PLAN.md)\n-   [IEO FAQ](./IEO_FAQ.md)\n-   [Technical Architecture](docs/ARCHITECTURE.md)\n-   [Token Analysis](docs/ANALYSIS.md)\n-   [Token Allocation](docs/ALLOCATION.md)\n-   [CILLAR–NADD Synergy Framework](docs/CILLAR_NADD_SYNERGY_FRAMEWORK.md)\n-   [Vesting Plan](docs/VESTING_PLAN.md)\n-   [CillarCoin Development Roadmap](docs/ROADMAP.md)\n-   [CillarCoin Implementation Roadmap](ROADMAP.md)\n-   [Audit Log \u0026 Status](AUDIT.md)\n-   [Release Notes](RELEASE_NOTES.md)\n\n----------\n\n## 🚀 Deployment (Mainnet)\n\nThe CillarCoin contract has been deployed and verified on BNB Smart Chain Mainnet.  \nDetails available in [`deployed-contracts/`](./deployed-contracts/README.md).\n\n🔗 [View on BscScan](https://bscscan.com/address/0x4364a697bB204C8239b40d038F500971f6fe4D37#code)\n\n----------\n\n## 📷 Branding\n\nOfficial CillarCoin branding assets including logos and tokens are located in the [`branding`](branding/) directory.\n\n### CillarCoin Token\n\nHere is the official CillarCoin Token — available in the [`branding`](branding/) folder:\n\n![CillarCoin Token – Primary](branding/cillar-token-primary.jpg) ![CillarCoin Token – Angled](branding/cillar-token-left.jpg)\n\n### 🪙 Cillar Mascot (Official Robot Character)\n\nThe official CillarCoin futuristic robot mascot is now part of the brand identity. This character represents automation, mobility, and precision within the Cillar ecosystem.\n\n![Cillar Robot](branding/Cillar_Futuristic_Robot_Figure.jpg)\n\nFile: `Cillar_Futuristic_Robot_Figure.jpg`\n\n### 🪙 CillarCoin Logo\n\nHere are the official CillarCoin Logos — available in the [`branding`](branding/) folder:\n\nPreview\n\nFile\n\n![](branding/cillar-logo-white-on-blue.jpg)\n\n`cillar-logo-white-on-blue.jpg`\n\n![](branding/cillar-logo-black-on-white.jpg)\n\n`cillar-logo-black-on-white.jpg`\n\n![](branding/cillar-logo-with-text.jpg)\n\n`cillar-logo-with-text.jpg`\n\n----------\n\n## 📄 Whitepaper\n\nFor full technical and economic details about CillarCoin, please refer to the [WHITEPAPER.md](docs/WHITEPAPER.md).\n\nThe whitepaper explains the purpose, utility, architecture, smart contract logic, deployment roadmap, and how CillarCoin integrates with AfrailX™, ArailX™, and the Abba App ecosystem.\n\n----------\n\n### 📄 CillarCoin Ecosystem – Infrastructure \u0026 Use Case Expansion Plan\n\nA comprehensive, production-grade whitepaper detailing the technical, economic, and governance architecture of **CillarCoin ($CILLAR)** — a non-speculative BEP-20 utility token built on BNB Smart Chain. Designed specifically to power AfrailX and ArailX smart transit systems, CillarCoin extends beyond mobility to support smart city services, education credits, local governance, and decentralized marketplaces across Africa and beyond.\n\n**Key Highlights:**\n\n-   Built-in reward, refund, and compliance logic\n-   Region-customized smart contracts (FareRegistry, DAOManager, etc.)\n-   Civic-focused DAO governance with non-transferable voting tokens\n-   Progressive rollout model aligned with real-world infrastructure readiness\n-   Visionary path to become Africa’s first decentralized civic utility currency\n\n\u003e This document serves as the blueprint for scaling blockchain-backed urban infrastructure, helping governments, NGOs, and enterprises deploy programmable public services with real-world impact.\n\nRead the whole document: [CILLARCOIN.md](docs/CILLARCOIN.md)\n\n## 📄 Analysis\n\nFor a deep technical and ecosystem evaluation of CillarCoin, read the [ANALYSIS.md](docs/ANALYSIS.md).\n\nThe analysis covers architecture, token security, contract logic, vesting structure, rewards, regional fare logic, benefits to holders, and alignment within the AfrailX™, ArailX™, and Abba App ecosystem.\n\n----------\n\n## CILLAR–NADD Synergy Framework\n\nWe’ve documented the integration between **CillarCoin ($CILLAR)** and **NADD (Namibia Digital Dollar)** in detail. The framework explains token flow, operational synergy, and real-world use cases.\n\n- **Framework Documentation:** [CILLAR_NADD_SYNERGY_FRAMEWORK.md](docs/CILLAR_NADD_SYNERGY_FRAMEWORK.md)\n- **Diagram:** ![CILLAR–NADD Framework Diagram](assets/cillar_nadd_diagram.jpg)\n\nThis section provides developers, stakeholders, and ecosystem partners with a visual and textual reference for understanding the CILLAR–NADD system.\n\n----------\n\n## 🔗 Ecosystem Integration\n\nComponent\n\nRole\n\n**AFRX Token**\n\nInvestor-grade security token for infrastructure funding\n\n**CILLAR Token**\n\nUtility token for riders to pay fares in Abba App\n\n**Abba App**\n\nUser-facing payment app integrated with smart contracts\n\n**AfrailX / ArailX**\n\nSmart mobility systems operating in target cities\n\n----------\n\n## 🧱 Smart Contracts\n\nThis repository contains the following contracts:\n\n-   `CillarCoin.sol` – Main token contract with reward, refund, and KYC logic\n-   `FareRegistry.sol` – Region-based fare and pricing logic\n-   `CillarVesting.sol` – Treasury and vesting logic for long-term supply control\n\n----------\n\n## 🛠 Features\n\n-   ✅ KYC enforcement\n-   ✅ Fare reward system (e.g. every 20 rides)\n-   ✅ Refundable fares within a 48-hour window\n-   ✅ Operator fee forwarding to treasury\n-   ✅ Configurable regional fares and senior discounts\n-   ✅ CO₂ savings tracker\n-   ✅ Subscription tracking\n\n----------\n\n## 💡 Tokenomics\n\n-   **Token Name**: CillarCoin\n-   **Ticker**: CILLAR\n-   **Max Supply**: 100,000,000,000 CILLAR\n-   **Total Supply**: 40,000,000,000 CILLAR\n-   **Founder's Allocation**: 25,000,000,000 CILLAR (25%) to be distributed gradually\n-   **IEO Allocation**: 2,500,000,000 CILLAR\n-   **Initial Mint**: 15,000,000,000 CILLAR (15%) minted and live on-chain\n\n### Distribution Plan\n\nCategory\n\nAllocation\n\nPublic Treasury\n\n45%\n\nFounders \u0026 Team\n\n30%\n\nEcosystem \u0026 Rewards\n\n15%\n\nVesting Reserve\n\n10%\n\n----------\n\n## 📦 Installation\n\n```bash\nnpm install\n\n\n```\n\nTo test locally with Hardhat:\n\n```bash\nnpx hardhat test\n\n\n```\n\n----------\n\n## 🤭 Project Roadmap\n\nWe are committed to maintaining CillarCoin as an enterprise-grade, production-ready token infrastructure. Our official roadmap outlines the technical and governance milestones to elevate the platform to full audit certification and DAO-readiness.\n\n📍 [View the Enterprise Development Roadmap](docs/ROADMAP.md)\n\n----------\n\n## 📄 License\n\nThis project is licensed under the **MIT License**.\n\n```\nMIT License\n\nCopyright (c) 2025 Abba Platforms Inc.\n\nCreated and developed by Simon Kapenda  \nMaintained by Abba Platforms Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  \ncopies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n\n```\n\n----------\n\n## 🌐 Links\n\n### Official Websites:\n\n-   Cillar: [https://cillar.io](https://cillar.io)\n-   Cillar DAO: [https://cillar.org](https://cillar.org)\n-   Abba App: [https://abbapp.com](https://abbapp.com)\n-   AfrailX: [https://afrailx.com](https://afrailx.com)\n-   ArailX: [https://arailx.com](https://arailx.com)\n-   Afrail Inc: [https://afrail.xyz](https://afrail.xyz)\n\n----------\n\n## 🤝 Contributions\n\nPull requests and audits are welcome. For questions or improvements, feel free to open an issue or contact the core team.\n\n\u003e Created and developed by **Simon Kapenda**, Creator of Abba App and the Afrail mobility ecosystem. Maintained by **Abba Platforms Inc.**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabba-platforms%2Fcillar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabba-platforms%2Fcillar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabba-platforms%2Fcillar/lists"}