FuturesChain Integration documentation

Integration guide for Cronos Mainnet Beta

Setup Guide

RPC URLs for Cronos mainnet Beta

:::danger Public RPCs URL Updates: The Cronos RPC endpoints have been lately updated (shown as below) and it is recommended for users to update the endpoints. The old endpoints are still available for compatibility but maybe deprecated later. :::

:::tip Request Limits on Public RPCs: To provide a stable experience to users, there is a request rate limit on the public RPCs to ensure fair usage. If your application requires a higher usage, please consider setting up your own nodes. You can also reach out to us on Discord for assistance. :::

:::tip Public RPCs Integration Tips: There are more than one machines serving the public RPC services. There is no guarantee that you are served by the same machine every time. This could break the assumptions of some applications. For example when you want to broadcast multiple transactions in sequential account nonce at once, each transactions may arrive on different machines if you are not broadcasting them in a batch.

If this assumption is important in your application, please consider setting up your own nodes. :::

  1. Tendermint RPC

  2. Cosmos RESTful

  3. Cosmos gRPC Based

  4. EVM HTTP JSON RPC (Web3 compatible)

Official token contract addresses for Cronos mainnet Beta

Below is the preview of the complete list of the official token contract addresses.

Token nameAddressDecimal
WCRO0x5C7F8A570d578ED84E63fdFA7b1eE72dEae1AE2318
WETH0xe44Fd7fCb2b1581822D0c862B68222998a0c299a18
WBTC0x062E66477Faf219F25D27dCED647BF57C3107d528
USDC0xc21223249CA28397B4B6541dfFaEcC539BfF0c596
USDT0x66e428c3f67a68878562e79A0234c1F83c2087706
DAI0xF2001B145b43032AAF5Ee2884e456CCd805F677D18

Integration guide for Cronos Testnet

Setup Guide

RPC URLs for For Cronos testnet

:::tip The Cronos Testnet RPC endpoints have been lately updated shown as below and it is recommanded for users to update the endpoints, while the old endpoints will still be compatible. :::

  1. Cosmos RPC

    • https://rpc-t3.cronos.org/
  2. gRPC Based

    • https://grpc-t3.cronos.org/
  3. Cosmos RESTful

    • https://rest-t3.cronos.org/
  4. EVM HTTP JSON RPC

    • https://evm-t3.cronos.org/

Mock token contract addresses for Cronos testnet

Token nameaddressdecimal
WCRO0x6a3173618859C7cd40fAF6921b5E9eB6A76f1fD418
WETH0x796135E94527c38433e9c42f4Cd91ca931E5e6A618
WBTC0xEE200f25d7B1B9518AC944fd60b113d39bee209c8
USDC0x25f0965F285F03d6F6B3B21c8EC3367412Fd0ef66
USDT0xa144617Afd9205AF1ceDE3Cc671da1a409A82c5a6
DAI0x8662A8111daEC7570a1bDF3dbd3E163d4156390418

API Clients and libraries

Ethereum type JSON-RPC Methods

Pre-requisite Readings

Below is a list of Ethereum type JSON-RPC Methods where users can curl via local node. While you can also surf to our swagger playground for a better understanding.

JSON-RPC Methods

MethodNamespaceImplementedPublic
web3_clientVersionWeb3
web3_sha3Web3
net_versionNet
net_peerCountNet
net_listeningNet
eth_protocolVersionEth
eth_syncingEth
eth_gasPriceEth
eth_accountsEth
eth_blockNumberEth
eth_getBalanceEth
eth_getStorageAtEth
eth_getTransactionCountEth
eth_getBlockTransactionCountByNumberEth
eth_getBlockTransactionCountByHashEth
eth_getCodeEth
eth_signEth
eth_sendTransactionEth
eth_sendRawTransactionEth
eth_callEth
eth_estimateGasEth
eth_getBlockByNumberEth
eth_getBlockByHashEth
eth_getTransactionByHashEth
eth_getTransactionByBlockHashAndIndexEth
eth_getTransactionReceiptEth
eth_newFilterEth
eth_newBlockFilterEth
eth_newPendingTransactionFilterEth
eth_uninstallFilterEth
eth_getFilterChangesEth
eth_getFilterLogsEth
eth_getLogsEth
eth_getTransactionbyBlockNumberAndIndexEth
eth_submitHashrateEth
eth_getCompilersEth
eth_compileLLLEth
eth_compileSolidityEth
eth_compileSerpentEth
eth_signTransactionEth
eth_coinbaseEth
eth_getProofEth
eth_subscribeWebsocket
eth_unsubscribeWebsocket

:::tip Block Number can be entered as a Hex string, "earliest", "latest" or "pending". ::: :::tip While the examples below make use of local node http://localhost:8545, users may also use our public full node: https://evm-t3.cronos.org:8545/ :::

JSON-RPC namespaces

Pre-requisite Readings

Ethereum Namespaces

NamespaceDescriptionSupportedEnabled by Default
ethCronos provides several extensions to the standard eth JSON-RPC namespace.
web3The web3 API provides utility functions for the web3 client.
netThe net API provides access to network information of the node
cliqueThe clique API provides access to the state of the clique consensus engine. You can use this API to manage signer votes and to check the health of a private network.
debugThe debug API gives you access to several non-standard RPC methods, which will allow you to inspect, debug and set certain debugging flags during runtime.
lesThe les API allows you to manage LES server settings, including client parameters and payment settings for prioritized clients. It also provides functions to query checkpoint information in both server and client mode.
minerThe miner API allows you to remote control the node’s mining operation and set various mining specific settings.
txpoolThe txpool API gives you access to several non-standard RPC methods to inspect the contents of the transaction pool containing all the currently pending transactions as well as the ones queued for future processing.
adminThe admin API gives you access to several non-standard RPC methods, which will allow you to have a fine grained control over your nodeinstance, including but not limited to network peer and RPC endpoint management.
personalThe personal API manages private keys in the key store.

Block Explorer

Creating API Keys on CronoScan

The CronoScan Developer APIs are designed to provide accessible and consistent Cronos data to the Cronos community. The APIs are provided as a community service with a rate up to 5 calls per second per IP. Users need to register for a CronoScan account to create an API key. After registration, a CronoScan user account will have a quota of up to 3 API keys.

On the CronoScan user dashboard, select “API-KEYs” from the left-hand side column or go to https://cronoscan.com/myapikey.

drawing

Click on the “Create a new API-KEY token” button, then optionally input an “AppName”, “My Cronos App” for example.

drawing

After the “API-KEY Token” is successfully created, a message will show up as below, and you may now use the “API key token” for your applications on Cronos!

drawing

Community

Discord