LibToucanCarbon

Author: Cujo

Functions

redeemAutoAndRetire

Redeems Toucan pool tokens using default redemtion and retires the TCO2

function redeemAutoAndRetire(
    address poolToken,
    uint256 amount,
    address retiringAddress,
    string memory retiringEntityString,
    address beneficiaryAddress,
    string memory beneficiaryString,
    string memory retirementMessage
) internal;

Parameters

Name	Type	Description
`poolToken`	`address`	Pool token to use for this retirement
`amount`	`uint256`	Amount of the project token to retire
`retiringAddress`	`address`	Address initiating this retirement
`retiringEntityString`	`string`	String description of the retiring entity
`beneficiaryAddress`	`address`	0x address for the beneficiary
`beneficiaryString`	`string`	String description of the beneficiary
`retirementMessage`	`string`	String message for this specific retirement

redeemSpecificAndRetire

Redeems Toucan pool tokens using specific redemtion and retires the TCO2

function redeemSpecificAndRetire(
    address poolToken,
    address projectToken,
    uint256 amount,
    address retiringAddress,
    string memory retiringEntityString,
    address beneficiaryAddress,
    string memory beneficiaryString,
    string memory retirementMessage
) internal returns (uint256 retiredAmount);

Parameters

Name	Type	Description
`poolToken`	`address`	Pool token to use for this retirement
`projectToken`	`address`	Project token to use for this retirement
`amount`	`uint256`	Amount of the project token to retire
`retiringAddress`	`address`	Address initiating this retirement
`retiringEntityString`	`string`	String description of the retiring entity
`beneficiaryAddress`	`address`	0x address for the beneficiary
`beneficiaryString`	`string`	String description of the beneficiary
`retirementMessage`	`string`	String message for this specific retirement

Returns

Name	Type	Description
`retiredAmount`	`uint256`	The amount of TCO2 retired

retireTCO2

Redeems Toucan TCO2s

function retireTCO2(
    address poolToken,
    address projectToken,
    uint256 amount,
    address retiringAddress,
    string memory retiringEntityString,
    address beneficiaryAddress,
    string memory beneficiaryString,
    string memory retirementMessage
) internal;

Parameters

Name	Type	Description
`poolToken`	`address`	Pool token to use for this retirement
`projectToken`	`address`	Project token to use for this retirement
`amount`	`uint256`	Amount of the project token to retire
`retiringAddress`	`address`	Address initiating this retirement
`retiringEntityString`	`string`	String description of the retiring entity
`beneficiaryAddress`	`address`	0x address for the beneficiary
`beneficiaryString`	`string`	String description of the beneficiary
`retirementMessage`	`string`	String message for this specific retirement

retirePuroTCO2

Creates a Retirement Request for Toucan Puro TCO2s

function retirePuroTCO2(uint256 tokenId, address projectToken, uint256 amount, LibRetire.RetireDetails memory details)
    internal;

Parameters

Name	Type	Description
`tokenId`	`uint256`	Credit token ID to be retired
`projectToken`	`address`	Project token to use for this retirement
`amount`	`uint256`	Amount of the project token to retire
`details`	`LibRetire.RetireDetails`

sendRetireCert

Send the ERC-721 retirement certificate received to a beneficiary

function sendRetireCert(address _beneficiary) internal;

Parameters

Name	Type	Description
`_beneficiary`	`address`	Beneficiary to send the certificate to

getSpecificRedeemFee

Calculates the additional pool tokens needed to specifically redeem x TCO2s

function getSpecificRedeemFee(address poolToken, uint256 amount) internal view returns (uint256 poolFeeAmount);

Parameters

Name	Type	Description
`poolToken`	`address`	Pool token to redeem
`amount`	`uint256`	Amount of TCO2 needed

Returns

Name	Type	Description
`poolFeeAmount`	`uint256`	Number of additional pool tokens needed

getSpecificRetireAmount

Returns the number of TCO2s retired when selectively redeeming x pool tokens

function getSpecificRetireAmount(address poolToken, uint256 amount) internal view returns (uint256 retireAmount);

Parameters

Name	Type	Description
`poolToken`	`address`	Pool token to redeem
`amount`	`uint256`	Amount of pool tokens redeemed

Returns

Name	Type	Description
`retireAmount`	`uint256`	Number TCO2s that can be retired.

redeemPoolAuto

Simple wrapper to use redeem Toucan pools using the default list

function redeemPoolAuto(address poolToken, uint256 amount, LibTransfer.To toMode)
    internal
    returns (address[] memory projectTokens, uint256[] memory amounts);

Parameters

Name	Type	Description
`poolToken`	`address`	Pool token to redeem
`amount`	`uint256`	Amount of tokens being redeemed
`toMode`	`LibTransfer.To`	Where to send TCO2 tokens

Returns

Name	Type	Description
`projectTokens`	`address[]`	TCO2 token addresses redeemed
`amounts`	`uint256[]`	TCO2 token amounts redeemed

redeemPoolSpecific

Simple wrapper to use redeem Toucan pools using the specific list

function redeemPoolSpecific(
    address poolToken,
    address[] memory projectTokens,
    uint256[] memory amounts,
    LibTransfer.To toMode
) internal returns (uint256[] memory);

Parameters

Name	Type	Description
`poolToken`	`address`	Pool token to redeem
`projectTokens`	`address[]`	Project tokens to redeem
`amounts`	`uint256[]`	Token amounts to redeem
`toMode`	`LibTransfer.To`	Where to send TCO2 tokens

Returns

Name	Type	Description
`<none>`	`uint256[]`	redeemedAmounts TCO2 token amounts redeemed

isValid

function isValid(address token) internal returns (bool);

isPuro

function isPuro(address token) internal returns (bool);

Events

CarbonRetired

event CarbonRetired(
    LibRetire.CarbonBridge carbonBridge,
    address indexed retiringAddress,
    string retiringEntityString,
    address indexed beneficiaryAddress,
    string beneficiaryString,
    string retirementMessage,
    address indexed carbonPool,
    address carbonToken,
    uint256 retiredAmount
);

CarbonRetired

event CarbonRetired(
    LibRetire.CarbonBridge carbonBridge,
    address indexed retiringAddress,
    string retiringEntityString,
    address indexed beneficiaryAddress,
    string beneficiaryString,
    string retirementMessage,
    address indexed carbonPool,
    address carbonToken,
    uint256 tokenId,
    uint256 retiredAmount
);

KlimaDAO solidity reference documentation