ocean.js/docs/classes/VeAllocate.md

@oceanprotocol/lib / Exports / VeAllocate

Class: VeAllocate

Provides an interface for veOcean contract

Hierarchy

• SmartContractWithAddress

  ↳ VeAllocate

Table of contents

Constructors

• constructor

Properties

• abi
• address
• config
• contract
• signer

Methods

• amountToUnits
• getContract
• getDefaultAbi
• getFairGasPrice
• getTotalAllocation
• getVeAllocation
• setAllocation
• setBatchAllocation
• unitsToAmount

Constructors

constructor

• new VeAllocate(address, signer, network?, config?, abi?)

Instantiate the smart contract.

Parameters

Name	Type	Description
address	string	The address of the contract.
signer	Signer	The signer object.
network?	string | number	Network id or name
config?	Config	The configuration object.
abi?	AbiItem[]	ABI array of the smart contract

Inherited from

SmartContractWithAddress.constructor

Defined in

contracts/SmartContractWithAddress.ts:17

Properties

abi

• abi: AbiItem[]

Inherited from

SmartContractWithAddress.abi

Defined in

contracts/SmartContract.ts:14

---

address

• address: string

Inherited from

SmartContractWithAddress.address

Defined in

contracts/SmartContractWithAddress.ts:6

---

config

• config: Config

Inherited from

SmartContractWithAddress.config

Defined in

contracts/SmartContract.ts:13

---

contract

• contract: Contract

Inherited from

SmartContractWithAddress.contract

Defined in

contracts/SmartContractWithAddress.ts:7

---

signer

• signer: Signer

Inherited from

SmartContractWithAddress.signer

Defined in

contracts/SmartContract.ts:12

Methods

amountToUnits

▸ Protected amountToUnits(token, amount, tokenDecimals?): Promise<string>

Converts an amount of tokens to units

Parameters

Name	Type	Description
token	string	The token to convert
amount	string	The amount of tokens to convert
tokenDecimals?	number	The number of decimals of the token

Returns

Promise<string>

• The converted amount in units

Inherited from

SmartContractWithAddress.amountToUnits

Defined in

contracts/SmartContract.ts:43

---

getContract

▸ Protected getContract(address, abi?): Contract

Returns a contract instance for the given address

Parameters

Name	Type	Description
address	string	The address of the contract
abi?	AbiItem[]	The ABI of the contract

Returns

Contract

• The contract instance

Inherited from

SmartContractWithAddress.getContract

Defined in

contracts/SmartContract.ts:80

---

getDefaultAbi

▸ getDefaultAbi(): AbiItem[]

Returns

AbiItem[]

Overrides

SmartContractWithAddress.getDefaultAbi

Defined in

contracts/ve/VeAllocate.ts:9

---

getFairGasPrice

▸ Protected getFairGasPrice(): Promise<string>

Retruns the gas price

Returns

Promise<string>

• The fair gas price

Inherited from

SmartContractWithAddress.getFairGasPrice

Defined in

contracts/SmartContract.ts:70

---

getTotalAllocation

▸ getTotalAllocation(userAddress): Promise<number>

Get totalAllocation for address

Parameters

Name	Type	Description
userAddress	string	user address

Returns

Promise<number>

Defined in

contracts/ve/VeAllocate.ts:81

---

getVeAllocation

▸ getVeAllocation(userAddress, nft, chainId): Promise<number>

Get getveAllocation for address, nft, chainId

Parameters

Name	Type	Description
userAddress	string	user address
nft	string	NFT address to allocate to
chainId	string	chainId of NFT

Returns

Promise<number>

Defined in

contracts/ve/VeAllocate.ts:92

---

setAllocation

▸ setAllocation<G>(amount, nft, chainId, estimateGas?): Promise<ReceiptOrEstimate<G>>

set a specific percentage of veOcean to a specific nft Maximum allocated percentage is 10000, so 1% is specified as 100

Type parameters

Name	Type
G	extends boolean = false

Parameters

Name	Type	Description
amount	string	Percentage used
nft	string	NFT address to allocate to
chainId	number	chainId of NFT
estimateGas?	G	-

Returns

Promise<ReceiptOrEstimate<G>>

Defined in

contracts/ve/VeAllocate.ts:21

---

setBatchAllocation

▸ setBatchAllocation<G>(amount, nft, chainId, estimateGas?): Promise<ReceiptOrEstimate<G>>

set specific percetage of veOcean to multiple nfts Maximum allocated percentage is 10000, so 1% is specified as 100

Type parameters

Name	Type
G	extends boolean = false

Parameters

Name	Type	Description
amount	string[]	Array of percentages used
nft	string[]	Array of NFT addresses
chainId	number[]	Array of chainIds
estimateGas?	G	-

Returns

Promise<ReceiptOrEstimate<G>>

Defined in

contracts/ve/VeAllocate.ts:51

---

unitsToAmount

▸ Protected unitsToAmount(token, amount, tokenDecimals?): Promise<string>

Converts an amount of units to tokens

Parameters

Name	Type	Description
token	string	The token to convert
amount	string	The amount of units to convert
tokenDecimals?	number	The number of decimals in the token

Returns

Promise<string>

• The converted amount in tokens

Inherited from

SmartContractWithAddress.unitsToAmount

Defined in

contracts/SmartContract.ts:58