CLV EVM is enabled only on CLV Parachain (P-Chain)
| Staking Rate | Inflation to Stakers | Monthly Reward Rate | Yearly Reward Rate |
|---|---|---|---|
| 0% | 2.25% | >125% | >1,500% |
| 5% | 3.25% | 5.42% | 65% |
| 10% | 4% | 3.33% | 40% |
| 20% | 5.5% | 2.29% | 27.5% |
| 25% | 6.25% | 2.08% | 25% |
| 30% | 7% | 1.94% | 23.3% |
| 40% | 8.5% | 1.78% | 21.3% |
| 50% | 10% | 1.67% | 20% |
| 60% | 4.38% | 0.61% | 7.3% |
| 70% | 2.97% | 0.35% | 4.2% |
| 80% | 2.62% | 0.28% | 3.3% |
| 90% | 2.53% | 0.23% | 2.8% |
| 100% | 2.51% | 0.21% | 2.51% |
# 🙋🏻 CLV Chain FAQ ### Is there an "Existential Deposit" for CLV Chain? No, you can keep any amount of $CLV in your wallet without worrying your fund being destroyed. ### What is the TPS of CLV Chain? Estimated TPS is around 1000 transactions per second. ### What is the minimum gas price? 50 gwei ### What is the block gas limit? 30,000,000 gwei ### What is the transaction gas limit? 30,000,000 gwei ### What is the target block time? 12 seconds (expected to be 6 seconds) # $CLV Cross-Chain Explorer CLV Cross-Chain Explorer (
With a self hosted CLV RPC service you could gain below benefits: * Faster access speed - a Self-hosted RPC node could provide better performance * Better security - transactions could be sent to to the self-hosted RPC server instead of the public service. * Better Availability
CLV is a fully decentralized network, anyone can setup a CLV node by following this tutorial! ## :four\_leaf\_clover: Types Of CLV RPC Nodes Generally speaking, there are two kind of RPC nodes:
* **Archive node**\ An archive node keeps all the past blocks data. And client can't query data in any of the past blocks.
* **Full node**\ A full is node is pruned. which means it keeps only a few of the past blocks data (256 by default, which could be adjusted using the `--pruning` command line arguments.
An archive nodes consumes much more disk spaces it stores more data than a full node. You need to take the decision based on your business model and requirements. E.g. block explorer and historical analysis tools normally requires an archive node to query the full historical data. Wallets on the other hand normally only requires a full node to be able to query the current state(e.g. the balance of an account) and submit transactions to the CLV Network. ## :tools: Hardware requirements * **CPU** - Recent released high end cpu, e.g. Intel Core i7-10700/AMD Ryzen 7 5800X or above * **Memory** - 32GB for Testnet, 64GB for Sakura and Mainnet. * **Storage** - 300GB SSD, Storage usage could increase by time, you might need to increase the capacity as the chain data grows.. * **OS**: Linux, Debian/Ubuntu LTS distributions are recommended. ## Prepare Environment We'll use [docker](https://docs.docker.com/engine/) and [docker-compose](https://docs.docker.com/compose/) to run the validator in this guide. You need to install docker and docker-compose firstly. Please follow the installation guide in the docs. * [Docker Install Document](https://docs.docker.com/engine/install/) * [Docker-Compose Install Document](https://docs.docker.com/compose/install/) {% hint style="info" %} We're using docker to simplify the setup process. You can use the tools which you're familiar with. {% endhint %} ### :satellite\_orbital: Firewall Setup Below ports need to be exposed: * **30333** - The p2p port of the chain * ***9933** - The http endpoint of the RPC service* * ***9944** - The websocket endpoint of the RPC service.* {% hint style="info" %} **You may not expose 9933/9944 ports directly.** Instead a reverse proxy server could be setup in front and proxy requests to the rpc backend. {% endhint %} ### :file\_folder: Create Directories Create the config and data directories using below command: ```bash sudo mkdir -p /opt/data/ sudo mkdir -p /opt/compose/ # secure the data access sudo chmod 0700 /opt/data sudo chmod 0700 /opt/compose ``` ## :gear: Setup CLV RPC Node Currently we only have CLV **Testnet**(iris) and CLV **Mainnet**(ivy) launched. Rpc Configuration for CLV Mainnet will be updated later. ### :pencil: Create the Compose configure file Create `/opt/compose/docker-compose.yaml` and set the content as below: ```yaml version: "3.8" services: clover-validator: image: "cloverio/clover-ivy:0.1.15" restart: always command: - /opt/clover/bin/clover - --chain - /opt/specs/clover-preview-iris.json - --base-path - /opt/chaindata - --pruning - archive - --name - 🍀clover-rpc-node - --port - "30333" - --ws-port - "9944" - --rpc-port - "9933" - --rpc-cors=all - --ws-max-connections - "2000" - --ws-external - --rpc-external - --execution - wasm ports: - "30333:30333" - "9933:9933" - "9944:9944" volumes: - /opt/data/clover:/opt/chaindata ``` {% hint style="info" %} You can edit the `docker-compose.yaml` and include your customizations by updating below arguments: * image: the docker image used to launch the node, for CLV Testnet, use `cloverio/clover-iris:0.1.15.` For a full list of clover networks please check out the [Clover Network List](broken://pages/-MYhDyMWo8dJUd4qGMdz) page. * \--*name*: The node name of your validator, the name could be found in the telemetry node list * *--pruning*: we're using the `archive` mode for the pruning argument, which means it will keep all the historical block data. You can provide numeric parameters for it, to let it just keep the provided number of blocks data. * *--ws-extenral/--rpc-external:* it enable the outer access for the RPC service. * `Enabling --execution wasm` will spped up wasm code execution quite a lot, it's recommended for rpc nodes. {% endhint %} ## :rocket: Bring up the RPC node Use below command to bring up the validator node: ```bash cd /opt/compose # goto the compose file directory docker-compose up # bring up the rpc node in the foreground ## check whether the node starts up normally ## Ctrl-C stop the node docker-compose up -d # start the rpc node in the daemon mode. ``` You need to check the node logs using `docker-compose logs` command. Wait until the node is synced and the block numbers syncs with the latest number on the chain. ## :satellite: Post Setup You may want to setup a reverse proxy server or load balancer for the RPC service. There're some known tools for you to start with, please checkout: * [Nginx](https://www.nginx.com/) - High Performance Load Balancer, Web Server, & Reverse Proxy * [Caddy](https://caddyserver.com/) - Powerful, enterprise-ready, open source web server with automatic HTTPS written in Go {% endtab %} {% endtabs %} ## Docker Compose file templates Below are several docker compose file templates for ClV networks. {% tabs %} {% tab title="CLV Mainnet (M-Chain)" %} ```yaml version: "3.8" services: clover-rpc: image: 'cloverio/clover-ivy:0.1.23' restart: always environment: ARGS: "--base-path /opt/chaindata --chain /opt/specs/clover-ivy.json --port 30333 --ws-port 9944 --rpc-port 9933 --pruning archive --name ivy-a-rpc4 --rpc-cors=all --ws-max-connections 5000 --ws-external --rpc-external --wasm-execution compiled" ports: - "9933:9933" - "9944:9944" - "30333:30333" - "9615:9615" volumes: - /opt/data/chains/ivy:/opt/chaindata - /opt/data/config:/opt/config ``` {% endtab %} {% tab title="CLV ParaChain (P-Chain)" %} ```yaml version: "3.3" services: clover-para-node: image: "cloverio/clover-para:polkadot-v0.9.16.1" restart: always command: - /opt/clover/bin/clover - --parachain-id - "2002" - --chain - /opt/specs/clover-para-raw.json - --base-path - /opt/chaindata - --name - clover-para-rpc - --bootnodes - /dns/boot1.para.clover.finance/tcp/40335/ws/p2p/12D3KooWFWYYwimRBexvZokZmNnmSdXcLCz8WmMTHDCAhzm5tLM6 - /dns/boot2.para.clover.finance/tcp/40335/ws/p2p/12D3KooWSvvxYi9nkyGJ17hEjwmytNRMrSsQtSrGsHzUaLTcUUea - --pruning # you can remove the pruning parameter if you don't need a full archive node - archive # - --ws-port - "9946" - --rpc-port - "20194" - --port - "40335" - "--rpc-cors=all" - --rpc-external - --ws-external - --execution - wasm - --ws-max-connections - "5000" - -- - --execution - wasm - --ws-port - "10194" - --rpc-port - "10195" - --chain - polkadot - --port - "30335" ports: - "9946:9946" - "20194:20194" - "40335:40335" - "30335:30335" volumes: - /data/data/chains/bootnode:/opt/chaindata - /data/data/config:/opt/config logging: driver: "json-file" options: max-size: "25m" max-file: "2" ``` {% endtab %} {% endtabs %} # Staking FAQ ### Is there a minimum amount to stake? First, CLV P-Chain does not have staking feature, only CLV M-Chain has. The minimum amount to stake is dynamic. It can move up or down depending on the nominations and the election solutions. Nominators with a stake smaller than this amount may not currently be receiving staking rewards. ### What is the maximum number of delegators per candidate? 256 ### What is the maximum number of delegations per account? 16 ### How long is a period (ERA)? About 6 hours ### What is the bond duration? Next ERA, which means the maximum is 6 hours ### What is the unbond duration? 24 Days ### How is the staking reward distributed? It's distributed by ERA, anyone can make the claim at any time, while CLV will also claim for user once every day automatically. The reward will not be slashed. # 💰 Download CLV Wallet # 📱 CLV Mobile Wallet ## **Getting Started** ### Download CLV Mobile Wallet **Firstly:** do not download CLV Wallet from anywhere other than through the guideline on [official website (https://clv.org/)](https://clv.org/) appropriate to your device/OS. Cloned versions of CLV Wallet are out there that are programmed to record your Secret Recovery Phrase as soon as it's generated. To avoid falling victim to these scams, make sure you download the official CLV Wallet app through the guideline on[ ](https://clv.org/)[the official website (https://clv.org/)](https://clv.org/) , and not from any other source. #### IOS: 1. Open the App Store and hit the search button in the bottom right. Input CLV Wallet into the search bar. 2. Either click 'Get' or tap on the name of the app to see more details. Complete the usual App Store download confirmation process.\  3. Once installed, open the app and follow the prompts to create your wallet. 4. Back up your Secret Recovery Phrase somewhere safe and offline! #### Android: 1. Visit
Counter Example
Current value: n/a
Chain Id
⛓
{chainId ?? 'Not Connected'}
)
}
function App() {
const triedEager = useEagerConnect()
return (
Counter Example
Current value: n/a
` title or somewhere else as you like.
```javascript
Counter Example
Current value: {currentValueText}
);
}
```
Here we create the counter contract using the `useContract` hook. And then we use the `useContractCallData` hook to fetch the `current_value` state from the smart contract.
In the renderer function, we set the current value text to the value on the chain.
Save `App.js` and reload the webpage, you should see the current counter value on the page.
## Write contract state
Now we can work on the inc/dec buttons, we'll add the `onClick` handler to them and call the `inc`/`dec` method correspondingly.
```javascript
function App() {
const triedEager = useEagerConnect()
const counter = useContract(CounterContract)
const [loading, setLoading] = useState(false)
const currentValue = useContractCallData(counter, 'current_value', [])
const currentValueText = (currentValue === undefined || currentValue === null) ? 'N/A' : currentValue
const callMethod = async (name) => {
if (loading) {
return
}
setLoading(true)
try {
await counter[name]()
} catch(ex) {
console.error('transaction error: ', ex)
} finally {
setLoading(false)
}
}
return (
Counter Example
Current value: {currentValueText}
{loading &&
);
}
```
Besides calling the `inc`/`dec`method, we also added a loading state to indicate we're waiting for some operation.
Save `App.js` and reload the webpage.
Click the Inc or Dec button, the sign transaction dialog will show up, click confirm to sign and send the transaction. The current value will be updated after a short while (\~around 10 seconds).
That's it! We've implemented read/write the smart contracts in the DApp.
{% hint style="info" %}
The source code of this chapter could be found at the revision `fc93d686aab`in the [`counter-dapp`](https://github.com/clover-network/example-counter-dapp) source repo.
{% endhint %}
## Conclusion
In this tutorial we completed an e2e DApp development process which includes smart contract development, deployment and setup a frontend application to interact with the smart contract.
There're several things to improve which you can do:
1. The smart contract should send the update when the current value changes.
2. Implement a real time `useBlockNumber` hook
3. The current value was not updated in real time, improve it
4. The loading spinner shows when the `confirm transaction` dialog open, improve it so that it will wait for the transaction completes.
As we only demo a smallest DApp development, some code/functions are not written in a performant style, you should adjust them if you want to use them in a real project.
# Test Cases
In order to make CLV as secure and high performance multi-chain. There are lots of test cases have been made to support.
## EVM Compatibility Tests
### Balance Tests
1. The CLV EVM should provide the same interface for balance transfer and query.
2. The balance transfer should run correctly and related balance updated.
Test cases can be viewed here:
### Block Tests
1. The CLV EVM can return correct genesis block.
2. CLV EVM can support query block by number or hash.
3. The returned block should contain transactions and correct transaction root.
4. The newly generated block should has valid timestamp and includes previous block as parent
Test cases can be viewed here:
### Bloom Tests
The transaction receipt should contains correct bloom data
Test cases can be viewed here:
### Smart Contract Creation Tests
1. Smart contract can be correctly created by CLV EVM.
2. Smart contract creation can return transaction hash.
Test cases can be viewed here:
### Smart Contract Call Tests
1. CLV EVM should support the invoke of smart contract call.
2. The smart contract call should return expected result.
3. The smart contract call should fail in case of invalid parameters.
Test cases can be viewed here:
### Gas Fee Tests
1. CLV EVM should support estimation of gas fee.
2. The gas limit should decrease on next block if gas unused.
3. The estimated gas should be correct for smart contract creation or method call.
Test cases can be viewed here:
### Other Tests
1. CLV EVM should support correct nonce query.
2. CLV EVM should return the revert reason in case of failure.
3. CLV EVM should return a valid transaction receipt for a successful or failed transaction.
Test cases can be viewed here:
## End to End Tests
In order to test the full functionality of CLV EVM, we provide a script which can automatically deploy Uniswap on CLV for one-shot.
1. It can deploy Uniswap ERC20 token to CLV
2. It can deploy Uniswap V2 Factory smart contract to CLV
3. It can deploy WETH ERC20 token to CLV
4. It can deploy Uniswap V2 Router smart contract to CLV
5. It can deploy Multicall smart contract to CLV
Please find the cool script here:
## Complex Gas Fee Tests
CLV EVM is based on Frontier, we find that the gas fee estimation under some cases may fail, such as nested smart contract call. CLV provides a binary search based solution to solve the problem. Please find the details here:
{% embed url="" %}
After the fix, CLV EVM can support all kinds of gas estimation correctly, please find the test case here:
## CLV Account Binding Tests
CLV has a powerful dual-chain architecture, which will empower its users to build their decentralized apps and digital assets on one blockchain (CLV EVM powered) and take advantage of Polkadot chain on the other. Thus CLV account binding is very important, it enables users to do all the staffs under one unified account. Also the bound accounts can share the same balance, as well as the integration of the cool features on the dual-chain.
The related test cases can be found here:
## CLV TPS Tests
In order to test the performance of CLV chain, test cases have been carried out both on EVM and CLV Parachain.
The EVM TPS tests can be found at:
The CLV Parachain tests can be found at:
# Technical Documentations
# CLV EVM
CLV EVM is based on Frontier, but we make a lot of changes to support unique CLV designs and features. Please see the following details.
## New Gas Estimation Feature
CLV EVM is based on Frontier, we find that the gas fee estimation under some cases may fail, such as nested smart contract call. CLV provides a binary search based solution to solve the problem. Please find the details here:
{% embed url="" %}
## New EVM Economic Incentives
In order to make developer easily do the development on CLV. CLV EVM support a new economic incentives. The smart contract owner will receive partial of the transaction fee once their contracts are called. Details are:
* Up to 40% of the transaction fee will be sent to the smart contract owner.
* Up to 60% of the transaction fee will be sent to the miner.
## Other EVM Configurations
CLV change the create\_contract\_limit from 0x6000 to 0xc000, try to reduce the chances that smart contract deployer has to split their big contract for deployment.
# Developers Incentive
The Developer Incentive Program (DIP) is made of two respective implementations, a foundational-layer coinbase rule activation and a following smart contract implementation.
## Coinbase Rule Activation
CLV users contribute to the program indirectly with transaction fees, this is so that a new fee schedule is not committed to the transaction structure itself. Wallet softwares functions the same as usual without breaking backwards compatibility.
The coinbase transaction which spends the block reward and all transaction fees to an address of the validators choosing follows a subsequent transaction where 49 percent of txFee reward is respectively transferred to DIP contract. The amount of total CLV a successful validator can claim for himself is therefore changed from blockReward + txnFees to blockReward + txnFees*51/100.* Whenever a block is propagated, every node will check whether the block adheres to the rules where the sum of all transaction outputs in a block must be equal or smaller than all transaction inputs and the block reward: sum(blockOutputs) ¡ sum(blockInputs) + (blockReward + txnFees51/100) + txnFees\*49/100
## Smart Contract Implementation
External contract registration and reward distribution are done through DIP contract, a trust- less autonomous contract that lives on the CLV parachain. This implementation is made of three main phases; registration, invocation and reward distribution.
### Registration
Third party CLV developers can benefit from the Developer Incentive Program upon registering their compiled contract with DIP contract pre-deployment. An external contract willing to register Developer Incentive Program should include an internal method called transactAndInvokeDIP which is used to trigger reward incrementation, and another internal method called claimRewards which is used to trigger reward settlement.
Right before contract deployment, the respective developer submits contract ABI and contract hexadecimal representation to DIP contract via registerExternalContract method. Given parameters registerExternalContract registers submission upon checking whether the contract is well-formatted and transactAndInvokeDIP is well-structured.
### Invocation
transactAndInvokeDIP adds a new standard to contracts on the CLV network which can be called internally within the external contract with the additional data provided. Whenever a CLV user interacts with a registered external contract, transactAndInvokeDIP invokes DIP contract’s function listenInvokeDIP and triggers an event incrementRewardNonce(address), following the convention set in ERC677.
### Reward Distribution
Registered third party CLV developers can claim their rewards, in a predefined period of time, upon calling internal claimRewards function which triggers a set of events to distribute a portion of associated rewards based on external contract’s reward nonce and DIP contract’s total reward pool from coinbase txFee rewards.
# CLV Accounts Binding
## Why need Account Binding
As explained in this [section](/intro-to-clv/what-is-clv-chain), CLV Parachain is a dual blockchain which support both EVM transactions as well as Polkadot like transactions.
Account binding only happens on CLV Parachain, you can bind your CLV address to a CLV EVM address. Once you bind the accounts, you can use one account to interact with both EVM-based dApps as well as Substrate-based dApps.
Here are the features of CLV accounts binding (suppose you have done the accounts binding, for example bind your CLV address: **5DyCG7icXFuq8WtLd7iLi3umczKf84SAvp7w7Rw44RFEU8Yf** with EVM address: **0xe6206C7f064c7d77C6d8e3eD8601c9AA435419cE**)
1. The above addresses will have the same balance. Other people can send CLV to any of the above account, and you can receive the CLV. At the same time, you can send CLV to other people using any of the above account.
2. If you only have CLV in **0xe6206C7f064c7d77C6d8e3eD8601c9AA435419cE**, you can't deploy or interact with CLV smart contract. Once you bind the account with a EVM address, you are able to deploy and interact with CLV smart contract.
## How to Bind the Account
1. Using CLV Wallet, the version should be above 1.0.3
2. Using the following sample code：
```javascript
const API = require("@polkadot/api")
const Web3 = require("web3")
const web3 = new Web3("https://rpc-2.clover.finance")
const cloverTypes = require('@clover-network/node-types')
const PUB_KEY = "0xe6206C7f064c7d77C6d8e3eD8601c9AA435419cE"
const PRIV_KEY = "0xa504b64992e478a6846670237a68ad89b6e42e90de0490273e28e74f084c03c8"
const CLOVER_SEEDS = "your 12 seed words"
async function run() {
const wsProvider = new API.WsProvider('wss://api-2.clover.finance');
const api = await API.ApiPromise.create({
provider: wsProvider,
types: cloverTypes
});
const keyring = new API.Keyring({ type: 'sr25519' });
const alice = keyring.addFromUri(CLOVER_SEEDS);
let nonce = await api.rpc.system.accountNextIndex(alice.address);
web3.eth.accounts.wallet.add(PRIV_KEY);
let signature = await web3.eth.sign(`clover evm:${web3.utils.bytesToHex(alice.publicKey).slice(2)}`, PUB_KEY);
await api.tx.evmAccounts
.claimAccount(PUB_KEY, web3.utils.hexToBytes(signature))
.signAndSend(alice, {
nonce,
}, ({ events = [], status }) => {
if (status.isFinalized) {
console.log(`${alice.address} has bound with EVM address: ${PUB_KEY}`)
}
});
}
run()
```
�
# Virtual Ethereum Address Binding
CLV and ETH address Binding is mandatory. CLV Chain will check whether the address is bound every time before a user signs. If the address is unbound, the following process will be triggered.
After binding, the CLV assets of the two accounts will be mapped and the data is shared.
# Query Balance
This section shows how to connect to CLV mainnet and query the account balance
## **Prerequisites**
Install @polkadot/api, the suggested version is ^4.15.1 (equal or above 4.15.1)
## Sample code
```javascript
const API = require("@polkadot/api")
const cloverTypes = require('@clover-network/node-types');
async function getBalance(address) {
const wsProvider = new API.WsProvider('wss://api-ivy.clover.finance');
const api = await API.ApiPromise.create({
provider: wsProvider,
types: cloverTypes
});
const { parentHash } = await api.rpc.chain.getHeader();
const {
data: { free: balance },
} = await api.query.system.account.at(parentHash, address);
return balance.toString();
}
getBalance('5DZabq7G2m12g1GUuqs66CCAVcmzdWRkXsGxpi4dgXFEcLEb').then(console.log)
```
Furthermore you may use **formatBalance** from **@polkadot/util** to format the display
�
# Transaction Finality
PolkadotJS API provides **signAndSend** function to send a transaction, the callback will yield information around the transaction pool status as well as any events when `isInBlock` or `isFinalized`. If you receive the `isFinalized` event, then your transaction is considered as finality and will never be reverted.
## Sample Code
```javascript
const API = require("@polkadot/api");
const cloverTypes = require('@clover-network/node-types');
async function sendCLV(address, amount) {
const wsProvider = new API.WsProvider('wss://api-ivy.clover.finance');
const api = await API.ApiPromise.create({
provider: wsProvider,
types: cloverTypes
});
const nonce = await api.rpc.system.accountNextIndex('your CLV address configured somewhere');
const keyring = new API.Keyring({ type: 'sr25519' });
const signer = keyring.addFromUri('your seeds configured somewhere');
return new Promise( (resolve, reject) => {
api.tx.balances
.transfer(address, amount)
.signAndSend(signer, {
nonce,
}, ({ events = [], status }) => {
if (status.isFinalized) {
// filter events and check balances.transfer is succeed
resolve({ success: true });
}
if (status.isDropped || status.isInvalid || status.isUsurped) {
resolve({ success: false });
}
});
});
}
```
# Web3 Compatibility
CLV is also a Polkadot smart contract chain, which has a full compatibility with web3 application.
For developers, please use the following web3 http provider to access CLV chain:
```
const Web3 = require("web3");
const web3 = new Web3("https://rpc.clover.finance");
```
# eth\_protocolVersion
Returns protocol version encoded as a string
```
web3.eth.getProtocolVersion([callback])
```
#### Returns
Promise returns String: the protocol version.
#### Example
```
> web3.eth.getProtocolVersion().then(console.log)
> 1
```
# eth\_syncing
Returns an object with data about the sync status or false
```
web3.eth.isSyncing([callback])
```
#### Returns
A sync object when the node is currently syncing or `false`:
> * `startingBlock` - `Number`: The block number where the sync started.
> * `currentBlock` - `Number`: The block number where the node is currently synced to.
> * `highestBlock` - `Number`: The estimated block number to sync to.
> * `knownStates` - `Number`: The number of estimated states to download.
> * `pulledStates` - `Number`: The number of already downloaded states.
#### Example
```
> web3.eth.isSyncing().then(console.log)
> false
```
# eth\_hashrate
Returns the number of hashes per second that the node is mining with
```
web3.eth.getHashrate([callback])
```
#### Returns
Number of hashes per second
#### Example
```
> web3.eth.getHashrate().then(console.log)
> 0
```
# eth\_coinbase
Returns the coinbase address to which mining rewards will go.
```
web3.eth.getCoinbase([callback])
```
#### Returns
The coinbase address set in the node for mining rewards
#### Example
```
> web3.eth.getCoinbase().then(console.log)
> 0x0000000000000000000000000000000000000000
```
# eth\_mining
Returns true if client is actively mining new blocks
```
web3.eth.isMining([callback])
```
#### Returns
`true` if the node is mining, otherwise `false`
#### Example
```
> web3.eth.isMining().then(console.log)
> true
```
# eth\_chainId
Returns the chain ID used for transaction signing at the current best block. None is returned if not available
```
web3.eth.getChainId([callback])
```
#### Returns
Returns chain ID.
#### Example
```
> web3.eth.getChainId().then(console.log);
> 1023
```
# eth\_gasPrice
Returns the current gas price oracle. The gas price is determined by the last few blocks median gas price.
```
web3.eth.getGasPrice([callback])
```
#### Returns
Number string of the current gas price in wei
#### Example
```
> web3.eth.getGasPrice().then(console.log)
> 1000000000
```
# eth\_accounts
Returns accounts list
```
web3.eth.getAccounts([callback])
```
#### Returns
An array of addresses controlled by node
#### Example
```
> web3.eth.getAccounts().then(console.log)
> [ '0x19E7E376E7C213B7E7e7e46cc70A5dD086DAff2A' ]
```
# eth\_blockNumber
Returns highest block number
```
web3.eth.getBlockNumber([callback])
```
#### Returns
The number of the most recent block.
#### Example
```
> web3.eth.getBlockNumber().then(console.log)
> 114913
```
# eth\_getBalance
Returns balance of the given account
```
web3.eth.getBalance(address [, defaultBlock] [, callback])
```
#### Parameters
1、The address to get the balance of.
2、(optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`,"latest" and `"pending"` can also be used.
3、(optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The current balance for the given address in wei.
#### Example
```
> web3.eth.getBalance("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41").then(console.log)
> 98999296192000000000
```
# eth\_getStorageAt
Returns content of the storage at given address
```
web3.eth.getStorageAt(address, position [, defaultBlock] [, callback]
```
#### Parameters
1、The address to get the storage from.
2、The index position of the storage.
3、(optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used.
4、(optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The value in storage at the given position.
#### Example
```
> web3.eth.getStorageAt("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41", 0).then(console.log)
> 0x0000000000000000000000000000000000000000000000000000000000000000
```
# eth\_getBlock
Returns block with given number
```
web3.eth.getBlock(blockHashOrBlockNumber [, returnTransactionObjects] [, callback])
```
#### Parameters
1. The block number or block hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock).
2. (optional, default `false`) If specified `true`, the returned block will contain all transactions as objects. If `false` it will only contains the transaction hashes.
3. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The block object:
> * `number`: The block number. `null` if a pending block.
> * `hash`: Hash of the block. `null` if a pending block.
> * `parentHash`: Hash of the parent block
> * `sha3Uncles` : SHA3 of the uncles data in the block.
> * `logsBloom`: The bloom filter for the logs of the block. `null` if a pending block.
> * `transactionsRoot`: The root of the transaction trie of the block.
> * `stateRoot` : The root of the final state trie of the block.
> * `miner` : The address of the beneficiary to whom the mining rewards were given.
> * `difficulty` : Integer of the difficulty for this block.
> * `totalDifficulty`: Integer of the total difficulty of the chain until this block.
> * `extraData`: The “extra data” field of this block.
> * `size`: Integer the size of this block in bytes.
> * `gasLimit`: The maximum gas allowed in this block.
> * `gasUsed`: The total used gas by all transactions in this block.
> * `timestamp`: The unix timestamp for when the block was collated.
> * `transactions`: Array of transaction objects, or 32 Bytes transaction hashes depending on the `returnTransactionObjects` parameter.
> * `uncles`: Array of uncle hashes.
> * author ：
> * receiptsRoot ：
> * sealFields ：
>
> #### Example
> ```
> //block number
> > web3.eth.getBlock(43458).then(console.log);
> > {
> author: '0xe4a61e41ac64a0e18c22bc3bf0f0e6c9ded3c08d',
> difficulty: '0',
> extraData: '0x',
> gasLimit: 0,
> gasUsed: 0,
> hash: '0x0098d4eb6ec05bf6a7c727310b64ae9bfe1c5fb3ff57a3449bcededa00858015',
> logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
> miner: '0xE4A61E41ac64a0e18c22bc3bF0F0E6c9DeD3C08d',
> number: 43458,
> parentHash: '0x0dd1bb45074703797fbfcb970df49b17e27f72db05af9784279ded0692bbaafd',
> receiptsRoot: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347',
> sealFields: [
> '0x0000000000000000000000000000000000000000000000000000000000000000',
> '0x0000000000000000'
> ],
> sha3Uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347',
> size: 509,
> stateRoot: '0x341e4f8c138596ef775ee35c82d196b1b97dc5ee2b4c474bff0d0437da9e355c',
> timestamp: 1609917924,
> totalDifficulty: null,
> transactions: [],
> transactionsRoot: '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421',
> uncles: []
> }
> ```
```
//block hash
> web3.eth.getBlock("0x0098d4eb6ec05bf6a7c727310b64ae9bfe1c5fb3ff57a3449bcededa00858015",true).then(console.log)
> {
author: '0xe4a61e41ac64a0e18c22bc3bf0f0e6c9ded3c08d',
difficulty: '0',
extraData: '0x',
gasLimit: 0,
gasUsed: 0,
hash: '0x0098d4eb6ec05bf6a7c727310b64ae9bfe1c5fb3ff57a3449bcededa00858015',
logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
miner: '0xE4A61E41ac64a0e18c22bc3bF0F0E6c9DeD3C08d',
number: 43458,
parentHash: '0x0dd1bb45074703797fbfcb970df49b17e27f72db05af9784279ded0692bbaafd',
receiptsRoot: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347',
sealFields: [
'0x0000000000000000000000000000000000000000000000000000000000000000',
'0x0000000000000000'
],
sha3Uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347',
size: 509,
stateRoot: '0x341e4f8c138596ef775ee35c82d196b1b97dc5ee2b4c474bff0d0437da9e355c',
timestamp: 1609917924,
totalDifficulty: null,
transactions: [],
transactionsRoot: '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421',
uncles: []
}
```
# eth\_getTransactionCount
Returns the number of transactions sent from given address at given time (block number)
```
web3.eth.getTransactionCount(address [, defaultBlock] [, callback])
```
#### Parameters
1. The address to get the numbers of transactions from.
2. (optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used.
3. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The number of transactions sent from the given address.
#### Example
```
> web3.eth.getTransactionCount("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41").then(console.log)
> 12
```
# eth\_getBlockTransactionCount
Returns the number of transactions in a block with given block number
```
web3.eth.getBlockTransactionCount(blockHashOrBlockNumber [, callback])
```
#### Parameters
1. The block number or hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock).
2. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The number of transactions in the given block.
#### Example
```
> web3.eth.getBlockTransactionCount(43458).then(console.log)
> 0
```
# eth\_getBlockUncleCount
Returns the number of uncles in a block with given hash
```
web3.eth.getBlockUncleCount(blockHashOrBlockNumber [, callback])
```
#### Parameters
1. The block number or hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock).
2. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The number of transactions in the given block.
#### Example
```
> web3.eth.getBlockUncleCount(43458).then(console.log)
> 0
```
# eth\_getCode
Returns the code at given address at given time (block number)
```
web3.eth.getCode(address [, defaultBlock] [, callback])
```
#### Parameters
1. The address to get the code from.
2. (optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used.
3. Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The data at given address `address`
#### Example
```
> web3.eth.getCode("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41").then(console.log);
> 0x
```
# eth\_sendTransaction
Sends transaction; will block waiting for signer to return the transaction hash
# eth\_sendSignedTransaction
Sends signed transaction, returning its hash
```
web3.eth.sendSignedTransaction(signedTransactionData [, callback])
```
#### Parameters
1. Signed transaction data in HEX format
2. (optional) Optional callback, returns an error object as first parameter and the result as second
#### Returns
The callback will return the 32 bytes transaction hash.
#### Example
```
> web3.eth.accounts.signTransaction({
from : "0x063eBCD1dB02320814Acc0721e65f14b8755Ff41",
to : "0x69d8fa34508C43C8533a32ab278aDDDE2820556b",
value : web3.utils.toWei('0.1', 'ether'),
gas : web3.utils.toHex(21000),
gasPrice : web3.utils.toWei("1", "gwei"),
nonce : 19
},"e0855c1ec13690c826ee767be03937fa5bce1d621ca780d2ac487574bf8d74d2",function(err,raw){
if(!err){
web3.eth.sendSignedTransaction(raw.rawTransaction, function(error, result){
if(!error){
console.log(result)
}else{
console.log(error)
}
})
}else{
console.log(err)
}
});
> 0x52e5f6347bdbf6fe1d8acb07bb460ce31d82bb36e80acfdc8aca798e28415334
```
# eth\_call
Call contract, returning the output data
```
web3.eth.call(callObject [, defaultBlock] [, callback])
```
#### Parameters
1. A transaction object, see [web3.eth.sendTransaction](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-sendtransaction-return). For calls the `from` property is optional however it is highly recommended to explicitly set it or it may default to address(0) depending on your node or provider.
2. (optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used.
3. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
The returned data of the call, e.g. a smart contract functions return value.
#### Example
```
const abi = JSON.parse('[{\"inputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"constant\":true,\"inputs\":[],\"name\":\"get\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"internalType\":\"string\",\"name\":\"_value\",\"type\":\"string\"}],\"name\":\"set\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]')
bytecode = '0x608060405234801561001057600080fd5b506040518060400160405280600781526020017f6d7956616c7565000000000000000000000000000000000000000000000000008152506000908051906020019061005c929190610062565b50610107565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f106100a357805160ff19168380011785556100d1565b828001600101855582156100d1579182015b828111156100d05782518255916020019190600101906100b5565b5b5090506100de91906100e2565b5090565b61010491905b808211156101005760008160009055506001016100e8565b5090565b90565b61030f806101166000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80634ed3885e1461003b5780636d4ce63c146100f6575b600080fd5b6100f46004803603602081101561005157600080fd5b810190808035906020019064010000000081111561006e57600080fd5b82018360208201111561008057600080fd5b803590602001918460018302840111640100000000831117156100a257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050610179565b005b6100fe610193565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561013e578082015181840152602081019050610123565b50505050905090810190601f16801561016b5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b806000908051906020019061018f929190610235565b5050565b606060008054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561022b5780601f106102005761010080835404028352916020019161022b565b820191906000526020600020905b81548152906001019060200180831161020e57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061027657805160ff19168380011785556102a4565b828001600101855582156102a4579182015b828111156102a3578251825591602001919060010190610288565b5b5090506102b191906102b5565b5090565b6102d791905b808211156102d35760008160009055506001016102bb565b5090565b9056fea265627a7a723158209f9d9ab8ca3378404a8af028da3bb61aa36dd8b9e4847ae0c51ce64fbb32b8b164736f6c63430005110032'
const contract = new web3.eth.Contract(abi)
const transaction = contract.deploy({data: bytecode})
web3.eth.call({
to : account1,
data : transaction.encodeABI()
}, function(error, result) {
if(!error){
console.log(result)
}else{
console.log(error)
}
});
> 0x
```
# eth\_estimateGas
Estimate gas needed for execution of given contract
```
web3.eth.estimateGas(callObject [, callback])
```
#### Parameters
1. A transaction object.
2. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
the used gas for the simulated call/transaction.
#### Example
```
web3.eth.estimateGas({
from : account1,
to : account2
}).then(console.log);
> 21000
```
# eth\_getTransaction
Get transaction by its hash
```
web3.eth.getTransaction(transactionHash [, callback])
```
#### Parameters
1. The transaction hash.
2. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
A transaction object its hash `transactionHash`:
> * `hash`: Hash of the transaction.
> * `nonce`: The number of transactions made by the sender prior to this one.
> * `blockHash`: Hash of the block where this transaction was in. `null` if pending.
> * `blockNumber`: Block number where this transaction was in. `null` if pending.
> * `transactionIndex`: Integer of the transactions index position in the block. `null` if pending.
> * `from`: Address of the sender.
> * `to`: Address of the receiver. `null` if it’s a contract creation transaction.
> * `value`: Value transferred in wei.
> * `gasPrice`: Gas price provided by the sender in wei.
> * `gas` : Gas provided by the sender.
> * `input` : The data sent along with the transaction.
> * `chainId` : chain ID of the current connected node
> * `creates`
> * `piblicKey`
> * `r`: First 32 bytes of the signature
> * `raw`The RLP encoded transaction
> * `s`: Next 32 bytes of the signature
> * `standardV`
> * `v`: Recovery value + 27
>
> #### Example
> ```
> web3.eth.getTransaction('0xe4cb9e145ecefdcccdb033989cef9f371f146a6e3a884b97f4766cc9e7a9d6fe').then(console.log)
> > {
> blockHash: '0xad92691ed2094fcd96d8b7c9afbf5f0516afe786ef3682f40c175bc3038dc04b',
> blockNumber: 73198,
> chainId: '0x539',
> creates: '0x2b6c183c31235f64d954f21105fef3e451a1c57b',
> from: '0x063eBCD1dB02320814Acc0721e65f14b8755Ff41',
> gas: 246904,
> gasPrice: '1000000000',
> hash: '0xe4cb9e145ecefdcccdb033989cef9f371f146a6e3a884b97f4766cc9e7a9d6fe',
> input: '0x608060405234801561001057600080fd5b506040518060400160405280600781526020017f6d7956616c7565000000000000000000000000000000000000000000000000008152506000908051906020019061005c929190610062565b50610107565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f106100a357805160ff19168380011785556100d1565b828001600101855582156100d1579182015b828111156100d05782518255916020019190600101906100b5565b5b5090506100de91906100e2565b5090565b61010491905b808211156101005760008160009055506001016100e8565b5090565b90565b61030f806101166000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80634ed3885e1461003b5780636d4ce63c146100f6575b600080fd5b6100f46004803603602081101561005157600080fd5b810190808035906020019064010000000081111561006e57600080fd5b82018360208201111561008057600080fd5b803590602001918460018302840111640100000000831117156100a257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050610179565b005b6100fe610193565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561013e578082015181840152602081019050610123565b50505050905090810190601f16801561016b5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b806000908051906020019061018f929190610235565b5050565b606060008054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561022b5780601f106102005761010080835404028352916020019161022b565b820191906000526020600020905b81548152906001019060200180831161020e57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061027657805160ff19168380011785556102a4565b828001600101855582156102a4579182015b828111156102a3578251825591602001919060010190610288565b5b5090506102b191906102b5565b5090565b6102d791905b808211156102d35760008160009055506001016102bb565b5090565b9056fea265627a7a723158209f9d9ab8ca3378404a8af028da3bb61aa36dd8b9e4847ae0c51ce64fbb32b8b164736f6c63430005110032',
> nonce: 10,
> publicKey: '0xcddc4fbba9625085aa0facaa028c31b8d78cb554848d18c3d946328b60af60e8a77813a41bde38217bb5745c157e6bc10cd40f41358902e1b916549952f746db',
> r: '0x5723a09fa84a50d5caa4bb995bc22cca68d1fc680bdb46f6d8e500a5e3464587',
> raw: '0xf904790a843b9aca008303c4788080b90425608060405234801561001057600080fd5b506040518060400160405280600781526020017f6d7956616c7565000000000000000000000000000000000000000000000000008152506000908051906020019061005c929190610062565b50610107565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f106100a357805160ff19168380011785556100d1565b828001600101855582156100d1579182015b828111156100d05782518255916020019190600101906100b5565b5b5090506100de91906100e2565b5090565b61010491905b808211156101005760008160009055506001016100e8565b5090565b90565b61030f806101166000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80634ed3885e1461003b5780636d4ce63c146100f6575b600080fd5b6100f46004803603602081101561005157600080fd5b810190808035906020019064010000000081111561006e57600080fd5b82018360208201111561008057600080fd5b803590602001918460018302840111640100000000831117156100a257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050610179565b005b6100fe610193565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561013e578082015181840152602081019050610123565b50505050905090810190601f16801561016b5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b806000908051906020019061018f929190610235565b5050565b606060008054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561022b5780601f106102005761010080835404028352916020019161022b565b820191906000526020600020905b81548152906001019060200180831161020e57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061027657805160ff19168380011785556102a4565b828001600101855582156102a4579182015b828111156102a3578251825591602001919060010190610288565b5b5090506102b191906102b5565b5090565b6102d791905b808211156102d35760008160009055506001016102bb565b5090565b9056fea265627a7a723158209f9d9ab8ca3378404a8af028da3bb61aa36dd8b9e4847ae0c51ce64fbb32b8b164736f6c63430005110032820a96a05723a09fa84a50d5caa4bb995bc22cca68d1fc680bdb46f6d8e500a5e3464587a05bd5d104e1b22f0b34f428996a22d5cd2050d14b6772bec2573c88a6ddc42d81',
> s: '0x5bd5d104e1b22f0b34f428996a22d5cd2050d14b6772bec2573c88a6ddc42d81',
> standardV: '0x1',
> to: null,
> transactionIndex: 0,
> v: '0xa96',
> value: '0'
> }
> ```
# eth\_getTransactionByBlockHashAndIndex
Returns a transaction based on a block hash and the transaction’s index position.
```
web3.eth.getTransactionByBlockHashAndIndex(BlockHash, indexNumber [, callback])
```
#### Parameters
1. A block hash .
2. The transaction’s index position.
3. Optional callback, returns an error object as first parameter and the result as second.
#### Returns
A transaction object its hash `transactionHash`:
> * `hash` : Hash of the transaction.
> * `nonce`: The number of transactions made by the sender prior to this one.
> * `blockHash`: Hash of the block where this transaction was in. `null` if pending.
> * `blockNumber`: Block number where this transaction was in. `null` if pending.
> * `transactionIndex`: Integer of the transactions index position in the block. `null` if pending.
> * `from`: Address of the sender.
> * `to`: Address of the receiver. `null` if it’s a contract creation transaction.
> * `value`: Value transferred in wei.
> * `gasPrice`: Gas price provided by the sender in wei.
> * `gas`: Gas provided by the sender.
> * `input` : The data sent along with the transaction.
#### Example
```
web3.eth.getTransactionByBlockHashAndIndex("0xfb8d7ee8fb5f4fbebf41a55caa5e988a480a0ce277813cd1ec4443c54f601ddd",0).then(console.log)
> {
"blockHash":"0xfb8d7ee8fb5f4fbebf41a55caa5e988a480a0ce277813cd1ec4443c54f601ddd",
"blockNumber":"0x8",
"chainId":"0x539",
"creates":null,
"from":"0xe6206c7f064c7d77c6d8e3ed8601c9aa435419ce",
"gas":"0x5208",
"gasPrice":"0x3b9aca00",
"hash":"0x7893da51d25cad2c10ab946e5b770a21a99b9c9ccff8f595f8222dd9f2e2013b",
"input":"0x",
"nonce":"0x0",
"publicKey":"0x8c9a51a90433508cec6ce29b993284a0e8d0835b38d3ced62216800db588a6d55fa2c114fab798977763ffe94a03b1a591c48d972d4daa6ba7810c80528644f4",
"r":"0x8f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179",
"raw":"0xf86e80843b9aca00825208942193517101eb10ef22f2fa67ef452f66c51839d3896c6b935b8bbd40000080820a96a08f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179a01d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7",
"s":"0x1d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7",
"standardV":"0x1","to":"0x2193517101eb10ef22f2fa67ef452f66c51839d3",
"transactionIndex":"0x0",
"v":"0xa96",
"value":"0x6c6b935b8bbd400000"
}
```
# eth\_getTransactionByBlockNumberAndIndex
Returns a transaction based on a block number and the transaction’s index position.
```
web3.eth.getTransactionByBlockNumberAndIndex(BlockNumber, indexNumber [, callback])
```
#### Parameters
1. A block number .
2. The transaction’s index position.
3. Optional callback, returns an error object as first parameter and the result as second.
#### Returns
A transaction object its hash `transactionHash`:
> * `hash` : Hash of the transaction.
> * `nonce`: The number of transactions made by the sender prior to this one.
> * `blockHash`: Hash of the block where this transaction was in. `null` if pending.
> * `blockNumber`: Block number where this transaction was in. `null` if pending.
> * `transactionIndex`: Integer of the transactions index position in the block. `null` if pending.
> * `from`: Address of the sender.
> * `to`: Address of the receiver. `null` if it’s a contract creation transaction.
> * `value`: Value transferred in wei.
> * `gasPrice`: Gas price provided by the sender in wei.
> * `gas`: Gas provided by the sender.
> * `input` : The data sent along with the transaction.
#### Example
```
web3.eth.getTransactionByBlockNumberAndIndex("0x8",0).then(console.log)
> {
"blockHash":"0xfb8d7ee8fb5f4fbebf41a55caa5e988a480a0ce277813cd1ec4443c54f601ddd",
"blockNumber":"0x8",
"chainId":"0x539",
"creates":null,
"from":"0xe6206c7f064c7d77c6d8e3ed8601c9aa435419ce",
"gas":"0x5208",
"gasPrice":"0x3b9aca00",
"hash":"0x7893da51d25cad2c10ab946e5b770a21a99b9c9ccff8f595f8222dd9f2e2013b",
"input":"0x",
"nonce":"0x0",
"publicKey":"0x8c9a51a90433508cec6ce29b993284a0e8d0835b38d3ced62216800db588a6d55fa2c114fab798977763ffe94a03b1a591c48d972d4daa6ba7810c80528644f4",
"r":"0x8f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179",
"raw":"0xf86e80843b9aca00825208942193517101eb10ef22f2fa67ef452f66c51839d3896c6b935b8bbd40000080820a96a08f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179a01d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7",
"s":"0x1d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7",
"standardV":"0x1","to":"0x2193517101eb10ef22f2fa67ef452f66c51839d3",
"transactionIndex":"0x0",
"v":"0xa96",
"value":"0x6c6b935b8bbd400000"
}
```
# eth\_getTransactionReceipt
Returns transaction receipt by transaction hash
```
web3.eth.getTransactionReceipt(hash [, callback])
```
#### Parameters
1. The transaction hash.
2. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
A transaction receipt object, or `null` if no receipt was found:
> * `status`: `TRUE` if the transaction was successful, `FALSE` if the EVM reverted the transaction.
> * `blockHash`: Hash of the block where this transaction was in.
> * `blockNumber`: Block number where this transaction was in.
> * `transactionHash`: Hash of the transaction.
> * `transactionIndex`: Integer of the transactions index position in the block.
> * `from`: Address of the sender.
> * `to`: Address of the receiver. `null` when it’s a contract creation transaction.
> * `contractAddress`: The contract address created, if the transaction was a contract creation, otherwise `null`.
> * `cumulativeGasUsed`: The total amount of gas used when this transaction was executed in the block.
> * `gasUsed`: The amount of gas used by this specific transaction alone.
> * `logs`: Array of log objects, which this transaction generated.
> * `internalTransactions`:
> * `logsBloom`:
>
> #### Example
> ```
> web3.eth.getTransactionReceipt('0x6d7d750cea87c11ade7852ce02a0a10617f1877995591057f99f66c4d9a350a3').then(console.log)
> > {
> blockHash: '0x79275dcda076bd6d07774318ae7cd74b9f7141b4e6242b1501b2ca25edb35684',
> blockNumber: 54550,
> contractAddress: null,
> cumulativeGasUsed: 21000,
> from: '0x063ebcd1db02320814acc0721e65f14b8755ff41',
> gasUsed: 21000,
> internalTransactions: [
> {
> developer: null,
> developerReward: null,
> from: '0x063ebcd1db02320814acc0721e65f14b8755ff41',
> gasUsed: '0x0',
> to: '0x69d8fa34508c43c8533a32ab278addde2820556b'
> }
> ],
> logs: [],
> logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
> status: true,
> to: '0x69d8fa34508c43c8533a32ab278addde2820556b',
> transactionHash: '0x6d7d750cea87c11ade7852ce02a0a10617f1877995591057f99f66c4d9a350a3',
> transactionIndex: 0
> }
> ```
>
> ####
# eth\_getUncle
Returns an uncles at given block and index
```
web3.eth.getUncle(blockHashOrBlockNumber, uncleIndex [, returnTransactionObjects] [, callback])
```
#### Parameters
1. The block number or hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock).
2. The index position of the uncle.
3. (optional, default `false`) If specified `true`, the returned block will contain all transactions as objects. By default it is `false` so, there is no need to explictly specify false. And, if `false` it will only contains the transaction hashes.
4. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
the returned uncle
```
```
# eth\_getLogs
Returns logs matching given filter object
# eth\_getWork
Returns the hash of the current block, the seedHash, and the boundary condition to be met
```
web3.eth.getWork([callback])
```
#### Parameters
1. (optional) Optional callback, returns an error object as first parameter and the result as second.
#### Returns
the mining work with the following structure:
> * current block header pow-hash
> * the seed hash used for the DAG.
> * the boundary condition (“target”), 2^256 / difficulty.
>
> #### Example
```
web3.eth.getWork().then(console.log)
> [
'0x0000000000000000000000000000000000000000000000000000000000000000',
'0x0000000000000000000000000000000000000000000000000000000000000000',
'0x0000000000000000000000000000000000000000000000000000000000000000'
]
```
# eth\_submitWork
Used for submitting a proof-of-work solution
# eth\_submitHashrate
Used for submitting mining hashrate
# eth\_subscribe
Subscribe to Eth subscription
# eth\_unsubscribe
Unsubscribe from existing Eth subscription
# net\_version
Returns the current network id
```
web3.net.version
```
**Parameters**
none
**Returns**
The current network id.
**Example**
```
var version = web3.net.version;
console.log(version);
> 1023
```
# net\_peerCount
Returns number of peers connected to node
```
web3.net.peerCount
```
#### Parameters
none
#### Returns
The number of other Ethereum nodes connected to the node.
#### Example
```
var peerCount = web3.net.peerCount;
console.log(peerCount);
> 5
```
# net\_listening
Returns true if client is actively listening for network connections. Otherwise false
```
web3.eth.net.Listening
```
#### Parameters
none
#### Returns
returns `Boolean：`that the connected node is listening for network requests.
#### Example
```
const Listening = web3.net.Listening
console.log(Listening);
> true
```
# web3\_clientVersion
Returns current client version
```
web3.clientVersion
```
#### Returns
The current version.
#### Example
```
const clientVersion = web3.clientVersion
console.log(clientVersion)
> clover/v11.1/fc-rpc-0.1.0-clover
```
# web3\_sha3
Returns sha3 of the given data
```
web3.sha3(SHA3hash)
```
**Parameters**
the data to convert into a SHA3 hash
**Returns**
The SHA3 result of the given string
**Example**
```
const sha3 = web3.sha3("0x68656c6c6f20776f726c64");
console.log(sha3)
> 0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad
```
# CLV P-Chain Integration
## Evm Chain Information
Clover P-Chain is an EVM-compatible network which means ecosystem partners can use the standard web3 protocol to integrate with CLV P-Chain.
The Chain Id of CLV P-Chain is **1024 (0x400 in hex)**.
The minimum accepted gas price is **50 Gwei** currently, please make sure to the gas price is no less than **50Gwei** to send a transaction.
## Public RPC endpoints
Below are a list of public RPC endpoints for CLV P-Chain.
| Provider | RPC URL |
| -------------- | ---------------------------------- |
| CLV foundation |
{/* <...> */}
```
Then, initialize cloverConnector, which could be used as connector to connect to Clover Extension Wallet.
```javascript
const cloverConnector = new CloverConnector({ supportedChainIds: [1, 3] })
```
At last, we could use cloverConnector to connect to and communicate with the wallet
```javascript
const { activate, deactivate, library, account, error } = useWeb3React()
useEffect(() => {
activate(cloverConnector, async (error) => {
if (error instanceof UnsupportedChainIdError) {
setToast('error', 'Unsupported chain id')
} else {
if (error instanceof NoEthereumProviderError) {
setToast('error', 'No provider was found')
} else if (
error instanceof UserRejectedRequestErrorInjected
) {
setToast('error', 'Please authorize to access your account')
} else {
setToast('error', error.message)
}
}
})
}, [activate])
useEffect(() => {
const send = async () => {
if (account !== undefined) {
const chainId = '0x3';
const transaction = {
nonce: '0x05',
to: account,
from: account,
value: '0x2386f26fc10000',
chainId: chainId,
};
const txHash = await library.request({
method: 'eth_sendTransaction',
params: [transaction],
});
}
}
send()
}, [account, library])
```
# Substrate dApp Integration
CLV Extension Wallet uses method '**injectExtension**' of **@polkadot/extension-inject** to inject an object into dApp's web page, and dApp can invoke the wallet by calling web3Enable(). The sample code is as follows:
```typescript
import { web3Accounts, web3Enable } from '@polkadot/extension-dapp';
// find clover extension wallet injector
const findCloverInjected = async () => {
const injected = await web3Enable('clv');
if (!injected.length) {
return {
message: "Not found wallet",
status: 'error'
};
}
const cloverInjector = injected.find(injected, (w) => isCloverWallet(w))
return cloverInjector
}
// sign message
const polkadotSignMessage = async () => {
const polkadotAddress = await web3Accounts({ ss58Format: 42 });
const wrapped = u8aWrapBytes(polkadotAddress.toLowerCase());
const ret = await currentInjected.signer.signRaw({
data: u8aToHex(wrapped),
address: polkadotAddress,
type: "bytes",
});
}
// send transaction
polkadotSignTransaction = async () => {
const wsProvider = new WsProvider('wss://rpc.polkadot.io');
const api = await ApiPromise.create({provider: wsProvider});
const polkadotAddress = await web3Accounts({ ss58Format: 42 });
const currentClvAccount = polkadotAddress
const injected = await web3FromAddress(currentClvAccount)
api.setSigner(injected.signer)
const unsub = await api.tx.balances
.transfer(currentClvAccount, 0)
.signAndSend(currentClvAccount, (result) => {
if (result.status.isInBlock) {
// in block
} else if (result.status.isFinalized) {
unsub();
}
})
}
```
# Solana dApp Integration
Once CLV extension wallet is installed, it will inject the following to window object:
```
window.clover_solana = {
isCloverWallet: true,
getAccount: async() => {...}
signTransaction: async (paload) => {...}
}
```
dApps can use the above injected object to integrate with CLV extension wallet.
## dApp Development Documents
### RPC document
" %}
### Web3 JS (create transactions in frontend)
{% embed url="" %}
# Kadena dApp Integration
CLV extension wallet will inject clover\_kadena to window object, dApp could use it to integrate with CLV extension wallet.
```
window.clover_kadena = {
isCloverWallet: true,
getAccount: async ()=> {...},
sign: async (paload) => {...}
}
```
## Sample Code
Below is an example for dApp to integrate CLV extension wallet
```
signKdaTransaction = async () => {
if (!window.clover_kadena) {
this.console('wallet not injected!')
}
var mkReq = function(cmd) {
return {
headers: {
"Content-Type": "application/json"
},
method: "POST",
body: JSON.stringify(cmd)
};
};
try {
const account = await window.clover_kadena.getAccount()
await new Promise((resolve) => setTimeout(resolve, 3000))
const signCmd = {
pactCode: `(free.hello-world.set-message ${JSON.stringify('hello test')})`,
caps: [
Pact.lang.mkCap("Gas capability", "description of gas cap", "coin.GAS", []).cap,
],
sender: account,
gasLimit: 10000,
chainId: "0",
ttl: 28800,
envData: {}
}
const result = await window.clover_kadena.sign(signCmd)
const txRes = await fetch(`https://api.testnet.chainweb.com/chainweb/0.0/testnet04/chain/0/pact/api/v1/send`, mkReq(result));
const tx = await txRes.json();
} catch (e) {
console.log(e)
}
}
```
# Aptos dApp Integration
## Install CLV Wallet
To use CLV Wallet for your Aptos dApp, your users need to install [CLV Wallet Chrome extension](https://chrome.google.com/webstore/detail/clv-wallet/nhnkbkgjikgcigadomkphalanndcapjk) in their browser. CLV Wallet injects an clover\_aptos object into the [window](https://developer.mozilla.org/en-US/docs/Web/API/Window) of any dApp that the user visits.
To check whether the user has installed CLV Wallet, please use the following check:
```javascript
const isCLVInstalled = window.clover_aptos
```
If CLV Wallet is not installed, you can navigate user to install CLV Wallet first. For example
const getCLVWallet = () => {
if ('clover_aptos' in window) {
return window.clover_aptos;
} else {
window.open('https://clv.org/?type=wallet', `_blank`);
}
}
## Connect to CLV Wallet
After clover\_aptos object is injected into the dApp, we can connect to CLV Wallet by calling wallet.connect(). When this function is called, it will prompt user a dialog to approve or reject the interactions between your web app and CLV Wallet. Once connection is approved, you can easily get user's current wallet address. Sample code:
```javascript
const wallet = getCLVWallet();
try {
const response = await wallet.connect();
console.log(response); // { address: string, publicKey: string }
const account = await wallet.account();
console.log(account); // { address: string, publicKey: string }
} catch (error) {
// { code: 500, message: "The request was cancelled."}
}
```
## Disconnect CLV Wallet
If you want the dApp to disconnect from CLV Wallet, you should just call wallet.disconnect().
```javascript
await wallet.disconnect();
```
## Transaction Signing
Once your dApp is connected with CLV Wallet, it can prompt to user to sign and send transactions to the Aptos blockchain.
### Case 1: Sign and Submit
```javascript
const wallet = getCLVWallet();
const transaction = {
arguments: [address, '1'],
function: '0x1::coin::transfer',
type: 'entry_function_payload',
type_arguments: ['0x1::aptos_coin::MyCoin'],
};
try {
const tx = await wallet.signAndSubmitTransaction(transaction);
console.log(tx.hash); // this is the transaction hash
return tx;
} catch (error) {
// see "Errors"
}
```
### Case 2: Sign only
```javascript
const wallet = getAptosWallet(); // see "Connecting"
// Example Transaction
const transaction = {
arguments: [address, '1'],
function: '0x1::coin::transfer',
type: 'entry_function_payload',
type_arguments: ['0x1::aptos_coin::MyCoin'],
};
try {
const signTransaction = await wallet.signTransaction(transaction);
console.log(signTransaction); // Uint8Arry for signed transaction
} catch (error) {
// see "Errors"
}
```
## Message Signing
A dApp can call wallet.signMessage(payload: SignMessagePayload) to sign a message using CLV Wallet.
The above function call will return Promise\
# Wallet Integration QA
## Asset Integration
if you need your blockchain assets supported by CLV Wallet, please provide the javascript SDK for your blockchain. For example:
| Assets | SDK | Description |
| ------ | --------------- | ----------- |
| DOT | @polkadot/api | |
| SOL | @solana/web3.js | |
| ... | | |
If your chain is EVM compatible, you only need to provide the following information:
* Chain ID
* Chain RPC
* Native Token Symbol
* Native Token Decimal
## dApp Integration
If your dApp is a Solana dApp, please refer to the following integration demo:
{% embed url="" %}
If your dApp is a EVM compatible dApp, please refer to the following integration demo:
{% embed url="" %}
# 🏞️ Ecosystem Partners
# CLV Chain
### DEX & Lending
SeasonSwap -
Counter Example
Current value: {currentValueText}
Counter Example
Current value: {currentValueText}
{loading &&# Query Balance This section shows how to connect to CLV mainnet and query the account balance ## **Prerequisites** Install @polkadot/api, the suggested version is ^4.15.1 (equal or above 4.15.1) ## Sample code ```javascript const API = require("@polkadot/api") const cloverTypes = require('@clover-network/node-types'); async function getBalance(address) { const wsProvider = new API.WsProvider('wss://api-ivy.clover.finance'); const api = await API.ApiPromise.create({ provider: wsProvider, types: cloverTypes }); const { parentHash } = await api.rpc.chain.getHeader(); const { data: { free: balance }, } = await api.query.system.account.at(parentHash, address); return balance.toString(); } getBalance('5DZabq7G2m12g1GUuqs66CCAVcmzdWRkXsGxpi4dgXFEcLEb').then(console.log) ``` Furthermore you may use **formatBalance** from **@polkadot/util** to format the display � # Transaction Finality PolkadotJS API provides **signAndSend** function to send a transaction, the callback will yield information around the transaction pool status as well as any events when `isInBlock` or `isFinalized`. If you receive the `isFinalized` event, then your transaction is considered as finality and will never be reverted. ## Sample Code ```javascript const API = require("@polkadot/api"); const cloverTypes = require('@clover-network/node-types'); async function sendCLV(address, amount) { const wsProvider = new API.WsProvider('wss://api-ivy.clover.finance'); const api = await API.ApiPromise.create({ provider: wsProvider, types: cloverTypes }); const nonce = await api.rpc.system.accountNextIndex('your CLV address configured somewhere'); const keyring = new API.Keyring({ type: 'sr25519' }); const signer = keyring.addFromUri('your seeds configured somewhere'); return new Promise( (resolve, reject) => { api.tx.balances .transfer(address, amount) .signAndSend(signer, { nonce, }, ({ events = [], status }) => { if (status.isFinalized) { // filter events and check balances.transfer is succeed resolve({ success: true }); } if (status.isDropped || status.isInvalid || status.isUsurped) { resolve({ success: false }); } }); }); } ``` # Web3 Compatibility CLV is also a Polkadot smart contract chain, which has a full compatibility with web3 application. For developers, please use the following web3 http provider to access CLV chain: ``` const Web3 = require("web3"); const web3 = new Web3("https://rpc.clover.finance"); ``` # eth\_protocolVersion Returns protocol version encoded as a string ``` web3.eth.getProtocolVersion([callback]) ``` #### Returns Promise returns String: the protocol version. #### Example ``` > web3.eth.getProtocolVersion().then(console.log) > 1 ``` # eth\_syncing Returns an object with data about the sync status or false ``` web3.eth.isSyncing([callback]) ``` #### Returns A sync object when the node is currently syncing or `false`: > * `startingBlock` - `Number`: The block number where the sync started. > * `currentBlock` - `Number`: The block number where the node is currently synced to. > * `highestBlock` - `Number`: The estimated block number to sync to. > * `knownStates` - `Number`: The number of estimated states to download. > * `pulledStates` - `Number`: The number of already downloaded states. #### Example ``` > web3.eth.isSyncing().then(console.log) > false ``` # eth\_hashrate Returns the number of hashes per second that the node is mining with ``` web3.eth.getHashrate([callback]) ``` #### Returns Number of hashes per second #### Example ``` > web3.eth.getHashrate().then(console.log) > 0 ``` # eth\_coinbase Returns the coinbase address to which mining rewards will go. ``` web3.eth.getCoinbase([callback]) ``` #### Returns The coinbase address set in the node for mining rewards #### Example ``` > web3.eth.getCoinbase().then(console.log) > 0x0000000000000000000000000000000000000000 ``` # eth\_mining Returns true if client is actively mining new blocks ``` web3.eth.isMining([callback]) ``` #### Returns `true` if the node is mining, otherwise `false` #### Example ``` > web3.eth.isMining().then(console.log) > true ``` # eth\_chainId Returns the chain ID used for transaction signing at the current best block. None is returned if not available ``` web3.eth.getChainId([callback]) ``` #### Returns Returns chain ID. #### Example ``` > web3.eth.getChainId().then(console.log); > 1023 ``` # eth\_gasPrice Returns the current gas price oracle. The gas price is determined by the last few blocks median gas price. ``` web3.eth.getGasPrice([callback]) ``` #### Returns Number string of the current gas price in wei #### Example ``` > web3.eth.getGasPrice().then(console.log) > 1000000000 ``` # eth\_accounts Returns accounts list ``` web3.eth.getAccounts([callback]) ``` #### Returns An array of addresses controlled by node #### Example ``` > web3.eth.getAccounts().then(console.log) > [ '0x19E7E376E7C213B7E7e7e46cc70A5dD086DAff2A' ] ``` # eth\_blockNumber Returns highest block number ``` web3.eth.getBlockNumber([callback]) ``` #### Returns The number of the most recent block. #### Example ``` > web3.eth.getBlockNumber().then(console.log) > 114913 ``` # eth\_getBalance Returns balance of the given account ``` web3.eth.getBalance(address [, defaultBlock] [, callback]) ``` #### Parameters 1、The address to get the balance of. 2、(optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`,"latest" and `"pending"` can also be used. 3、(optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns The current balance for the given address in wei. #### Example ``` > web3.eth.getBalance("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41").then(console.log) > 98999296192000000000 ``` # eth\_getStorageAt Returns content of the storage at given address ``` web3.eth.getStorageAt(address, position [, defaultBlock] [, callback] ``` #### Parameters 1、The address to get the storage from. 2、The index position of the storage. 3、(optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used. 4、(optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns The value in storage at the given position. #### Example ``` > web3.eth.getStorageAt("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41", 0).then(console.log) > 0x0000000000000000000000000000000000000000000000000000000000000000 ``` # eth\_getBlock Returns block with given number ``` web3.eth.getBlock(blockHashOrBlockNumber [, returnTransactionObjects] [, callback]) ``` #### Parameters 1. The block number or block hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). 2. (optional, default `false`) If specified `true`, the returned block will contain all transactions as objects. If `false` it will only contains the transaction hashes. 3. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns The block object: > * `number`: The block number. `null` if a pending block. > * `hash`: Hash of the block. `null` if a pending block. > * `parentHash`: Hash of the parent block > * `sha3Uncles` : SHA3 of the uncles data in the block. > * `logsBloom`: The bloom filter for the logs of the block. `null` if a pending block. > * `transactionsRoot`: The root of the transaction trie of the block. > * `stateRoot` : The root of the final state trie of the block. > * `miner` : The address of the beneficiary to whom the mining rewards were given. > * `difficulty` : Integer of the difficulty for this block. > * `totalDifficulty`: Integer of the total difficulty of the chain until this block. > * `extraData`: The “extra data” field of this block. > * `size`: Integer the size of this block in bytes. > * `gasLimit`: The maximum gas allowed in this block. > * `gasUsed`: The total used gas by all transactions in this block. > * `timestamp`: The unix timestamp for when the block was collated. > * `transactions`: Array of transaction objects, or 32 Bytes transaction hashes depending on the `returnTransactionObjects` parameter. > * `uncles`: Array of uncle hashes. > * author ： > * receiptsRoot ： > * sealFields ： > > #### Example > ``` > //block number > > web3.eth.getBlock(43458).then(console.log); > > { > author: '0xe4a61e41ac64a0e18c22bc3bf0f0e6c9ded3c08d', > difficulty: '0', > extraData: '0x', > gasLimit: 0, > gasUsed: 0, > hash: '0x0098d4eb6ec05bf6a7c727310b64ae9bfe1c5fb3ff57a3449bcededa00858015', > logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', > miner: '0xE4A61E41ac64a0e18c22bc3bF0F0E6c9DeD3C08d', > number: 43458, > parentHash: '0x0dd1bb45074703797fbfcb970df49b17e27f72db05af9784279ded0692bbaafd', > receiptsRoot: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347', > sealFields: [ > '0x0000000000000000000000000000000000000000000000000000000000000000', > '0x0000000000000000' > ], > sha3Uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347', > size: 509, > stateRoot: '0x341e4f8c138596ef775ee35c82d196b1b97dc5ee2b4c474bff0d0437da9e355c', > timestamp: 1609917924, > totalDifficulty: null, > transactions: [], > transactionsRoot: '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421', > uncles: [] > } > ``` ``` //block hash > web3.eth.getBlock("0x0098d4eb6ec05bf6a7c727310b64ae9bfe1c5fb3ff57a3449bcededa00858015",true).then(console.log) > { author: '0xe4a61e41ac64a0e18c22bc3bf0f0e6c9ded3c08d', difficulty: '0', extraData: '0x', gasLimit: 0, gasUsed: 0, hash: '0x0098d4eb6ec05bf6a7c727310b64ae9bfe1c5fb3ff57a3449bcededa00858015', logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', miner: '0xE4A61E41ac64a0e18c22bc3bF0F0E6c9DeD3C08d', number: 43458, parentHash: '0x0dd1bb45074703797fbfcb970df49b17e27f72db05af9784279ded0692bbaafd', receiptsRoot: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347', sealFields: [ '0x0000000000000000000000000000000000000000000000000000000000000000', '0x0000000000000000' ], sha3Uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347', size: 509, stateRoot: '0x341e4f8c138596ef775ee35c82d196b1b97dc5ee2b4c474bff0d0437da9e355c', timestamp: 1609917924, totalDifficulty: null, transactions: [], transactionsRoot: '0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421', uncles: [] } ``` # eth\_getTransactionCount Returns the number of transactions sent from given address at given time (block number) ``` web3.eth.getTransactionCount(address [, defaultBlock] [, callback]) ``` #### Parameters 1. The address to get the numbers of transactions from. 2. (optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used. 3. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns The number of transactions sent from the given address. #### Example ``` > web3.eth.getTransactionCount("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41").then(console.log) > 12 ``` # eth\_getBlockTransactionCount Returns the number of transactions in a block with given block number ``` web3.eth.getBlockTransactionCount(blockHashOrBlockNumber [, callback]) ``` #### Parameters 1. The block number or hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). 2. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns The number of transactions in the given block. #### Example ``` > web3.eth.getBlockTransactionCount(43458).then(console.log) > 0 ``` # eth\_getBlockUncleCount Returns the number of uncles in a block with given hash ``` web3.eth.getBlockUncleCount(blockHashOrBlockNumber [, callback]) ``` #### Parameters 1. The block number or hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). 2. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns The number of transactions in the given block. #### Example ``` > web3.eth.getBlockUncleCount(43458).then(console.log) > 0 ``` # eth\_getCode Returns the code at given address at given time (block number) ``` web3.eth.getCode(address [, defaultBlock] [, callback]) ``` #### Parameters 1. The address to get the code from. 2. (optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used. 3. Optional callback, returns an error object as first parameter and the result as second. #### Returns The data at given address `address` #### Example ``` > web3.eth.getCode("0x063eBCD1dB02320814Acc0721e65f14b8755Ff41").then(console.log); > 0x ``` # eth\_sendTransaction Sends transaction; will block waiting for signer to return the transaction hash # eth\_sendSignedTransaction Sends signed transaction, returning its hash ``` web3.eth.sendSignedTransaction(signedTransactionData [, callback]) ``` #### Parameters 1. Signed transaction data in HEX format 2. (optional) Optional callback, returns an error object as first parameter and the result as second #### Returns The callback will return the 32 bytes transaction hash. #### Example ``` > web3.eth.accounts.signTransaction({ from : "0x063eBCD1dB02320814Acc0721e65f14b8755Ff41", to : "0x69d8fa34508C43C8533a32ab278aDDDE2820556b", value : web3.utils.toWei('0.1', 'ether'), gas : web3.utils.toHex(21000), gasPrice : web3.utils.toWei("1", "gwei"), nonce : 19 },"e0855c1ec13690c826ee767be03937fa5bce1d621ca780d2ac487574bf8d74d2",function(err,raw){ if(!err){ web3.eth.sendSignedTransaction(raw.rawTransaction, function(error, result){ if(!error){ console.log(result) }else{ console.log(error) } }) }else{ console.log(err) } }); > 0x52e5f6347bdbf6fe1d8acb07bb460ce31d82bb36e80acfdc8aca798e28415334 ``` # eth\_call Call contract, returning the output data ``` web3.eth.call(callObject [, defaultBlock] [, callback]) ``` #### Parameters 1. A transaction object, see [web3.eth.sendTransaction](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-sendtransaction-return). For calls the `from` property is optional however it is highly recommended to explicitly set it or it may default to address(0) depending on your node or provider. 2. (optional) If you pass this parameter it will not use the default block set with [web3.eth.defaultBlock](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). Pre-defined block numbers as `"earliest"`, `"latest"` and `"pending"` can also be used. 3. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns The returned data of the call, e.g. a smart contract functions return value. #### Example ``` const abi = JSON.parse('[{\"inputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"},{\"constant\":true,\"inputs\":[],\"name\":\"get\",\"outputs\":[{\"internalType\":\"string\",\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"internalType\":\"string\",\"name\":\"_value\",\"type\":\"string\"}],\"name\":\"set\",\"outputs\":[],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}]') bytecode = '0x608060405234801561001057600080fd5b506040518060400160405280600781526020017f6d7956616c7565000000000000000000000000000000000000000000000000008152506000908051906020019061005c929190610062565b50610107565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f106100a357805160ff19168380011785556100d1565b828001600101855582156100d1579182015b828111156100d05782518255916020019190600101906100b5565b5b5090506100de91906100e2565b5090565b61010491905b808211156101005760008160009055506001016100e8565b5090565b90565b61030f806101166000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80634ed3885e1461003b5780636d4ce63c146100f6575b600080fd5b6100f46004803603602081101561005157600080fd5b810190808035906020019064010000000081111561006e57600080fd5b82018360208201111561008057600080fd5b803590602001918460018302840111640100000000831117156100a257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050610179565b005b6100fe610193565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561013e578082015181840152602081019050610123565b50505050905090810190601f16801561016b5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b806000908051906020019061018f929190610235565b5050565b606060008054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561022b5780601f106102005761010080835404028352916020019161022b565b820191906000526020600020905b81548152906001019060200180831161020e57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061027657805160ff19168380011785556102a4565b828001600101855582156102a4579182015b828111156102a3578251825591602001919060010190610288565b5b5090506102b191906102b5565b5090565b6102d791905b808211156102d35760008160009055506001016102bb565b5090565b9056fea265627a7a723158209f9d9ab8ca3378404a8af028da3bb61aa36dd8b9e4847ae0c51ce64fbb32b8b164736f6c63430005110032' const contract = new web3.eth.Contract(abi) const transaction = contract.deploy({data: bytecode}) web3.eth.call({ to : account1, data : transaction.encodeABI() }, function(error, result) { if(!error){ console.log(result) }else{ console.log(error) } }); > 0x ``` # eth\_estimateGas Estimate gas needed for execution of given contract ``` web3.eth.estimateGas(callObject [, callback]) ``` #### Parameters 1. A transaction object. 2. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns the used gas for the simulated call/transaction. #### Example ``` web3.eth.estimateGas({ from : account1, to : account2 }).then(console.log); > 21000 ``` # eth\_getTransaction Get transaction by its hash ``` web3.eth.getTransaction(transactionHash [, callback]) ``` #### Parameters 1. The transaction hash. 2. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns A transaction object its hash `transactionHash`: > * `hash`: Hash of the transaction. > * `nonce`: The number of transactions made by the sender prior to this one. > * `blockHash`: Hash of the block where this transaction was in. `null` if pending. > * `blockNumber`: Block number where this transaction was in. `null` if pending. > * `transactionIndex`: Integer of the transactions index position in the block. `null` if pending. > * `from`: Address of the sender. > * `to`: Address of the receiver. `null` if it’s a contract creation transaction. > * `value`: Value transferred in wei. > * `gasPrice`: Gas price provided by the sender in wei. > * `gas` : Gas provided by the sender. > * `input` : The data sent along with the transaction. > * `chainId` : chain ID of the current connected node > * `creates` > * `piblicKey` > * `r`: First 32 bytes of the signature > * `raw`The RLP encoded transaction > * `s`: Next 32 bytes of the signature > * `standardV` > * `v`: Recovery value + 27 > > #### Example > ``` > web3.eth.getTransaction('0xe4cb9e145ecefdcccdb033989cef9f371f146a6e3a884b97f4766cc9e7a9d6fe').then(console.log) > > { > blockHash: '0xad92691ed2094fcd96d8b7c9afbf5f0516afe786ef3682f40c175bc3038dc04b', > blockNumber: 73198, > chainId: '0x539', > creates: '0x2b6c183c31235f64d954f21105fef3e451a1c57b', > from: '0x063eBCD1dB02320814Acc0721e65f14b8755Ff41', > gas: 246904, > gasPrice: '1000000000', > hash: '0xe4cb9e145ecefdcccdb033989cef9f371f146a6e3a884b97f4766cc9e7a9d6fe', > input: '0x608060405234801561001057600080fd5b506040518060400160405280600781526020017f6d7956616c7565000000000000000000000000000000000000000000000000008152506000908051906020019061005c929190610062565b50610107565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f106100a357805160ff19168380011785556100d1565b828001600101855582156100d1579182015b828111156100d05782518255916020019190600101906100b5565b5b5090506100de91906100e2565b5090565b61010491905b808211156101005760008160009055506001016100e8565b5090565b90565b61030f806101166000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80634ed3885e1461003b5780636d4ce63c146100f6575b600080fd5b6100f46004803603602081101561005157600080fd5b810190808035906020019064010000000081111561006e57600080fd5b82018360208201111561008057600080fd5b803590602001918460018302840111640100000000831117156100a257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050610179565b005b6100fe610193565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561013e578082015181840152602081019050610123565b50505050905090810190601f16801561016b5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b806000908051906020019061018f929190610235565b5050565b606060008054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561022b5780601f106102005761010080835404028352916020019161022b565b820191906000526020600020905b81548152906001019060200180831161020e57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061027657805160ff19168380011785556102a4565b828001600101855582156102a4579182015b828111156102a3578251825591602001919060010190610288565b5b5090506102b191906102b5565b5090565b6102d791905b808211156102d35760008160009055506001016102bb565b5090565b9056fea265627a7a723158209f9d9ab8ca3378404a8af028da3bb61aa36dd8b9e4847ae0c51ce64fbb32b8b164736f6c63430005110032', > nonce: 10, > publicKey: '0xcddc4fbba9625085aa0facaa028c31b8d78cb554848d18c3d946328b60af60e8a77813a41bde38217bb5745c157e6bc10cd40f41358902e1b916549952f746db', > r: '0x5723a09fa84a50d5caa4bb995bc22cca68d1fc680bdb46f6d8e500a5e3464587', > raw: '0xf904790a843b9aca008303c4788080b90425608060405234801561001057600080fd5b506040518060400160405280600781526020017f6d7956616c7565000000000000000000000000000000000000000000000000008152506000908051906020019061005c929190610062565b50610107565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f106100a357805160ff19168380011785556100d1565b828001600101855582156100d1579182015b828111156100d05782518255916020019190600101906100b5565b5b5090506100de91906100e2565b5090565b61010491905b808211156101005760008160009055506001016100e8565b5090565b90565b61030f806101166000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c80634ed3885e1461003b5780636d4ce63c146100f6575b600080fd5b6100f46004803603602081101561005157600080fd5b810190808035906020019064010000000081111561006e57600080fd5b82018360208201111561008057600080fd5b803590602001918460018302840111640100000000831117156100a257600080fd5b91908080601f016020809104026020016040519081016040528093929190818152602001838380828437600081840152601f19601f820116905080830192505050505050509192919290505050610179565b005b6100fe610193565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561013e578082015181840152602081019050610123565b50505050905090810190601f16801561016b5780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b806000908051906020019061018f929190610235565b5050565b606060008054600181600116156101000203166002900480601f01602080910402602001604051908101604052809291908181526020018280546001816001161561010002031660029004801561022b5780601f106102005761010080835404028352916020019161022b565b820191906000526020600020905b81548152906001019060200180831161020e57829003601f168201915b5050505050905090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f1061027657805160ff19168380011785556102a4565b828001600101855582156102a4579182015b828111156102a3578251825591602001919060010190610288565b5b5090506102b191906102b5565b5090565b6102d791905b808211156102d35760008160009055506001016102bb565b5090565b9056fea265627a7a723158209f9d9ab8ca3378404a8af028da3bb61aa36dd8b9e4847ae0c51ce64fbb32b8b164736f6c63430005110032820a96a05723a09fa84a50d5caa4bb995bc22cca68d1fc680bdb46f6d8e500a5e3464587a05bd5d104e1b22f0b34f428996a22d5cd2050d14b6772bec2573c88a6ddc42d81', > s: '0x5bd5d104e1b22f0b34f428996a22d5cd2050d14b6772bec2573c88a6ddc42d81', > standardV: '0x1', > to: null, > transactionIndex: 0, > v: '0xa96', > value: '0' > } > ``` # eth\_getTransactionByBlockHashAndIndex Returns a transaction based on a block hash and the transaction’s index position. ``` web3.eth.getTransactionByBlockHashAndIndex(BlockHash, indexNumber [, callback]) ``` #### Parameters 1. A block hash . 2. The transaction’s index position. 3. Optional callback, returns an error object as first parameter and the result as second. #### Returns A transaction object its hash `transactionHash`: > * `hash` : Hash of the transaction. > * `nonce`: The number of transactions made by the sender prior to this one. > * `blockHash`: Hash of the block where this transaction was in. `null` if pending. > * `blockNumber`: Block number where this transaction was in. `null` if pending. > * `transactionIndex`: Integer of the transactions index position in the block. `null` if pending. > * `from`: Address of the sender. > * `to`: Address of the receiver. `null` if it’s a contract creation transaction. > * `value`: Value transferred in wei. > * `gasPrice`: Gas price provided by the sender in wei. > * `gas`: Gas provided by the sender. > * `input` : The data sent along with the transaction. #### Example ``` web3.eth.getTransactionByBlockHashAndIndex("0xfb8d7ee8fb5f4fbebf41a55caa5e988a480a0ce277813cd1ec4443c54f601ddd",0).then(console.log) > { "blockHash":"0xfb8d7ee8fb5f4fbebf41a55caa5e988a480a0ce277813cd1ec4443c54f601ddd", "blockNumber":"0x8", "chainId":"0x539", "creates":null, "from":"0xe6206c7f064c7d77c6d8e3ed8601c9aa435419ce", "gas":"0x5208", "gasPrice":"0x3b9aca00", "hash":"0x7893da51d25cad2c10ab946e5b770a21a99b9c9ccff8f595f8222dd9f2e2013b", "input":"0x", "nonce":"0x0", "publicKey":"0x8c9a51a90433508cec6ce29b993284a0e8d0835b38d3ced62216800db588a6d55fa2c114fab798977763ffe94a03b1a591c48d972d4daa6ba7810c80528644f4", "r":"0x8f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179", "raw":"0xf86e80843b9aca00825208942193517101eb10ef22f2fa67ef452f66c51839d3896c6b935b8bbd40000080820a96a08f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179a01d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7", "s":"0x1d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7", "standardV":"0x1","to":"0x2193517101eb10ef22f2fa67ef452f66c51839d3", "transactionIndex":"0x0", "v":"0xa96", "value":"0x6c6b935b8bbd400000" } ``` # eth\_getTransactionByBlockNumberAndIndex Returns a transaction based on a block number and the transaction’s index position. ``` web3.eth.getTransactionByBlockNumberAndIndex(BlockNumber, indexNumber [, callback]) ``` #### Parameters 1. A block number . 2. The transaction’s index position. 3. Optional callback, returns an error object as first parameter and the result as second. #### Returns A transaction object its hash `transactionHash`: > * `hash` : Hash of the transaction. > * `nonce`: The number of transactions made by the sender prior to this one. > * `blockHash`: Hash of the block where this transaction was in. `null` if pending. > * `blockNumber`: Block number where this transaction was in. `null` if pending. > * `transactionIndex`: Integer of the transactions index position in the block. `null` if pending. > * `from`: Address of the sender. > * `to`: Address of the receiver. `null` if it’s a contract creation transaction. > * `value`: Value transferred in wei. > * `gasPrice`: Gas price provided by the sender in wei. > * `gas`: Gas provided by the sender. > * `input` : The data sent along with the transaction. #### Example ``` web3.eth.getTransactionByBlockNumberAndIndex("0x8",0).then(console.log) > { "blockHash":"0xfb8d7ee8fb5f4fbebf41a55caa5e988a480a0ce277813cd1ec4443c54f601ddd", "blockNumber":"0x8", "chainId":"0x539", "creates":null, "from":"0xe6206c7f064c7d77c6d8e3ed8601c9aa435419ce", "gas":"0x5208", "gasPrice":"0x3b9aca00", "hash":"0x7893da51d25cad2c10ab946e5b770a21a99b9c9ccff8f595f8222dd9f2e2013b", "input":"0x", "nonce":"0x0", "publicKey":"0x8c9a51a90433508cec6ce29b993284a0e8d0835b38d3ced62216800db588a6d55fa2c114fab798977763ffe94a03b1a591c48d972d4daa6ba7810c80528644f4", "r":"0x8f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179", "raw":"0xf86e80843b9aca00825208942193517101eb10ef22f2fa67ef452f66c51839d3896c6b935b8bbd40000080820a96a08f59b2e2a2a07e82067fea3903402a30e7a78176e50827678075271decd19179a01d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7", "s":"0x1d0c193a99e5ecce21a40ff18e20e0bf4e1751e5308b3e09acc42d0a53b4b3d7", "standardV":"0x1","to":"0x2193517101eb10ef22f2fa67ef452f66c51839d3", "transactionIndex":"0x0", "v":"0xa96", "value":"0x6c6b935b8bbd400000" } ``` # eth\_getTransactionReceipt Returns transaction receipt by transaction hash ``` web3.eth.getTransactionReceipt(hash [, callback]) ``` #### Parameters 1. The transaction hash. 2. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns A transaction receipt object, or `null` if no receipt was found: > * `status`: `TRUE` if the transaction was successful, `FALSE` if the EVM reverted the transaction. > * `blockHash`: Hash of the block where this transaction was in. > * `blockNumber`: Block number where this transaction was in. > * `transactionHash`: Hash of the transaction. > * `transactionIndex`: Integer of the transactions index position in the block. > * `from`: Address of the sender. > * `to`: Address of the receiver. `null` when it’s a contract creation transaction. > * `contractAddress`: The contract address created, if the transaction was a contract creation, otherwise `null`. > * `cumulativeGasUsed`: The total amount of gas used when this transaction was executed in the block. > * `gasUsed`: The amount of gas used by this specific transaction alone. > * `logs`: Array of log objects, which this transaction generated. > * `internalTransactions`: > * `logsBloom`: > > #### Example > ``` > web3.eth.getTransactionReceipt('0x6d7d750cea87c11ade7852ce02a0a10617f1877995591057f99f66c4d9a350a3').then(console.log) > > { > blockHash: '0x79275dcda076bd6d07774318ae7cd74b9f7141b4e6242b1501b2ca25edb35684', > blockNumber: 54550, > contractAddress: null, > cumulativeGasUsed: 21000, > from: '0x063ebcd1db02320814acc0721e65f14b8755ff41', > gasUsed: 21000, > internalTransactions: [ > { > developer: null, > developerReward: null, > from: '0x063ebcd1db02320814acc0721e65f14b8755ff41', > gasUsed: '0x0', > to: '0x69d8fa34508c43c8533a32ab278addde2820556b' > } > ], > logs: [], > logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000', > status: true, > to: '0x69d8fa34508c43c8533a32ab278addde2820556b', > transactionHash: '0x6d7d750cea87c11ade7852ce02a0a10617f1877995591057f99f66c4d9a350a3', > transactionIndex: 0 > } > ``` > > #### # eth\_getUncle Returns an uncles at given block and index ``` web3.eth.getUncle(blockHashOrBlockNumber, uncleIndex [, returnTransactionObjects] [, callback]) ``` #### Parameters 1. The block number or hash. Or the string `"earliest"`, `"latest"` or `"pending"` as in the [default block parameter](https://web3js.readthedocs.io/en/v1.3.0/web3-eth.html#eth-defaultblock). 2. The index position of the uncle. 3. (optional, default `false`) If specified `true`, the returned block will contain all transactions as objects. By default it is `false` so, there is no need to explictly specify false. And, if `false` it will only contains the transaction hashes. 4. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns the returned uncle ``` ``` # eth\_getLogs Returns logs matching given filter object # eth\_getWork Returns the hash of the current block, the seedHash, and the boundary condition to be met ``` web3.eth.getWork([callback]) ``` #### Parameters 1. (optional) Optional callback, returns an error object as first parameter and the result as second. #### Returns the mining work with the following structure: > * current block header pow-hash > * the seed hash used for the DAG. > * the boundary condition (“target”), 2^256 / difficulty. > > #### Example ``` web3.eth.getWork().then(console.log) > [ '0x0000000000000000000000000000000000000000000000000000000000000000', '0x0000000000000000000000000000000000000000000000000000000000000000', '0x0000000000000000000000000000000000000000000000000000000000000000' ] ``` # eth\_submitWork Used for submitting a proof-of-work solution # eth\_submitHashrate Used for submitting mining hashrate # eth\_subscribe Subscribe to Eth subscription # eth\_unsubscribe Unsubscribe from existing Eth subscription # net\_version Returns the current network id ``` web3.net.version ``` **Parameters** none **Returns** The current network id. **Example** ``` var version = web3.net.version; console.log(version); > 1023 ``` # net\_peerCount Returns number of peers connected to node ``` web3.net.peerCount ``` #### Parameters none #### Returns The number of other Ethereum nodes connected to the node. #### Example ``` var peerCount = web3.net.peerCount; console.log(peerCount); > 5 ``` # net\_listening Returns true if client is actively listening for network connections. Otherwise false ``` web3.eth.net.Listening ``` #### Parameters none #### Returns returns `Boolean：`that the connected node is listening for network requests. #### Example ``` const Listening = web3.net.Listening console.log(Listening); > true ``` # web3\_clientVersion Returns current client version ``` web3.clientVersion ``` #### Returns The current version. #### Example ``` const clientVersion = web3.clientVersion console.log(clientVersion) > clover/v11.1/fc-rpc-0.1.0-clover ``` # web3\_sha3 Returns sha3 of the given data ``` web3.sha3(SHA3hash) ``` **Parameters** the data to convert into a SHA3 hash **Returns** The SHA3 result of the given string **Example** ``` const sha3 = web3.sha3("0x68656c6c6f20776f726c64"); console.log(sha3) > 0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad ``` # CLV P-Chain Integration ## Evm Chain Information Clover P-Chain is an EVM-compatible network which means ecosystem partners can use the standard web3 protocol to integrate with CLV P-Chain. The Chain Id of CLV P-Chain is **1024 (0x400 in hex)**. The minimum accepted gas price is **50 Gwei** currently, please make sure to the gas price is no less than **50Gwei** to send a transaction. ## Public RPC endpoints Below are a list of public RPC endpoints for CLV P-Chain. | Provider | RPC URL | | -------------- | ---------------------------------- | | CLV foundation |
const getCLVWallet = () => {
if ('clover_aptos' in window) {
return window.clover_aptos;
} else {
window.open('https://clv.org/?type=wallet', `_blank`);
}
}