@leap-network/v4-timelocks
v1.1.2
Published
PoolTogether V4 Timelocks
Downloads
4
Readme
PoolTogether V4 Timelocks Contracts
Have questions or want the latest news? Join the PoolTogether Discord or follow us on Twitter:
Documentation https://v4.docs.pooltogether.com
Deployments
Overview
- BeaconTimelockTrigger
- DrawCalculatorTimelock
- L1TimelockTrigger
- L2TimelockTrigger
- ReceiverTimelockTrigger
Timelock contracts assist with Phase 1 in the roll-out of V4. Granting authority to the operations teams to prevent a "bad actor" oracle from incorrectly setting a draw or prize distribution params.
DrawCalculatorTimelock
The DrawCalculatorTimelock adds a timelock for PrizeDistributor to execute a claim with the most recently pushed PrizeDistribution params pushed.
L1TimelockTrigger & L2TimelockTrigger
Both L1TimelockTrigger/L2TimelockTrigger contracts set a timelock or a "cooldown" period in the linked DrawCalculatorTimelock
contract. The DrawCalculatorTimelock
routes calculate
execution through a DrawCalculator
contract for the linked PrizeDistributor
contract.
L1TimelockTrigger
The L1TimelockTrigger
contract pushes DrawLib.Draw
and DrawLib.PrizeDistribution
params onto the DrawBuffer
and PrizeDistributionBuffer
contracts.
L2TimelockTrigger
The L2TimelockTrigger
pushes DrawLib.PrizeDistribution
params onto a PrizeDistributionBuffer
contract.
Core and Periphery contracts:
Getting Started
The project is made available as a NPM package.
yarn add @leap-network/pooltogether-contracts
The repo can be cloned from Github for contributions.
git clone https://github.com/pooltogether/v4-timelock
yarn
We use direnv to manage environment variables. You'll likely need to install it.
cp .envrc.example .envrc
To run fork scripts, deploy or perform any operation with a mainnet/testnet node you will need an Infura API key.
Testing
We use Hardhat and hardhat-deploy
To run unit & integration tests:
yarn test
To run coverage:
yarn coverage
Fork Testing
Ensure your environment variables are set up. Make sure your Alchemy URL is set. Now start a local fork:
yarn start-fork
Setup account impersonation and transfer eth:
./scripts/setup.sh
Deployment
Deploy Locally
Start a local node and deploy the top-level contracts:
yarn start
NOTE: When you run this command it will reset the local blockchain.
Testnets
Deployment is maintained in a different repo.
Mainnet
Deployment is maintained in a different repo.