blockscan

README

Blockscan

---

Chains supported

chain id	network	blockscan
1	ethereum	etherscan
10	optimism	optimism
56	binance	bscscan
128	heco	hecoscan
137	polygon	polygonscan
250	fantom	ftmscan
42161	arbitrum	arbiscan
43114	avalanche	snowtrace

---

New a Scanner

How to get an api key?

// You can use "" as your api key, but not recommanded.
// You may suffer from some unpredictabale errors when requesting data form blockscans.
ethScanner, _ := blockscan.New(chainId.EthereumChainName, "YOUR API KEY")
avaxScanner, _ := blockscan.New(chainId.AvalancheChainName, "YOUR API KEY")
polyScanner, _ := blockscan.New(chainId.PolygonChainName, "YOUR API KEY")
...

---

To see more on etherscan api.

Accounts

1. GetBalance

Return the chain token(eth for ethereum) balance of an address.

2. GetBalances

Return the chain token(eth for ethereum) balances of a list of addresses.

3. GetErc20Transactions

Return the erc20 transactions(up to 10000) of an address between sepecific blocks.

4. GetErc20TransactionsAll

Return all the erc20 transactions(no amount limit) of an address from block 0 till now.

5. GetInternalTransactions

Return the internal transactions(up to 10000) of an address between sepecific blocks.

6. GetInternalTransactionsAll

Return all the internal transactions(no amount limit) of an address from block 0 till now.

7. GetNormalTransactions

Return the normal transactions(up to 10000) of an address between sepecific blocks.

8. GetNormalTransactionsAll

Return all the normal transactions(no amount limit) of an address from block 0 till now.

---

Contracts

1. GetContractAbi

Return the contract abi.

2. GetSourceCode

Return the contract's source code.

3. GetContractName

Return the contract's name.

4. IsVerifiedContract

Return whether the address is a contract.

If the contract is not verified, will still return false.

---

Blocks

1. GetBlockNumberByTimestamp

Return the block number at specific timestamp.

---

Logs

1. GetEvents

Return the events(up to 1000) of a topic0 between sepecific blocks.

2. GetEventsAll

Return all the events(no amount limit) of a topic0 from block 0 till now.

---

Gas

1. GetGasPrice

Return the gas price in wei.

Documentation

Index

• type AbiStruct
• type BlockscanErc20Txs
• type BlockscanEvents
• type BlockscanGasPriceReq
• type BlockscanGetBalanceReq
• type BlockscanGetBalancesReq
• type BlockscanGetErc20TxsReq
• type BlockscanGetEventsReq
• type BlockscanGetInternalTxsReq
• type BlockscanGetNormalTxsReq
• type BlockscanInternalTxs
• type BlockscanNormalTxs
• type BlockscanResultStringReq
• type BlockscanSourceCode
• type BlockscanSourceCodeReq
• type Scanner
  • func New(network string, apiKey string) (*Scanner, error)
  • func (s *Scanner) GetBalance(address any) (int64, error)
  • func (s *Scanner) GetBalances(addresses []string) (map[string]int64, error)
  • func (s *Scanner) GetBlockNumberByTimestamp(timestamp string) (int64, error)
  • func (s *Scanner) GetContractAbi(address any) (AbiStruct, error)
  • func (s *Scanner) GetContractName(address any) (string, error)
  • func (s *Scanner) GetErc20Transactions(address any, startBlock int, endBlock any) ([]BlockscanErc20Txs, error)
  • func (s *Scanner) GetErc20TransactionsAll(address any) ([]BlockscanErc20Txs, error)
  • func (s *Scanner) GetEvents(topic0 string, address any, startBlock int, endBlock any) ([]BlockscanEvents, error)
  • func (s *Scanner) GetEventsAll(topic0 string, address string) ([]BlockscanEvents, error)
  • func (s *Scanner) GetGasPrice() (int64, error)
  • func (s *Scanner) GetInternalTransactions(address any, startBlock int, endBlock any) ([]BlockscanInternalTxs, error)
  • func (s *Scanner) GetInternalTransactionsAll(address any) ([]BlockscanInternalTxs, error)
  • func (s *Scanner) GetNormalTransactions(address any, startBlock int, endBlock any) ([]BlockscanNormalTxs, error)
  • func (s *Scanner) GetNormalTransactionsAll(address any) ([]BlockscanNormalTxs, error)
  • func (s *Scanner) GetSourceCode(address any) (BlockscanSourceCode, error)
  • func (s *Scanner) IsVerifiedContract(address any) (bool, error)

Types

type AbiStruct

type AbiStruct []struct {
	Inputs []struct {
		InternalType string `json:"internalType"`
		Name         string `json:"name"`
		Type         string `json:"type"`
	} `json:"inputs"`
	StateMutability string `json:"stateMutability"`
	Type            string `json:"type"`
	Anonymous       bool   `json:"anonymous"`
	Name            string `json:"name"`
	Outputs         []struct {
		InternalType string `json:"internalType"`
		Name         string `json:"name"`
		Type         string `json:"type"`
	} `json:"outputs"`
}

type BlockscanErc20Txs

type BlockscanErc20Txs struct {
	BlockNumber       string `json:"blockNumber"`
	TimeStamp         string `json:"timeStamp"`
	Hash              string `json:"hash"`
	Nonce             string `json:"nonce"`
	BlockHash         string `json:"blockHash"`
	From              string `json:"from"`
	ContractAddress   string `json:"contractAddress"`
	To                string `json:"to"`
	Value             string `json:"value"`
	TokenName         string `json:"tokenName"`
	TokenSymbol       string `json:"tokenSymbol"`
	TokenDecimal      string `json:"tokenDecimal"`
	TransactionIndex  string `json:"transactionIndex"`
	Gas               string `json:"gas"`
	GasPrice          string `json:"gasPrice"`
	GasUsed           string `json:"gasUsed"`
	CumulativeGasUsed string `json:"cumulativeGasUsed"`
	Input             string `json:"input"`
	Confirmations     string `json:"confirmations"`
}

type BlockscanEvents

type BlockscanEvents struct {
	Address          string   `json:"address"`
	Topics           []string `json:"topics"`
	Data             string   `json:"data"`
	BlockNumber      string   `json:"blockNumber"`
	TimeStamp        string   `json:"timeStamp"`
	GasPrice         string   `json:"gasPrice"`
	GasUsed          string   `json:"gasUsed"`
	LogIndex         string   `json:"logIndex"`
	TransactionHash  string   `json:"transactionHash"`
	TransactionIndex string   `json:"transactionIndex"`
}

type BlockscanGasPriceReq

type BlockscanGasPriceReq struct {
	Jsonrpc string `json:"jsonrpc"`
	ID      int    `json:"id"`
	Result  string `json:"result"`
}

type BlockscanGetBalanceReq

type BlockscanGetBalanceReq struct {
	Status  string `json:"status"`
	Message string `json:"message"`
	Result  string `json:"result"`
}

type BlockscanGetBalancesReq

type BlockscanGetBalancesReq struct {
	Status  string `json:"status"`
	Message string `json:"message"`
	Result  []struct {
		Account string `json:"account"`
		Balance string `json:"balance"`
	} `json:"result"`
}

type BlockscanGetErc20TxsReq

type BlockscanGetErc20TxsReq struct {
	Status  string              `json:"status"`
	Message string              `json:"message"`
	Result  []BlockscanErc20Txs `json:"result"`
}

type BlockscanGetEventsReq

type BlockscanGetEventsReq struct {
	Status  string            `json:"status"`
	Message string            `json:"message"`
	Result  []BlockscanEvents `json:"result"`
}

type BlockscanGetInternalTxsReq

type BlockscanGetInternalTxsReq struct {
	Status  string                 `json:"status"`
	Message string                 `json:"message"`
	Result  []BlockscanInternalTxs `json:"result"`
}

type BlockscanGetNormalTxsReq

type BlockscanGetNormalTxsReq struct {
	Status  string               `json:"status"`
	Message string               `json:"message"`
	Result  []BlockscanNormalTxs `json:"result"`
}

type BlockscanInternalTxs

type BlockscanInternalTxs struct {
	BlockNumber     string `json:"blockNumber"`
	TimeStamp       string `json:"timeStamp"`
	Hash            string `json:"hash"`
	From            string `json:"from"`
	To              string `json:"to"`
	Value           string `json:"value"`
	ContractAddress string `json:"contractAddress"`
	Input           string `json:"input"`
	Type            string `json:"type"`
	Gas             string `json:"gas"`
	GasUsed         string `json:"gasUsed"`
	TraceID         string `json:"traceId"`
	IsError         string `json:"isError"`
	ErrCode         string `json:"errCode"`
}

type BlockscanNormalTxs

type BlockscanNormalTxs struct {
	BlockNumber       string `json:"blockNumber"`
	TimeStamp         string `json:"timeStamp"`
	Hash              string `json:"hash"`
	Nonce             string `json:"nonce"`
	BlockHash         string `json:"blockHash"`
	TransactionIndex  string `json:"transactionIndex"`
	From              string `json:"from"`
	To                string `json:"to"`
	Value             string `json:"value"`
	Gas               string `json:"gas"`
	GasPrice          string `json:"gasPrice"`
	IsError           string `json:"isError"`
	TxreceiptStatus   string `json:"txreceipt_status"`
	Input             string `json:"input"`
	ContractAddress   string `json:"contractAddress"`
	CumulativeGasUsed string `json:"cumulativeGasUsed"`
	GasUsed           string `json:"gasUsed"`
	Confirmations     string `json:"confirmations"`
}

type BlockscanResultStringReq

type BlockscanResultStringReq struct {
	Status  string `json:"status"`
	Message string `json:"message"`
	Result  string `json:"result"`
}

type BlockscanSourceCode

type BlockscanSourceCode struct {
	SourceCode           string `json:"SourceCode"`
	Abi                  string `json:"ABI"`
	ContractName         string `json:"ContractName"`
	CompilerVersion      string `json:"CompilerVersion"`
	OptimizationUsed     string `json:"OptimizationUsed"`
	Runs                 string `json:"Runs"`
	ConstructorArguments string `json:"ConstructorArguments"`
	EVMVersion           string `json:"EVMVersion"`
	Library              string `json:"Library"`
	LicenseType          string `json:"LicenseType"`
	Proxy                string `json:"Proxy"`
	Implementation       string `json:"Implementation"`
	SwarmSource          string `json:"SwarmSource"`
}

type BlockscanSourceCodeReq

type BlockscanSourceCodeReq struct {
	Status  string                `json:"status"`
	Message string                `json:"message"`
	Result  []BlockscanSourceCode `json:"result"`
}

type Scanner

type Scanner struct {
	UrlHead string
	ApiKey  string
}

func New

func New(network string, apiKey string) (*Scanner, error)

Create a new scanner.

func (*Scanner) GetBalance

func (s *Scanner) GetBalance(address any) (int64, error)

Return the balance of a single address.

func (*Scanner) GetBalances

func (s *Scanner) GetBalances(addresses []string) (map[string]int64, error)

map[address] = balance. Return balances of up to 20 addresses.

func (*Scanner) GetBlockNumberByTimestamp

func (s *Scanner) GetBlockNumberByTimestamp(timestamp string) (int64, error)

Return the block number.

func (*Scanner) GetContractAbi

func (s *Scanner) GetContractAbi(address any) (AbiStruct, error)

Return the contract's abi.

func (*Scanner) GetContractName

func (s *Scanner) GetContractName(address any) (string, error)

Return the contract's name.

func (*Scanner) GetErc20Transactions

func (s *Scanner) GetErc20Transactions(address any, startBlock int, endBlock any) ([]BlockscanErc20Txs, error)

Return up to 10000 erc20 txs of an address.

func (*Scanner) GetErc20TransactionsAll

func (s *Scanner) GetErc20TransactionsAll(address any) ([]BlockscanErc20Txs, error)

Return all the erc20 txs of an address.

func (*Scanner) GetEvents

func (s *Scanner) GetEvents(topic0 string, address any, startBlock int, endBlock any) ([]BlockscanEvents, error)

Return up to 1000 events of an address.

func (*Scanner) GetEventsAll

func (s *Scanner) GetEventsAll(topic0 string, address string) ([]BlockscanEvents, error)

Return all the events of an address.

func (*Scanner) GetGasPrice

func (s *Scanner) GetGasPrice() (int64, error)

Return gas price.

func (*Scanner) GetInternalTransactions

func (s *Scanner) GetInternalTransactions(address any, startBlock int, endBlock any) ([]BlockscanInternalTxs, error)

Return up to 10000 internal txs of an address.

func (*Scanner) GetInternalTransactionsAll

func (s *Scanner) GetInternalTransactionsAll(address any) ([]BlockscanInternalTxs, error)

Return all the internal txs of an address.

func (*Scanner) GetNormalTransactions

func (s *Scanner) GetNormalTransactions(address any, startBlock int, endBlock any) ([]BlockscanNormalTxs, error)

Return up to 10000 txs of an address.

func (*Scanner) GetNormalTransactionsAll

func (s *Scanner) GetNormalTransactionsAll(address any) ([]BlockscanNormalTxs, error)

Return all the txs of an address.

func (*Scanner) GetSourceCode

func (s *Scanner) GetSourceCode(address any) (BlockscanSourceCode, error)

Return the source code of a contract.

func (*Scanner) IsVerifiedContract

func (s *Scanner) IsVerifiedContract(address any) (bool, error)

Return whether the address is a verified contract. Some contracts may not be verified, will be considered not contract.