PayGasX

This is a demo project to implement a system where we can interact with an contract and pay the gas fee with customized approach rather than ETH-only.

Overview

This demo adopted the new proposed EIP: ERC-4337 Account Abstraction via Entry Point Contract specification to achieve the goal of using customized approach to pay for the gas fee. You could check the EIP specification in above link or the medium article here. Sometimes, some users are lack of $ETH, but they may have some other payment methods such as ERC20 tokens just because they have participated in some airdrop activities previously. In the past period, they can interact with our smart contracts or their token contracts only when they have enough $ETH to pay for the transaction fee. With PayGasX, gasless users are able to interact with our smart contracts even if they only have other payment methods other than $ETH.

Sponsored transactions provided by ERC-4337 allow application developers to pay fees on behalf of their users and also allow users to pay fees in ERC20 tokens, which needs a contract serving as an intermediary to collect ERC20s and pay in ETH.

Sponsorship with paymaster is only one feature brought by ERC-4337. Besides that, the key goal of this proposal is account abstraction. If you want to dive deep into the detail, please check their doc.

Components

Our demo focuses on two main components: Paymaster and Contract Wallet. In this demo, we take $MASK as the payment token and the recipient contract is our contract Redpacket.

Paymaster

We customized paymaster for taking $MASK as payment token.

• Check the detailed workflow of paymaster

Contract Wallet

Contract wallet is deployed for PayGasX users to help them manage their ERC20 assets.

Details

• API of EntryPoint

• Structure of UserOperation

GasReport

Check detail gas cost at GasReport.md.

You could run the following command to generate gas report automatically.

  npm run gas-report

Deployed Contract Address

<!-- begin PayGasX -->

| Chain | MaskToken | EntryPoint | DepositPaymaster | VerifyingPaymaster | WalletLogic | PresetFactory | | ------------ | ------------------------------- | ------------------------------- | -------------------------------- | -------------------------------- | ------------------------------- | ------------------------------- | | matic_mumbai | 0xF8935Df6 | 0x8A42F700 | 0x808c7f48 | 0xB349AC5E | 0x0912FD4D | 0x72C51052 | | matic | 0x2b9e7ccd | 0x43B87595 | 0x5592E365 | 0x540dcAc6 | 0xE74351cA | 0xd57E8156 |

<!-- end PayGasX -->

Contribute

Any contribution is welcomed to make it better.

If you have any questions, please create an issue.

Statement

All our work is based on the contract wallet implementation of proofofsoulprotocol.

LICENSE

MIT LICENSE