🚀 Cryptoments Widget SDK V2.0.0

<!-- V2 SDK (현재 배포 경로) -->
<script src="https://widget.cryptoments.net/src/v2/widget.cryptoments.sdk.js"></script>

<!-- 또는 압축 버전 -->
<script src="https://widget.cryptoments.net/src/v2/widget.cryptoments.sdk.min.js"></script>

import { CryptoPaymentsWidget } from './v2/widget.cryptoments.sdk.js';
// 또는
import CryptoPaymentsWidget from './v2/widget.cryptoments.sdk.js';

// 1. SDK 생성
const widget = new CryptoPaymentsWidget({
  apiBaseUrl: 'https://api.cryptoments.net',
  widgetBaseUrl: 'https://widget.cryptoments.net',
  partnerApiUrl: '/api/get-widget-token',
  mode: 'modal',
});

// 2. 초기화 (Axim 정보 자동 로드)
await widget.initialize('user-12345');

// 3. Axim 활성화 확인
if (widget.isAximEnabled()) {
  console.log('✅ Axim Pay 사용 가능');
  console.log('Axim 정보:', widget.getAximInfo());
  console.log('연결 상태:', widget.getAximConnectionStatus());
}

// 4. 입금 위젯 열기
await widget.openDeposit('user-12345', {
  presetAmount: 10
});

// 5. 출금 위젯 열기
await widget.openWithdrawal('user-12345', {
  maxAmount: 100000, //사용자 잔액
  //필수
  reqWithdraw: async (data) => {
    // 출금 처리
    const response = await fetch('/api/withdraw', {
      method: 'POST',
      body: JSON.stringify(data)
    });
    return response.ok;
  }
});

<script src="https://widget.cryptoments.net/src/v2/widget.cryptoments.sdk.js"></script>

<script>
  // 전역 객체 사용
  const widget = new window.CryptomentsWidget({
    apiBaseUrl: 'https://api.cryptoments.net',
    mode: 'modal'
  });

  // 버전 확인
  console.log('SDK Version:', window.CryptomentsWidget.version); // "v2.0.0"
</script>

// 1. KRW 환율 고정시
await widget.openDeposit('user-12345', {
  fixedRateKrw: 1500
});
await widget.openWithdrawal('user-12345', {
    fixedRateKrw: 1500,

    maxAmount: 100000, //사용자 잔액
    reqWithdraw: async (data) => { //필수
        // 출금 처리
        const response = await fetch('/api/withdraw', {
        method: 'POST',
        body: JSON.stringify(data)
        });
        return response.ok;
    }
});


// 2. 고정값 입금/출금시  
await widget.openDeposit('user-12345', {
    skipInput:true,
    presetAmount:100,//필수
    currencyType:'USDT',//필수
    chainType:'TRON'//선택 (미설정시 사용자가 직접 변경 가능)
});
await widget.openWithdrawal('user-12345', {
    skipInput:true,
    presetAmount:100,//필수
    currencyType:'USDT',//필수
    chainType:'TRON'//선택 (미설정시 사용자가 직접 변경 가능)

    maxAmount: 100000, //사용자 잔액
    reqWithdraw: async (data) => { //필수
        // 출금 처리
        const response = await fetch('/api/withdraw', {
        method: 'POST',
        body: JSON.stringify(data)
        });
        return response.ok;
    }
});

// 3. 금액 입력만 고정
await widget.openDeposit('user-12345', {
    presetAmount:100,
    allowAmountEdit:false
});
await widget.openWithdrawal('user-12345', {
    presetAmount:100,
    allowAmountEdit:false

    maxAmount: 100000, //사용자 잔액
    reqWithdraw: async (data) => { //필수
        // 출금 처리
        const response = await fetch('/api/withdraw', {
        method: 'POST',
        body: JSON.stringify(data)
        });
        return response.ok;
    }
});

// V2는 초기화 시 자동으로 Axim 정보를 로드합니다
await widget.initialize('user-12345');

// 초기화 후 Axim 정보 확인
console.log('Axim 활성화:', widget.isAximEnabled());
console.log('Axim 정보:', widget.getAximInfo());
console.log('연결 상태:', widget.getAximConnectionStatus());

// 기본 입금
await widget.openDeposit('user-12345');

// 옵션 지정
await widget.openDeposit('user-12345', {
  chainType: 'BSC',
  currencyType: 'USDT',
  presetAmount: 100000
});

await widget.openWithdrawal('user-12345', {
  minAmount: 10,
  maxAmount: 100000,
  showBalance: true,
  
  // 필수: 출금 요청 처리 함수
  reqWithdraw: async (withdrawalData) => {
    console.log('출금 요청:', withdrawalData);
    
    // 파트너 서버에 출금 요청
    const response = await fetch('/api/withdraw', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(withdrawalData)
    });
    
    return response.ok; // 성공 시 true 반환
  },
  
  // 선택: 성공 콜백
  onSuccess: (result) => {
    console.log('출금 성공:', result);
  },
  
  // 선택: 에러 콜백
  onError: (error) => {
    console.error('출금 실패:', error);
  }
});

// Axim 활성화 여부
const enabled = widget.isAximEnabled();

// Axim 정보 조회
const info = widget.getAximInfo();
// { siteId: '12345', connectId: '1_user123', ... }

// Axim 연결 상태 조회 (캐시)
const status = widget.getAximConnectionStatus();

// Axim 연결 상태 확인 (API 호출)
const latestStatus = await widget.checkAximConnectionStatus();

// Axim 정보 새로고침
await widget.refreshAximInfo();

// SDK 버전 확인
const version = widget.getVersion(); // "v2.0.0"

// 디버그 정보
const debugInfo = widget.getDebugInfo();
widget.printDebugInfo(); // 콘솔 출력

// Axim 활성화 이벤트
widget.addEventListener('aximEnabled', (event) => {
  console.log('✅ Axim Pay 활성화:', event.data);
  // UI에 Axim Pay 옵션 표시
  showAximPayOption();
});

// Axim 연결 성공 이벤트
widget.addEventListener('aximConnectionSuccess', (event) => {
  console.log('🎉 Axim 지갑 연결 성공:', event.data);
  // 연결 정보 저장
  saveAximConnection({
    connectId: event.data.connectId,
    walletAddress: event.data.walletAddress
  });
  // UI 업데이트
  showConnectedWallet(event.data.walletAddress);
});

// Axim 결제 성공 이벤트
widget.addEventListener('aximPaymentSuccess', (event) => {
  console.log('💰 Axim 결제 완료:', event.data);
  // 결제 정보 저장
  savePayment({
    txHash: event.data.txHash,
    amount: event.data.amount,
    currency: event.data.currency
  });
  // 성공 페이지로 이동
  location.href = `/success?tx=${event.data.txHash}`;
});

// 개별 이벤트 리스너
widget.addEventListener('aximPaymentSuccess', (event) => {
  console.log('결제 완료:', event.data);
});

// 여러 이벤트 일괄 등록
const listenerIds = widget.addEventListeners({
  aximConnectionSuccess: (event) => {
    console.log('연결 성공:', event.data);
  },
  aximPaymentSuccess: (event) => {
    console.log('결제 성공:', event.data);
  },
  error: (event) => {
    console.error('에러:', event.data);
  }
});

// 이벤트 리스너 제거
widget.removeEventListener('aximPaymentSuccess', listenerId);

// 모든 이벤트 리스너 제거
widget.removeAllEventListeners();

// Node.js/Express 예시
app.post('/api/get-widget-token', async (req, res) => {
  const { partnerUserId, permissions } = req.body;
  
  // 1. 서명 생성
  const timestamp = Math.floor(Date.now() / 1000);
  const method = 'POST';
  const path = '/widgets/auth/token';
  const message = method + path + timestamp;
  const signature = crypto
    .createHmac('sha256', PARTNER_API_SECRET)
    .update(message)
    .digest('hex');
  
  // 2. Widget API 호출
  const response = await fetch('https://api.cryptoments.net/widgets/auth/token', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-KEY': PARTNER_API_KEY,
      'X-TIMESTAMP': timestamp,
      'X-SIGNATURE': signature
    },
    body: JSON.stringify({
      partnerUserId,
      permissions
    })
  });
  
  const data = await response.json();
  res.json({ accessToken: data.accessToken });
});

// reqWithdraw 함수 구현 예시
async function handleWithdraw(withdrawalData) {
  try {
    // 1. 사용자 검증
    const user = await getUserById(withdrawalData.userId);
    if (!user) {
      throw new Error('사용자를 찾을 수 없습니다');
    }
    
    // 2. 잔액 확인
    const balance = await getUserBalance(user.id, withdrawalData.currencyType);
    if (balance < withdrawalData.amountCrypto) {
      throw new Error('잔액이 부족합니다');
    }
    
    // 3. 출금 요청 저장
    const withdrawal = await createWithdrawalRequest({
      userId: user.id,
      chainType: withdrawalData.chainType,
      currencyType: withdrawalData.currencyType,
      toAddress: withdrawalData.toAddress,
      amount: withdrawalData.amountCrypto,
      status: 'PENDING'
    });
    
    // 4. 성공 응답
    return true;
    
  } catch (error) {
    console.error('출금 처리 실패:', error);
    return false;
  }
}

// 디버그 모드 활성화
const widget = new CryptoPaymentsWidget({
  debug: true
});

// 디버그 정보 출력
widget.printDebugInfo();

// 이벤트 히스토리 확인
const history = widget.getEventHistory();
console.log('이벤트 히스토리:', history);

// 이벤트 통계
const stats = widget.getEventStats();
console.log('이벤트 통계:', stats);

# 1. 다운로드한 파일 압축 해제
unzip widget-demo-v2.zip

# 2. Demo Project 실행
cd widget-demo
npm install
npm start

# 3. 브라우저에서 V2 예시 테스트
http://localhost:3001/v2-examples

# 또는 V1 예시
http://localhost:3001/usage-examples

widget-demo/
├── server.js                # Express 파트너 서버
├── usage-examples.html      # V1 SDK 사용 예시
├── v2-examples.html      # V2 SDK 사용 예시
└── package.json             # 의존성