Este proyecto utiliza Protostar como marco de desarrollo. Para comenzar con Protostar, siga las guías contenidas en los documentos oficiales.
Una vez instalado y clonado este repositorio no hará falta iniciar el proyecto con protostar, nos dirijimos directamente al archivo protostar.toml para revisar su información. Como ven estan añadidos todos los contratos y la configuración de testnet2 para el deploy, así que nos han dejado el trabajo para hacer los MINIMOS esfuerzos Min-Starknet, así que intentaré seguir en esa línea para esta guía.
En esta nueva version de protostar 0.9.1 tendremos que crear un perfil que añadirermos en protostar.toml en el que defineremos el usuario de cuenta que pagará el fee. Usaremos los ajustes PARA TESTNET aunque también estan preparados para TESTNET2. La cuenta de ArgentX para la guía será 0x03F878C94De81906ba1A016aB0E228D361753536681a776ddA29674FfeBB3CB0 (EN SU CASO AÑADIR LA VUESTRA) para el deploy del staking.cairo. Tendremos que exportar nuestra PRIVATE KEY de esa cuenta de ArgentX. En la versión 0.9.0 protostar teniamos que pasarlo a hexa usando Stark-utils.
Recordar que tenemos OPCIONES A - B para TESTNET o TESNET2 y no usar ni compartir ninguna PRIVATE KEY NUNCA, todo ello es provisional hasta la versión de CAIRO 1.0. Al reiniciar el pc o terminal tendrá que volver a exportar la clave.
En la versión 0.9.0 protostar teniamos que pasarlo a hexa usando Stark-utils. En la 0.9.1 pasaremos nuestra private key directamente para exportarla, usando el siguiente comando. (SUSITITUIR 0x1234 por vuestro hexa).
export PROTOSTAR_ACCOUNT_PRIVATE_KEY=0x1234Otra opción es este método, añadimos en un archivo .env nuestra private key. También tendremos que ajustar el protostar.toml para indicar la ruta de nuestra Private Key, aunque prefiero esta opción. Nunca mostrar tu clave privada. Nunca subir a Git tu archivo .env.
Si queremos realizar el deploy de nuestro contrato en la testnet 2, debemos seguir los mismos pasos que en la testnet. La única diferencia es que necesitaremos utilizar una wallet que esté en la testnet 2 y agregar un perfil específico al archivo de configuración de Protostar. Además, cuando ejecutemos los comandos de Protostar, debemos utilizar el parámetro -p testnet2 en lugar de -p testnet para que la configuración se aplique a la testnet 2. Con estos pasos, podremos realizar el deploy de nuestro contrato en la testnet 2 de manera efectiva.
Ahora para compilar nuesrto token staking.cairo y el resto de contratos sólo deberemos pasar el siguiente comando y obtendremos también cada uno de sus Class Hash.
protostar build
Ahora nos quedaremos con el class hash del Staking para hacer el deploy. En el caso del declare la mayoría ya los tenían realizados creados por otros usuarios, igualmente los declare para esta guía. También comprobaremos que todo este bien, así que pasaremos el comando.
protostar -p testnet declare ./build/token_bridge.json --max-fee auto
Usaremos esta vez para el Min-Starknet protostar. En este constructor en particular, tenemos que pasar dos parámetros: tokenAddress y adminAddress. Para tokenAddress usaremos ETH en Starknet y de admin la wallet usada para esta guía. Estos se guardan en el almacenamiento del contrato (usando la función write) en las variables token_address y admin_address respectivamente. Así que pasaremos para el deploy el siguiente comando.
protostar -p testnet deploy 0x04464eba7601763a9edc8d497d9fe48c2aeefd77bba9598fb13d9507ff12407b --max-fee auto -i 2087021424722619777119509474943472645767659996348769578120564519014510906823 1795950254530259382270168937734171348535331377400385313842303804539016002736
Para aprobar el token en este contrato, necesitarás utilizar la función approve del contrato ERC-20 que representa el token. En este caso usamos ETH en Starknet. La función approve permite que el contrato especificado pueda transferir tokens desde tu cuenta. En este caso será el contrato de STAKING. La cantidad que pasaremos será 100000000000.
Una vez esté procesada la transacción iremos hacer el Stake de ETH y tiene dos parámetros de entrada: stake_amount y duration_in_secs.
La función comienza por asignar algunas variables locales y luego obtiene la dirección del llamante y la dirección del contrato actual utilizando las funciones get_caller_address y get_contract_address, respectivamente. También obtiene la dirección del token y el valor actual del contador de stakes utilizando las funciones read y las variables token_address y stake_counter, respectivamente.
Luego, la función asigna un nuevo valor al contador de stakes y calcula la hora de finalización del stake sumando la duración del stake al tiempo actual. Para la guía usamos para stake_amount 100 y duration_in_secs 60.
La función claim_reward es utilizada para reclamar sobre un sistema de recompensas basado en stakes (depósitos). La idea es que los usuarios pueden depositar tokens en el contrato y recibir recompensas por el tiempo durante el cual mantienen sus tokens depositados.
La función claim_reward se utiliza para recoger las recompensas acumuladas por un stake específico. El parámetro stake_id se utiliza para identificar el stake del que se quieren recoger las recompensas.
En la función, se obtienen los detalles del stake especificado, incluyendo la hora de inicio y la hora de finalización del stake. Luego, se puede calcular el tiempo durante el cual el stake ha estado activo y utilizar esta información para calcular las recompensas acumuladas.
Una vez que se han calculado las recompensas, se pueden transferir los tokens a la cuenta del usuario que ha realizado la llamada a la función utilizando la función transfer del contrato ERC-20 del token, en nuetro caso transcurrido los 60 sec.
Como podremos comprobar ha cambiado nuestra lista el claim_status a 1, podremos revisar en la lista de llamadas de nuestro contrato aquí los stake y claim que se han realizado.
Como tarea extra podemos dejar verificado nuestro contrato en Starkscan, para ello debemos de tener instalada y guardado el contrato que acabamos de hacer el Deploy. Ejecutamos el siguiente comando, escogemos el amm.cairo y vamos siguiendo los pasos. (EN CASO ERROR EN LA RUTA SOLO HAY QUE AÑADIR LA PALABRA lib)
starkscan