菜单
Production-ready ERC-4337 Account Abstraction Paymaster infrastructure for sponsoring gas fees with policy controls, real EntryPoint v0.6.0 integration, and multi-chain support. Build, validate, and submit UserOperations with whitelist, limits, and token-gating.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/XSpoonAi/spoon-awesome-skill --skill account-abstraction-paymaster命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Context-aware caption translation skill for SRT/VTT/ASS with bilingual output and optional Gemini CLI fallback.
CRITICAL: Skill composition engine for automatic workflow generation from skill metadata. Triggers: compose skills, orchestrate, workflow, combine skills, skill pipeline, multi-skill, 技能组合, 工作流编排, 技能发现, 自动编排, skill discovery, semantic matching, StateGraph generation
Intelligent content optimization framework for preparing data and content for AI/ML training pipelines with quality analysis, dataset optimization, and hyperparameter suggestions.
基于 SOC 职业分类
正在显示 SKILL.md
| name | Account Abstraction Paymaster |
| description | Production-ready ERC-4337 Account Abstraction Paymaster infrastructure for sponsoring gas fees with policy controls, real EntryPoint v0.6.0 integration, and multi-chain support. Build, validate, and submit UserOperations with whitelist, limits, and token-gating. |
| version | 1.0.0 |
| author | Sambit (Community Contributor) |
| tags | ["web3-core-operations","erc-4337","account-abstraction","paymaster","gas-sponsorship","entrypoint","userops","infrastructure","ethereum","polygon","arbitrum"] |
| category | Web3 Core Operations |
| difficulty | Advanced |
| estimated_time | 2-3 hours setup + deployment |
| last_updated | 2026-02-19T00:00:00.000Z |
| activation_triggers | ["account abstraction paymaster","sponsor gas fees","erc-4337 paymaster","useroperation builder","entrypoint integration","gas sponsorship","smart wallet paymaster","aa paymaster","sponsor user operations","paymaster policy"] |
| parameters | [{"name":"rpc_url","type":"str","required":true,"description":"RPC endpoint for target network (e.g., https://eth.llamarpc.com)"},{"name":"paymaster_address","type":"str","required":true,"description":"Deployed ERC-4337 Paymaster contract address"},{"name":"paymaster_owner_key","type":"str","required":true,"description":"Private key for paymaster signing (secure storage required)"},{"name":"bundler_private_key","type":"str","required":false,"description":"Private key for bundler account (optional, for submitting UserOps)"},{"name":"max_gas_per_op","type":"int","default":500000,"description":"Maximum gas units to sponsor per UserOperation"},{"name":"max_cost_per_op_eth","type":"float","default":0.01,"description":"Maximum ETH cost to sponsor per UserOperation"},{"name":"daily_limit_eth","type":"float","default":0.1,"description":"Daily spending limit per user in ETH"}] |
| requirements | ["Python 3.8+","web3>=6.0.0","eth-account>=0.9.0","eth-abi>=4.0.0","Understanding of ERC-4337 Account Abstraction","Deployed Paymaster contract (or use existing one)","RPC endpoint for target network(s)"] |
Implement ERC-4337 Account Abstraction Paymaster to sponsor gas fees for users with comprehensive policy controls, real-time validation, and multi-chain support. Features real EntryPoint v0.6.0 integration tested on Ethereum mainnet with actual contract interactions.
Handles gas sponsorship logic and policy validation.
Key Classes:
PaymasterSponsor - Main sponsorship managerSponsorshipPolicy - Policy configurationSponsorshipResult - Sponsorship outcomeUserOperationGas - Gas cost breakdownMethods:
sponsor_user_operation() - Validate and sponsor a UserOpcheck_sponsorship_eligibility() - Check if user meets criteriacalculate_user_op_gas() - Estimate gas costsgenerate_paymaster_data() - Create paymasterAndData fieldget_paymaster_deposit() - Check paymaster balance in EntryPointDirect interaction with ERC-4337 EntryPoint contract.
Key Classes:
EntryPointInteraction - EntryPoint managerUserOpReceipt - Transaction receiptValidationResult - Validation outcomeMethods:
submit_user_operations() - Submit UserOps via handleOpsget_user_op_hash()get_nonce() - Get account nonceget_deposit_balance() - Check EntryPoint balancedeposit_to_entrypoint() - Add funds for accountsimulate_user_operation() - Test UserOpbefore submissionConstructs properly formatted UserOperations.
Key Classes:
UserOperationBuilder - Main builderUserOperation - UserOp dataclassMethods:
build_user_operation() - Build complete UserOpbuild_eth_transfer_op() - Build ETH transferbuild_erc20_transfer_op() - Build token transferencode_execute_call() - Encode single callencode_execute_batch() - Encode batch callsestimate_user_op_gas() - Estimate gas limitsget_nonce() - Fetch latest nonce# Navigate to skill directory
cd web3-core-operations/account-abstraction-paymaster
# Install dependencies
pip install web3 eth-account eth-abi
# Configure environment
export RPC_URL="https://eth.llamarpc.com"
export PAYMASTER_ADDRESS="0x..."
export BUNDLER_PRIVATE_KEY="0x..."
export PAYMASTER_OWNER_KEY="0x..."
from web3 import Web3
from paymaster_sponsor import PaymasterSponsor, SponsorshipPolicy
from user_operation_builder import UserOperationBuilder
# Connect to network
w3 = Web3(Web3.HTTPProvider("https://eth.llamarpc.com"))
# Initialize components
builder = UserOperationBuilder(w3)
sponsor = PaymasterSponsor(
w3=w3,
paymaster_address="0xYourPaymaster...",
owner_private_key="0x..." # Signs paymaster data
)
# Build UserOperation
user_op = builder.build_eth_transfer_op(
sender="0xSmartAccount...", # User's AA wallet
recipient="0xRecipient...",
amount_wei=Web3.to_wei(0.1, 'ether')
)
# Define sponsorship policy
policy = SponsorshipPolicy(
enabled=True,
max_gas_per_op=500_000,
max_cost_per_op_eth=0.01,
daily_limit_eth=0.1,
whitelist=["0xSmartAccount..."],
blacklist=[],
require_token_balance=None
)
# Sponsor the operation
result = sponsor.sponsor_user_operation(
user_op=user_op.to_dict(),
policy=policy
)
if result.success:
print(f"✅ Sponsored! Cost: {result.cost_eth} ETH")
print(f" Gas: {result.gas_sponsored:,} units")
else:
print(f"❌ Not eligible: {result.reason}")
Expected Output:
💎 Sponsorship Request
Sender: 0xSmartAccount...
Gas Estimate: 281,196 units
Cost Estimate: 0.000010 ETH
✅ Eligible: Eligible for sponsorship
UserOp Hash: 0x2df8034e...
✅ Paymaster data generated (97 bytes)
📊 Daily spending: 0.000010 / 0.1 ETH
✅ Sponsorship approved!
# Sponsor only users holding specific tokens
policy = SponsorshipPolicy(
enabled=True,
max_gas_per_op=300_000,
max_cost_per_op_eth=0.005,
daily_limit_eth=0.05,
whitelist=[], # Empty = check token balance only
blacklist=[],
require_token_balance=(
"0xYourERC20Token...", # Token address
Web3.to_wei(100, 'ether') # Min 100 tokens
)
)
# Build ERC20 transfer operation
user_op = builder.build_erc20_transfer_op(
sender="0xSmartAccount...",
token="0xUSDC...",
recipient="0xRecipient...",
amount=1_000_000 # 1 USDC (6 decimals)
)
# Sponsor
result = sponsor.sponsor_user_operation(user_op.to_dict(), policy)
Expected Output:
📤 Building ERC20 Transfer UserOp
Token: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
To: 0xRecipient...
Amount: 1000000
💎 Sponsorship Request
Sender: 0xSmartAccount...
Gas Estimate: 295,000 units
Cost Estimate: 0.000011 ETH
✅ Eligible: Eligible for sponsorship
✅ Sponsorship approved!
from entrypoint_interaction import EntryPointInteraction
# Initialize EntryPoint interaction
entrypoint = EntryPointInteraction(
w3=w3,
bundler_key="0xBundlerPrivateKey..."
)
# Submit the sponsored UserOperation
receipt = entrypoint.submit_user_operations(
user_ops=[user_op.to_dict()],
beneficiary="0xBundlerAddress...", # Receives bundler fees
wait_for_receipt=True
)
if receipt and receipt.success:
print(f"✅ UserOperation executed!")
print(f" TX Hash: {receipt.tx_hash}")
print(f" Block: {receipt.block_number}")
print(f" Gas Used: {receipt.actual_gas_used:,}")
print(f" Cost: {receipt.actual_gas_cost:.6f} ETH")
# Check for UserOperationEvent
for event in receipt.events:
if event['event'] == 'UserOperationEvent':
print(f" ✅ UserOp successful")
print(f" Sender: {event['args']['sender']}")
print(f" Paymaster: {event['args']['paymaster']}")
print(f" Actual Gas: {event['args']['actualGasUsed']:,}")
Expected Output:
🚀 Submitting 1 UserOperation(s)
Beneficiary: 0xBundler...
UserOp #1: 0x5678efab...
✅ Transaction sent: 0xabcd1234...
⏳ Waiting for confirmation...
✅ Confirmed in block 19234567
Gas used: 275,432
💰 Total cost: 0.000551 ETH
✅ UserOperation executed successfully
Actual gas used: 265,123
Actual gas cost: 0.000530 ETH
# Encode multiple calls in one UserOperation
call_data = builder.encode_execute_batch(
targets=[
"0xToken1...", # First call: approve token
"0xDEX..." # Second call: swap tokens
],
values=[0, 0], # No ETH sent
datas=[
"0x095ea7b3...", # approve(spender, amount)
"0x38ed1739..." # swapExactTokensForTokens(...)
]
)
# Build UserOperation with batch call
user_op = builder.build_user_operation(
sender="0xSmartAccount...",
call_data=call_data
)
# Sponsor and submit
result = sponsor.sponsor_user_operation(user_op.to_dict(), policy)
if result.success:
receipt = entrypoint.submit_user_operations([user_op.to_dict()])
Expected Output:
🔨 Building UserOperation
Sender: 0xSmartAccount...
Nonce: 5 (from chain)
Gas Estimates:
Call: 165,000
Verification: 150,000
Pre-verification: 21,528
Gas Prices:
Max fee: 0.046 gwei
Priority: 0.0035 gwei
Estimated Cost: 0.000015 ETH
✅ UserOperation built successfully
💎 Sponsorship Request
...
✅ Sponsorship approved!
🚀 Submitting 1 UserOperation(s)
...
✅ UserOperation executed successfully
# Check paymaster's deposit in EntryPoint
balance = sponsor.get_paymaster_deposit()
print(f"Paymaster deposit: {balance} ETH")
# Deposit more ETH if needed
if balance < 0.1:
print("⚠️ Low balance, depositing 1 ETH...")
tx_hash = entrypoint.deposit_to_entrypoint(
account=sponsor.paymaster_address,
amount_eth=1.0,
from_key="0xOwnerKey..."
)
print(f"✅ Deposited: {tx_hash}")
# Check spending for specific user
user_address = "0xUser..."
daily_spent = sponsor.daily_spending.get(user_address, 0.0)
print(f"User daily spending: {daily_spent:.6f} ETH")
# Reset daily limits (call once per day)
sponsor.reset_daily_limits()
Expected Output:
Paymaster deposit: 0.05 ETH
⚠️ Low balance, depositing 1 ETH...
💰 Depositing to EntryPoint
For: 0xPaymaster...
Amount: 1.0 ETH
From: 0xOwner...
✅ Transaction sent: 0x9876fedc...
✅ Deposit successful!
New balance: 1.05 ETH
User daily spending: 0.002340 ETH
✅ Daily spending limits reset
cd scripts
python user_operation_builder.py
Expected Output:
======================================================================
USEROPERATION BUILDER
======================================================================
✅ Connected (chain: 1, block: 24488867)
Gas price: 0.035808439 gwei
✅ UserOperation builder initialized
Chain ID: 1
EntryPoint: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
💸 Building ETH Transfer UserOp
To: 0x70997970C51812dc3A010C7d01b50e0d17dc79C8
Amount: 0.1 ETH
🔨 Building UserOperation
Sender: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
Nonce: 0 (from chain)
Gas Estimates:
Call: 109,668
Verification: 150,000
Pre-verification: 21,528
Gas Prices:
Max fee: 0.04655097 gwei
Priority: 0.003580843 gwei
Estimated Cost: 0.000013 ETH
✅ UserOperation built successfully
📋 UserOperation Summary:
Sender: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
Nonce: 0
Total Gas: 281,196
UserOp Hash: 2df8034e1731aced5eed3dddffd3c060f267e7f6f5770d4a058f2ce31b4e7b06
✅ UserOperation ready for signing and submission
python paymaster_sponsor.py
Expected Output:
======================================================================
ACCOUNT ABSTRACTION PAYMASTER - GAS SPONSORSHIP
======================================================================
✅ Connected to network (chain ID: 1)
Block: 24488867
✅ Paymaster initialized
Paymaster: 0x1234567890123456789012345678901234567890
EntryPoint: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
Network: 1
💎 Sponsorship Request
Sender: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
Gas Estimate: 281,196 units
Cost Estimate: 0.000010 ETH
✅ Eligible: Eligible for sponsorship
UserOp Hash: 0x2df8034e1731aced...
✅ Paymaster data generated (97 bytes)
📊 Daily spending: 0.000010 / 0.1 ETH
✅ Sponsorship approved!
📋 Sponsorship Result:
Success: True
Sponsored: True
Gas Sponsored: 281,196 units
Cost: 0.000010 ETH
Reason: Sponsored successfully
✅ UserOperation ready to be submitted with paymaster!
paymasterAndData: 0x12345678901234567890123456789012345...
python entrypoint_interaction.py
Expected Output:
======================================================================
ERC-4337 ENTRYPOINT INTERACTION
======================================================================
✅ Connected (chain: 1, block: 24488925)
✅ EntryPoint interaction initialized
EntryPoint: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
Chain ID: 1
📊 Checking nonce for 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
Nonce: 0
💰 Checking EntryPoint deposit balance
Balance: 0.0 ETH
Problem: User is not whitelisted for sponsorship
Solution:
# Add user to whitelist
policy.whitelist.append("0xNewUser...")
# Or use empty whitelist with token gating
policy = SponsorshipPolicy(
...
whitelist=[], # Empty = no whitelist check
require_token_balance=("0xToken...", min_balance)
)
Problem: User has reached daily spending limit
Solution:
# Check current spending
print(f"Daily spent: {sponsor.daily_spending.get(user_address, 0)}")
# Increase limit
policy.daily_limit_eth = 0.5 # Increase from 0.1 to 0.5
# Or reset limits manually
sponsor.reset_daily_limits()
Problem: Bundler account has no ETH
Solution:
# Send ETH to bundler address
# Or deposit to EntryPoint for paymaster
tx_hash = entrypoint.deposit_to_entrypoint(
account=paymaster_address,
amount_eth=1.0,
from_key=owner_key
)
Problem: Paymaster signature verification failed
Solution:
# Ensure correct signing key
sponsor = PaymasterSponsor(
w3=w3,
paymaster_address="0x...",
owner_private_key="0x..." # Must match paymaster.verifyingSigner()
)
# Regenerate paymaster data
paymaster_data = sponsor.generate_paymaster_data(
user_op_hash=bytes.fromhex(user_op_hash[2:]),
valid_until=0, # No expiration
valid_after=0 # Immediate
)
chains = {
'ethereum': {
'rpc': 'https://eth.llamarpc.com',
'paymaster': '0x...',
'entrypoint': '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789'
},
'polygon': {
'rpc': 'https://polygon-rpc.com',
'paymaster': '0x...',
'entrypoint': '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789'
}
}
# Initialize for each chain
sponsors = {}
for chain_name, config in chains.items():
w3 = Web3(Web3.HTTPProvider(config['rpc']))
sponsors[chain_name] = PaymasterSponsor(
w3=w3,
paymaster_address=config['paymaster'],
entrypoint_address=config['entrypoint'],
owner_private_key=paymaster_key
)
def get_dynamic_policy(user: str, time_of_day: int) -> SponsorshipPolicy:
"""Adjust policy based on user tier and time"""
# Premium users get higher limits
if user in premium_users:
return SponsorshipPolicy(
enabled=True,
max_gas_per_op=1_000_000,
max_cost_per_op_eth=0.05,
daily_limit_eth=1.0,
whitelist=[user],
blacklist=[],
require_token_balance=None
)
# Off-peak hours: more generous limits
elif 0 <= time_of_day < 8: # Midnight to 8am UTC
return SponsorshipPolicy(
enabled=True,
max_gas_per_op=500_000,
max_cost_per_op_eth=0.02,
daily_limit_eth=0.2,
whitelist=[],
blacklist=[],
require_token_balance=None
)
# Peak hours: conservative limits
else:
return SponsorshipPolicy(
enabled=True,
max_gas_per_op=300_000,
max_cost_per_op_eth=0.01,
daily_limit_eth=0.1,
whitelist=[],
blacklist=[],
require_token_balance=(token_address, Web3.to_wei(50, 'ether'))
)
Real Test Results (Ethereum Mainnet):
Contributions welcome! Areas for improvement:
Skill Level: Advanced
Estimated Time: 2-3 hours setup + deployment
Production Ready: Yes (with proper testing)