AVATAR (AVA) Whitepaper

A. 일반 전송 — transfer() / transferFrom()

• 자유잔액(초기언락 + 선형해제 분)만 전송 가능
• 받는 지갑에 베스팅 조건 없음 — 자유 토큰으로 수령
• 락업잔액 전송 시도 시 트랜잭션 실패 (InsufficientAvailableBalance)
• 표준 ERC-20 approve / allowance 메커니즘 사용 가능

B. 베스팅 전송 — vestingTransferBySender()

일반 사용자가 본인의 락업 토큰을 직접 다른 지갑으로 전송할 수 있는 함수입니다.

• 발신자는 항상 msg.sender (본인 지갑) — 타인의 토큰 전송 불가
• 락업잔액만 전송 가능 (InsufficientLockedBalance)
• 받는 지갑에 초기언락 0, 해당 그룹의 클리프 + 선형해제 조건 상속
• 1회 호출당 1개 그룹 / 1개 스케줄만 지정 가능
• 그룹 지갑은 호출 불가 (GroupWalletNotAllowed)

vestingTransferBySender(group, to, amount, scheduleIndex)

차단되는 동작

Admin을 통한 전송

그룹 지갑의 토큰은 ADMIN_VESTING_MANAGER_ROLE을 가진 Admin(MultiSig)만 전송할 수 있습니다.

• 락업 토큰 전송: vestingTransferByAdmin() — 베스팅 조건 상속
• 언락 토큰 전송: groupWalletTransferByAdmin() — 자유 토큰으로 전송
• 소각: burnByAdmin() — 그룹별 조건 충족 시 (6. Burn Policy 참조)

A. 베스팅 전송 — vestingTransferByAdmin()

임의의 주소 간 락업 토큰을 전송하고, 베스팅 조건을 상속합니다.

• 그룹 지갑 → 개인 지갑, 개인 → 개인 모두 가능
• 받는 지갑에 초기언락 0, 해당 그룹의 클리프 + 선형해제 조건 상속
• 몇 단계의 전송을 거치든 베스팅 조건이 유지됨 (A → B → C → D)
• 발신자의 해당 스케줄 잔액에서 차감, 수신자에게 새 스케줄 생성

vestingTransferByAdmin(group, from, to, amount, scheduleIndex)

B. 그룹지갑 언락 토큰 전송 — groupWalletTransferByAdmin()

그룹 지갑의 자유잔액(언락된 토큰)을 다른 지갑으로 전송합니다.

• 자유잔액만 전송 가능 (InsufficientAvailableBalance)
• 받는 지갑에 베스팅 조건 없음 — 자유 토큰으로 수령
• 그룹 지갑의 transfer() 차단을 우회하여 Admin이 대신 실행

groupWalletTransferByAdmin(group, to, amount)

C. 초기 배분 — distributeToGroupByAdmin()

Deployer에서 그룹 지갑으로 최초 토큰을 배분합니다. 그룹당 1회만 실행 가능합니다.

• 그룹 설정(setGroupConfigByAdmin)과 TGE 설정 이후에만 실행 가능
• 배분 수량은 해당 그룹의 totalAllocation 이내
• 그룹 지갑에 베스팅 스케줄 생성 (초기언락 적용)
• 이미 배분된 그룹에 재배분 시도 시 GroupAlreadyDistributed

distributeToGroupByAdmin(group, from, amount)

Case 1 — EOA가 Admin Role을 보유한 경우

단일 개인키로 서명하여 즉시 실행됩니다.

• msg.sender = Admin EOA 주소
• 트랜잭션 서명 즉시 체인에 전파 → 블록 포함 시 실행 완료
• 단일 키 유출 시 무단 실행 위험이 있어, 운영 환경에서는 Safe{Wallet} 사용을 권장

Case 2 — Safe{Wallet}이 Admin Role을 보유한 경우

Safe{Wallet}(Gnosis Safe)은 멀티시그 지갑으로, Role은 Safe 컨트랙트 주소에 부여됩니다. 실제 트랜잭션 제안은 Safe에 등록된 Delegate 또는 Signer(서명자)가 수행하며, 설정된 임계값(Threshold) 이상의 서명이 모여야 온체인에서 실행됩니다.

방법 A — 단일 그룹에서 1회 전송

VC 스케줄(300만)에서 250만을 한 번에 전송합니다.

// Admin 실행
vestingTransferByAdmin(VC, walletA, walletB, 2,500,000, 2)

// 또는 사용자(A) 직접 실행
vestingTransferBySender(VC, walletB, 2,500,000, 2)

지갑(B)는 VC 그룹의 베스팅 조건을 상속받으며, 초기언락(Initial Unlock)은 0입니다.

방법 B — 복수 그룹에서 분할 전송

TeamAdvisor(100만) + Partnership(150만) = 250만을 2회에 나누어 전송합니다.

// 1차: TeamAdvisor 전량
vestingTransferBySender(TeamAdvisor, walletB, 1,000,000, 0)

// 2차: Partnership 일부
vestingTransferBySender(Partnership, walletB, 1,500,000, 1)

지갑(B)에 2개의 독립된 베스팅 스케줄이 생성되며, 각 스케줄은 해당 그룹의 조건을 독립적으로 따릅니다.