proofchain

type APIError struct {
	Message      string                 `json:"message"`
	StatusCode   int                    `json:"status_code,omitempty"`
	ResponseBody map[string]interface{} `json:"response_body,omitempty"`
}

type APIKey struct {
	ID          string     `json:"id"`
	Name        string     `json:"name"`
	KeyPrefix   string     `json:"key_prefix"`
	Permissions []string   `json:"permissions"`
	CreatedAt   Timestamp  `json:"created_at"`
	LastUsedAt  *Timestamp `json:"last_used_at,omitempty"`
	ExpiresAt   *Timestamp `json:"expires_at,omitempty"`
	IsActive    bool       `json:"is_active"`
	// Key is only available when creating a new key
	Key string `json:"key,omitempty"`
}

type Achievement struct {
	ID            string                 `json:"id"`
	TenantID      string                 `json:"tenant_id"`
	AchievementID string                 `json:"achievement_id"`
	Name          string                 `json:"name"`
	Description   *string                `json:"description,omitempty"`
	Category      *string                `json:"category,omitempty"`
	PointsReward  int                    `json:"points_reward"`
	Requirements  map[string]interface{} `json:"requirements"`
	CreatedAt     time.Time              `json:"created_at"`
}

type ActivitySummaryView struct {
	WalletAddress    string         `json:"wallet_address"`
	TotalEvents      int            `json:"total_events"`
	EventCountByType map[string]int `json:"event_count_by_type"`
	LastActivity     string         `json:"last_activity"`
	ActiveDays       int            `json:"active_days"`
	PeriodDays       int            `json:"period_days"`
	ComputedAt       string         `json:"computed_at"`
}

type AddNFTRequest struct {
	ContractAddress string                 `json:"contract_address"`
	TokenID         string                 `json:"token_id"`
	Network         string                 `json:"network"`
	Metadata        map[string]interface{} `json:"metadata,omitempty"`
	Source          string                 `json:"source,omitempty"`
}

type AttestBytesRequest struct {
	Content   []byte                 `json:"content"`
	Filename  string                 `json:"filename"`
	UserID    string                 `json:"user_id"`
	EventType string                 `json:"event_type,omitempty"`
	Metadata  map[string]interface{} `json:"metadata,omitempty"`
	Encrypt   bool                   `json:"encrypt,omitempty"`
}

type AttestRequest struct {
	FilePath  string                 `json:"file_path"`
	UserID    string                 `json:"user_id"`
	EventType string                 `json:"event_type,omitempty"`
	Metadata  map[string]interface{} `json:"metadata,omitempty"`
	Encrypt   bool                   `json:"encrypt,omitempty"`
}

type AttestationMode string

type AttestationResult struct {
	ID              string          `json:"id"`
	IPFSHash        string          `json:"ipfs_hash"`
	DocumentHash    string          `json:"document_hash"`
	GatewayURL      string          `json:"gateway_url"`
	VerifyURL       string          `json:"verify_url"`
	CertificateID   string          `json:"certificate_id"`
	Status          EventStatus     `json:"status"`
	AttestationMode AttestationMode `json:"attestation_mode"`
	Timestamp       Timestamp       `json:"timestamp"`
	BlockchainTx    *string         `json:"blockchain_tx,omitempty"`
	Proof           []string        `json:"proof,omitempty"`
}

type AuthenticationError struct {
	APIError
}

type AuthorizationError struct {
	APIError
}

type Badge struct {
	ID           string                 `json:"id"`
	TenantID     string                 `json:"tenant_id"`
	BadgeID      string                 `json:"badge_id"`
	Name         string                 `json:"name"`
	Description  *string                `json:"description,omitempty"`
	IconURL      *string                `json:"icon_url,omitempty"`
	Rarity       string                 `json:"rarity"`
	Requirements map[string]interface{} `json:"requirements"`
	CreatedAt    time.Time              `json:"created_at"`
}

type BatchIngestRequest struct {
	Events []IngestEventRequest `json:"events"`
}

type BatchIngestResponse struct {
	TotalEvents int                   `json:"total_events"`
	Queued      int                   `json:"queued"`
	Failed      int                   `json:"failed"`
	Results     []IngestEventResponse `json:"results"`
}

type BatchVerifyItem struct {
	Type string `json:"type"` // "certificate", "ipfs_hash", "event_id"
	ID   string `json:"id"`
}

type BatchVerifyResult struct {
	BatchID      string                   `json:"batch_id"`
	MerkleRoot   string                   `json:"merkle_root"`
	TotalEvents  int                      `json:"total_events"`
	BlockchainTx *string                  `json:"blockchain_tx,omitempty"`
	BlockNumber  *int64                   `json:"block_number,omitempty"`
	Verified     bool                     `json:"verified"`
	Events       []map[string]interface{} `json:"events"`
}

type BlockchainProof struct {
	CertificateID string   `json:"certificate_id"`
	Verified      bool     `json:"verified"`
	TxHash        *string  `json:"tx_hash,omitempty"`
	BlockNumber   *int64   `json:"block_number,omitempty"`
	MerkleRoot    *string  `json:"merkle_root,omitempty"`
	MerkleProof   []string `json:"merkle_proof,omitempty"`
	LeafIndex     *int     `json:"leaf_index,omitempty"`
	ChainName     string   `json:"chain_name"`
}

type BlockchainStats struct {
	TotalTransactions   int     `json:"total_transactions"`
	TotalGasUsed        int64   `json:"total_gas_used"`
	TotalEventsAttested int     `json:"total_events_attested"`
	PendingEvents       int     `json:"pending_events"`
	LastTransaction     *string `json:"last_transaction,omitempty"`
	ContractAddress     *string `json:"contract_address,omitempty"`
	ChainID             int     `json:"chain_id"`
	ChainName           string  `json:"chain_name"`
}

type Certificate struct {
	CertificateID    string                 `json:"certificate_id"`
	RecipientName    string                 `json:"recipient_name"`
	RecipientEmail   *string                `json:"recipient_email,omitempty"`
	Title            string                 `json:"title"`
	Description      *string                `json:"description,omitempty"`
	IPFSHash         string                 `json:"ipfs_hash"`
	VerifyURL        string                 `json:"verify_url"`
	QRCodeURL        string                 `json:"qr_code_url"`
	IssuedAt         Timestamp              `json:"issued_at"`
	ExpiresAt        *Timestamp             `json:"expires_at,omitempty"`
	Revoked          bool                   `json:"revoked"`
	RevokedAt        *Timestamp             `json:"revoked_at,omitempty"`
	RevocationReason *string                `json:"revocation_reason,omitempty"`
	Metadata         map[string]interface{} `json:"metadata,omitempty"`
	BlockchainTx     *string                `json:"blockchain_tx,omitempty"`
}

type CertificateVerifyResult struct {
	CertificateID string                 `json:"certificate_id"`
	Status        string                 `json:"status"`
	Type          string                 `json:"type"`
	Event         map[string]interface{} `json:"event"`
	Issuer        map[string]interface{} `json:"issuer"`
	Verification  map[string]interface{} `json:"verification"`
	Blockchain    map[string]interface{} `json:"blockchain"`
}

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

type Channel struct {
	ChannelID string       `json:"channel_id"`
	Name      string       `json:"name"`
	State     ChannelState `json:"state"`
	CreatedAt Timestamp    `json:"created_at"`
}

type ChannelState string

type ChannelStatus struct {
	ChannelID      string       `json:"channel_id"`
	Name           string       `json:"name"`
	State          ChannelState `json:"state"`
	EventCount     int          `json:"event_count"`
	SyncedCount    int          `json:"synced_count"`
	PendingCount   int          `json:"pending_count"`
	CreatedAt      Timestamp    `json:"created_at"`
	LastActivity   *Timestamp   `json:"last_activity,omitempty"`
	LastSettlement *Timestamp   `json:"last_settlement,omitempty"`
	MerkleRoot     *string      `json:"merkle_root,omitempty"`
}

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

type Client struct {

	// Resource managers
	Documents      *DocumentsResource
	Events         *EventsResource
	Channels       *ChannelsResource
	Certificates   *CertificatesResource
	Webhooks       *WebhooksResource
	Vault          *VaultResource
	Search         *SearchResource
	VerifyResource *VerifyResource
	Tenant         *TenantResource
	Passports      *PassportClient
	Wallets        *WalletClient
	Users          *EndUsersClient
	Rewards        *RewardsClient
	Quests         *QuestsClient
	Schemas        *SchemasClient
	DataViews      *DataViewsClient
	Cohorts        *CohortLeaderboardClient
	Fanpass        *FanpassLeaderboardClient
	// contains filtered or unexported fields
}

type CohortDefinition struct {
	ID          string   `json:"id"`
	TenantID    string   `json:"tenant_id"`
	Name        string   `json:"name"`
	Slug        string   `json:"slug"`
	Description *string  `json:"description,omitempty"`
	ScoringType string   `json:"scoring_type"`
	Icon        *string  `json:"icon,omitempty"`
	Color       *string  `json:"color,omitempty"`
	Status      string   `json:"status"`
	AvgScore    *float64 `json:"avg_score,omitempty"`
	TotalUsers  *int     `json:"total_users,omitempty"`
	CreatedAt   string   `json:"created_at"`
	UpdatedAt   string   `json:"updated_at"`
}

type CohortGroupStats struct {
	FilteredAvgPercentile     *float64 `json:"filtered_avg_percentile,omitempty"`
	FilteredTopNAvgPercentile *float64 `json:"filtered_top_n_avg_percentile,omitempty"`
	GlobalCount               int      `json:"global_count"`
	GlobalAvgPercentile       float64  `json:"global_avg_percentile"`
}

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

type CohortLeaderboardEntry struct {
	Rank               int                     `json:"rank"`
	UserID             string                  `json:"user_id"`
	Score              float64                 `json:"score"`
	PercentileGlobal   float64                 `json:"percentile_global"`
	PercentileFiltered *float64                `json:"percentile_filtered,omitempty"`
	ComputedAt         *string                 `json:"computed_at,omitempty"`
	User               *LeaderboardUserProfile `json:"user,omitempty"`
}

type CohortLeaderboardOptions struct {
	Filters map[string]string
	Country string
	Limit   int
	TopN    int
	Fresh   bool
	UserID  string
}

type CohortLeaderboardResponse struct {
	CohortID                 string                   `json:"cohort_id"`
	CohortName               string                   `json:"cohort_name"`
	Filter                   map[string]interface{}   `json:"filter"`
	TotalUsers               int                      `json:"total_users"`
	GroupStats               CohortGroupStats         `json:"group_stats"`
	Leaderboard              []CohortLeaderboardEntry `json:"leaderboard"`
	CurrentUser              *CohortLeaderboardEntry  `json:"current_user,omitempty"`
	CurrentUserInLeaderboard bool                     `json:"current_user_in_leaderboard"`
}

type ComprehensiveWalletInfo struct {
	WalletID       string                 `json:"wallet_id"`
	Address        string                 `json:"address"`
	UserID         string                 `json:"user_id"`
	WalletType     string                 `json:"wallet_type"`
	Network        string                 `json:"network"`
	Name           *string                `json:"name,omitempty"`
	Status         string                 `json:"status"`
	SupportsExport bool                   `json:"supports_export"`
	CreatedAt      string                 `json:"created_at"`
	Metadata       map[string]interface{} `json:"metadata,omitempty"`
	OwnerWalletID  *string                `json:"owner_wallet_id,omitempty"`
	OwnerAddress   *string                `json:"owner_address,omitempty"`
	IsDeployed     *bool                  `json:"is_deployed,omitempty"`
	Balances       *WalletBalanceInfo     `json:"balances,omitempty"`
	NFTs           *WalletNFTInfo         `json:"nfts,omitempty"`
	Activity       *WalletActivityInfo    `json:"activity,omitempty"`
}

type CreateAPIKeyRequest struct {
	Name          string   `json:"name"`
	Permissions   []string `json:"permissions,omitempty"`
	ExpiresInDays int      `json:"expires_in_days,omitempty"`
}

type CreateAchievementRequest struct {
	AchievementID string                 `json:"achievement_id"`
	Name          string                 `json:"name"`
	Description   *string                `json:"description,omitempty"`
	Category      *string                `json:"category,omitempty"`
	PointsReward  int                    `json:"points_reward,omitempty"`
	Requirements  map[string]interface{} `json:"requirements,omitempty"`
}

type CreateBadgeRequest struct {
	BadgeID      string                 `json:"badge_id"`
	Name         string                 `json:"name"`
	Description  *string                `json:"description,omitempty"`
	IconURL      *string                `json:"icon_url,omitempty"`
	Rarity       string                 `json:"rarity,omitempty"`
	Requirements map[string]interface{} `json:"requirements,omitempty"`
}

type CreateChannelRequest struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
}

type CreateDataViewRequest struct {
	Name             string      `json:"name"`
	DisplayName      string      `json:"display_name"`
	Description      string      `json:"description"`
	ViewType         string      `json:"view_type,omitempty"`
	Computation      interface{} `json:"computation"` // single or []DataViewComputation
	SourceCategories []string    `json:"source_categories,omitempty"`
	IsPublic         *bool       `json:"is_public,omitempty"`
}

type CreateDualWalletsRequest struct {
	UserID     string  `json:"user_id"`
	Network    string  `json:"network,omitempty"`
	NamePrefix *string `json:"name_prefix,omitempty"`
}

type CreateEndUserRequest struct {
	ExternalID    string                 `json:"external_id"`
	Email         *string                `json:"email,omitempty"`
	FirstName     *string                `json:"first_name,omitempty"`
	LastName      *string                `json:"last_name,omitempty"`
	DisplayName   *string                `json:"display_name,omitempty"`
	Phone         *string                `json:"phone,omitempty"`
	DateOfBirth   *time.Time             `json:"date_of_birth,omitempty"`
	Country       *string                `json:"country,omitempty"`
	City          *string                `json:"city,omitempty"`
	Timezone      *string                `json:"timezone,omitempty"`
	Language      *string                `json:"language,omitempty"`
	Bio           *string                `json:"bio,omitempty"`
	WalletAddress *string                `json:"wallet_address,omitempty"`
	Segments      []string               `json:"segments,omitempty"`
	Attributes    map[string]interface{} `json:"attributes,omitempty"`
}

type CreateEventRequest struct {
	EventType string                 `json:"event_type"`
	UserID    string                 `json:"user_id"`
	Data      map[string]interface{} `json:"data"`
	Source    string                 `json:"event_source,omitempty"`
}

type CreatePassportRequest struct {
	UserID         string                 `json:"user_id"`
	WalletAddress  *string                `json:"wallet_address,omitempty"`
	Level          int                    `json:"level,omitempty"`
	Points         int                    `json:"points,omitempty"`
	Experience     int                    `json:"experience,omitempty"`
	Traits         map[string]interface{} `json:"traits,omitempty"`
	CustomMetadata map[string]interface{} `json:"custom_metadata,omitempty"`
}

type CreateQuestRequest struct {
	Name                  string                   `json:"name"`
	Slug                  string                   `json:"slug,omitempty"`
	Description           *string                  `json:"description,omitempty"`
	ShortDescription      *string                  `json:"short_description,omitempty"`
	IconURL               *string                  `json:"icon_url,omitempty"`
	BannerURL             *string                  `json:"banner_url,omitempty"`
	Category              *string                  `json:"category,omitempty"`
	Difficulty            *string                  `json:"difficulty,omitempty"`
	EstimatedTime         *string                  `json:"estimated_time,omitempty"`
	IsOrdered             bool                     `json:"is_ordered,omitempty"`
	IsRepeatable          bool                     `json:"is_repeatable,omitempty"`
	RepeatCooldownHours   *int                     `json:"repeat_cooldown_hours,omitempty"`
	MaxCompletionsPerUser *int                     `json:"max_completions_per_user,omitempty"`
	StartsAt              *time.Time               `json:"starts_at,omitempty"`
	EndsAt                *time.Time               `json:"ends_at,omitempty"`
	TimeLimitHours        *int                     `json:"time_limit_hours,omitempty"`
	PrerequisiteQuestIDs  []string                 `json:"prerequisite_quest_ids,omitempty"`
	MaxParticipants       *int                     `json:"max_participants,omitempty"`
	MaxCompletions        *int                     `json:"max_completions,omitempty"`
	RewardDefinitionID    *string                  `json:"reward_definition_id,omitempty"`
	RewardPoints          *int                     `json:"reward_points,omitempty"`
	IsPublic              bool                     `json:"is_public,omitempty"`
	IsFeatured            bool                     `json:"is_featured,omitempty"`
	Tags                  []string                 `json:"tags,omitempty"`
	Steps                 []CreateQuestStepRequest `json:"steps"`
}

type CreateQuestStepRequest struct {
	Name               string                 `json:"name"`
	Description        *string                `json:"description,omitempty"`
	Order              *int                   `json:"order,omitempty"`
	StepType           string                 `json:"step_type,omitempty"`
	EventType          *string                `json:"event_type,omitempty"`
	EventTypes         []string               `json:"event_types,omitempty"`
	Criteria           map[string]interface{} `json:"criteria,omitempty"`
	RequiredDataFields []string               `json:"required_data_fields,omitempty"`
	StepPoints         *int                   `json:"step_points,omitempty"`
	IconURL            *string                `json:"icon_url,omitempty"`
	IsOptional         bool                   `json:"is_optional,omitempty"`
}

type CreateRewardDefinitionRequest struct {
	Name                 string                 `json:"name"`
	Slug                 string                 `json:"slug"`
	Description          *string                `json:"description,omitempty"`
	CampaignID           *string                `json:"campaign_id,omitempty"`
	RewardType           string                 `json:"reward_type,omitempty"`
	Value                *float64               `json:"value,omitempty"`
	ValueCurrency        *string                `json:"value_currency,omitempty"`
	TokenContractAddress *string                `json:"token_contract_address,omitempty"`
	TokenSymbol          *string                `json:"token_symbol,omitempty"`
	TokenDecimals        int                    `json:"token_decimals,omitempty"`
	TokenChain           string                 `json:"token_chain,omitempty"`
	NFTMetadataTemplate  map[string]interface{} `json:"nft_metadata_template,omitempty"`
	NFTIsSoulbound       bool                   `json:"nft_is_soulbound,omitempty"`
	NFTValidityDays      *int                   `json:"nft_validity_days,omitempty"`
	NFTMintingStrategy   string                 `json:"nft_minting_strategy,omitempty"`
	NFTPreMintCount      *int                   `json:"nft_pre_mint_count,omitempty"`
	PassportThresholdID  *string                `json:"passport_threshold_id,omitempty"`
	TriggerType          string                 `json:"trigger_type,omitempty"`
	TriggerConfig        map[string]interface{} `json:"trigger_config,omitempty"`
	MaxPerUser           *int                   `json:"max_per_user,omitempty"`
	MaxTotal             *int                   `json:"max_total,omitempty"`
	IsActive             bool                   `json:"is_active,omitempty"`
	IconURL              *string                `json:"icon_url,omitempty"`
	BadgeColor           *string                `json:"badge_color,omitempty"`
	IsPublic             bool                   `json:"is_public,omitempty"`
}

type CreateSchemaRequest struct {
	YAMLContent string `json:"yaml_content"`
}

type CreateTemplateFieldRequest struct {
	Name          string                 `json:"name"`
	FieldKey      string                 `json:"field_key"`
	Description   *string                `json:"description,omitempty"`
	DataType      string                 `json:"data_type,omitempty"`
	DefaultValue  interface{}            `json:"default_value,omitempty"`
	Formula       *string                `json:"formula,omitempty"`
	FormulaType   *string                `json:"formula_type,omitempty"`
	Aggregation   *string                `json:"aggregation,omitempty"`
	EventFilter   map[string]interface{} `json:"event_filter,omitempty"`
	DisplayFormat *string                `json:"display_format,omitempty"`
	Icon          *string                `json:"icon,omitempty"`
	Color         *string                `json:"color,omitempty"`
	SortOrder     int                    `json:"sort_order,omitempty"`
	IsVisible     bool                   `json:"is_visible,omitempty"`
	IsComputed    bool                   `json:"is_computed,omitempty"`
}

type CreateTemplateRequest struct {
	Name        string                       `json:"name"`
	Description *string                      `json:"description,omitempty"`
	Slug        string                       `json:"slug"`
	IconURL     *string                      `json:"icon_url,omitempty"`
	IsDefault   bool                         `json:"is_default,omitempty"`
	Fields      []CreateTemplateFieldRequest `json:"fields,omitempty"`
}

type CreateTokenRequest struct {
	ContractAddress    string  `json:"contract_address"`
	Network            string  `json:"network"`
	Symbol             string  `json:"symbol"`
	Name               string  `json:"name"`
	Decimals           *int    `json:"decimals,omitempty"`
	LogoURL            *string `json:"logo_url,omitempty"`
	Color              *string `json:"color,omitempty"`
	CoingeckoID        *string `json:"coingecko_id,omitempty"`
	CoinmarketcapID    *string `json:"coinmarketcap_id,omitempty"`
	CustomPriceFeedURL *string `json:"custom_price_feed_url,omitempty"`
	IsNativeWrapper    *bool   `json:"is_native_wrapper,omitempty"`
	DisplayOrder       *int    `json:"display_order,omitempty"`
}

type CreateUserWalletRequest struct {
	WalletType string `json:"wallet_type,omitempty"`
	Network    string `json:"network,omitempty"`
}

type CreateWalletRequest struct {
	UserID     string                 `json:"user_id"`
	WalletType string                 `json:"wallet_type,omitempty"`
	Network    string                 `json:"network,omitempty"`
	Name       *string                `json:"name,omitempty"`
	Metadata   map[string]interface{} `json:"metadata,omitempty"`
}

type CreateWebhookRequest struct {
	URL    string   `json:"url"`
	Events []string `json:"events"`
	Secret string   `json:"secret,omitempty"`
}

type DataViewComputation struct {
	Type           string             `json:"type"`
	Name           *string            `json:"name,omitempty"`
	EventTypes     []string           `json:"event_types,omitempty"`
	TimeWindowDays *int               `json:"time_window_days,omitempty"`
	EventWeights   map[string]float64 `json:"event_weights,omitempty"`
	MaxScore       *float64           `json:"max_score,omitempty"`
	DecayRate      *float64           `json:"decay_rate,omitempty"`
	Field          *string            `json:"field,omitempty"`
	Operation      *string            `json:"operation,omitempty"`
	GroupBy        *string            `json:"group_by,omitempty"`
	Limit          *int               `json:"limit,omitempty"`
	Fields         []string           `json:"fields,omitempty"`
	Tiers          []TierDefinition   `json:"tiers,omitempty"`
	ScoreSource    *string            `json:"score_source,omitempty"`
}

type DataViewDetail struct {
	ID               string      `json:"id"`
	Name             string      `json:"name"`
	DisplayName      string      `json:"display_name"`
	Description      string      `json:"description"`
	ViewType         string      `json:"view_type"`
	Computation      interface{} `json:"computation"` // single DataViewComputation or []DataViewComputation
	SourceCategories []string    `json:"source_categories"`
	IsPublic         bool        `json:"is_public"`
	CreatedAt        string      `json:"created_at"`
	UpdatedAt        string      `json:"updated_at"`
}

type DataViewExecuteResult struct {
	ViewName       string                 `json:"view_name"`
	DisplayName    string                 `json:"display_name"`
	Identifier     string                 `json:"identifier"`
	IdentifierType string                 `json:"identifier_type"`
	Data           map[string]interface{} `json:"data"`
	ComputedAt     string                 `json:"computed_at"`
	TotalEvents    int                    `json:"total_events"`
}

type DataViewListResponse struct {
	OwnViews     []DataViewSummary `json:"own_views"`
	PublicViews  []DataViewSummary `json:"public_views"`
	BuiltinViews []DataViewSummary `json:"builtin_views"`
}

type DataViewPreviewRequest struct {
	WalletAddress  string      `json:"wallet_address"`
	Computation    interface{} `json:"computation"` // single or []DataViewComputation
	TimeWindowDays *int        `json:"time_window_days,omitempty"`
	Limit          *int        `json:"limit,omitempty"`
}

type DataViewPreviewResult struct {
	Preview         bool                   `json:"preview"`
	WalletAddress   string                 `json:"wallet_address"`
	ComputationType string                 `json:"computation_type"`
	Result          map[string]interface{} `json:"result"`
	EventsProcessed int                    `json:"events_processed"`
	TimeWindowDays  int                    `json:"time_window_days"`
}

type DataViewSummary struct {
	Name             string   `json:"name"`
	DisplayName      *string  `json:"display_name,omitempty"`
	Description      string   `json:"description"`
	ViewType         *string  `json:"view_type,omitempty"`
	SourceCategories []string `json:"source_categories,omitempty"`
}

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

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

type DualWallets struct {
	UserID      string `json:"user_id"`
	AssetWallet Wallet `json:"asset_wallet"`
	SmartWallet Wallet `json:"smart_wallet"`
	Network     string `json:"network"`
}

type EarnedReward struct {
	ID             string     `json:"id"`
	UserID         string     `json:"user_id"`
	UserExternalID string     `json:"user_external_id"`
	RewardName     string     `json:"reward_name"`
	RewardType     string     `json:"reward_type"`
	Status         string     `json:"status"`
	NFTTokenID     *int       `json:"nft_token_id,omitempty"`
	NFTTxHash      *string    `json:"nft_tx_hash,omitempty"`
	EarnedAt       time.Time  `json:"earned_at"`
	DistributedAt  *time.Time `json:"distributed_at,omitempty"`
}

type EndUser struct {
	ID             string                 `json:"id"`
	ExternalID     string                 `json:"external_id"`
	Email          *string                `json:"email,omitempty"`
	FirstName      *string                `json:"first_name,omitempty"`
	LastName       *string                `json:"last_name,omitempty"`
	DisplayName    *string                `json:"display_name,omitempty"`
	AvatarURL      *string                `json:"avatar_url,omitempty"`
	Phone          *string                `json:"phone,omitempty"`
	DateOfBirth    *time.Time             `json:"date_of_birth,omitempty"`
	Country        *string                `json:"country,omitempty"`
	City           *string                `json:"city,omitempty"`
	Timezone       *string                `json:"timezone,omitempty"`
	Language       *string                `json:"language,omitempty"`
	Bio            *string                `json:"bio,omitempty"`
	WalletAddress  *string                `json:"wallet_address,omitempty"`
	WalletSource   *string                `json:"wallet_source,omitempty"`
	Status         string                 `json:"status"`
	TotalEvents    int                    `json:"total_events"`
	FirstEventAt   *time.Time             `json:"first_event_at,omitempty"`
	LastEventAt    *time.Time             `json:"last_event_at,omitempty"`
	EventTypes     []string               `json:"event_types"`
	Segments       []string               `json:"segments"`
	Tags           map[string]interface{} `json:"tags"`
	PointsBalance  int                    `json:"points_balance"`
	LifetimePoints int                    `json:"lifetime_points"`
	Attributes     map[string]interface{} `json:"attributes"`
	CreatedAt      time.Time              `json:"created_at"`
	DiscoveredAt   *time.Time             `json:"discovered_at,omitempty"`
}

type EndUserListResponse struct {
	Users    []EndUser `json:"users"`
	Total    int       `json:"total"`
	Page     int       `json:"page"`
	PageSize int       `json:"page_size"`
	HasMore  bool      `json:"has_more"`
}

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

type EnsureWalletResult struct {
	UserID      string `json:"user_id"`
	AssetWallet Wallet `json:"asset_wallet"`
	SmartWallet Wallet `json:"smart_wallet"`
	Network     string `json:"network"`
	Created     bool   `json:"created"`
}

type Event struct {
	ID              string                 `json:"id"`
	EventType       string                 `json:"event_type"`
	UserID          string                 `json:"user_id"`
	IPFSHash        string                 `json:"ipfs_hash"`
	DocumentHash    *string                `json:"document_hash,omitempty"`
	GatewayURL      string                 `json:"gateway_url"`
	CertificateID   string                 `json:"certificate_id"`
	Status          EventStatus            `json:"status"`
	AttestationMode AttestationMode        `json:"attestation_mode"`
	Timestamp       Timestamp              `json:"timestamp"`
	Data            map[string]interface{} `json:"data,omitempty"`
	BlockchainTx    *string                `json:"blockchain_tx,omitempty"`
	BatchID         *string                `json:"batch_id,omitempty"`
	ChannelID       *string                `json:"channel_id,omitempty"`
}

type EventBatchProof struct {
	EventID       string   `json:"event_id"`
	CertificateID string   `json:"certificate_id"`
	BatchID       string   `json:"batch_id"`
	LeafIndex     int      `json:"leaf_index"`
	MerkleProof   []string `json:"merkle_proof"`
	MerkleRoot    string   `json:"merkle_root"`
	BlockchainTx  *string  `json:"blockchain_tx,omitempty"`
	Verified      bool     `json:"verified"`
}

type EventMetadata struct {
	EventTypes  []EventTypeInfo `json:"event_types"`
	TotalEvents int             `json:"total_events"`
	Categories  []string        `json:"categories"`
}

type EventStatus string

type EventTypeInfo struct {
	EventType string `json:"event_type"`
	Count     int    `json:"count"`
	LastSeen  string `json:"last_seen"`
}

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

type ExecuteSwapRequest struct {
	WalletID    string `json:"wallet_id"`
	FromToken   string `json:"from_token"`
	ToToken     string `json:"to_token"`
	FromAmount  string `json:"from_amount"`
	Network     string `json:"network,omitempty"`
	SlippageBps int    `json:"slippage_bps,omitempty"`
}

type Facet struct {
	Key   string `json:"key"`
	Count int    `json:"count"`
}

type FacetsResponse struct {
	EventTypes   []Facet `json:"event_types"`
	EventSources []Facet `json:"event_sources"`
	Statuses     []Facet `json:"statuses"`
	Users        []Facet `json:"users"`
}

type FanProfileView struct {
	WalletAddress  string         `json:"wallet_address"`
	FanScore       float64        `json:"fan_score"`
	TotalEvents    int            `json:"total_events"`
	EventBreakdown map[string]int `json:"event_breakdown"`
	FirstSeen      string         `json:"first_seen"`
	LastSeen       string         `json:"last_seen"`
	LoyaltyTier    string         `json:"loyalty_tier"`
	ComputedAt     string         `json:"computed_at"`
}

type FanpassGroupStats struct {
	AvgFanScore       float64 `json:"avg_fan_score"`
	TopNAvgFanScore   float64 `json:"top_n_avg_fan_score"`
	GlobalCount       int     `json:"global_count"`
	GlobalAvgFanScore float64 `json:"global_avg_fan_score"`
}

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

type FanpassLeaderboardEntry struct {
	Rank            int                     `json:"rank"`
	UserID          string                  `json:"user_id"`
	FanScore        float64                 `json:"fan_score"`
	NormalizedScore float64                 `json:"normalized_score"`
	RawScore        float64                 `json:"raw_score"`
	Percentile      float64                 `json:"percentile"`
	ComputedAt      *string                 `json:"computed_at,omitempty"`
	User            *LeaderboardUserProfile `json:"user,omitempty"`
}

type FanpassLeaderboardOptions struct {
	AggregationRuleID string
	Filters           map[string]string
	Country           string
	Limit             int
	TopN              int
	Fresh             bool
	UserID            string
}

type FanpassLeaderboardResponse struct {
	AggregationRuleID        *string                   `json:"aggregation_rule_id,omitempty"`
	AggregationRuleName      *string                   `json:"aggregation_rule_name,omitempty"`
	Filter                   map[string]interface{}    `json:"filter"`
	TotalUsers               int                       `json:"total_users"`
	GroupStats               FanpassGroupStats         `json:"group_stats"`
	Leaderboard              []FanpassLeaderboardEntry `json:"leaderboard"`
	CurrentUser              *FanpassLeaderboardEntry  `json:"current_user,omitempty"`
	CurrentUserInLeaderboard bool                      `json:"current_user_in_leaderboard"`
}

type FanpassUserComparisonResponse struct {
	UserID  string                     `json:"user_id"`
	Filter  map[string]interface{}     `json:"filter"`
	Cohorts []UserCohortBreakdownEntry `json:"cohorts"`
}

type FieldValue struct {
	FieldKey    string      `json:"field_key"`
	FieldName   string      `json:"field_name"`
	Value       interface{} `json:"value"`
	DataType    string      `json:"data_type"`
	ComputedAt  *time.Time  `json:"computed_at,omitempty"`
	ManuallySet bool        `json:"manually_set"`
}

type GDPRDeletionRequest struct {
	Confirm       bool    `json:"confirm"`
	DeleteEvents  *bool   `json:"delete_events,omitempty"`
	DeleteWallets *bool   `json:"delete_wallets,omitempty"`
	Reason        *string `json:"reason,omitempty"`
}

type GDPRDeletionResponse struct {
	Success        bool           `json:"success"`
	UserID         string         `json:"user_id"`
	ExternalID     string         `json:"external_id"`
	DeletedRecords map[string]int `json:"deleted_records"`
	MerkleWarning  *string        `json:"merkle_warning,omitempty"`
	AuditID        *string        `json:"audit_id,omitempty"`
}

type GDPRPreviewResponse struct {
	User          map[string]interface{} `json:"user"`
	WouldDelete   map[string]int         `json:"would_delete"`
	MerkleWarning *string                `json:"merkle_warning,omitempty"`
}

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

type GRPCClientOption func(*GRPCClient)

type GRPCEvent struct {
	UserID       string                 `json:"user_id"`
	EventType    string                 `json:"event_type"`
	DocumentHash string                 `json:"document_hash,omitempty"`
	Data         map[string]interface{} `json:"data,omitempty"`
	Timestamp    *time.Time             `json:"timestamp,omitempty"`
}

type GRPCResponse struct {
	EventID       string `json:"event_id"`
	CertificateID string `json:"certificate_id"`
	Status        string `json:"status"`
	Error         string `json:"error,omitempty"`
}

type GetInfoOptions struct {
	IncludeBalances bool
	IncludeNFTs     bool
	IncludeActivity bool
}

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

type HTTPClientOption func(*HTTPClient)

type IngestEventRequest struct {
	UserID      string                 `json:"user_id"`
	EventType   string                 `json:"event_type"`
	Data        map[string]interface{} `json:"data,omitempty"`
	EventSource string                 `json:"event_source,omitempty"`
	Timestamp   string                 `json:"timestamp,omitempty"` // ISO8601/RFC3339 format
	SchemaIDs   []string               `json:"-"`                   // Sent via header
}

type IngestEventResponse struct {
	EventID               string `json:"event_id"`
	CertificateID         string `json:"certificate_id"`
	Status                string `json:"status"`
	QueuePosition         int    `json:"queue_position,omitempty"`
	EstimatedConfirmation string `json:"estimated_confirmation,omitempty"`
}

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

type IngestionClientOption func(*IngestionClient)

type IssueCertificateRequest struct {
	RecipientName  string                 `json:"recipient_name"`
	RecipientEmail string                 `json:"recipient_email,omitempty"`
	Title          string                 `json:"title"`
	Description    string                 `json:"description,omitempty"`
	Metadata       map[string]interface{} `json:"metadata,omitempty"`
	ExpiresAt      *time.Time             `json:"expires_at,omitempty"`
}

type LeaderboardUserProfile struct {
	ExternalID  string                 `json:"external_id"`
	DisplayName *string                `json:"display_name,omitempty"`
	FirstName   *string                `json:"first_name,omitempty"`
	LastName    *string                `json:"last_name,omitempty"`
	Email       *string                `json:"email,omitempty"`
	AvatarURL   *string                `json:"avatar_url,omitempty"`
	Country     *string                `json:"country,omitempty"`
	City        *string                `json:"city,omitempty"`
	Attributes  map[string]interface{} `json:"attributes"`
}

type LinkWalletRequest struct {
	WalletAddress string  `json:"wallet_address"`
	WalletSource  *string `json:"wallet_source,omitempty"`
	Signature     *string `json:"signature,omitempty"`
}

type ListCertificatesRequest struct {
	RecipientEmail string `json:"recipient_email,omitempty"`
	Limit          int    `json:"limit,omitempty"`
	Offset         int    `json:"offset,omitempty"`
}

type ListCohortsOptions struct {
	Status string // "active", "inactive", "draft"
	Limit  int
	Offset int
}

type ListEndUsersOptions struct {
	Page      int
	PageSize  int
	Search    string
	Status    string
	Segment   string
	HasWallet *bool
	MinEvents *int
	SortBy    string
	SortOrder string
}

type ListEventsRequest struct {
	UserID    string `json:"user_id,omitempty"`
	EventType string `json:"event_type,omitempty"`
	Status    string `json:"status,omitempty"`
	StartDate string `json:"start_date,omitempty"`
	EndDate   string `json:"end_date,omitempty"`
	Limit     int    `json:"limit,omitempty"`
	Offset    int    `json:"offset,omitempty"`
}

type ListQuestsOptions struct {
	Status     string
	Category   string
	IsPublic   *bool
	IsFeatured *bool
	Limit      int
	Offset     int
}

type ListRewardsOptions struct {
	IsActive   *bool
	RewardType string
	Limit      int
	Offset     int
}

type ListSchemasOptions struct {
	Status string
	Search string
	Limit  int
	Offset int
}

type ListTokensOptions struct {
	Network       string
	IncludeGlobal *bool
	IncludeHidden *bool
}

type ManualRewardRequest struct {
	DefinitionID          string                 `json:"definition_id"`
	UserIDs               []string               `json:"user_ids"`
	TriggerData           map[string]interface{} `json:"trigger_data,omitempty"`
	DistributeImmediately bool                   `json:"distribute_immediately,omitempty"`
}

type MergeUsersRequest struct {
	SourceUserIDs []string `json:"source_user_ids"`
	TargetUserID  string   `json:"target_user_id"`
}

type MultiStreamClient struct {
	*GRPCClient
	// contains filtered or unexported fields
}

type NFT struct {
	ID              string                 `json:"id"`
	WalletID        string                 `json:"wallet_id"`
	ContractAddress string                 `json:"contract_address"`
	TokenID         string                 `json:"token_id"`
	Network         string                 `json:"network"`
	Name            *string                `json:"name,omitempty"`
	Description     *string                `json:"description,omitempty"`
	ImageURL        *string                `json:"image_url,omitempty"`
	Metadata        map[string]interface{} `json:"metadata,omitempty"`
	Source          string                 `json:"source"`
	AcquiredAt      string                 `json:"acquired_at"`
}

type NetworkError struct {
	APIError
	Cause error
}

type NotFoundError struct {
	APIError
}

type Passport struct {
	ID             string                 `json:"id"`
	TenantID       string                 `json:"tenant_id"`
	UserID         string                 `json:"user_id"`
	WalletAddress  *string                `json:"wallet_address,omitempty"`
	Level          int                    `json:"level"`
	Points         int                    `json:"points"`
	Experience     int                    `json:"experience"`
	Traits         map[string]interface{} `json:"traits"`
	CustomMetadata map[string]interface{} `json:"custom_metadata"`
	OnChainTokenID *string                `json:"on_chain_token_id,omitempty"`
	OnChainTxHash  *string                `json:"on_chain_tx_hash,omitempty"`
	CreatedAt      time.Time              `json:"created_at"`
	LastUpdatedAt  time.Time              `json:"last_updated_at"`
}

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

type PassportHistory struct {
	ID           string      `json:"id"`
	PassportID   string      `json:"passport_id"`
	EventType    string      `json:"event_type"`
	OldValue     interface{} `json:"old_value,omitempty"`
	NewValue     interface{} `json:"new_value,omitempty"`
	ChangeReason *string     `json:"change_reason,omitempty"`
	CreatedAt    time.Time   `json:"created_at"`
}

type PassportListOptions struct {
	Limit  int `json:"limit,omitempty"`
	Offset int `json:"offset,omitempty"`
}

type PassportTemplate struct {
	ID          string          `json:"id"`
	TenantID    string          `json:"tenant_id"`
	Name        string          `json:"name"`
	Description *string         `json:"description,omitempty"`
	Slug        string          `json:"slug"`
	IconURL     *string         `json:"icon_url,omitempty"`
	IsDefault   bool            `json:"is_default"`
	IsActive    bool            `json:"is_active"`
	CreatedAt   time.Time       `json:"created_at"`
	UpdatedAt   time.Time       `json:"updated_at"`
	Fields      []TemplateField `json:"fields"`
}

type PassportWithFields struct {
	Passport
	TemplateID   *string      `json:"template_id,omitempty"`
	TemplateName *string      `json:"template_name,omitempty"`
	FieldValues  []FieldValue `json:"field_values"`
}

type PointsResult struct {
	UserID         string `json:"user_id"`
	PointsAdded    int    `json:"points_added"`
	NewBalance     int    `json:"new_balance"`
	LifetimePoints int    `json:"lifetime_points"`
	Reason         string `json:"reason"`
}

type ProofVerifyRequest struct {
	Leaf  string   `json:"leaf"`
	Proof []string `json:"proof"`
	Root  string   `json:"root"`
}

type ProofVerifyResult struct {
	Valid      bool   `json:"valid"`
	Message    string `json:"message"`
	VerifiedAt string `json:"verified_at"`
}

type Quest struct {
	ID                    string      `json:"id"`
	Name                  string      `json:"name"`
	Slug                  string      `json:"slug"`
	Description           *string     `json:"description,omitempty"`
	ShortDescription      *string     `json:"short_description,omitempty"`
	IconURL               *string     `json:"icon_url,omitempty"`
	BannerURL             *string     `json:"banner_url,omitempty"`
	Category              *string     `json:"category,omitempty"`
	Difficulty            *string     `json:"difficulty,omitempty"`
	EstimatedTime         *string     `json:"estimated_time,omitempty"`
	IsOrdered             bool        `json:"is_ordered"`
	IsRepeatable          bool        `json:"is_repeatable"`
	RepeatCooldownHours   *int        `json:"repeat_cooldown_hours,omitempty"`
	MaxCompletionsPerUser *int        `json:"max_completions_per_user,omitempty"`
	StartsAt              *time.Time  `json:"starts_at,omitempty"`
	EndsAt                *time.Time  `json:"ends_at,omitempty"`
	TimeLimitHours        *int        `json:"time_limit_hours,omitempty"`
	PrerequisiteQuestIDs  []string    `json:"prerequisite_quest_ids"`
	MaxParticipants       *int        `json:"max_participants,omitempty"`
	MaxCompletions        *int        `json:"max_completions,omitempty"`
	RewardDefinitionID    *string     `json:"reward_definition_id,omitempty"`
	RewardPoints          *int        `json:"reward_points,omitempty"`
	IsPublic              bool        `json:"is_public"`
	IsFeatured            bool        `json:"is_featured"`
	Tags                  []string    `json:"tags"`
	Status                string      `json:"status"`
	Steps                 []QuestStep `json:"steps"`
	TotalParticipants     int         `json:"total_participants"`
	TotalCompletions      int         `json:"total_completions"`
	CreatedAt             time.Time   `json:"created_at"`
	UpdatedAt             time.Time   `json:"updated_at"`
}

type QuestStep struct {
	ID                 string                 `json:"id"`
	QuestID            string                 `json:"quest_id"`
	Name               string                 `json:"name"`
	Description        *string                `json:"description,omitempty"`
	Order              int                    `json:"order"`
	StepType           string                 `json:"step_type"`
	EventType          *string                `json:"event_type,omitempty"`
	EventTypes         []string               `json:"event_types,omitempty"`
	Criteria           map[string]interface{} `json:"criteria,omitempty"`
	RequiredDataFields []string               `json:"required_data_fields,omitempty"`
	StepPoints         *int                   `json:"step_points,omitempty"`
	IconURL            *string                `json:"icon_url,omitempty"`
	IsOptional         bool                   `json:"is_optional"`
}

type QuestWithProgress struct {
	Quest
	UserProgress *UserQuestProgress `json:"user_progress,omitempty"`
}

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

type RateLimitError struct {
	APIError
	RetryAfter int `json:"retry_after,omitempty"`
}

type RegisterWalletRequest struct {
	WalletAddress string  `json:"wallet_address"`
	Signature     *string `json:"signature,omitempty"`
}

type RewardAsset struct {
	ID           string                 `json:"id"`
	DefinitionID string                 `json:"definition_id"`
	AssetType    string                 `json:"asset_type"`
	FilePath     string                 `json:"file_path"`
	MimeType     string                 `json:"mime_type"`
	FileSize     int64                  `json:"file_size"`
	Metadata     map[string]interface{} `json:"metadata,omitempty"`
	CreatedAt    time.Time              `json:"created_at"`
}

type RewardDefinition struct {
	ID                   string                 `json:"id"`
	Name                 string                 `json:"name"`
	Slug                 string                 `json:"slug"`
	Description          *string                `json:"description,omitempty"`
	RewardType           string                 `json:"reward_type"`
	Value                *float64               `json:"value,omitempty"`
	ValueCurrency        *string                `json:"value_currency,omitempty"`
	TokenContractAddress *string                `json:"token_contract_address,omitempty"`
	TokenSymbol          *string                `json:"token_symbol,omitempty"`
	TokenDecimals        int                    `json:"token_decimals"`
	TokenChain           string                 `json:"token_chain"`
	NFTMintingStrategy   *string                `json:"nft_minting_strategy,omitempty"`
	NFTPreMintCount      *int                   `json:"nft_pre_mint_count,omitempty"`
	NFTMintedPoolCount   int                    `json:"nft_minted_pool_count"`
	NFTIsSoulbound       bool                   `json:"nft_is_soulbound"`
	PassportThresholdID  *string                `json:"passport_threshold_id,omitempty"`
	TriggerType          string                 `json:"trigger_type"`
	TriggerConfig        map[string]interface{} `json:"trigger_config,omitempty"`
	MaxPerUser           *int                   `json:"max_per_user,omitempty"`
	MaxTotal             *int                   `json:"max_total,omitempty"`
	CurrentIssued        int                    `json:"current_issued"`
	IsActive             bool                   `json:"is_active"`
	IconURL              *string                `json:"icon_url,omitempty"`
	BadgeColor           *string                `json:"badge_color,omitempty"`
	CreatedAt            time.Time              `json:"created_at"`
}

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

type Schema struct {
	ID          string     `json:"id"`
	Name        string     `json:"name"`
	Version     string     `json:"version"`
	DisplayName *string    `json:"display_name,omitempty"`
	Description *string    `json:"description,omitempty"`
	Status      string     `json:"status"`
	IsDefault   bool       `json:"is_default"`
	UsageCount  int        `json:"usage_count"`
	CreatedAt   *time.Time `json:"created_at,omitempty"`
	UpdatedAt   *time.Time `json:"updated_at,omitempty"`
}

type SchemaDetail struct {
	Schema
	SchemaDefinition map[string]interface{} `json:"schema_definition"`
	YAMLContent      string                 `json:"yaml_content"`
}

type SchemaField struct {
	Name        string   `json:"name"`
	Type        string   `json:"type"`
	Required    bool     `json:"required,omitempty"`
	Description *string  `json:"description,omitempty"`
	Default     any      `json:"default,omitempty"`
	Min         *float64 `json:"min,omitempty"`
	Max         *float64 `json:"max,omitempty"`
	Pattern     *string  `json:"pattern,omitempty"`
	Values      []string `json:"values,omitempty"`
}

type SchemaListResponse struct {
	Schemas []Schema `json:"schemas"`
	Total   int      `json:"total"`
}

type SchemaUsageStats struct {
	TotalValidations      int        `json:"total_validations"`
	SuccessfulValidations int        `json:"successful_validations"`
	FailedValidations     int        `json:"failed_validations"`
	LastUsedAt            *time.Time `json:"last_used_at,omitempty"`
}

type SchemaValidationErrorItem struct {
	Field   string `json:"field"`
	Message string `json:"message"`
	Value   any    `json:"value,omitempty"`
}

type SchemaValidationResult struct {
	Valid         bool                        `json:"valid"`
	SchemaName    string                      `json:"schema_name"`
	SchemaVersion *string                     `json:"schema_version,omitempty"`
	Errors        []SchemaValidationErrorItem `json:"errors"`
}

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

type SearchEventResult struct {
	ID                 string                 `json:"id"`
	CertificateID      *string                `json:"certificate_id,omitempty"`
	EventType          string                 `json:"event_type"`
	EventSource        string                 `json:"event_source"`
	UserID             string                 `json:"user_id"`
	Status             string                 `json:"status"`
	Timestamp          Timestamp              `json:"timestamp"`
	IPFSHash           *string                `json:"ipfs_hash,omitempty"`
	DocumentName       *string                `json:"document_name,omitempty"`
	DocumentType       *string                `json:"document_type,omitempty"`
	DocumentSize       *int64                 `json:"document_size,omitempty"`
	HasBlockchainProof bool                   `json:"has_blockchain_proof"`
	BlockchainTxHash   *string                `json:"blockchain_tx_hash,omitempty"`
	Data               map[string]interface{} `json:"data,omitempty"`
}

type SearchFilters struct {
	Query              string                 `json:"query,omitempty"`
	EventTypes         []string               `json:"event_types,omitempty"`
	EventSources       []string               `json:"event_sources,omitempty"`
	UserIDs            []string               `json:"user_ids,omitempty"`
	CertificateIDs     []string               `json:"certificate_ids,omitempty"`
	Status             string                 `json:"status,omitempty"`
	HasDocument        *bool                  `json:"has_document,omitempty"`
	HasBlockchainProof *bool                  `json:"has_blockchain_proof,omitempty"`
	FromDate           *Timestamp             `json:"from_date,omitempty"`
	ToDate             *Timestamp             `json:"to_date,omitempty"`
	DataFilters        map[string]interface{} `json:"data_filters,omitempty"`
}

type SearchQueryRequest struct {
	Filters     *SearchFilters `json:"filters,omitempty"`
	Offset      int            `json:"offset,omitempty"`
	Limit       int            `json:"limit,omitempty"`
	IncludeData bool           `json:"include_data,omitempty"`
}

type SearchRequest struct {
	Query     string `json:"query"`
	UserID    string `json:"user_id,omitempty"`
	EventType string `json:"event_type,omitempty"`
	StartDate string `json:"start_date,omitempty"`
	EndDate   string `json:"end_date,omitempty"`
	Limit     int    `json:"limit,omitempty"`
	Page      int    `json:"page,omitempty"`
}

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

type SearchResponse struct {
	Results     []SearchEventResult    `json:"results"`
	Total       int                    `json:"total"`
	Offset      int                    `json:"offset"`
	Limit       int                    `json:"limit"`
	QueryTimeMs int                    `json:"query_time_ms"`
	Facets      map[string]interface{} `json:"facets,omitempty"`
}

type SearchResult struct {
	Total  int     `json:"total"`
	Page   int     `json:"page"`
	Limit  int     `json:"limit"`
	Events []Event `json:"events"`
}

type SearchStats struct {
	PeriodDays        int                      `json:"period_days"`
	TotalEvents       int                      `json:"total_events"`
	UniqueUsers       int                      `json:"unique_users"`
	EventsPerDay      float64                  `json:"events_per_day"`
	TopUsers          []map[string]interface{} `json:"top_users"`
	TopEventTypes     []map[string]interface{} `json:"top_event_types"`
	TotalStorageBytes int64                    `json:"total_storage_bytes"`
}

type ServerError struct {
	APIError
}

type Settlement struct {
	ChannelID   string    `json:"channel_id"`
	TxHash      string    `json:"tx_hash"`
	MerkleRoot  string    `json:"merkle_root"`
	EventCount  int       `json:"event_count"`
	BlockNumber int64     `json:"block_number"`
	GasUsed     int64     `json:"gas_used"`
	SettledAt   Timestamp `json:"settled_at"`
}

type StepProgress struct {
	StepID      string     `json:"step_id"`
	StepName    string     `json:"step_name"`
	Order       int        `json:"order"`
	Status      string     `json:"status"`
	CompletedAt *time.Time `json:"completed_at,omitempty"`
	EventID     *string    `json:"event_id,omitempty"`
}

type StreamAck struct {
	Sequence  int64  `json:"sequence"`
	ChannelID string `json:"channel_id"`
	Received  bool   `json:"received"`
}

type StreamBatchRequest struct {
	Events []StreamEventRequest `json:"events"`
}

type StreamEventRequest struct {
	EventType string                 `json:"event_type"`
	UserID    string                 `json:"user_id"`
	Data      map[string]interface{} `json:"data,omitempty"`
	Source    string                 `json:"event_source,omitempty"`
}

type StreamStats struct {
	TotalSent     int64
	TotalSuccess  int64
	TotalFailed   int64
	TotalDropped  int64 // Events dropped due to buffer full (only for TrySend)
	Duration      time.Duration
	EventsPerSec  float64
	ActiveStreams int
}

type SwapQuote struct {
	FromToken          string `json:"from_token"`
	ToToken            string `json:"to_token"`
	FromAmount         string `json:"from_amount"`
	ToAmount           string `json:"to_amount"`
	MinToAmount        string `json:"min_to_amount"`
	ExchangeRate       string `json:"exchange_rate"`
	QuoteID            string `json:"quote_id"`
	SlippageBps        int    `json:"slippage_bps"`
	Network            string `json:"network"`
	LiquidityAvailable bool   `json:"liquidity_available"`
	ExpiresAt          string `json:"expires_at"`
}

type SwapQuoteRequest struct {
	FromToken   string `json:"from_token"`
	ToToken     string `json:"to_token"`
	FromAmount  string `json:"from_amount"`
	Network     string `json:"network,omitempty"`
	SlippageBps int    `json:"slippage_bps,omitempty"`
}

type SwapResult struct {
	TransactionHash string `json:"transaction_hash"`
	Status          string `json:"status"`
	FromToken       string `json:"from_token"`
	ToToken         string `json:"to_token"`
	FromAmount      string `json:"from_amount"`
	ToAmount        string `json:"to_amount"`
	GasUsed         string `json:"gas_used"`
}

type TemplateField struct {
	ID            string                 `json:"id"`
	TemplateID    string                 `json:"template_id"`
	Name          string                 `json:"name"`
	FieldKey      string                 `json:"field_key"`
	Description   *string                `json:"description,omitempty"`
	DataType      string                 `json:"data_type"`
	DefaultValue  interface{}            `json:"default_value,omitempty"`
	Formula       *string                `json:"formula,omitempty"`
	FormulaType   *string                `json:"formula_type,omitempty"`
	Aggregation   *string                `json:"aggregation,omitempty"`
	EventFilter   map[string]interface{} `json:"event_filter,omitempty"`
	DisplayFormat *string                `json:"display_format,omitempty"`
	Icon          *string                `json:"icon,omitempty"`
	Color         *string                `json:"color,omitempty"`
	SortOrder     int                    `json:"sort_order"`
	IsVisible     bool                   `json:"is_visible"`
	IsComputed    bool                   `json:"is_computed"`
	CreatedAt     time.Time              `json:"created_at"`
}

type TenantInfo struct {
	TenantID           string  `json:"tenant_id"`
	Name               string  `json:"name"`
	Slug               string  `json:"slug,omitempty"`
	ClientID           string  `json:"client_id,omitempty"`
	Tier               string  `json:"tier,omitempty"`
	Status             string  `json:"status,omitempty"`
	ContractAddress    *string `json:"contract_address,omitempty"`
	ChainID            int     `json:"chain_id,omitempty"`
	MaxEventsPerMonth  int     `json:"max_events_per_month,omitempty"`
	EventsThisMonth    int     `json:"events_this_month,omitempty"`
	EncryptionEnabled  bool    `json:"encryption_enabled,omitempty"`
	OnchainSyncEnabled bool    `json:"onchain_sync_enabled,omitempty"`
}

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

type TierDefinition struct {
	Name string  `json:"name"`
	Min  float64 `json:"min"`
	Max  float64 `json:"max"`
}

type TimeoutError struct {
	APIError
}

type Timestamp struct {
	time.Time
}

type Token struct {
	ID              string  `json:"id"`
	ContractAddress string  `json:"contract_address"`
	Network         string  `json:"network"`
	Symbol          string  `json:"symbol"`
	Name            string  `json:"name"`
	Decimals        int     `json:"decimals"`
	LogoURL         *string `json:"logo_url,omitempty"`
	Color           *string `json:"color,omitempty"`
	CoingeckoID     *string `json:"coingecko_id,omitempty"`
	CoinmarketcapID *string `json:"coinmarketcap_id,omitempty"`
	TokenStandard   string  `json:"token_standard"`
	IsNativeWrapper bool    `json:"is_native_wrapper"`
	IsVerified      bool    `json:"is_verified"`
	IsActive        bool    `json:"is_active"`
	IsHidden        *bool   `json:"is_hidden,omitempty"`
	DisplayOrder    int     `json:"display_order"`
	IsGlobal        bool    `json:"is_global"`
}

type TokenBalance struct {
	Token    string   `json:"token"`
	Symbol   string   `json:"symbol"`
	Balance  string   `json:"balance"`
	Decimals int      `json:"decimals"`
	USDValue *float64 `json:"usd_value,omitempty"`
}

type Transaction struct {
	Hash      string `json:"hash"`
	Type      string `json:"type"` // "sent" or "received"
	From      string `json:"from"`
	To        string `json:"to"`
	Value     string `json:"value"`
	Asset     string `json:"asset"`
	Category  string `json:"category"`
	BlockNum  string `json:"block_num"`
	Timestamp string `json:"timestamp"`
}

type TransactionHistory struct {
	Address       string        `json:"address"`
	Network       string        `json:"network"`
	TotalSent     int           `json:"total_sent"`
	TotalReceived int           `json:"total_received"`
	Transactions  []Transaction `json:"transactions"`
	Error         *string       `json:"error,omitempty"`
}

type TransferRequest struct {
	FromAddress string `json:"from_address"`
	ToAddress   string `json:"to_address"`
	Amount      string `json:"amount"`
	Token       string `json:"token,omitempty"`
	Network     string `json:"network,omitempty"`
}

type TransferResult struct {
	TxHash  string `json:"tx_hash"`
	From    string `json:"from"`
	To      string `json:"to"`
	Amount  string `json:"amount"`
	Token   string `json:"token"`
	Network string `json:"network"`
	Status  string `json:"status"`
}

type UpdateDataViewRequest struct {
	DisplayName      *string     `json:"display_name,omitempty"`
	Description      *string     `json:"description,omitempty"`
	Computation      interface{} `json:"computation,omitempty"`
	SourceCategories []string    `json:"source_categories,omitempty"`
	IsPublic         *bool       `json:"is_public,omitempty"`
}

type UpdateEndUserRequest struct {
	Email       *string                `json:"email,omitempty"`
	FirstName   *string                `json:"first_name,omitempty"`
	LastName    *string                `json:"last_name,omitempty"`
	DisplayName *string                `json:"display_name,omitempty"`
	AvatarURL   *string                `json:"avatar_url,omitempty"`
	Phone       *string                `json:"phone,omitempty"`
	DateOfBirth *time.Time             `json:"date_of_birth,omitempty"`
	Country     *string                `json:"country,omitempty"`
	City        *string                `json:"city,omitempty"`
	Timezone    *string                `json:"timezone,omitempty"`
	Language    *string                `json:"language,omitempty"`
	Bio         *string                `json:"bio,omitempty"`
	Segments    []string               `json:"segments,omitempty"`
	Tags        map[string]interface{} `json:"tags,omitempty"`
	Attributes  map[string]interface{} `json:"attributes,omitempty"`
}

type UpdatePassportRequest struct {
	WalletAddress  *string                `json:"wallet_address,omitempty"`
	Level          *int                   `json:"level,omitempty"`
	Points         *int                   `json:"points,omitempty"`
	Experience     *int                   `json:"experience,omitempty"`
	Traits         map[string]interface{} `json:"traits,omitempty"`
	CustomMetadata map[string]interface{} `json:"custom_metadata,omitempty"`
}

type UpdateTokenRequest struct {
	Symbol             *string `json:"symbol,omitempty"`
	Name               *string `json:"name,omitempty"`
	Decimals           *int    `json:"decimals,omitempty"`
	LogoURL            *string `json:"logo_url,omitempty"`
	Color              *string `json:"color,omitempty"`
	CoingeckoID        *string `json:"coingecko_id,omitempty"`
	CoinmarketcapID    *string `json:"coinmarketcap_id,omitempty"`
	CustomPriceFeedURL *string `json:"custom_price_feed_url,omitempty"`
	IsActive           *bool   `json:"is_active,omitempty"`
	IsHidden           *bool   `json:"is_hidden,omitempty"`
	DisplayOrder       *int    `json:"display_order,omitempty"`
}

type UpdateWebhookRequest struct {
	URL    *string   `json:"url,omitempty"`
	Events *[]string `json:"events,omitempty"`
	Active *bool     `json:"active,omitempty"`
}

type UsageStats struct {
	TenantID          string  `json:"tenant_id,omitempty"`
	EventsThisMonth   int     `json:"events_this_month,omitempty"`
	MaxEventsPerMonth int     `json:"max_events_per_month,omitempty"`
	UsagePercentage   float64 `json:"usage_percentage,omitempty"`
	StorageUsedBytes  int64   `json:"storage_used_bytes,omitempty"`
	MaxStorageGB      int     `json:"max_storage_gb,omitempty"`
	LastEventAt       string  `json:"last_event_at,omitempty"`
	// Legacy fields
	PeriodStart       *Timestamp `json:"period_start,omitempty"`
	PeriodEnd         *Timestamp `json:"period_end,omitempty"`
	EventsCreated     int        `json:"events_created,omitempty"`
	DocumentsAttested int        `json:"documents_attested,omitempty"`
	Verifications     int        `json:"verifications,omitempty"`
	APICalls          int        `json:"api_calls,omitempty"`
	StorageBytes      int64      `json:"storage_bytes,omitempty"`
	ChannelsCreated   int        `json:"channels_created,omitempty"`
	Settlements       int        `json:"settlements,omitempty"`
}

type UserAchievement struct {
	ID            string       `json:"id"`
	PassportID    string       `json:"passport_id"`
	AchievementID string       `json:"achievement_id"`
	Achievement   *Achievement `json:"achievement,omitempty"`
	EarnedAt      time.Time    `json:"earned_at"`
	Progress      float64      `json:"progress"`
	Completed     bool         `json:"completed"`
}

type UserActivityResponse struct {
	UserID         string                   `json:"user_id"`
	ExternalID     string                   `json:"external_id"`
	TotalEvents    int                      `json:"total_events"`
	EventsByType   map[string]int           `json:"events_by_type"`
	EventsByDay    []map[string]interface{} `json:"events_by_day"`
	RecentEvents   []map[string]interface{} `json:"recent_events"`
	RewardsEarned  int                      `json:"rewards_earned"`
	RewardsPending int                      `json:"rewards_pending"`
}