adapters

type ExchangeRate struct {
	FromCurrency string
	ToCurrency   string
	Rate         float64
	BuyRate      float64
	RateID       string
	Locale       string
	UpdatedAt    time.Time
}

type InsufficientBalanceError struct {
	Available float64
	Requested float64
}

type MobileMoneyNetwork struct {
	ID     string
	Name   string
	Code   string
	Status string
}

type NetworkInactiveError struct {
	NetworkCode string
	NetworkName string
	Country     string
	Status      string
}

type NetworkNotFoundError struct {
	NetworkCode string
	NetworkName string
	Country     string
}

type NoOpOffRampService struct{}

type OffRampProvider struct {
	ID                      string
	Name                    string
	SupportedMethods        []string
	MinAmount               float64
	MaxAmount               float64
	Currency                string
	Status                  string
	FeeUSD                  float64
	FeeLocal                float64
	EstimatedSettlementTime int
}

type OffRampRequest struct {
	LoanID           string
	UserID           string
	RecipientName    string
	AmountUSD        float64
	AmountStroops    int64 // Amount in stroops (USDC * 10^7) for direct settlement crypto transfer
	DestinationPhone string
	CountryCode      string
	IdempotencyKey   string
	NetworkCode      string
	NetworkName      string
	SettlementMethod string // "direct" (default) or "fiat"
}

type OffRampResult struct {
	RequestID        string
	SequenceID       string
	Status           string
	AmountUSD        float64
	AmountLocal      float64
	LocalCurrency    string
	ExchangeRate     float64
	Fee              float64 // Total fee in USD
	FeeLocal         float64 // Total fee in local currency
	EstimatedTime    int
	CreatedAt        time.Time
	SettlementMethod string // "direct" or "fiat" — which mode was actually used
	StellarAddress   string // Stellar address (direct settlement only)
	StellarMemo      string // Stellar memo/walletTag (direct settlement only)
	StellarTxHash    string // USDC transfer tx hash (direct settlement only)
}

type OffRampService interface {
	// InitiateOffRamp starts the off-ramp process after validating balance.
	InitiateOffRamp(ctx context.Context, req OffRampRequest) (*OffRampResult, error)

	// GetOffRampStatus checks the status of an off-ramp transaction.
	GetOffRampStatus(ctx context.Context, requestID string) (*OffRampStatus, error)

	// GetSupportedProviders returns available off-ramp providers for a region.
	GetSupportedProviders(ctx context.Context, countryCode string) ([]OffRampProvider, error)

	// GetExchangeRate returns the current exchange rate for a currency.
	GetExchangeRate(ctx context.Context, currency string) (*ExchangeRate, error)

	// GetMobileMoneyNetworks returns available MoMo networks for a country.
	GetMobileMoneyNetworks(ctx context.Context, countryCode string) ([]MobileMoneyNetwork, error)

	// GetAvailableBalance returns the available USD balance for disbursements.
	GetAvailableBalance(ctx context.Context) (float64, error)
}

type OffRampStatus struct {
	RequestID     string
	SequenceID    string
	Status        string
	AmountLocal   float64
	LocalCurrency string
	CompletedAt   *time.Time
	FailureReason *string
}

type StellarSendUSDC interface {
	// SendUSDC sends USDC from the treasury wallet to the destination specified in the request.
	SendUSDC(ctx context.Context, req types.SendUSDCRequest) (*types.SendUSDCResponse, error)
}

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

type TreasuryTransfer interface {
	// SendUSDC sends USDC from the treasury wallet to a destination Stellar address with a memo.
	// Returns the transaction hash on success.
	SendUSDC(ctx context.Context, destination string, memo string, amount int64) (txHash string, err error)
}

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

type WalletConfig struct {
	MasterKey          *bip32.Key
	TreasuryPrivateKey string
	TreasuryPublicKey  string
	USDCIssuer         string
	EnableMultiSig     bool
	LowThreshold       uint32
	MediumThreshold    uint32
	HighThreshold      uint32
}

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

type YellowCardOffRampConfig struct {
	Adapter      *yellowcard.YellowcardAdapter
	Treasury     TreasuryTransfer // Required for direct settlement mode
	BusinessID   string
	BusinessName string
	Logger       *slog.Logger
}