etherscan

type BaseResp struct {
	Status  int             `json:"status,string"` // 1 for good, 0 for error
	Message string          `json:"message"`       // OK for good, other words when Status equals 0
	Result  json.RawMessage `json:"result"`
}

type Client interface {
	GetContractABI(req GetContractABIReq) (*ContractABIResp, error)
	GetContractSourceCode(req GetContractSourceCodeReq) (*ContractSourcecodeResp, error)
	GetContractCreatorTxInfo(req GetContractCreatorTxInfoReq) (*ContractCreatorTxInfoResp, error)

	GetEventLogsByAddress(req GetEventLogsByAddressReq) (*LogResp, error)
	GetEventLogsByTopics(req GetEventLogsByTopicsReq) (*LogResp, error)
	GetEventLogsByAddressFilterByTopics(req GetEventLogsByAddressFilterByTopicsReq) (*LogResp, error)

	Debug() Client
}

type ContractABIResp BaseResp

type ContractCreatorTxInfo struct {
	ContractAddress  string `json:"contractAddress"`
	ContractCreator  string `json:"contractCreator"`
	TxHash           string `json:"txHash"`
	BlockNumber      string `json:"blockNumber"`
	Timestamp        string `json:"timeStamp"`
	ContractFactory  string `json:"contractFactory"`
	CreationBytecode string `json:"creationBytecode"`
}

type ContractCreatorTxInfoResp BaseResp

type ContractSourceCode struct {
	SourceCode           string `json:"SourceCode"`
	ABI                  string `json:"ABI"`
	ContractName         string `json:"ContractName"`
	CompilerVersion      string `json:"CompilerVersion"`
	CompilerType         string `json:"CompilerType"`
	OptimizationUsed     string `json:"OptimizationUsed"`
	Runs                 string `json:"Runs"`
	ConstructorArguments string `json:"ConstructorArguments"`
	EVMVersion           string `json:"EVMVersion"`
	Library              string `json:"Library"`
	ContractFileName     string `json:"ContractFileName"`
	LicenseType          string `json:"LicenseType"`
	Proxy                string `json:"Proxy"`
	Implementation       string `json:"Implementation"`
	SwarmSource          string `json:"SwarmSource"`
	SimilarMatch         string `json:"SimilarMatch"`
}

type ContractSourcecodeResp BaseResp

type GetContractABIReq struct {
	ChainID uint64 `json:"chainid"`
	Address string `json:"address"` // the string representing the address of the contract
}

type GetContractCreatorTxInfoReq struct {
	ChainID   uint64   `json:"chainid"`
	Addresses []string `json:"contractaddresses"` // the array representing the addresses of the contract
}

type GetContractSourceCodeReq struct {
	ChainID uint64 `json:"chainid"`
	Address string `json:"address"` // the string representing the address of the contract
}

type GetEventLogsByAddressFilterByTopicsReq struct {
	ChainID   uint64            `json:"chainid"`
	Address   string            `json:"address"`   // the string representing the address to check for logs
	FromBlock uint64            `json:"fromBlock"` // the integer block number to start searching for logs eg. 12878196
	ToBlock   uint64            `json:"toBlock"`   // the integer block number to stop searching for logs eg. 12879196
	Topics    map[string]string `json:"topics"`    // topic & topicOperator
	Page      *int              `json:"page"`      // the integer page number, if pagination is enabled
	Offset    *int              `json:"offset"`    // the number of transactions displayed per page, limited to 1000 records per query, use the page parameter for subsequent records
}

type GetEventLogsByAddressReq struct {
	ChainID   uint64 `json:"chainid"`
	Address   string `json:"address"`   // the string representing the address to check for logs
	FromBlock uint64 `json:"fromBlock"` // the integer block number to start searching for logs eg. 12878196
	ToBlock   uint64 `json:"toBlock"`   // the integer block number to stop searching for logs eg. 12879196
	Page      *int   `json:"page"`      // the integer page number, if pagination is enabled
	Offset    *int   `json:"offset"`    // the number of transactions displayed per page, limited to 1000 records per query, use the page parameter for subsequent records
}

type GetEventLogsByTopicsReq struct {
	ChainID   uint64            `json:"chainid"`
	FromBlock uint64            `json:"fromBlock"` // the integer block number to start searching for logs eg. 12878196
	ToBlock   uint64            `json:"toBlock"`   // the integer block number to stop searching for logs eg. 12879196
	Topics    map[string]string `json:"topics"`    // topic & topicOperator
	Page      *int              `json:"page"`      // the integer page number, if pagination is enabled
	Offset    *int              `json:"offset"`    // the number of transactions displayed per page, limited to 1000 records per query, use the page parameter for subsequent records
}

type Log struct {
	Address          string   `json:"address"`
	Topics           []string `json:"topics"`
	Data             string   `json:"data"`
	BlockNumber      string   `json:"blockNumber"`
	BlockHash        string   `json:"blockHash"`
	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 LogResp BaseResp

type Options struct {
	Timeout       time.Duration
	BaseUrl       string
	Verbose       bool
	Transport     *http.Transport
	BeforeRequest []resty.RequestMiddleware // for rate limit
}