Godwoken network banner

Godwoken L2 Network

Introduction

Godwoken is an L2 network running on the Nervos blockchain. It is an Ethereum-compatible layer inside of an optimistic rollup, which allows for low cost, high speed transactions with a familiar user and developer experience.

  • Compatibility with Ethereum: developers are able to run Ethereum contracts and utilize Ethereum tooling with minimal changes

  • Diverse wallet support: The Nervos “Universal Passport” allows users to interact with Ethereum applications using familiar wallets, such as Metamask or TRON wallet

  • Scalability and flexibility: moving computation off of the Nervos blockchain allows low cost contract execution and allows developers to make use of widely deployed and audited Solidity smart contracts

Quick facts

Property Value
Godwoken Mainnet chainId 71402
Godwoken Testnet chainId 71401
Godwoken Blockchain Explorer https://v1.gwscan.com/
Block time ~1 minute

Supported endpoints

Get token balances for address
Class A
Given chain_id and wallet address, return current token balances along with their spot prices. This endpoint supports a variety of token standards like ERC20, ERC721 and ERC1155. As a special case, network native tokens like ETH on Ethereum are also returned even though it’s not a token contract.
GET
/v1/:chain_id/address/:address/balances_v2/
`
Get transactions for address
Class A
Given chain_id and wallet address, return all transactions along with their decoded log events. This endpoint does a deep-crawl of the blockchain to retrieve all kinds of transactions that references the address including indexed topics within the event logs.
GET
/v1/:chain_id/address/:address/transactions_v2/
Get ERC20 token transfers for address
Class A
Given chain_id, wallet address and contract-address, return all ERC20 token contract transfers along with their historical prices at the time of their transfer.
GET
/v1/:chain_id/address/:address/transfers_v2/
Get token holders as of any block height
Class A
Given chain_id and wallet address, return a paginated list of token holders. If block-height is omitted, the latest block is used.
GET
/v1/:chain_id/tokens/:address/token_holders/
Get log events by contract address
Class A
Given chain_id and contract address, return a paginated list of decoded log events emitted by a particular smart contract.
GET
/v1/:chain_id/events/address/:address/
Get log events by topic hash(es)
Class A
Given chain_id and topic hash(es), return a paginated list of decoded log events with one or more topic hashes separated by a comma.
GET
/v1/:chain_id/events/topics/:topic/

Go to Covalent’s API Reference


Appendix

CKByte token

The CKByte token CKB is the native token of the Nervos Network including Godwoken. This is similar to Ether in Ethereum. To interact with the Godwoken Network, CKB tokens are required to pay gas fees. The Covalent API response returns gas_* fields in fiat units.

Node Provider

https://docs.ankr.com/nodes/nervos

Last modified: September 21, 2022: Update postman collection URL (5744f29)