지갑 연동

연동은 두 단계입니다.

1. Connect 팝업으로 사용자 지갑 주소를 획득

2. Sign 팝업으로 검토/서명/전송 후 txHash 수신

---

1) 설치

npm i @newblet/sign-sdk
# or: pnpm add @newblet/sign-sdk / yarn add @newblet/sign-sdk

2) Connect — 주소 공유

사용자 클릭 이벤트 핸들러 내부에서 호출하세요.

import { openNewbletConnectPopup } from '@newblet/sign-sdk'

async function onConnect(){
  const { address } = await openNewbletConnectPopup({
    walletUrl: 'https://newblet.com',   // `${walletUrl}/connect`
    state: `connect-${Date.now()}`
  })
  console.log('address:', address)
}

Connect 오류 코드: USER_REJECTED, TIMEOUT, ENV_NOT_BROWSER

---

3) Sign — 검토/서명/전송

import { openNewbletSignPopup } from '@newblet/sign-sdk'

async function onPay(){
  const { txHash } = await openNewbletSignPopup(
    { chain_id: 56, to: '0xB0...8D06', value: '10000000000000000' },
    { walletUrl: 'https://newblet.com', state: 'order#123' }
  )
  console.log('tx:', txHash)
}

Sign 오류 코드: USER_REJECTED, TIMEOUT, SUBMIT_FAILED, MALFORMED_TX, ENV_NOT_BROWSER

---

4) 사용자 플로우

Connect – 주소 공유 승인

Sign – 트랜잭션 검토

Sign – PIN 확인

전송이 완료되면 부모 창으로 { txHash, state } 를 전달하고 팝업이 닫힙니다.

---

5) 결과 처리 패턴

try {
  const res = await openNewbletSignPopup(params, { walletUrl, state: orderId })
  await pollUntilConfirmed(res.txHash)
  completeOrder(res.state ?? orderId, res.txHash)
} catch (e: any) {
  switch (e.code) {
    case 'USER_REJECTED': toast.info('사용자 취소'); break
    case 'TIMEOUT':       toast.warn('지연 발생'); break
    case 'SUBMIT_FAILED': toast.error('전송 실패'); break
    case 'MALFORMED_TX':  toast.error('TX 파라미터 확인'); break
    default:              toast.error('알 수 없는 오류')
  }
}

6) 체크리스트

• 팝업은 사용자 클릭 핸들러 내부에서 호출

• 로컬 개발 중 교차 오리진 테스트: devAllowAnyOrigin: true(운영 금지)

• 서버 동기화: state를 멱등 키로 사용