​

Coin Contract

​

Constructor

constructor(
    address _minter,
    string memory name,
    string memory symbol
)

• _minter: Address authorized to mint new tokens (Lender.sol)
• name: ERC20 token name (e.g., “USD Coin”)
• symbol: ERC20 token symbol (e.g., “USDC”)

​

User-Facing Functions

​

mint

function mint(address to, uint256 amount) external

• to: Address to receive the minted tokens
• amount: Amount of tokens to mint (in wei, 18 decimals)

• msg.sender must be the minter address (Lender.sol).

• Transfer(address(0), to, amount)

​

burn

function burn(uint256 amount) external

• amount: Amount of tokens to burn from caller’s balance

• Caller must have sufficient balance (balanceOf(msg.sender) >= amount)

• Transfer(msg.sender, address(0), amount)

​

transfer

function transfer(address to, uint256 amount) external returns (bool)

• to: Recipient address
• amount: Amount of tokens to transfer

• bool: Always returns true on successful transfer

• Caller must have sufficient balance

• Transfer(msg.sender, to, amount)

​

transferFrom

function transferFrom(address from, address to, uint256 amount) external returns (bool)

• from: Address to transfer tokens from
• to: Recipient address
• amount: Amount of tokens to transfer

• bool: Always returns true on successful transfer

• from must have sufficient balance
• Caller must have sufficient allowance from from

• Transfer(from, to, amount)

​

approve

function approve(address spender, uint256 amount) external returns (bool)

• spender: Address authorized to spend tokens
• amount: Maximum amount spender can transfer

• bool: Always returns true on successful approval

• Approval(msg.sender, spender, amount)

​

View Functions

​

balanceOf

function balanceOf(address account) external view returns (uint256)

• account: Address to query balance for

• uint256: Token balance in wei

​

allowance

function allowance(address owner, address spender) external view returns (uint256)

• owner: Address that granted the allowance
• spender: Address authorized to spend

• uint256: Remaining allowance amount

​

totalSupply

function totalSupply() external view returns (uint256)

• uint256: Total token supply in wei

​

name

function name() external view returns (string memory)

• string: Token name

​

symbol

function symbol() external view returns (string memory)

• string: Token symbol

​

decimals

function decimals() external view returns (uint8)

• uint8: Number of decimals (18 for this token)

​

minter

function minter() external view returns (address)

• address: Minter address

​

Events

​

Transfer

event Transfer(address indexed from, address indexed to, uint256 amount)

• from: Sender address (address(0) for mints)
• to: Recipient address (address(0) for burns)
• amount: Amount of tokens transferred

​

Approval

event Approval(address indexed owner, address indexed spender, uint256 amount)

• owner: Address granting the allowance
• spender: Address receiving the allowance
• amount: New allowance amount