RSK テストネット上で農産物の分散型マーケットプレイスを構築する方法

テクノロジーは人類に奉仕するものでなければなりません。すでに多くの分野に改变を起こしているブロックチェーン技術は、農業分野にも変革をもたらす会性があります。この分散性型テクノロジーを核心の採用トレンドにするには、寻常大衆に届くように簡素化し、より幅広いユーザーに渗透させて、最終的に用例を増やす必不可少があります。

このチュートリアルでは、ユーザーが Rootstock (RSK) ブロックチェーン ネットワーク上で農産物を売買できる增溶型アプリケーション (dApp) を構築します。主な依据は、ブロックチェーン ネットワーク上で実行される dApp を構築することです。あらゆる種類のユーザーが、過度の人的入驻なしに農産物を販売して収益を得るために、簡単に製品を追加できます。

如果当初、アプリは Rootstock のテストネットでテストされており、ほぼ本番環境対応の状態です (Rootstock のメインネットに切り替えるために诺干の調整が不必要でした)。プロジェクトはすでに GitHub にアップロードされているため、リポジトリをクローンして自分でテストすることができます。

このため、私はのReadme.md好みます。ただし、このチュートリアルでは、あらゆる種類のユーザーがチュートリアルを段階的に理解しながら簡単に dApp を構築できるように、詳細にガイドします。GitHub リポジトリからフロントエンド コードをダウンロードし、適切なディレクトリに追加することをお勧めします。プロジェクトのセットアップからスマート コントラクトのデプロイ、リアルタイム機能を備えたインタラクティブなフロントエンドの作成まで、すべてをカバーします。

始める前に、私たちは以下的の機能を持つと予想される AgriMarket という dApp の構築を目指しています。

• サポートされているウォレット (この場合は MetaMask) を通じてユーザーが Web3 機能にアクセスできるようにします。
• ユーザーはウォレットを dApp に接続することで、農産物とその価格を追加できます。
• アプリは、MetaMask と対話してスマートコントラクトの呼び出しを確認します。
• ユーザーはカートに商品を追加することができ、カートに複数の商品がある場合でも dApp はトランザクションを開始できます。
• ユーザーは、カートと商品リストページの両方から、リアルタイム通知、取引領収書、商品削除機能を利用できます。

📥前提条件 - 始める前に、マシンに以下がインストールされていることを確認してください。

• Node.js (v14 以上)
• npm または yarn
• スマートコントラクト開発のためのTruffleまたはHardhat
• RSKテストネット用に設定されたMetaMask拡張機能
• バージョン管理のための Git
• VSCodeのようなIDE

📥プロジェクトのセットアップ

👉プロジェクトディレクトリを制成する

開発およびテストのプロセス我谨代表を通じて、このメイン プロジェクトのディレクトリを優先するようにしてください。

👉プロジェクトディレクトリを期间化するターミナルで次のコマンドを実行して、プロジェクト用の新しいディレクトリを弄成します。

 mkdir rsk-agri-marketplace cd rsk-agri-marketplace

👉新しい npm プロジェクトを在初期的化します。

 npm init -y

👉Truffleプロジェクトの时期化

スマート コントラクトのコンパイルと開発には Truffle を便用しているため、ルート ディレクトリから早期化します。

 truffle init

これにより、基本的な構造が作成されます。 • contracts/ - Solidity コントラクトが含まれます• migrations/ -デプロイメント スクリプト• test/ -コントラクトのテスト• truffle-config.js - Truffle 構成ファイル

📥環境変数を設定する

秘密全集鍵、Pimata API キーなどの機密情報は、.env ファイルに永久保存する必备があります。

👉dotenvをインストールする

npm install dotenv

👉.envファイルを做成する

ルート ディレクトリに、次の構造の .env ファイルを制成します。

 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=//public-node.testnet.rsk.co REACT_APP_CONTRACT_ADDRESS=Contract Address

📥RSKテストネットへの接続

👉truffle-config.js を更行する

プロジェクトのディレクトリに、すでに做成された truffle-config.js が带表されます。コードを最新するだけで、RSK テストネットとやり取りできるようになります。

 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: `//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, }, };

👉HDWalletProviderをインストールする

npm install @truffle/hdwallet-provider

📥スマートコントラクト開発

マーケットプレイス契約を制作します。

👉OpenZeppelin コントラクトをインストールするスマート コントラクトのセキュリティとスムーズな方法を強化するために OpenZeppelin コントラクトを应用しているため、ターミナルで次のコマンドを実行してインストールします。

 npm install @openzeppelin/contracts

contracts/ディレクトリにMarketplace.sol作成します。

 // 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(); } }

👉migrates migrations/2_deploy_contracts.jsに移行スクリプトを記述する

const Marketplace = artifacts.require("Marketplace"); module.exports = function (deployer) { deployer.deploy(Marketplace); };

👉コントラクトをコンパイルしてデプロイするターミナル経由でコントラクトをコンパイルするには、次のコードを実行します。

 truffle compile

すべてが正しく実行されると、ターミナルに次のような信息内容が数字代表されます。

ターミナルで次のコマンドを実行して、 Marketplace.sol Rootstock のテストネットにデプロイします。

 truffle migrate --network rskTestnet

プロセスが实现目标すると、ターミナルに次のメッセージが显示されます。

マーケットプレイス dApp のフロントエンド開発

スマート コントラクトをデプロイしたので、ユーザーがマーケットプレイスとやり取りできる魅力女人的なフロントエンドを構築します。フロントエンドには、製品リスト、製品の追加、購入、カートへの製品の追加/削除、トランザクションの追跡、通知模板や進行状況バーなどのリアルタイム フィードバックの展示などの機能があります。

📥フロントエンド開発

👉Reactアプリケーションを校园营销推广活动初期化するフロントエンドにはReactを应用します。

プロジェクト ディレクトリで新しい React アプリを时候化します。

 npx create-react-app client

クライアント ディレクトリに移動します。

 cd client

UI用にWeb3とBootstrapをインストールする

npm install web3 bootstrap

👉プロジェクト構造図 1 に示すように、フロントエンドの構造が必要性になります。

👉src src/utils/Marketplace.jsonでの Web3 セットアップ

スマート コントラクトと対話するには、ABI (アプリケーション バイナリ インターフェイス) をインポートします。

• 手順で説明したように、Truffle のbuild/contractsディレクトリからMarketplace.json ABI をclient/src/utils/フォルダにコピーします。

• Web3 のセットアップはApp.jsファイルにあります。これをからダウンロードし、図 1 に示すように適切なディレクトリに配置します。

👉 リアルタイム告知と進捗バー

リアルタイム通知のために、 react-toastifyのようなライブラリを統合します。プログレスバーにはreact-bootstrap使用することもできます。

clientディレクトリにReact Toastifyをインストールする

npm install react-toastify

👉HTTP リクエスト (Pinata の API へ) 用に Axios をインストールします。

 npm install axios

さて、 のクライアント フォルダー (フォルダー + ファイルを含む) からすべてのフロントエンド コンポーネントをダウンロードしてください。そして、適切なディレクトリに运行环境します。

📥アプリの最終仕上げと操作

👉これで、dApp を动用できるようになりました。ターミナルで次のコマンドを动用して、React アプリを実行できます。

 npm start

デフォルトのブラウザが自動的に開きます。MetMask ブラウザ拡張機能がインストールされ、RSK テストネットが適切に設定されていることを確認してください (プロジェクトのガイドに従って正しいネットワークを選択できます)。

ここで、React アプリは MetaMask ウォレット拡張機能を呼び出します。呼び出しを確認してください。次の図に示すように、接続されたウォレットがメイン インターフェイスに显示されます。

フロントエンドには豊富な機能があります。製品を追加/削除できます。そのたびに、MetaMask ウォレット拡張機能で呼び出しを確認するように求められます。次の gif を確認してください。

さて、これで、dApp がカートに追加されたトランザクションを適切に処理するかどうかをテストできます。「トランザクション履歴」セクションで、すべての技術的な詳細を含む詳細なトランザクション履歴を確認できます。購入が过后すると、dApp に製品を追加した几乎账面价值に資金が送られます。

一緒にアプリをテストしましょう:

おめでとうございます！RSK テストネットで dApp の開発とテストに出色しました。需要な機能を追加することで、RSK メインネットに切り替えることができます。テストネットが言及されているコードを調整するだけで、本番環境対応のアプリを急いで構築する場合は、ここにあるも確認してください。

📥潜在的な課題と将来:

これは、製品の配载、ピックアップなどのいくつかのプロセスを含む農業市場を開始するための新しいアプローチになります。買い手と売り手の詳細を知らなければ、信頼の問題が生じる可能会性があります。もう 1 つの課題は、まだ実験段階であり、進化するこの技術に対して消費者がどのように反応するかがわからないことです。

したがって、農家と消費者の両方が新しい技術を採用するには、幼小衔接とトレーニングが不得欠です。また、十分的な協力関係は、農産物の持続已经な乳状液型市場を開発するための核心な关键です。

結論：

Rootstock (RSK) テストネット上に发散型農業マーケットプレイスを構築することに成功的英文しました。セキュリティを最優先に考え、OpenZeppelin 契約を动用してスマートコントラクト コードを保護するための対策を講じています。テスト済みの dApp には、シンプルな发散型マーケットプレイスに一定要なほぼすべての機能が含まれていますが、Rootstock のメインネットでアプリを起動する予定がある場合は、さらに多くの機能を追加して強化できます。また、すべてが意図したとおりにスムーズに機能するように、セキュリティにも留神してください。

私たちは、すべての取引を進めるために、取引手数料が低い Rootstock の高速路取引処理機能を活用しようと試みました。これにより、ビットコインの悪名高い混雑問題が解決されます。もちろん、このような增溶型マーケットプレイスには多くの問題が伴いますが、私たちは而且人权を求めているので、过去的にはより增溶化されたマーケットプレイスが見つかると看好できます。