Dev environment changes

To faciliate testing, the Linear development environment has been updated as part of the upgrade.

Mock collateral tokens

The updated development environment assumes the use of the following collateral tokens:

NameSymbolDecimals
Linear TokenLINA18
Wrapped BNBWBNB18
BTCB TokenBTCB18
Ethereum TokenETH18

ℹ️ Note

These tokens actually exist in the Binance Smart Chain network, and they actually match the list of collateral tokens assumed for production deployment.

ℹ️ Note

The upgrade only supports ERC20 tokens, and not the native network currency BNB. Therefore, to support BNB as collateral, the wrapped token WBNB must be used instead.

It's technically possible for the system to internally handle the conversion between BNB and WBNB, in a way similar to how Uniswap handles ETH swaps on the router level. However, this is out of scope for this upgrade itself.

Environment initialization

A patch to Linear-finance/linear-dev-cli has been submitted as a new dev/multi_collateral branch. Similar to the service changes, a new Docker image has not been built for it yet. When building, it's recommended to use a tag expected by the Docker Compose stack.

Docker Compose stack

Linear-finance/linear-dev has been updated (also in the dev/multi_collateral branch) to make the upgrade available in the development environment.

It's important to note that new Docker images referenced by the upgrade do not actually exist yet. Rather, they are expected to be built once other parts of the upgrade are merged and released (see this section and this session). Therefore, if you want to test the stack before those images are built from GitHub Actions, you'll need to manually build them locally.