WIchiFarm

This contract wraps the ICHI MasterChef farming contract by holding ICHI LP tokens in the BlueberryBank, while the underlying LP tokens are deposited into the ICHI farming pool to generate additional yields The LP tokens are identified by token IDs encoded from the LP token address and accPerShare of the deposited time.

Variables

The WIchiFarm contract has the following state variables:

  • ICHIv1: An IERC20Upgradeable variable that represents the address of the legacy ICHI token.

  • ICHI: An IIchiV2 variable that represents the address of the ICHI v2 token.

  • ichiFarm: An IIchiFarm variable that represents the address of the ICHI farming contract.

Functions

initialize

function initialize(address _ichi, address _ichiv1, address _ichiFarm) external initializer

This function initializes the contract's state variables with the provided ICHI v1, ICHI v2, and ICHI farming contract addresses.

Parameters:

NameTypeDescription

_ichi

address

Address of the ICHI v2 token contract

_ichiv1

address

Address of the ICHI v1 token address

_ichiFarm

address

Address of the ICHI farming contract

encodeId

function encodeId(uint256 pid, uint256 ichiPerShare) public pure returns (uint256 id)

This function encodes the pool ID and ICHI per share into an ERC-1155 token ID.

Parameters:

NameTypeDescription

pid

uint256

Pool ID

ichiPerShare

uint256

ICHI reward per share multiplied by 10e18

decodeId

function decodeId(uint256 id) public pure returns (uint256 pid, uint256 ichiPerShare)

This function decodes the ERC-1155 token ID into the pool ID and ICHI per share.The pid is the first 16 bits of the token id, and ichiPerShare is the last 240 bits of the token id.

Parameters:

  • id (uint256): ERC-1155 token ID

Returns:

NameTypeDescription

pid

uint256

The pool ID extracted from the first 16 bits fo the id

ichiPerShare

uint256

The value of ichiPerShare extracted from the last 240 bits of the id

getUnderlyingToken

function getUnderlyingToken(uint256 id) external view override returns (address)

This function returns the underlying ERC-20 token for a given ERC1155 token id. It calls decodeId to extract the pid from the token id and then looks up the corresponding LP token address from the ICHI farming pool.

Parameters:

  • id(uint256): The ERC1155 token ID to decode

Returns:

  • address: The address of the underlying ERC-20 token

pendingRewards

function pendingRewards(uint256 tokenId, uint amount) public view override returns (address[] memory tokens, uint256[] memory rewards)

This function returns the pending ICHI rewards for a given ERC1155 token id and amount of LP tokens. It calls decodeId to extract the pid and stIchiPerShare values from the token id, looks up the current enIchiPerShare value from the ICHI farming pool, and calculates the difference in ICHI rewards based on the change in ichiPerShare values.

Parameters:

NameTypeDescription

tokenId

uint256

The ERC1155 token ID to encode

amount

uint

The amount of share

Returns:

NameTypeDescription

tokens

array

An array containing the address of the reward token ( specifically ICHI)

rewards

uint256

An array containing the amount of ICHI rewards

mint

function mint(uint256 pid, uint256 amount) external nonReentrant returns (uint256)

This function mints new ERC1155 tokens by wrapping a user's LP tokens in the ICHI farming pool. It first transfers the LP tokens from the user to the ERC1155 contract, approves the ICHI farming pool to spend the LP tokens, deposits the LP tokens into the ICHI farming pool, and then mints new ERC1155 tokens with the pid and current ichiPerShare values.

Parameters:

NameTypeDescription

pid

uint256

The ID of the pool to deposit the LP tokens

amount

uint256

The amount of LP tokens to deposit

Returns:

  • uint256: The token ID that was minted.

burn

function burn(uint256 id, uint256 amount) external nonReentrant returns (uint256)

This function burns existing ERC1155 tokens to redeem a user's LP tokens from the ICHI farming pool and claim any pending ICHI rewards. It first decodes the token id to extract the pid, then burns the ERC1155 tokens from the user's account. It then calls the harvest and withdraw functions of the ICHI farming pool to claim the user's LP tokens and ICHI rewards, respectively. If the user has any pending ICHI rewards in the legacy ICHI contract, this function converts them to ICHI v2 tokens. Finally, the user's LP tokens and ICHI rewards are transferred to the user's account.

Parameters:

NameTypeDescription

id

uint256

The ERC1155 token ID to burn

amount

uint256

The amount of tokens to burn

Returns:

  • uint256: The pool ID that you will receive LP tokens back.

_ensureApprove

function _ensureApprove(address token, address spender, uint256 amount) internal

This internal function ensures that a user has approved the spender to spend at least the given amount of the given token. If the current allowance is less than the required amount, it approves the spender to spend the token up to the required amount.

Parameters:

NameTypeDescription

token

address

The address of the token to check

spender

address

The address of the spender to check

amount

uint256

The amount of allowance to ensure

Last updated