Wallets
Wallet and web3

Custodial delete requires { address, pin } (6 digits) in the same request. External links need only { address }. Clerk lastActiveAt is not a gate. Last wallet may be deleted. Wrong PIN is 400 INVALID_PIN; missing PIN is 400 VALIDATION_ERROR. Optional ack: { timestamp, walletAddress, binderCount?, cardCount?, unopenedPackCount?, openedPackCount?, countsUnknown?, copyVersion } records the delete confirmation (#928): binders keep the removed address (hidden from wallet-scoped lists until the address is linked again) and the ack is stored durably. All four stored counts are server-computed truth; the client numbers (null/omitted when unknown) are stored in the corresponding shown* fields. If any shown numeric count is below current truth, deletion returns 409 WALLET_DELETE_ACK_REQUIRED with the current counts so the fan can review again. countsUnknown: true cannot accompany any numeric count. Malformed ack is 400 VALIDATION_ERROR; an ack naming another wallet is rejected.

delete/api/wallets

Request

  • Base URL
    https://app.d-sports.org
  • Auth
    HTTP bearer

Request body

addressstring required

0x-prefixed 40-hex Ethereum address

pinstring

Required for CUSTODIAL wallets. Omit for EXTERNAL links.

Response

{ message, wallets } — wallets is the remaining list sorted by sortOrder (compacted 0..n-1)

Changes