@tracer-protocol/perpetual-pools-contracts
Advanced tools
Tracer's Perpetual Pools ethers contract types
Tracer Perpetual Pools V2 is the second major release of Tracer's Perpetual Pools product.
Tracer Perpetual Pools is a system that provides leveraged, tokenised exposure to arbitrary assets via a simple and elegant model where settlement is locked within the system in exchange for pool tokens (via minting) and pool tokens are returned to the protocol in exchange for (some of) the underlying settlement tokens (via burning).
For additional information on the higher-level economics of how Pools works, please consult the whitepaper.
Sigma Prime have performed an audit of the previous version of the codebase — i.e., Perpetual Pools v1. Both the audit report and the team's response to the audit's findings are available here.
A crowdsourced audit was also undertaken via Code 423n4. The results are available here.
The most accurate version of this list is the set of all PRs merged in since 16 September 2021 until today (inclusive): https://github.com/tracer-protocol/perpetual-pools-contracts/pulls?q=is%3Apr+is%3Aclosed+merged%3A2021-09-16..2021-11-01
Regardless, an abridged list is provided for convenience:
SMAOracle.sol (https://github.com/tracer-protocol/perpetual-pools-contracts/pull/172)Any issues in the public repository that were opened prior to the start of CARE are considered known and thus out-of-scope.
Any given pool will be upkept (that is to say PoolCommitter::performUpkeepSinglePool, PoolCommitter::performUpkeepMultiplePools, or their packed variants are called with the LeveragedPool's address as a parameter) within a reasonable time after an update interval finishes (~15 minutes maximum)).
The update interval (LeveragedPool::updateInterval) is typically 1 hour (3600 seconds).
$ git clone git@github.com:tracer-protocol/perpetual-pools-contracts.git
$ cd perpetual-pools-contracts
perpetual-pools-contracts$ yarn install
$ yarn run compile
$ yarn run test
$ yarn run lint # to check
$ yarn run lint:fix # to fix
Requires Slither to both be installed and on current PATH.
$ yarn run slither
Via sol2uml:
$ yarn run uml
Note that this can take a while and also both gas usage and contract code size metrics will be incorrect (this is due to added overhead due to instrumentation).
$ yarn run coverage
Create/modify network config in hardhat.config.ts and add API key and private key, then run:
npx hardhat deploy --network arb --tags ArbDeploy --reset
npx hardhat deploy --network arbRinkeby --tags ArbRinkebyDeploy --reset
Note: As of this commit, deploys are out of sync with the current contract set-up and therefore will not work.
Using the hardhat-etherscan plugin, add Etherscan API key to hardhat.config.ts, then run:
npx hardhat verify --network rinkeby <DEPLOYED ADDRESS>
PRs and feedback welcome!
How are pool keepers to be chosen? How many keepers are there?
The Pool Keeper is simply a contract that enforces the correct keeper behaviour. Anyone may be a keeper by calling the keeper function on that contract with a pool that is valid for upkeep. We will initially be adding wrappers for Chainlink keepers as well as having custom keepers.
The leveraged pool fee is represented as a bytes16 value. Why is this chosen over something like uint? What denomination does this represent?
The leveraged pool fee is a bytes16 value simply due to the maths library used. We often represent values in WAD values (popularised by the Maker DAO team). WAD values are the integer value multiplied by 10^18 (e.g. 1 = 1*10^18). The maths library we currently use represents values in IEEE quad precision numbers and uses bytes as way of storing this. A good primer on the above can be found here and WAD / RAY maths is introduced here.
How many different type of tests are there? There are unit tests in the test suite. Are there also end to end tests?
Most tests are unit tests. There is a single E2E test in e2e.spec.ts right now. We plan to add more.
Whats the deployments/kovan folder for? They seem to be different from the ABIs I get from artifacts folder when I compile.
We use a plugin for hardhat called hardhat deploy that helps with deployment. They recommend you commit the deployments folder to have consistent data across deploys. The deploys you find there will be deploys that have been run from old versions of the contract, hence the ABI difference.
FAQs
Tracer's Perpetual Pools ethers contract types
The npm package @tracer-protocol/perpetual-pools-contracts receives a total of 1 weekly downloads. As such, @tracer-protocol/perpetual-pools-contracts popularity was classified as not popular.
We found that @tracer-protocol/perpetual-pools-contracts demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 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.
Security News
Deno 2.2 enhances Node.js compatibility, improves dependency management, adds OpenTelemetry support, and expands linting and task automation for developers.
Security News
React's CRA deprecation announcement sparked community criticism over framework recommendations, leading to quick updates acknowledging build tools like Vite as valid alternatives.
Security News
Ransomware payment rates hit an all-time low in 2024 as law enforcement crackdowns, stronger defenses, and shifting policies make attacks riskier and less profitable.