हर service किस RPC URL का उपयोग करती है?
Virtual Environment का एक Public RPC URL और एक Admin RPC URL होता है। Alto Public RPC पर चलता है। Funding job, mock paymaster, और accounts को fund करने वाला test code Admin RPC का उपयोग करते हैं।शुरू करने से पहले
- एक Virtual Environment, जो किसी ऐसे network से fork किया गया हो जहाँ ERC-4337 EntryPoint contracts deployed हैं, जैसे Ethereum Mainnet, Base, OP Mainnet, या Arbitrum One। यह parent network का chain ID रख सकता है या किसी custom chain ID का उपयोग कर सकता है। Virtual Environment बनाने के लिए, Virtual Environment quickstart का पालन करें।
- Virtual Environment के Public RPC और Admin RPC URLs, जो Home tab पर Integrate Virtual RPC card में सूचीबद्ध हैं (देखें dashboard संदर्भ)
- Docker Compose के साथ Docker
- Node.js 20.6 या बाद का version और npm
jq, snapshot उदाहरण के लिए
Alto और mock paymaster चलाएँ
1
Project और उसकी .env file बनाएँ
यह command एक project folder और bundler के लिए तीन नई private keys वाली एक
.env file बनाता है।.env खोलें, दोनों placeholder URLs को Virtual Environment के Public RPC और Admin RPC URLs से बदलें, और parent network के लिए ALTO_CHAIN_TYPE सेट करें:2
Funding script जोड़ें
शुरू होने से पहले Alto को अपनी keys पर ETH की आवश्यकता होती है। Alto के पहली बार शुरू होने पर utility key उसके simulation contracts deploy करती है, और executor keys bundle transactions के लिए भुगतान करती हैं।Virtual Environment pre-funded accounts के साथ शुरू होता है, जिन्हें
eth_accounts लौटाता है। Admin RPC unsigned eth_sendTransaction requests स्वीकार करता है, इसलिए script हर key को उन accounts में से किसी एक से किए गए transfer से fund करती है।Script को fund-accounts.mjs के रूप में save करें:fund-accounts.mjs
3
Compose file जोड़ें
File को
docker-compose.yml के रूप में save करें:docker-compose.yml
Mock paymaster केवल testing के लिए है। यह हर request को sponsor करता है और सार्वजनिक रूप से ज्ञात key से sign करता है।
4
Stack शुरू करें
5
Bundler और paymaster जाँचें
Bundler से उसके EntryPoints पूछें:फिर paymaster को ping करें:
Mock paymaster के contract addresses
Virtual Environment पर पहली बार शुरू होने पर, mock paymaster नीचे दिए गए contracts deploy करता है। ये addresses हर network पर समान हैं।
हर paymaster को अपने EntryPoint में 50 ETH का deposit मिलता है।
Sponsored UserOperation भेजें
1
viem और permissionless install करें
viem और permissionless install करने के लिए project folder में ये commands चलाएँ:
2
setup.ts बनाएँ
setup.ts में वे clients और constants हैं जिन्हें इस पेज की सभी scripts साझा करती हैं।setup.ts
3
sponsored.ts बनाएँ
यह script एक ऐसा smart account बनाती है जिसके पास कोई ETH नहीं है, और एक ऐसा UserOperation भेजती है जिसके लिए mock paymaster भुगतान करता है।
sponsored.ts
4
Script चलाएँ
entryPoint constant को बदलें, उदाहरण के लिए { address: entryPoint08Address, version: "0.8" } में। Alto को EntryPoint 0.6, 0.7, और 0.8 के लिए configure किया गया है, और mock paymaster हर एक के लिए एक paymaster deploy करता है।
तीनों endpoints को अलग-अलग रखें। Alto केवल bundler methods का उत्तर देता है: यदि आप उसे
eth_call जैसा कोई read भेजते हैं, तो viem The method "eth_call" does not exist / is not available report करता है। pm_getPaymasterStubData जैसे paymaster methods paymaster URL पर जाते हैं।Gas के भुगतान के अन्य तरीके
नीचे दी गई हर script पूर्ण है औरsetup.ts को reuse करती है। इसे sponsored.ts की तरह ही चलाएँ, उदाहरण के लिए npx tsx --env-file=.env erc20.ts।
Account के balance से gas का भुगतान करें
Paymaster के बिना, account को अपने पहले UserOperation से पहले ETH की आवश्यकता होती है।getFundedWallet इसे Admin RPC के माध्यम से एक pre-funded account से भेजता है।
self-funded.ts
ERC-20 token में gas का भुगतान करें
Mock paymaster अपने खुद के test token को gas के भुगतान के रूप में स्वीकार करता है। कोई भीsudoMint से यह token mint कर सकता है।
erc20.ts
Script पहले भुगतान से पहले paymaster की treasury में token का 1 wei mint करती है। इसके बिना, नए Virtual Environment पर पहला ERC-20 UserOperation
AA50 postOp reverted के साथ fail हो जाता है। Alto, paymaster की postOp gas को 1 wei की fees के साथ मापता है, जहाँ token fee round होकर शून्य हो जाती है। वास्तविक fees के साथ, खाली treasury में पहले transfer को Alto द्वारा मापी गई gas से लगभग 22,600 अधिक gas की आवश्यकता होती है, और postOp की gas खत्म हो जाती है।EIP-7702 account से UserOperation भेजें
एक externally owned account (EOA)Simple7702Account implementation को delegate करके smart account की तरह काम कर सकता है। इसके लिए EntryPoint 0.8 आवश्यक है। पहले UserOperation में signed authorization होता है, और Alto उसे एक EIP-7702 transaction में submit करता है।
eip7702.ts
0xef0100 और उसके बाद implementation address होता है। उसी account के बाद के UserOperations को authorization field की आवश्यकता नहीं होती।
Test runs के बीच state reset करें
Test runs के बीच Virtual Environment को किसी ज्ञात state पर वापस लाने के लिए,evm_snapshot से snapshot लें, Admin RPC पर evm_revert से उस पर revert करें, और हर revert के बाद Alto को restart करें। यह उदाहरण jq का उपयोग करता है।
Time travel और paymaster validity windows
Paymaster signatures में आमतौर पर एक validity window होती है, और दो clocks उसे जाँचते हैं: EntryPoint उसकी तुलना block timestamp से करता है, और Alto उसकी तुलना उस machine के clock से करता है जिस पर वह चलता है। Virtual Environment पर, ये दोनों अलग हो सकते हैं:evm_increaseTimeके बाद, block timestamps machine के clock से आगे चलते हैं (देखें Virtual Environments पर timestamps के साथ काम करना)।evm_revertके बाद, block timestamps snapshot के timestamp से जारी रहते हैं, इसलिए वे machine के clock से उतने समय पीछे चलते हैं जितना समय snapshot के बाद से बीत चुका है।
अपनी paymaster service का उपयोग करें
अपने खुद के sponsorship rules को test करने के लिए, अपनी paymaster service को उसी Virtual Environment पर चलाएँ औरPAYMASTER_URL की जगह उसका URL paymaster client को pass करें। ERC-7677 (pm_getPaymasterStubData और pm_getPaymasterData) को implement करने वाली कोई भी service इस पेज की scripts के साथ काम करती है।
तीन बातें Virtual Environment के लिए विशिष्ट हैं:
- Paymaster को Admin RPC के माध्यम से fund करें। Paymaster contract को EntryPoint deposit की आवश्यकता होती है, और उसे deploy करने वाले account को ETH की आवश्यकता होती है। दोनों को एक pre-funded account से भेजें, जैसा
getFundedWalletकरता है। - Validity windows को दोनों clocks में से आगे वाले clock से sign करें।
validUntilको latest block timestamp और service के अपने clock में से जो आगे हो, उससे compute करें। केवल block timestamp पर आधारित signature तब fail हो जाता है जब Virtual Environment का clock पीछे हो: AltoUserOperation expires too soonके साथ UserOperation को reject कर देता है। - Service को Public RPC URL दें। Chain को पढ़ने और signed transactions भेजने के लिए Admin RPC की आवश्यकता नहीं होती।
समस्या निवारण
यह भी देखें
eth_sendTransaction,evm_snapshot,evm_revert, औरevm_increaseTimeके लिए Admin RPC संदर्भ- Snapshots या dashboard के साथ Virtual Environment state को revert करें
- Virtual Environments पर timestamps के साथ काम करना
- Virtual Environment पर Viem: custom chains और custom RPC methods
- Bundle transaction को step through करने के लिए Debugging Transactions