Register a BYO wallet

Registering a BYO wallet tells Prudra to monitor an existing EVM address for incoming deposits. You provide the address, chain, and which tokens to monitor. Prudra sets up address activity monitoring and returns a wallet object you can use in walletMiddleware.

Dashboard
SDK
cURL

Dashboard support for BYO wallet registration is coming soon. Use the SDK or cURL to register wallets.

import { initialise, Chain, Token } from '@prudra/core';
import { registerBYOWallet } from '@prudra/wallet';

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

const wallet = await registerBYOWallet({
  address:         '0x742d35Cc...',
  chain:           Chain.BASE,
  supportedTokens: [Token.USDC],
  name:            'Operations wallet',
});

console.log(wallet.id);      // byw_clx1abc123
console.log(wallet.status);  // 'pending' → 'active' after AML screening
console.log(wallet.address); // '0x742d35Cc...'

curl -X POST https://api.prudra.dev/wallet-infra/byo-wallets \
  -H "Authorization: Bearer prv_test_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0x742d35Cc...",
    "chain": "base",
    "supportedTokens": ["USDC"],
    "name": "Operations wallet"
  }'

Response:

{
  "id":              "byw_clx1abc123",
  "address":         "0x742d35Cc...",
  "chain":           "base",
  "chainId":         8453,
  "supportedTokens": ["USDC"],
  "name":            "Operations wallet",
  "status":          "pending",
  "createdAt":       "2026-04-30T09:00:00.000Z"
}

Parameters

Parameter	Type	Required	Description
`address`	string	Yes	The EVM wallet address to monitor (checksummed or lowercase)
`chain`	Chain	Yes	The chain this address lives on
`supportedTokens`	Token[]	Yes	Tokens to monitor for incoming deposits
`name`	string	No	Human-readable label for this wallet

Registration status

After registration, the wallet status is "pending" while AML screening runs. Status values:

Status	Meaning
`pending`	AML screening in progress. Monitoring not yet active.
`active`	Screening passed. Address is being monitored for deposits.
`rejected`	Address flagged during AML screening. Cannot be used.

Check the status by fetching the wallet:

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

What happens after registration

AML screening completes (typically within seconds)
If passed, Prudra registers the address with its blockchain monitoring service
The wallet status changes to active
Any incoming transfers to the address are detected and a deposit.success webhook fires
A WalletTransaction record is created for each deposit

Use the wallet in payMiddleware

Once status === 'active', use the wallet ID in walletMiddleware:

app.use(walletMiddleware({ walletId: 'byw_clx1abc123' }));

Payments made to your Prudra-protected endpoints will settle to this wallet address.

Error handling

Error	Status	Cause	Resolution
`byo-wallet-limit-reached`	429	Plan limit exceeded	Upgrade plan or deregister an existing wallet
`wallet-already-registered`	409	Address already registered	Check your existing wallets with GET /wallet-infra/byo-wallets
`address-format-invalid`	422	Not a valid EVM address	Use a checksummed or lowercase EVM address

Next steps

Monitor deposits — how deposit detection and deposit.success work
Supported chains and tokens — which chains and tokens are available
Accept a payment — use this wallet in the payment middleware chain

Get Started

Payments

Wallets

Storage

Webhooks

Discovery

Platform

Register a BYO wallet