The Unlock Interface*
Methods
computeAvailableDiscountFor
function computeAvailableDiscountFor(address _purchaser, uint256 _keyPrice) external view returns (uint256 discount, uint256 tokens)
This function returns the discount available for a user, when purchasing a a key from a lock. This does not modify the state. It returns both the discount and the number of tokens consumed to grant that discount.
Parameters
| Name | Type | Description |
|---|
| _purchaser | address | undefined |
| _keyPrice | uint256 | undefined |
Returns
| Name | Type | Description |
|---|
| discount | uint256 | undefined |
| tokens | uint256 | undefined |
configUnlock
function configUnlock(address _udt, address _weth, uint256 _estimatedGasForPurchase, string _symbol, string _URI) external nonpayable
Allows the owner to update configuration variables
Parameters
| Name | Type | Description |
|---|
| _udt | address | undefined |
| _weth | address | undefined |
| _estimatedGasForPurchase | uint256 | undefined |
| _symbol | string | undefined |
| _URI | string | undefined |
createLock
function createLock(uint256 _expirationDuration, address _tokenAddress, uint256 _keyPrice, uint256 _maxNumberOfKeys, string _lockName, bytes12 _salt) external nonpayable
Create lock This deploys a lock for a creator. It also keeps track of the deployed lock.
Parameters
| Name | Type | Description |
|---|
| _expirationDuration | uint256 | undefined |
| _tokenAddress | address | set to the ERC20 token address, or 0 for ETH. |
| _keyPrice | uint256 | undefined |
| _maxNumberOfKeys | uint256 | undefined |
| _lockName | string | undefined |
| _salt | bytes12 | an identifier for the Lock, which is unique for the user. This may be implemented as a sequence ID or with RNG. It's used with create2 to know the lock's address before the transaction is mined. |
estimatedGasForPurchase
function estimatedGasForPurchase() external view returns (uint256)
Returns
| Name | Type | Description |
|---|
| _0 | uint256 | undefined |
getGlobalBaseTokenURI
function getGlobalBaseTokenURI() external view returns (string)
Redundant with globalBaseTokenURI() for backwards compatibility with v3 & v4 locks.
Returns
| Name | Type | Description |
|---|
| _0 | string | undefined |
getGlobalTokenSymbol
function getGlobalTokenSymbol() external view returns (string)
Redundant with globalTokenSymbol() for backwards compatibility with v3 & v4 locks.
Returns
| Name | Type | Description |
|---|
| _0 | string | undefined |
globalBaseTokenURI
function globalBaseTokenURI() external view returns (string)
Returns
| Name | Type | Description |
|---|
| _0 | string | undefined |
globalTokenSymbol
function globalTokenSymbol() external view returns (string)
Returns
| Name | Type | Description |
|---|
| _0 | string | undefined |
grossNetworkProduct
function grossNetworkProduct() external view returns (uint256)
Returns
| Name | Type | Description |
|---|
| _0 | uint256 | undefined |
initialize
function initialize(address _unlockOwner) external nonpayable
Parameters
| Name | Type | Description |
|---|
| _unlockOwner | address | undefined |
isOwner
function isOwner() external view returns (bool)
Returns true if the caller is the current owner.
Returns
| Name | Type | Description |
|---|
| _0 | bool | undefined |
locks
function locks(address) external view returns (bool deployed, uint256 totalSales, uint256 yieldedDiscountTokens)
Parameters
| Name | Type | Description |
|---|
| _0 | address | undefined |
Returns
| Name | Type | Description |
|---|
| deployed | bool | undefined |
| totalSales | uint256 | undefined |
| yieldedDiscountTokens | uint256 | undefined |
owner
function owner() external view returns (address)
Returns the address of the current owner.
Returns
| Name | Type | Description |
|---|
| _0 | address | undefined |
publicLockAddress
function publicLockAddress() external view returns (address)
Returns
| Name | Type | Description |
|---|
| _0 | address | undefined |
recordConsumedDiscount
function recordConsumedDiscount(uint256 _discount, uint256 _tokens) external nonpayable
This function will keep track of consumed discounts by a given user. It will also grant discount tokens to the creator who is granting the discount based on the amount of discount and compensation rate. This function is invoked by a previously deployed lock only.
Parameters
| Name | Type | Description |
|---|
| _discount | uint256 | undefined |
| _tokens | uint256 | undefined |
recordKeyPurchase
function recordKeyPurchase(uint256 _value, address _referrer) external nonpayable
This function keeps track of the added GDP, as well as grants of discount tokens to the referrer, if applicable. The number of discount tokens granted is based on the value of the referal, the current growth rate and the lock's discount token distribution rate This function is invoked by a previously deployed lock only.
Parameters
| Name | Type | Description |
|---|
| _value | uint256 | undefined |
| _referrer | address | undefined |
renounceOwnership
function renounceOwnership() external nonpayable
Leaves the contract without owner. It will not be possible to call onlyOwner functions anymore. Can only be called by the current owner. * NOTE: Renouncing ownership will leave the contract without an owner, thereby removing any functionality that is only available to the owner.
resetTrackedValue
function resetTrackedValue(uint256 _grossNetworkProduct, uint256 _totalDiscountGranted) external nonpayable
Parameters
| Name | Type | Description |
|---|
| _grossNetworkProduct | uint256 | undefined |
| _totalDiscountGranted | uint256 | undefined |
setLockTemplate
function setLockTemplate(address payable _publicLockAddress) external nonpayable
Upgrade the PublicLock template used for future calls to createLock.
This will initialize the template and revokeOwnership.
Parameters
| Name | Type | Description |
|---|
| _publicLockAddress | address payable | undefined |
setOracle
function setOracle(address _tokenAddress, address _oracleAddress) external nonpayable
allows the owner to set the oracle address to use for value conversions setting the _oracleAddress to address(0) removes support for the token
This will also call update to ensure at least one datapoint has been recorded.
Parameters
| Name | Type | Description |
|---|
| _tokenAddress | address | undefined |
| _oracleAddress | address | undefined |
totalDiscountGranted
function totalDiscountGranted() external view returns (uint256)
Returns
| Name | Type | Description |
|---|
| _0 | uint256 | undefined |
transferOwnership
function transferOwnership(address newOwner) external nonpayable
Transfers ownership of the contract to a new account (newOwner). Can only be called by the current owner.
Parameters
| Name | Type | Description |
|---|
| newOwner | address | undefined |
udt
function udt() external view returns (address)
Returns
| Name | Type | Description |
|---|
| _0 | address | undefined |
uniswapOracles
function uniswapOracles(address) external view returns (address)
Parameters
| Name | Type | Description |
|---|
| _0 | address | undefined |
Returns
| Name | Type | Description |
|---|
| _0 | address | undefined |
unlockVersion
function unlockVersion() external pure returns (uint16)
Returns
| Name | Type | Description |
|---|
| _0 | uint16 | undefined |
weth
function weth() external view returns (address)
Returns
| Name | Type | Description |
|---|
| _0 | address | undefined |