EIP-712 서명

import { ethers, Signer } from 'ethers';

/**
 * USDC transferWithAuthorization을 위한 EIP-712 서명을 생성합니다.
 * 이 서명은 가스비 없이 USDC를 전송할 수 있게 해줍니다.
 *
 * @param signer - ethers.js v6 Signer 인스턴스
 * @param to - 받는 사람 지갑 주소
 * @param amount - 전송할 금액 (6 decimals, "10000" = $0.01)
 * @param usdcAddress - 해당 체인의 USDC 컨트랙트 주소
 * @param chainId - 블록체인 네트워크 ID (Base Sepolia: 84532)
 */
async function signTransferWithAuthorization(
  signer: Signer,
  to: string,
  amount: string,
  usdcAddress: string,
  chainId: number
) {
  // ========================================
  // 1단계: Domain Separator 정의
  // ========================================
  // 서명이 USDC 컨트랙트용임을 증명합니다.
  // 이 값들은 USDC 컨트랙트에 하드코딩된 값과 일치해야 합니다.
  const domain = {
    name: "USD Coin",          // USDC v2 컨트랙트의 공식 이름
    version: "2",              // USDC 컨트랙트 버전
    chainId: chainId,          // 체인 ID (다른 체인 서명 재사용 방지)
    verifyingContract: usdcAddress  // USDC 컨트랙트 주소
  };

  // ========================================
  // 2단계: Type 정의
  // ========================================
  // USDC 컨트랙트의 transferWithAuthorization 함수가
  // 기대하는 정확한 파라미터 구조입니다.
  const types = {
    TransferWithAuthorization: [
      { name: "from", type: "address" },        // 보내는 사람
      { name: "to", type: "address" },          // 받는 사람
      { name: "value", type: "uint256" },       // 금액
      { name: "validAfter", type: "uint256" },  // 유효 시작
      { name: "validBefore", type: "uint256" }, // 유효 종료
      { name: "nonce", type: "bytes32" }        // 고유 ID
    ]
  };

  // ========================================
  // 3단계: 보안 파라미터 생성
  // ========================================
  // nonce: 32바이트 랜덤 값으로 replay attack 방지
  // ethers v6에서는 ethers.randomBytes() 사용
  const nonce = ethers.hexlify(ethers.randomBytes(32));

  // validBefore: 현재 시간 + 60초
  // 서명이 1분 후 만료되어 도용 위험 최소화
  const validBefore = Math.floor(Date.now() / 1000) + 60;

  // ========================================
  // 4단계: 메시지 구성
  // ========================================
  const signerAddress = await signer.getAddress();
  const message = {
    from: signerAddress,     // 서명자 = 토큰 보내는 사람
    to: to,                  // 파라미터로 받은 수신자
    value: amount,           // 파라미터로 받은 금액
    validAfter: 0,           // 즉시 유효 (시작 제한 없음)
    validBefore: validBefore,// 1분 후 만료
    nonce: nonce             // 랜덤 생성된 고유 ID
  };

  // ========================================
  // 5단계: EIP-712 서명 생성
  // ========================================
  // ethers v6에서는 signer.signTypedData() 사용
  // domain + types + message를 해시하고 서명합니다.
  // 결과: 65바이트 서명 (v, r, s 포함)
  const signature = await signer.signTypedData(domain, types, message);

  // 서명과 메시지 데이터를 함께 반환
  // 서버/퍼실리테이터가 이 정보로 온체인 트랜잭션 실행
  return {
    signature,           // 65바이트 서명 문자열
    authorization: message  // 서명된 메시지 (검증용)
  };
}