मुख्य सामग्री पर जाएं
Virtual Environment पर ERC-4337 smart accounts को test करने के लिए, Pimlico के open-source bundler Alto और Pimlico के mock paymaster को Docker में चलाएँ, और दोनों को Virtual Environment के RPC URLs पर point करें। Parent network पर deployed EntryPoint contracts और account factories forked state का हिस्सा हैं, और हर bundle एक transaction है जिसे आप Virtual Environment Explorer में खोल सकते हैं। यह गाइड UserOperations को चार तरीकों से भेजती है: paymaster द्वारा sponsored, account द्वारा भुगतान किए गए, ERC-20 token में भुगतान किए गए, और EIP-7702 account से। यह Alto 1.2.8, permissionless 0.5.0, और viem 2.57.7 के साथ, Ethereum Mainnet, Base, OP Mainnet, और Arbitrum One से fork किए गए Virtual Environments पर, EntryPoint 0.6, 0.7, और 0.8 के साथ test की गई थी।

हर 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 सेट करें:
नई keys generate करें। Anvil या Hardhat के डिफ़ॉल्ट जैसी जानी-मानी test keys का उपयोग न करें। Live networks के forks पर, वे addresses EIP-7702 के माध्यम से एक ऐसे contract को delegate किए गए हैं जो उन्हें मिलने वाला कोई भी ETH forward कर देता है, इसलिए उनके पास कभी कोई balance नहीं रहता।
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 शुरू करें

पहले funder चलता है, फिर Alto, फिर mock paymaster। Stack आमतौर पर 30 सेकंड से कम समय में तैयार हो जाता है।
5

Bundler और paymaster जाँचें

Bundler से उसके EntryPoints पूछें:
फिर paymaster को ping करें:

Mock paymaster के contract addresses

Virtual Environment पर पहली बार शुरू होने पर, mock paymaster नीचे दिए गए contracts deploy करता है। ये addresses हर network पर समान हैं। हर paymaster को अपने EntryPoint में 50 ETH का deposit मिलता है।
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 चलाएँ

Account एक ही UserOperation में deploy हुआ और उसने अपना call किया, और उसके पास अब भी कोई ETH नहीं है। Bundle का पूरा trace देखने के लिए, Virtual Environment Explorer में transaction hash खोजें।
किसी दूसरे EntryPoint version का उपयोग करने के लिए, 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
पहले UserOperation के बाद, EOA का code 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 का उपयोग करता है।
आप उसी snapshot पर जितनी बार आवश्यकता हो उतनी बार revert कर सकते हैं। Dashboard flow और revert distance सीमा के लिए, देखें Virtual Environment state को revert करें।
हर evm_revert के बाद Alto को restart करें। Alto submit किए गए bundles, pending account deployments, और हाल की receipts को memory में रखता है, और revert के बाद वह state ऐसे blocks का वर्णन करती है जो अब मौजूद नहीं हैं। Restart के बिना, हो सकता है कि UserOperations AA10 ... Another deployment operation for this sender is already being processed के साथ fail हों, कभी confirm न हों, या उन UserOperations की receipts लौटाएँ जो revert किए गए थे। debug_bundler_clearState से Alto का mempool clear करना restart की जगह नहीं लेता।

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 के बाद से बीत चुका है।
Mock paymaster हर sponsorship को machine के clock से 60,000 सेकंड के लिए sign करता है। यदि आप time को इससे अधिक आगे बढ़ाते हैं, तो उसकी sponsorships chain पर पहले ही expire हो चुकी होती हैं: UserOperation कभी confirm नहीं होता, और जब तक आप Alto को restart नहीं करते, वह fail हो रहे bundle को resubmit करता रहता है। इससे अधिक आगे jump करने वाले tests के लिए, paymaster के बिना UserOperations भेजें, या अपनी paymaster service का उपयोग करें।

अपनी 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 पीछे हो: Alto UserOperation expires too soon के साथ UserOperation को reject कर देता है।
  • Service को Public RPC URL दें। Chain को पढ़ने और signed transactions भेजने के लिए Admin RPC की आवश्यकता नहीं होती।

समस्या निवारण

यह भी देखें