mechanisms/evm/batch-settlement

const (
	// SchemeBatched is the scheme identifier for batch settlement.
	SchemeBatched = "batch-settlement"

	// BatchSettlementAddress is the deployed x402BatchSettlement contract address (CREATE2, all chains).
	BatchSettlementAddress = "0x4020074e9dF2ce1deE5A9C1b5c3f541D02a10003"

	// ERC3009DepositCollectorAddress is the deployed ERC3009DepositCollector contract address.
	ERC3009DepositCollectorAddress = "0x4020806089470a89826cB9fB1f4059150b550004"

	// Permit2DepositCollectorAddress is the deployed Permit2DepositCollector contract address.
	Permit2DepositCollectorAddress = "0x4020425FAf3B746C082C2f942b4E5159887B0005"

	// MinWithdrawDelay is the minimum withdraw delay in seconds (15 minutes).
	MinWithdrawDelay = 900

	// MaxWithdrawDelay is the maximum withdraw delay in seconds (30 days).
	MaxWithdrawDelay = 2_592_000
)

const (

	// ErrCumulativeBelowClaimed is the canonical value of
	// `facilitator.ErrMaxClaimableTooLow`. Surfaced both by the facilitator
	// (as a verify rejection) AND by the resource server's corrective 402
	// recovery handshake - clients accept it as a signal to refresh
	// channel state and retry. Defined here so `client/scheme.go` can match
	// it without importing the facilitator package.
	ErrCumulativeBelowClaimed = "invalid_batch_settlement_evm_cumulative_below_claimed"

	// ErrCumulativeAmountMismatch signals a recoverable 402 from the resource
	// server when the client's signed cumulative disagrees with the server's
	// tracked state. Clients refresh from the corrective ChannelState in
	// requirements.extra and retry.
	ErrCumulativeAmountMismatch = "invalid_batch_settlement_evm_cumulative_amount_mismatch"

	// ErrChannelBusy signals that another request is currently holding the
	// per-channel concurrency lock. Clients should back off briefly and
	// retry. Emitted by AfterVerifyHook / BeforeSettleHook when a pending
	// request is in flight.
	ErrChannelBusy = "invalid_batch_settlement_evm_channel_busy"

	// ErrInvalidChannelId signals a non-canonical channel id (not `0x` + 64 hex).
	// Surfaced by binding checks and storage key normalization so untrusted
	// ids never reach path builders or map keys.
	ErrInvalidChannelId = "invalid_batch_settlement_evm_channel_id_invalid"

	// ErrChannelIdMismatch signals that a claimed channel id does not match
	// the EIP-712 hash of the payload's channelConfig for the payment network.
	// Duplicated from facilitator/errors.go so utils can reference it without
	// importing facilitator (which would cycle).
	ErrChannelIdMismatch = "invalid_batch_settlement_evm_channel_id_mismatch"

	// ErrVerificationStateUnavailable signals that the resource server could
	// not establish local verification state (storage failure, missing
	// reservation context). Fail-closed - clients should retry.
	ErrVerificationStateUnavailable = "invalid_batch_settlement_evm_verification_state_unavailable"

	// ErrMissingChannel signals that the server has no record of the
	// channel referenced by the payload. Emitted by BeforeSettleHook for
	// voucher and refund payloads when no session exists for the computed
	// channelId.
	ErrMissingChannel = "invalid_batch_settlement_evm_missing_channel"

	// ErrChargeExceedsSignedCumulative signals that committing this voucher
	// would push the server-tracked chargedCumulativeAmount above the
	// voucher's signed maxClaimableAmount cap. Emitted by BeforeSettleHook's
	// voucher-commit path; clients must re-sign with a larger cap.
	ErrChargeExceedsSignedCumulative = "invalid_batch_settlement_evm_charge_exceeds_signed_cumulative"

	// ErrRefundNoBalance signals that a cooperative refund request hit a
	// channel with no remaining refundable balance (post-claim). Non-
	// recoverable - the client must abandon the refund. Emitted by
	// BeforeSettleHook's refund-rewrite path.
	ErrRefundNoBalance = "invalid_batch_settlement_evm_refund_no_balance"

	// ErrRefundAmountInvalid signals the client requested a malformed refund
	// amount (non-numeric or non-positive). Non-recoverable - the client
	// must fix the request before retrying.
	ErrRefundAmountInvalid = "invalid_batch_settlement_evm_refund_amount_invalid"

	// ErrRefundAmountExceedsBalance signals the client requested a refund
	// larger than the channel's available balance. Non-recoverable; client
	// should retry with a smaller amount or omit `amount` for a full refund.
	ErrRefundAmountExceedsBalance = "invalid_batch_settlement_evm_refund_amount_exceeds_balance"
)

const ChannelConfigTypeString = "ChannelConfig(address payer,address payerAuthorizer,address receiver,address receiverAuthorizer,address token,uint40 withdrawDelay,bytes32 salt)"

const DepositWitnessTypeString = "DepositWitness witness)DepositWitness(bytes32 channelId)TokenPermissions(address token,uint256 amount)"

const Permit2Address = "0x000000000022D473030F116dDEE9F6B43aC78BA3"

const Permit2DomainName = "Permit2"

const (
	// AssetTransferMethodEip3009 is the default - uses USDC's
	// `transferWithAuthorization` (EIP-3009) via the ERC3009DepositCollector.
	AssetTransferMethodEip3009 AssetTransferMethod = "eip3009"

	// AssetTransferMethodPermit2 funds the deposit via a channel-bound
	// `PermitWitnessTransferFrom` against the universal Permit2 contract,
	// brokered by the Permit2DepositCollector.
	AssetTransferMethodPermit2 AssetTransferMethod = "permit2"
)

var BatchPermit2WitnessTypes = map[string][]evm.TypedDataField{
	"PermitWitnessTransferFrom": {
		{Name: "permitted", Type: "TokenPermissions"},
		{Name: "spender", Type: "address"},
		{Name: "nonce", Type: "uint256"},
		{Name: "deadline", Type: "uint256"},
		{Name: "witness", Type: "DepositWitness"},
	},
	"TokenPermissions": {
		{Name: "token", Type: "address"},
		{Name: "amount", Type: "uint256"},
	},
	"DepositWitness": {
		{Name: "channelId", Type: "bytes32"},
	},
}

var BatchSettlementChannelsABI = []byte(`[
	{
		"type": "function",
		"name": "channels",
		"inputs": [{"name": "channelId", "type": "bytes32"}],
		"outputs": [
			{"name": "balance", "type": "uint128"},
			{"name": "totalClaimed", "type": "uint128"}
		],
		"stateMutability": "view"
	}
]`)

var BatchSettlementClaimABI = []byte(`[
	{
		"type": "function",
		"name": "claim",
		"inputs": [
			{
				"name": "voucherClaims",
				"type": "tuple[]",
				"components": [
					{
						"name": "voucher",
						"type": "tuple",
						"components": [
							{"name": "channel", "type": "tuple", "components": ` + channelConfigComponentsJSON + `},
							{"name": "maxClaimableAmount", "type": "uint128"}
						]
					},
					{"name": "signature", "type": "bytes"},
					{"name": "totalClaimed", "type": "uint128"}
				]
			}
		],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementClaimWithSignatureABI = []byte(`[
	{
		"type": "function",
		"name": "claimWithSignature",
		"inputs": [
			{
				"name": "voucherClaims",
				"type": "tuple[]",
				"components": [
					{
						"name": "voucher",
						"type": "tuple",
						"components": [
							{"name": "channel", "type": "tuple", "components": ` + channelConfigComponentsJSON + `},
							{"name": "maxClaimableAmount", "type": "uint128"}
						]
					},
					{"name": "signature", "type": "bytes"},
					{"name": "totalClaimed", "type": "uint128"}
				]
			},
			{"name": "authorizerSignature", "type": "bytes"}
		],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementDepositABI = []byte(`[
	{
		"type": "function",
		"name": "deposit",
		"inputs": [
			{"name": "config", "type": "tuple", "components": ` + channelConfigComponentsJSON + `},
			{"name": "amount", "type": "uint128"},
			{"name": "collector", "type": "address"},
			{"name": "collectorData", "type": "bytes"}
		],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementDomain = evm.TypedDataDomain{
	Name:    "x402 Batch Settlement",
	Version: "1",
}

var BatchSettlementFinalizeWithdrawABI = []byte(`[
	{
		"type": "function",
		"name": "finalizeWithdraw",
		"inputs": [{"name": "config", "type": "tuple", "components": ` + channelConfigComponentsJSON + `}],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementGetChannelIdABI = []byte(`[
	{
		"type": "function",
		"name": "getChannelId",
		"inputs": [{"name": "config", "type": "tuple", "components": ` + channelConfigComponentsJSON + `}],
		"outputs": [{"name": "", "type": "bytes32"}],
		"stateMutability": "pure"
	}
]`)

var BatchSettlementInitiateWithdrawABI = []byte(`[
	{
		"type": "function",
		"name": "initiateWithdraw",
		"inputs": [
			{"name": "config", "type": "tuple", "components": ` + channelConfigComponentsJSON + `},
			{"name": "amount", "type": "uint128"}
		],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementMulticallABI = []byte(`[
	{
		"type": "function",
		"name": "multicall",
		"inputs": [{"name": "data", "type": "bytes[]"}],
		"outputs": [{"name": "results", "type": "bytes[]"}],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementPendingWithdrawalsABI = []byte(`[
	{
		"type": "function",
		"name": "pendingWithdrawals",
		"inputs": [{"name": "channelId", "type": "bytes32"}],
		"outputs": [
			{"name": "amount", "type": "uint128"},
			{"name": "initiatedAt", "type": "uint40"}
		],
		"stateMutability": "view"
	}
]`)

var BatchSettlementReceiversABI = []byte(`[
	{
		"type": "function",
		"name": "receivers",
		"inputs": [
			{"name": "receiver", "type": "address"},
			{"name": "token", "type": "address"}
		],
		"outputs": [
			{"name": "totalClaimed", "type": "uint128"},
			{"name": "totalSettled", "type": "uint128"}
		],
		"stateMutability": "view"
	}
]`)

var BatchSettlementRefundABI = []byte(`[
	{
		"type": "function",
		"name": "refund",
		"inputs": [
			{"name": "config", "type": "tuple", "components": ` + channelConfigComponentsJSON + `},
			{"name": "amount", "type": "uint128"}
		],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementRefundNonceABI = []byte(`[
	{
		"type": "function",
		"name": "refundNonce",
		"inputs": [{"name": "channelId", "type": "bytes32"}],
		"outputs": [{"name": "", "type": "uint256"}],
		"stateMutability": "view"
	}
]`)

var BatchSettlementRefundWithSignatureABI = []byte(`[
	{
		"type": "function",
		"name": "refundWithSignature",
		"inputs": [
			{"name": "config", "type": "tuple", "components": ` + channelConfigComponentsJSON + `},
			{"name": "amount", "type": "uint128"},
			{"name": "nonce", "type": "uint256"},
			{"name": "receiverAuthorizerSignature", "type": "bytes"}
		],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var BatchSettlementSettleABI = []byte(`[
	{
		"type": "function",
		"name": "settle",
		"inputs": [
			{"name": "receiver", "type": "address"},
			{"name": "token", "type": "address"}
		],
		"outputs": [],
		"stateMutability": "nonpayable"
	}
]`)

var ChannelConfigTypeHash = crypto.Keccak256([]byte(ChannelConfigTypeString))

var ChannelConfigTypes = map[string][]evm.TypedDataField{
	"ChannelConfig": {
		{Name: "payer", Type: "address"},
		{Name: "payerAuthorizer", Type: "address"},
		{Name: "receiver", Type: "address"},
		{Name: "receiverAuthorizer", Type: "address"},
		{Name: "token", Type: "address"},
		{Name: "withdrawDelay", Type: "uint40"},
		{Name: "salt", Type: "bytes32"},
	},
}

var ClaimBatchTypes = map[string][]evm.TypedDataField{
	"ClaimBatch": {
		{Name: "claims", Type: "ClaimEntry[]"},
	},
	"ClaimEntry": {
		{Name: "channelId", Type: "bytes32"},
		{Name: "maxClaimableAmount", Type: "uint128"},
		{Name: "totalClaimed", Type: "uint128"},
	},
}

var ReceiveAuthorizationTypes = map[string][]evm.TypedDataField{
	"ReceiveWithAuthorization": {
		{Name: "from", Type: "address"},
		{Name: "to", Type: "address"},
		{Name: "value", Type: "uint256"},
		{Name: "validAfter", Type: "uint256"},
		{Name: "validBefore", Type: "uint256"},
		{Name: "nonce", Type: "bytes32"},
	},
}

var RefundTypes = map[string][]evm.TypedDataField{
	"Refund": {
		{Name: "channelId", Type: "bytes32"},
		{Name: "nonce", Type: "uint256"},
		{Name: "amount", Type: "uint128"},
	},
}

var VoucherTypes = map[string][]evm.TypedDataField{
	"Voucher": {
		{Name: "channelId", Type: "bytes32"},
		{Name: "maxClaimableAmount", Type: "uint128"},
	},
}