Gamma Protocol

Gamma is a decentralized capital efficient option protocol that enables sellers to create spreads. Gamma protocol enables any user to create arbitrary option tokens, that represent the right to buy or sell a certain asset in a predefined price (strike price) at or before expiry. As the option seller in Gamma, you can reduce the amount of capital locked in the system by creating spreads. (e.g Instead of putting down 100 USDC and mint 1 ETH-USDC-100 Put, you can buy a ETH-USDC-50 Put, and only deposit 50 USDC as collateral) The oTokens created by Gamma are cash settled European option, means all the options will automatically be exercised at expiry. A holder can redeem the proceeds by sending the oTokens back, the system will pay the holder the cash value based on strike price and underlying spot price at expiry, instead of actually exchanging the underlying asset and the strike asset.

Documentation

Our docs site is here. It contains tutorials, explainers, and smart contract documentation. If you'd like to view these docs on github instead, check out the docs folder in the docs repo:

• Smart contracts documentation
• UML diagrams
• Control flow diagrams

Local Development Setup

For local development it is recommended to use ganache to run a local development chain. Using the ganache simulator no full Ethereum node is required.

As a pre-requisite, you need:

• Node.js (v10.18.0)
• NPM

Clone the project and install all dependencies:

$ git clone https://github.com/opynfinance/GammaProtocol.git
$ cd GammaProtocol

# install project dependencies
$ npm i

Compile all contracts:

$ npm run build

In a new terminal, launch an Ethereum RPC client, we use the default ganache-cli command to configure and run a local development ganache:

$ npm run ganache

Switch back to your other terminal and deploy the contracts, and make sure to:

• Add your infura key in .infuraKey file
• Add your wallet mnemonic in .secret file
• Setup the deployments parameters in ./migrations/deployment-config.json file

# Local deployment
$ npm run deploy:development

# Mainnet deployment
$ npm run deploy:mainnet

Running Tests

Run all unit tests:

$ npm run test:unit

Run all integration tests:

$ npm run test:integration

Linting

Clean code is the best code, so we've provided tools to automatically lint your projects.

Lint all smart contracts:

$ npm run lint:sol

Lint all tests files:

$ npm run lint:tests

Automatically Fixing Linting Issues

We've also provided tools to make it possible to automatically fix any linting issues. It's much easier than trying to fix issues manually.

Fix all smart contracts:

$ npm run lint:sol:prettier:fix

Fix all tests files:

$ npm run lint:tests:prettier:fix

Coverage

We use the solidity-coverage package to generate our coverage reports. You can find the coverage report at coveralls. Otherwise, you can generate it locally by running:

$ npm run coverage

The full report can be viewed by opening the coverage/index.html file in a browser.

Testnet deployments

deployer: 0x775d1377223c9338771CbF955A9a53147219ea4A

weth: 0xE32513090f05ED2eE5F3c5819C9Cce6d020Fefe7

usdc: 0x3C6c9B6b41B9E0d82FeD45d9502edFFD5eD3D737

addressbook: 0x2d3E178FFd961BD8C0b035C926F9f2363a436DdC

otokenFactory: 0xcBcC61d56bb2cD6076E2268Ea788F51309FA253B

otoken: 0x07F00EB70837091b2D23c902561CE8D1b4df4702

whitelist: 0x0cc0b0C984036e0942544F70A5708Ab16463cd31

oracle: 0xe4d64aed5e76bCcE2C255f3c819f4C3817D42f19

pool: 0xDD91EB7C3822552D89a5Cb8D4166B1EB19A36Ff2

calculator: 0xa91B46bDDB891fED2cEE626FB03E2929702951A6

vault: 0x15887BD136Cdc8F170B8564e2E4568ee19C035F7

controller: 0xb2923CAbbC7dd78e9573D1D6d755E75dCB49CE47

pricer: 0xFfe61399050D2ACABa00419248B8616A4Bf56F9E

eth-pricer-bot: 0x282f13b62b4341801210657e3aa4ee1df69f4083

Security And Bug Bounty Program

The security of the Opyn protocol is our highest priority. Our team has created a protocol that we believe is safe and dependable, and has been audited by OpenZeppelin. All smart contract code is publicly verifiable and we have a bug bounty for undiscovered vulnerabilities. We encourage our users to be mindful of risk and only use funds they can afford to lose. Options are complex instruments that when understood correctly can be powerful hedges. Smart contracts are still new and experimental technology. We want to remind our users to be optimistic about innovation while remaining cautious about where they put their money.

Please see here for details on our security audit and bug bounty program.