This is a default Next.js project bootstrapped with create-next-app, customized as the default boilerplate for new Web3 projects.

Features

• Separate packages from ethers.js for improved tree-shaking, often only ethers Contracts
• Hooks-first approach to fetching and caching data from Contracts and memoization for performance with SWR
• web3-react for ease of connecting to Web3 providers with a solid API
• Auto-generates types for the contract ABIs in the /contracts folder via TypeChain

Auto Contract Type Generation

Note: After adding in your new contract ABIs (in JSON format) to the /contracts folder, run yarn compile-contract-types to generate the types.

You can import these types when declaring a new Contract hook. The types generated show the function params and return types of your functions, among other helpful types.

import MY_CONTRACT_ABI from "../contracts/MY_CONTRACT.json";
import type { MY_CONTRACT } from "../contracts/types";
import useContract from "./useContract";

export default function useMyContract() {
  return useContract<MY_CONTRACT>(CONTRACT_ADDRESS, MY_CONTRACT_ABI);
}

Previous Art

• NoahZinsmeister/hypertext

Getting Started

First, run the development server:

npm run dev
# or
yarn dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying pages/index.js. The page auto-updates as you edit the file.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Flow

The UX flow is based on impermax/tarot.to to start with:

• User is presented with a number of vaults with several assets to deposit, mainly: token0 - token1 - LPv2 - LPv3 (as a group)
• User can enter vault to see stats + deposit assets to earn
  • Simple Token0 / token1 deposit for single assets exposure
  • LPv2 deposit (and potentially leveraged farming but non essential: requires smart contract dev)
  • LPv3: sends to ranger page
• Ranger: provides range farming
  • Present available ranges (currently just use fixed dont care about querying contracts)
    • how to present multiple ranges? one solution is all ranges as boxes. we can also select a number of active ranges, e.g
    • strategies: multi ranges suggestions, "extended crab" "bear crab" "bull crab"

TODO

• Deposit regular assets in the lending pool: EARN
  • Deposit withdraw popup
  • hook approve
  • hook deposit
• Deposit LPv2 in lending pool
  • not urgent as same as impermax
• Deposit LPv3 in the lending pool
  • way 0: 1x, no need for loan, just deposit and put in ROE so higher APY
  • way 1: borrow LPv2, split, range
  • way 2: deposit any collateral: to express a view. position uses what's in the LP
• CDS style interface
  • borrow LPv2 + split