Payment Abstraction

Payment Abstraction is a system of onchain smart contracts that aim to reduce payment friction for Chainlink services. The system is designed to (1) accept fees in various tokens across multiple blockchain networks, (2) consolidate fee tokens onto a single blockchain network via Chainlink CCIP, (3) convert fee tokens into LINK via Chainlink Automation, Price Feeds, and existing Automated Market Maker (AMM) Decentralized Exchange (DEX) contracts, and (4) pass converted LINK into a dedicated contract for withdrawal by Chainlink Network service providers.

Usage

Pre-requisites

• pnpm
• foundry
• slither (for static analysis)
• Create an .env file, following the .env.example (some tests will fail without a configured mainnet RPC)

Build

$ pnpm foundry
$ pnpm install
$ forge build

Test

Run all tests:

$ forge test

Detailed gas report:

$ forge test --gas-report --isolate

Coverage report:

$ forge coverage --report lcov

Check coverage:

node tools/coverage.cjs

• Note: the tools/coverage.ignore.json file tracks the ignored contracts for coverage checks (the script natively ignore test and script files). Example:

["FeeAggregator"]

Run static analysis on all files:

$ slither .

Testing common contracts

Some abstract contracts such as EmergencyWithdrawer are inherited by many of the contracts in this repo. To ensure full test coverage without duplicating tests, add the new contract in the following list from test/BaseTest.t.sol:

// BaseTest.t.sol
  mapping(CommonContracts commonContracts => address[]) internal s_commonContracts;

// BaseUnitTest.t.sol
// Add contracts to the list of contracts that are PausableWithAccessControl
s_commonContracts[CommonContracts.PAUSABLE_WITH_ACCESS_CONTROL].push(address(s_feeAggregatorSender));
s_commonContracts[CommonContracts.PAUSABLE_WITH_ACCESS_CONTROL].push(address(s_feeAggregatorReceiver));
s_commonContracts[CommonContracts.PAUSABLE_WITH_ACCESS_CONTROL].push(address(s_swapAutomator));
s_commonContracts[CommonContracts.PAUSABLE_WITH_ACCESS_CONTROL].push(address(s_reserves));

The performForAllContracts modifier must be added to all the shared tests. This modifier takes in a CommonContracts enum type as an argument. If a new shared contract is added a new type should also be added to the enum.

enum CommonContracts {
  PAUSABLE_WITH_ACCESS_CONTROL,
  EMERGENCY_WITHDRAWER,
  LINK_RECEIVER
}

Format

$ forge fmt

Gas Snapshots

Generate snapshot:

$ pnpm run snapshot

Compare against existing snapshot:

$ pnpm run snapshot --diff

Updating Foundry version

Foundry is fixed to a specific nightly version. To update the version:

• Update the nightly-<FOUNDRY_VERSION> field in package.json foundry script.

"foundry": "foundryup --version nightly-fdd321bac95f0935529164a88faf99d4d5cfa321"

• Update the foundry version in the action.yml file.

version: nightly-fdd321bac95f0935529164a88faf99d4d5cfa321

• Run pnpm foundry