Query multiple attributes
Use the getAttributesBulk
function from the QuadReader smart contract to query multiple attributes about a passport holder.
Requirements
Installation
Install @quadrata/contracts package
npm i @quadrata/contracts --save-dev
Permissions
Calling smart contract have to be granted permissions to call getAttributesBulk
in Mainnet.
Contact us via email at [email protected] or Discord
Function
import "@quadrata/contracts/interfaces/IQuadPassportStore.sol";
// For Solidity version >= 0.8.0.
reader.getAttributesBulk(
address user,
bytes32[] calldata attributes
) external returns(
IQuadPassportStore.Attribute[] memory attributes
);
// For Solidity version < 0.8.0.
reader.getAttributesBulkLegacy(
address user,
bytes32[] calldata attributes
) external returns(
bytes32[] attributeValues,
uint256[] epochs,
address[] issuers
);
Parameters
Parameter
Description
Type
user
address of the passport holder
address (required)
Return values
A list of issued values for each attributes being queried.
This function will return exactly a list of the same length as the number of attributes being queried.
If an attribute hasn't been issued yet, it's value will be:
Attribute{value: bytes32(0), epoch: uint256(0), issuer: address(0)}
/// @dev Attribute store infomation as it relates to a single attribute
/// `attrKeys` Array of keys defined by (wallet address/DID + data Type)
/// `value` Attribute value
/// `epoch` timestamp when the attribute has been verified by an Issuer
/// `issuer` address of the issuer issuing the attribute
struct Attribute {
bytes32 value;
uint256 epoch;
address issuer;
}
Example
You can find our helper library to facilitate parsing the response => QuadReaderUtils
import "@quadrata/contracts/interfaces/IQuadReader.sol";
import "@quadrata/contracts/interfaces/IQuadPassportStore.sol";
import "@quadrata/contracts/utility/QuadReaderUtils.sol";
contract MyDapp {
using QuadReaderUtils for bytes32;
IQuadReader public reader;
function borrowMoney() external payable {
bytes32[] memory attributesToQuery = new bytes32[](2);
attributesToQuery[0] = keccak256("COUNTRY");
attributesToQuery[1] = keccak256("AML");
IQuadPassportStore.Attribute[] memory attributes = reader.getAttributesBulk(
msg.sender,
attributesToQuery
);
require(attributes.length == attributesToQuery.length, "REQUIRES_COUNTRY_AND_AML");
// only users residing outside the US may borrow money
bool isEligibleCountry = !attributes[0].value.countryIsEqual("US");
// only users with AML risk score < 5 may borrow money
bool isEligibleAML = attributes[1].value.amlLessThan(5));
if (isEligibleCountry && isEligibleAML) {
// Allow borrow actions
}
}
Last updated