@pushchain/core 5.1.5-alpha.1 → 5.1.5

package/src/lib/universal-tx-detector/events.d.ts

@@ -0,0 +1,765 @@
+/**
+ * Event ABI fragments used by the universal-tx detector.
+ *
+ * Sourced from push-chain-gateway-contracts and push-chain-core-contracts:
+ *   - UniversalTx, UniversalTxExecuted, RevertUniversalTx, FundsRescued
+ *       → contracts/evm-gateway/src/interfaces/IUniversalGateway.sol
+ *   - UniversalTxFinalized, UniversalTxReverted, FundsRescued (vault)
+ *       → contracts/evm-gateway/src/interfaces/IVault.sol
+ *   - UniversalTxOutbound
+ *       → contracts/evm-gateway/src/interfaces/IUniversalGatewayPC.sol
+ *
+ * RevertInstructions is a struct `(address revertRecipient, bytes revertMsg)`
+ * per contracts/evm-gateway/src/libraries/Types.sol.
+ */
+/**
+ * UniversalTx(
+ *   address indexed sender,
+ *   address indexed recipient,
+ *   address token,
+ *   uint256 amount,
+ *   bytes payload,
+ *   address revertRecipient,
+ *   TX_TYPE txType,
+ *   bytes signatureData,
+ *   bool fromCEA
+ * )
+ *
+ * Note: this event does NOT carry subTxId/universalTxId. The detector
+ * derives universalTxId deterministically from (sourceChainId, txHash).
+ */
+export declare const EVENT_UNIVERSAL_TX: {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTx";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "payload";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "revertRecipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint8";
+        readonly name: "txType";
+        readonly type: "uint8";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "signatureData";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bool";
+        readonly name: "fromCEA";
+        readonly type: "bool";
+    }];
+};
+/**
+ * UniversalTxExecuted(
+ *   bytes32 indexed subTxId,
+ *   bytes32 indexed universalTxId,
+ *   address indexed pushAccount,
+ *   address target,
+ *   address token,
+ *   uint256 amount,
+ *   bytes data
+ * )
+ */
+export declare const EVENT_UNIVERSAL_TX_EXECUTED: {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxExecuted";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "pushAccount";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "target";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+};
+/**
+ * RevertUniversalTx(
+ *   bytes32 indexed subTxId,
+ *   bytes32 indexed universalTxId,
+ *   address indexed to,
+ *   address token,
+ *   uint256 amount,
+ *   RevertInstructions revertInstruction
+ * )
+ */
+export declare const EVENT_REVERT_UNIVERSAL_TX: {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "RevertUniversalTx";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "struct RevertInstructions";
+        readonly name: "revertInstruction";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "revertRecipient";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "revertMsg";
+            readonly type: "bytes";
+        }];
+    }];
+};
+/**
+ * FundsRescued(
+ *   bytes32 indexed subTxId,
+ *   bytes32 indexed universalTxId,
+ *   address indexed token,
+ *   uint256 amount,
+ *   RevertInstructions revertInstruction
+ * )
+ *
+ * Emitted by both UniversalGateway and Vault.
+ */
+export declare const EVENT_FUNDS_RESCUED: {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "FundsRescued";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "struct RevertInstructions";
+        readonly name: "revertInstruction";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "revertRecipient";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "revertMsg";
+            readonly type: "bytes";
+        }];
+    }];
+};
+/**
+ * UniversalTxFinalized(
+ *   bytes32 indexed subTxId,
+ *   bytes32 indexed universalTxId,
+ *   address indexed pushAccount,
+ *   address recipient,
+ *   address token,
+ *   uint256 amount,
+ *   bytes data
+ * )
+ */
+export declare const EVENT_UNIVERSAL_TX_FINALIZED: {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxFinalized";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "pushAccount";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+};
+/**
+ * UniversalTxReverted(
+ *   bytes32 indexed subTxId,
+ *   bytes32 indexed universalTxId,
+ *   address indexed token,
+ *   uint256 amount,
+ *   RevertInstructions revertInstruction
+ * )
+ */
+export declare const EVENT_UNIVERSAL_TX_REVERTED: {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxReverted";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "struct RevertInstructions";
+        readonly name: "revertInstruction";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "revertRecipient";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "revertMsg";
+            readonly type: "bytes";
+        }];
+    }];
+};
+/**
+ * UniversalTxOutbound(
+ *   bytes32 indexed subTxId,
+ *   address indexed sender,
+ *   string chainNamespace,
+ *   address indexed token,
+ *   bytes recipient,
+ *   uint256 amount,
+ *   address gasToken,
+ *   uint256 gasFee,
+ *   uint256 gasLimit,
+ *   bytes payload,
+ *   uint256 protocolFee,
+ *   address revertRecipient,
+ *   TX_TYPE txType,
+ *   uint256 gasPrice
+ * )
+ */
+export declare const EVENT_UNIVERSAL_TX_OUTBOUND: {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxOutbound";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "string";
+        readonly name: "chainNamespace";
+        readonly type: "string";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "gasToken";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasFee";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasLimit";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "payload";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "protocolFee";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "revertRecipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint8";
+        readonly name: "txType";
+        readonly type: "uint8";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasPrice";
+        readonly type: "uint256";
+    }];
+};
+/** Aggregated ABI handed to viem's parseEventLogs. */
+export declare const UNIVERSAL_TX_EVENT_ABI: readonly [{
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTx";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "payload";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "revertRecipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint8";
+        readonly name: "txType";
+        readonly type: "uint8";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "signatureData";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bool";
+        readonly name: "fromCEA";
+        readonly type: "bool";
+    }];
+}, {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxExecuted";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "pushAccount";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "target";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+}, {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "RevertUniversalTx";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "struct RevertInstructions";
+        readonly name: "revertInstruction";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "revertRecipient";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "revertMsg";
+            readonly type: "bytes";
+        }];
+    }];
+}, {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "FundsRescued";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "struct RevertInstructions";
+        readonly name: "revertInstruction";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "revertRecipient";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "revertMsg";
+            readonly type: "bytes";
+        }];
+    }];
+}, {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxFinalized";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "pushAccount";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+}, {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxReverted";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "universalTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "struct RevertInstructions";
+        readonly name: "revertInstruction";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly internalType: "address";
+            readonly name: "revertRecipient";
+            readonly type: "address";
+        }, {
+            readonly internalType: "bytes";
+            readonly name: "revertMsg";
+            readonly type: "bytes";
+        }];
+    }];
+}, {
+    readonly anonymous: false;
+    readonly type: "event";
+    readonly name: "UniversalTxOutbound";
+    readonly inputs: readonly [{
+        readonly indexed: true;
+        readonly internalType: "bytes32";
+        readonly name: "subTxId";
+        readonly type: "bytes32";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "sender";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "string";
+        readonly name: "chainNamespace";
+        readonly type: "string";
+    }, {
+        readonly indexed: true;
+        readonly internalType: "address";
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "recipient";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "gasToken";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasFee";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasLimit";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "bytes";
+        readonly name: "payload";
+        readonly type: "bytes";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "protocolFee";
+        readonly type: "uint256";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "address";
+        readonly name: "revertRecipient";
+        readonly type: "address";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint8";
+        readonly name: "txType";
+        readonly type: "uint8";
+    }, {
+        readonly indexed: false;
+        readonly internalType: "uint256";
+        readonly name: "gasPrice";
+        readonly type: "uint256";
+    }];
+}];
+/** Event names the detector knows about (for classify.ts). */
+export type KnownEventName = 'UniversalTx' | 'UniversalTxExecuted' | 'RevertUniversalTx' | 'FundsRescued' | 'UniversalTxFinalized' | 'UniversalTxReverted' | 'UniversalTxOutbound';