Overview
You can create custom conditions for specialized logic beyond what the built-in conditions provide. Implement the ICondition interface and follow the security rules below.
ICondition Rules
From the ICondition.sol NatSpec:
- MUST NOT revert — return
false to deny, never revert
- Should be
view or pure — no state-changing operations
- No external calls — avoid calling other contracts to prevent reentrancy risks
- Return
true to allow, false to deny
The operator converts a false return into a ConditionNotMet revert.
Example: TimeOfDayCondition
A condition that only allows actions during specific hours (UTC):
contract TimeOfDayCondition is ICondition {
uint256 public immutable startHour; // e.g., 9 (9 AM)
uint256 public immutable endHour; // e.g., 17 (5 PM)
constructor(uint256 _startHour, uint256 _endHour) {
startHour = _startHour;
endHour = _endHour;
}
function check(
PaymentInfo calldata payment,
uint256,
address caller
) external view returns (bool) {
uint256 hour = (block.timestamp / 3600) % 24;
return hour >= startHour && hour < endHour;
}
}
// Deploy via your custom factory
const businessHours = await timeOfDayConditionFactory.write.deploy([9, 17]);
// Use in operator config
config.releaseCondition = businessHours;
Security Checklist
Before deploying a custom condition:
Custom conditions with bugs can lead to permanently locked funds (if check() always returns false) or unauthorized access (if check() always returns true). Test thoroughly on testnet before mainnet deployment.
Testing
Test custom conditions with Forge:
contract TimeOfDayConditionTest is Test {
TimeOfDayCondition condition;
function setUp() public {
condition = new TimeOfDayCondition(9, 17);
}
function test_allowsDuringBusinessHours() public {
// Set block.timestamp to 10 AM UTC
vm.warp(10 * 3600);
assertTrue(condition.check(paymentInfo, 0, caller));
}
function test_deniesOutsideBusinessHours() public {
// Set block.timestamp to 8 PM UTC
vm.warp(20 * 3600);
assertFalse(condition.check(paymentInfo, 0, caller));
}
}
Next Steps
