ETHEREUM_POLLING_INTERVAL, डिफ़ॉल्ट 1000 ms)।
सामान्य setups:
- Virtual Environment पर आपके द्वारा deploy किए गए contracts (development, CI): नीचे दिए गए setup का पालन करें।
- Production history वाले staging या demo environments: parent network पर पहले से मौजूद contract को index करें।
- Fork के बाद parent network की activity: Network Mirror Mode का उपयोग करें।
- Public network पर subgraph: Tenderly Node RPC पर Graph Node चलाएँ।
DemoToken को index करते हैं, जो एक minimal ERC-20 है जो Transfer(address indexed from, address indexed to, uint256 value) emit करता है और Ethereum mainnet से fork किए गए Virtual Environment पर deployed है।
शुरू करने से पहले
- Node.js 20.18.1 या बाद का version (Graph CLI के लिए आवश्यक) और npm
- Docker Compose के साथ Docker
- एक Virtual Environment और उसका Public RPC URL, जो Virtual Environment के Home tab पर Integrate Virtual RPC card में सूचीबद्ध है (देखें dashboard संदर्भ)
- Virtual Environment पर deployed एक contract (देखें Contracts deploy और verify करें), और उसके बारे में:
- उसका address
- JSON file के रूप में उसका ABI
- उसके deployment transaction का block number:
Graph Node और subgraph सेट करें
1
Graph CLI install करें
2
अपने contract से subgraph scaffold करें
graph init demo-token directory बनाता है, जिसमें subgraph.yaml, schema.graphql, src/demo-token.ts में एक event mapping, और एक docker-compose.yml होती है जो Graph Node, IPFS, और Postgres चलाती है।subgraph.yaml में, indexerHints.prune को auto से never में बदलें। Reverted blocks को roll back करने के लिए Graph Node को पूरी entity history की आवश्यकता होती है।subgraph.yaml
3
Graph Node को Virtual Environment पर point करें
Generated
docker-compose.yml में, graph-node service का environment edit करें:ethereumको<network>:<Public RPC URL>पर सेट करें। पहले colon से पहले का network नामsubgraph.yamlमेंnetworkसे match होना चाहिए।ETHEREUM_REORG_THRESHOLD: "1"जोड़ें ताकि Graph Node reverted blocks को roll back कर सके।GRAPH_NODE_GENESIS_VALIDATION_ENABLED: "true"जोड़ें ताकि Graph Node किसी दूसरे Virtual Environment का RPC URL मिलने पर रुका रहने के बजाय उसे अस्वीकार कर दे।
docker-compose.yml (graph-node service)
ipfs और postgres services को generated रूप में ही रहने दें। Graph Node केवल chain data पढ़ता है, इसलिए Admin RPC के बजाय Public RPC का उपयोग करें।4
Graph Node शुरू करें
Starting GraphQL HTTP server at: http://localhost:8000 दिखे, तब Graph Node तैयार है।5
Subgraph बनाएँ और deploy करें
graph deploy subgraph को build करता है, उसे IPFS पर upload करता है, और query URL print करता है:package.json यही commands npm run create-local और npm run deploy-local के रूप में चलाता है। schema.graphql या ABI edit करने के बाद graph codegen फिर से चलाएँ।6
Subgraph को query करें
Indexing status जाँचें
Port8030 पर indexing status API को query करें:
latestBlock वह आखिरी block है जिसे subgraph ने process किया, और chainHeadBlock Virtual Environment का latest block है। health पर निर्भर रहने के बजाय इन दोनों की तुलना करें। इस पेज के हर failure case में, subgraph healthy report करता रहता है जबकि latestBlock आगे बढ़ना बंद कर देता है।
Graph Node द्वारा भेजे गए requests देखने के लिए Virtual Environment का JSON-RPC Calls tab खोलें। Virtual Environment जिन methods को reject करता है, उन्हें खोजने के लिए Status filter को Failed पर सेट करें, जैसे call handlers से आने वाला trace_filter। Request parameters और error response देखने के लिए किसी row को expand करें।
Docker के बजाय gnd के साथ subgraph चलाएँ
gnd (Graph Node Dev) Graph Node को एक native binary के रूप में चलाता है, उसे किसी local IPFS node की आवश्यकता नहीं होती, और वह graph create या graph deploy के बिना subgraph को उसकी build directory से deploy करता है। यह entities को Postgres में store करता है; generated docker-compose.yml की postgres service इसके लिए काम करती है।
graph node install gnd को ~/.local/bin में install करता है; उस directory को अपने PATH में जोड़ें। gnd dev subgraph को http://localhost:8000/subgraphs/name/subgraph-0 पर serve करता है। Build directory बदलने पर हर बार redeploy करने के लिए --watch जोड़ें।
Graph Node Virtual Environment revert को कैसे संभालता है?
Graph Node revert को chain reorganization के रूप में मानता है। जैसे ही Virtual Environment का latest block number उस आखिरी block से आगे निकलता है जिसे subgraph ने index किया था, Graph Node हटाए गए blocks की entities को roll back करता है और replacement blocks को index करता है। तब तक, Graph Node छोटी chain को ignore करता है (log मेंProvider went backwards - ignoring this latest block दिखता है) और reverted blocks की entities serve करता रहता है। Dashboard से या evm_revert से revert करने के बाद (देखें Virtual Environment state को revert करें), पुराने latest block से आगे mine करें: transactions भेजें, dashboard में Mine पर क्लिक करें, या Admin RPC पर evm_mine call करें।
Rollback setup की इन दो settings पर निर्भर करता है:
Parent network पर पहले से मौजूद contract को index करें
Fork से पहले की किसी contract की history शामिल करने के लिए,startBlock को fork block से पहले के किसी block पर सेट करें। Graph Node उन blocks को Virtual Environment RPC के माध्यम से parent network से पढ़ता है, फिर Virtual Environment के blocks के साथ आगे बढ़ता है, इसलिए subgraph में parent network के events और आपके Virtual Environment transactions के events, दोनों होते हैं।
Graph Node startBlock से आगे का हर block RPC के माध्यम से scan करता है और हर eth_getLogs range का आकार contract के events की density के अनुसार तय करता है, इसलिए किसी busy contract को प्रति request कुछ ही blocks के हिसाब से scan किया जाता है। इस पेज के Docker setup के साथ USDC की 1,000 blocks की history (लगभग 97,000 Transfer events) को backfill करने में लगभग 7 मिनट लगे। जब तक आपको पूरी history की आवश्यकता न हो, startBlock को fork block के करीब रखें।
Mappings में contract calls (ethereum.call, उदाहरण के लिए Token.bind(address).balanceOf(holder)) fork के दोनों ओर काम करते हैं। Graph Node event के block hash पर eth_call भेजता है, और Virtual Environment fork से पहले के blocks के लिए calls का उत्तर parent network की state से देता है।
जो Admin RPC cheatcodes state को सीधे write करते हैं, जैसे tenderly_setBalance और tenderly_setErc20Balance, वे कोई events emit नहीं करते, इसलिए event handlers उन्हें record नहीं करते। Wallets को ERC-20 tokens से इस तरह fund करने के लिए कि subgraph उसे record करे, tenderly_addErc20Balance का उपयोग करें, जो हर funded wallet के लिए एक synthetic Transfer event emit करता है। Graph Node इसे किसी भी अन्य Transfer की तरह index करता है।
कौन-से Virtual Environment modes parent-network events को index करते हैं?
केवल Network Mirror Mode parent network के नए blocks को, उनके logs के साथ, Virtual Environment में जोड़ता है। अन्य modes में, subgraph fork के बाद केवल आपके अपने transactions के events देखता है।किसी दूसरे Virtual Environment पर switch करें
Graph Node को किसी दूसरे Virtual Environment पर point करने से पहले उसका data reset करें। Graph Node indexed blocks को network नाम के अनुसार store करता है और, डिफ़ॉल्ट रूप से, यह जाँच नहीं करता कि उस नाम के पीछे का RPC बदल गया है या नहीं। पुराने database के साथ, subgraph उन blocks की ओर point करता है जो नए Virtual Environment में नहीं हैं। Graph NodeEthereum node did not find block <hash> को retry करता रहता है और synced: true report करते हुए पुरानी entities serve करता रहता है।
docker-compose.yml में ethereum और subgraph.yaml में contract address और startBlock अपडेट करें, और docker compose up -d, graph create, और graph deploy फिर से चलाएँ। network को parent network के नाम पर ही रखें (mainnet, न कि virtual_mainnet जैसा कोई custom नाम), ताकि वही subgraph.yaml उस network से fork किए गए किसी भी Virtual Environment के साथ और स्वयं उस network के साथ भी काम करे।
GRAPH_NODE_GENESIS_VALIDATION_ENABLED: "true" के साथ, जब दोनों Virtual Environments के chain IDs अलग होते हैं, तब Graph Node switch का पता लगा लेता है और Genesis hash validation failed on provider 'mainnet-rpc-0': net version mismatch on chain 'mainnet'; expected '73574', found '73575' के साथ नए RPC को अस्वीकार कर देता है। एक ही network से fork किए गए Virtual Environments उस network का genesis hash साझा करते हैं, इसलिए समान chain ID वाले दो Virtual Environments के बीच switch validation पास कर लेता है।
Event handlers के साथ index करें
आपका contract जो events emit करता है, उन्हेंeventHandlers के साथ index करें। Call handlers (callHandlers) और call filter वाले block handlers trace_filter RPC method के माध्यम से traces पढ़ते हैं, जिसे Virtual Environment RPCs serve नहीं करते। इनका उपयोग करने वाला subgraph startBlock - 1 पर रुका रहता है, और Graph Node Trying again after trace_filter RPC call ... failed log करता है, साथ में Public RPC से Access forbidden by access rules, try Admin RPC URL या Admin RPC से not supported। Public networks पर, call handlers Node RPC पर Graph Node के साथ काम करते हैं।
समस्या निवारण
यह भी देखें
- Virtual Environment पर Contracts deploy और verify करें
- Snapshots या dashboard के साथ Virtual Environment state को revert करें
- Network Mirror Mode और State Sync
- Public networks पर subgraphs के लिए Tenderly Node RPC पर Graph Node
evm_snapshot,evm_revert, और balance cheatcodes के लिए Admin RPC संदर्भ