> For the complete documentation index, see [llms.txt](https://docs.gooddollar.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gooddollar.org/previous-protocol-versions/protocol-v3/core-contracts-and-api/gooddollar.md). # GoodDollar ### Events #### Transfer Emitted when `value` tokens are moved from one account (`from`) to another (`to`).

Parameter name	Annotation
from	The address from which tokens are moved.
to	The address to which tokens are moved.
value	The value to be processed and then transferred.

Note that `value` may be zero. ``` event Transfer(address indexed from, address indexed to, uint256 value); ``` #### Approval Emitted when the allowance of a `spender` for an `owner` is set by a call to {approve}. `value` is the new allowance.

Parameter name	Annotation
owner	The address of the tokens owner.
spender	The address which can spend tokens in allowance.
value	The tokens amount to be spent on behave of the tokens owner.

``` event Approval(address indexed owner, address indexed spender, uint256 value); ``` ### transfer Processes fees from given value and sends remainder to given address.

Parameter name	Annotation
to	The address to be sent to.
value	The value to be processed and then transferred.

Returns: a boolean that indicates if the operation was successful. ``` function transfer(address to, uint256 value) public returns (bool); ``` ### approve Approve the passed address to spend the specified amount of tokens on behalf of `msg.sender`.

Parameter name	Annotation
spender	The address which will spend the funds.
value	The amount of tokens to be spent.

Returns: a boolean that indicates if the operation was successful. ``` function approve(address spender, uint256 value) public returns (bool); ``` ### transferFrom Transfer tokens from one address to another on behalf of the third party as `msg.sender`.

Parameter name	Annotation
from	The address which you want to send tokens from.
to	The address which you want to transfer to.
value	The amount of tokens to be transferred.

Returns: a boolean that indicates if the operation was successful. ``` function transferFrom( address from, address to, uint256 value ) public returns (bool); ``` ### transferAndCall Processes transfer fees and calls ERC677Token transferAndCall function.

Parameter name	Annotation
from	The address to transfer to.
value	The amount to transfer.
data	The data to be used in further execution according to ERC677.

Returns: a boolean that indicates if the operation was successful. ``` function transferAndCall( address to, uint256 value, bytes calldata data ) external returns (bool); ``` ### mint Minting function.

Parameter name	Annotation
to	The address that will receive the minted tokens. Must be out of blocklist. The blocklist is managed by the administrator of the contract.
value	Value the amount of tokens to mint.

Who can execute: An address who is in minter role. Returns: a boolean that indicates if the operation was successful. ``` function mint(address to, uint256 value) public; ``` ### burn Burns a specific amount of tokens.

Parameter name	Annotation
value	The amount of token to be burned..

Who can execute: An address who is not blocklisted by the administration. ``` function burn(uint256 value) public; ``` ### burnFrom Burns a specific amount of tokens from the target address and decreases an allowance.

Parameter name	Annotation
from	The address which you want to burn tokens from. Must not be in blocklist.
value	The amount of token to be burned.

Who can execute: An address who is not blocklisted by the administration. ``` function burnFrom(address from, uint256 value) public; ``` ### increaseAllowance Increase the amount of tokens that an owner allows a spender.

Parameter name	Annotation
spender	The address which will spend the funds.
addedValue	The amount of tokens to increase the allowance by.

Returns: a boolean that indicates if the operation was successful. ``` function increaseAllowance(address spender, uint256 addedValue) public returns (bool); ``` ### decreaseAllowance Decrease the amount of tokens that an owner allowed to a spender.

Parameter name	Annotation
spender	The address which will spend the funds.
subtractedValue	The amount of tokens to decrease the allowance by.

Returns: a boolean that indicates if the operation was successful. ``` function decreaseAllowance(address spender, uint256 subtractedValue) public returns (bool); ``` ### getFees Gets the current transaction fees.

Parameter name	Annotation
value	Value the amount of tokens to mint.

Returns: tuple of `uint256` and `bool`, first is an absolute amount of fees based on value and the second is whether `msg.sender` paying or not. ``` function getFees(uint256 value) public view returns (uint256, bool); ``` ### setFeeRecipient Sets the address that receives the transactional fees.

Parameter name	Annotation
_feeRecipient	The new address to receive transactional fees.

Who can execute: An adminstrator only. ``` function setFeeRecipient(address _feeRecipient) public; ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.gooddollar.org/previous-protocol-versions/protocol-v3/core-contracts-and-api/gooddollar.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.