Skip to content

richpob/MiCryptoCoins-ICo-DEX

BranchesTags

Repository files navigation

Proyecto Yoppen

El Proyecto Yoppen busca innovar en el espacio de las criptomonedas, combinando tecnología blockchain avanzada con una visión de inclusión y comunidad. Este repositorio contiene el código fuente de la criptomoneda Yoppen (YPN), la estructura de su Oferta Inicial de Monedas (ICO) y el intercambio descentralizado (DEX) asociado.

Introducción

Yoppen es una criptomoneda diseñada para promover la conectividad y el apoyo dentro de su comunidad de usuarios. Inspirada en valores de cooperación y solidaridad, Yoppen busca ser más que una moneda digital: un movimiento hacia transacciones más justas y equitativas.

Para el nombre de la criptomoneda "Yoppen", inspirado en el vocabulario Selk'nam que significa "amigo" o "compañero", podríamos proponer un acrónimo y símbolo que reflejen tanto la herencia cultural como la naturaleza innovadora de la criptomoneda.

Acrónimo: YPN

"YPN" captura las iniciales de "Yoppen" y lo condensa en una forma fácil de recordar y usar en comunicaciones digitales. Este acrónimo es corto, lo que facilita su uso en el mercado de criptomonedas, donde la simplicidad y la facilidad de recordación son claves para la adopción y el reconocimiento.

Símbolo: ⓨ

Como símbolo, propongo utilizar "ⓨ", que es la letra "Y" dentro de un círculo. Esta representación visual hace referencia a la inicial de "Yoppen" y la inclusión en un círculo puede simbolizar la unidad, comunidad y la idea de globalidad, valores importantes para la criptomoneda inspirada en el concepto de amistad y cooperación. Además, el uso de un círculo es una práctica común en logotipos y símbolos para transmitir inclusión y totalidad.

Estas propuestas de acrónimo y símbolo buscan combinar la relevancia cultural del término "Yoppen" con la funcionalidad y el diseño requerido para una identificación clara en el ecosistema de criptomonedas.

Imagen de Yoppen

Características

  • Token ERC-20: Yoppen utiliza el estándar ERC-20 para garantizar la compatibilidad con la amplia gama de infraestructuras Ethereum.
  • ICO Trustless: Una ICO descentralizada permite a los inversores participar de manera segura y transparente.
  • DEX Integrado: La plataforma incluye un DEX para facilitar el intercambio de Yoppen por otras criptomonedas sin intermediarios.

Tecnologías Utilizadas

Estructura del Repositorio

  • contracts/ - Contiene los contratos inteligentes de Yoppen, ICO y DEX.
  • migrations/ - Scripts de migración para desplegar los contratos en la red Ethereum.
  • tests/ - Pruebas automatizadas para validar la lógica de los contratos.

Desarrollo

Para comenzar a trabajar con el proyecto, clona este repositorio y sigue los pasos a continuación para instalar las dependencias y compilar los contratos. image

Luego usando Visual Code Studio, creamos los códigos del proyecto

image

Contribuir

Si estás interesado en contribuir al proyecto Yoppen, por favor lee CONTRIBUTING.md para más información sobre cómo empezar.

Licencia

Este proyecto está bajo la licencia MIT. Ver LICENSE para más detalles.

Contacto

Para más información, por favor contacta a [email protected].

Creación de Token ERC20 YoppenToken

Descripción

YoppenToken es un token ERC-20 desarrollado en Solidity que incorpora varias extensiones de la librería OpenZeppelin para proporcionar funcionalidades avanzadas como quema de tokens, pausabilidad y permisos. Este token ha sido diseñado para ser utilizado en la red de prueba Sepolia de Ethereum, facilitando una amplia gama de operaciones financieras descentralizadas.

Código fuente Solidity de Toekn ERC Yoppen

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Burnable.sol";
import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Pausable.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol";


contract YoppenToken is ERC20, ERC20Burnable, ERC20Pausable, Ownable, ERC20Permit {
    constructor(address initialOwner)
        ERC20("Yoppen", "YPN") 
        Ownable(initialOwner)
        ERC20Permit("Yoppen") {
        _mint(msg.sender, 1000000 * 10 ** decimals()); // Emite 1,000,000 YPN al desplegar el contrato
    
  }
    function pause() public onlyOwner {
        _pause();
    }

    function unpause() public onlyOwner {
        _unpause();
    }

    function mint(address to, uint256 amount) public onlyOwner {
        _mint(to, amount);
    }

    // The following functions are overrides required by Solidity.

    function _update(address from, address to, uint256 value)
        internal
        override(ERC20, ERC20Pausable)
    {
        super._update(from, to, value);
    }
}

Características

  • ERC20: Estándar básico para la creación de tokens intercambiables en la red Ethereum.
  • ERC20Burnable: Permite a los titulares de tokens destruir (quemar) sus tokens, reduciendo el suministro total.
  • ERC20Pausable: Introduce la capacidad de pausar y despausar las transferencias de tokens, lo que puede ser útil en situaciones de emergencia o mantenimiento.
  • Ownable: Restringe ciertas acciones solo al propietario del contrato, como la emisión de nuevos tokens o la pausa del contrato.
  • ERC20Permit: Permite a los usuarios realizar transacciones sin pagar gas, firmando una autorización.

Funciones Principales

  • constructor(address initialOwner): Establece el nombre y símbolo del token, el propietario inicial y habilita los permisos según el estándar ERC20Permit.El constructor del contrato crea el token con el nombre "Yoppen" y el símbolo "YPN", y acuña inicialmente 1,000,000 de tokens para el creador del contrato. La función mint permite al propietario del contrato acuñar más tokens en el futuro.
  • pause(): Pausa todas las transferencias de tokens.
  • unpause(): Reanuda todas las transferencias de tokens.
  • mint(address to, uint256 amount): Permite al propietario del contrato acuñar nuevos tokens a una dirección específica.
  • _update(address from, address to, uint256 value): Sobrescribe las funciones de actualización de balances de tokens para ser compatibles con la pausabilidad.

Despliegue

El contrato YoppenToken fue creado utilizando Visual Studio Code, compilado y desplegado a través de Remix, integrado con MetaMask y utilizando una cuenta de la red de prueba Sepolia.

Licencia

Este proyecto está bajo la licencia MIT.

Resultado del despliegue en Renix Yoppen Token ERC20

Imagen del contrato Toekn ERC20

image

Cartera de Metamak con Token Yoppen

image

Cuenta asignada a Yoppen Token

image

Oferta Inicial de Monedas (ICO)

Para organizar una Oferta Inicial de Monedas (ICO) para financiar tu proyecto de criptomoneda como "Yoppen" en Ethereum, necesitas crear un contrato de Crowdsale. A continuación, se muestra un ejemplo básico de cómo podría ser este contrato utilizando Solidity y aprovechando las librerías de OpenZeppelin, que proporcionan implementaciones seguras y comprobadas de estos tipos de contratos.

Este ejemplo asume que ya has creado el token ERC-20 "Yoppen" como se describió anteriormente. Ahora, crearemos el contrato Crowdsale que permitirá a los usuarios comprar tu token con Ether.

Código fuente contrato ICO

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@openzeppelin/contracts/token/ERC20/IERC20.sol";

contract ICO {
    IERC20 public token;
    address public wallet;
    uint256 public rate;

    event TokensPurchased(address indexed purchaser, address indexed beneficiary, uint256 value, uint256 amount);

    constructor(address _token, address _wallet, uint256 _rate) {
        require(_token != address(0), "ICO: token is the zero address");
        require(_wallet != address(0), "ICO: wallet is the zero address");
        require(_rate > 0, "ICO: rate is 0");
        
        token = IERC20(_token);
        wallet = _wallet;
        rate = _rate;
    }

    function buyTokens(address beneficiary, uint256 weiAmount) public payable {
        require(beneficiary != address(0), "ICO: beneficiary is the zero address");
        require(weiAmount > 0, "ICO: weiAmount is 0");

        uint256 tokens = weiAmount * rate;
        token.transferFrom(wallet, beneficiary, tokens);

        emit TokensPurchased(msg.sender, beneficiary, weiAmount, tokens);
    }

    receive() external payable {
        buyTokens(msg.sender, msg.value);
    }
}

Este código Solidity define un contrato inteligente para una Oferta Inicial de Monedas (ICO, por sus siglas en inglés) utilizando un token ERC20 en la blockchain de Ethereum. A continuación, se detallan los componentes principales del contrato:

  • Importación del Contrato IERC20 de OpenZeppelin: Se importa la interfaz IERC20 del contrato estándar ERC20 de OpenZeppelin. Esto permite interactuar con cualquier token ERC20, ya que IERC20 define las funciones estándar que debe tener un token ERC20.

  • Variables de Estado:

    • IERC20 public token: Almacena la dirección del contrato del token ERC20 que se venderá en la ICO.
    • address public wallet: Dirección de la billetera que recibe el ether (ETH) pagado por los compradores de tokens.
    • uint256 public rate: Tasa de conversión entre ether y el token ERC20. Indica cuántos tokens se pueden comprar con 1 ETH.
    • Evento TokensPurchased: Un evento que se emite cada vez que se compran tokens. Esto permite a las aplicaciones externas y a los exploradores de blockchain rastrear las compras de tokens.

  • Constructor: Establece las condiciones iniciales del contrato de ICO:

    • Verifica que la dirección del token ERC20 y la dirección de la billetera no sean la dirección cero.
    • Inicializa las variables de estado token, wallet y rate con los valores proporcionados.

  • Función buyTokens:

    • Acepta dos parámetros: la dirección del beneficiario que recibirá los tokens (beneficiary) y la cantidad de ether (weiAmount) que se está pagando.
    • Verifica que la dirección del beneficiario no sea cero y que la cantidad de ether pagada sea mayor que cero.
    • Calcula la cantidad de tokens a transferir basándose en la tasa (rate) y la cantidad de ether recibida.
    • Transfiere los tokens del wallet del vendedor al beneficiario utilizando token.transferFrom.
    • Fallback Function (receive()): Permite que el contrato reciba ether directamente (sin llamar a una función específica). Cuando se envía ether al contrato, automáticamente llama a buyTokens para el remitente y el valor enviado.

El contrato es una implementación básica de una ICO donde los compradores pueden enviar ether al contrato y recibir tokens ERC20 a cambio, según una tasa predefinida. Este mecanismo es fundamental en el mundo de las criptomonedas y las finanzas descentralizadas (DeFi), permitiendo a los proyectos recaudar fondos vendiendo tokens propios a los inversores

Pasos para desplegar y usar este contrato:

  • Asegúrate de tener el token ERC-20 "Yoppen" desplegado.
  • Despliega este contrato Crowdsale en Remix, especificando la tasa de cambio (tokens por Ether) y la dirección del contrato token "Yoppen" como argumentos del constructor.
  • Los usuarios pueden enviar Ether al contrato para comprar tokens durante el período de la ICO.
  • Este es un ejemplo simplificado. Para una ICO real, considera implementar características adicionales como límites de compra, bonificaciones, y la posibilidad de pausar o finalizar la venta, siempre asegurándote de cumplir con las regulaciones legales aplicables.

Despliegue en Remix y Testnet Sepolia de una ICO

Codigo fuente de Contrato DEX

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/token/ERC20/IERC20.sol";

contract YoppenDEX {
    IERC20 public yoppenToken;
    address public owner;
    uint256 public tokenPrice;

    event Bought(address indexed buyer, uint256 amount);
    event Sold(address indexed seller, uint256 amount);

    constructor(address _yoppenTokenAddress, uint256 _tokenPrice) {
        require(_yoppenTokenAddress != address(0), "YoppenDEX: token address is the zero address");
        yoppenToken = IERC20(_yoppenTokenAddress);
        tokenPrice = _tokenPrice;
        owner = msg.sender;
    }

    modifier onlyOwner() {
        require(msg.sender == owner, "YoppenDEX: caller is not the owner");
        _;
    }

    // Buy tokens with Ether
    function buyTokens() public payable {
        uint256 amountToBuy = msg.value / tokenPrice;
        uint256 dexBalance = yoppenToken.balanceOf(address(this));
        
        require(amountToBuy > 0, "YoppenDEX: You need to send some Ether");
        require(amountToBuy <= dexBalance, "YoppenDEX: Not enough tokens in the reserve");
        
        yoppenToken.transfer(msg.sender, amountToBuy);
        emit Bought(msg.sender, amountToBuy);
    }

    // Sell tokens and receive Ether
    function sellTokens(uint256 amountToSell) public {
        require(amountToSell > 0, "YoppenDEX: You need to sell at least some tokens");
        uint256 allowance = yoppenToken.allowance(msg.sender, address(this));
        require(allowance >= amountToSell, "YoppenDEX: Check the token allowance");

        yoppenToken.transferFrom(msg.sender, address(this), amountToSell);
        payable(msg.sender).transfer(amountToSell * tokenPrice);
        emit Sold(msg.sender, amountToSell);
    }

    // Function to set a new token price
    function setTokenPrice(uint256 _newPrice) public onlyOwner {
        tokenPrice = _newPrice;
    }

    // Function to transfer ownership
    function transferOwnership(address _newOwner) public onlyOwner {
        require(_newOwner != address(0), "YoppenDEX: new owner is the zero address");
        owner = _newOwner;
    }
}

Este código Solidity define un contrato inteligente para un intercambio descentralizado (DEX) llamado YoppenDEX, que permite a los usuarios comprar y vender tokens Yoppen utilizando Ether. El contrato utiliza la biblioteca OpenZeppelin, específicamente el contrato IERC20 para la interacción con tokens ERC20, lo que asegura compatibilidad y seguridad en las operaciones con tokens.

  • Variables y Eventos: Define variables para almacenar el token Yoppen (yoppenToken), el propietario del contrato (owner), y el precio del token (tokenPrice). También declara eventos Bought y Sold para emitirlos cuando se realicen compras y ventas de tokens, respectivamente.
  • Constructor: Inicializa el contrato con la dirección del token Yoppen y el precio del token. Establece al creador del contrato como el propietario.
  • Modificador onlyOwner: Asegura que solo el propietario del contrato pueda ejecutar ciertas funciones.
  • Función buyTokens: Permite a los usuarios comprar tokens Yoppen enviando Ether. Calcula la cantidad de tokens a comprar basándose en el precio del token y verifica que haya suficientes tokens en el contrato para completar la compra antes de transferir los tokens al comprador y emitir el evento Bought.
  • Función sellTokens: Permite a los usuarios vender tokens Yoppen al contrato a cambio de Ether. Verifica que el usuario tenga suficientes tokens y la autorización para transferirlos al contrato antes de realizar la transferencia y enviar Ether al vendedor, emitiendo el evento Sold.
  • Función setTokenPrice: Permite al propietario cambiar el precio del token Yoppen.
  • Función transferOwnership: Permite al propietario actual transferir la propiedad del contrato a otra dirección.

Este contrato es un ejemplo simple de un DEX que facilita la compra y venta de un token ERC20 específico, utilizando prácticas de seguridad como el uso de require para validar las condiciones antes de ejecutar transacciones y modificadores para restringir el acceso a funciones críticas.

Pasos para la compilación y despliegue del contrato DEX

Para desplegar el contrato YoppenDEX utilizando Remix y una wallet de MetaMask, sigue estos pasos:

  1. Preparación:
  • Asegúrate de tener MetaMask instalado en tu navegador y de tener una cuenta configurada. Agrega algo de Ether en tu cuenta de MetaMask para cubrir los costos de gas del despliegue del contrato. Esto puede ser en la red de Ethereum mainnet o en una testnet como la que usamos en este proyecto la testnet Sepolia, dependiendo de dónde quieras desplegar tu contrato.
  1. Abrir Remix:
  • Ve a Remix, que es un IDE de Solidity basado en el navegador.
  1. Pegar el Código:
  • Crea un nuevo archivo en Remix y pega el código fuente del contrato YoppenDEX.
  1. Compilar el Contrato:
  • En Remix, ve a la pestaña "Solidity compiler".
  • Selecciona la versión de Solidity que coincida con la versión utilizada en tu contrato (en este caso, ^0.8.20).
  • Haz clic en "Compile".
  1. Conectar MetaMask:
  • En Remix, ve a la pestaña "Deploy & run transactions".
  • Selecciona "Injected Web3" como Environment. Esto debería conectar Remix con tu wallet de MetaMask.
  • Si MetaMask solicita permiso para conectarse a Remix, apruébalo.
  1. Desplegar el Contrato:
  • En el campo "Contract" selecciona YoppenDEX.
  • Introduce los parámetros necesarios para el constructor del contrato, como la dirección del token ERC20 Yoppen YON y el precio del token.
  • Haz clic en "Deploy". MetaMask te pedirá que confirmes la transacción, incluyendo el costo del gas.
  • Una vez confirmada la transacción y procesada en la blockchain, tu contrato estará desplegado.
  1. Interactuar con el Contrato:
  • Después del despliegue, podrás ver tu contrato en la sección "Deployed Contracts" en Remix.
  • Aquí puedes interactuar con las funciones del contrato, como buyTokens, sellTokens, setTokenPrice, y transferOwnership.
  1. Verificar y Publicar (opcional):
  • Para que otros puedan interactuar fácilmente con tu contrato y verificar su código, considera verificar y publicar el código fuente en Etherscan o en el explorador de bloques correspondiente a la red que utilizaste para el despliegue.

Este proceso te permite desplegar un contrato en la blockchain utilizando Remix, de in smart contracts en Solidity, y MetaMask.

Despliegue en Remix y Testnet Sepolia contrato para Crea una DEX

Traspaso de YPN al Contrato

Compra de YPN por ETH - Saldo

https://sepolia.etherscan.io/tx/0x88b3d8c9d146657f275a6b6866ca48866ea119887ce7700ef588a34cba25ae4f image

About

MiCryptoCoins-ICo-DEX

Resources

Readme
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages