Overview

The BusinessOnboardingSdk is provided by Averer. It lets RWA issuer developers integrate business onboarding into their own apps without having to build KYB flows or smart contract logic.

🔎 What it Does¶

When you embed the SDK in your application, here’s what happens for a business user:

1. KYB Verification – Averer verifies the business applicant (director or authorized officer).
2. Smart Contract Deployment – Once verified, a Business Identifier contract is automatically deployed on the Redbelly Network with the business’s details.
3. Delegated Access – That Business Identifier lets the company authorize external EOAs (wallets) to act on its behalf, without each account needing to go through KYB.

👩‍💻 Why this matters for you (RWA Issuer Developer)¶

• No need to build KYB – The entire KYB flow is handled inside the SDK.
• No need to deploy contracts manually – The Business Identifier contract is created automatically.
• Easy integration – Drop the SDK into your app in minutes.
• On-chain trust – Any address and business details can be checked later to confirm if it’s a verified business.

🚦 Quick Start – Adding Business Onboarding¶

To use the Business Onbarding SDK in your application, you need to wrap your root component with EligibilitySDKProvider and initialize wallet support via AppKit’s Wagmi adapter.

You can also refer to the example at: 👉 EligibilitySDKProvider

import { BusinessOnboardingSdk } from "@redbellynetwork/eligibility-sdk";

export default function BusinessOnboardingPage() {
  return (
    <BusinessOnboardingSdk
      // optional: customize the text and branding
      sdkOverride={{
        welcome: {
          heading: "Register your business",
          description:
            "Complete KYB and deploy your Business Identifier contract on the Redbelly Network.",
          btnText: "Start Verification",
        },
        verificationPending: {
          heading: "We’re verifying your business…",
          message: "This usually takes less than a minute.",
        },
        verificationFailed: {
          heading: "Verification failed",
          message: "Something went wrong. Please try again.",
        },
        verificationSuccess: {
          heading: "✅ Business Verified!",
          message:
            "Your KYB is complete and your Business Identifier contract is now live on-chain.",
          nextButton: <a href="/dashboard">Continue</a>,
        },
      }}
    />
  );
}

👉 That’s it — you now have a working business onboarding flow in your app.

🔍 Checking Business Status with useBusinessDetails¶

After onboarding, you’ll often want to know if a connected wallet belongs to a verified business and fetch its details.

That’s where the useBusinessDetails hook comes in.

import { useBusinessDetails } from "@redbellynetwork/eligibility-sdk";

// address: eth watllet address
function BusinessStatus({ address }: { address: string }) {
  const { data, isLoading, error, refetchBusinessIdentifier } =
    useBusinessDetails(address);

  if (isLoading) return <p>Loading…</p>;
  if (error) return <p>Error: {error.message}</p>;

  if (!data?.isBusinessUser) {
    return <p>{address} is not a verified business.</p>;
  }

  return (
    <div>
      <p>✅ {address} is a verified business</p>
      <p>Contract: {data.businessContractAddress}</p>
      <pre>{JSON.stringify(data.businessDetails, null, 2)}</pre>
      <button onClick={refetchBusinessIdentifier}>Refresh</button>
    </div>
  );
}

What you get back¶

• isBusinessUser → true if the address is linked to a verified business
• businessContractAddress → the deployed Business Identifier contract address
• businessDetails → metadata (company name, incorporation details, identifier, type, incorporated name, is beneficial owner, company address.)