perpetual-protocol/perp-curie-contract

Perpetual Protocol Curie (v2) core contracts

perp-curie-contract

This repository contains the core smart contracts for Perpetual Protocol Curie (v2).

Contract source code and metadata are also published as npm packages:

• @perp/curie-contract (source code)
• @perp/curie-deployments (artifacts and deployed addresses)

Get Started

Please check out:

• Perpetual Protocol v2 Smart Contract Documentation
• Perpetual Protocol v2 User Docs

Deployments

Perpetual Protocol Curie (v2) are deployed on Optimism mainnet (an Ethereum Layer 2 network).

Contract addresses:

• https://metadata.perp.exchange/v2/optimism.json (Optimism mainnet)
• https://metadata.perp.exchange/v2/optimism-goerli.json (Optimism Goerli testnet)

You could also find the deployed contract addresses inside the npm package @perp/curie-deployments.

Local Development

You need Node.js 16+ to build. Use nvm to install it.

Clone this repository, install Node.js dependencies, and build the source code:

git clone [email protected]:perpetual-protocol/perp-curie-contract.git
npm i
npm run build

If the installation failed on your machine, please try a vanilla install instead:

npm run clean
rm -rf node_modules/
rm package-lock.json
npm install
npm run build

Run all the test cases:

npm run test

Changelog

See CHANGELOG.

Audit Reports

See audits.

Bug Bounty Program

This repository is subject to the Perpetual Protocol v2 bug bounty program, per the terms defined on ImmuneFi.

Grant Program

Projects, ideas and events that benefit Perpetual Protocol and its ecosystem are eligible for grants!

Related Projects

• perp-oracle-contract
• perp-curie-periphery-contract
• perp-curie-subgraph

---

If any features/functionalities described in the Perpetual Protocol documentation, code comments, marketing, community discussion or announcements, pre-production or testing code, or other non-production-code sources, vary or differ from the code used in production, in case of any dispute, the code used in production shall prevail.

perp-curie-contract's Issues

Access request to feeGrowthOutside specs notion page

perp-curie-contract/contracts/lib/Tick.sol

Lines 70 to 79 in f98ff08

	/// @return all values returned can underflow per feeGrowthOutside specs;
	/// see https://www.notion.so/32990980ba8b43859f6d2541722a739b
	function getAllFundingGrowth(
	mapping(int24 => GrowthInfo) storage self,
	int24 lowerTick,
	int24 upperTick,
	int24 currentTick,
	int256 twPremiumGrowthGlobalX96,
	int256 twPremiumDivBySqrtPriceGrowthGlobalX96
	) internal view returns (FundingGrowthRangeInfo memory) {

We're currently doing some uniswap v3/trident stuffs, accidentally we found some articles about the uniswap's underflow issue.

According to this (Uniswap/v3-periphery#164), I assume that this is why perpetual team does not use safemath on the fee growth calculation logic.

However, I cannot understand that how the under/overflow situation occurs. To resolve this, I wanna get an access to that notion page.

Thanks.