Skip to main content
The KYI Widget SDK (@bluprynt/kyi-widget-sdk) puts Know Your Issuer inside your product. Your members verify their organization and their assets in a drawer on your page. They never create a separate Bluprynt login or leave your site. It’s built for platforms that list or hold tokens, such as exchanges, launchpads, tokenization platforms, wallets and data sites, and that want issuers verified where they already are.
KYI drawer open over a partner page.

The kyi scope, opened from a partner page.

​
Key concepts

​
How it works

  1. Your server signs a token with your SECRET_KEY. The secret never reaches the browser.
  2. The browser calls kyi(). The SDK opens an iframe at https://app.bluprynt.com/widget/<scope>.
  3. Bluprynt checks the token and that your page’s origin is allowlisted, then links the session to the member’s organization.
  4. The member completes the steps. Progress is saved against sub, so they can stop and pick up later.
  5. Lifecycle events come back to your page through postMessage. The SDK only accepts messages from Bluprynt’s origin and its own iframe.

​
Integration lifecycle

1

Get credentials and allowlist your origins

Contact your Bluprynt representative with every origin that will embed the widget, for example https://app.example.com, https://staging.example.com and http://localhost:3000. You receive a partner ID and a SECRET_KEY.
2

Install the SDK

3

Add a token endpoint

An authenticated POST route that returns { accessToken }. See Access tokens.
4

Open the drawer

kyi('drawer', 'kyi', accessToken, { onClose }) from a button. See the Quickstart.
5

Members verify

KYB, add an asset, then sign with each authority wallet. See Verification flow.
6

Show status

Open asset-list or wallet-list for members to review their verified assets and wallets. Show public status with a KYI badge, or query it with the Public API.
7

Clean up

Call widget.destroy() when your page unmounts.

​
What’s in the SDK

The package is open source at github.com/blupryntco/kyi-widget-sdk, with a playground for trying tokens and scopes.

​
Supported chains

The widget verifies assets on the chains listed in Supported chains: EVM networks including Ethereum, Base, Plume and Avalanche, plus Solana and XRPL. The signing methods for each chain are in Wallet verification.

​
Limits

  • Drawer only. drawer is the one supported display mode.
  • No prefill. You can’t pass a chain or token address. The member pastes it in the drawer.
  • No completion callback. There’s no onComplete. To check status after the drawer closes, use the Public API or a badge.
  • Allowlisted origins only. The widget won’t load anywhere else.

​
Start here

Quickstart

A working integration in three steps.

Verification flow

Every screen your members see.

Access tokens

Node.js and Python token endpoints.

Example: Claim this profile

A complete Next.js integration.