offramp

type BalanceReporter interface {
	AvailableBalance(ctx context.Context) (float64, error)
}

type Directory interface {
	SupportedProviders(ctx context.Context, countryCode string) ([]ProviderInfo, error)
}

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

type MobileMoneyDirectory interface {
	Networks(ctx context.Context, countryCode string) ([]MobileMoneyNetwork, error)
}

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

type NoOpProvider struct{}

type Provider interface {
	ID() ProviderID
	Initiate(ctx context.Context, req Request) (*Result, error)
}

type ProviderID string

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

type ProviderOptions interface {
	ProviderID() ProviderID
}

type ProviderPayload interface {
	ProviderID() ProviderID
}

type ProviderRef struct {
	ID       string
	Provider ProviderID
	Extra    map[string]any
}

type QuoteRequest struct {
	Currency string
}

type Quoter interface {
	Quote(ctx context.Context, q QuoteRequest) (*ExchangeRate, error)
}

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

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

type Request struct {
	LoanID           string
	UserID           string
	RecipientName    string
	AmountUSD        float64
	AmountStroops    int64
	DestinationPhone string
	CountryCode      string
	IdempotencyKey   string
	NetworkCode      string
	NetworkName      string

	// PayoutMethod is consulted by the registry to pick a provider when the
	// caller doesn't pin one via Options. Empty defaults to mobile money.
	PayoutMethod string

	// Options carries per-provider extras (yellowcard.Options,
	// moneygram.Options). nil is acceptable; each adapter documents its
	// expectations for missing/wrong types.
	Options ProviderOptions
}

type Result struct {
	RequestID        string
	SequenceID       string
	Status           string
	AmountUSD        float64
	AmountLocal      float64
	LocalCurrency    string
	ExchangeRate     float64
	Fee              float64
	FeeLocal         float64
	EstimatedTime    int
	CreatedAt        time.Time
	SettlementMethod string // tag for downstream persistence: "direct"|"fiat"|"cash_pickup"

	// Provider is the typed payload returned by the adapter. Consumers
	// type-assert to the concrete payload type owned by the provider package.
	Provider ProviderPayload
}

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

type StatusReader interface {
	Status(ctx context.Context, ref ProviderRef) (*Status, error)
}

type TreasuryTransfer interface {
	SendUSDC(ctx context.Context, destination string, memo string, amount int64) (txHash string, err error)
	CheckUSDCTrustline(ctx context.Context, address string) (hasTrustline bool, err error)
}