scw-contracts is a collection of modified Biconomy contracts used by Kwenta. Specifically, Kwenta required a modified version of the Session Validation Module to support Account Abstraction. The Session Validation Module is used to validate the details of a User Operation that defines an interaction between an actor and Kwenta's Smart Margin v2 or Smart Margin v3 system.

tree src/

src/
├── SMv2SessionValidationModule.sol
├── SMv3SessionValidationModule.sol
├── biconomy
│   ├── BaseAuthorizationModule.sol
│   └── interfaces
│       ├── IAuthorizationModule.sol
│       ├── ISessionValidationModule.sol
│       ├── ISignatureValidator.sol
│       └── UserOperation.sol
├── kwenta
│   ├── smv2
│   │   └── IAccount.sol
│   └── smv3
│       ├── IERC7412.sol
│       └── IEngine.sol
└── openzeppelin
    └── ECDSA.sol

1. Follow the Foundry guide to working on an existing project

2. Build project

npm run compile

3. Execute tests (requires rpc url(s) to be set in .env)

npm run test

4. Run specific test

   OPTIMISM_SEPOLIA_RPC_URL can be replaced with OPTIMISM_RPC_URL if a mainnet fork is desired

forge test --fork-url $(grep OPTIMISM_SEPOLIA_RPC_URL .env | cut -d '=' -f2) --match-test TEST_NAME -vvv

See deployments/ folder

1. Optimism deployments found in deployments/Optimism.json
2. Optimism Sepolia deployments found in deployments/OptimismSepolia.json
3. Base deployments found in deployments/Base.json
4. Base Sepolia deployments found in deployments/BaseSepolia.json

See audits/ folder

1. Internal audits found in audits/internal/
2. External audits found in audits/external/