NFT మింటర్ ట్యుటోరియల్
Web2 నేపథ్యం నుండి వచ్చే డెవలపర్లకు ఎదురయ్యే అతిపెద్ద సవాళ్లలో ఒకటి, మీ స్మార్ట్ కాంట్రాక్ట్ను ఫ్రంటెండ్ ప్రాజెక్ట్కు ఎలా కనెక్ట్ చేయాలో మరియు దానితో ఎలా సంభాషించాలో గుర్తించడం.
ఒక NFT మింటర్ను నిర్మించడం ద్వారా — మీ డిజిటల్ ఆస్తికి ఒక లింక్, ఒక శీర్షిక మరియు ఒక వివరణను మీరు ఇన్పుట్ చేయగల ఒక సులభమైన UI — మీరు ఎలాగో నేర్చుకుంటారు:
- మీ ఫ్రంటెండ్ ప్రాజెక్ట్ ద్వారా MetaMaskకు కనెక్ట్ అవ్వండి
- మీ ఫ్రంటెండ్ నుండి స్మార్ట్ కాంట్రాక్ట్ పద్ధతులను కాల్ చేయండి
- MetaMask ఉపయోగించి లావాదేవీలపై సంతకం చేయండి
ఈ ట్యుటోరియల్లో, మేము మా ఫ్రంటెండ్ ఫ్రేమ్వర్క్గా Reactopens in a new tab ను ఉపయోగిస్తాము. ఈ ట్యుటోరియల్ ప్రధానంగా Web3 అభివృద్ధిపై దృష్టి సారించినందున, మేము React ప్రాథమిక అంశాలను విడమరచి చెప్పడానికి ఎక్కువ సమయం వెచ్చించము. బదులుగా, మేము మా ప్రాజెక్ట్కు కార్యాచరణను తీసుకురావడంపై దృష్టి పెడతాము.
ఒక ముందస్తు అవసరంగా, మీకు React గురించి ప్రాథమిక స్థాయి అవగాహన ఉండాలి—కాంపోనెంట్లు, ప్రాప్స్, useState/useEffect, మరియు ప్రాథమిక ఫంక్షన్ కాలింగ్ ఎలా పనిచేస్తాయో తెలిసి ఉండాలి. మీరు ఇంతకు ముందు ఆ పదాలలో దేనినీ విని ఉండకపోతే, మీరు ఈ React ట్యుటోరియల్కు పరిచయంopens in a new tab ను చూడాలనుకోవచ్చు. దృశ్య అభ్యాసకుల కోసం, మేము Net Ninja ద్వారా రూపొందించబడిన ఈ అద్భుతమైన పూర్తి ఆధునిక React ట్యుటోరియల్opens in a new tab వీడియో సిరీస్ను గట్టిగా సిఫార్సు చేస్తున్నాము.
మరియు మీరు ఇప్పటికే చేయకపోతే, ఈ ట్యుటోరియల్ను పూర్తి చేయడానికి అలాగే బ్లాక్చైన్లో ఏదైనా నిర్మించడానికి మీకు ఖచ్చితంగా ఒక Alchemy ఖాతా అవసరం. ఇక్కడopens in a new tab ఒక ఉచిత ఖాతా కోసం సైన్ అప్ చేయండి.
ఇంకా ఆలస్యం చేయకుండా, ప్రారంభిద్దాం!
NFTలను తయారు చేయడం 101
మేము ఏదైనా కోడ్ను చూడటం ప్రారంభించడానికి ముందు, ఒక NFTని తయారు చేయడం ఎలా పనిచేస్తుందో అర్థం చేసుకోవడం ముఖ్యం. ఇందులో రెండు దశలు ఉంటాయి:
Ethereum బ్లాక్చైన్పై ఒక NFT స్మార్ట్ కాంట్రాక్ట్ను ప్రచురించండి
రెండు NFT స్మార్ట్ కాంట్రాక్ట్ ప్రమాణాల మధ్య అతిపెద్ద వ్యత్యాసం ఏమిటంటే, ERC-1155 ఒక మల్టీ-టోకెన్ ప్రమాణం మరియు బ్యాచ్ కార్యాచరణను కలిగి ఉంటుంది, అయితే ERC-721 ఒక సింగిల్-టోకెన్ ప్రమాణం మరియు అందువల్ల ఒకేసారి ఒక టోకెన్ను మాత్రమే బదిలీ చేయడానికి మద్దతు ఇస్తుంది.
మింటింగ్ ఫంక్షన్ను కాల్ చేయండి
సాధారణంగా, ఈ మింటింగ్ ఫంక్షన్కు మీరు రెండు వేరియబుల్స్ను పారామీటర్లుగా పాస్ చేయవలసి ఉంటుంది, మొదట recipient, ఇది మీ తాజాగా ముద్రించబడిన NFTని స్వీకరించే చిరునామాను నిర్దేశిస్తుంది, మరియు రెండవది NFT యొక్క tokenURI, ఇది NFT యొక్క మెటాడేటాను వివరించే ఒక JSON డాక్యుమెంట్కు పరిష్కరించే ఒక స్ట్రింగ్.
ఒక NFT యొక్క మెటాడేటా నిజంగా దానికి జీవం పోస్తుంది, దానిని ఒక పేరు, వివరణ, చిత్రం (లేదా విభిన్న డిజిటల్ ఆస్తి), మరియు ఇతర గుణాలను కలిగి ఉండటానికి అనుమతిస్తుంది. ఇక్కడ ఒక tokenURI ఉదాహరణopens in a new tab ఉంది, ఇందులో ఒక NFT యొక్క మెటాడేటా ఉంటుంది.
ఈ ట్యుటోరియల్లో, మేము రెండవ భాగంపై దృష్టి పెట్టబోతున్నాము, మా React UIని ఉపయోగించి ఇప్పటికే ఉన్న NFT యొక్క స్మార్ట్ కాంట్రాక్ట్ మింటింగ్ ఫంక్షన్ను కాల్ చేయడం.
ఈ ట్యుటోరియల్లో మేము కాల్ చేయబోయే ERC-721 NFT స్మార్ట్ కాంట్రాక్ట్కి ఇక్కడ ఒక లింక్opens in a new tab ఉంది. మేము దానిని ఎలా తయారు చేశామో మీరు తెలుసుకోవాలనుకుంటే, మా ఇతర ట్యుటోరియల్, "ఒక NFTని ఎలా సృష్టించాలి"opens in a new tab ను చూడమని మేము గట్టిగా సిఫార్సు చేస్తున్నాము.
బాగుంది, ఇప్పుడు ఒక NFTని తయారు చేయడం ఎలా పనిచేస్తుందో మనకు అర్థమైంది, మా స్టార్టర్ ఫైల్లను క్లోన్ చేద్దాం!
స్టార్టర్ ఫైల్లను క్లోన్ చేయండి
మొదట, ఈ ప్రాజెక్ట్ కోసం స్టార్టర్ ఫైల్లను పొందడానికి nft-minter-tutorial GitHub రిపోజిటరీopens in a new tab కి వెళ్ళండి. ఈ రిపోజిటరీని మీ స్థానిక వాతావరణంలోకి క్లోన్ చేయండి.
మీరు ఈ క్లోన్ చేయబడిన nft-minter-tutorial రిపోజిటరీని తెరిచినప్పుడు, అందులో రెండు ఫోల్డర్లు ఉన్నాయని మీరు గమనిస్తారు: minter-starter-files మరియు nft-minter.
minter-starter-filesలో ఈ ప్రాజెక్ట్ కోసం స్టార్టర్ ఫైల్లు (ముఖ్యంగా React UI) ఉన్నాయి. ఈ ట్యుటోరియల్లో, మేము ఈ డైరెక్టరీలో పని చేస్తాము, మీరు ఈ UIని మీ Ethereum వాలెట్ మరియు ఒక NFT స్మార్ట్ కాంట్రాక్ట్కు కనెక్ట్ చేయడం ద్వారా దానికి జీవం పోయడం ఎలాగో నేర్చుకుంటారు.nft-minterపూర్తి ట్యుటోరియల్ను కలిగి ఉంది మరియు మీరు ఇరుక్కుపోయినట్లయితే సూచనగా మీ కోసం అక్కడ ఉంది.
తరువాత, మీ కోడ్ ఎడిటర్లో మీ minter-starter-files కాపీని తెరిచి, ఆపై మీ src ఫోల్డర్లోకి నావిగేట్ చేయండి.
మేము వ్రాసే కోడ్ అంతా src ఫోల్డర్ కింద ఉంటుంది. మేము Minter.js కాంపోనెంట్ను సవరించడం మరియు మా ప్రాజెక్ట్కు Web3 కార్యాచరణను అందించడానికి అదనపు జావాస్క్రిప్ట్ ఫైల్లను వ్రాయడం చేస్తాము.
దశ 2: మా స్టార్టర్ ఫైల్లను చూడండి
మేము కోడింగ్ ప్రారంభించడానికి ముందు, స్టార్టర్ ఫైల్లలో మాకు ఇప్పటికే ఏమి అందించబడిందో చూడటం ముఖ్యం.
మీ react ప్రాజెక్ట్ను రన్ చేయండి
మా బ్రౌజర్లో React ప్రాజెక్ట్ను రన్ చేయడం ద్వారా ప్రారంభిద్దాం. React యొక్క అందం ఏమిటంటే, మా బ్రౌజర్లో మా ప్రాజెక్ట్ రన్ అవుతున్నప్పుడు, మేము సేవ్ చేసే ఏవైనా మార్పులు మా బ్రౌజర్లో ప్రత్యక్షంగా అప్డేట్ చేయబడతాయి.
ప్రాజెక్ట్ను రన్ చేయడానికి, minter-starter-files ఫోల్డర్ యొక్క రూట్ డైరెక్టరీకి నావిగేట్ చేయండి, మరియు ప్రాజెక్ట్ యొక్క డిపెండెన్సీలను ఇన్స్టాల్ చేయడానికి మీ టెర్మినల్లో npm install రన్ చేయండి:
cd minter-starter-filesnpm installఅవి ఇన్స్టాల్ చేయడం పూర్తయిన తర్వాత, మీ టెర్మినల్లో npm start రన్ చేయండి:
npm startఅలా చేయడం వలన మీ బ్రౌజర్లో http://localhost:3000/opens in a new tab తెరుచుకోవాలి, అక్కడ మీరు మా ప్రాజెక్ట్ కోసం ఫ్రంటెండ్ను చూస్తారు. ఇది 3 ఫీల్డ్లను కలిగి ఉండాలి: మీ NFT యొక్క ఆస్తికి ఒక లింక్ను ఇన్పుట్ చేయడానికి ఒక స్థలం, మీ NFT పేరును నమోదు చేయండి మరియు ఒక వివరణను అందించండి.
మీరు "వాలెట్ను కనెక్ట్ చేయండి" లేదా "NFTని ముద్రించండి" బటన్లను క్లిక్ చేయడానికి ప్రయత్నిస్తే, అవి పనిచేయవని మీరు గమనిస్తారు—అందుకు కారణం మేము ఇంకా వాటి కార్యాచరణను ప్రోగ్రామ్ చేయాలి! :)
Minter.js కాంపోనెంట్
గమనిక: మీరు minter-starter-files ఫోల్డర్లో ఉన్నారని మరియు nft-minter ఫోల్డర్లో లేరని నిర్ధారించుకోండి!
మా ఎడిటర్లోని src ఫోల్డర్లోకి తిరిగి వెళ్లి, Minter.js ఫైల్ను తెరుద్దాం. ఈ ఫైల్లోని ప్రతిదాన్ని మనం అర్థం చేసుకోవడం చాలా ముఖ్యం, ఎందుకంటే ఇది మనం పని చేయబోయే ప్రాథమిక React కాంపోనెంట్.
ఈ ఫైల్ పైన, మా స్టేట్ వేరియబుల్స్ ఉన్నాయి, వాటిని మేము నిర్దిష్ట ఈవెంట్ల తర్వాత అప్డేట్ చేస్తాము.
1//State variables2const [walletAddress, setWallet] = useState("")3const [status, setStatus] = useState("")4const [name, setName] = useState("")5const [description, setDescription] = useState("")6const [url, setURL] = useState("")React స్టేట్ వేరియబుల్స్ లేదా స్టేట్ హుక్స్ గురించి ఎప్పుడూ వినలేదా? ఈopens in a new tab డాక్స్ను చూడండి.
ప్రతి వేరియబుల్ దేనిని సూచిస్తుందో ఇక్కడ ఉంది:
walletAddress- వినియోగదారుడి వాలెట్ చిరునామాను నిల్వ చేసే ఒక స్ట్రింగ్status- UI దిగువన ప్రదర్శించడానికి ఒక సందేశాన్ని కలిగి ఉన్న ఒక స్ట్రింగ్name- NFT పేరును నిల్వ చేసే ఒక స్ట్రింగ్description- NFT వివరణను నిల్వ చేసే ఒక స్ట్రింగ్url- NFT యొక్క డిజిటల్ ఆస్తికి ఒక లింక్ అయిన ఒక స్ట్రింగ్
స్టేట్ వేరియబుల్స్ తర్వాత, మీరు మూడు అమలు చేయని ఫంక్షన్లను చూస్తారు: useEffect, connectWalletPressed, మరియు onMintPressed. ఈ ఫంక్షన్లన్నీ async అని మీరు గమనిస్తారు, అందుకు కారణం మేము వాటిలో అసమకాలిక API కాల్స్ చేస్తాము! వాటి పేర్లు వాటి కార్యాచరణలకు పర్యాయపదాలుగా ఉన్నాయి:
1useEffect(async () => {2 //TODO: implement3}, [])45const connectWalletPressed = async () => {6 //TODO: implement7}89const onMintPressed = async () => {10 //TODO: implement11}అన్నీ చూపించుuseEffectopens in a new tab - ఇది మీ కాంపోనెంట్ రెండర్ అయిన తర్వాత కాల్ చేయబడే ఒక React హుక్. దీనికి ఒక ఖాళీ శ్రేణి[]ప్రాప్ పాస్ చేయబడినందున (3వ పంక్తిని చూడండి), ఇది కాంపోనెంట్ యొక్క మొదటి రెండర్లో మాత్రమే కాల్ చేయబడుతుంది. ఒక వాలెట్ ఇప్పటికే కనెక్ట్ చేయబడిందో లేదో ప్రతిబింబించేలా మా UIని అప్డేట్ చేయడానికి ఇక్కడ మేము మా వాలెట్ లిజనర్ మరియు మరొక వాలెట్ ఫంక్షన్ను కాల్ చేస్తాము.connectWalletPressed- ఈ ఫంక్షన్ వినియోగదారుడి MetaMask వాలెట్ను మా డాప్కు కనెక్ట్ చేయడానికి కాల్ చేయబడుతుంది.onMintPressed- ఈ ఫంక్షన్ వినియోగదారుడి NFTని ముద్రించడానికి కాల్ చేయబడుతుంది.
ఈ ఫైల్ చివరిలో, మా కాంపోనెంట్ యొక్క UI ఉంది. మీరు ఈ కోడ్ను జాగ్రత్తగా స్కాన్ చేస్తే, వాటి సంబంధిత టెక్స్ట్ ఫీల్డ్లలోని ఇన్పుట్ మారినప్పుడు మేము మా url, name, మరియు description స్టేట్ వేరియబుల్స్ను అప్డేట్ చేస్తామని మీరు గమనిస్తారు.
మీరు mintButton మరియు walletButton ఐడీలతో ఉన్న బటన్లను వరుసగా క్లిక్ చేసినప్పుడు connectWalletPressed మరియు onMintPressed కాల్ చేయబడతాయని కూడా మీరు చూస్తారు.
1//the UI of our component2return (3 <div className="Minter">4 <button id="walletButton" onClick={connectWalletPressed}>5 {walletAddress.length > 0 ? (6 "Connected: " +7 String(walletAddress).substring(0, 6) +8 "..." +9 String(walletAddress).substring(38)10 ) : (11 <span>Connect Wallet</span>12 )}13 </button>1415 <br></br>16 <h1 id="title">🧙♂️ Alchemy NFT Minter</h1>17 <p>18 Simply add your asset's link, name, and description, then press "Mint."19 </p>20 <form>21 <h2>🖼 Link to asset: </h2>22 <input23 type="text"24 placeholder="e.g., https://gateway.pinata.cloud/ipfs/<hash>"25 onChange={(event) => setURL(event.target.value)}26 />27 <h2>🤔 Name: </h2>28 <input29 type="text"30 placeholder="e.g., My first NFT!"31 onChange={(event) => setName(event.target.value)}32 />33 <h2>✍️ Description: </h2>34 <input35 type="text"36 placeholder="e.g., Even cooler than cryptokitties ;)"37 onChange={(event) => setDescription(event.target.value)}38 />39 </form>40 <button id="mintButton" onClick={onMintPressed}>41 Mint NFT42 </button>43 <p id="status">{status}</p>44 </div>45)అన్నీ చూపించుచివరగా, ఈ Minter కాంపోనెంట్ ఎక్కడ జోడించబడిందో చూద్దాం.
మీరు App.js ఫైల్కు వెళితే, ఇది React లోని ప్రధాన కాంపోనెంట్, ఇది అన్ని ఇతర కాంపోనెంట్లకు ఒక కంటైనర్గా పనిచేస్తుంది, మా Minter కాంపోనెంట్ 7వ పంక్తిలో ఇంజెక్ట్ చేయబడిందని మీరు చూస్తారు.
ఈ ట్యుటోరియల్లో, మేము కేవలం Minter.js ఫైల్ను సవరించడం మరియు మా src ఫోల్డర్లో ఫైల్లను జోడించడం మాత్రమే చేస్తాము.
ఇప్పుడు మనం దేనితో పనిచేస్తున్నామో అర్థమైంది, మా Ethereum వాలెట్ను సెటప్ చేద్దాం!
మీ Ethereum వాలెట్ను సెటప్ చేయండి
వినియోగదారులు మీ స్మార్ట్ కాంట్రాక్ట్తో సంభాషించగలగడానికి, వారు తమ Ethereum వాలెట్ను మీ డాప్కు కనెక్ట్ చేయవలసి ఉంటుంది.
MetaMaskను డౌన్లోడ్ చేయండి
ఈ ట్యుటోరియల్ కోసం, మేము MetaMaskను ఉపయోగిస్తాము, ఇది మీ ఇతీరియము అకౌంట్ చిరునామాను నిర్వహించడానికి ఉపయోగించే బ్రౌజర్లోని వర్చువల్ వాలెట్. Ethereum పై లావాదేవీలు ఎలా పనిచేస్తాయో మీరు మరింత అర్థం చేసుకోవాలనుకుంటే, ఈ పేజీని చూడండి.
మీరు ఇక్కడopens in a new tab ఉచితంగా MetaMask అకౌంట్ను డౌన్లోడ్ చేసి, సృష్టించవచ్చు. మీరు ఒక ఖాతాను సృష్టిస్తున్నప్పుడు, లేదా మీకు ఇప్పటికే ఒక ఖాతా ఉన్నట్లయితే, కుడి ఎగువన ఉన్న “Ropsten టెస్టునెట్” కు మారారని నిర్ధారించుకోండి (తద్వారా మనం నిజమైన డబ్బుతో వ్యవహరించడం లేదు).
ఫాసెట్ నుండి ఈథర్ జోడించండి
మా NFTలను ముద్రించడానికి (లేదా Ethereum బ్లాక్చైన్లో ఏవైనా లావాదేవీలపై సంతకం చేయడానికి), మాకు కొంత నకిలీ Eth అవసరం. Eth పొందడానికి మీరు Ropsten ఫాసెట్opens in a new tab కు వెళ్లి, మీ Ropsten ఖాతా చిరునామాను నమోదు చేసి, ఆపై “Ropsten Eth పంపించు.” క్లిక్ చేయవచ్చు. త్వరలోనే మీ MetaMask ఖాతాలో Eth కనిపించాలి!
మీ బ్యాలెన్స్ను తనిఖీ చేయండి
మా బ్యాలెన్స్ అక్కడ ఉందని నిర్ధారించుకోవడానికి, Alchemy యొక్క కంపోజర్ సాధనాన్నిopens in a new tab ఉపయోగించి ఒక eth_getBalanceopens in a new tab అభ్యర్థన చేద్దాం. ఇది మా వాలెట్లోని Eth మొత్తాన్ని తిరిగి ఇస్తుంది. మీరు మీ MetaMask అకౌంట్ చిరునామాను ఇన్పుట్ చేసి, “అభ్యర్థన పంపు” క్లిక్ చేసిన తర్వాత, మీరు ఇలాంటి ప్రతిస్పందనను చూడాలి:
1{"jsonrpc": "2.0", "id": 0, "result": "0xde0b6b3a7640000"}గమనిక: ఈ ఫలితం weiలో ఉంది, ethలో కాదు. ఈథర్ యొక్క అతి చిన్న ప్రమాణంగా వీని ఉపయోగిస్తారు. wei నుండి ethకి మార్పిడి: 1 eth = 10¹⁸ wei. కాబట్టి మనం 0xde0b6b3a7640000 ను దశాంశానికి మార్చితే మనకు 1*10¹⁸ వస్తుంది, ఇది 1 ethకి సమానం.
అమ్మయ్య! మా నకిలీ డబ్బు అంతా అక్కడే ఉంది!
మీ UIకి MetaMaskని కనెక్ట్ చేయండి
ఇప్పుడు మా MetaMask వాలెట్ సెటప్ చేయబడింది, మా డాప్ను దానికి కనెక్ట్ చేద్దాం!
మేము MVCopens in a new tab పారడైమ్కు కట్టుబడి ఉండాలని కోరుకుంటున్నందున, మా డాప్ యొక్క లాజిక్, డేటా మరియు నియమాలను నిర్వహించడానికి మా ఫంక్షన్లను కలిగి ఉన్న ఒక ప్రత్యేక ఫైల్ను సృష్టించి, ఆపై ఆ ఫంక్షన్లను మా ఫ్రంటెండ్ (మా Minter.js కాంపోనెంట్) కు పాస్ చేయబోతున్నాము.
connectWallet ఫంక్షన్
అలా చేయడానికి, మీ src డైరెక్టరీలో utils అనే కొత్త ఫోల్డర్ను సృష్టించి, దాని లోపల interact.js అనే ఫైల్ను జోడిద్దాం, ఇందులో మా వాలెట్ మరియు స్మార్ట్ కాంట్రాక్ట్ ఇంటరాక్షన్ ఫంక్షన్లు అన్నీ ఉంటాయి.
మా interact.js ఫైల్లో, మేము ఒక connectWallet ఫంక్షన్ను వ్రాస్తాము, దానిని మేము మా Minter.js కాంపోనెంట్లో దిగుమతి చేసుకుని కాల్ చేస్తాము.
మీ interact.js ఫైల్లో, కింది వాటిని జోడించండి
1export const connectWallet = async () => {2 if (window.ethereum) {3 try {4 const addressArray = await window.ethereum.request({5 method: "eth_requestAccounts",6 })7 const obj = {8 status: "👆🏽 Write a message in the text-field above.",9 address: addressArray[0],10 }11 return obj12 } catch (err) {13 return {14 address: "",15 status: "😥 " + err.message,16 }17 }18 } else {19 return {20 address: "",21 status: (22 <span>23 <p>24 {" "}25 🦊 <a target="_blank" href={`https://metamask.io/download`}>26 You must install MetaMask, a virtual Ethereum wallet, in your27 browser.28 </a>29 </p>30 </span>31 ),32 }33 }34}అన్నీ చూపించుఈ కోడ్ ఏమి చేస్తుందో విడమరచి చూద్దాం:
మొదట, మా ఫంక్షన్ మీ బ్రౌజర్లో window.ethereum ప్రారంభించబడిందో లేదో తనిఖీ చేస్తుంది.
window.ethereum అనేది MetaMask మరియు ఇతర వాలెట్ ప్రొవైడర్ల ద్వారా ఇంజెక్ట్ చేయబడిన గ్లోబల్ API, ఇది వెబ్సైట్లు వినియోగదారుల Ethereum ఖాతాలను అభ్యర్థించడానికి అనుమతిస్తుంది. ఆమోదించబడితే, ఇది వినియోగదారుడు కనెక్ట్ చేయబడిన బ్లాక్చైన్ల నుండి డేటాను చదవగలదు మరియు వినియోగదారుడు సందేశాలు మరియు లావాదేవీలపై సంతకం చేయమని సూచించగలదు. మరింత సమాచారం కోసం MetaMask డాక్స్opens in a new tab చూడండి!
window.ethereum ఉండకపోతే, అప్పుడు MetaMask ఇన్స్టాల్ చేయబడలేదని అర్థం. దీని ఫలితంగా ఒక JSON వస్తువు తిరిగి వస్తుంది, ఇక్కడ address తిరిగి వచ్చినది ఖాళీ స్ట్రింగ్, మరియు status JSX వస్తువు వినియోగదారుడు MetaMaskను ఇన్స్టాల్ చేయాలని తెలియజేస్తుంది.
మేము వ్రాసే చాలా ఫంక్షన్లు JSON వస్తువులను తిరిగి ఇస్తాయి, వాటిని మేము మా స్టేట్ వేరియబుల్స్ మరియు UIని అప్డేట్ చేయడానికి ఉపయోగించవచ్చు.
ఇప్పుడు window.ethereum ఉంటే, అప్పుడు విషయాలు ఆసక్తికరంగా మారతాయి.
ఒక try/catch లూప్ను ఉపయోగించి, మేము window.ethereum.request({ method: "eth_requestAccounts" });opens in a new tab కాల్ చేయడం ద్వారా MetaMaskకు కనెక్ట్ చేయడానికి ప్రయత్నిస్తాము. ఈ ఫంక్షన్ను కాల్ చేయడం వలన బ్రౌజర్లో MetaMask తెరుచుకుంటుంది, దీని ద్వారా వినియోగదారుడు తమ వాలెట్ను మీ డాప్కు కనెక్ట్ చేయమని ప్రాంప్ట్ చేయబడతారు.
- వినియోగదారుడు కనెక్ట్ చేయడానికి ఎంచుకుంటే,
method: "eth_requestAccounts"డాప్కు కనెక్ట్ చేయబడిన వినియోగదారుడి అన్ని ఖాతా చిరునామాలను కలిగి ఉన్న ఒక శ్రేణిని తిరిగి ఇస్తుంది. మొత్తం మీద, మాconnectWalletఫంక్షన్ ఈ శ్రేణిలోని మొదటిaddress(9వ పంక్తిని చూడండి) మరియు స్మార్ట్ కాంట్రాక్ట్కు ఒక సందేశం వ్రాయమని వినియోగదారుడిని ప్రాంప్ట్ చేసే ఒకstatusసందేశాన్ని కలిగి ఉన్న ఒక JSON వస్తువును తిరిగి ఇస్తుంది. - వినియోగదారుడు కనెక్షన్ను తిరస్కరిస్తే, అప్పుడు JSON వస్తువు తిరిగి వచ్చిన
addressకోసం ఖాళీ స్ట్రింగ్ను మరియు వినియోగదారుడు కనెక్షన్ను తిరస్కరించినట్లు ప్రతిబింబించే ఒకstatusసందేశాన్ని కలిగి ఉంటుంది.
మీ Minter.js UI కాంపోనెంట్కు connectWallet ఫంక్షన్ను జోడించండి
ఇప్పుడు మేము ఈ connectWallet ఫంక్షన్ను వ్రాశాము, దానిని మా Minter.js. కాంపోనెంట్కు కనెక్ట్ చేద్దాం.
మొదట, మేము మా ఫంక్షన్ను మా Minter.js ఫైల్లోకి import { connectWallet } from "./utils/interact.js"; ను Minter.js ఫైల్ పైభాగానికి జోడించడం ద్వారా దిగుమతి చేసుకోవాలి. Minter.js యొక్క మీ మొదటి 11 పంక్తులు ఇప్పుడు ఇలా కనిపించాలి:
1import { useEffect, useState } from "react";2import { connectWallet } from "./utils/interact.js";34const Minter = (props) => {56 //State variables7 const [walletAddress, setWallet] = useState("");8 const [status, setStatus] = useState("");9 const [name, setName] = useState("");10 const [description, setDescription] = useState("");11 const [url, setURL] = useState("");అన్నీ చూపించుఅప్పుడు, మా connectWalletPressed ఫంక్షన్ లోపల, మేము మా దిగుమతి చేసుకున్న connectWallet ఫంక్షన్ను ఇలా కాల్ చేస్తాము:
1const connectWalletPressed = async () => {2 const walletResponse = await connectWallet()3 setStatus(walletResponse.status)4 setWallet(walletResponse.address)5}మా Minter.js కాంపోనెంట్ నుండి interact.js ఫైల్ నుండి మా కార్యాచరణలో చాలా వరకు ఎలా సంగ్రహించబడిందో గమనించండి? ఇది మేము M-V-C పారడైమ్కు కట్టుబడి ఉండటానికి!
connectWalletPressedలో, మేము కేవలం మా దిగుమతి చేసుకున్న connectWallet ఫంక్షన్కు ఒక await కాల్ చేస్తాము, మరియు దాని ప్రతిస్పందనను ఉపయోగించి, మేము మా status మరియు walletAddress వేరియబుల్స్ను వాటి స్టేట్ హుక్స్ ద్వారా అప్డేట్ చేస్తాము.
ఇప్పుడు, Minter.js మరియు interact.js రెండు ఫైల్లను సేవ్ చేసి, ఇప్పటివరకు మా UIని పరీక్షిద్దాం.
localhost:3000లో మీ బ్రౌజర్ను తెరిచి, పేజీ యొక్క కుడి ఎగువన ఉన్న "వాలెట్ను కనెక్ట్ చేయండి" బటన్ను నొక్కండి.
మీరు MetaMaskను ఇన్స్టాల్ చేసి ఉంటే, మీ వాలెట్ను మీ డాప్కు కనెక్ట్ చేయమని మిమ్మల్ని ప్రాంప్ట్ చేయాలి. కనెక్ట్ చేయడానికి ఆహ్వానాన్ని అంగీకరించండి.
వాలెట్ బటన్ ఇప్పుడు మీ చిరునామా కనెక్ట్ చేయబడిందని ప్రతిబింబిస్తుందని మీరు చూడాలి.
తరువాత, పేజీని రిఫ్రెష్ చేయడానికి ప్రయత్నించండి... ఇది వింతగా ఉంది. మా వాలెట్ బటన్ MetaMaskను కనెక్ట్ చేయమని మమ్మల్ని ప్రాంప్ట్ చేస్తోంది, అది ఇప్పటికే కనెక్ట్ చేయబడి ఉన్నప్పటికీ...
అయినప్పటికీ చింతించకండి! getCurrentWalletConnected అనే ఫంక్షన్ను అమలు చేయడం ద్వారా మేము దానిని సులభంగా పరిష్కరించవచ్చు, ఇది మా డాప్కు ఒక చిరునామా ఇప్పటికే కనెక్ట్ చేయబడిందో లేదో తనిఖీ చేస్తుంది మరియు తదనుగుణంగా మా UIని అప్డేట్ చేస్తుంది!
getCurrentWalletConnected ఫంక్షన్
మీ interact.js ఫైల్లో, కింది getCurrentWalletConnected ఫంక్షన్ను జోడించండి:
1export const getCurrentWalletConnected = async () => {2 if (window.ethereum) {3 try {4 const addressArray = await window.ethereum.request({5 method: "eth_accounts",6 })7 if (addressArray.length > 0) {8 return {9 address: addressArray[0],10 status: "👆🏽 Write a message in the text-field above.",11 }12 } else {13 return {14 address: "",15 status: "🦊 Connect to MetaMask using the top right button.",16 }17 }18 } catch (err) {19 return {20 address: "",21 status: "😥 " + err.message,22 }23 }24 } else {25 return {26 address: "",27 status: (28 <span>29 <p>30 {" "}31 🦊 <a target="_blank" href={`https://metamask.io/download`}>32 You must install MetaMask, a virtual Ethereum wallet, in your33 browser.34 </a>35 </p>36 </span>37 ),38 }39 }40}అన్నీ చూపించుఈ కోడ్ మేము ఇందాక వ్రాసిన connectWallet ఫంక్షన్కు చాలా సారూప్యంగా ఉంటుంది.
ప్రధాన వ్యత్యాసం ఏమిటంటే, ఇక్కడ మేము eth_requestAccounts పద్ధతిని కాల్ చేయడానికి బదులుగా, ఇది వినియోగదారుడు తమ వాలెట్ను కనెక్ట్ చేయడానికి MetaMaskను తెరుస్తుంది, ఇక్కడ మేము eth_accounts పద్ధతిని కాల్ చేస్తాము, ఇది కేవలం మా డాప్కు ప్రస్తుతం కనెక్ట్ చేయబడిన MetaMask చిరునామాలను కలిగి ఉన్న ఒక శ్రేణిని తిరిగి ఇస్తుంది.
ఈ ఫంక్షన్ను చర్యలో చూడటానికి, మా Minter.js కాంపోనెంట్ యొక్క useEffect ఫంక్షన్లో దానిని కాల్ చేద్దాం.
మేము connectWallet కోసం చేసినట్లే, మేము ఈ ఫంక్షన్ను మా interact.js ఫైల్ నుండి మా Minter.js ఫైల్లోకి ఇలా దిగుమతి చేసుకోవాలి:
1import { useEffect, useState } from "react"2import {3 connectWallet,4 getCurrentWalletConnected, //import here5} from "./utils/interact.js"ఇప్పుడు, మేము దానిని మా useEffect ఫంక్షన్లో కేవలం కాల్ చేస్తాము:
1useEffect(async () => {2 const { address, status } = await getCurrentWalletConnected()3 setWallet(address)4 setStatus(status)5}, [])గమనించండి, మేము మా walletAddress మరియు status స్టేట్ వేరియబుల్స్ను అప్డేట్ చేయడానికి మా getCurrentWalletConnected కాల్ యొక్క ప్రతిస్పందనను ఉపయోగిస్తాము.
మీరు ఈ కోడ్ను జోడించిన తర్వాత, మా బ్రౌజర్ విండోను రిఫ్రెష్ చేయడానికి ప్రయత్నించండి. బటన్ మీరు కనెక్ట్ అయ్యారని చెప్పాలి, మరియు మీరు రిఫ్రెష్ చేసిన తర్వాత కూడా మీ కనెక్ట్ చేయబడిన వాలెట్ చిరునామా యొక్క ప్రివ్యూను చూపాలి!
addWalletListenerని అమలు చేయండి
మా డాప్ వాలెట్ సెటప్లో చివరి దశ వాలెట్ లిజనర్ను అమలు చేయడం, తద్వారా మా వాలెట్ స్టేట్ మారినప్పుడు, ఉదాహరణకు వినియోగదారుడు డిస్కనెక్ట్ చేసినప్పుడు లేదా ఖాతాలను మార్చినప్పుడు మా UI అప్డేట్ అవుతుంది.
మీ Minter.js ఫైల్లో, కింది విధంగా కనిపించే addWalletListener అనే ఫంక్షన్ను జోడించండి:
1function addWalletListener() {2 if (window.ethereum) {3 window.ethereum.on("accountsChanged", (accounts) => {4 if (accounts.length > 0) {5 setWallet(accounts[0])6 setStatus("👆🏽 Write a message in the text-field above.")7 } else {8 setWallet("")9 setStatus("🦊 Connect to MetaMask using the top right button.")10 }11 })12 } else {13 setStatus(14 <p>15 {" "}16 🦊 <a target="_blank" href={`https://metamask.io/download`}>17 You must install MetaMask, a virtual Ethereum wallet, in your browser.18 </a>19 </p>20 )21 }22}అన్నీ చూపించుఇక్కడ ఏమి జరుగుతుందో త్వరగా విడమరచి చూద్దాం:
- మొదట, మా ఫంక్షన్
window.ethereumప్రారంభించబడిందో లేదో తనిఖీ చేస్తుంది (అనగా, MetaMask ఇన్స్టాల్ చేయబడింది).- అది కాకపోతే, మేము కేవలం మా
statusస్టేట్ వేరియబుల్ను వినియోగదారుడిని MetaMaskను ఇన్స్టాల్ చేయమని ప్రాంప్ట్ చేసే ఒక JSX స్ట్రింగ్కు సెట్ చేస్తాము. - అది ప్రారంభించబడితే, మేము 3వ పంక్తిలో
window.ethereum.on("accountsChanged")లిజనర్ను సెట్ చేస్తాము, ఇది MetaMask వాలెట్లోని స్టేట్ మార్పులను వింటుంది, ఇందులో వినియోగదారుడు డాప్కు అదనపు ఖాతాను కనెక్ట్ చేసినప్పుడు, ఖాతాలను మార్చినప్పుడు, లేదా ఒక ఖాతాను డిస్కనెక్ట్ చేసినప్పుడు ఉంటాయి. కనీసం ఒక ఖాతా కనెక్ట్ చేయబడి ఉంటే,walletAddressస్టేట్ వేరియబుల్ లిజనర్ ద్వారా తిరిగి వచ్చినaccountsశ్రేణిలోని మొదటి ఖాతాగా అప్డేట్ చేయబడుతుంది. లేకపోతే,walletAddressఖాళీ స్ట్రింగ్గా సెట్ చేయబడుతుంది.
- అది కాకపోతే, మేము కేవలం మా
చివరగా, మేము దానిని మా useEffect ఫంక్షన్లో కాల్ చేయాలి:
1useEffect(async () => {2 const { address, status } = await getCurrentWalletConnected()3 setWallet(address)4 setStatus(status)56 addWalletListener()7}, [])మరియు ఇదుగో! మేము మా వాలెట్ కార్యాచరణ అంతా ప్రోగ్రామింగ్ పూర్తి చేసాము! ఇప్పుడు మా వాలెట్ సెటప్ చేయబడింది, మా NFTని ఎలా ముద్రించాలో కనుగొందాం!
NFT మెటాడేటా 101
కాబట్టి ఈ ట్యుటోరియల్ యొక్క 0వ దశలో మనం మాట్లాడిన NFT మెటాడేటా గుర్తుందా—ఇది ఒక NFTకి జీవం పోస్తుంది, దానికి డిజిటల్ ఆస్తి, పేరు, వివరణ మరియు ఇతర గుణాలు వంటి లక్షణాలను కలిగి ఉండటానికి అనుమతిస్తుంది.
మేము ఈ మెటాడేటాను ఒక JSON వస్తువుగా కాన్ఫిగర్ చేసి, దానిని నిల్వ చేయవలసి ఉంటుంది, తద్వారా మా స్మార్ట్ కాంట్రాక్ట్ యొక్క mintNFT ఫంక్షన్ను కాల్ చేసేటప్పుడు దానిని tokenURI పారామీటర్గా పాస్ చేయవచ్చు.
"ఆస్తికి లింక్", "పేరు", "వివరణ" ఫీల్డ్లలోని టెక్స్ట్ మా NFT యొక్క మెటాడేటా యొక్క విభిన్న లక్షణాలను కలిగి ఉంటుంది. మేము ఈ మెటాడేటాను ఒక JSON వస్తువుగా ఫార్మాట్ చేస్తాము, కానీ ఈ JSON వస్తువును ఎక్కడ నిల్వ చేయవచ్చో కొన్ని ఎంపికలు ఉన్నాయి:
- మేము దానిని Ethereum బ్లాక్చైన్లో నిల్వ చేయవచ్చు; అయితే, అలా చేయడం చాలా ఖరీదైనది.
- మేము దానిని AWS లేదా Firebase వంటి కేంద్రీకృత సర్వర్లో నిల్వ చేయవచ్చు. కానీ అది మా వికేంద్రీకరణ నీతిని ఓడిస్తుంది.
- మేము IPFS, ఒక వికేంద్రీకృత ప్రోటోకాల్ మరియు ఒక పంపిణీ చేయబడిన ఫైల్ సిస్టమ్లో డేటాను నిల్వ చేయడానికి మరియు పంచుకోవడానికి పీర్-టు-పీర్ నెట్వర్క్ను ఉపయోగించవచ్చు. ఈ ప్రోటోకాల్ వికేంద్రీకృతం మరియు ఉచితం కాబట్టి, ఇది మా ఉత్తమ ఎంపిక!
IPFSలో మా మెటాడేటాను నిల్వ చేయడానికి, మేము Pinataopens in a new tab, ఒక సౌకర్యవంతమైన IPFS API మరియు టూల్కిట్ను ఉపయోగిస్తాము. తదుపరి దశలో, దీన్ని ఖచ్చితంగా ఎలా చేయాలో మేము వివరిస్తాము!
మీ మెటాడేటాను IPFSకి పిన్ చేయడానికి Pinataను ఉపయోగించండి
మీకు Pinataopens in a new tab ఖాతా లేకపోతే, ఇక్కడopens in a new tab ఒక ఉచిత ఖాతా కోసం సైన్ అప్ చేయండి మరియు మీ ఇమెయిల్ మరియు ఖాతాను ధృవీకరించడానికి దశలను పూర్తి చేయండి.
మీ Pinata API కీని సృష్టించండి
https://pinata.cloud/keysopens in a new tab పేజీకి నావిగేట్ చేయండి, ఆపై పైన ఉన్న "కొత్త కీ" బటన్ను ఎంచుకోండి, అడ్మిన్ విడ్జెట్ను ప్రారంభించబడినట్లు సెట్ చేయండి మరియు మీ కీకి పేరు పెట్టండి.
అప్పుడు మీకు మీ API సమాచారంతో ఒక పాపప్ చూపబడుతుంది. దీన్ని ఎక్కడైనా భద్రంగా ఉంచారని నిర్ధారించుకోండి.
ఇప్పుడు మా కీ సెట్ చేయబడింది, దాన్ని మా ప్రాజెక్ట్కు జోడిద్దాం, తద్వారా దాన్ని ఉపయోగించవచ్చు.
ఒక .env ఫైల్ను సృష్టించండి
మేము మా Pinata కీ మరియు రహస్యాన్ని ఒక పర్యావరణ ఫైల్లో సురక్షితంగా నిల్వ చేయవచ్చు. మీ ప్రాజెక్ట్ డైరెక్టరీలో dotenv ప్యాకేజీనిopens in a new tab ఇన్స్టాల్ చేద్దాం.
మీ టెర్మినల్లో కొత్త ట్యాబ్ను తెరవండి (లోకల్ హోస్ట్ను నడుపుతున్న దాని నుండి వేరుగా) మరియు మీరు minter-starter-files ఫోల్డర్లో ఉన్నారని నిర్ధారించుకోండి, ఆపై మీ టెర్మినల్లో కింది ఆదేశాన్ని అమలు చేయండి:
1npm install dotenv --saveతరువాత, మీ కమాండ్ లైన్లో కింది వాటిని నమోదు చేయడం ద్వారా మీ minter-starter-files యొక్క రూట్ డైరెక్టరీలో ఒక .env ఫైల్ను సృష్టించండి:
1vim.envఇది vim (ఒక టెక్స్ట్ ఎడిటర్)లో మీ .env ఫైల్ను పాప్ అప్ చేస్తుంది. దాన్ని సేవ్ చేయడానికి మీ కీబోర్డ్లో "esc" + ":" + "q" ను ఆ క్రమంలో నొక్కండి.
తరువాత, VSCodeలో, మీ .env ఫైల్కు నావిగేట్ చేయండి మరియు మీ Pinata API కీ మరియు API రహస్యాన్ని దానికి జోడించండి, ఇలా:
1REACT_APP_PINATA_KEY = <pinata-api-key>2REACT_APP_PINATA_SECRET = <pinata-api-secret>ఫైల్ను సేవ్ చేయండి, ఆపై మీరు మీ JSON మెటాడేటాను IPFSకి అప్లోడ్ చేయడానికి ఫంక్షన్ను వ్రాయడానికి సిద్ధంగా ఉన్నారు!
opens in a new tabpinJSONToIPFSని అమలు చేయండి
అదృష్టవశాత్తు మాకు, Pinata కు IPFSకి JSON డేటాను అప్లోడ్ చేయడానికి ప్రత్యేకంగా ఒక APIopens in a new tab మరియు కొన్ని స్వల్ప మార్పులతో మేము ఉపయోగించగల ఒక అనుకూలమైన JavaScript తో axios ఉదాహరణ ఉంది.
మీ utils ఫోల్డర్లో, pinata.js అనే మరొక ఫైల్ను సృష్టించి, ఆపై మా Pinata రహస్యం మరియు కీని .env ఫైల్ నుండి ఇలా దిగుమతి చేసుకుందాం:
1require("dotenv").config()2const key = process.env.REACT_APP_PINATA_KEY3const secret = process.env.REACT_APP_PINATA_SECRETతరువాత, కింద నుండి అదనపు కోడ్ను మీ pinata.js ఫైల్లో అతికించండి. చింతించకండి, ప్రతిదీ ఏమిటో మేము విడమరచి చెబుతాము!
1require("dotenv").config()2const key = process.env.REACT_APP_PINATA_KEY3const secret = process.env.REACT_APP_PINATA_SECRET45const axios = require("axios")67export const pinJSONToIPFS = async (JSONBody) => {8 const url = `https://api.pinata.cloud/pinning/pinJSONToIPFS`9 //making axios POST request to Pinata ⬇️10 return axios11 .post(url, JSONBody, {12 headers: {13 pinata_api_key: key,14 pinata_secret_api_key: secret,15 },16 })17 .then(function (response) {18 return {19 success: true,20 pinataUrl:21 "https://gateway.pinata.cloud/ipfs/" + response.data.IpfsHash,22 }23 })24 .catch(function (error) {25 console.log(error)26 return {27 success: false,28 message: error.message,29 }30 })31}అన్నీ చూపించుకాబట్టి ఈ కోడ్ ఖచ్చితంగా ఏమి చేస్తుంది?
మొదట, ఇది axiosopens in a new tab, బ్రౌజర్ మరియు node.js కోసం ఒక ప్రామిస్ ఆధారిత HTTP క్లయింట్ను దిగుమతి చేసుకుంటుంది, దీనిని మేము Pinata కు ఒక అభ్యర్థన చేయడానికి ఉపయోగిస్తాము.
అప్పుడు మాకు మా అసమకాలిక ఫంక్షన్ pinJSONToIPFS ఉంది, ఇది ఒక JSONBodyని దాని ఇన్పుట్గా మరియు దాని హెడర్లో Pinata api కీ మరియు రహస్యాన్ని తీసుకుంటుంది, అన్నీ వారి pinJSONToIPFS APIకి ఒక POST అభ్యర్థన చేయడానికి.
- ఈ POST అభ్యర్థన విజయవంతమైతే, అప్పుడు మా ఫంక్షన్
successబూలియన్ నిజంగా మరియు మా మెటాడేటా పిన్ చేయబడినpinataUrlతో ఒక JSON వస్తువును తిరిగి ఇస్తుంది. మేము ఈpinataUrlను మా స్మార్ట్ కాంట్రాక్ట్ మింట్ ఫంక్షన్కుtokenURIఇన్పుట్గా ఉపయోగిస్తాము. - ఈ పోస్ట్ అభ్యర్థన విఫలమైతే, అప్పుడు మా ఫంక్షన్
successబూలియన్ తప్పుగా మరియు మా లోపాన్ని తెలియజేసే ఒకmessageస్ట్రింగ్తో ఒక JSON వస్తువును తిరిగి ఇస్తుంది.
మా connectWallet ఫంక్షన్ రిటర్న్ రకాలతో పాటు, మేము JSON వస్తువులను తిరిగి ఇస్తున్నాము, తద్వారా వాటి పారామీటర్లను మా స్టేట్ వేరియబుల్స్ మరియు UIని అప్డేట్ చేయడానికి ఉపయోగించవచ్చు.
మీ స్మార్ట్ కాంట్రాక్ట్ను లోడ్ చేయండి
ఇప్పుడు మా pinJSONToIPFS ఫంక్షన్ ద్వారా IPFSకి మా NFT మెటాడేటాను అప్లోడ్ చేయడానికి ఒక మార్గం ఉంది, దాని mintNFT ఫంక్షన్ను కాల్ చేయడానికి మా స్మార్ట్ కాంట్రాక్ట్ యొక్క ఒక ఉదాహరణను లోడ్ చేయడానికి ఒక మార్గం అవసరం.
మేము ఇందాక చెప్పినట్లు, ఈ ట్యుటోరియల్లో మేము ఈ ఇప్పటికే ఉన్న NFT స్మార్ట్ కాంట్రాక్ట్opens in a new tabను ఉపయోగిస్తాము; అయితే, మేము దాన్ని ఎలా తయారు చేశామో తెలుసుకోవాలనుకుంటే, లేదా మీరే ఒకటి తయారు చేసుకోవాలనుకుంటే, మా ఇతర ట్యుటోరియల్, "ఒక NFTని ఎలా సృష్టించాలి."opens in a new tabని చూడమని మేము గట్టిగా సిఫార్సు చేస్తున్నాము.
కాంట్రాక్ట్ ABI
మీరు మా ఫైల్లను జాగ్రత్తగా పరిశీలిస్తే, మా src డైరెక్టరీలో, ఒక contract-abi.json ఫైల్ ఉందని మీరు గమనించి ఉంటారు. ఒక కాంట్రాక్ట్ ఏ ఫంక్షన్ను పిలుస్తుందో నిర్దేశించడానికి అలాగే ఫంక్షన్ మీరు ఆశించే ఫార్మాట్లో డేటాను తిరిగి ఇస్తుందని నిర్ధారించడానికి ఒక ABI అవసరం.
Ethereum బ్లాక్చైన్కు కనెక్ట్ అవ్వడానికి మరియు మా స్మార్ట్ కాంట్రాక్ట్ను లోడ్ చేయడానికి మాకు ఒక Alchemy API కీ మరియు Alchemy Web3 API కూడా అవసరం.
మీ Alchemy API కీని సృష్టించండి
మీకు ఇప్పటికే Alchemy ఖాతా లేకపోతే, ఇక్కడ ఉచితంగా సైన్ అప్ చేసుకోండి.opens in a new tab
మీరు ఆల్కెమీ అకౌంట్ను సృష్టించిన తర్వాత, యాప్ను సృష్టించడం ద్వారా మీరు API కీని రూపొందించవచ్చు. ఇది Ropsten టెస్టునెట్కు అభ్యర్థనలు చేయడానికి మాకు అనుమతిస్తుంది.
మీ Alchemy డాష్బోర్డ్లో నావ్ బార్లో “Apps” పై హోవర్ చేసి “Create App” క్లిక్ చేయడం ద్వారా “Create App” పేజీకి నావిగేట్ చేయండి.
మీ అనువర్తనానికి పేరు పెట్టండి మేము "నా మొదటి NFT!"ని ఎంచుకున్నాము, ఒక చిన్న వివరణను అందించండి, మీ అనువర్తన బుక్కీపింగ్ కోసం ఉపయోగించే పర్యావరణం కోసం “స్టేజింగ్”ని ఎంచుకోండి, మరియు మీ నెట్వర్క్ కోసం “Ropsten”ని ఎంచుకోండి.
“యాప్ను సృష్టించు” క్లిక్ చేయండి, అంతే! మీ యాప్ దిగువ పట్టికలో కనిపించాలి.
అద్భుతం, ఇప్పుడు మేము మా HTTP Alchemy API URLని సృష్టించాము, దాన్ని మీ క్లిప్బోర్డ్కు కాపీ చేయండి...
… ఆపై దానిని మా .env ఫైల్కు జోడిద్దాం. మొత్తం మీద, మీ .env ఫైల్ ఇలా కనిపించాలి:
1REACT_APP_PINATA_KEY = <pinata-key>2REACT_APP_PINATA_SECRET = <pinata-secret>3REACT_APP_ALCHEMY_KEY = https://eth-ropsten.alchemyapi.io/v2/<alchemy-key>ఇప్పుడు మా కాంట్రాక్ట్ ABI మరియు మా Alchemy API కీ ఉన్నాయి, మేము Alchemy Web3opens in a new tab ఉపయోగించి మా స్మార్ట్ కాంట్రాక్ట్ను లోడ్ చేయడానికి సిద్ధంగా ఉన్నాము.
మీ Alchemy Web3 ఎండ్పాయింట్ మరియు కాంట్రాక్ట్ను సెటప్ చేయండి
మొదట, మీకు ఇప్పటికే లేకపోతే, టెర్మినల్లో హోమ్ డైరెక్టరీ: nft-minter-tutorial కి నావిగేట్ చేయడం ద్వారా మీరు Alchemy Web3opens in a new tabని ఇన్స్టాల్ చేయాలి:
1cd ..2npm install @alch/alchemy-web3తరువాత మా interact.js ఫైల్కు తిరిగి వెళ్దాం. ఫైల్ పైభాగంలో, మీ .env ఫైల్ నుండి మీ Alchemy కీని దిగుమతి చేసుకోవడానికి మరియు మీ Alchemy Web3 ఎండ్పాయింట్ను సెటప్ చేయడానికి కింది కోడ్ను జోడించండి:
1require("dotenv").config()2const alchemyKey = process.env.REACT_APP_ALCHEMY_KEY3const { createAlchemyWeb3 } = require("@alch/alchemy-web3")4const web3 = createAlchemyWeb3(alchemyKey)Alchemy Web3opens in a new tab అనేది Web3.jsopens in a new tab చుట్టూ ఉన్న ఒక చుట్టు, ఇది వెబ్3 డెవలపర్గా మీ జీవితాన్ని సులభతరం చేయడానికి మెరుగైన API పద్ధతులు మరియు ఇతర కీలక ప్రయోజనాలను అందిస్తుంది. ఇది కనిష్ట కాన్ఫిగరేషన్ అవసరం అయ్యేలా రూపొందించబడింది, తద్వారా మీరు వెంటనే మీ అనువర్తనంలో దాన్ని ఉపయోగించడం ప్రారంభించవచ్చు!
తరువాత, మా కాంట్రాక్ట్ ABI మరియు కాంట్రాక్ట్ చిరునామాను మా ఫైల్కు జోడిద్దాం.
1require("dotenv").config()2const alchemyKey = process.env.REACT_APP_ALCHEMY_KEY3const { createAlchemyWeb3 } = require("@alch/alchemy-web3")4const web3 = createAlchemyWeb3(alchemyKey)56const contractABI = require("../contract-abi.json")7const contractAddress = "0x4C4a07F737Bf57F6632B6CAB089B78f62385aCaE"మాకు రెండూ ఉన్న తర్వాత, మేము మా మింట్ ఫంక్షన్ను కోడింగ్ చేయడం ప్రారంభించడానికి సిద్ధంగా ఉన్నాము!
మింట్ఎన్ఎఫ్టి ఫంక్షన్ను అమలు చేయండి
మీ interact.js ఫైల్ లోపల, మా ఫంక్షన్, mintNFTని నిర్వచిద్దాం, ఇది దాని పేరుకు తగినట్లుగా మా NFTని ముద్రిస్తుంది.
మేము అనేక అసమకాలిక కాల్స్ చేయబోతున్నందున (మా మెటాడేటాను IPFSకి పిన్ చేయడానికి Pinataకు, మా స్మార్ట్ కాంట్రాక్ట్ను లోడ్ చేయడానికి Alchemy Web3కు, మరియు మా లావాదేవీలపై సంతకం చేయడానికి MetaMaskకు), మా ఫంక్షన్ కూడా అసమకాలికంగా ఉంటుంది.
మా ఫంక్షన్కు మూడు ఇన్పుట్లు మా డిజిటల్ ఆస్తి యొక్క url, name, మరియు description. connectWallet ఫంక్షన్ కింద కింది ఫంక్షన్ సంతకాన్ని జోడించండి:
1export const mintNFT = async (url, name, description) => {}ఇన్పుట్ దోష నిర్వహణ
సహజంగానే, ఫంక్షన్ ప్రారంభంలో కొంత ఇన్పుట్ దోష నిర్వహణ ఉండటం అర్ధవంతంగా ఉంటుంది, తద్వారా మా ఇన్పుట్ పారామీటర్లు సరిగ్గా లేకపోతే మేము ఈ ఫంక్షన్ నుండి నిష్క్రమిస్తాము. మా ఫంక్షన్ లోపల, కింది కోడ్ను జోడిద్దాం:
1export const mintNFT = async (url, name, description) => {2 //error handling3 if (url.trim() == "" || name.trim() == "" || description.trim() == "") {4 return {5 success: false,6 status: "❗Please make sure all fields are completed before minting.",7 }8 }9}అన్నీ చూపించుముఖ్యంగా, ఇన్పుట్ పారామీటర్లలో ఏదైనా ఖాళీ స్ట్రింగ్ అయితే, అప్పుడు మేము success బూలియన్ తప్పుగా మరియు మా UIలోని అన్ని ఫీల్డ్లు పూర్తి చేయాలని తెలియజేసే status స్ట్రింగ్తో ఒక JSON వస్తువును తిరిగి ఇస్తాము.
opens in a new tabమెటాడేటాను IPFSకి అప్లోడ్ చేయండి
మా మెటాడేటా సరిగ్గా ఫార్మాట్ చేయబడిందని మాకు తెలిసిన తర్వాత, తదుపరి దశ దానిని ఒక JSON వస్తువులో చుట్టి, మేము వ్రాసిన pinJSONToIPFS ద్వారా IPFSకి అప్లోడ్ చేయడం!
అలా చేయడానికి, మేము మొదట pinJSONToIPFS ఫంక్షన్ను మా interact.js ఫైల్లోకి దిగుమతి చేసుకోవాలి. interact.js పైభాగాన, ఇలా జోడిద్దాం:
1import { pinJSONToIPFS } from "./pinata.js"pinJSONToIPFS ఒక JSON బాడీని తీసుకుంటుందని గుర్తుంచుకోండి. కాబట్టి దానికి కాల్ చేయడానికి ముందు, మేము మా url, name, మరియు description పారామీటర్లను ఒక JSON వస్తువుగా ఫార్మాట్ చేయాలి.
metadata అనే JSON వస్తువును సృష్టించడానికి మా కోడ్ను అప్డేట్ చేసి, ఆపై ఈ metadata పారామీటర్తో pinJSONToIPFSకు కాల్ చేద్దాం:
1export const mintNFT = async (url, name, description) => {2 //error handling3 if (url.trim() == "" || name.trim() == "" || description.trim() == "") {4 return {5 success: false,6 status: "❗Please make sure all fields are completed before minting.",7 }8 }910 //make metadata11 const metadata = new Object()12 metadata.name = name13 metadata.image = url14 metadata.description = description1516 //make pinata call17 const pinataResponse = await pinJSONToIPFS(metadata)18 if (!pinataResponse.success) {19 return {20 success: false,21 status: "😢 Something went wrong while uploading your tokenURI.",22 }23 }24 const tokenURI = pinataResponse.pinataUrl25}అన్నీ చూపించుగమనించండి, మేము pinJSONToIPFS(metadata)కు మా కాల్ యొక్క ప్రతిస్పందనను pinataResponse వస్తువులో నిల్వ చేస్తాము. అప్పుడు, మేము ఏవైనా దోషాల కోసం ఈ వస్తువును పార్స్ చేస్తాము.
దోషం ఉంటే, మేము success బూలియన్ తప్పుగా మరియు మా status స్ట్రింగ్ మా కాల్ విఫలమైందని తెలియజేసే ఒక JSON వస్తువును తిరిగి ఇస్తాము. లేకపోతే, మేము pinataResponse నుండి pinataURLను సంగ్రహించి, దానిని మా tokenURI వేరియబుల్గా నిల్వ చేస్తాము.
ఇప్పుడు మేము మా ఫైల్ పైభాగంలో ప్రారంభించిన Alchemy Web3 APIని ఉపయోగించి మా స్మార్ట్ కాంట్రాక్ట్ను లోడ్ చేసే సమయం వచ్చింది. mintNFT ఫంక్షన్ దిగువన window.contract గ్లోబల్ వేరియబుల్లో కాంట్రాక్ట్ను సెట్ చేయడానికి కింది కోడ్ పంక్తిని జోడించండి:
1window.contract = await new web3.eth.Contract(contractABI, contractAddress)మా mintNFT ఫంక్షన్లో జోడించాల్సిన చివరి విషయం మా Ethereum లావాదేవీ:
1//set up your Ethereum transaction2const transactionParameters = {3 to: contractAddress, // Required except during contract publications.4 from: window.ethereum.selectedAddress, // must match user's active address.5 data: window.contract.methods6 .mintNFT(window.ethereum.selectedAddress, tokenURI)7 .encodeABI(), //make call to NFT smart contract8}910//sign the transaction via MetaMask11try {12 const txHash = await window.ethereum.request({13 method: "eth_sendTransaction",14 params: [transactionParameters],15 })16 return {17 success: true,18 status:19 "✅ Check out your transaction on Etherscan: https://ropsten.etherscan.io/tx/" +20 txHash,21 }22} catch (error) {23 return {24 success: false,25 status: "😥 Something went wrong: " + error.message,26 }27}అన్నీ చూపించుమీకు ఇప్పటికే Ethereum లావాదేవీలతో పరిచయం ఉంటే, మీరు చూసిన దానితో నిర్మాణం చాలా సారూప్యంగా ఉందని మీరు గమనిస్తారు.
- మొదట, మేము మా లావాదేవీల పారామీటర్లను సెటప్ చేస్తాము.
toగ్రహీత చిరునామాను నిర్దేశిస్తుంది (మా స్మార్ట్ కాంట్రాక్ట్)fromలావాదేవీ యొక్క సంతకం చేసేవారిని నిర్దేశిస్తుంది (వినియోగదారుడి కనెక్ట్ చేయబడిన చిరునామా MetaMaskకు:window.ethereum.selectedAddress)dataమా స్మార్ట్ కాంట్రాక్ట్mintNFTపద్ధతికి కాల్ను కలిగి ఉంటుంది, ఇది మాtokenURIమరియు వినియోగదారుడి వాలెట్ చిరునామా,window.ethereum.selectedAddressను ఇన్పుట్లుగా స్వీకరిస్తుంది
- అప్పుడు, మేము ఒక await కాల్,
window.ethereum.request,చేస్తాము, ఇక్కడ మేము లావాదేవీపై సంతకం చేయమని MetaMaskను అడుగుతాము. గమనించండి, ఈ అభ్యర్థనలో, మేము మా eth పద్ధతిని (eth_SentTransaction) నిర్దేశిస్తున్నాము మరియు మాtransactionParametersను పాస్ చేస్తున్నాము. ఈ సమయంలో, MetaMask బ్రౌజర్లో తెరుచుకుంటుంది మరియు లావాదేవీపై సంతకం చేయమని లేదా తిరస్కరించమని వినియోగదారుడిని ప్రాంప్ట్ చేస్తుంది.- లావాదేవీ విజయవంతమైతే, ఫంక్షన్
successబూలియన్ నిజంగా సెట్ చేయబడిన ఒక JSON వస్తువును మరియుstatusస్ట్రింగ్ వినియోగదారుడిని వారి లావాదేవీ గురించి మరింత సమాచారం కోసం Etherscanను చూడమని ప్రాంప్ట్ చేసే ఒక JSON వస్తువును తిరిగి ఇస్తుంది. - లావాదేవీ విఫలమైతే, ఫంక్షన్
successబూలియన్ తప్పుగా సెట్ చేయబడిన ఒక JSON వస్తువును మరియుstatusస్ట్రింగ్ దోష సందేశాన్ని తెలియజేసే ఒక JSON వస్తువును తిరిగి ఇస్తుంది.
- లావాదేవీ విజయవంతమైతే, ఫంక్షన్
మొత్తం మీద, మా mintNFT ఫంక్షన్ ఇలా కనిపించాలి:
1export const mintNFT = async (url, name, description) => {2 //error handling3 if (url.trim() == "" || name.trim() == "" || description.trim() == "") {4 return {5 success: false,6 status: "❗Please make sure all fields are completed before minting.",7 }8 }910 //make metadata11 const metadata = new Object()12 metadata.name = name13 metadata.image = url14 metadata.description = description1516 //pinata pin request17 const pinataResponse = await pinJSONToIPFS(metadata)18 if (!pinataResponse.success) {19 return {20 success: false,21 status: "😢 Something went wrong while uploading your tokenURI.",22 }23 }24 const tokenURI = pinataResponse.pinataUrl2526 //load smart contract27 window.contract = await new web3.eth.Contract(contractABI, contractAddress) //loadContract();2829 //set up your Ethereum transaction30 const transactionParameters = {31 to: contractAddress, // Required except during contract publications.32 from: window.ethereum.selectedAddress, // must match user's active address.33 data: window.contract.methods34 .mintNFT(window.ethereum.selectedAddress, tokenURI)35 .encodeABI(), //make call to NFT smart contract36 }3738 //sign transaction via MetaMask39 try {40 const txHash = await window.ethereum.request({41 method: "eth_sendTransaction",42 params: [transactionParameters],43 })44 return {45 success: true,46 status:47 "✅ Check out your transaction on Etherscan: https://ropsten.etherscan.io/tx/" +48 txHash,49 }50 } catch (error) {51 return {52 success: false,53 status: "😥 Something went wrong: " + error.message,54 }55 }56}అన్నీ చూపించుఅది ఒక పెద్ద ఫంక్షన్! ఇప్పుడు, మేము మా mintNFT ఫంక్షన్ను మా Minter.js కాంపోనెంట్కు కనెక్ట్ చేయాలి...
mintNFTని మా Minter.js ఫ్రంటెండ్కు కనెక్ట్ చేయండి
మీ Minter.js ఫైల్ను తెరిచి, పైభాగంలో ఉన్న import { connectWallet, getCurrentWalletConnected } from "./utils/interact.js"; పంక్తిని ఇలా అప్డేట్ చేయండి:
1import {2 connectWallet,3 getCurrentWalletConnected,4 mintNFT,5} from "./utils/interact.js"చివరగా, మీ దిగుమతి చేసుకున్న mintNFT ఫంక్షన్కు await కాల్ చేయడానికి మరియు మా లావాదేవీ విజయవంతమైందో లేదా విఫలమైందో ప్రతిబింబించేలా status స్టేట్ వేరియబుల్ను అప్డేట్ చేయడానికి onMintPressed ఫంక్షన్ను అమలు చేయండి:
1const onMintPressed = async () => {2 const { status } = await mintNFT(url, name, description)3 setStatus(status)4}మీ NFTని ప్రత్యక్ష వెబ్సైట్కు అమలు చేయండి
వినియోగదారులు సంభాషించడానికి మీ ప్రాజెక్ట్ను ప్రత్యక్షంగా తీసుకెళ్లడానికి సిద్ధంగా ఉన్నారా? మీ మింటర్ను ప్రత్యక్ష వెబ్సైట్కు అమలు చేయడానికి ఈ ట్యుటోరియల్opens in a new tabని చూడండి.
ఒక చివరి దశ...
బ్లాక్చైన్ ప్రపంచాన్ని తుఫానులా ముంచెత్తండి
కేవలం సరదాకి, మీరు ట్యుటోరియల్ చివరికి చేరుకున్నారు!
సంక్షిప్తంగా, ఒక NFT మింటర్ను నిర్మించడం ద్వారా, మీరు విజయవంతంగా ఎలాగో నేర్చుకున్నారు:
- మీ ఫ్రంటెండ్ ప్రాజెక్ట్ ద్వారా MetaMaskకు కనెక్ట్ అవ్వండి
- మీ ఫ్రంటెండ్ నుండి స్మార్ట్ కాంట్రాక్ట్ పద్ధతులను కాల్ చేయండి
- MetaMask ఉపయోగించి లావాదేవీలపై సంతకం చేయండి
బహుశా, మీరు మీ వాలెట్లో మీ డాప్ ద్వారా ముద్రించబడిన NFTలను చూపించాలనుకుంటారు — కాబట్టి మా శీఘ్ర ట్యుటోరియల్ మీ వాలెట్లో మీ NFTని ఎలా చూడాలిopens in a new tabని తప్పకుండా చూడండి!
మరియు, ఎప్పటిలాగే, మీకు ఏవైనా ప్రశ్నలు ఉంటే, మేము Alchemy Discordopens in a new tabలో సహాయం చేయడానికి ఇక్కడ ఉన్నాము. ఈ ట్యుటోరియల్ నుండి మీరు నేర్చుకున్న భావనలను మీ భవిష్యత్ ప్రాజెక్ట్లకు ఎలా వర్తింపజేస్తారో చూడటానికి మేము వేచి ఉండలేము!
పేజీ చివరి అప్డేట్: 22 అక్టోబర్, 2025