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¶

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

npm install @brij-fi/widget-sdk

2. Initialize the Widget¶

Create a container element and initialize the SDK:

<div id="brij-widget"></div>

<script>
    const {BrijSDK, BrijAction} = window.BrijSDK;

    const sdk = BrijSDK.init('#brij-widget', {
        apiKey: 'your-api-key',
    });
</script>

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

Configuration Options¶

Basic Configuration¶

Example with Options¶

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

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

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

Theme Options¶

General¶

Option	Type	Default	Description
logoUrl	string		URL to your logo image (PNG, JPG, or SVG). Displays at 31px height with auto-scaled width
mode	string	'light'	Base theme: 'light' or 'dark'. Partner colors override on top

Backgrounds¶

Text¶

Brand¶

Primary CTA Buttons¶

Secondary CTA Buttons¶

Menu¶

Examples¶

On-Ramp Only (Solana)¶

Enable only fiat-to-crypto conversion on Solana:

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

Off-Ramp Only (Multiple Chains)¶

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

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

Full Configuration with Custom Theme¶

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

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