relayer

type APIKey struct {
	// Key is the API key.
	Key string `json:"apiKey"`
	// Address is the owner address.
	Address string `json:"address"`
	// CreatedAt is the key creation timestamp.
	CreatedAt pmtypes.Time `json:"createdAt"`
	// UpdatedAt is the key update timestamp.
	UpdatedAt pmtypes.Time `json:"updatedAt"`
}

type BuilderCredentials struct {
	// APIKey is the builder API key.
	APIKey string
	// Secret is the URL-safe base64 builder API secret.
	Secret string
	// Passphrase is the builder API passphrase.
	Passphrase string
}

type CallType string

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

type Config struct {
	// Host is the Relayer API host.
	Host string
	// HTTPClient is the client used for HTTP requests.
	HTTPClient *http.Client
	// UserAgent sets the User-Agent header.
	UserAgent string
	// Credentials configures Relayer API-key authentication.
	Credentials *Credentials
	// BuilderCredentials configures builder-key authentication.
	BuilderCredentials *BuilderCredentials
}

type Credentials struct {
	// APIKey is the relayer API key.
	APIKey string
	// Address is the owner address for APIKey.
	Address string
}

type DepositWalletCall struct {
	// Target is the contract address to call.
	Target string `json:"target"`
	// Value is the native token value for the call.
	Value string `json:"value"`
	// Data is 0x-prefixed calldata.
	Data string `json:"data"`
}

type DepositWalletParams struct {
	// DepositWallet is the deterministic deposit wallet address.
	DepositWallet string `json:"depositWallet"`
	// Deadline is the Unix timestamp after which the batch is invalid.
	Deadline string `json:"deadline"`
	// Calls are the wallet calls executed by the batch.
	Calls []DepositWalletCall `json:"calls"`
}

type NonceResponse struct {
	// Nonce is the current relayer nonce.
	Nonce pmtypes.String `json:"nonce"`
	// Address is the associated relayer or user address when present.
	Address string `json:"address,omitempty"`
}

type NonceType string

type OperationType uint8

type ProxySubmitTransactionArgs struct {
	// From is the EOA signer address. If empty, signer.Address() is used.
	From string
	// ProxyWallet is the user's Polymarket proxy wallet / funder address.
	// Required. Do not derive it unless the official CREATE2 formula is fully verified.
	ProxyWallet string
	// Data is encoded proxy transaction batch calldata.
	Data string
	// Metadata is optional relayer metadata.
	Metadata string
	// GasLimit optionally overrides the computed proxy gas limit.
	GasLimit string
}

type ProxyTransaction struct {
	To       string   `json:"to"`
	TypeCode CallType `json:"typeCode"`
	Data     string   `json:"data"`
	Value    string   `json:"value"`
}

type SafeDeployedResponse struct {
	// Address is the Safe wallet address queried.
	Address string `json:"address,omitempty"`
	// Deployed is true when the Safe is deployed.
	Deployed bool `json:"deployed"`
}

type SafeSubmitTransactionArgs struct {
	// From is the EOA signer address. If empty, signer.Address() is used.
	From string
	// ProxyWallet is the Safe wallet address. If empty, it is derived from From.
	ProxyWallet string
	// ChainID is the EIP-712 chain id.
	ChainID int64
	// Transactions are Safe transactions. Multiple transactions are wrapped in MultiSend.
	Transactions []SafeTransaction
	// Metadata is optional caller-provided relayer metadata.
	Metadata string
}

type SafeTransaction struct {
	To        string        `json:"to"`
	Operation OperationType `json:"operation"`
	Data      string        `json:"data"`
	Value     string        `json:"value"`
}

type SignatureParams struct {
	// Existing SAFE fields.
	// GasPrice is the Safe gas price parameter.
	GasPrice string `json:"gasPrice,omitempty"`
	// Operation is the Safe operation parameter.
	Operation string `json:"operation,omitempty"`
	// SafeTxGas is the Safe transaction gas parameter.
	SafeTxGas string `json:"safeTxnGas,omitempty"`
	// BaseGas is the Safe base gas parameter.
	BaseGas string `json:"baseGas,omitempty"`
	// GasToken is the token used for gas refunds.
	GasToken string `json:"gasToken,omitempty"`
	// RefundReceiver is the address receiving gas refunds.
	RefundReceiver string `json:"refundReceiver,omitempty"`

	// PROXY fields.
	GasLimit   string `json:"gasLimit,omitempty"`
	RelayerFee string `json:"relayerFee,omitempty"`
	RelayHub   string `json:"relayHub,omitempty"`
	Relay      string `json:"relay,omitempty"`
}

type SubmitTransactionRequest struct {
	// From is the signer/owner address.
	From string `json:"from"`
	// To is the target contract address.
	// For WALLET-CREATE this is the deposit wallet factory.
	To string `json:"to"`
	// ProxyWallet is the user's Polymarket proxy/safe wallet for legacy relayer flows.
	ProxyWallet string `json:"proxyWallet,omitempty"`
	// Data is 0x-prefixed encoded transaction calldata for legacy relayer flows.
	Data string `json:"data,omitempty"`
	// Nonce is the relayer transaction nonce.
	Nonce string `json:"nonce,omitempty"`
	// Signature is the 0x-prefixed transaction signature.
	// WALLET-CREATE does not require a user signature.
	Signature string `json:"signature,omitempty"`
	// SignatureParams are Safe/proxy transaction parameters.
	SignatureParams *SignatureParams `json:"signatureParams,omitempty"`
	// Type is the transaction type: SAFE, PROXY, WALLET, or WALLET-CREATE.
	Type NonceType `json:"type"`
	// DepositWalletParams contains WALLET batch payload details.
	DepositWalletParams *DepositWalletParams `json:"depositWalletParams,omitempty"`
	// Metadata is optional caller-provided transaction metadata.
	Metadata string `json:"metadata,omitempty"`
	// Value is the native token value for the call when required.
	Value string `json:"value,omitempty"`
}

type SubmitTransactionResponse struct {
	// TransactionID is the relayer transaction identifier.
	TransactionID string `json:"transactionID"`
	// State is the current relayer state.
	State string `json:"state"`
}

type Transaction struct {
	// TransactionID is the relayer transaction identifier.
	TransactionID string `json:"transactionID"`
	// State is the current relayer state.
	State string `json:"state"`
	// TransactionHash is the on-chain hash after broadcast.
	TransactionHash string `json:"transactionHash"`
	// From is the signer address.
	From string `json:"from"`
	// To is the target contract address.
	To string `json:"to"`
	// ProxyWallet is the user's Polymarket proxy wallet.
	ProxyWallet string `json:"proxyWallet"`
	// Data is the 0x-prefixed calldata submitted to the relayer.
	Data string `json:"data"`
	// Nonce is the transaction nonce.
	Nonce pmtypes.String `json:"nonce"`
	// Value is the transaction value.
	Value pmtypes.String `json:"value"`
	// Signature is the 0x-prefixed transaction signature.
	Signature string `json:"signature"`
	// Type is the transaction type.
	Type NonceType `json:"type"`
	// Owner is the transaction owner.
	Owner string `json:"owner"`
	// Metadata is the transaction metadata.
	Metadata string `json:"metadata"`
	// CreatedAt is the creation timestamp.
	CreatedAt pmtypes.Time `json:"createdAt"`
	// UpdatedAt is the last update timestamp.
	UpdatedAt pmtypes.Time `json:"updatedAt"`
}

type WalletCreateSubmitTransactionArgs struct {
	// From is the owner address. If empty, signer.Address() is used.
	From string
	// Factory is the deposit wallet factory address. If empty, PolygonDepositWalletFactory is used.
	Factory string
}