Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
@balancer-labs/sor
Advanced tools
Readme
Smart Order Router (SOR)
Smart Order Router, or SOR, is an off-chain linear optimization of routing orders across pools for best price execution.
SOR exists in the Bronze release as a way to aggregate liquidity across all Balancer pools. Future releases of Balancer will accomplish this on-chain and allow aggregate contract fillable liquidity.
Liquidity aggregators are free to use the SOR npm package or create their own order routing across pools.
There are two types of swap available:
swapExactIn - i.e. You want to swap exactly 1 ETH as input and SOR will calculate X amount of BAL you receive in return.
or
swapExactOut - i.e. You want to receive exactly 1 BAL and SOR will calculate X amount of ETH you must input.
The SOR will return totalReturn/totalInput as well as a list swaps to achieve the total. Swaps can be through direct pools, i.e. A > POOL1 > B, or via a multihop pool, i.e. A > POOL1 > C > POOL2 > B. The swaps are returned in a format that can be directly to the Vault to execute the trade.
The example file swapExample.ts
in: ./testScripts, demonstrates full examples with comments.
To Run:
Create a .env file in root dir. Depending on network being used add an RPC URL (e.g. Alchemy, Infura), e.g.: RPC_URL_MAINNET=alchemy/infura
Supported networks out of box for example are:
RPC_URL_MAINNET
RPC_URL_POLYGON
RPC_URL_ARBITRUM
RPC_URL_GNOSIS
RPC_URL_ZKEVM
RPC_URL_GOERLI
Install dependencies: $ yarn install
Run example: $ ts-node ./test/testScripts/swapExample.ts
Running tests locally:
RPC_URL_MAINNET=
RPC_URL_POLYGON=
$ yarn run node
$ yarn run node:polygon
$ yarn test
To run a single test file use test:only
, e.g.:
$ yarn test:only test/composableStable.integration.spec.ts
Adding New Pools:
See info here
Optional config values can be set in the .env file:
PRICE_ERROR_TOLERANCE - how close we expect prices after swap to be in SOR suggested paths. Defaults 0.00001.
INFINITESIMAL - Infinitesimal is an amount that's used to initialize swap amounts so they are not zero or the path's limit. Defaults 0.000001.
Example:
PRICE_ERROR_TOLERANCE=0.00001
INFINITESIMAL=0.000001
Except where indicated otherwise, the code in this repository is licensed GPLv3.
Superluminal Labs Ltd. is the owner of the directories balancer-sor/src/pools/gyro2Pool/
, balancer-sor/src/pools/gyro3Pool/
, balancer-sor/src/pools/gyroEPool/
, balancer-sor/src/pools/gyro2V2Pool/
, and balancer-sor/src/pools/gyroEV2Pool/
and any accompanying files contained herein (collectively, these “Software”). Use of these Software is exclusively subject to the Gyroscope Pool License, which is available at the provided link (the “Gyroscope Pool License”). These Software are not covered by the General Public License and do not confer any rights to the user other than the limited rights specified in the Gyroscope Pool License. A special hybrid license between Superluminal Labs Ltd and Balancer Labs OÜ governs Superluminal Labs Ltd's use of the Balancer Labs OÜ code Special License, which is available at the provided link. By using these Software, you agree to be bound by the terms and conditions of the Gyroscope Pool License. If you do not agree to all terms and conditions of the Gyroscope Pool License, do not use any of these Software.
FAQs
There are two types of swap available:
The npm package @balancer-labs/sor receives a total of 2,104 weekly downloads. As such, @balancer-labs/sor popularity was classified as popular.
We found that @balancer-labs/sor demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 6 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.