In order for a ManagerWithMerkleVerification to manage a BoringVault, it needs a DecoderAndSanitizer for every protocol the BoringVault will interact with. The job of the DecoderAndSanitizer is to implement the same function selector for every function the BoringVault will need to call. Then when a function is called, it needs to decode the arguments, possibly sanitize them, such that it can return a bytes containing all the addresses found in the msg.data, in an abi.encodePacked format. The ManagerWithMerkleVerification, then takes this bytes and uses it to verify a merkle tree proof.

Below is a tutorial for how to create the DecoderAndSanitizer for a Uniswap V3 Integration. The finished DecoderAndSanitizer can be found here.

Step 1: Determine what functions need to be callable by the BoringVault

For a Uniswap V3 Integration, the boring vault should be able to

Thus the UniswapV3DecoderAndSanitizer must implement the following functions.

BoringVault Action Function to implement
Swap with Uniswap V3 exactInput(DecoderCustomTypes.ExactInputParams calldata *params*)
Create an Uniswap V3 liquidity position mint(DecoderCustomTypes.MintParams calldata *params*)
Add to an Uniswap V3 liquidity position increaseLiquidity(DecoderCustomTypes.IncreaseLiquidityParams calldata *params*)
Take from an Uniswap V3 liquidity position decreaseLiquidity(DecoderCustomTypes.DecreaseLiquidityParams calldata *params*)
Collect from an Uniswap V3 liquidity position collect(DecoderCustomTypes.CollectParams calldata *params*)

Step 2: Implementing the functions

All DecoderAndSanitizer function implementations will follow these specifications.