Every ZBD project comes with its own programmable Bitcoin Lightning wallet. This isolated wallet gives you complete control over your project’s funds, transactions, and financial operations – all accessible via API.

Core Architecture: 1 Project = 1 Wallet = 1 API Key. This separation ensures clean accounting, isolated risk, and granular control.

​
How Project Wallets Work

Isolated Funds

Each project has its own Bitcoin balance, completely separate from other projects

API Controlled

Every transaction through your API key affects only this wallet

Real-time Updates

Balance changes instantly with Lightning-speed settlements

​
Wallet Architecture

​
Wallet Dashboard

Navigate to your project’s Wallet tab to access comprehensive financial data:

Project wallet dashboard showing balance and transactions

​
Wallet Management Best Practices

​
Common Wallet Operations

​
Check Balance

const wallet = await zbd.getWallet();
console.log(`Balance: ${wallet.balance} sats`);
console.log(`USD Value: $${wallet.balanceUSD}`);

​
Transfer Between Projects

// Transfer funds between your projects
const result = await zbd.internalTransfer({
  amount: 10000,
  receiverWalletId: 'project_abc123',
  reference: 'Budget reallocation'
});

​
Next Steps

Send First Payment

Make your first Lightning payment

Set Up Webhooks

Monitor transaction updates in real-time

Pro Tip: Use project wallets to isolate financial risk. If one project has issues, your other projects remain unaffected. This is especially important for testing new features or running experiments.