Avalanche Rosetta Node Upgrade

Avalanche Rosetta

Rosetta server implementation for Avalanche C-Chain.

Requirements

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.

Installation

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.

Usage

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

Configuration

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.

RPC Endpoints

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

Development

Available commands:

make build - Build the development version of the binary
make test - Run the test suite
make dist - Build distribution binaries
make docker-build - Build a Docker image
make docker-push - Push a Docker image to the registry
make run-testnet - Run node and rosetta testnet server
make run-testnet-offline - Run node and rosetta testnet server
make run-mainnet - Run node and rosetta mainnet server
make run-mainnet-offline - Run node and rosetta mainnet server

Testing Rosetta

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

Note: If you're running arm64 machine(e.g, Mac M1), you may run

make docker-build-arm64

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

Rebuild the ContractInfoToken.go autogen file

abigen --abi contractInfo.abi --pkg main --type ContractInfoToken --out client/contractInfoToken.go

License

BSD 3-Clause

ava-labs / avalanche-rosetta Goto Github PK

avalanche-rosetta's Introduction

Avalanche Rosetta

Requirements

Installation

Usage

Configuration

RPC Endpoints

Development

Testing Rosetta

Rebuild the ContractInfoToken.go autogen file

License

avalanche-rosetta's People

Contributors

Stargazers

Watchers

Forkers

avalanche-rosetta's Issues

Recommend Projects

Recommend Topics

Recommend Org