feat: add core interop resource (#44)

* feat: add core interop resource

* fix: aggregate approvals for the same token

* fix: formatting

* refactor: interop implementation

* refactor: remove error helpers

* fix: formatting

* fix: remove unused constants

Author: vasyl-ivanchuk

docs/src/sdk-reference/core/rpc.md

@@ -119,6 +119,7 @@ type ProofNormalized = {
   id: bigint;
   batchNumber: bigint;
   proof: Hex[];
+  root: Hex;
 };
 
 type ReceiptWithL2ToL1 = {

package.json

@@ -42,6 +42,9 @@
     "access": "public"
   },
   "exports": {
+    "./types/flows/interop": null,
+    "./core/types/flows/interop": null,
+    "./core/resources/interop/*": null,
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",

src/adapters/ethers/resources/withdrawals/services/finalization.ts

@@ -14,7 +14,7 @@ import {
 import { IL1NullifierABI } from '../../../../../core/abi.ts';
 
 import { L2_ASSET_ROUTER_ADDRESS, L1_MESSENGER_ADDRESS } from '../../../../../core/constants';
-import { findL1MessageSentLog } from '../../../../../core/resources/withdrawals/events';
+import { findL1MessageSentLog } from '../../../../../core/utils/events';
 import { messengerLogIndex } from '../../../../../core/resources/withdrawals/logs';
 import { createErrorHandlers } from '../../../errors/error-ops';
 import { classifyReadinessFromRevert } from '../../../errors/revert';

src/adapters/viem/resources/withdrawals/services/finalization.ts

@@ -11,7 +11,7 @@ import {
 
 import { IL1NullifierABI } from '../../../../../core/abi.ts';
 import { L2_ASSET_ROUTER_ADDRESS, L1_MESSENGER_ADDRESS } from '../../../../../core/constants';
-import { findL1MessageSentLog } from '../../../../../core/resources/withdrawals/events';
+import { findL1MessageSentLog } from '../../../../../core/utils/events';
 import { messengerLogIndex } from '../../../../../core/resources/withdrawals/logs';
 import { createErrorHandlers } from '../../../errors/error-ops';
 import { classifyReadinessFromRevert } from '../../../errors/revert';

src/core/abi.ts

@@ -8,4 +8,9 @@ export { default as L1NativeTokenVaultABI } from './internal/abis/L1NativeTokenV
 export { default as L2NativeTokenVaultABI } from './internal/abis/L2NativeTokenVault';
 export { default as IBaseTokenABI } from './internal/abis/IBaseToken';
 export { default as IERC20ABI } from './internal/abis/IERC20';
+export { default as IERC7786AttributesABI } from './internal/abis/IERC7786Attributes';
 export { default as MailboxABI } from './internal/abis/Mailbox';
+export { default as InteropCenterABI } from './internal/abis/InteropCenter';
+export { default as IInteropHandlerABI } from './internal/abis/IInteropHandler';
+export { default as InteropRootStorageABI } from './internal/abis/InteropRootStorage';
+export { default as L2MessageVerificationABI } from './internal/abis/L2MessageVerification';

src/core/constants.ts

@@ -31,9 +31,26 @@ export const L1_MESSENGER_ADDRESS: Address = '0x00000000000000000000000000000000
 /** L2 Base Token System contract address. */
 export const L2_BASE_TOKEN_ADDRESS: Address = '0x000000000000000000000000000000000000800A';
 
+/** The address of the L2 InteropCenter contract.*/
+export const L2_INTEROP_CENTER_ADDRESS: Address = '0x000000000000000000000000000000000001000d';
+
+/** The address of the L2 InteropHandler contract.*/
+export const L2_INTEROP_HANDLER_ADDRESS: Address = '0x000000000000000000000000000000000001000e';
+
+/** The address of the L2 InteropRootStorage contract. */
+export const L2_INTEROP_ROOT_STORAGE_ADDRESS: Address =
+  '0x0000000000000000000000000000000000010008';
+
+/** L2 Message Verification contract address. */
+export const L2_MESSAGE_VERIFICATION_ADDRESS: Address =
+  '0x0000000000000000000000000000000000010009';
+
 /** L1 token address (SOPH). */
 export const L1_SOPH_TOKEN_ADDRESS: Address = '0xa9544a49d4aEa4c8E074431c89C79fA9592049d8';
 
+/** Prefix byte used by InteropCenter when emitting L2->L1 bundle messages. */
+export const BUNDLE_IDENTIFIER: Hex = '0x01';
+
 // -----------------------------------------------------------------------------
 // Event topics
 // -----------------------------------------------------------------------------

src/core/index.ts

@@ -23,7 +23,7 @@ export * from './utils/addr';
 // Core resources (routes, events, logs)
 export * from './resources/deposits/route';
 export * from './resources/withdrawals/route';
-export * from './resources/withdrawals/events';
+export * from './utils/events';
 export * from './resources/withdrawals/logs';
 
 // Core types (type-only)

src/core/internal/abis/IERC7786Attributes.ts

@@ -0,0 +1,56 @@
+const IERC7786AttributesABI = [
+  {
+    inputs: [
+      {
+        internalType: 'bytes',
+        name: '_executionAddress',
+        type: 'bytes',
+      },
+    ],
+    name: 'executionAddress',
+    outputs: [],
+    stateMutability: 'pure',
+    type: 'function',
+  },
+  {
+    inputs: [
+      {
+        internalType: 'uint256',
+        name: '_indirectCallMessageValue',
+        type: 'uint256',
+      },
+    ],
+    name: 'indirectCall',
+    outputs: [],
+    stateMutability: 'pure',
+    type: 'function',
+  },
+  {
+    inputs: [
+      {
+        internalType: 'uint256',
+        name: '_interopCallValue',
+        type: 'uint256',
+      },
+    ],
+    name: 'interopCallValue',
+    outputs: [],
+    stateMutability: 'pure',
+    type: 'function',
+  },
+  {
+    inputs: [
+      {
+        internalType: 'bytes',
+        name: '_unbundlerAddress',
+        type: 'bytes',
+      },
+    ],
+    name: 'unbundlerAddress',
+    outputs: [],
+    stateMutability: 'pure',
+    type: 'function',
+  },
+] as const;
+
+export default IERC7786AttributesABI;