Class: RETH ​

Rocket Pool RETH Token Manager

Hierarchy ​

• ERC20

  ↳ RETH

Constructors ​

constructor ​

• new RETH(web3, contracts)

Create a new rETH instance.

Parameters ​

Overrides ​

ERC20.constructor

Defined in ​

rocketpool/tokens/reth.ts:19

Properties ​

web3 ​

• Protected web3: default

Inherited from ​

ERC20.web3

contracts ​

• Protected contracts: Contracts

Inherited from ​

ERC20.contracts

tokenContractName ​

• Protected tokenContractName: string

Inherited from ​

ERC20.tokenContractName

Accessors ​

tokenContract ​

• Protected get tokenContract(): Promise<Contract>

Private accessor use to retrieve the related contract

Returns ​

Promise<Contract>

a Promise<Contract> with a web3.eth.contract instance of the contract passed into the constructor

Defined in ​

rocketpool/tokens/erc20.ts:25

Methods ​

balanceOf ​

▸ balanceOf(account): Promise<string>

Return the token balance of an account

example using Typescript const account = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";

const balance = rp.tokens.rpl.balanceOf(account).then((val: string) => { val };

const balance = rp.tokens.rpl.balanceOf(account).then((val: string) => { val };

Parameters ​

Returns ​

Promise<string>

a Promise<string> that resolves to a string representing the token balance in Wei

Inherited from ​

ERC20.balanceOf

Defined in ​

rocketpool/tokens/erc20.ts:40

allowance ​

▸ allowance(account, spender): Promise<string>

Return the token allowance for an account

example using Typescript const account = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294"; const contractAddress = rp.api.contracts.get("rocketTokenRPL").then((val: string) => { contract.options.address };

const balance = rp.tokens.rpl.allowance(account, contractAddress).then((val: string) => { val };

const balance = rp.tokens.rpl.allowance(account, contractAddress).then((val: string) => { val };

Parameters ​

Returns ​

Promise<string>

a Promise<string> that resolves to a string representing the token balance in Wei

Inherited from ​

ERC20.allowance

Defined in ​

rocketpool/tokens/erc20.ts:59

transfer ​

▸ transfer(to, amountWei, options?, onConfirmation?): Promise<TransactionReceipt>

Transfer tokens to an account to a recipient if approved

example using Typescript

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const toAddress = "0x421433c3f99529A704Ec2270E1A68fa66DD8bD79";
const amountWei = web3.utils.toWei("20", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.rpl.transfer(toAddress, amountWei, options).then((txReceipt: TransactionReceipt) => { txReceipt };

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const toAddress = "0x421433c3f99529A704Ec2270E1A68fa66DD8bD79";
const amountWei = web3.utils.toWei("20", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.rpl.transfer(toAddress, amountWei, options).then((txReceipt: TransactionReceipt) => { txReceipt };

Parameters ​

Returns ​

Promise<TransactionReceipt>

a Promise<TransactionReceipt> that resolves to a TransactionReceipt object representing the receipt of the transaction

Inherited from ​

ERC20.transfer

Defined in ​

rocketpool/tokens/erc20.ts:85

approve ​

▸ approve(spender, amountWei, options?, onConfirmation?): Promise<TransactionReceipt>

Approve an allowance for a spender

example using Typescript

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const contractAddress = rp.api.contracts.get("rocketTokenRPL").then((val: string) => { contract.options.address };
const amountWei = web3.utils.toWei("20", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.rpl.approve(contractAddress, amountWei, options).then((txReceipt: TransactionReceipt) => { txReceipt };

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const contractAddress = rp.api.contracts.get("rocketTokenRPL").then((val: string) => { contract.options.address };
const amountWei = web3.utils.toWei("20", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.rpl.approve(contractAddress, amountWei, options).then((txReceipt: TransactionReceipt) => { txReceipt };

Parameters ​

Returns ​

Promise<TransactionReceipt>

a Promise<TransactionReceipt> that resolves to a TransactionReceipt object representing the receipt of the transaction

Inherited from ​

ERC20.approve

Defined in ​

rocketpool/tokens/erc20.ts:111

transferFrom ​

▸ transferFrom(from, to, amountWei, options?, onConfirmation?): Promise<TransactionReceipt>

Transfer tokens from an account to a recipient if approved

example using Typescript

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const toAddress = "0x421433c3f99529A704Ec2270E1A68fa66DD8bD79";
const amountWei = web3.utils.toWei("20", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.rpl.transferFrom(from, to, options).then((txReceipt: TransactionReceipt) => { txReceipt };

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const toAddress = "0x421433c3f99529A704Ec2270E1A68fa66DD8bD79";
const amountWei = web3.utils.toWei("20", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.rpl.transferFrom(from, to, options).then((txReceipt: TransactionReceipt) => { txReceipt };

Parameters ​

Returns ​

Promise<TransactionReceipt>

a Promise<TransactionReceipt> that resolves to a TransactionReceipt object representing the receipt of the transaction

Inherited from ​

ERC20.transferFrom

Defined in ​

rocketpool/tokens/erc20.ts:138

getEthValue ​

▸ getEthValue(rethAmountWei): Promise<string>

Get the amount of ETH backing an amount of rETH

params rethAmountWei a string representing the rETH amount in Wei

example using Typescript

const rethAmountWei = web3.utils.toWei("1", "ether");
const ethValue = rp.tokens.reth.getEthValue(rethAmountWei).then((val: string) => { val };

const rethAmountWei = web3.utils.toWei("1", "ether");
const ethValue = rp.tokens.reth.getEthValue(rethAmountWei).then((val: string) => { val };

Parameters ​

Returns ​

Promise<string>

a Promise<string> that resolves to a string representing the amount amount of rETH backing an amount of ETH

Defined in ​

rocketpool/tokens/reth.ts:34

getRethValue ​

▸ getRethValue(ethAmountWei): Promise<string>

Get the amount of rETH backing an amount of ETH

params ethAmountWei a string representing the ETH amount in Wei

example using Typescript

const ethAmountWei = web3.utils.toWei("1", "ether");
const rethValue = rp.tokens.reth.getRethValue(ethAmountWei).then((val: string) => { val };

const ethAmountWei = web3.utils.toWei("1", "ether");
const rethValue = rp.tokens.reth.getRethValue(ethAmountWei).then((val: string) => { val };

Parameters ​

Returns ​

Promise<string>

a Promise<string> that resolves to a string representing the amount amount of rETH backing an amount of ETH

Defined in ​

rocketpool/tokens/reth.ts:51

getExchangeRate ​

▸ getExchangeRate(): Promise<number>

Get the current ETH to rETH exchange rate

example using Typescript

const exchangeRate = rp.tokens.reth.getTotalCollateral().then((val: number) => { val };

const exchangeRate = rp.tokens.reth.getTotalCollateral().then((val: number) => { val };

Returns ​

Promise<number>

a Promise<number> that resolves to a number representing the amount of ETH backing 1 rETH

Defined in ​

rocketpool/tokens/reth.ts:66

getTotalCollateral ​

▸ getTotalCollateral(): Promise<string>

Get the total amount of ETH collateral available

example using Typescript

const totalCollateral = rp.tokens.reth.getTotalCollateral().then((val: string) => { val };

const totalCollateral = rp.tokens.reth.getTotalCollateral().then((val: string) => { val };

Returns ​

Promise<string>

a Promise<string> that resolves to a string representing the portion of rETH backed by ETH in the contract as a fraction

Defined in ​

rocketpool/tokens/reth.ts:81

getCollateralRate ​

▸ getCollateralRate(): Promise<number>

Get the current ETH collateral rate

example using Typescript

const rate = rp.tokens.reth.getCollateralRate().then((val: number) => { val };

const rate = rp.tokens.reth.getCollateralRate().then((val: number) => { val };

Returns ​

Promise<number>

a Promise<number> that resolves to a number representing the portion of rETH backed by ETH in the contract as a fraction

Defined in ​

rocketpool/tokens/reth.ts:96

getTotalSupply ​

▸ getTotalSupply(): Promise<number>

Get the total supply

example using Typescript

const supply = rp.tokens.reth.totalSupply().then((val: number) => { val };

const supply = rp.tokens.reth.totalSupply().then((val: number) => { val };

Returns ​

Promise<number>

a Promise<number> that resolves to a number representing the total supply

Defined in ​

rocketpool/tokens/reth.ts:111

burn ​

▸ burn(amountWei, options?, onConfirmation?): Promise<TransactionReceipt>

Burn rETH for ETH

example using Typescript

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const amountWei = web3.utils.toWei("1", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.reth.burn(amountWei, options).then((txReceipt: TransactionReceipt) => { txReceipt };

const fromAddress = "0x24fBeD7Ecd625D3f0FD19a6c9113DEd436172294";
const amountWei = web3.utils.toWei("1", "ether");
const options = {
		from: fromAddress,
		gas: 1000000
};
const txReceipt = rp.tokens.reth.burn(amountWei, options).then((txReceipt: TransactionReceipt) => { txReceipt };

Parameters ​

Returns ​

Promise<TransactionReceipt>

a Promise<TransactionReceipt> that resolves to a TransactionReceipt object representing the receipt of the transaction

Defined in ​

rocketpool/tokens/reth.ts:135