KintoID

Deployment Address:

Mainnet: 0xf369f78E3A0492CC4e96a90dae0728A38498e9c7

Interface: IKintoId.sol

---

Basics

The easiest way to check an account is to use the isKYC method. It checks a given address, making sure it has a valid KYC. It has been audited recently for AML sanctions, and it has none.

For example, if you want to check whether a specific address verifies all these properties, you can call:

isKYC(<ADDRESS>)

Trait IDs

Every user has a trait that identifies its country of origin using the ISO-32166. For example, if an individual is a citizen of the USA, the trait with ID 840 will be set. The following traits will be used to verify additional flags on a user identity.

Name	Number
KINTO_ADMIN_WALLET	0
US_ACCREDITATION	1
USA	840
...	...

Using the following call method, you can quickly check if a user has any trait. For example, if you want to check whether a specific address is an accredited investor in the US, you can use:

hasTrait(<ADDRESS>, 1)

Sanction IDs

The numerical country code will key the sanction IDs according to https://en.wikipedia.org/wiki/ISO_3166-1_numeric.

Kinto will use the country code 1 for network related incidents including hacks, stolen and duplicate identity.

For example, to check whether a user has any sanctions in the US:

isSanctionsSafeIn(<ADDRESS>, 840);

State Functions

Privileged roles can call the following functions.

function mintIndividualKyc(SignatureData calldata _signatureData, uint16[] memory _traits) external;

function mintCompanyKyc(SignatureData calldata _signatureData, uint16[] memory _traits) external;

function burnKYC(SignatureData calldata _signatureData) external;

function addTrait(address _account, uint16 _traitId) external;

function removeTrait(address _account, uint16 _traitId) external;

function addSanction(address _account, uint16 _countryId) external;

function removeSanction(address _account, uint16 _countryId) external;

function monitor(address[] memory _accounts, MonitorUpdateData[][] memory _traitsAndSanctions) external;

1. mintIndividualKyc

This function mints a KYC token for an individual with specific traits. Only KYC providers are allowed to call this function.

function mintIndividualKyc(SignatureData calldata _signatureData, uint8[] memory _traits) external;

Parameter	Type	Explanation
_signatureData	SignatureData calldata	Contains the signature data for minting the KYC token
_traits	uint16[] memory	The array of trait IDs for the individual

---

2. mintCompanyKyc

This function mints a KYC token for a company with specific traits. Only KYC providers are allowed to call this function.

function mintCompanyKyc(SignatureData calldata _signatureData, uint16[] memory _traits) external;

Parameter	Type	Explanation
_signatureData	SignatureData calldata	Contains the signature data for minting the KYC token
_traits	uint16[] memory	The array of trait IDs for the company

---

3. burnKYC

This function burns a KYC token. Only KYC providers are allowed to call this function.

function burnKYC(SignatureData calldata _signatureData) external;

Parameter	Type	Explanation
_signatureData	SignatureData calldata	Contains the signature data for burning

---

---

4. addTrait

This function adds a trait to a given account. Only KYC providers are allowed to call this function.

function addTrait(address _account, uint16 _traitId) external;

Parameter	Type	Explanation
_account	address	The account address
_traitId	uint16	ID of the trait to add

---

5. removeTrait

This function removes a trait from a given account. Only KYC providers are allowed to call this function.

function removeTrait(address _account, uint16 _traitId) external;

Parameter	Type	Explanation
_account	address	The account address
_traitId	uint16	ID of the trait to remove

---

6. addSanction

This function adds a sanction to a given account. Only KYC providers are allowed to call this function.

function addSanction(address _account, uint16 _countryId) external;

Parameter	Type	Explanation
_account	address	The account address
_countryId	uint16	ID of the country to sanction

---

7. removeSanction

This function removes a sanction from a given account.

Only KYC providers are allowed to call this function.

function removeSanction(address _account, uint16 _countryId) external;

Parameter	Type	Explanation
_account	address	The account address
_countryId	uint8	ID of the country to remove sanction

---

8. monitor

This function monitors an array of accounts and updates their traits and sanctions. Only KYC providers are allowed to call this function.

function monitor(address[] memory _accounts, MonitorUpdateData[][] memory _traitsAndSanctions) external;

Parameter	Type	Explanation
_accounts	address[] memory	Array of account addresses
_traitsAndSanctions	MonitorUpdateData[][] memory	Array of traits and sanctions updates

---

View Functions

Anyone can call the following functions without a transaction to retrieve information from the contract.

function name() external pure returns (string memory);

function symbol() external pure returns (string memory);

function isKYC(address _account) external view returns (bool);

function isSanctionsMonitored(uint32 _days) external view returns (bool);

function isSanctionsSafe(address _account) external view returns (bool);

function isSanctionsSafeIn(address _account, uint16 _countryId) external view returns (bool);

function isCompany(address _account) external view returns (bool);

function isIndividual(address _account) external view returns (bool);

function mintedAt(address _account) external view returns (uint256);

function hasTrait(address _account, uint16 index) external view returns (bool);

function traits(address _account) external view returns (bool[] memory);

function supportsInterface(bytes4 interfaceId);

1. isKYC

This function checks whether a given account is KYC'd by checking the balance of KYC tokens.

function isKYC(address _account) external view override returns (bool);

Parameter	Type	Explanation
_account	address	The address to check

2. isSanctionsMonitored

This function checks whether the account has been monitored for sanctions in the last X days.

function isSanctionsMonitored(uint32 _days) public view override returns(bool);

Parameter	Type	Explanation
_days	uint32	Number of days to check

---

3. isSanctionsSafe

This function checks whether a given account is safe from sanctions.

function isSanctionsSafe(address _account) public view override returns (bool);

Parameter	Type	Explanation
_account	address	The account address

---

4. isSanctionsSafeIn

This function checks whether a given account is safe from sanctions in a specific country.

function isSanctionsSafeIn(address _account, uint16 _countryId) external view override returns (bool);

Parameter	Type	Explanation
_account	address	The account address
_countryId	uint16	The country ID

---

5. isCompany

This function checks whether a given account is a company.

function isCompany(address _account) external view override returns (bool);

Parameter	Type	Explanation
_account	address	The account address

---

6. isIndividual

This function checks whether a given account is an individual.

function isIndividual(address _account) external view override returns (bool);

Parameter	Type	Explanation
_account	address	The account address

---

7. mintedAt

This function returns the timestamp when the KYC token was minted for a given account.

function mintedAt(address _account) external view override returns (uint256);

Parameter	Type	Explanation
_account	address	The account address

---

8. hasTrait

This function checks whether a given account has a specific trait.

function hasTrait(address _account, uint16 index) external view override returns (bool);

Parameter	Type	Explanation
_account	address	The account address
index	uint16	Index of the trait to check

---

9. traits

This function returns an array of booleans representing the traits of the account.

function traits(address _account) external view override returns (bool[] memory);

Parameter	Type	Explanation
_account	address	The account address

10. supportsInterface

Returns whether the contract implements the interface defined by the id

function supportsInterface(bytes4 interfaceId);

Parameter	Type	Explanation
interfaceId	bytes4	id of the interface to be checked