Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@otterspace-xyz/contracts) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

otterspace-contracts

Otterspace’s EIP-4973-compliant non-transferable badge protocol helps DAOs create better incentive systems, automate permissions and enable non-financialized governance ✨ 🦦 🚀

Project setup

Install Foundry
Requires Node v16 and Solidity 0.8.16

git clone git@github.com:otterspace-xyz/otterspace-contracts.git
git submodule update --init
yarn
forge install
forge build
forge test
npx hardhat typechain
npx hardhat test

Live contracts on Optimism:

Live contracts on Goerli:

Use ABIs with JavaScript

We're publishing this repository at @otterspace-xyz/contracts

npm i @otterspace-xyz/contracts

With node >= 16, contract ABIs can be imported into JavaScript applications as npm dependencies as follows:

Badges ABI

import Badges from '@otterspace-xyz/contracts/out/Badges.sol/Badges.json' assert { type: 'json' }

Raft ABI

import Raft from '@otterspace-xyz/contracts/out/Raft.sol/Raft.json' assert { type: 'json' }

SpecDataHolder ABI

import SpecDataHolder from '@otterspace-xyz/contracts/out/SpecDataHolder.sol/SpecDataHolder.json' assert { type: 'json' }

We're exporting specific .sol files using the "files" property in package.json. Please familiarize yourself with the .sol files we're exporting by looking into package.json.

Tech Stack

We use Foundry and Hardhat together. With this setup we get:

Unit tests written in Solidity (Forge)
Integration tests written in JavaScript (Mocha)

Foundry

Foundry is a blazing fast, portable and modular toolkit for Ethereum application development written in Rust.

Foundry consists of:

Forge: Ethereum testing framework (like Truffle, Hardhat and DappTools).
Cast: Swiss army knife for interacting with EVM smart contracts, sending transactions and getting chain data.
Anvil: local Ethereum node, akin to Ganache, Hardhat Network.

Need help getting started with Foundry? Read the 📖 Foundry Book!

Hardhat

Hardhat is an Ethereum development environment for professionals. It facilitates performing frequent tasks, such as running tests, automatically checking code for mistakes or interacting with a smart contract.

On Hardhat's website you will find:

Deploying contracts for the first time

create a .env file matching the variables seen in .env.example
run ./scripts/deployProxy.ts .env
Hardhat will deploy the SpecDataHolder, Raft, and Badges contracts, then deploy a proxy for each one.
Once deployed, follow the logged instructions in your terminal to verify the contracts.
it will tell you: npx hardhat verify --network ${networkName} ${contractAddress}

Testing upgradability

Our contracts use the OpenZeppelin UUPS proxy pattern for upgrades.
To test your working changes against the latest release:
1. make sure you're on the latest from the dev branch
1. run forge build to make sure you've generated the latest ABIs
1. copy the contents of:
- artifacts/src/Badges.sol/Badges.json into src/test/abis/latest
- artifacts/src/Raft.sol/Raft.json into src/test/abis/latest
- artifacts/src/SpecDataHolder.sol/SpecDataHolder.json into src/test/abis/latest
1. make some changes to the contracts
1. run npx hardhat testUpgrade
1. As long as you don't see errors, your new contract is upgrade safe!

Running upgrades (overview)

Once you've confirmed that the contracts are upgrade safe you'll
- deploy an implementation (not proxy) of each changed contract
- point the proxy at the new implementation

Running upgrades (steps)

make sure your .env.implemntation file has the correct values
run ./scripts deploy_and_verify_implementation.sh .env.implementation ${contractName} ${networkName}
to deploy Badges on Optimism it would be
- ./scripts deploy_and_verify_implementation.sh .env.implementation Badges optimism
watch the console for confirmation of deployment and verification, copy the implementation's address
go into Defender and propose and execute the upgrade

Foundry setup for VS Code Users

Add a .vscode file under the root

{
  "solidity.packageDefaultDependenciesContractsDirectory": "src",
  "solidity.packageDefaultDependenciesDirectory": "lib",
  "solidity.compileUsingRemoteVersion": "v0.8.16"
}

Changelog

See changelog.md file.

Checklist for bumping version

update "version" in package.json
update contract addresses in readme (if necessary)
update changelog

License

See LICENSE file.