Rosetta server implementation for Avalanche C-Chain.
In order to run the Avalanche Rosetta server you will need access to Avalanche services via RPC. More info in available APIs found here.
See AvalancheGo documentation on how to run the chain node locally. If you don't run the Avalanche node yourself you might use the hosted API provided by Ava Labs.
Clone repository, then build the rosetta server by running the following commands:
make setup
make build
If successful, you will have rosetta-server
binary in your current directory.
Before you start running the server you need to create a configuration file:
{
"rpc_base_url": "https://api.avax-test.network",
"mode": "online",
"listen_addr": "0.0.0.0:8080",
"genesis_block_hash" :"0x31ced5b9beb7f8782b014660da0cb18cc409f121f408186886e1ca3e8eeca96b",
}
Start the server by running the following command:
./rosetta-server -config=./config.json
Full configuration example:
{
"mode": "online",
"rpc_base_url": "http://localhost:9650",
"listen_addr": "0.0.0.0:8080",
"network_name": "Fuji",
"chain_id": 43113,
"log_requests": true,
"genesis_block_hash" :"0x31ced5b9beb7f8782b014660da0cb18cc409f121f408186886e1ca3e8eeca96b",
"index_unknown_tokens": false,
"ingestion_mode" : "standard",
"token_whitelist" : [],
"bridge_tokens" : [],
"validate_erc20_whitelist": false
}
Where:
Name | Type | Default | Description |
---|---|---|---|
mode | string | online |
Mode of operations. One of: online , offline |
rpc_base_url | string | http://localhost:9650 |
Avalanche RPC base url |
listen_addr | string | http://localhost:8080 |
Rosetta server listen address (host/port) |
network_name | string | - | Avalanche network name |
chain_id | integer | - | Avalanche C-Chain ID |
genesis_block_hash | string | - | The block hash for the genesis block |
index_unknown_tokens | bool | false |
Enables ingesting tokens that don't have a public symbol or decimal variable |
ingestion_mode | string | standard |
Toggles between standard and analytics ingesting modes |
token_whitelist | []string | [] | Enables ingesting for the provided ERC20 contract addresses in standard mode. |
bridge_tokens | []string | [] | Supported Avalanche Bridge tokens. Unwrap function allowed, which initates transfer to ethereum if amount threshold met |
validate_erc20_whitelist | bool | false |
Verifies provided ERC20 contract addresses in standard mode (node must be bootstrapped when rosetta server starts). |
The token whitelist only supports tokens that emit evm transfer logs for all minting (from should be 0x000---), burning (to address should be 0x0000) and transfer events are supported. All other tokens will break cause ingestion to fail.
List of all available Rosetta RPC server endpoints
Method | Path | Status | Description |
---|---|---|---|
POST | /network/list | Y | Get List of Available Networks |
POST | /network/status | Y | Get Network Status |
POST | /network/options | Y | Get Network Options |
POST | /block | Y | Get a Block |
POST | /block/transaction | Y | Get a Block Transaction |
POST | /account/balance | Y | Get an Account Balance |
POST | /mempool | Y | Get All Mempool Transactions counts |
POST | /mempool/transaction | N/A | Get a Mempool Transaction |
POST | /construction/combine | Y | Create Network Transaction from Signatures |
POST | /construction/derive | Y | Derive an AccountIdentifier from a PublicKey |
POST | /construction/hash | Y | Get the Hash of a Signed Transaction |
POST | /construction/metadata | Y | Get Transaction Construction Metadata |
POST | /construction/parse | Y | Parse a Transaction |
POST | /construction/payloads | Y | Generate an Unsigned Transaction and Signing Payloads |
POST | /construction/preprocess | Y | Create a Request to Fetch Metadata |
POST | /construction/submit | Y | Submit a Signed Transaction |
POST | /call | Y | Perform a Blockchain Call |
Available commands:
make build
- Build the development version of the binarymake test
- Run the test suitemake dist
- Build distribution binariesmake docker-build
- Build a Docker imagemake docker-push
- Push a Docker image to the registrymake run-testnet
- Run node and rosetta testnet servermake run-testnet-offline
- Run node and rosetta testnet servermake run-mainnet
- Run node and rosetta mainnet servermake run-mainnet-offline
- Run node and rosetta mainnet server
Rosetta implementaion could be testing using the Rosetta CLI.
Before we can start the service, we need to build the docker image:
make docker-build
Next, start the Testnet service by running:
make run-testnet
Wait until the node is done bootstrapping, then start the data check:
make check-testnet-data
Run the construction check:
make check-testnet-construction
Run the construction check for ERC-20s:
make check-testnet-construction-erc20
abigen --abi contractInfo.abi --pkg main --type ContractInfoToken --out client/contractInfoToken.go
BSD 3-Clause