⚡ Quickstart Tutorial

What You'll Build

A complete BRDZ SDK application with authentication, wallet management, and basic transactions. Perfect for understanding core concepts and getting started quickly.

Prerequisites

Node.js 16+ installed
Basic JavaScript/TypeScript knowledge
API Key configured
Code editor (VS Code recommended)

Step 1: Project Setup

Create New Project

# Create project directory
mkdir my-brdz-app
cd my-brdz-app

# Initialize Node.js project
npm init -y

# Install BRDZ SDK
npm install anantla_sdk

# Install additional dependencies
npm install dotenv

Environment Configuration

Create .env file:

.env
# BRDZ SDK Configuration
BRDZ_API_BASE=https://api.brdz.link/api
BRDZ_API_KEY=your_api_key_here

# Replace with your actual API key from setup guide

Basic Project Structure

my-brdz-app/
├── src/
│   ├── index.js
│   ├── auth.js
│   ├── wallet.js
│   └── utils.js
├── .env
├── package.json
└── README.md

Step 2: SDK Initialization

Create src/utils.js:

// src/utils.js
require('dotenv').config();
const brdzSDK = require('anantla_sdk');

class BRDZManager {
  constructor() {
    this.initialized = false;
    this.currentUser = null;
  }

  async init() {
    try {
      console.log('🔄 Initializing BRDZ SDK...');
      
      // Configure SDK
      const config = brdzSDK.config;
      config.setBaseUrl(process.env.BRDZ_API_BASE);
      config.setApiKey(process.env.BRDZ_API_KEY);

      // Check if user token exists (for returning users)
      if (process.env.BRDZ_USER_TOKEN) {
        config.setToken(process.env.BRDZ_USER_TOKEN);
      }

      // Validate setup
      const utils = brdzSDK.utils;
      const isValid = utils.validateSDKSetup();
      
      if (isValid) {
        this.initialized = true;
        console.log('✅ BRDZ SDK initialized successfully');
      } else {
        throw new Error('SDK validation failed');
      }

    } catch (error) {
      console.error('❌ SDK initialization failed:', error.message);
      throw error;
    }
  }

  isReady() {
    return this.initialized;
  }

  setCurrentUser(user) {
    this.currentUser = user;
  }

  getCurrentUser() {
    return this.currentUser;
  }
}

module.exports = { BRDZManager, brdzSDK };

Step 3: Authentication Implementation

Create src/auth.js:

// src/auth.js
const { brdzSDK } = require('./utils');

class AuthManager {
  constructor(brdzManager) {
    this.brdz = brdzManager;
    this.auth = brdzSDK.auth;
    this.twofa = brdzSDK.twofa;
  }

  async register(userData) {
    if (!this.brdz.isReady()) {
      throw new Error('BRDZ SDK not initialized');
    }

    try {
      console.log('📝 Registering new user...');
      
      const result = await this.auth.registerUser(userData);
      console.log('✅ Registration successful:', result.user?.username);
      
      return result;
    } catch (error) {
      console.error('❌ Registration failed:', error.message);
      throw error;
    }
  }

  async login(email, password) {
    try {
      console.log('🔐 Logging in user...');
      
      const result = await this.auth.loginUser(email, password);
      
      if (result.requires_2fa) {
        console.log('🔒 2FA required for this account');
        return {
          success: false,
          requires_2fa: true,
          user_id: result.user_id
        };
      }

      // Save token and update SDK config
      const config = brdzSDK.config;
      config.setToken(result.token);
      
      this.brdz.setCurrentUser(result.user);
      
      console.log('✅ Login successful:', result.user?.username);
      return result;
      
    } catch (error) {
      console.error('❌ Login failed:', error.message);
      throw error;
    }
  }

  async loginWith2FA(userId, code) {
    try {
      console.log('🔐 Completing 2FA login...');
      
      const result = await this.auth.completeLoginWith2FA(userId, code);
      
      // Save token and update SDK config
      const config = brdzSDK.config;
      config.setToken(result.token);
      
      this.brdz.setCurrentUser(result.user);
      
      console.log('✅ 2FA login successful');
      return result;
      
    } catch (error) {
      console.error('❌ 2FA login failed:', error.message);
      throw error;
    }
  }

  async getUserProfile(userId) {
    try {
      const profile = await this.auth.getUserProfile(userId);
      console.log('👤 User profile retrieved:', profile.username);
      return profile;
    } catch (error) {
      console.error('❌ Failed to get profile:', error.message);
      throw error;
    }
  }
}

module.exports = { AuthManager };

Step 4: Wallet Management

Create src/wallet.js:

// src/wallet.js
const { brdzSDK } = require('./utils');

class WalletManager {
  constructor(brdzManager) {
    this.brdz = brdzManager;
    this.cryptoWallet = brdzSDK.cryptoWallet;
    this.onchain = brdzSDK.onchain;
  }

  async createWallet(walletName, userId) {
    try {
      console.log('💼 Creating new wallet...');
      
      const wallet = await this.cryptoWallet.createWallet({
        wallet_name: walletName,
        user_id: userId
      });
      
      console.log('✅ Wallet created:', wallet.wallet_name);
      return wallet;
    } catch (error) {
      console.error('❌ Wallet creation failed:', error.message);
      throw error;
    }
  }

  async getUserWallets(userId) {
    try {
      console.log('📂 Getting user wallets...');
      
      const wallets = await this.cryptoWallet.getUserWallets(userId);
      console.log(`✅ Found ${wallets.length} wallets`);
      
      return wallets;
    } catch (error) {
      console.error('❌ Failed to get wallets:', error.message);
      throw error;
    }
  }

  async addChainToWallet(walletId, chainId) {
    try {
      console.log(`⛓️ Adding ${chainId} chain to wallet...`);
      
      const result = await this.cryptoWallet.addChainAddress(walletId, {
        chain_id: chainId
      });
      
      console.log('✅ Chain added successfully');
      return result;
    } catch (error) {
      console.error('❌ Failed to add chain:', error.message);
      throw error;
    }
  }

  async getWalletBalance(walletId, chainId) {
    try {
      console.log('💰 Checking wallet balance...');
      
      const balance = await this.cryptoWallet.balance.getChain(walletId, chainId);
      console.log(`✅ Balance retrieved for ${chainId}`);
      
      return balance;
    } catch (error) {
      console.error('❌ Failed to get balance:', error.message);
      throw error;
    }
  }

  async getTransactionHistory(userId) {
    try {
      console.log('📊 Getting transaction history...');
      
      const history = await this.onchain.getTransactionHistory(userId, {
        limit: 10
      });
      
      console.log(`✅ Retrieved ${history.data?.length || 0} transactions`);
      return history;
    } catch (error) {
      console.error('❌ Failed to get transaction history:', error.message);
      throw error;
    }
  }

  // AI-powered wallet operations
  async aiWalletOperation(userInput, userId) {
    try {
      console.log('🤖 Processing AI wallet request...');
      
      const result = await this.cryptoWallet.processAIIntent({
        user_input: userInput,
        user_id: userId
      });
      
      console.log('✅ AI operation completed');
      return result;
    } catch (error) {
      console.error('❌ AI operation failed:', error.message);
      throw error;
    }
  }
}

module.exports = { WalletManager };

Step 5: Main Application

Create src/index.js:

// src/index.js
const { BRDZManager } = require('./utils');
const { AuthManager } = require('./auth');
const { WalletManager } = require('./wallet');

class MyBRDZApp {
  constructor() {
    this.brdz = new BRDZManager();
    this.auth = null;
    this.wallet = null;
    this.currentUser = null;
  }

  async initialize() {
    try {
      console.log('🚀 Starting BRDZ Application...');
      
      // Initialize SDK
      await this.brdz.init();
      
      // Initialize managers
      this.auth = new AuthManager(this.brdz);
      this.wallet = new WalletManager(this.brdz);
      
      console.log('✅ Application initialized successfully\n');
      
    } catch (error) {
      console.error('❌ Application initialization failed:', error.message);
      process.exit(1);
    }
  }

  async runDemo() {
    try {
      console.log('='.repeat(50));
      console.log('🎯 BRDZ SDK Demo Application');
      console.log('='.repeat(50));

      // Demo 1: User Registration
      console.log('\n📝 Demo 1: User Registration');
      const userData = {
        email: 'demo@example.com',
        username: 'demouser',
        client_alias: 'Demo App',
        client_type: 'individual',
        country_code: 'ID',
        phone: '+628123456789'
      };

      try {
        const registerResult = await this.auth.register(userData);
        console.log('Registration demo completed');
      } catch (error) {
        if (error.message.includes('already exists')) {
          console.log('User already exists, continuing with login demo...');
        } else {
          throw error;
        }
      }

      // Demo 2: User Login
      console.log('\n🔐 Demo 2: User Login');
      try {
        const loginResult = await this.auth.login('demo@example.com', 'password123');
        
        if (loginResult.requires_2fa) {
          console.log('🔒 This account has 2FA enabled');
          console.log('In production, you would prompt user for 2FA code here');
        } else {
          this.currentUser = loginResult.user;
          console.log('Login demo completed');
        }
      } catch (error) {
        console.log('Login demo failed (expected if demo user not found)');
      }

      // Demo 3: Wallet Operations (requires authentication)
      if (this.currentUser) {
        console.log('\n💼 Demo 3: Wallet Operations');
        
        // Create wallet
        const wallet = await this.wallet.createWallet('Demo Wallet', this.currentUser.id);
        console.log('Wallet created:', wallet.wallet_name);
        
        // Get user wallets
        const wallets = await this.wallet.getUserWallets(this.currentUser.id);
        console.log('User wallets retrieved:', wallets.length);
        
        // Add chain support
        if (wallets.length > 0) {
          const walletId = wallets[0].bw_id;
          await this.wallet.addChainToWallet(walletId, 'sepolia');
        }

        // AI Wallet Demo
        console.log('\n🤖 Demo 4: AI Wallet Operations');
        const aiResult = await this.wallet.aiWalletOperation(
          'Show me my wallet balances',
          this.currentUser.id
        );
        console.log('AI Response:', aiResult.agent_response?.message);
      } else {
        console.log('\n⏭️  Skipping wallet demos (authentication required)');
      }

      console.log('\n🎉 Demo completed successfully!');
      console.log('Next steps: Explore more SDK modules and build your own features');

    } catch (error) {
      console.error('❌ Demo failed:', error.message);
    }
  }

  async run() {
    await this.initialize();
    await this.runDemo();
  }
}

// Run the application
const app = new MyBRDZApp();
app.run().catch(console.error);

Step 6: Test Your Application

Run the Demo

# Make sure you have your API key in .env file
node src/index.js

Expected Output

🚀 Starting BRDZ Application...
🔄 Initializing BRDZ SDK...
✅ BRDZ SDK initialized successfully
✅ Application initialized successfully

==================================================
🎯 BRDZ SDK Demo Application
==================================================

📝 Demo 1: User Registration
✅ Registration successful: demouser

🔐 Demo 2: User Login
✅ Login successful: demouser

💼 Demo 3: Wallet Operations
💼 Creating new wallet...
✅ Wallet created: Demo Wallet
📂 Getting user wallets...
✅ Found 1 wallets
⛓️ Adding sepolia chain to wallet...
✅ Chain added successfully

🤖 Demo 4: AI Wallet Operations
🤖 Processing AI wallet request...
✅ AI operation completed
AI Response: I can see your wallet information. You currently have 1 wallet...

🎉 Demo completed successfully!
Next steps: Explore more SDK modules and build your own features

Step 7: Explore More Features

Add Package Scripts

Update your package.json:

{
  "name": "my-brdz-app",
  "version": "1.0.0",
  "scripts": {
    "start": "node src/index.js",
    "demo": "node src/index.js",
    "test": "echo \"Run: npm run demo\""
  },
  "dependencies": {
    "anantla_sdk": "latest",
    "dotenv": "latest"
  }
}

Try Additional Modules

// Add to your app for more features

// AI Commerce (MCP)
const mcp = brdzSDK.mcp;
const productIntent = await mcp.step1_detectIntent({
  prompt: "I want to buy headphones from tokopedia"
});

// Cross-chain Operations
const crosschain = brdzSDK.crosschain;
const balance = await crosschain.getUSDCBalance('sepolia', 'your_wallet_address');

// Traditional Wallet
const wallet = brdzSDK.wallet;
const walletBalance = await wallet.getBalance();

// Foreign Exchange
const fx = brdzSDK.fx;
const rate = await fx.getRate('USD', 'IDR');

Common Issues & Solutions

Issue: API Key Missing

Error: API Key required. Call config.setApiKey() first

Solution: Make sure your .env file has BRDZ_API_KEY set correctly

Issue: Authentication Required

Error: Authentication required. Call auth.loginUser() first

Solution: Login with valid user credentials before accessing authenticated endpoints

Issue: Module Not Found

Error: Cannot find module 'anantla_sdk'

Solution: Install the SDK: npm install anantla_sdk

What You've Learned

✅ SDK Initialization: How to configure and initialize BRDZ SDK
✅ Authentication: User registration, login, and 2FA handling
✅ Wallet Management: Create wallets, add chains, check balances
✅ AI Integration: Use AI-powered wallet operations
✅ Error Handling: Proper error handling and validation
✅ Project Structure: Organized, maintainable code architecture

Next Steps

Now that you have a working BRDZ application:

✅ API Key Setup - Complete
✅ Authentication - Complete
✅ Quickstart Tutorial - Complete
React Integration - Build frontend components

Explore More Modules

Crypto Wallet (ABSK) - Advanced wallet features
AI Commerce (MCP) - AI-powered shopping
Cross-chain - Multi-blockchain operations
Two-Factor Auth - Enhanced security

Need Help?

If you encounter issues:

Email: contact@anantla.com
Contact: BRDZ Contact Form

Prerequisites​

Step 1: Project Setup​

Create New Project​

Environment Configuration​

Basic Project Structure​

Step 2: SDK Initialization​

Step 3: Authentication Implementation​

Step 4: Wallet Management​

Step 5: Main Application​

Step 6: Test Your Application​

Run the Demo​

Expected Output​

Step 7: Explore More Features​

Add Package Scripts​

Try Additional Modules​

Common Issues & Solutions​

Issue: API Key Missing​

Issue: Authentication Required​

Issue: Module Not Found​

What You've Learned​

Next Steps​

Explore More Modules​