Blockwell-QR Index

0x9f2e6d25cdb1ccef08bae943d3d1f5f7a5a98e4d Copy

About

Stats

Public Functions 25

Event Types 5

Code Size 24,115 bytes

Library Use

Uses Groups for Groups.GroupMap.

Uses SafeMath for uint256.

Events (5)

AddedToGroup Event

Parameters

groupId	uint8
account	address

Approval Event

Parameters

_owner	address
_approved	address
_tokenId	uint256

ApprovalForAll Event

Parameters

_owner	address
_operator	address
_approved	bool

RemovedFromGroup Event

Parameters

groupId	uint8
account	address

Transfer Event

Parameters

_from	address
_to	address
_tokenId	uint256

Constants (5)

ADMIN Constant

uint8

INTERFACE_ID_ERC721 Constant

bytes4

0x80ac58cd

INTERFACE_ID_ERC721_METADATA Constant

bytes4

0x5b5e139f

INTERFACE_ID_ERC721_ENUMERABLE Constant

bytes4

0x780e9d63

INTERFACE_ID_ERC165 Constant

bytes4

0x01ffc9a7

State Variables (15)

unrestrictedMinting Variable

bool

tokenOwner Variable

address

tokenName Variable

string

Internal Variable

tokenSymbol Variable

string

Internal Variable

groups Variable

Groups.GroupMap

Internal Variable

allTokens Variable

uint256[]

Internal Variable

tokenIndex Variable

mapping(uint256 => uint256)

Internal Variable

owners Variable

mapping(uint256 => address)

Internal Variable

ownedTokens Variable

mapping(address => uint256[])

Internal Variable

ownedTokensIndex Variable

mapping(uint256 => uint256)

Internal Variable

approval Variable

mapping(uint256 => address)

Internal Variable

tokenCount Variable

mapping(address => uint256)

Internal Variable

operatorApproval Variable

mapping(address => mapping(address => bool))

Internal Variable

uri Variable

mapping(uint256 => string)

Internal Variable

supportedInterfaces Variable

mapping(bytes4 => bool)

Internal Variable

Functions Expand All Collapse All

supportsInterface

Parameters

Name	Type
interfaceId	bytes4

Properties

Visibility public

Mutability view

Source Code

function supportsInterface(bytes4 interfaceId) external view returns (bool) {
  return supportedInterfaces[interfaceId];
}

unrestrictMinting

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

onlyAdmin checks for the following:

null

Source Code

function unrestrictMinting() public onlyAdmin {
  unrestrictedMinting = true;
}

restrictMinting

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

onlyAdmin checks for the following:

null

Source Code

function restrictMinting() public onlyAdmin {
  unrestrictedMinting = false;
}

name

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function name() external view returns (string) {
  return tokenName;
}

symbol

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function symbol() external view returns (string) {
  return tokenSymbol;
}

totalSupply

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function totalSupply() public view returns (uint256) {
  return allTokens.length;
}

balanceOf

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability view

Requirements

account must not be equal to UNKNOWN VALUE

Source Code

function balanceOf(address account) public view returns (uint256) {
  require(account != address(0));
  return tokenCount[account];
}

ownerOf

Parameters

Name	Type
tokenId	uint256

Properties

Visibility public

Mutability view

Requirements

owner must not be equal to UNKNOWN VALUE

Source Code

function ownerOf(uint256 tokenId) public view returns (address) {
  address owner = owners[tokenId];
  require(owner != address(0));
  return owner;
}

tokenOfOwnerByIndex

Parameters

Name	Type
owner	address
index	uint256

Properties

Visibility public

Mutability view

Requirements

index must be less than the result of calling balanceOf with owner

Source Code

function tokenOfOwnerByIndex(address owner, uint256 index)
  public
  view
  returns (uint256)
{
  require(index < balanceOf(owner));
  return ownedTokens[owner][index];
}

tokenByIndex

Parameters

Name	Type
index	uint256

Properties

Visibility public

Mutability view

Requirements

index must be less than the result of calling totalSupply

Source Code

function tokenByIndex(uint256 index) public view returns (uint256) {
  require(index < totalSupply());
  return allTokens[index];
}

getApproved

Parameters

Name	Type
tokenId	uint256

Properties

Visibility public

Mutability view

Requirements

null

Source Code

function getApproved(uint256 tokenId) public view returns (address) {
  require(_exists(tokenId));
  return approval[tokenId];
}

isApprovedForAll

Parameters

Name	Type
account	address
operator	address

Properties

Visibility public

Mutability view

Source Code

function isApprovedForAll(address account, address operator)
  public
  view
  returns (bool)
{
  return operatorApproval[account][operator];
}

tokenURI

Parameters

Name	Type
tokenId	uint256

Properties

Visibility public

Mutability view

Requirements

null

Source Code

function tokenURI(uint256 tokenId) external view returns (string) {
  require(_exists(tokenId));
  return uri[tokenId];
}

addAdmin

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyAdmin checks for the following:

null

Source Code

function addAdmin(address account) public onlyAdmin {
  _addAdmin(account);
}

removeAdmin

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyAdmin checks for the following:

null

Source Code

function removeAdmin(address account) public onlyAdmin {
  groups.remove(ADMIN, account);
  emit RemovedFromGroup(ADMIN, account);
}

isAdmin

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability view

Source Code

function isAdmin(address account) public view returns (bool) {
  return groups.contains(ADMIN, account);
}

approve

Parameters

Name	Type
account	address
tokenId	uint256

Properties

Visibility public

Mutability transaction

Requirements

One or more of the following: -null - OR owner must be equal to the sender's address

Source Code

function approve(address account, uint256 tokenId) public {
  address owner = ownerOf(tokenId);

  require(msg.sender == owner || isApprovedForAll(owner, msg.sender));

  approval[tokenId] = account;
  emit Approval(owner, account, tokenId);
}

setApprovalForAll

Parameters

Name	Type
to	address
approved	bool

Properties

Visibility public

Mutability transaction

Requirements

to must not be equal to the sender's address

Source Code

function setApprovalForAll(address to, bool approved) public {
  require(to != msg.sender);
  operatorApproval[msg.sender][to] = approved;
  emit ApprovalForAll(msg.sender, to, approved);
}

transferFrom

Parameters

Name	Type
from	address
to	address
tokenId	uint256

Properties

Visibility public

Mutability transaction

Requirements

null

to must not be equal to UNKNOWN VALUE

from must be equal to the result of calling ownerOf with tokenId

owners for tokenId must be equal to UNKNOWN VALUE

Source Code

function transferFrom(
  address from,
  address to,
  uint256 tokenId
) public {
  require(_isApprovedOrOwner(msg.sender, tokenId));
  require(to != address(0));

  _clearApproval(from, tokenId);
  _removeTokenFrom(from, tokenId);
  _addTokenTo(to, tokenId);

  emit Transfer(from, to, tokenId);
}

safeTransferFrom

Parameters

Name	Type
from	address
to	address
tokenId	uint256

Properties

Visibility public

Mutability payable

Requirements

null

to must not be equal to UNKNOWN VALUE

from must be equal to the result of calling ownerOf with tokenId

owners for tokenId must be equal to UNKNOWN VALUE

null

Source Code

function safeTransferFrom(
  address from,
  address to,
  uint256 tokenId
) external payable {
  transferFrom(from, to, tokenId);
  require(_checkOnERC721Received(from, to, tokenId, ""));
}

safeTransferFrom

Parameters

Name	Type
from	address
to	address
tokenId	uint256
data	bytes

Properties

Visibility public

Mutability payable

Requirements

null

to must not be equal to UNKNOWN VALUE

from must be equal to the result of calling ownerOf with tokenId

owners for tokenId must be equal to UNKNOWN VALUE

null

Source Code

function safeTransferFrom(
  address from,
  address to,
  uint256 tokenId,
  bytes data
) external payable {
  transferFrom(from, to, tokenId);
  require(_checkOnERC721Received(from, to, tokenId, data));
}

mint

Parameters

Name	Type
to	address
tokenId	uint256

Properties

Visibility public

Mutability transaction

Modifiers

onlyAdmin checks for the following:

null

Requirements

to must not be equal to UNKNOWN VALUE

owners for tokenId must be equal to UNKNOWN VALUE

Source Code

function mint(address to, uint256 tokenId) public onlyAdmin returns (bool) {
  _mint(to, tokenId);
  return true;
}

mintWithTokenURI

Parameters

Name	Type
to	address
tokenId	uint256
URIForToken	string

Properties

Visibility public

Mutability transaction

Modifiers

onlyAdmin checks for the following:

null

Requirements

to must not be equal to UNKNOWN VALUE

owners for tokenId must be equal to UNKNOWN VALUE

null

Source Code

function mintWithTokenURI(
  address to,
  uint256 tokenId,
  string URIForToken
) public onlyAdmin returns (bool) {
  _mint(to, tokenId);
  _setTokenURI(tokenId, URIForToken);
  return true;
}

addQr

Parameters

Name	Type
tokenId	uint256

Properties

Visibility public

Mutability transaction

Requirements

tokenOwner must not be equal to UNKNOWN VALUE

owners for tokenId must be equal to UNKNOWN VALUE

null

Source Code

function addQr(uint256 tokenId) public returns (bool) {
  if (!unrestrictedMinting) {
    require(isAdmin(msg.sender), "Must be an admin");
  }
  _mint(tokenOwner, tokenId);
  _setTokenURI(
    tokenId,
    concat("https://qr.blockwell.ai/qri/", uint2str(tokenId))
  );
  return true;
}

burn

Parameters

Name	Type
tokenId	uint256

Properties

Visibility public

Mutability transaction

Requirements

the sender's address must be equal to the result of calling ownerOf with tokenId

from must be equal to the result of calling ownerOf with tokenId

the result of calling ownerOf with tokenId must be equal to the sender's address

Source Code

function burn(uint256 tokenId) public {
  require(msg.sender == ownerOf(tokenId));
  _burn(msg.sender, tokenId);
}

Internal Functions Expand All Collapse All

Internal functions are parts of the contract that can't be used directly, but instead are used by the public functions listed above.

internal Qri._addAdmin

Parameters

Name	Type
account	address

Properties

Visibility internal

Mutability transaction

Source Code

function _addAdmin(address account) internal {
  groups.add(ADMIN, account);
  emit AddedToGroup(ADMIN, account);
}

internal Qri._exists

Parameters

Name	Type
tokenId	uint256

Properties

Visibility internal

Mutability view

Source Code

function _exists(uint256 tokenId) internal view returns (bool) {
  return owners[tokenId] != address(0);
}

internal Qri._isApprovedOrOwner

Parameters

Name	Type
spender	address
tokenId	uint256

Properties

Visibility internal

Mutability view

Source Code

function _isApprovedOrOwner(address spender, uint256 tokenId)
  internal
  view
  returns (bool)
{
  address owner = ownerOf(tokenId);
  return (spender == owner ||
    getApproved(tokenId) == spender ||
    isApprovedForAll(owner, spender));
}

internal Qri._mint

Parameters

Name	Type
to	address
tokenId	uint256

Properties

Visibility internal

Mutability transaction

Requirements

tokenOwner must not be equal to UNKNOWN VALUE

owners for tokenId must be equal to UNKNOWN VALUE

Source Code

function _mint(address to, uint256 tokenId) internal {
  require(to != address(0));
  _addTokenTo(to, tokenId);

  tokenIndex[tokenId] = allTokens.length;
  allTokens.push(tokenId);

  emit Transfer(address(0), to, tokenId);
}

internal Qri._burn

Parameters

Name	Type
account	address
tokenId	uint256

Properties

Visibility internal

Mutability transaction

Requirements

from must be equal to the result of calling ownerOf with tokenId

the result of calling ownerOf with tokenId must be equal to the sender's address

Source Code

function _burn(address account, uint256 tokenId) internal {
  _clearApproval(account, tokenId);
  _removeTokenFrom(account, tokenId);

  if (bytes(uri[tokenId]).length != 0) {
    delete uri[tokenId];
  }

  // Delete from array by moving the last element to the deleted position
  uint256 index = tokenIndex[tokenId];
  uint256 lastTokenIndex = allTokens.length.sub(1);
  uint256 lastToken = allTokens[lastTokenIndex];

  allTokens[index] = lastToken;
  allTokens[lastTokenIndex] = 0;

  allTokens.length--;
  tokenIndex[tokenId] = 0;
  tokenIndex[lastToken] = index;

  emit Transfer(account, address(0), tokenId);
}

internal Qri._addTokenTo

Parameters

Name	Type
to	address
tokenId	uint256

Properties

Visibility internal

Mutability transaction

Requirements

owners for tokenId must be equal to UNKNOWN VALUE

Source Code

function _addTokenTo(address to, uint256 tokenId) internal {
  require(owners[tokenId] == address(0));
  owners[tokenId] = to;
  tokenCount[to] = tokenCount[to].add(1);

  ownedTokens[to].push(tokenId);
  ownedTokensIndex[tokenId] = ownedTokens[to].length - 1;
}

internal Qri._removeTokenFrom

Parameters

Name	Type
from	address
tokenId	uint256

Properties

Visibility internal

Mutability transaction

Requirements

the result of calling ownerOf with tokenId must be equal to the sender's address

Source Code

function _removeTokenFrom(address from, uint256 tokenId) internal {
  require(ownerOf(tokenId) == from);
  tokenCount[from] = tokenCount[from].sub(1);
  owners[tokenId] = address(0);

  // Delete from array by moving the last element to the deleted position
  uint256 index = ownedTokensIndex[tokenId];
  uint256 lastTokenIndex = ownedTokens[from].length.sub(1);
  uint256 lastToken = ownedTokens[from][lastTokenIndex];

  ownedTokens[from][index] = lastToken;
  ownedTokens[from].length--;

  ownedTokensIndex[tokenId] = 0;
  ownedTokensIndex[lastToken] = index;
}

internal Qri._checkOnERC721Received

Parameters

Name	Type
from	address
to	address
tokenId	uint256
data	bytes

Properties

Visibility internal

Mutability transaction

Source Code

function _checkOnERC721Received(
  address from,
  address to,
  uint256 tokenId,
  bytes data
) internal returns (bool) {
  if (!isContract(to)) {
    return true;
  }
  ERC721TokenReceiver receiver = ERC721TokenReceiver(to);
  bytes4 retval = receiver.onERC721Received(msg.sender, from, tokenId, data);
  return (retval == receiver.onERC721Received.selector);
}

internal Qri._clearApproval

Parameters

Name	Type
account	address
tokenId	uint256

Properties

Visibility private

Mutability transaction

Requirements

from must be equal to the result of calling ownerOf with tokenId

Source Code

function _clearApproval(address account, uint256 tokenId) private {
  require(ownerOf(tokenId) == account);
  if (approval[tokenId] != address(0)) {
    approval[tokenId] = address(0);
  }
}

internal Qri._setTokenURI

Parameters

Name	Type
tokenId	uint256
newURI	string

Properties

Visibility internal

Mutability transaction

Requirements

null

Source Code

function _setTokenURI(uint256 tokenId, string newURI) internal {
  require(_exists(tokenId));
  uri[tokenId] = newURI;
}

internal Qri.concat

Parameters

Name	Type
a	string
b	string

Properties

Visibility internal

Mutability pure

Source Code

function concat(string memory a, string memory b)
  internal
  pure
  returns (string memory)
{
  uint256 aLength = bytes(a).length;
  uint256 bLength = bytes(b).length;
  string memory value = new string(aLength + bLength);
  uint256 valuePointer;
  uint256 aPointer;
  uint256 bPointer;
  assembly {
    valuePointer := add(value, 32)
    aPointer := add(a, 32)
    bPointer := add(b, 32)
  }
  copy(aPointer, valuePointer, aLength);
  copy(bPointer, valuePointer + aLength, bLength);
  return value;
}

internal Qri.uint2str

Parameters

Name	Type
i	uint

Properties

Visibility internal

Mutability pure

Source Code

function uint2str(uint256 i) internal pure returns (string) {
  if (i == 0) return "0";
  uint256 j = i;
  uint256 length;
  while (j != 0) {
    length++;
    j /= 10;
  }
  bytes memory bstr = new bytes(length);
  uint256 k = length - 1;
  while (i != 0) {
    bstr[k--] = byte(48 + (i % 10));
    i /= 10;
  }
  return string(bstr);
}

internal Qri.copy

Parameters

Name	Type
src	uint
dest	uint
len	uint

Properties

Visibility internal

Mutability pure

Source Code

function copy(
  uint256 src,
  uint256 dest,
  uint256 len
) internal pure {
  // Copy word-length chunks while possible
  for (; len >= 32; len -= 32) {
    assembly {
      mstore(dest, mload(src))
    }
    dest += 32;
    src += 32;
  }

  // Copy remaining bytes
  uint256 mask = 256**(32 - len) - 1;
  assembly {
    let srcpart := and(mload(src), not(mask))
    let destpart := and(mload(dest), mask)
    mstore(dest, or(destpart, srcpart))
  }
}

internal Qri.isContract

Parameters

Name	Type
account	address

Properties

Visibility internal

Mutability view

Source Code

function isContract(address account) internal view returns (bool) {
  uint256 size;
  assembly {
    size := extcodesize(account)
  }
  return size > 0;
}

internal ERC165Map._addInterface

Parameters

Name	Type
interfaceId	bytes4

Properties

Visibility internal

Mutability transaction

Requirements

interfaceId must not be equal to 0xffffffff

Source Code

function _addInterface(bytes4 interfaceId) internal {
  require(interfaceId != 0xffffffff);
  supportedInterfaces[interfaceId] = true;
}

Blockwell-QR Index

About

Stats

Library Use

Events (5) keyboard_arrow_up

AddedToGroup Event

Parameters help Event parameters list the data that an event contains.

Approval Event

Parameters help Event parameters list the data that an event contains.

ApprovalForAll Event

Parameters help Event parameters list the data that an event contains.

RemovedFromGroup Event

Parameters help Event parameters list the data that an event contains.

Transfer Event

Parameters help Event parameters list the data that an event contains.

Constants (5) keyboard_arrow_up

ADMIN Constant

INTERFACE_ID_ERC721 Constant

INTERFACE_ID_ERC721_METADATA Constant

INTERFACE_ID_ERC721_ENUMERABLE Constant

INTERFACE_ID_ERC165 Constant

State Variables (15) keyboard_arrow_up

unrestrictedMinting Variable

tokenOwner Variable

tokenName Variable

tokenSymbol Variable

groups Variable

allTokens Variable

tokenIndex Variable

owners Variable

ownedTokens Variable

ownedTokensIndex Variable

approval Variable

tokenCount Variable

operatorApproval Variable

uri Variable

supportedInterfaces Variable

Functions Expand All Collapse All

supportsInterface keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Source Code

unrestrictMinting keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

onlyAdmin checks for the following:

Source Code

restrictMinting keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

onlyAdmin checks for the following:

Source Code

name keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Source Code

symbol keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Source Code

totalSupply keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Source Code

balanceOf keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Requirements help Requirements are checks that the function makes when it runs, and give you insight on what conditions are required for the function to succeed.

Source Code

ownerOf keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Requirements help Requirements are checks that the function makes when it runs, and give you insight on what conditions are required for the function to succeed.

Source Code

tokenOfOwnerByIndex keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Requirements help Requirements are checks that the function makes when it runs, and give you insight on what conditions are required for the function to succeed.

Events (5)

Parameters

Parameters

Parameters

Parameters

Parameters

Constants (5)

State Variables (15)

supportsInterface

Parameters

unrestrictMinting

Parameters

Modifiers

restrictMinting

Parameters

Modifiers

name

Parameters

symbol

Parameters

totalSupply

Parameters

balanceOf

Parameters

Requirements

ownerOf

Parameters

Requirements

tokenOfOwnerByIndex

Parameters

Requirements

tokenByIndex

Parameters

Requirements

getApproved

Parameters

Requirements

isApprovedForAll

Parameters

tokenURI

Parameters

Requirements

addAdmin

Parameters

Modifiers

removeAdmin

Parameters

Modifiers

isAdmin

Parameters

approve

Parameters

Requirements

setApprovalForAll

Parameters

Requirements

transferFrom

Parameters

Requirements

safeTransferFrom

Parameters

Requirements

safeTransferFrom

Parameters

Requirements

mint

Parameters

Modifiers

Requirements

mintWithTokenURI