Permissionless.js POC

TypeScript implementation of Account Abstraction (ERC-4337) tests using permissionless.js SDK with EntryPoint v0.6 on Fuse Network.

Includes implementations for both Fuse bundler/paymaster and Pimlico bundler/paymaster.

Features

• ✅ EtherspotWallet support (compatible with Fuse SDK addresses)
• ✅ EntryPoint v0.6 implementation
• ✅ Native token transfers via user operations
• ✅ ERC-20 token transfers via user operations
• ✅ Fuse bundler and paymaster integration
• ✅ Pimlico bundler and paymaster integration

Quick Start

cd test-permissionless
cp env.example .env
# Edit .env with your credentials
npm install

# Test with Fuse bundler/paymaster
npm test

# Test with Pimlico bundler/paymaster
npm run test:pimlico

Both implementations are fully functional and pass all tests with EntryPoint v0.6.

Configuration

Copy env.example to .env and configure:

# Required for both
PRIVATE_KEY=0x...
RPC_URL=https://rpc.fuse.io
TOKEN_ADDRESS=0x34Ef2Cc892a88415e9f02b91BfA9c91fC0bE6bD4
USE_ETHERSPOT=true

# For Fuse bundler/paymaster (npm test)
PUBLIC_API_KEY=your_fuse_api_key
SPONSOR_ID=your_sponsor_id
PAYMASTER_ADDRESS=0x...
BUNDLER_URL=https://api.fuse.io/api/v0/bundler?apiKey=YOUR_KEY
PAYMASTER_URL=https://api.fuse.io/api/v0/paymaster?apiKey=YOUR_KEY

# For Pimlico bundler/paymaster (npm run test:pimlico)
PIMLICO_API_KEY=your_pimlico_api_key

Note: RPC_URL must be HTTP/HTTPS (not WebSocket).

Tests

1. Paymaster Funds - Verify sponsor balance
2. AA Authentication - Create and validate smart account
3. Native Token Transaction - Send FUSE tokens
4. ERC-20 Token Transaction - Send ERC-20 tokens

Account Types

By default, tests use EtherspotWallet which generates the same addresses as Fuse SDK:

# Use Etherspot (matches Fuse SDK)
USE_ETHERSPOT=true npm test

# Use SimpleAccount
USE_ETHERSPOT=false npm test

Architecture

EOA (Private Key)
    ↓
EtherspotWallet / SimpleAccount (EntryPoint v0.6)
    ↓
Bundler → EntryPoint → Fuse Network
    ↓
Paymaster (Gas Sponsorship)

Implementation Details

• Factory: 0x7f6d8F107fE8551160BD5351d5F1514A6aD5d40E (EtherspotWallet)
• EntryPoint: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 (v0.6)
• Chain: Fuse Network (Chain ID: 122)

Files

• aa_tests.ts - Fuse bundler/paymaster test suite
• aa_tests_pimlico.ts - Pimlico bundler/paymaster test suite
• etherspot_account.ts - EtherspotWallet adapter for permissionless.js
• fuse_bundler_transport.ts - Custom transport for Fuse bundler (v0.6 compatibility)
• pimlico_bundler_transport.ts - Custom transport for Pimlico bundler (v0.6 compatibility)
• package.json - Dependencies and scripts
• tsconfig.json - TypeScript configuration

Requirements

• Node.js 18+
• TypeScript 5+
• Valid private key with sufficient balance
• Fuse API key (for Fuse bundler tests)
• Pimlico API key (for Pimlico bundler tests)