@0xmonaco/contracts 1.0.35 → 1.0.36

package/dist/abis/index.d.ts

@@ -4,4 +4,6 @@
  * This module exports all contract ABIs for the Monaco protocol.
  * Each ABI provides type-safe contract interaction capabilities.
  */
+export { SWEEPER_ABI } from "./sweeper";
+export { SWEEPER_FACTORY_ABI } from "./sweeperFactory";
 export { VAULT_ABI } from "./vault";

package/dist/abis/index.js

@@ -4,4 +4,6 @@
  * This module exports all contract ABIs for the Monaco protocol.
  * Each ABI provides type-safe contract interaction capabilities.
  */
+export { SWEEPER_ABI } from "./sweeper"; // Per-(application, user) deposit address
+export { SWEEPER_FACTORY_ABI } from "./sweeperFactory"; // CREATE2 factory for sweepers
 export { VAULT_ABI } from "./vault"; // Vault for managing user balances

package/dist/abis/sweeper.d.ts

@@ -0,0 +1,128 @@
+export declare const SWEEPER_ABI: readonly [{
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "rollup_";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "constructor";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "InvalidAddress";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "NativeTransferFailed";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "NothingToSweep";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "OnlyClone";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly name: "SafeERC20FailedOperation";
+    readonly type: "error";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "Refunded";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "RefundedNative";
+    readonly type: "event";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly name: "Swept";
+    readonly type: "event";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "config";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly internalType: "string";
+        readonly name: "applicationId";
+        readonly type: "string";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "refundNative";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "rollup";
+    readonly outputs: readonly [{
+        readonly internalType: "contract IRollup";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly name: "sweep";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];

package/dist/abis/sweeper.js

@@ -0,0 +1,164 @@
+export const SWEEPER_ABI = [
+    {
+        inputs: [
+            {
+                internalType: "address",
+                name: "rollup_",
+                type: "address",
+            },
+        ],
+        stateMutability: "nonpayable",
+        type: "constructor",
+    },
+    {
+        inputs: [],
+        name: "InvalidAddress",
+        type: "error",
+    },
+    {
+        inputs: [],
+        name: "NativeTransferFailed",
+        type: "error",
+    },
+    {
+        inputs: [],
+        name: "NothingToSweep",
+        type: "error",
+    },
+    {
+        inputs: [],
+        name: "OnlyClone",
+        type: "error",
+    },
+    {
+        inputs: [
+            {
+                internalType: "address",
+                name: "token",
+                type: "address",
+            },
+        ],
+        name: "SafeERC20FailedOperation",
+        type: "error",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: "address",
+                name: "token",
+                type: "address",
+            },
+            {
+                indexed: true,
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+            {
+                indexed: false,
+                internalType: "uint256",
+                name: "amount",
+                type: "uint256",
+            },
+        ],
+        name: "Refunded",
+        type: "event",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+            {
+                indexed: false,
+                internalType: "uint256",
+                name: "amount",
+                type: "uint256",
+            },
+        ],
+        name: "RefundedNative",
+        type: "event",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: "address",
+                name: "token",
+                type: "address",
+            },
+            {
+                indexed: true,
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+            {
+                indexed: false,
+                internalType: "uint256",
+                name: "amount",
+                type: "uint256",
+            },
+        ],
+        name: "Swept",
+        type: "event",
+    },
+    {
+        inputs: [],
+        name: "config",
+        outputs: [
+            {
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+            {
+                internalType: "string",
+                name: "applicationId",
+                type: "string",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "refundNative",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "rollup",
+        outputs: [
+            {
+                internalType: "contract IRollup",
+                name: "",
+                type: "address",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "address",
+                name: "token",
+                type: "address",
+            },
+        ],
+        name: "sweep",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+];

package/dist/abis/sweeperFactory.d.ts

@@ -0,0 +1,163 @@
+export declare const SWEEPER_FACTORY_ABI: readonly [{
+    readonly inputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "rollup_";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "constructor";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "CloneArgumentsTooLong";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "Create2EmptyBytecode";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "FailedDeployment";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "balance";
+        readonly type: "uint256";
+    }, {
+        readonly internalType: "uint256";
+        readonly name: "needed";
+        readonly type: "uint256";
+    }];
+    readonly name: "InsufficientBalance";
+    readonly type: "error";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "InvalidAddress";
+    readonly type: "error";
+}, {
+    readonly anonymous: false;
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "sweeper";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "string";
+        readonly name: "applicationId";
+        readonly type: "string";
+    }];
+    readonly name: "SweeperDeployed";
+    readonly type: "event";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "string";
+        readonly name: "applicationId";
+        readonly type: "string";
+    }, {
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly name: "deploy";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "sweeper";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "implementation";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "string";
+        readonly name: "applicationId";
+        readonly type: "string";
+    }, {
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly name: "isDeployed";
+    readonly outputs: readonly [{
+        readonly internalType: "bool";
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "string";
+        readonly name: "applicationId";
+        readonly type: "string";
+    }, {
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly name: "refundNative";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "rollup";
+    readonly outputs: readonly [{
+        readonly internalType: "contract IRollup";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "string";
+        readonly name: "applicationId";
+        readonly type: "string";
+    }, {
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }, {
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly name: "sweep";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "string";
+        readonly name: "applicationId";
+        readonly type: "string";
+    }, {
+        readonly internalType: "address";
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly name: "sweeperFor";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}];

package/dist/abis/sweeperFactory.js

@@ -0,0 +1,213 @@
+export const SWEEPER_FACTORY_ABI = [
+    {
+        inputs: [
+            {
+                internalType: "address",
+                name: "rollup_",
+                type: "address",
+            },
+        ],
+        stateMutability: "nonpayable",
+        type: "constructor",
+    },
+    {
+        inputs: [],
+        name: "CloneArgumentsTooLong",
+        type: "error",
+    },
+    {
+        inputs: [],
+        name: "Create2EmptyBytecode",
+        type: "error",
+    },
+    {
+        inputs: [],
+        name: "FailedDeployment",
+        type: "error",
+    },
+    {
+        inputs: [
+            {
+                internalType: "uint256",
+                name: "balance",
+                type: "uint256",
+            },
+            {
+                internalType: "uint256",
+                name: "needed",
+                type: "uint256",
+            },
+        ],
+        name: "InsufficientBalance",
+        type: "error",
+    },
+    {
+        inputs: [],
+        name: "InvalidAddress",
+        type: "error",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: "address",
+                name: "sweeper",
+                type: "address",
+            },
+            {
+                indexed: true,
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+            {
+                indexed: false,
+                internalType: "string",
+                name: "applicationId",
+                type: "string",
+            },
+        ],
+        name: "SweeperDeployed",
+        type: "event",
+    },
+    {
+        inputs: [
+            {
+                internalType: "string",
+                name: "applicationId",
+                type: "string",
+            },
+            {
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+        ],
+        name: "deploy",
+        outputs: [
+            {
+                internalType: "address",
+                name: "sweeper",
+                type: "address",
+            },
+        ],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "implementation",
+        outputs: [
+            {
+                internalType: "address",
+                name: "",
+                type: "address",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "string",
+                name: "applicationId",
+                type: "string",
+            },
+            {
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+        ],
+        name: "isDeployed",
+        outputs: [
+            {
+                internalType: "bool",
+                name: "",
+                type: "bool",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "string",
+                name: "applicationId",
+                type: "string",
+            },
+            {
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+        ],
+        name: "refundNative",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "rollup",
+        outputs: [
+            {
+                internalType: "contract IRollup",
+                name: "",
+                type: "address",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "string",
+                name: "applicationId",
+                type: "string",
+            },
+            {
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+            {
+                internalType: "address",
+                name: "token",
+                type: "address",
+            },
+        ],
+        name: "sweep",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "string",
+                name: "applicationId",
+                type: "string",
+            },
+            {
+                internalType: "address",
+                name: "user",
+                type: "address",
+            },
+        ],
+        name: "sweeperFor",
+        outputs: [
+            {
+                internalType: "address",
+                name: "",
+                type: "address",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+];

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { type Hex, predictSweeperAddress, type SweeperAddressInput, sweeperCloneInitCode, sweeperImmutableArgs } from "./sweeper";
 /**
  * Contract ABIs for all protocol contracts.
  * These ABIs are used to interact with the deployed contracts.
@@ -760,6 +761,299 @@ export declare const CONTRACT_ABIS: {
         readonly stateMutability: "nonpayable";
         readonly type: "function";
     }];
+    /** Per-(application, user) sweeper deposit address ABI */
+    readonly sweeper: readonly [{
+        readonly inputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "rollup_";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "nonpayable";
+        readonly type: "constructor";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "InvalidAddress";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "NativeTransferFailed";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "NothingToSweep";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "OnlyClone";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "token";
+            readonly type: "address";
+        }];
+        readonly name: "SafeERC20FailedOperation";
+        readonly type: "error";
+    }, {
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly indexed: true;
+            readonly internalType: "address";
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly indexed: true;
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }, {
+            readonly indexed: false;
+            readonly internalType: "uint256";
+            readonly name: "amount";
+            readonly type: "uint256";
+        }];
+        readonly name: "Refunded";
+        readonly type: "event";
+    }, {
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly indexed: true;
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }, {
+            readonly indexed: false;
+            readonly internalType: "uint256";
+            readonly name: "amount";
+            readonly type: "uint256";
+        }];
+        readonly name: "RefundedNative";
+        readonly type: "event";
+    }, {
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly indexed: true;
+            readonly internalType: "address";
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly indexed: true;
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }, {
+            readonly indexed: false;
+            readonly internalType: "uint256";
+            readonly name: "amount";
+            readonly type: "uint256";
+        }];
+        readonly name: "Swept";
+        readonly type: "event";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "config";
+        readonly outputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }, {
+            readonly internalType: "string";
+            readonly name: "applicationId";
+            readonly type: "string";
+        }];
+        readonly stateMutability: "view";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "refundNative";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "rollup";
+        readonly outputs: readonly [{
+            readonly internalType: "contract IRollup";
+            readonly name: "";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "token";
+            readonly type: "address";
+        }];
+        readonly name: "sweep";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+        readonly type: "function";
+    }];
+    /** CREATE2 sweeper factory ABI */
+    readonly sweeperFactory: readonly [{
+        readonly inputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "rollup_";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "nonpayable";
+        readonly type: "constructor";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "CloneArgumentsTooLong";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "Create2EmptyBytecode";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "FailedDeployment";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "uint256";
+            readonly name: "balance";
+            readonly type: "uint256";
+        }, {
+            readonly internalType: "uint256";
+            readonly name: "needed";
+            readonly type: "uint256";
+        }];
+        readonly name: "InsufficientBalance";
+        readonly type: "error";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "InvalidAddress";
+        readonly type: "error";
+    }, {
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly indexed: true;
+            readonly internalType: "address";
+            readonly name: "sweeper";
+            readonly type: "address";
+        }, {
+            readonly indexed: true;
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }, {
+            readonly indexed: false;
+            readonly internalType: "string";
+            readonly name: "applicationId";
+            readonly type: "string";
+        }];
+        readonly name: "SweeperDeployed";
+        readonly type: "event";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "string";
+            readonly name: "applicationId";
+            readonly type: "string";
+        }, {
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }];
+        readonly name: "deploy";
+        readonly outputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "sweeper";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "nonpayable";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "implementation";
+        readonly outputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "string";
+            readonly name: "applicationId";
+            readonly type: "string";
+        }, {
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }];
+        readonly name: "isDeployed";
+        readonly outputs: readonly [{
+            readonly internalType: "bool";
+            readonly name: "";
+            readonly type: "bool";
+        }];
+        readonly stateMutability: "view";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "string";
+            readonly name: "applicationId";
+            readonly type: "string";
+        }, {
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }];
+        readonly name: "refundNative";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [];
+        readonly name: "rollup";
+        readonly outputs: readonly [{
+            readonly internalType: "contract IRollup";
+            readonly name: "";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "string";
+            readonly name: "applicationId";
+            readonly type: "string";
+        }, {
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }, {
+            readonly internalType: "address";
+            readonly name: "token";
+            readonly type: "address";
+        }];
+        readonly name: "sweep";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+        readonly type: "function";
+    }, {
+        readonly inputs: readonly [{
+            readonly internalType: "string";
+            readonly name: "applicationId";
+            readonly type: "string";
+        }, {
+            readonly internalType: "address";
+            readonly name: "user";
+            readonly type: "address";
+        }];
+        readonly name: "sweeperFor";
+        readonly outputs: readonly [{
+            readonly internalType: "address";
+            readonly name: "";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+        readonly type: "function";
+    }];
 };
 export declare const TESTNET_TOKENS: {
     readonly MockUSDC: {

package/dist/index.js

@@ -5,7 +5,8 @@
  * This package provides the interface definitions and deployed addresses
  * for all Monaco protocol contracts.
  */
-import { VAULT_ABI } from "./abis";
+import { SWEEPER_ABI, SWEEPER_FACTORY_ABI, VAULT_ABI } from "./abis";
+export { predictSweeperAddress, sweeperCloneInitCode, sweeperImmutableArgs } from "./sweeper";
 /**
  * Contract ABIs for all protocol contracts.
  * These ABIs are used to interact with the deployed contracts.
@@ -24,6 +25,10 @@ import { VAULT_ABI } from "./abis";
 export const CONTRACT_ABIS = {
     /** Vault contract ABI */
     vault: VAULT_ABI,
+    /** Per-(application, user) sweeper deposit address ABI */
+    sweeper: SWEEPER_ABI,
+    /** CREATE2 sweeper factory ABI */
+    sweeperFactory: SWEEPER_FACTORY_ABI,
 };
 export const TESTNET_TOKENS = {
     MockUSDC: {

package/dist/sweeper.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Off-chain derivation of Monaco sweeper deposit addresses.
+ *
+ * A sweeper is an EIP-1167 clone deployed by `SweeperFactory` at a CREATE2
+ * address determined by the (clientId, user) pair it is bound to. The address
+ * can therefore be shown to a user — and funded — before any contract exists
+ * there, without an RPC round trip.
+ *
+ * The client id is the application's identifier as used for rollup deposits
+ * (the string `sdk.login` takes). It is hashed **byte-for-byte**: two
+ * spellings derive two different, both-valid addresses, so the exact string
+ * of the registered application must be used — the backend rejects unknown
+ * spellings at registration because the lookup is an exact match.
+ */
+export type Hex = `0x${string}`;
+export interface SweeperAddressInput {
+    /** Address of the deployed `SweeperFactory`. */
+    factory: string;
+    /** Address of the `Sweeper` implementation the factory clones. */
+    implementation: string;
+    /**
+     * The application's client id, exactly as registered — hashed
+     * byte-for-byte, so any other spelling derives a different address.
+     */
+    clientId: string;
+    /** Address credited on the rollup when the sweeper sweeps. */
+    user: string;
+}
+/**
+ * Derives the deposit address for a (clientId, user) pair.
+ *
+ * @returns The EIP-55 checksummed sweeper address, deployed or not.
+ * @throws If any address is malformed or the client id is empty.
+ */
+export declare function predictSweeperAddress({ factory, implementation, clientId, user }: SweeperAddressInput): Hex;
+/**
+ * The clone's immutable args: `abi.encode(address user, string clientId)`
+ * (the contract calls the string `applicationId`, matching the rollup's
+ * deposit parameter name).
+ *
+ * Length-prefixed rather than packed, so no pair can be confused with another.
+ */
+export declare function sweeperImmutableArgs(user: string, clientId: string): Hex;
+/** The clone's creation code, mirroring OpenZeppelin `Clones._cloneCodeWithImmutableArgs`. */
+export declare function sweeperCloneInitCode(implementation: string, args: Hex): Hex;

package/dist/sweeper.js

@@ -0,0 +1,117 @@
+import { keccak_256 } from "@noble/hashes/sha3";
+const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+/** EIP-1167-with-immutable-args runtime prefix, up to the implementation address. */
+const CLONE_RUNTIME_PREFIX = "3d81600a3d39f3363d3d373d3d3d363d73";
+/** EIP-1167-with-immutable-args runtime suffix, after the implementation address. */
+const CLONE_RUNTIME_SUFFIX = "5af43d82803e903d91602b57fd5bf3";
+/** Byte length of the clone runtime code, excluding the immutable args. */
+const CLONE_RUNTIME_LENGTH = 45;
+/**
+ * The shared CREATE2 salt, matching `SweeperFactory.SALT`.
+ *
+ * The pair is already inside the clone's immutable args, which CREATE2 hashes
+ * as part of the initcode, so the salt carries no per-pair information.
+ */
+const SALT = new Uint8Array(32);
+/**
+ * Derives the deposit address for a (clientId, user) pair.
+ *
+ * @returns The EIP-55 checksummed sweeper address, deployed or not.
+ * @throws If any address is malformed or the client id is empty.
+ */
+export function predictSweeperAddress({ factory, implementation, clientId, user }) {
+    const factoryAddress = assertAddress(factory, "factory");
+    const implementationAddress = assertAddress(implementation, "implementation");
+    const userAddress = assertNonZeroUser(assertAddress(user, "user"));
+    assertClientId(clientId);
+    const initCode = sweeperCloneInitCode(implementationAddress, sweeperImmutableArgs(userAddress, clientId));
+    const preimage = concatBytes(Uint8Array.of(0xff), hexToBytes(factoryAddress), SALT, keccak_256(hexToBytes(initCode)));
+    return toChecksumAddress(`0x${bytesToHex(keccak_256(preimage).slice(12))}`);
+}
+/**
+ * The clone's immutable args: `abi.encode(address user, string clientId)`
+ * (the contract calls the string `applicationId`, matching the rollup's
+ * deposit parameter name).
+ *
+ * Length-prefixed rather than packed, so no pair can be confused with another.
+ */
+export function sweeperImmutableArgs(user, clientId) {
+    const userAddress = assertNonZeroUser(assertAddress(user, "user"));
+    assertClientId(clientId);
+    return `0x${word(userAddress.slice(2))}${word("40")}${encodeStringTail(clientId)}`;
+}
+/** The clone's creation code, mirroring OpenZeppelin `Clones._cloneCodeWithImmutableArgs`. */
+export function sweeperCloneInitCode(implementation, args) {
+    const implementationAddress = assertAddress(implementation, "implementation");
+    const argsHex = args.slice(2);
+    const runtimeLength = argsHex.length / 2 + CLONE_RUNTIME_LENGTH;
+    return `0x61${runtimeLength.toString(16).padStart(4, "0")}${CLONE_RUNTIME_PREFIX}${implementationAddress
+        .slice(2)
+        .toLowerCase()}${CLONE_RUNTIME_SUFFIX}${argsHex}`;
+}
+function assertAddress(value, label) {
+    if (!ADDRESS.test(value)) {
+        throw new Error(`Invalid ${label} address: ${JSON.stringify(value)} is not a 20-byte hex address`);
+    }
+    return value;
+}
+/**
+ * The factory refuses to deploy a sweeper for the zero user, so deriving one
+ * would hand out an address that can be funded and never swept.
+ */
+function assertNonZeroUser(value) {
+    if (/^0x0{40}$/i.test(value)) {
+        throw new Error("Invalid user address: the zero address has no sweeper — the factory refuses to deploy one");
+    }
+    return value;
+}
+function assertClientId(value) {
+    if (value.length === 0) {
+        throw new Error("Invalid client id: an empty string derives an address no application owns. " +
+            "Pass the application's client id exactly as registered — it is hashed byte-for-byte.");
+    }
+}
+/** Left-pads a hex fragment into one 32-byte ABI word. */
+function word(hex) {
+    return hex.toLowerCase().padStart(64, "0");
+}
+/** The length word plus right-padded UTF-8 body of a dynamic ABI string. */
+function encodeStringTail(value) {
+    const bytes = new TextEncoder().encode(value);
+    const padded = Math.ceil(bytes.length / 32) * 32;
+    return word(bytes.length.toString(16)) + bytesToHex(bytes).padEnd(padded * 2, "0");
+}
+function toChecksumAddress(address) {
+    const lower = address.slice(2).toLowerCase();
+    const hash = bytesToHex(keccak_256(new TextEncoder().encode(lower)));
+    let checksummed = "";
+    for (const [index, char] of [...lower].entries()) {
+        checksummed += Number.parseInt(hash.charAt(index), 16) >= 8 ? char.toUpperCase() : char;
+    }
+    return `0x${checksummed}`;
+}
+function hexToBytes(hex) {
+    const body = hex.startsWith("0x") ? hex.slice(2) : hex;
+    const bytes = new Uint8Array(body.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = Number.parseInt(body.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+function bytesToHex(bytes) {
+    let hex = "";
+    for (const byte of bytes) {
+        hex += byte.toString(16).padStart(2, "0");
+    }
+    return hex;
+}
+function concatBytes(...chunks) {
+    const total = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/contracts",
-	"version": "1.0.35",
+	"version": "1.0.36",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -13,6 +13,9 @@
 	"files": [
 		"dist"
 	],
+	"dependencies": {
+		"@noble/hashes": "^1.8.0"
+	},
 	"scripts": {
 		"build": "tsc -b",
 		"dev": "tsc --watch",