KYC & Identity

To ensure regulatory compliance for fiat operations, the Toronet blockchain supports Know Your Customer (KYC) verification directly through the SDK.

This allows projects to:

  • Perform user identity verification using BVN and personal info

  • Ensure a wallet is eligible for higher-value fiat transactions

  • Check if a wallet is already verified


βœ… When Is KYC Required?

KYC is mandatory for:

  • Deposits over 200 USD or ₦200,000 NGN

  • Legal/financial use cases where verified identity is necessary

  • Unlocking certain on-chain features (coming soon)


🧾 KYC Verification Flow

  1. Collect user identity information (name, BVN, DOB, etc.)

  2. Pass the data into the performKYCForCustomer() method

  3. Verify the result and store confirmation in your backend


🧠 Perform KYC

import { performKYCForCustomer } from 'torosdk';

const success = await performKYCForCustomer({
  firstName: 'John',
  middleName: 'Doe',
  lastName: 'Doe',
  bvn: '12345678901',
  currency: 'NGN',
  phoneNumber: '08012345678',
  dob: '1990-01-01',
  address: '0xWalletAddress',
  admin: 'adminWalletAddress',
  adminpwd: 'adminPassword',
});

πŸ“¦ Payload Fields

Field
Description

firstName

User's legal first name

middleName

User's middle name (optional but recommended)

lastName

User's last name

bvn

Nigerian BVN (for NGN-based verification)

currency

Currency code (e.g. NGN)

phoneNumber

User's phone number

dob

Date of birth (format: YYYY-MM-DD)

address

Toronet wallet address being verified

admin, adminpwd

Credentials from your registered project


πŸ” Check If Wallet is KYC Verified

Use this method to confirm KYC status of a given wallet:

import { isAddressKYCVerified } from 'torosdk';

const { verified, provider } = await isAddressKYCVerified({
  address: '0xWalletAddress',
});

Response:

{
  verified: true,
  provider: 'ConnectW'
}

πŸ”’ Best Practices

  • Always perform KYC before high-volume fiat deposits.

  • Never store raw BVN or sensitive identity info in plaintext.

  • Inform users how their data is used and stored.


🌍 Multi-Currency Support

While BVN is used for NGN flows, KYC for other currencies (e.g. USD, KSH) may follow alternative verification models in the future.


Last updated