NFTX is a platform for creating liquid markets for illiquid Non-Fungible Tokens (NFTs).
Users deposit their NFT into an NFTX vault to fractionalize and mint a fungible ERC20 token (vToken). This vToken can be redeem back for any NFT from the vault, by paying a redeem fee in ETH.

The vTokens can then be used to earn yield by:

1. Depositing into InventoryStaking to earn ETH (from vault fees) + vTokens (from early withdrawal fees)
2. Pairing the vTokens with ETH and providing concentrated liquidity into the NFTX AMM to earn trading fees and additional ETH (from vault fees).

Allows the following 3 main operations:
i. mint: Deposits NFTs and mints vault tokens in exchange.
ii. redeem: Burn vault tokens to redeem NFTs from the vault in exchange.
iii. swap: Swap an array of NFTs into a desired array of NFTs from the vault.

All of the above operations require the user to pay vault fees in ETH, calculated as a % of the ~20 min TWAP of the vToken from our AMM pool (with fee tier = FeeDistributor.rewardFeeTier()). If the pool doesn't exist yet, then no vault fees are deducted.

The vault fees collected here are sent to the NFTXFeeDistributorV3 in the same transaction to distribute to Inventory stakers and Liquidity Providers.

In case of redeeming/swapping into a newly deposited NFT from a vault, an extra premium in ETH needs to be paid along with the vault fees. This premium is shared with the original depositor of the redeemed tokenId and the rest of the stakers. This premium amount goes down exponentially since being deposited into the vault and finally settling on 0.

Additional features:

• Flash-minting without any added fees.
• Using Eligibility modules to only allow certain tokenIds into the Vault.

Allows to deploy Beacon Proxies for the Vaults.

Allows to distribute WETH (vault fees) between multiple receivers including inventory stakers and NFTX AMM liquidity providers in the rewardFeeTier pool.

Allows users to stake vTokens and mint xNFT in exchange that earns WETH and vTokens as fees. The WETH vault fees are distributed equally among all the stakers.

• NFTs can also be directly staked via Inventory, which internally mints vTokens but without deducting any vault fees. As users can use this to game and avoid the mint fees, so a redeem timelock is placed on the xNFT.
• There is an option to early withdraw (while still in timelock) by paying a % of your vTokens as penalty, which gets distributed among rest of the stakers. This penalty goes down linearly overtime.
• Users can collect and withdraw the WETH accumulated by their position
• During withdrawal, users have the option to redeem NFTs from the vault with their underlying vToken balance. No vault fees is paid if initially the xNFT position was created by depositing NFTs.
• Users can combine multiple xNFT positions into one, after each of their timelocks have run out.

Forked from Uniswap, and converted into an upgradeable contract. Allows to deploy NFTX AMM pools as Create2 Beacon Proxies.

Forked from Uniswap. Added distributeRewards function, to be called by the FeeDistributor, which allows to distribute the WETH vault fees to the LPs in the current tick, proportional to their share of the liquidity.
If the pool is in rewardFeeTier, then cardinality is set during initialization of the pool so that it's able to provide TWAP for the vault fee calculations. The cost of initialization of the observations slots is forwarded & distributed to the first swappers.

Forked from Uniswap. Allows NFTX AMM positions to be represented as ERC721 NFTs. Allows the NFTXRouter to timelock positions from withdrawing liquidity, though more liquidity can still be added.

• Vault fees accumulated as WETH show up the same way as normal LP fees.

Router to facilitate vault tokens minting/burning + addition/removal of concentrated liquidity, all in one transaction.

• NFTs can be directly deposited into the pool via NFTXRouter, which internally mints vTokens but without deducting any vault fees. As users can use this to game and avoid the mint fees, so a redeem timelock is placed on the LP NFT.
• During withdrawal, users have the option to redeem NFTs from the vault with their underlying vToken balance. No vault fees is paid if initially the position was created by depositing NFTs.
• NFTs can be directly sold and bought from the pool in exchange for ETH, via the AMM.

An amalgomation of vault creation steps, merged and optimised in a single contract call.
Allows to create a new Vault, mint vTokens in exchange for NFTs, deploy new NFTX AMM pool, deposit the minted vTokens and the ETH sent into the AMM pool to mint liquidity position NFT, deposit the remaining vTokens into inventory staking to mint xNFT.

Marketplace Zap that utilizes Uniswap's Universal Router to facilitate tokens swaps via Sushiswap and NFTX AMM. Enables deducting creator royalties via ERC2981.

• sell721/sell1155: sell NFT tokenIds to ETH.
  idsIn --{--mint-> [vault] -> vTokens --sell-> [UniversalRouter] --}-> ETH
• swap721/swap1155: Swap an array of NFTs into a desired array of NFTs from the vault, by paying ETH for vault fees.
• buyNFTsWithETH: buy NFT tokenIds with ETH.
  ETH --{-sell-> [UniversalRouter] -> vTokens + ETH --redeem-> [vault] --}-> idsOut
• buyNFTsWithERC20: buy NFT tokenIds with ERC20.
  ERC20 --{-sell-> [UniversalRouter] -> ETH -> [UniversalRouter] -> vTokens + ETH --redeem-> [vault] --}-> idsOut

Allows the users to migrate their NFTX v2 positions to v3:

• from v2 vTokens in sushiswap liquidity to v3 vTokens in NFTX AMM.
• from v2 vTokens in v2 inventory staking to v3 vTokens in xNFT.
• from v2 vTokens to v3 vTokens in xNFT.

We use Foundry for tests and Hardhat for contract deployments. Refer to installation instructions for foundry here.

git clone https://github.com/NFTX-project/nftx-protocol-v3.git
cd nftx-protocol-v3
forge install
yarn install

Copy .env.sample into .env and fill out the env variables.

forge test

1. To deploy core V3 contracts (including Uniswap V3 Fork):

yarn deploy:goerli --maxfee <inWei> --priorityfee <inWei> --tags NFTXV3

2. Deploy new Universal Router (https://github.com/NFTX-project/nftx-universal-router) with updated address for UniswapV3 Factory address.
3. Deploy all Zaps:

yarn deploy:goerli --maxfee <inWei> --priorityfee <inWei> --tags Zaps

4. Run the following to generate ./addresses.json for the deployed contract addresses

yarn gen:addresses

Note: Tags are defined in the deploy script at the end like: func.tags = ["<tag>"]

yarn verify:goerli

Note: For some UniswapV3 contracts there might be some error while verifying, so run this for those contracts:

yarn verify:goerli --license "GPL-2.0" --force-license --solc-input

• How to verify the Create2BeaconProxy (for Vaults):

  source .env &&
  forge verify-contract --chain-id 1 \
    0x8e42595f46e5998332F51D3267830DE982A3E59a \
    src/custom/proxy/Create2BeaconProxy.sol:Create2BeaconProxy \
    --num-of-optimizations 800 \
    --compiler-version v0.8.15+commit.e14f2714 \
    --watch \
    --etherscan-api-key $ETHERSCAN_API_KEY
  

  where 0x8e42595f46e5998332F51D3267830DE982A3E59a = vault (proxy) address.

• How to verify the Create2BeaconProxy (for UniswapV3Pool):

  source .env &&
  forge verify-contract --chain-id 1 \
    0x2c2511250C3561F6E5f8999Ac777d9465E7e27FA \
    src/custom/proxy/Create2BeaconProxy.sol:Create2BeaconProxy \
    --num-of-optimizations 380 \
    --compiler-version v0.8.15+commit.e14f2714 \
    --watch \
    --etherscan-api-key $ETHERSCAN_API_KEY
  

  where 0x2c2511250C3561F6E5f8999Ac777d9465E7e27FA = pool (proxy) address.