Deregister a wallet

Documentation Index

Fetch the complete documentation index at: https://docs.prudra.dev/llms.txt

Use this file to discover all available pages before exploring further.

​

Deregister a wallet

import { initialise } from '@prudra/core';
import { deregisterBYOWallet } from '@prudra/wallet';

initialise({ apiKey: process.env.PRUDRA_API_KEY! });

await deregisterBYOWallet({ walletId: 'byw_clx1abc123' });

console.log('Wallet deregistered — monitoring stopped');

curl -X DELETE https://api.prudra.dev/wallet-infra/byo-wallets/byw_clx1abc123 \
  -H "Authorization: Bearer prv_test_sk_..."

{
  "id":          "byw_clx1abc123",
  "status":      "deregistered",
  "deregisteredAt": "2026-04-30T09:00:00.000Z"
}

​

What deregistering does

1. Address monitoring is stopped immediately
2. No further deposit.success webhooks fire for this address
3. The wallet slot is freed — you can register a new wallet on your plan
4. Existing WalletTransaction and WalletBalance records are retained (read-only)
5. The wallet ID becomes invalid for use in walletMiddleware

​

What deregistering does NOT do

• It does not move, freeze, or affect funds in the wallet
• It does not delete historical transaction records
• It does not affect payments already processed through this wallet

​

Before deregistering

// Remove or update before deregistering
app.use(walletMiddleware({ walletId: 'byw_clx1abc123' }));  // ← update this

​

Error handling

​

Related

• Register a BYO wallet — register a new wallet after freeing a slot
• Monitor deposits — how deposit monitoring worked
• Plan limits — slot counts by plan