feat(aggregation-mode): add subscription limit and arbitrary expiration lists

[maximopalopoli]

Description

This PR makes two changes to the Aggregation Mode Payment Service contract:

• Adds a total subscription limit to be reset each month.
• Adds an onlyOwner endpoint to add a custom expiration subscription for a list of addresses.

How to test

1. Start anvil:

make anvil_start

2. Start agg mode batcher:

make agg_mode_batcher_start_local

Note: If you see a Migrations to run correctly: VersionMismatch(1) error, you have to clean the DB by running make agg_mode_docker_clean.

Subscription limit

We are lowering the limit and then subscribing with some Anvil rich accounts.

i. Lower the limit:

cast send 0x922D6956C99E12DFeB3224DEA977D0939758A1Fe "setSubscriptionLimit(uint256)" 2 --rpc-url http://127.0.0.1:8545 --private-key 0x4bbbf85ce3377467afe5d46f804f221813b2bb87f24d81f60f1fcdbf7cbf4356

ii. Transfer to the contract with 2 rich accounts:

cast send --value 1ether \
0x922D6956C99E12DFeB3224DEA977D0939758A1Fe \
--private-key 0x47e179ec197488593b187f80a00eb0da91f1b9d0b13f8733639f19c30a34926a
cast send --value 1ether \
0x922D6956C99E12DFeB3224DEA977D0939758A1Fe \
--private-key 0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a

iii. Try to transfer with the example account with make agg_mode_batcher_send_payment, you should see an error, the custom error 0xdd6af2ad. This means the current subscription amount has reached the established limit.

iv. Increase the limit up to 3:

cast send 0x922D6956C99E12DFeB3224DEA977D0939758A1Fe "setSubscriptionLimit(uint256)" 3 --rpc-url http://127.0.0.1:8545 --private-key 0x4bbbf85ce3377467afe5d46f804f221813b2bb87f24d81f60f1fcdbf7cbf4356

Now, if you retry step 3, you should be able to subscribe.

Custom expiration subscriptions

Add a custom expiration for the example's address:

cast send 0x922D6956C99E12DFeB3224DEA977D0939758A1Fe \
"addSubscriptions(address[],uint256)" \
'[0x70997970C51812dc3A010C7d01b50e0d17dc79C8]' \
<5-mins-in-future-utc-seconds> \
--rpc-url http://127.0.0.1:8545 \
--private-key 0xdbda1821b80551c9d65939329250298aa3472ba22feea921c0cf5d620ea67b97

Note that you should put the UTC seconds value for the next 5 minutes (for getting this I used this tool).

Now try to send a proof with make agg_mode_batcher_send_sp1_proof, and if you try in 5 minutes, you should not be able to send more.

You can test the Access Roles feature by calling the addSubscriptions method using the owner address (which is not the same as the admin one):

cast send 0x922D6956C99E12DFeB3224DEA977D0939758A1Fe \
"addArbitraryExpirationSubscriptions(address[],uint256)" \
'[0x70997970C51812dc3A010C7d01b50e0d17dc79C8]' \
<5-mins-in-future-utc-seconds> \
--rpc-url http://127.0.0.1:8545 \
--private-key 0x4bbbf85ce3377467afe5d46f804f221813b2bb87f24d81f60f1fcdbf7cbf4356

Type of change

Please delete options that are not relevant.

• New feature
• Bug fix
• Optimization
• Refactor

Checklist

• “Hotfix” to testnet, everything else to staging
• Linked to Github Issue
• This change depends on code or research by an external entity
  • Acknowledgements were updated to give credit
• Unit tests added
• This change requires new documentation.
  • Documentation has been added/updated.
• This change is an Optimization
  • Benchmarks added/run
• Has a known issue
  • Link to the open issue addressing it
• If your PR changes the Operator compatibility (Ex: Upgrade prover versions)
  • This PR adds compatibility for operator for both versions and do not change crates/docs/examples
  • This PR updates batcher and docs/examples to the newer version. This requires the operator are already updated to be compatible

[github-actions]

Changes to gas cost

Generated at commit: ead8fc4ffaccbe24f54c555d7d59e61cdcc77fe2, compared to commit: d623ed01c89d39de1ff02ed487f330a139c22c33

🧾 Summary (10% most significant diffs)

Contract	Method	Avg (+/-)	%
AlignedLayerServiceManager	createNewTask	+78 ❌	+0.10%

---

Full diff report 👇

Contract	Deployment Cost (+/-)	Method	Min (+/-)	%	Avg (+/-)	%	Median (+/-)	%	Max (+/-)	%	# Calls (+/-)
AlignedLayerServiceManager	4,398,072 (0)	createNewTask receive	56,886 (+12) 23,301 (0)	+0.02% 0.00%	76,552 (+78) 46,463 (+93)	+0.10% +0.20%	77,026 (0) 47,115 (0)	0.00% 0.00%	77,860 (0) 47,115 (0)	0.00% 0.00%	256 (0) 256 (0)