Teknologiak gizakiaren zerbitzura egon behar du. Blockchain teknologiak, dagoeneko sektore asko irauli dituenak, nekazaritza arloa ere eraldatu dezake. Teknologia deszentralizatu hau hartzeko joera nagusira eramateko, sinplifikatu egin beharko genuke publiko orokorrarengana iristeko, erabiltzaile zabalagoetan sartu ahal izateko, azken finean, erabilera kasuak areagotuz. Tutorial honetan, erabiltzaileek Rootstock (RSK) blockchain sarean nekazaritza produktuak erosi eta saltzeko aukera ematen duen aplikazio deszentralizatua (dApp) eraikiko dugu. Helburu nagusia blockchain sarean exekutatzen den dApp bat eraikitzea da. Edozein erabiltzailek produktuak erraz gehi ditzakete nekazaritza produktuak salduz gizakiaren gehiegizko esku-hartzerik gabe. Hasieran, aplikazioa Rootstock-en testnet-ean probatu zen, eta ia ekoizpenerako prest dago (doikuntza txikiak behar ziren Rootstock-en sare nagusira aldatzeko). Proiektua GitHub-en kargatuta dago, beraz, biltegia klonatu dezakezu zuk zeuk probatzeko. Horretarako, nahiago dut -en. Baina, tutorial honetan, sakontzen saiatzen gara edozein erabiltzailek bere dApp-a eraiki dezan tutoriala urratsez urrats ulertzeko erraztasunarekin. Frontend kodea GitHub biltegitik deskargatu eta dagokion direktorioan gehitzea proposatzen dizugu. Proiektua konfiguratu, kontratu adimendunak zabaldu eta denbora errealeko funtzioekin frontend interaktibo bat sortu arte landuko dugu. Readme.md GitHub Hasi baino lehen, AgriMarket izeneko dApp bat eraiki nahi dugu, honako ezaugarri hauek izango dituena: Erabiltzaileei Web3 funtzioetara sartzeko aukera ematen die onartzen diren zorroen bidez (MetaMask gure kasuan). Erabiltzaileei beren nekazaritza produktuak prezioekin gehitzeko aukera ematen die beren diru-zorroak dApp-arekin konektatuz. Aplikazioak smartcontract-en deiak berresten ditu MetaMask-ekin elkarreraginean. Erabiltzaileek produktuak gehi ditzakete saskian eta dApp-ek transakzioak abiarazteko gai da, nahiz eta saskian hainbat produktu egon. Erabiltzaileek denbora errealeko jakinarazpenak, transakzioen ordainagiriak eta produktuak kentzeko eginbideak lor ditzakete bi saskietatik eta baita produktuen zerrendako orrialdetik ere. 📥Aurrebaldintzak - Hasi baino lehen, ziurtatu honako hau instalatuta duzula zure makinan: Node.js (v14 edo berriagoa) npm edo haria Truffle edo Hard Hat kontratu adimendunen garapenerako MetaMask luzapena RSK testnet-erako konfiguratuta Git bertsioak kontrolatzeko VSCode bezalako IDE bat 📥Proiektuaren konfigurazioa 👉Sortu Proiektuen Direktorioa Mesedez, ziurtatu proiektu nagusi honen direktorioa nahiago duzula gure garapen eta proba prozesu osoan zehar. 👉Abiaraztu Proiektuen Direktorioa Sortu direktorio berri bat zure proiekturako komando hauek exekutatuta terminalean: mkdir rsk-agri-marketplace cd rsk-agri-marketplace 👉Hasi npm proiektu berri bat: npm init -y 👉Boilurra Proiektua hasieratu Truffle erabiltzen ari gara kontratu adimenduna konpilatzeko eta garatzeko, beraz, hasieratu erroko direktorioaren bidez: truffle init Honek oinarrizko egitura sortzen du: • - • - • - • - contracts/ Solidity kontratuak ditu migrations/ Inplementazio scriptak test/ Zure kontratuen probak truffle-config.js Truffle konfigurazio fitxategia 📥Konfiguratu inguruneko aldagaiak Informazio sentikorra bezalako gako pribatuak, Pimata API gakoa eta abar .env fitxategi batean gorde behar dira. 👉Instalatu dotenv npm install dotenv 👉Sortu .env fitxategi bat Erroko direktorioan, sortu .env fitxategi bat egitura honekin: REACT_APP_PINATA_API_KEY=Your API Key REACT_APP_PINATA_SECRET_API_KEY=Secret API Key MNEMONIC=12 words mnemonic key RSK_TESTNET_URL=https://public-node.testnet.rsk.co REACT_APP_CONTRACT_ADDRESS=Contract Address Mesedez, sortu fitxategia espazio gehigarririk edo karaktere desegokirik gabe, bestela zailtasunak izango dituzu geroago. Mesedez, gogoratu hau geroago kontratu adimenduna eguneratzen ari zarelako. Lortu Pinata APIa . .env Urrats hemendik 📥 RSK Testnet-era konektatzen 👉Eguneratu truffle-config.js Dagoeneko sortutako truffle-config.js ikus dezakezu zure proiektuaren direktorioa. Kodea eguneratu besterik ez dago RSK testnet-arekin elkarreragin ahal izateko. require('dotenv').config(); const HDWalletProvider = require('@truffle/hdwallet-provider'); module.exports = { networks: { development: { host: "127.0.0.1", port: 8545, network_id: "*", }, rskTestnet: { provider: () => new HDWalletProvider({ mnemonic: { phrase: process.env.MNEMONIC, }, providerOrUrl: `https://public-node.testnet.rsk.co`, chainId: 31, // RSK Testnet ID pollingInterval: 15000, }), network_id: 31, gas: 2500000, gasPrice: 60000000, confirmations: 2, timeoutBlocks: 60000, skipDryRun: true, }, }, compilers: { solc: { version: "0.8.20", }, }, db: { enabled: false, }, }; 👉Instalatu HDWalletProvider npm install @truffle/hdwallet-provider 📥 Kontratu Adimenduna Garapena Marketplace kontratua sortuko dugu. 👉Instalatu OpenZeppelin Kontratuak OpenZeppelin kontratuak erabiltzen ari gara gure kontratu adimendunaren segurtasuna eta funtzionamendu ona hobetzeko, beraz, instalatu komando hau terminalean exekutatuz: npm install @openzeppelin/contracts 👉Sortu direktorioan: Marketplace.sol contracts/ // SPDX-License-Identifier: MIT pragma solidity ^0.8.0; import "@openzeppelin/contracts/utils/ReentrancyGuard.sol"; import "@openzeppelin/contracts/utils/Pausable.sol"; contract Marketplace is ReentrancyGuard, Pausable { uint public productCount = 0; struct Product { uint id; address payable seller; string name; string description; string imageHash; // IPFS hash uint price; // Price in tRBTC bool active; } mapping(uint => Product) public products; event ProductCreated( uint id, address seller, string name, string description, string imageHash, uint price, bool active ); event ProductPurchased( uint id, address seller, address buyer, uint price ); event ProductRemoved(uint id, address seller); function createProduct( string memory _name, string memory _description, string memory _imageHash, uint _price ) public whenNotPaused { require(bytes(_name).length > 0, "Name is required"); require(_price > 0, "Price must be positive"); // Price is expected in tRBTC productCount++; products[productCount] = Product( productCount, payable(msg.sender), _name, _description, _imageHash, _price, true ); emit ProductCreated( productCount, msg.sender, _name, _description, _imageHash, _price, true ); } function purchaseProducts(uint[] memory _ids) public payable nonReentrant whenNotPaused { uint totalCost = 0; for (uint i = 0; i < _ids.length; i++) { Product storage _product = products[_ids[i]]; require(_product.id > 0 && _product.id <= productCount, "Invalid product ID"); require(_product.active, "Product is not active"); require(_product.seller != msg.sender, "Seller cannot buy their own product"); totalCost += _product.price; } require(msg.value >= totalCost, "Insufficient funds"); for (uint i = 0; i < _ids.length; i++) { Product storage _product = products[_ids[i]]; (bool success, ) = _product.seller.call{value: _product.price}(""); require(success, "Transfer failed to the seller"); // Emit purchase event (product can be bought again) emit ProductPurchased( _product.id, _product.seller, msg.sender, _product.price ); } } function removeProduct(uint _id) public { Product storage _product = products[_id]; require(_product.id > 0 && _product.id <= productCount, "Invalid product ID"); require(_product.seller == msg.sender, "Only the seller can remove the product"); _product.active = false; // Mark the product as inactive emit ProductRemoved(_id, msg.sender); } function getProduct(uint _id) public view returns (Product memory) { require(_id > 0 && _id <= productCount, "Invalid product ID"); Product memory product = products[_id]; require(product.active, "Product is not available"); return product; } function pause() public { _pause(); } function unpause() public { _unpause(); } } 👉Idatzi Migration Scripta migrations/2_deploy_contracts.js const Marketplace = artifacts.require("Marketplace"); module.exports = function (deployer) { deployer.deploy(Marketplace); }; 👉Kontratuak osatu eta zabaldu Exekutatu honako kodea terminalaren bidez kontratua osatzeko: truffle compile Dena ondo badoa, honelako zerbait ikus dezakezu terminalean: Exekutatu komando hau terminalean Rootstock-en testnet-ean zabaltzeko. Marketplace.sol truffle migrate --network rskTestnet tRBTC kopuru batzuk behar dituzu zorroan zure kontratua zabaldu aurretik. Eskuratu RSK txorrotatik. hemen Prozesu arrakastatsuaren ondoren, mezua ikusiko duzu terminal honetan: fitxategia aurkituko duzu gogoratu, fitxategi hau beste direktorio batean kopiatuko duzu. Marketplace.json \build\contracts\Marketplace.json Marketplace dApp-rako frontend garapena Kontratu adimendunak zabaldu ditugunez, merkaturako frontend erakargarri bat eraikiko dugu, erabiltzaileek harekin elkarreragin dezaten. Frontendak produktuen zerrendak, produktuak gehitzea, erostea, produktuak gehitzea/kentzea saskian, transakzioen jarraipena egitea eta denbora errealeko iritzia ematea bezalako ezaugarriak izango ditu, hala nola jakinarazpenak eta aurrerapen-barra. 📥 Frontend garapena 👉Hasi React aplikazioa Frontenderako React erabiliko dugu. Hasieratu React aplikazio berri bat proiektuaren direktorioan. npx create-react-app client Nabigatu bezeroen direktoriora. cd client Instalatu Web3 eta Bootstrap UI-rako npm install web3 bootstrap 👉Proiektuaren Egitura Frontendaren egitura beharko duzu 1. Irudian erakusten den moduan. 👉Web3 konfigurazioa en src/utils/Marketplace.json Kontratu adimendunarekin elkarreragiteko, ABI (Application Binary Interface) inportatuko dugu. Kopiatu ABI zure Truffle direktoriotik karpetara aipatu bezala. Marketplace.json build/contracts client/src/utils/ Urratsean Web3 konfigurazioa fitxategian dago. Deskargatu etik eta jarri direktorio egokian 1. Irudian erakusten den moduan. App.js GitHub- 👉 Denbora errealeko jakinarazpenak eta aurrerapen-barrak Denbora errealeko jakinarazpenetarako, liburutegi moduko bat integratuko dugu. Era berean, erabil dezakezu aurrerapen-barretarako. react-toastify react-bootstrap Instalatu React Toastify direktorioan client npm install react-toastify 👉Instalatu Axios HTTP eskaeretarako (Pinata-ren APIrako): npm install axios Ongi da, orain deskargatu Frontend osagai guztiak bezero karpetatik (karpeta+fitxategiak barne). Eta jarri itzazu dagokion direktorioan. GitHub biltegiko 📥Azken ukituak eta zure aplikazioarekin elkarreragin 👉Orain, zure dApp-arekin elkarreragin dezakezu. Zure erreakzio aplikazioa exekutatu dezakezu komando hau terminalean erabiliz: npm start Nabigatzaile lehenetsia automatikoki irekiko du. Mesedez, ziurtatu MetMask arakatzailearen luzapena instalatuta eta RSK testnet-a behar bezala konfiguratuta duzula (proiektuaren gida jarraitu dezakezu sare egokia hautatzeko ). hemen Orain, erreakzionatzeko aplikazioak MetaMask zorroaren luzapena deitzen du, berretsi deia. Ondoren, konektatutako zorroa erakutsiko du interfaze nagusian hurrengo irudian erakusten den moduan. Frontend-ak funtzio ugari eskaintzen dizkizu. Produktuak gehitu/kendu ditzakezu. Aldi bakoitzean, deia berresteko eskatuko zaizu MetaMask zorroaren luzapenean. Egiaztatu gif hau: Beno, orain dApp-ek saskian gehitutako transakzioak behar bezala prozesatzen dituen edo ez probatu dezakezu. Transakzioen historia zehatza ikus dezakezu "Transakzioen historia" atalean xehetasun tekniko guztiekin. Erosketa amaitutakoan, funtsa dApp-era produktuak gehitu dituen jabeari bidaltzen zaio. Probatu dezagun aplikazioa elkarrekin: Zorionak! DApp-a arrakastaz garatu eta probatu dugu RSK testnet-en. RSK sare nagusira alda dezakezu nahi dituzun funtzioak gehituz. Egokitu kodeak testnet aipatzen den lekuan eta egiaztatu hemen produkziorako prest dagoen aplikazioa eraikitzera presaka joaten bazara. proiektuaren dokumentazioa 📥Erronka potentzialak eta etorkizuna: Nekazaritza-merkatua abiarazteko ikuspegi berria izango da, hainbat prozesu barne hartzen dituena, besteak beste, produktuen entrega, bilketa, etab. Erosleak eta saltzaileak zehatz-mehatz ezagutu gabe, konfiantza arazoak sor ditzake. Beste erronka bat da oraindik fase esperimentalean dagoela, eta ez dakigu kontsumitzaileek nola jokatzen duten eboluzionatzen ari den teknologia honen aurrean. Beraz, hezkuntza eta prestakuntza ezinbestekoak dira bai nekazariak bai kontsumitzaileak teknologia berriak hartzeko. Era berean, kolaborazio nahikoak dira nekazaritzako produktuen merkatu deszentralizatu iraunkor bat garatzeko funtsezko faktoreak. Ondorioa: Arrakastaz eraiki genuen nekazaritza-merkatu deszentralizatua Rootstock (RSK) testnet-ean. Segurtasuna lehentasun gisa hartu da, horregatik hainbat neurri hartzen dira OpenZeppelin kontratuak erabiliz smartcontract kodea babesteko. Probatu dApp-ek merkatu deszentralizatu sinple batek izan beharko lituzkeen ia beharrezko eginbide guztiak ditu, baina funtzio gehiagorekin hobetu dezakezu aplikazioa Rootstock-en sare nagusian abiarazteko asmoa baduzu. Gainera, kontuan izan segurtasuna dena nahi bezala eta ondo funtzionatzen duela ziurtatzeko. Rootstock-en transakzio bizkorrak prozesatzeko funtzioak erabiltzen saiatu gara transakzio kuota baxuekin Bitcoin-en pilaketa arazo ezaguna konponduko duen transakzio guztiarekin aurrera egiteko. Jakina, merkatu deszentralizatu mota hauek arazo askori aurre egin behar diete, baina askatasuna naturalki bilatzen dugunez, etorkizunean merkatu deszentralizatuago bat aurkitzea espero dezakegu.
