Dapp Wallet Integration

Two steps:

1. Connect popup to obtain the user address

2. Sign popup to review/PIN/broadcast and get txHash

---

1) Install

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

2) Connect — get address

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)
}

Errors (Connect): USER_REJECTED, TIMEOUT, ENV_NOT_BROWSER

---

3) Sign — review/PIN/send

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(txHash)
}

Errors (Sign): USER_REJECTED, TIMEOUT, SUBMIT_FAILED, MALFORMED_TX, ENV_NOT_BROWSER

---

4) User flow

Connect – Address approval

Sign – Review

Sign – PIN

After broadcast, the wallet returns { txHash, state } and closes the popup.

---

5) Result handling

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('Cancelled'); break
    case 'TIMEOUT':       toast.warn('Timed out'); break
    case 'SUBMIT_FAILED': toast.error('Broadcast failed'); break
    case 'MALFORMED_TX':  toast.error('Bad TX'); break
    default:              toast.error('Unknown error')
  }
}

6) Checklist

• Call popups inside click handlers

• Cross‑origin dev only: devAllowAnyOrigin: true (never in production)

• Use state as an idempotency key