etherscan

type Contract struct {
	SourceCode           interface{} `json:"SourceCode"`           // The source code of the contract. Can be a plain string or a structured metadata object.
	ABI                  string      `json:"ABI"`                  // The ABI (Application Binary Interface) of the contract in JSON format.
	Name                 string      `json:"ContractName"`         // The name of the contract.
	CompilerVersion      string      `json:"CompilerVersion"`      // The version of the Solidity compiler used to compile the contract.
	OptimizationUsed     string      `json:"OptimizationUsed"`     // Indicates if optimization was used during compilation.
	Runs                 string      `json:"Runs"`                 // The number of runs specified for the optimizer.
	ConstructorArguments string      `json:"ConstructorArguments"` // The constructor arguments used when deploying the contract.
	EVMVersion           string      `json:"EVMVersion"`           // The version of the Ethereum Virtual Machine (EVM) for which the contract was compiled.
	Library              string      `json:"Library"`              // Specifies any library used in the contract.
	LicenseType          string      `json:"LicenseType"`          // The license type under which the contract source code is provided.
	Proxy                string      `json:"Proxy"`                // Indicates if the contract is a proxy contract.
	Implementation       string      `json:"Implementation"`       // The address of the implementation contract, if this is a proxy contract.
	SwarmSource          string      `json:"SwarmSource"`          // The Swarm source of the contract's metadata.
}

type ContractCreation struct {
	Address         string `json:"contractAddress"` // The smart contract address.
	CreatorAddress  string `json:"contractCreator"` // The address of the creator of the contract.
	TransactionHash string `json:"txHash"`          // The hash of the transaction that created the contract.
}

type ContractCreationResponse struct {
	Status  string              `json:"status"`  // The response status.
	Message string              `json:"message"` // A descriptive message of the response.
	Result  []*ContractCreation `json:"result"`  // The contract creation details.
}

type ContractResponse struct {
	Status  string     `json:"status"`  // The status of the API response, "1" for success and "0" for failure.
	Message string     `json:"message"` // A message accompanying the status, often indicating the nature of any error.
	Result  []Contract `json:"result"`  // The contracts returned by the query, typically containing a single contract.
}

type ErrorResponse struct {
	Status  string `json:"status"`  // The status code of the response.
	Message string `json:"message"` // A message describing the error.
	Result  string `json:"result"`  // The result field, typically empty in error responses.
}

type Options struct {
	// Provider specifies the blockchain explorer service (e.g., Etherscan, BscScan) to be used.
	Provider ProviderType `json:"provider" yaml:"provider" mapstructure:"provider"`

	// Endpoint is the base URL of the blockchain explorer API.
	// It determines where the client sends its requests.
	Endpoint string `json:"endpoint" yaml:"endpoint" mapstructure:"endpoint"`

	// RateLimit specifies the maximum number of requests that the client is allowed to make to the
	// blockchain explorer API within a fixed time window. Consult Etherscan documentation.
	RateLimit int `json:"rateLimit" yaml:"rateLimit" mapstructure:"rateLimit"`

	// Keys contains a list of API keys used for authenticating requests to the blockchain explorer API.
	// The client can rotate through these keys to manage rate limits.
	Keys []string `json:"keys" yaml:"keys" mapstructure:"keys"`
}

type Provider struct {
	// contains filtered or unexported fields
}

type ProviderType string