@yoroi/banxa
TypeScript icon, indicating that this package has built-in type declarations

1.5.0 • Public • Published

Yoroi Banxa Module

The Yoroi Banxa package is a utility for interacting with Banxa resources/APIs.

Installation

Install the package using npm or yarn :

npm install @yoroi/banxa --save
yarn add @yoroi/banxa --save

Usage

Generating a referral URL to redirect/open

import { Banxa, banxaModuleMaker } from '@yoroi/banxa';

const options: Banxa.ReferralUrlBuilderOptions = {
    isProduction: true,
    partner: 'emurgo',
};

const params: Banxa.ReferralUrlQueryStringParams = {
    fiatType: 'USD',
    coinType: 'ADA',
    walletAddress:
        'addr1q9v8dvht2mv847gwarl7r4p49yzys8r7zlep7c8t2hqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqquvupf',
};

const banxa = banxaModuleMaker(options);

const url = banxa.createReferralUrl(params);

console.log(url.toString())

Error handling

try {
    // some Banxa code
} catch (error) {
    if (error instanceof Banxa.ValidationError) {
        console.error("Validation error:", error.message);
    } else if (error instanceof Banxa.UnknownError) {
        console.error("Unknown error:", error.message);
    }
}

Running on mobile

To use this module on a react-native application it is required to polyfill the URL object by using modules such as react-native-url-polyfill

Package Sidebar

Install

npm i @yoroi/banxa

Weekly Downloads

39

Version

1.5.0

License

Apache-2.0

Unpacked Size

134 kB

Total Files

138

Last publish

Collaborators

  • cryptotitan
  • vsubhuman
  • drkost
  • stackchain