[WIP] Balancer v3

[johngrantuk]

• Add support for Balancer V3.
• Currently we only have a Sepolia test deployment so some config has been added to help with debug, tests, etc but doesn't fully run as PS not deployed there.
• Using Balancer Maths package which is typescript maths for Vault/Pool logic. Aims to be 100% accurate to Smart Contract logic and maths, written with bigint maths with no dependencies to be efficient. Will always include Balancer supported pools and hooks which makes adding new pools, etc scalable across integrations.
  • This is currently out of date vs latest testnet deploy so some tests are failing. Will be updated.
• Boosted Pool support is added:
  • Balancer V3 has the concepts of Boosted Pools and ERC4626 Liquidity Buffers.
  • These enable highly capital efficient pools and gas efficient swaps.
  • To swap via a buffer we must provide the correct ""steps" to the router transaction.
    • Wrap: e.g. USDC>aUSDC
    • Unwrap: e.g. aUSDC>USDC
  • A full swap between USDC>DAI for an example bbausd pool consisting of aDAI/aUSDC/aUSDT would look like: USDC[wrap-buffer]aUSDC[swap-pool]aDAI[unwrap-buffer]USDC
  • See docs for further info:
  • BoostedPool
  • Buffer

Questions:

• getAdapters: Should this be filled? And if yes what should it do?
• getAdapterParam: Should this be filled? And if yes what should it do?

TODOs/Notes:

• balancer-v3-integration.test.ts test is failing because there is a mismatch between math and testnet pool versions. Will be updated in near future to match.
• other event tests need added but waiting for new test deployment
• gasCost to be added once final profiling ready
• nested pools to be added later
• hook support to be added later
• there are other todos being tracked inline

[KanievskyiDanylo]

Fixes BACK-1746