github.com/x402-foundation/x402/go/v2

type AfterPaymentCreationHook func(PaymentCreatedContext) error

type AfterSettleHook func(SettleResultContext) error

type AfterSettleHookProvider interface {
	AfterSettleHook() AfterSettleHook
}

type AfterVerifyHook func(VerifyResultContext) (*AfterVerifyResult, error)

type AfterVerifyHookProvider interface {
	AfterVerifyHook() AfterVerifyHook
}

type AfterVerifyResult struct {
	Abort       bool
	Reason      string
	Message     string
	SkipHandler bool
	Response    *SkipHandlerDirective
}

type AssetAmount struct {
	Asset  string                 `json:"asset"`
	Amount string                 `json:"amount"`
	Extra  map[string]interface{} `json:"extra,omitempty"`
}

type AssetDecimalsProvider interface {
	GetAssetDecimals(asset string, network Network) int
}

type BeforeHookResult struct {
	Abort            bool
	Reason           string
	Message          string
	Skip             bool
	SkipResult       *SettleResponse
	SkipVerifyResult *VerifyResponse
}

type BeforePaymentCreationHook func(PaymentCreationContext) (*BeforePaymentCreationHookResult, error)

type BeforePaymentCreationHookResult struct {
	Abort  bool
	Reason string
}

type BeforeSettleHook func(SettleContext) (*BeforeHookResult, error)

type BeforeSettleHookProvider interface {
	BeforeSettleHook() BeforeSettleHook
}

type BeforeVerifyHook func(VerifyContext) (*BeforeHookResult, error)

type BeforeVerifyHookProvider interface {
	BeforeVerifyHook() BeforeVerifyHook
}

type ClientExtension interface {
	// Key returns the unique extension identifier (e.g., "eip2612GasSponsoring").
	// Must match the extension key used in PaymentRequired.Extensions.
	Key() string

	// EnrichPaymentPayload is called after payload creation for every registered
	// extension. Allows the extension to enrich the payload with extension-specific
	// data (e.g., builder-code service codes). Extensions that require a server
	// declaration must no-op when the server did not advertise them.
	EnrichPaymentPayload(ctx context.Context, payload types.PaymentPayload, required types.PaymentRequired) (types.PaymentPayload, error)
}

type ClientOption func(*x402Client)

type EnrichSettlementPayloadProvider interface {
	EnrichSettlementPayload(ctx SettleContext) (map[string]interface{}, error)
}

type EnrichSettlementResponseProvider interface {
	EnrichSettlementResponse(ctx SettleResultContext) (map[string]interface{}, error)
}

type ExtensionAwareClient interface {
	SchemeNetworkClient
	CreatePaymentPayloadWithExtensions(ctx context.Context, requirements types.PaymentRequirements, extensions map[string]interface{}) (types.PaymentPayload, error)
}

type ExtensionValidationResult struct {
	Valid         bool
	InvalidReason string
	ExtensionKey  string
}

type FacilitatorAfterSettleHook func(FacilitatorSettleResultContext) error

type FacilitatorAfterVerifyHook func(FacilitatorVerifyResultContext) error

type FacilitatorBeforeHookResult struct {
	Abort   bool
	Reason  string
	Message string
}

type FacilitatorBeforeSettleHook func(FacilitatorSettleContext) (*FacilitatorBeforeHookResult, error)

type FacilitatorBeforeVerifyHook func(FacilitatorVerifyContext) (*FacilitatorBeforeHookResult, error)

type FacilitatorClient interface {
	// Verify a payment (detects version from bytes, routes internally)
	Verify(ctx context.Context, payloadBytes []byte, requirementsBytes []byte) (*VerifyResponse, error)

	// Settle a payment (detects version from bytes, routes internally)
	Settle(ctx context.Context, payloadBytes []byte, requirementsBytes []byte) (*SettleResponse, error)

	// GetSupported returns supported payment kinds in flat array format with x402Version in each element (backward compatible)
	GetSupported(ctx context.Context) (SupportedResponse, error)
}

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

type FacilitatorExtension interface {
	Key() string
}

type FacilitatorOnSettleFailureHook func(FacilitatorSettleFailureContext) (*FacilitatorSettleFailureHookResult, error)

type FacilitatorOnVerifyFailureHook func(FacilitatorVerifyFailureContext) (*FacilitatorVerifyFailureHookResult, error)

type FacilitatorSettleContext struct {
	Ctx               context.Context
	Payload           PaymentPayloadView
	Requirements      PaymentRequirementsView
	PayloadBytes      []byte // Raw bytes for extensions needing full data
	RequirementsBytes []byte // Raw bytes for extensions needing full data
}

type FacilitatorSettleFailureContext struct {
	FacilitatorSettleContext
	Error error
}

type FacilitatorSettleFailureHookResult struct {
	Recovered bool
	Result    *SettleResponse
}

type FacilitatorSettleResultContext struct {
	FacilitatorSettleContext
	Result *SettleResponse
}

type FacilitatorSupportValidator interface {
	ValidateFacilitatorSupport(network Network, supportedKind types.SupportedKind, facilitatorExtensions []string) error
}

type FacilitatorVerifyContext struct {
	Ctx               context.Context
	Payload           PaymentPayloadView
	Requirements      PaymentRequirementsView
	PayloadBytes      []byte // Raw bytes for extensions needing full data
	RequirementsBytes []byte // Raw bytes for extensions needing full data
}

type FacilitatorVerifyFailureContext struct {
	FacilitatorVerifyContext
	Error error
}

type FacilitatorVerifyFailureHookResult struct {
	Recovered bool
	Result    *VerifyResponse
}

type FacilitatorVerifyResultContext struct {
	FacilitatorVerifyContext
	Result *VerifyResponse
}

type MoneyParser func(amount float64, network Network) (*AssetAmount, error)

type Network string

type OnPaymentCreationFailureHook func(PaymentCreationFailureContext) (*PaymentCreationFailureHookResult, error)

type OnPaymentResponseHook func(context.Context, PaymentResponseContext) (PaymentResponseResult, error)

type OnSettleFailureHook func(SettleFailureContext) (*SettleFailureHookResult, error)

type OnSettleFailureHookProvider interface {
	OnSettleFailureHook() OnSettleFailureHook
}

type OnVerifiedPaymentCanceledHook func(VerifiedPaymentCanceledContext) error

type OnVerifiedPaymentCanceledHookProvider interface {
	OnVerifiedPaymentCanceledHook() OnVerifiedPaymentCanceledHook
}

type OnVerifyFailureHook func(VerifyFailureContext) (*VerifyFailureHookResult, error)

type OnVerifyFailureHookProvider interface {
	OnVerifyFailureHook() OnVerifyFailureHook
}

type PartialPaymentPayload struct {
	X402Version int `json:"x402Version"`
}

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

type PaymentCreatedContext struct {
	PaymentCreationContext
	Payload PaymentPayloadView
}

type PaymentCreationContext struct {
	Ctx                  context.Context
	Version              int // V1 or V2
	SelectedRequirements PaymentRequirementsView
}

type PaymentCreationFailureContext struct {
	PaymentCreationContext
	Error error
}

type PaymentCreationFailureHookResult struct {
	Recovered bool
	Payload   PaymentPayloadView
}

type PaymentError struct {
	Code    string                 `json:"code"`
	Message string                 `json:"message"`
	Details map[string]interface{} `json:"details,omitempty"`
}

type PaymentPayload = types.PaymentPayload

type PaymentPayloadView interface {
	GetVersion() int
	GetScheme() string
	GetNetwork() string // Returns network as string (can be converted to Network type)
	GetPayload() map[string]interface{}
}

type PaymentPolicy func(requirements []PaymentRequirementsView) []PaymentRequirementsView

type PaymentRequired = types.PaymentRequired

type PaymentRequiredContext struct {
	Requirements            []types.PaymentRequirements
	PaymentPayload          *types.PaymentPayload
	ResourceInfo            *types.ResourceInfo
	Error                   string
	PaymentRequiredResponse *types.PaymentRequired
}

type PaymentRequiredEnricher interface {
	EnrichPaymentRequiredResponse(ctx PaymentRequiredContext)
}

type PaymentRequirements = types.PaymentRequirements

type PaymentRequirementsSelector func(requirements []PaymentRequirementsView) PaymentRequirementsView

type PaymentRequirementsView interface {
	GetScheme() string
	GetNetwork() string // Returns network as string (can be converted to Network type)
	GetAsset() string
	GetAmount() string // V1: MaxAmountRequired, V2: Amount
	GetPayTo() string
	GetMaxTimeoutSeconds() int
	GetExtra() map[string]interface{}
}

type PaymentResponseContext struct {
	PaymentPayload  types.PaymentPayload
	Requirements    types.PaymentRequirements
	SettleResponse  *SettleResponse
	PaymentRequired *types.PaymentRequired
}

type PaymentResponseHandler interface {
	OnPaymentResponse(ctx context.Context, prCtx PaymentResponseContext) (PaymentResponseResult, error)
}

type PaymentResponseResult struct {
	Recovered bool
}

type Price interface{}

type ResourceConfig struct {
	Scheme            string                 `json:"scheme"`
	PayTo             string                 `json:"payTo"`
	Price             Price                  `json:"price"`
	Network           Network                `json:"network"`
	MaxTimeoutSeconds int                    `json:"maxTimeoutSeconds,omitempty"`
	Extra             map[string]interface{} `json:"extra,omitempty"`
}

type ResourceInfo = types.ResourceInfo

type ResourceServerExtensionDynamicInfoFieldsProvider interface {
	DynamicInfoFields() []string
}

type ResourceServerExtensionHookProvider interface {
	ResourceServerExtensionHooks() ResourceServerExtensionHooks
}

type ResourceServerExtensionHooks struct {
	OnBeforeVerify            BeforeVerifyHook
	OnAfterVerify             AfterVerifyHook
	OnVerifyFailure           OnVerifyFailureHook
	OnBeforeSettle            BeforeSettleHook
	OnAfterSettle             AfterSettleHook
	OnSettleFailure           OnSettleFailureHook
	OnVerifiedPaymentCanceled OnVerifiedPaymentCanceledHook
}

type ResourceServerOption func(*x402ResourceServer)

type SchemeNetworkClient interface {
	Scheme() string
	CreatePaymentPayload(ctx context.Context, requirements types.PaymentRequirements) (types.PaymentPayload, error)
}

type SchemeNetworkClientV1 interface {
	Scheme() string
	CreatePaymentPayload(ctx context.Context, requirements types.PaymentRequirementsV1) (types.PaymentPayloadV1, error)
}

type SchemeNetworkFacilitator interface {
	Scheme() string

	// CaipFamily returns the CAIP family pattern this facilitator supports.
	// Used to group signers by blockchain family in the supported response.
	//
	// Examples:
	//   - EVM facilitators return "eip155:*"
	//   - SVM facilitators return "solana:*"
	CaipFamily() string

	// GetExtra returns mechanism-specific extra data for the supported kinds endpoint.
	// This method is called when building the facilitator's supported response.
	//
	// For EVM schemes, return nil (no extra data needed).
	// For SVM schemes, return map with feePayer address.
	//
	// Args:
	//   network: Network identifier for context
	//
	// Returns:
	//   Extra data map or nil if no extra data is needed
	GetExtra(network Network) map[string]interface{}

	// GetSigners returns signer addresses used by this facilitator for a given network.
	// These are included in the supported response to help clients understand
	// which addresses might sign/pay for transactions.
	//
	// Supports multiple addresses for load balancing, key rotation, and high availability.
	//
	// Args:
	//   network: Network identifier
	//
	// Returns:
	//   Array of signer addresses
	//
	// Examples:
	//   - EVM: Returns facilitator wallet addresses
	//   - SVM: Returns fee payer addresses
	GetSigners(network Network) []string

	Verify(ctx context.Context, payload types.PaymentPayload, requirements types.PaymentRequirements, fctx *FacilitatorContext) (*VerifyResponse, error)
	Settle(ctx context.Context, payload types.PaymentPayload, requirements types.PaymentRequirements, fctx *FacilitatorContext) (*SettleResponse, error)
}

type SchemeNetworkFacilitatorV1 interface {
	Scheme() string

	// CaipFamily returns the CAIP family pattern this facilitator supports.
	// Used to group signers by blockchain family in the supported response.
	//
	// Examples:
	//   - EVM facilitators return "eip155:*"
	//   - SVM facilitators return "solana:*"
	CaipFamily() string

	// GetExtra returns mechanism-specific extra data for the supported kinds endpoint.
	// This method is called when building the facilitator's supported response.
	//
	// For EVM schemes, return nil (no extra data needed).
	// For SVM schemes, return map with feePayer address.
	//
	// Args:
	//   network: Network identifier for context
	//
	// Returns:
	//   Extra data map or nil if no extra data is needed
	GetExtra(network Network) map[string]interface{}

	// GetSigners returns signer addresses used by this facilitator for a given network.
	// These are included in the supported response to help clients understand
	// which addresses might sign/pay for transactions.
	//
	// Supports multiple addresses for load balancing, key rotation, and high availability.
	//
	// Args:
	//   network: Network identifier
	//
	// Returns:
	//   Array of signer addresses
	//
	// Examples:
	//   - EVM: Returns facilitator wallet addresses
	//   - SVM: Returns fee payer addresses
	GetSigners(network Network) []string

	Verify(ctx context.Context, payload types.PaymentPayloadV1, requirements types.PaymentRequirementsV1, fctx *FacilitatorContext) (*VerifyResponse, error)
	Settle(ctx context.Context, payload types.PaymentPayloadV1, requirements types.PaymentRequirementsV1, fctx *FacilitatorContext) (*SettleResponse, error)
}

type SchemeNetworkServer interface {
	Scheme() string
	ParsePrice(price Price, network Network) (AssetAmount, error)
	EnhancePaymentRequirements(
		ctx context.Context,
		requirements types.PaymentRequirements,
		supportedKind types.SupportedKind,
		extensions []string,
	) (types.PaymentRequirements, error)
}

type SettleContext struct {
	Ctx          context.Context
	Payload      PaymentPayloadView
	Requirements PaymentRequirementsView
	// DeclaredExtensions carries the extension declarations attached to the
	// route. Extension hooks gate on `DeclaredExtensions[extKey]` being set
	// before firing - mirrors TS `ctx.declaredExtensions[extensionKey]`.
	DeclaredExtensions map[string]interface{}
	PayloadBytes       []byte // Raw bytes for extensions needing full data
	RequirementsBytes  []byte // Raw bytes for extensions needing full data
}

type SettleError struct {
	ErrorReason  string  // Error reason/code (e.g., "transaction_failed", "insufficient_balance")
	Payer        string  // Payer address (if known)
	Network      Network // Network identifier
	Transaction  string  // Transaction hash (if settlement was attempted)
	ErrorMessage string  // Optional error message details
}

type SettleFailureContext struct {
	SettleContext
	Error error
}

type SettleFailureHookResult struct {
	Recovered bool
	Result    *SettleResponse
}

type SettleResponse struct {
	Success      bool                   `json:"success"`
	ErrorReason  string                 `json:"errorReason,omitempty"`
	ErrorMessage string                 `json:"errorMessage,omitempty"`
	Payer        string                 `json:"payer,omitempty"`
	Transaction  string                 `json:"transaction"`
	Network      Network                `json:"network"`
	Amount       string                 `json:"amount,omitempty"`
	Extensions   map[string]interface{} `json:"extensions,omitempty"`
	Extra        map[string]interface{} `json:"extra,omitempty"`
}

type SettleResponseCoreSnapshot struct {
	Success      bool
	Transaction  string
	Network      Network
	Amount       string
	Payer        string
	ErrorReason  string
	ErrorMessage string
}

type SettleResultContext struct {
	SettleContext
	Result *SettleResponse
}

type SettlementOverrides struct {
	// Amount to settle. Supports three formats:
	//   - Raw atomic units: "1000" settles exactly 1000 atomic units.
	//   - Percent: "50%" settles 50% of PaymentRequirements.Amount (up to 2 decimal places, floored).
	//   - Dollar price: "$0.05" converts to atomic units using Extra["decimals"] (default 6).
	// The resolved amount must be <= the authorized maximum in PaymentRequirements.
	Amount string `json:"amount,omitempty"`
}

type SkipHandlerDirective struct {
	ContentType string
	Body        interface{}
}

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

type SupportedKind = types.SupportedKind

type SupportedResponse = types.SupportedResponse

type SupportedResponseV1 = types.SupportedResponseV1

type VerifiedPaymentCancelOptions struct {
	Reason         VerifiedPaymentCancellationReason
	Err            error
	ResponseStatus int
}

type VerifiedPaymentCanceledContext struct {
	SettleContext
	Reason         VerifiedPaymentCancellationReason
	Err            error
	ResponseStatus int
}

type VerifiedPaymentCancellationReason string

type VerifyContext struct {
	Ctx          context.Context
	Payload      PaymentPayloadView
	Requirements PaymentRequirementsView
	// DeclaredExtensions carries the extension declarations attached to the
	// route. Extension hooks gate on `DeclaredExtensions[extKey]` being set
	// before firing - mirrors TS `ctx.declaredExtensions[extensionKey]`.
	DeclaredExtensions map[string]interface{}
	PayloadBytes       []byte // Raw bytes for extensions needing full data
	RequirementsBytes  []byte // Raw bytes for extensions needing full data
}

type VerifyError struct {
	InvalidReason  string // Error reason/code (e.g., "insufficient_balance", "invalid_signature")
	Payer          string // Payer address (if known)
	InvalidMessage string // Optional invalid message details
}

type VerifyFailureContext struct {
	VerifyContext
	Error error
}

type VerifyFailureHookResult struct {
	Recovered bool
	Result    *VerifyResponse
}

type VerifyResponse struct {
	IsValid        bool                   `json:"isValid"`
	InvalidReason  string                 `json:"invalidReason,omitempty"`
	InvalidMessage string                 `json:"invalidMessage,omitempty"`
	Payer          string                 `json:"payer,omitempty"`
	Extensions     map[string]interface{} `json:"extensions,omitempty"`
	Extra          map[string]interface{} `json:"extra,omitempty"`

	// SkipHandler is an in-process directive set by an AfterVerifyHook that wants
	// the HTTP layer to bypass the resource handler and settle inline. It is never
	// serialized to the facilitator wire.
	SkipHandler *SkipHandlerDirective `json:"-"`
}

type VerifyResultContext struct {
	VerifyContext
	Result *VerifyResponse
}

type X402Client = x402Client

type X402Facilitator = x402Facilitator

type X402ResourceServer = x402ResourceServer