{"id":28205233,"url":"https://github.com/cripterhack/capicoin","last_synced_at":"2025-06-14T12:30:36.477Z","repository":{"id":279929326,"uuid":"940473882","full_name":"CripterHack/CapiCoin","owner":"CripterHack","description":"Token BEP-20 en Binance Smart Chain enfocado en sustentabilidad y donaciones a refugios de animales","archived":false,"fork":false,"pushed_at":"2025-02-28T08:40:08.000Z","size":105,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-17T08:13:20.396Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/CripterHack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-28T08:37:46.000Z","updated_at":"2025-02-28T08:40:11.000Z","dependencies_parsed_at":"2025-02-28T15:28:35.082Z","dependency_job_id":null,"html_url":"https://github.com/CripterHack/CapiCoin","commit_stats":null,"previous_names":["cripterhack/capicoin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CripterHack/CapiCoin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CripterHack%2FCapiCoin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CripterHack%2FCapiCoin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CripterHack%2FCapiCoin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CripterHack%2FCapiCoin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CripterHack","download_url":"https://codeload.github.com/CripterHack/CapiCoin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CripterHack%2FCapiCoin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259816105,"owners_count":22915812,"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","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":[],"created_at":"2025-05-17T08:14:01.267Z","updated_at":"2025-06-14T12:30:36.471Z","avatar_url":"https://github.com/CripterHack.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CapiCoin (CAPI)\r\n\r\nCapiCoin es un token BEP-20 desarrollado en la Binance Smart Chain (BSC) con un enfoque en la sustentabilidad, ética y justicia. El token implementa un sistema de tarifas de transacción que beneficia directamente a refugios de animales y proyectos ecológicos.\r\n\r\n## Características Principales\r\n\r\n- **Nombre:** Capibara\r\n- **Símbolo:** CAPI\r\n- **Suministro Total:** 1,000,000,000 CAPI\r\n- **Decimales:** 18\r\n- **Red:** Binance Smart Chain (BSC)\r\n\r\n### Sistema de Tarifas de Transacción (2% total)\r\n- 1% donación automática a refugios de animales y proyectos ecológicos\r\n- 0.5% quema automática de tokens\r\n- 0.5% fondo de desarrollo y marketing\r\n\r\n## Descripción Técnica\r\n\r\nCapiCoin es un token BEP-20 que implementa características avanzadas de tokenomics y seguridad:\r\n\r\n### Características de Seguridad\r\n- Protección contra reentrancia en todas las funciones críticas\r\n- Sistema de roles y permisos basado en OpenZeppelin\r\n- Protección contra overflow/underflow matemático\r\n- Validaciones exhaustivas en todas las transacciones\r\n- Eventos detallados para auditoría y seguimiento\r\n- Tests unitarios completos con cobertura del 100%\r\n\r\n### Tokenomics\r\n- Sistema de quema automática para deflación controlada\r\n- Mecanismo de donación automática para causas benéficas\r\n- Fondo de desarrollo para sostenibilidad del proyecto\r\n- Distribución transparente de tarifas\r\n\r\n## Requisitos Previos\r\n\r\n- Node.js (v12 o superior)\r\n- npm o pnpm\r\n- Truffle Suite (`npm install -g truffle`)\r\n- MetaMask con BSC configurada\r\n- BNB para gas (testnet/mainnet)\r\n\r\n## Instalación y Configuración\r\n\r\n1. Clonar el repositorio:\r\n```bash\r\ngit clone [URL_DEL_REPOSITORIO]\r\ncd CapiCoin\r\n```\r\n\r\n2. Instalar dependencias:\r\n```bash\r\npnpm install\r\n```\r\n\r\n3. Configurar variables de entorno:\r\n   - Crear archivo `.env` basado en `.env.example`\r\n   - Configurar:\r\n     ```\r\n     MNEMONIC=\"tu frase semilla de 12 palabras\"\r\n     BSCSCAN_API_KEY=\"tu api key de bscscan\"\r\n     BSC_TESTNET_RPC=\"https://data-seed-prebsc-1-s1.binance.org:8545\"\r\n     BSC_MAINNET_RPC=\"https://bsc-dataseed.binance.org\"\r\n     ```\r\n\r\n## Desarrollo y Testing\r\n\r\n### Compilación\r\n```bash\r\ntruffle compile\r\n```\r\n\r\n### Tests Unitarios\r\n```bash\r\ntruffle test\r\n```\r\n\r\nLos tests incluyen:\r\n- ✓ Inicialización correcta del token\r\n- ✓ Sistema de tarifas y transferencias\r\n- ✓ Gestión de carteras y permisos\r\n- ✓ Pruebas de seguridad (reentrancia, overflow)\r\n- ✓ Auditoría de eventos y estado\r\n- ✓ Cálculos de tarifas y precisión\r\n\r\n### Despliegue\r\n\r\n1. Red de pruebas (Testnet):\r\n```bash\r\ntruffle migrate --network bscTestnet\r\n```\r\n\r\n2. Red principal (Mainnet):\r\n```bash\r\ntruffle migrate --network bscMainnet\r\n```\r\n\r\n## Estructura del Proyecto\r\n\r\n```\r\nCapiCoin/\r\n├── contracts/           # Contratos inteligentes Solidity\r\n│   └── CapiToken.sol    # Contrato principal del token\r\n├── migrations/          # Scripts de migración\r\n├── test/               # Tests unitarios\r\n│   └── CapiToken.test.js # Tests principales\r\n├── truffle-config.js   # Configuración de red y compilador\r\n└── .env               # Variables de entorno (no compartir)\r\n```\r\n\r\n## Glosario de Términos\r\n\r\n### Conceptos Blockchain\r\n- **Gas**: Unidad que mide el costo computacional de ejecutar transacciones en la blockchain. Se paga en BNB en la BSC.\r\n- **BEP-20**: Estándar de token en Binance Smart Chain, similar a ERC-20 de Ethereum.\r\n- **Smart Contract**: Programa autoejecutable que vive en la blockchain.\r\n- **Wallet**: Dirección que puede contener tokens y realizar transacciones.\r\n\r\n### Términos del Proyecto\r\n- **Quema de Tokens**: Proceso de enviar tokens a una dirección inutilizable, reduciendo el suministro total.\r\n- **Cartera de Desarrollo**: Dirección que recibe fondos para mantenimiento y marketing.\r\n- **Cartera de Donaciones**: Dirección destinada a proyectos benéficos.\r\n- **Tokenomics**: Economía y distribución del token.\r\n\r\n## Seguridad\r\n\r\n### Medidas Implementadas\r\n- Protección contra reentrancia (ReentrancyGuard)\r\n- Sistema de roles (Ownable)\r\n- Matemáticas seguras (SafeMath implícito en Solidity \u003e0.8.0)\r\n- Validaciones de dirección cero\r\n- Eventos para trazabilidad\r\n\r\n### Mejores Prácticas\r\n- Nunca compartir claves privadas o semillas\r\n- Usar carteras diferentes para desarrollo y producción\r\n- Mantener las variables de entorno seguras\r\n- Realizar auditorías antes del despliegue en mainnet\r\n\r\n## Licencia\r\n\r\nEste proyecto está licenciado bajo la Licencia MIT - vea el archivo [LICENSE](LICENSE) para más detalles.\r\n\r\n### ¿Por qué MIT?\r\n\r\nLa Licencia MIT fue elegida específicamente para este proyecto por:\r\n\r\n- **Apertura y Transparencia**: Permite que cualquiera pueda verificar el código del token, alineado con nuestros valores de transparencia.\r\n- **Compatibilidad**: Facilita la integración con exchanges y otras plataformas.\r\n- **Comunidad**: Fomenta la participación y mejora del código.\r\n- **Protección**: Incluye una cláusula de no garantía que protege a los desarrolladores.\r\n\r\n### Términos Principales\r\n\r\n- ✓ Uso comercial permitido\r\n- ✓ Modificación permitida\r\n- ✓ Distribución permitida\r\n- ✓ Uso privado permitido\r\n- ✓ Sublicenciamiento permitido\r\n- ℹ️ Debe incluir el aviso de copyright\r\n- ℹ️ Debe incluir la licencia\r\n- ❌ Sin garantías proporcionadas\r\n\r\n## Contribuir\r\n\r\nLas contribuciones son bienvenidas. Por favor:\r\n1. Fork del repositorio\r\n2. Crear rama para feature (`git checkout -b feature/AmazingFeature`)\r\n3. Commit de cambios (`git commit -m 'Add AmazingFeature'`)\r\n4. Push a la rama (`git push origin feature/AmazingFeature`)\r\n5. Abrir Pull Request\r\n\r\n## Contacto y Soporte\r\n\r\n- **Documentación**: [Link a la documentación]\r\n- **Issues**: Usar el sistema de issues de GitHub\r\n- **Comunidad**: [Links a redes sociales/Discord] ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcripterhack%2Fcapicoin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcripterhack%2Fcapicoin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcripterhack%2Fcapicoin/lists"}