multichain

type ArbitrumProvider struct {
	ContractFetcher
	ContractsCreatorFetcher
	TokenDescriptorsFetcher
	TokenIdentifierOwnerFetcher
	TokenMetadataBatcher
	TokenMetadataFetcher
	TokensByContractWalletFetcher
	TokensByTokenIdentifiersFetcher
	TokensIncrementalContractFetcher
	TokensIncrementalOwnerFetcher
}

type BaseProvider struct {
	ContractFetcher
	ContractsCreatorFetcher
	TokenDescriptorsFetcher
	TokenIdentifierOwnerFetcher
	TokenMetadataBatcher
	TokenMetadataFetcher
	TokensByContractWalletFetcher
	TokensByTokenIdentifiersFetcher
	TokensIncrementalContractFetcher
	TokensIncrementalOwnerFetcher
}

type ChainAgnosticContract struct {
	Descriptors ChainAgnosticContractDescriptors `json:"descriptors"`
	Address     persist.Address                  `json:"address"`
	IsSpam      *bool                            `json:"is_spam"`
	LatestBlock persist.BlockNumber              `json:"latest_block"`
}

type ChainAgnosticContractDescriptors struct {
	Symbol          string          `json:"symbol"`
	Name            string          `json:"name"`
	Description     string          `json:"description"`
	ProfileImageURL string          `json:"profile_image_url"`
	OwnerAddress    persist.Address `json:"owner_address"`
}

type ChainAgnosticIdentifiers struct {
	ContractAddress persist.Address    `json:"contract_address"`
	TokenID         persist.HexTokenID `json:"token_id"`
}

type ChainAgnosticToken struct {
	Descriptors     ChainAgnosticTokenDescriptors `json:"descriptors"`
	TokenType       persist.TokenType             `json:"token_type"`
	TokenURI        persist.TokenURI              `json:"token_uri"`
	TokenID         persist.HexTokenID            `json:"token_id"`
	Quantity        persist.HexString             `json:"quantity"`
	OwnerAddress    persist.Address               `json:"owner_address"`
	TokenMetadata   persist.TokenMetadata         `json:"metadata"`
	ContractAddress persist.Address               `json:"contract_address"`
	FallbackMedia   persist.FallbackMedia         `json:"fallback_media"`
	ExternalURL     string                        `json:"external_url"`
	BlockNumber     persist.BlockNumber           `json:"block_number"`
	IsSpam          *bool                         `json:"is_spam"`
}

type ChainAgnosticTokenDescriptors struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type ChainAgnosticTokensAndContracts struct {
	Tokens    []ChainAgnosticToken    `json:"tokens"`
	Contracts []ChainAgnosticContract `json:"contracts"`
}

type ChainProvider struct {
	Ethereum *EthereumProvider
	Tezos    *TezosProvider
	Optimism *OptimismProvider
	Arbitrum *ArbitrumProvider
	Poap     *PoapProvider
	Zora     *ZoraProvider
	Base     *BaseProvider
	Polygon  *PolygonProvider
}

type ContractFetcher interface {
	GetContractByAddress(ctx context.Context, contract persist.Address) (ChainAgnosticContract, error)
}

type ContractOwnerResult struct {
	Contracts []ChainAgnosticContract
	Chain     persist.Chain
}

type ContractsCreatorFetcher interface {
	GetContractsByCreatorAddress(ctx context.Context, owner persist.Address) ([]ChainAgnosticContract, error)
}

type CustomMetadataHandlers struct {
	AutoglyphHandler               metadataHandler
	ColorglyphHandler              metadataHandler
	EnsHandler                     metadataHandler
	CryptopunkHandler              metadataHandler
	ZoraHandler                    metadataHandler
	OpenseaSharedStorefrontHandler metadataHandler
}

type ErrProviderContractNotFound struct {
	Contract persist.Address
	Chain    persist.Chain
	Err      error
}

type ErrProviderFailed struct{ Err error }

type EthereumProvider struct {
	ContractFetcher
	ContractsCreatorFetcher
	TokenDescriptorsFetcher
	TokenIdentifierOwnerFetcher
	TokenMetadataBatcher
	TokenMetadataFetcher
	TokensByContractWalletFetcher
	TokensByTokenIdentifiersFetcher
	TokensIncrementalContractFetcher
	TokensIncrementalOwnerFetcher
	Verifier
}

type OptimismProvider struct {
	ContractFetcher
	ContractsCreatorFetcher
	TokenDescriptorsFetcher
	TokenIdentifierOwnerFetcher
	TokenMetadataBatcher
	TokenMetadataFetcher
	TokensByContractWalletFetcher
	TokensByTokenIdentifiersFetcher
	TokensIncrementalContractFetcher
	TokensIncrementalOwnerFetcher
}

type PoapProvider struct {
	TokenDescriptorsFetcher
	TokenMetadataFetcher
	TokensIncrementalOwnerFetcher
	TokenIdentifierOwnerFetcher
}

type PolygonProvider struct {
	ContractFetcher
	ContractsCreatorFetcher
	TokenDescriptorsFetcher
	TokenIdentifierOwnerFetcher
	TokenMetadataBatcher
	TokenMetadataFetcher
	TokensByContractWalletFetcher
	TokensByTokenIdentifiersFetcher
	TokensIncrementalContractFetcher
	TokensIncrementalOwnerFetcher
}

type Provider struct {
	Repos     *postgres.Repositories
	Queries   *db.Queries
	Chains    ProviderLookup
	Submitter tokenmanage.Submitter
}

type ProviderLookup map[persist.Chain]any

type TezosProvider struct {
	ContractFetcher
	ContractsCreatorFetcher
	TokenDescriptorsFetcher
	TokenIdentifierOwnerFetcher
	TokenMetadataBatcher
	TokenMetadataFetcher
	TokensByContractWalletFetcher
	TokensByTokenIdentifiersFetcher
	TokensIncrementalContractFetcher
	TokensIncrementalOwnerFetcher
	Verifier
}

type TokenDescriptorsFetcher interface {
	GetTokenDescriptorsByTokenIdentifiers(ctx context.Context, ti ChainAgnosticIdentifiers) (ChainAgnosticTokenDescriptors, ChainAgnosticContractDescriptors, error)
}

type TokenIdentifierOwnerFetcher interface {
	GetTokenByTokenIdentifiersAndOwner(context.Context, ChainAgnosticIdentifiers, persist.Address) (ChainAgnosticToken, ChainAgnosticContract, error)
}

type TokenMetadataBatcher interface {
	GetTokenMetadataByTokenIdentifiersBatch(ctx context.Context, tIDs []ChainAgnosticIdentifiers) ([]persist.TokenMetadata, error)
}

type TokenMetadataFetcher interface {
	GetTokenMetadataByTokenIdentifiers(ctx context.Context, ti ChainAgnosticIdentifiers) (persist.TokenMetadata, error)
}

type TokensByContractWalletFetcher interface {
	GetTokensByContractWallet(ctx context.Context, contract persist.ChainAddress, wallet persist.Address) ([]ChainAgnosticToken, ChainAgnosticContract, error)
}

type TokensByTokenIdentifiersFetcher interface {
	GetTokensByTokenIdentifiers(context.Context, ChainAgnosticIdentifiers) ([]ChainAgnosticToken, ChainAgnosticContract, error)
}

type TokensIncrementalContractFetcher interface {
	// NOTE: implementations MUST close the rec channel
	// maxLimit is not for pagination, it is to make sure we don't fetch a bajilion tokens from an omnibus contract
	GetTokensIncrementallyByContractAddress(ctx context.Context, address persist.Address, maxLimit int) (<-chan ChainAgnosticTokensAndContracts, <-chan error)
}

type TokensIncrementalOwnerFetcher interface {
	// NOTE: implementation MUST close the rec channel
	GetTokensIncrementallyByWalletAddress(ctx context.Context, address persist.Address) (<-chan ChainAgnosticTokensAndContracts, <-chan error)
}

type Verifier interface {
	VerifySignature(ctx context.Context, pubKey persist.PubKey, walletType persist.WalletType, nonce string, sig string) (bool, error)
}

type ZoraProvider struct {
	ContractFetcher
	ContractsCreatorFetcher
	TokenDescriptorsFetcher
	TokenIdentifierOwnerFetcher
	TokenMetadataBatcher
	TokenMetadataFetcher
	TokensByContractWalletFetcher
	TokensByTokenIdentifiersFetcher
	TokensIncrementalContractFetcher
	TokensIncrementalOwnerFetcher
}