Wallet Integration Guide

Overview

The BRIJ Widget SDK allows wallets and dApps to embed crypto on/off-ramp functionality directly into their applications. With just a few lines of code, you can provide your users with seamless fiat-to-crypto and crypto-to-fiat conversion powered by BRIJ’s network of ramp partners.

Features

• Easy Integration: Add on/off-ramp functionality with minimal code
• Customizable UI: Match the widget appearance to your application’s design
• Multi-Chain Support: Support for all major blockchain networks
• Flexible Modes: Enable on-ramp, off-ramp, or both

Getting Started

1. Contact BRIJ to obtain your API key
2. Add the SDK to your application using CDN or npm
3. Initialize the widget with your API key and desired configuration
4. Customize the theme to match your application’s design (optional)

Installation

1. Add the SDK

CDN

Add the SDK script to your HTML:

1
<script src="https://unpkg.com/@brij-fi/widget-sdk/dist/index.umd.js"></script>

npm

Install via npm:

$
npm install @brij-fi/widget-sdk

2. Initialize the Widget

Create a container element and initialize the SDK:

1
<div id="brij-widget"></div>
2
3
<script>
4
    const {BrijSDK, BrijAction} = window.BrijSDK;
5
6
    const sdk = BrijSDK.init('#brij-widget', {
7
        apiKey: 'your-api-key',
8
    });
9
</script>

That’s it! The widget is now ready to use.

Configuration Options

Basic Configuration

Example with Options

1
const sdk = BrijSDK.init('#brij-widget', {
2
    apiKey: 'your-api-key',
3
    chains: ['SOLANA', 'ETHEREUM', 'BASE'],
4
    mode: ['ONRAMP'],
5
});

Theme Customization

The widget supports two predefined themes (light and dark) with full color customization. Select a base theme with mode, then override specific colors as needed.

Built-in Themes

Light	Dark

1
const sdk = BrijSDK.init('#brij-widget', {
2
    apiKey: 'your-api-key',
3
    theme: {
4
        mode: 'dark',
5
        logoUrl: 'https://your-site.com/logo.png',
6
        primaryBrand: 'FF4500',
7
        primaryCtaBgActive: '2563EB',
8
    }
9
});

Theme Options

General

Backgrounds

Text

Brand

Primary CTA Buttons

Secondary CTA Buttons

Menu

Note: Color values should be provided as hex codes without the # prefix (e.g., 'FF4500' for orange, 'FF000080' for 50% transparent red).

Examples

On-Ramp Only (Solana)

Enable only fiat-to-crypto conversion on Solana:

1
const sdk = BrijSDK.init('#brij-widget', {
2
    apiKey: 'your-api-key',
3
    chains: ['SOLANA'],
4
    mode: ['ONRAMP'],
5
});

Off-Ramp Only (Multiple Chains)

Enable only crypto-to-fiat conversion on Ethereum and Base:

1
const sdk = BrijSDK.init('#brij-widget', {
2
    apiKey: 'your-api-key',
3
    chains: ['ETHEREUM', 'BASE'],
4
    mode: ['OFFRAMP'],
5
});

Full Configuration with Custom Theme

1
const sdk = BrijSDK.init('#brij-widget', {
2
    apiKey: 'your-api-key',
3
    chains: ['SOLANA', 'ETHEREUM', 'BASE', 'POLYGON'],
4
    mode: ['ONRAMP', 'OFFRAMP'],
5
    theme: {
6
        mode: 'dark',
7
        logoUrl: 'https://your-site.com/logo.png',
8
        primaryBrand: '6366F1',
9
        contentBg: '0F0F23',
10
        primaryCtaBgActive: '4F46E5',
11
    }
12
});

Supported Networks

The widget supports all BRIJ networks. Use the network codes when configuring the chains option:

• SOLANA - Solana
• ETHEREUM - Ethereum
• BASE - Base
• POLYGON - Polygon
• ARBITRUM - Arbitrum
• OPTIMISM - Optimism
• BSC - BNB Smart Chain
• AVALANCHEC - Avalanche C-Chain
• BITCOIN - Bitcoin
• TON - TON
• TRON - TRON