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
Collect user identity information (name, BVN, DOB, etc.)
Pass the data into the
performKYCForCustomer()
methodVerify 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
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
Last updated