ERC-4626 토큰 (Tokenized Vault)

Share 토큰 1개의 가치 = 총 자산 / 총 Share 발행량

초기 상태:
- Alice가 1,000 USDC 예치 → 1,000 vUSDC 받음
- Bob이 1,000 USDC 예치 → 1,000 vUSDC 받음
- 총 자산: 2,000 USDC, 총 Share: 2,000 vUSDC
- 1 vUSDC = 1 USDC

수익 발생 후:
- 볼트가 200 USDC 수익 창출
- 총 자산: 2,200 USDC, 총 Share: 2,000 vUSDC
- 1 vUSDC = 1.1 USDC

인출 시:
- Alice가 1,000 vUSDC 반환 → 1,100 USDC 받음 (100 USDC 수익)
- Bob이 1,000 vUSDC 반환 → 1,100 USDC 받음 (100 USDC 수익)

// ERC-4626 컨트랙트 내부
// 기초 자산 토큰
IERC20 public immutable asset;

// ERC-20에서 상속받은 잔액 매핑 (Share 잔액)
mapping(address => uint256) private _balances;

// 예시:
// _balances[alice] = 1000  // Alice는 1,000 Share 보유
// _balances[bob] = 500     // Bob은 500 Share 보유

// Asset → Share 변환 (예치 시)
function convertToShares(uint256 assets) public view returns (uint256) {
    uint256 supply = totalSupply();
    return supply == 0 ? assets : (assets * supply) / totalAssets();
}

// Share → Asset 변환 (인출 시)
function convertToAssets(uint256 shares) public view returns (uint256) {
    uint256 supply = totalSupply();
    return supply == 0 ? shares : (shares * totalAssets()) / supply;
}

// 기초 자산의 컨트랙트 주소 반환
function asset() public view returns (address)

// 볼트가 관리하는 총 자산 반환
function totalAssets() public view returns (uint256)

// 주어진 Asset 수량을 Share로 변환
// 예치 시 받을 Share 계산에 사용
function convertToShares(uint256 assets) public view returns (uint256)

// 주어진 Share 수량을 Asset으로 변환
// 인출 시 받을 Asset 계산에 사용
function convertToAssets(uint256 shares) public view returns (uint256)

// 특정 주소가 한 번에 예치 가능한 최대 자산
function maxDeposit(address receiver) public view returns (uint256)

// 특정 주소가 한 번에 발행 가능한 최대 Share
function maxMint(address receiver) public view returns (uint256)

// 특정 주소가 한 번에 인출 가능한 최대 자산
function maxWithdraw(address owner) public view returns (uint256)

// 특정 주소가 한 번에 상환 가능한 최대 Share
function maxRedeem(address owner) public view returns (uint256)

// 예치 시 받을 Share 미리보기 (수수료 등 반영)
function previewDeposit(uint256 assets) public view returns (uint256)

// 발행 시 필요한 Asset 미리보기
function previewMint(uint256 shares) public view returns (uint256)

// 인출 시 필요한 Share 미리보기
function previewWithdraw(uint256 assets) public view returns (uint256)

// 상환 시 받을 Asset 미리보기
function previewRedeem(uint256 shares) public view returns (uint256)

// Asset 기준 예치: 특정 양의 자산을 예치하고 Share를 받음
// assets: 예치할 자산 수량
// receiver: Share를 받을 주소
function deposit(uint256 assets, address receiver) public returns (uint256 shares)

// Share 기준 예치: 특정 양의 Share를 받기 위해 필요한 자산 예치
// shares: 받고 싶은 Share 수량
// receiver: Share를 받을 주소
function mint(uint256 shares, address receiver) public returns (uint256 assets)

// Asset 기준 인출: 특정 양의 자산을 인출
// assets: 인출할 자산 수량
// receiver: 자산을 받을 주소
// owner: Share를 소각할 주소
function withdraw(uint256 assets, address receiver, address owner) public returns (uint256 shares)

// Share 기준 인출: 특정 양의 Share를 상환하고 자산 받음
// shares: 상환할 Share 수량
// receiver: 자산을 받을 주소
// owner: Share를 소각할 주소
function redeem(uint256 shares, address receiver, address owner) public returns (uint256 assets)

// 자산이 예치될 때 발생
event Deposit(
    address indexed sender,    // 자산을 보낸 주소
    address indexed owner,     // Share를 받은 주소
    uint256 assets,           // 예치된 자산 수량
    uint256 shares            // 발행된 Share 수량
)

// 자산이 인출될 때 발생
event Withdraw(
    address indexed sender,    // 인출을 실행한 주소
    address indexed receiver,  // 자산을 받은 주소
    address indexed owner,     // Share가 소각된 주소
    uint256 assets,           // 인출된 자산 수량
    uint256 shares            // 소각된 Share 수량
)

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";

contract SimpleVault is ERC20 {
    // 기초 자산 토큰
    IERC20 public immutable _asset;

    // 이벤트
    event Deposit(address indexed sender, address indexed owner, uint256 assets, uint256 shares);
    event Withdraw(address indexed sender, address indexed receiver, address indexed owner, uint256 assets, uint256 shares);

    constructor(IERC20 assetToken) ERC20("Vault Token", "vTKN") {
        _asset = assetToken;
    }

    // 기초 자산 주소 반환
    function asset() public view returns (address) {
        return address(_asset);
    }

    // 볼트가 보유한 총 자산
    function totalAssets() public view returns (uint256) {
        return _asset.balanceOf(address(this));
    }

    // Asset → Share 변환
    function convertToShares(uint256 assets) public view returns (uint256) {
        uint256 supply = totalSupply();
        return supply == 0 ? assets : (assets * supply) / totalAssets();
    }

    // Share → Asset 변환
    function convertToAssets(uint256 shares) public view returns (uint256) {
        uint256 supply = totalSupply();
        return supply == 0 ? shares : (shares * totalAssets()) / supply;
    }

    // 예치 미리보기
    function previewDeposit(uint256 assets) public view returns (uint256) {
        return convertToShares(assets);
    }

    // 상환 미리보기
    function previewRedeem(uint256 shares) public view returns (uint256) {
        return convertToAssets(shares);
    }

    // Asset 기준 예치
    function deposit(uint256 assets, address receiver) public returns (uint256 shares) {
        require(assets > 0, "예치할 자산이 없습니다");

        shares = previewDeposit(assets);
        require(shares > 0, "발행될 Share가 없습니다");

        // 자산을 볼트로 전송
        _asset.transferFrom(msg.sender, address(this), assets);

        // Share 발행
        _mint(receiver, shares);

        emit Deposit(msg.sender, receiver, assets, shares);
    }

    // Share 기준 인출 (redeem)
    function redeem(uint256 shares, address receiver, address owner) public returns (uint256 assets) {
        require(shares > 0, "상환할 Share가 없습니다");

        // 호출자가 owner가 아니면 allowance 체크
        if (msg.sender != owner) {
            uint256 allowed = allowance(owner, msg.sender);
            require(allowed >= shares, "승인 한도 초과");
            _approve(owner, msg.sender, allowed - shares);
        }

        assets = previewRedeem(shares);
        require(assets > 0, "인출할 자산이 없습니다");

        // Share 소각
        _burn(owner, shares);

        // 자산 전송
        _asset.transfer(receiver, assets);

        emit Withdraw(msg.sender, receiver, owner, assets, shares);
    }

    // Asset 기준 인출 (withdraw)
    function withdraw(uint256 assets, address receiver, address owner) public returns (uint256 shares) {
        require(assets > 0, "인출할 자산이 없습니다");

        shares = convertToShares(assets);

        // 호출자가 owner가 아니면 allowance 체크
        if (msg.sender != owner) {
            uint256 allowed = allowance(owner, msg.sender);
            require(allowed >= shares, "승인 한도 초과");
            _approve(owner, msg.sender, allowed - shares);
        }

        // Share 소각
        _burn(owner, shares);

        // 자산 전송
        _asset.transfer(receiver, assets);

        emit Withdraw(msg.sender, receiver, owner, assets, shares);
    }
}

// Alice가 1,000 USDC 예치
usdc.approve(vaultAddress, 1000);
vault.deposit(1000, alice);

// 컨트랙트 내부에서 일어나는 일:
// 1. Share 계산
uint256 shares = convertToShares(1000);  // 예: 1,000 vUSDC

// 2. USDC를 볼트로 전송
usdc.transferFrom(alice, vault, 1000);

// 3. Share 토큰 발행
_mint(alice, 1000);  // Alice에게 1,000 vUSDC 발행

emit Deposit(alice, alice, 1000, 1000);

// Alice가 1,000 vUSDC 상환 (수익 포함)
vault.redeem(1000, alice, alice);

// 컨트랙트 내부에서 일어나는 일:
// 1. 받을 자산 계산
uint256 assets = convertToAssets(1000);  // 예: 1,100 USDC (수익 포함)

// 2. Share 소각
_burn(alice, 1000);

// 3. USDC 전송
usdc.transfer(alice, 1100);

emit Withdraw(alice, alice, alice, 1100, 1000);

// Asset 기준: 정확히 1,000 USDC 예치
vault.deposit(1000, alice);  // Share는 환율에 따라 결정

// Share 기준: 정확히 1,000 vUSDC 받기
vault.mint(1000, alice);  // 필요한 USDC는 환율에 따라 결정

// Asset 기준: 정확히 1,000 USDC 인출
vault.withdraw(1000, alice, alice);  // 소각될 Share는 환율에 따라 결정

// Share 기준: 정확히 1,000 vUSDC 상환
vault.redeem(1000, alice, alice);  // 받을 USDC는 환율에 따라 결정

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import {ERC4626} from "@openzeppelin/contracts/token/ERC20/extensions/ERC4626.sol";
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import {IERC20} from "@openzeppelin/contracts/token/ERC20/IERC20.sol";

contract MyVault is ERC4626 {
    constructor(IERC20 asset_)
        ERC4626(asset_)
        ERC20("My Vault Token", "mvTKN")
    {}

    // 수익 창출 로직은 여기에 구현
    // 예: 외부 프로토콜에 자산 예치, 수익 수확 등
}

받을 Share = 예치할 자산 × 총 Share / 총 자산

// 볼트 생성 시 최소량의 Share를 영구 잠금
constructor() {
    _mint(address(0xdead), 1000); // 아무도 사용할 수 없는 주소로 Share 전송
}

// 프론트엔드에서 슬리피지 허용 범위 설정
uint256 expectedShares = vault.previewDeposit(assets);
uint256 minShares = expectedShares * 99 / 100; // 1% 슬리피지 허용

uint256 actualShares = vault.deposit(assets, receiver);
require(actualShares >= minShares, "슬리피지 초과");

// preview에서 수수료를 반영하지 않음 - 잘못됨!
function previewDeposit(uint256 assets) public view returns (uint256) {
    return convertToShares(assets); // 수수료 미반영
}

function deposit(uint256 assets, address receiver) public returns (uint256) {
    uint256 fee = assets * 2 / 100; // 2% 수수료
    uint256 shares = convertToShares(assets - fee); // 실제로는 수수료 차감
    // 사용자는 예상보다 적은 Share를 받음!
}

// preview에서 수수료를 정확히 반영
function previewDeposit(uint256 assets) public view returns (uint256) {
    uint256 fee = assets * 2 / 100; // 2% 수수료
    return convertToShares(assets - fee);
}

function deposit(uint256 assets, address receiver) public returns (uint256) {
    uint256 fee = assets * 2 / 100;
    uint256 shares = convertToShares(assets - fee);
    // preview와 동일한 결과
}