What Are Periphery Contracts?
Periphery contracts support the PaymentOperator but are not the operator itself. They handle escrow storage, token collection, refund workflows, and evidence submission.Contract Map
| Contract | Role | Type |
|---|---|---|
| Commerce Payments | AuthCaptureEscrow + ERC3009PaymentCollector (base layer) | Singleton |
| RefundRequest | Tracks refund request lifecycle and approvals | Singleton |
| RefundRequestEvidence | On-chain evidence submission for disputes | Singleton |
| ReceiverRefundCollector | Pulls funds from receiver for post-escrow refunds | Singleton |
Contract Addresses
All periphery contracts use unified CREATE3 addresses — the same address on every supported chain.| Contract | Address |
|---|---|
| AuthCaptureEscrow | 0xe050bB89eD43BB02d71343063824614A7fb80B77 |
| ERC3009PaymentCollector | 0xcE66Ab399EDA513BD12760b6427C87D6602344a7 |
| ProtocolFeeConfig | 0x7e868A42a458fa2443b6259419aA6A8a161E08c8 |
| ReceiverRefundCollector | 0xE5500a38BE45a6C598420fbd7867ac85EC451A07 |
| RefundRequestEvidence | 0xF97aAB816b7cbe53025454ad05b03cf5C361F1BA |
Factories
| Factory | Address |
|---|---|
| PaymentOperatorFactory | 0x4D9BC2Ba2D0d9AFb6B63E3afBbfC95143E6E8Da9 |
| EscrowPeriodFactory | 0x15DB06aADEB3a39D47756Bf864a173cc48bafe24 |
| FreezeFactory | 0xdf129EFFE040c3403aca597c0F0bb704859a78Fd |
| StaticFeeCalculatorFactory | 0x6CDdBdB46e2d7Caae31A6b213B59a1412d7f16Ac |
| StaticAddressConditionFactory | 0xfB09350b200fda7dDd06565F5296A0CA625311d5 |
| AndConditionFactory | 0x5a1F3b6d030D25a2B86aAE469Ae1216ef3be308D |
| OrConditionFactory | 0x101B2fac8cdC6348E541A0ef087275dA62AA13A0 |
| NotConditionFactory | 0x1D58f97843579356863d3393ebe24feEd76ceefF |
| RecorderCombinatorFactory | 0xACf2b5e21CFc14135C9cD43ebE96a481F184C1A1 |
Condition Singletons
| Condition | Address |
|---|---|
| PayerCondition | 0x33F5F1154A02d0839266EFd23Fd3b85a3505bB4B |
| ReceiverCondition | 0xF41974A853940Ff4c18d46B6565f973c1180E171 |
| AlwaysTrueCondition | 0xb295df7E7f786fd84D614AB26b1f2e86026C3483 |
All addresses are available programmatically via
@x402r/core’s getChainConfig(chainId). See SDK Installation for details.Next Steps
Commerce Payments
AuthCaptureEscrow and ERC3009PaymentCollector.
RefundRequest
Refund request lifecycle and approvals.
PaymentOperator
The core operator contract.