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.

---

🔗 Related Docs

• Fiat Deposit & Verification
• Wallet Management
• Get Balances