x402

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

type ClientConfig struct {
	// Signer signs payment authorizations.
	Signer Signer

	// MaxPayment is the maximum amount per request in token smallest units.
	// Zero or nil means no limit.
	MaxPayment *big.Int

	// HTTPClient is the underlying HTTP client. If nil, a default client is used.
	HTTPClient *http.Client

	// TokenName is the ERC-20 token name (default: "USD Coin").
	TokenName string

	// TokenVersion is the ERC-20 token version (default: "2").
	TokenVersion string
}

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

type FacilitatorConfig struct {
	// Registry is the processor registry for executing payments.
	Registry *processor.Registry

	// RemoteURL is the URL of a remote facilitator service.
	// If set, settlement is delegated to this service.
	RemoteURL string

	// TokenName is the ERC-20 token name (default: "USD Coin").
	TokenName string

	// TokenVersion is the ERC-20 token version (default: "2").
	TokenVersion string
}

type PaymentAuthorization struct {
	From        string `json:"from"`        // Payer address
	To          string `json:"to"`          // Facilitator address
	Value       string `json:"value"`       // Amount
	ValidAfter  int64  `json:"validAfter"`  // Unix timestamp
	ValidBefore int64  `json:"validBefore"` // Unix timestamp
	Nonce       string `json:"nonce"`       // Random 32-byte nonce (hex)
	Signature   string `json:"signature"`   // EIP-712 signature (hex)
}

type PaymentReceipt struct {
	RequestHash string `json:"requestHash"`
	Payer       string `json:"payer"`
	Payee       string `json:"payee"`
	Amount      string `json:"amount"`
	TxHash      string `json:"txHash"`
	Timestamp   int64  `json:"timestamp"`
	Success     bool   `json:"success"`
}

type PaymentRequest struct {
	Version     string `json:"version"`
	Network     string `json:"network"`
	ChainID     int64  `json:"chainId"`
	Facilitator string `json:"facilitator"` // Facilitator contract address
	Payee       string `json:"payee"`       // Merchant/resource owner address
	Token       string `json:"token"`       // Token contract address (e.g., USDC)
	Amount      string `json:"amount"`      // Amount in token's smallest unit
	Resource    string `json:"resource"`    // The resource path being paid for
	ValidFor    int64  `json:"validFor"`    // Validity window in seconds
}

type PaywallConfig struct {
	// Facilitator is the default facilitator contract address.
	Facilitator string

	// Payee is the default payee address (merchant).
	Payee string

	// Token is the default payment token address (USDC).
	Token string

	// Network is the default network name.
	Network string

	// ChainID is the default chain ID.
	ChainID int64

	// Routes maps path patterns to their payment configuration.
	// If a path is not in this map, it passes through without payment.
	Routes map[string]*RouteConfig

	// FacilitatorURL is the URL of the facilitator service for settlement.
	FacilitatorURL string
}

type RouteConfig struct {
	Path        string // URL path pattern
	Payee       string // Merchant address for this route
	Token       string // Token address (default: USDC)
	Amount      string // Amount in smallest token unit
	Network     string // Network name (default: "lux")
	ChainID     int64  // Chain ID (default: 96369)
	Facilitator string // Facilitator contract address
	ValidFor    int64  // Validity window in seconds
}

type Signer interface {
	// Address returns the signer's Ethereum address.
	Address() string

	// SignDigest signs a 32-byte EIP-712 digest and returns a 65-byte
	// [R(32) || S(32) || V(1)] signature.
	SignDigest(digest [32]byte) ([]byte, error)
}