CofiBlocks - La Comunidad del Café ☕️

CofiBlocks is the first Collaborative Business connecting traditional coffee-growing communities in Costa Rica and worldwide directly with coffee lovers using StarkNet blockchain technology. Our mission is to distribute benefits among all members, ensuring fair trade, community engagement, and technological innovation.

---

🚀 Roadmap

Season	Details
2022-2023	Thank you to everyone who participated in our first season featuring coffee from the slopes of Volcán Poás.
2024-2025	Launching our second season with coffee from additional regions of Costa Rica.

Want to bring CofiBlocks to your region?
📧 Contact Us

---

🌎 Movement

CofiBlocks is more than just a coffee marketplace; it's a movement for a more equitable and sustainable coffee future. With a strong foundation and a passionate community, we aim to transform the way coffee is produced, distributed, and enjoyed worldwide. Whether you're a coffee enthusiast or a blockchain believer, join us on this journey!

---

📌 Fundamental Links

• Learning about Modern Collaborative Businesses with CofiBlocks
• CofiBlocks: Innovating the Coffee Industry in Costa Rica with Web3
• Pitch Deck

---

👥 Meet the Team

☕ Founders

• Omar Hurtado Munguia: From coffee picker to coffee tour guide, Omar's journey inspired CofiBlocks. Watch his story.
• Karla Córdoba Brenes: Blockchain expert focused on impact-driven solutions.
• Ranulfo Paiva Sobrinho: Blockchain developer with expertise in collaborative economies.

Maintainers

• Alberto - Brolag
  • GitHub | Twitter
• Erick - Evgongora
  • GitHub | Twitter
• Randall Valenciano
  • GitHub | Twitter

---

🎉 Join the Community

• 🌐 Website
• 🐦 Follow us on Twitter
• 💬 Telegram for ODBoost
• 💻 Telegram for Developers

---

🛠️ Getting Started

Prerequisites

• Node.js (>= 18)
• Bun package manager ([email protected])
• Prisma

Crate file

/cofiblocks/apps/web/sql/init.sql

• And REPLACE MYSQL_USER with your mysql user in the .env

GRANT CREATE ON *.* TO '<MYSQL_USER>'@'%';
GRANT ALL PRIVILEGES ON *.* TO '<MYSQL_USER>'@'%';

Docker-compose.yml

Add this to your docker-compose.yml file:

version: '3.8'
services:
  db:
    image: mysql:8.4
    container_name: mysql
    restart: always
    env_file:
      - ./apps/web/.env
    ports:
      - '3306:3306'
    healthcheck:
      test: ['CMD-SHELL', 'mysqladmin ping -h 127.0.0.1 --password="$$(cat /run/secrets/db-password)" --silent']
      interval: 3s
      retries: 5
      start_period: 30s
    volumes:
      - mysql-data:/var/lib/mysql
      - ./apps/web/sql/init.sql:/docker-entrypoint-initdb.d/init.sql
volumes:
  mysql-data:

Installation

1. Clone the repository:

   git clone https://github.com/Vagabonds-Labs/cofiblocks.git
   cd cofiblocks

   • Run docker compose up, to access the database.
2. Install dependencies:

   bun install

3. Rename

   mv .env.example to .env 

   And add this in your .env file:

   MYSQL_ROOT_PASSWORD=
   MYSQL_DATABASE=
   MYSQL_USER=
   MYSQL_PASSWORD=
   DATABASE_URL="mysql://${MYSQL_USER}:${MYSQL_PASSWORD
   }@localhost:3306/${MYSQL_DATABASE}?
   connect_timeout=10"

   Important:
   • Add and run docker compose up in this part.
4. Generate the Prisma client:

   bun prisma generate

5. Run the development server:

   bun turbo dev

Make sure the values in the .env file are configured correctly for your environment.

Project Structure

The project is organized using workspaces:

• apps/ - Contains the main web application.
• packages/ - Shared packages and utilities.

Key scripts include:

• build: Build the project.
• dev: Start the development server.
• db:migrate: Apply database migrations.
• db:seed: Seed the database with initial data.

Key Technologies

1. StarkNet

   StarkNet is a decentralized, permissionless Layer 2 solution for Ethereum. It uses ZK-STARKs (zero-knowledge proofs) to enable fast and cost-efficient transactions while ensuring security and scalability. Developers can deploy smart contracts, and users benefit from significantly reduced gas fees compared to Ethereum's mainnet.

2. Prisma

   Prisma is a modern database toolkit for Node.js and TypeScript. It provides an ORM (Object-Relational Mapping) that simplifies working with databases, allowing developers to define models and query data in a type-safe way. Prisma supports multiple databases, including PostgreSQL, MySQL, and MongoDB

3. Bun

   Bun is an all-in-one JavaScript runtime that competes with Node.js and Deno. It’s built for performance and includes a fast bundler, transpiler, and package manager. Bun aims to speed up development workflows, reduce dependency on third-party tools, and execute JavaScript and TypeScript quickly. It’s designed to handle server-side apps, scripts, and front-end tooling.

📚 Code of Conduct

We are committed to creating a welcoming and inclusive environment. Please read our Community Guidelines to ensure a positive experience for everyone involved.

📚 Development Resources

CofiBlocks Dev Assistant

Our custom GPT assistant helps with coding, StarkNet guidance, and blockchain-related development. Access it here.

Prompt Guide

Explore our detailed Prompt Guide to streamline your workflow.

---

🛠️ Key Technologies

• StarkNet: Scalable Layer 2 solution for Ethereum with reduced gas fees.
• Prisma: Type-safe, modern ORM for working with databases.
• Bun: High-performance runtime for JavaScript/TypeScript.

---

💡 Contributions

We welcome contributors! Here's how you can help:

1. Review open issues.
2. Submit pull requests with detailed explanations.
3. Suggest new features or improvements.