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.
Track transfer status
Direct and swap transfers confirm synchronously — the transfer() call returns with status: 'confirmed'. Bridge transfers start as pending and require tracking.
Polling transfer status
import { initialise } from '@prudra/core';
import { getTransaction } from '@prudra/wallet';
initialise({ apiKey: process.env.PRUDRA_API_KEY! });
const tx = await getTransaction({ transactionId: 'wtx_clx1abc123' });
console.log(tx.status); // 'pending' | 'confirmed' | 'failed'
console.log(tx.confirmedAt); // null while pending
curl https://api.prudra.dev/wallet-infra/wallets/mwt_clx1abc123/transactions/wtx_clx1abc123 \
-H "Authorization: Bearer prv_test_sk_..."
Webhook-based tracking
Webhooks are more efficient than polling for bridge transfers. Register once and receive status updates automatically:
Register webhook
Handle webhook
curl -X POST https://api.prudra.dev/webhooks \
-H "Authorization: Bearer prv_test_sk_..." \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-server.com/webhooks/prudra",
"events": ["transfer.completed", "transfer.failed"]
}'
import { verifyWebhook } from '@prudra/webhooks';
app.post('/webhooks/prudra', express.raw({ type: '*/*' }), (req, res) => {
res.sendStatus(200);
const isValid = verifyWebhook({
payload: req.body as Buffer,
signature: req.headers['x-prudra-signature'] as string,
timestamp: req.headers['x-prudra-timestamp'] as string,
secret: process.env.PRUDRA_WEBHOOK_SECRET!,
});
if (!isValid) return;
const event = JSON.parse((req.body as Buffer).toString());
if (event.type === 'transfer.completed') {
const { transactionId, toChain, confirmedAt } = event.payload;
console.log(`Transfer ${transactionId} confirmed on ${toChain} at ${confirmedAt}`);
// Update your database, notify your users, etc.
}
if (event.type === 'transfer.failed') {
const { transactionId, reason, refundTxHash } = event.payload;
console.log(`Transfer ${transactionId} failed: ${reason}`);
console.log(`Funds returned: ${refundTxHash}`);
}
});
Status values
| Status | Description | Next state |
|---|
pending | Bridge initiated, awaiting destination confirmation | confirmed or failed |
confirmed | Destination chain confirmed, tokens received | Terminal |
failed | Bridge failed, funds refunded to source wallet | Terminal |
pending entirely — they return confirmed immediately.
List all transfers
import { listTransactions } from '@prudra/wallet';
const txs = await listTransactions({
walletId: 'mwt_clx1abc123',
direction: 'outbound',
});
for (const tx of txs) {
console.log(`${tx.id} ${tx.route} ${tx.status} ${tx.amount} ${tx.fromToken}`);
}
