@gzeoneth/gov-tracker 0.1.0 → 0.1.1-1

package/dist/calldata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/calldata/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGvF,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/calldata/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Calldata Decoding Module
+ *
+ * Exports for recursive calldata decoding, signature lookup,
+ * and address utilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryableChainToContext = exports.getRetryableChainName = exports.decodeRetryableTicket = exports.detectChainFromInbox = exports.isRetryableTicketMagic = exports.NOVA_DELAYED_INBOX = exports.ARB1_DELAYED_INBOX = exports.RETRYABLE_TICKET_MAGIC = exports.getChainLabel = exports.getTxExplorerUrl = exports.getAddressExplorerUrl = exports.getKnownAddresses = exports.getAddressLabel = exports.decodeParameters = exports.formatDecodedValue = exports.isLikelyCalldata = exports.parseParamTypes = exports.clearSignatureCache = exports.extractFunctionName = exports.lookup4byteDirectory = exports.lookupLocalSignature = exports.lookupSignature = exports.decodeCalldataArray = exports.decodeCalldata = void 0;
+// Main decoder
+var decoder_1 = require("./decoder");
+Object.defineProperty(exports, "decodeCalldata", { enumerable: true, get: function () { return decoder_1.decodeCalldata; } });
+Object.defineProperty(exports, "decodeCalldataArray", { enumerable: true, get: function () { return decoder_1.decodeCalldataArray; } });
+// Signature lookup
+var signature_lookup_1 = require("./signature-lookup");
+Object.defineProperty(exports, "lookupSignature", { enumerable: true, get: function () { return signature_lookup_1.lookupSignature; } });
+Object.defineProperty(exports, "lookupLocalSignature", { enumerable: true, get: function () { return signature_lookup_1.lookupLocalSignature; } });
+Object.defineProperty(exports, "lookup4byteDirectory", { enumerable: true, get: function () { return signature_lookup_1.lookup4byteDirectory; } });
+Object.defineProperty(exports, "extractFunctionName", { enumerable: true, get: function () { return signature_lookup_1.extractFunctionName; } });
+Object.defineProperty(exports, "clearSignatureCache", { enumerable: true, get: function () { return signature_lookup_1.clearSignatureCache; } });
+// Parameter decoder
+var parameter_decoder_1 = require("./parameter-decoder");
+Object.defineProperty(exports, "parseParamTypes", { enumerable: true, get: function () { return parameter_decoder_1.parseParamTypes; } });
+Object.defineProperty(exports, "isLikelyCalldata", { enumerable: true, get: function () { return parameter_decoder_1.isLikelyCalldata; } });
+Object.defineProperty(exports, "formatDecodedValue", { enumerable: true, get: function () { return parameter_decoder_1.formatDecodedValue; } });
+Object.defineProperty(exports, "decodeParameters", { enumerable: true, get: function () { return parameter_decoder_1.decodeParameters; } });
+// Address utilities
+var address_utils_1 = require("./address-utils");
+Object.defineProperty(exports, "getAddressLabel", { enumerable: true, get: function () { return address_utils_1.getAddressLabel; } });
+Object.defineProperty(exports, "getKnownAddresses", { enumerable: true, get: function () { return address_utils_1.getKnownAddresses; } });
+// URL utilities
+var urls_1 = require("../utils/urls");
+Object.defineProperty(exports, "getAddressExplorerUrl", { enumerable: true, get: function () { return urls_1.getAddressExplorerUrl; } });
+Object.defineProperty(exports, "getTxExplorerUrl", { enumerable: true, get: function () { return urls_1.getTxExplorerUrl; } });
+Object.defineProperty(exports, "getChainLabel", { enumerable: true, get: function () { return urls_1.getChainLabel; } });
+// Retryable ticket
+var retryable_ticket_1 = require("./retryable-ticket");
+Object.defineProperty(exports, "RETRYABLE_TICKET_MAGIC", { enumerable: true, get: function () { return retryable_ticket_1.RETRYABLE_TICKET_MAGIC; } });
+Object.defineProperty(exports, "ARB1_DELAYED_INBOX", { enumerable: true, get: function () { return retryable_ticket_1.ARB1_DELAYED_INBOX; } });
+Object.defineProperty(exports, "NOVA_DELAYED_INBOX", { enumerable: true, get: function () { return retryable_ticket_1.NOVA_DELAYED_INBOX; } });
+Object.defineProperty(exports, "isRetryableTicketMagic", { enumerable: true, get: function () { return retryable_ticket_1.isRetryableTicketMagic; } });
+Object.defineProperty(exports, "detectChainFromInbox", { enumerable: true, get: function () { return retryable_ticket_1.detectChainFromInbox; } });
+Object.defineProperty(exports, "decodeRetryableTicket", { enumerable: true, get: function () { return retryable_ticket_1.decodeRetryableTicket; } });
+Object.defineProperty(exports, "getRetryableChainName", { enumerable: true, get: function () { return retryable_ticket_1.getRetryableChainName; } });
+Object.defineProperty(exports, "retryableChainToContext", { enumerable: true, get: function () { return retryable_ticket_1.retryableChainToContext; } });
+//# sourceMappingURL=index.js.map

package/dist/calldata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/calldata/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,eAAe;AACf,qCAAgE;AAAvD,yGAAA,cAAc,OAAA;AAAE,8GAAA,mBAAmB,OAAA;AAE5C,mBAAmB;AACnB,uDAM4B;AAL1B,mHAAA,eAAe,OAAA;AACf,wHAAA,oBAAoB,OAAA;AACpB,wHAAA,oBAAoB,OAAA;AACpB,uHAAA,mBAAmB,OAAA;AACnB,uHAAA,mBAAmB,OAAA;AAGrB,oBAAoB;AACpB,yDAK6B;AAJ3B,oHAAA,eAAe,OAAA;AACf,qHAAA,gBAAgB,OAAA;AAChB,uHAAA,kBAAkB,OAAA;AAClB,qHAAA,gBAAgB,OAAA;AAGlB,oBAAoB;AACpB,iDAAqE;AAA5D,gHAAA,eAAe,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AAE3C,gBAAgB;AAChB,sCAAuF;AAA9E,6GAAA,qBAAqB,OAAA;AAAE,wGAAA,gBAAgB,OAAA;AAAE,qGAAA,aAAa,OAAA;AAE/D,mBAAmB;AACnB,uDAS4B;AAR1B,0HAAA,sBAAsB,OAAA;AACtB,sHAAA,kBAAkB,OAAA;AAClB,sHAAA,kBAAkB,OAAA;AAClB,0HAAA,sBAAsB,OAAA;AACtB,wHAAA,oBAAoB,OAAA;AACpB,yHAAA,qBAAqB,OAAA;AACrB,yHAAA,qBAAqB,OAAA;AACrB,2HAAA,uBAAuB,OAAA"}

package/dist/calldata/parameter-decoder.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Parameter Decoder
+ *
+ * Decodes ABI-encoded parameters from calldata into typed values.
+ * Handles complex types like tuples, arrays, and provides formatting.
+ */
+import { ethers } from "ethers";
+import type { ChainContext, DecodedParameter } from "../types/calldata";
+/**
+ * Parse parameter types from function signature
+ * Handles nested types like tuples and arrays
+ *
+ * @param typesStr - Parameter types string (e.g., "address,uint256,bytes")
+ * @returns Array of individual type strings
+ */
+export declare function parseParamTypes(typesStr: string): string[];
+/**
+ * Check if a value looks like calldata (for nested decoding)
+ *
+ * @param value - Hex string to check
+ * @returns True if it looks like valid calldata
+ */
+export declare function isLikelyCalldata(value: string): boolean;
+/**
+ * Format a decoded value for display
+ *
+ * @param value - The raw decoded value
+ * @param type - Solidity type string
+ * @returns Formatted string representation
+ */
+export declare function formatDecodedValue(value: unknown, type: string): string;
+/**
+ * Decode parameters from calldata using signature
+ *
+ * @param calldata - Full calldata hex string (with selector)
+ * @param signature - Function signature (e.g., "transfer(address,uint256)")
+ * @param chainContext - Chain for address resolution
+ * @returns Array of decoded parameters, or null if decoding fails
+ */
+export declare function decodeParameters(calldata: string, signature: string, chainContext: ChainContext): {
+    params: DecodedParameter[];
+    decoded: ethers.utils.Result;
+} | null;
+//# sourceMappingURL=parameter-decoder.d.ts.map

package/dist/calldata/parameter-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-decoder.d.ts","sourceRoot":"","sources":["../../src/calldata/parameter-decoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGxE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUvD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAuCvE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,GACzB;IAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAA;CAAE,GAAG,IAAI,CAwDrE"}

package/dist/calldata/parameter-decoder.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Parameter Decoder
+ *
+ * Decodes ABI-encoded parameters from calldata into typed values.
+ * Handles complex types like tuples, arrays, and provides formatting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseParamTypes = parseParamTypes;
+exports.isLikelyCalldata = isLikelyCalldata;
+exports.formatDecodedValue = formatDecodedValue;
+exports.decodeParameters = decodeParameters;
+const ethers_1 = require("ethers");
+const address_utils_1 = require("./address-utils");
+/**
+ * Parse parameter types from function signature
+ * Handles nested types like tuples and arrays
+ *
+ * @param typesStr - Parameter types string (e.g., "address,uint256,bytes")
+ * @returns Array of individual type strings
+ */
+function parseParamTypes(typesStr) {
+    const types = [];
+    let depth = 0;
+    let current = "";
+    for (const char of typesStr) {
+        if (char === "(" || char === "[")
+            depth++;
+        if (char === ")" || char === "]")
+            depth--;
+        if (char === "," && depth === 0) {
+            if (current.trim())
+                types.push(current.trim());
+            current = "";
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current.trim())
+        types.push(current.trim());
+    return types;
+}
+/**
+ * Check if a value looks like calldata (for nested decoding)
+ *
+ * @param value - Hex string to check
+ * @returns True if it looks like valid calldata
+ */
+function isLikelyCalldata(value) {
+    if (!value || typeof value !== "string")
+        return false;
+    if (!value.startsWith("0x"))
+        return false;
+    // Must have at least selector (4 bytes = 8 hex chars + 0x)
+    if (value.length < 10)
+        return false;
+    // Check if it's all hex
+    const hexPattern = /^0x[0-9a-fA-F]+$/;
+    return hexPattern.test(value);
+}
+/**
+ * Format a decoded value for display
+ *
+ * @param value - The raw decoded value
+ * @param type - Solidity type string
+ * @returns Formatted string representation
+ */
+function formatDecodedValue(value, type) {
+    // Handle BigNumber
+    if (ethers_1.ethers.BigNumber.isBigNumber(value)) {
+        const bn = value;
+        const strValue = bn.toString();
+        // For uint256 that might be ETH amounts, show conversion
+        if (type.includes("uint256") && bn.gt(0)) {
+            try {
+                const ethValue = ethers_1.ethers.utils.formatEther(bn);
+                const ethNum = parseFloat(ethValue);
+                // Only show ETH conversion for values >= 0.001 ETH
+                if (ethNum >= 0.001) {
+                    return `${strValue} (${ethValue} ETH)`;
+                }
+            }
+            catch {
+                // Ignore formatting errors
+            }
+        }
+        return strValue;
+    }
+    // Handle arrays
+    if (Array.isArray(value)) {
+        const elementType = type.endsWith("[]") ? type.slice(0, -2) : type;
+        const formatted = value.map((v) => formatDecodedValue(v, elementType));
+        return `[${formatted.join(", ")}]`;
+    }
+    // Handle bytes - truncate middle for readability
+    if (typeof value === "string" && value.startsWith("0x") && value.length > 34) {
+        const prefix = value.slice(0, 18);
+        const suffix = value.slice(-16);
+        return `${prefix}...${suffix}`;
+    }
+    // Default: convert to string
+    return String(value);
+}
+/**
+ * Decode parameters from calldata using signature
+ *
+ * @param calldata - Full calldata hex string (with selector)
+ * @param signature - Function signature (e.g., "transfer(address,uint256)")
+ * @param chainContext - Chain for address resolution
+ * @returns Array of decoded parameters, or null if decoding fails
+ */
+function decodeParameters(calldata, signature, chainContext) {
+    try {
+        // Extract parameter types from signature
+        const match = signature.match(/\((.+)\)$/);
+        if (!match)
+            return null;
+        const typesStr = match[1];
+        const paramTypes = parseParamTypes(typesStr);
+        // Remove selector (first 4 bytes = 10 chars including 0x)
+        const encodedParams = "0x" + calldata.slice(10);
+        // Decode using ethers
+        const abiCoder = new ethers_1.ethers.utils.AbiCoder();
+        const decoded = abiCoder.decode(paramTypes, encodedParams);
+        // Format into DecodedParameter array
+        const params = paramTypes.map((type, index) => {
+            const rawValue = decoded[index];
+            const param = {
+                name: `arg${index}`,
+                type,
+                value: formatDecodedValue(rawValue, type),
+                rawValue: rawValue,
+                isNested: false,
+            };
+            // Handle address type - add label
+            if (type === "address") {
+                const addr = String(rawValue);
+                const label = (0, address_utils_1.getAddressLabel)(addr, chainContext);
+                if (label)
+                    param.addressLabel = label;
+            }
+            // Handle bytes type - check if nested calldata
+            if (type === "bytes") {
+                const bytesValue = String(rawValue);
+                if (isLikelyCalldata(bytesValue)) {
+                    param.isNested = true;
+                }
+                param.value = bytesValue;
+            }
+            // Handle bytes[] - store raw array for nested processing
+            if (type === "bytes[]" && Array.isArray(rawValue)) {
+                param._rawBytesArray = rawValue.map((b) => String(b));
+                param.isNested = true;
+            }
+            return param;
+        });
+        return { params, decoded };
+    }
+    catch (_error) {
+        return null;
+    }
+}
+//# sourceMappingURL=parameter-decoder.js.map

package/dist/calldata/parameter-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-decoder.js","sourceRoot":"","sources":["../../src/calldata/parameter-decoder.ts"],"names":[],"mappings":"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"}

package/dist/calldata/retryable-ticket.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Retryable Ticket Decoder
+ *
+ * Extracts and parses Arbitrum L1→L2 retryable ticket data from calldata.
+ */
+import type { RetryableTicketData, ChainContext } from "../types/calldata";
+/**
+ * Magic address that indicates a retryable ticket in timelock operations
+ * When a timelock target is this address, the calldata contains a retryable tuple
+ */
+export declare const RETRYABLE_TICKET_MAGIC = "0xa723c008e76e379c55599d2e4d93879beafda79c";
+/**
+ * Delayed inbox addresses for chain detection
+ */
+export declare const ARB1_DELAYED_INBOX = "0x4dbd4fc535ac27206064b68ffcf827b0a60bab3f";
+export declare const NOVA_DELAYED_INBOX = "0xc4448b71118c9071bcb9734a0eac55d18a153949";
+/**
+ * Check if an address is the retryable ticket magic address
+ *
+ * @param target - Target address to check
+ * @returns True if this is the retryable ticket magic address
+ */
+export declare function isRetryableTicketMagic(target: string): boolean;
+/**
+ * Detect L2 chain from inbox address
+ *
+ * @param inboxAddress - Delayed inbox address on L1
+ * @returns Target L2 chain
+ */
+export declare function detectChainFromInbox(inboxAddress: string): "arb1" | "nova" | "unknown";
+/**
+ * Get human-readable chain name for display
+ *
+ * @param chain - Chain identifier
+ * @returns Human-readable chain name
+ */
+export declare function getRetryableChainName(chain: "arb1" | "nova" | "unknown"): string;
+/**
+ * Decode retryable ticket data from ABI-encoded bytes
+ *
+ * Retryable tickets are encoded as tuples (NOT calldata) with this structure:
+ * (address inbox, address l2Target, uint256 l2Value, uint256 gasLimit, uint256 maxFeePerGas, bytes l2Calldata)
+ *
+ * @param bytes - ABI-encoded retryable ticket bytes
+ * @returns Decoded retryable ticket data, or null if decoding fails
+ */
+export declare function decodeRetryableTicket(bytes: string): RetryableTicketData | null;
+/**
+ * Get ChainContext from retryable chain
+ *
+ * @param chain - Retryable chain identifier
+ * @returns ChainContext for address resolution
+ */
+export declare function retryableChainToContext(chain: "arb1" | "nova" | "unknown"): ChainContext;
+//# sourceMappingURL=retryable-ticket.d.ts.map

package/dist/calldata/retryable-ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryable-ticket.d.ts","sourceRoot":"","sources":["../../src/calldata/retryable-ticket.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,+CAA+C,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAC/E,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAShF;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAsB/E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAIxF"}

package/dist/calldata/retryable-ticket.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Retryable Ticket Decoder
+ *
+ * Extracts and parses Arbitrum L1→L2 retryable ticket data from calldata.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOVA_DELAYED_INBOX = exports.ARB1_DELAYED_INBOX = exports.RETRYABLE_TICKET_MAGIC = void 0;
+exports.isRetryableTicketMagic = isRetryableTicketMagic;
+exports.detectChainFromInbox = detectChainFromInbox;
+exports.getRetryableChainName = getRetryableChainName;
+exports.decodeRetryableTicket = decodeRetryableTicket;
+exports.retryableChainToContext = retryableChainToContext;
+const ethers_1 = require("ethers");
+/**
+ * Magic address that indicates a retryable ticket in timelock operations
+ * When a timelock target is this address, the calldata contains a retryable tuple
+ */
+exports.RETRYABLE_TICKET_MAGIC = "0xa723c008e76e379c55599d2e4d93879beafda79c";
+/**
+ * Delayed inbox addresses for chain detection
+ */
+exports.ARB1_DELAYED_INBOX = "0x4dbd4fc535ac27206064b68ffcf827b0a60bab3f";
+exports.NOVA_DELAYED_INBOX = "0xc4448b71118c9071bcb9734a0eac55d18a153949";
+/**
+ * Check if an address is the retryable ticket magic address
+ *
+ * @param target - Target address to check
+ * @returns True if this is the retryable ticket magic address
+ */
+function isRetryableTicketMagic(target) {
+    return target.toLowerCase() === exports.RETRYABLE_TICKET_MAGIC;
+}
+/**
+ * Detect L2 chain from inbox address
+ *
+ * @param inboxAddress - Delayed inbox address on L1
+ * @returns Target L2 chain
+ */
+function detectChainFromInbox(inboxAddress) {
+    const lowerInbox = inboxAddress.toLowerCase();
+    if (lowerInbox === exports.ARB1_DELAYED_INBOX)
+        return "arb1";
+    if (lowerInbox === exports.NOVA_DELAYED_INBOX)
+        return "nova";
+    return "unknown";
+}
+/**
+ * Get human-readable chain name for display
+ *
+ * @param chain - Chain identifier
+ * @returns Human-readable chain name
+ */
+function getRetryableChainName(chain) {
+    switch (chain) {
+        case "arb1":
+            return "Arbitrum One";
+        case "nova":
+            return "Nova";
+        default:
+            return "Unknown L2";
+    }
+}
+/**
+ * Decode retryable ticket data from ABI-encoded bytes
+ *
+ * Retryable tickets are encoded as tuples (NOT calldata) with this structure:
+ * (address inbox, address l2Target, uint256 l2Value, uint256 gasLimit, uint256 maxFeePerGas, bytes l2Calldata)
+ *
+ * @param bytes - ABI-encoded retryable ticket bytes
+ * @returns Decoded retryable ticket data, or null if decoding fails
+ */
+function decodeRetryableTicket(bytes) {
+    try {
+        const abiCoder = new ethers_1.ethers.utils.AbiCoder();
+        const decoded = abiCoder.decode(["address", "address", "uint256", "uint256", "uint256", "bytes"], bytes);
+        const chain = detectChainFromInbox(decoded[0]);
+        return {
+            targetInbox: decoded[0],
+            l2Target: decoded[1],
+            l2Value: decoded[2].toString(),
+            gasLimit: decoded[3].toString(),
+            maxFeePerGas: decoded[4].toString(),
+            l2Calldata: decoded[5],
+            chain,
+        };
+    }
+    catch (_error) {
+        return null;
+    }
+}
+/**
+ * Get ChainContext from retryable chain
+ *
+ * @param chain - Retryable chain identifier
+ * @returns ChainContext for address resolution
+ */
+function retryableChainToContext(chain) {
+    if (chain === "nova")
+        return "nova";
+    // Default to arb1 for unknown
+    return "arb1";
+}
+//# sourceMappingURL=retryable-ticket.js.map

package/dist/calldata/retryable-ticket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryable-ticket.js","sourceRoot":"","sources":["../../src/calldata/retryable-ticket.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAuBH,wDAEC;AAQD,oDAMC;AAQD,sDASC;AAWD,sDAsBC;AAQD,0DAIC;AAnGD,mCAAgC;AAGhC;;;GAGG;AACU,QAAA,sBAAsB,GAAG,4CAA4C,CAAC;AAEnF;;GAEG;AACU,QAAA,kBAAkB,GAAG,4CAA4C,CAAC;AAClE,QAAA,kBAAkB,GAAG,4CAA4C,CAAC;AAE/E;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,MAAc;IACnD,OAAO,MAAM,CAAC,WAAW,EAAE,KAAK,8BAAsB,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,YAAoB;IACvD,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAE9C,IAAI,UAAU,KAAK,0BAAkB;QAAE,OAAO,MAAM,CAAC;IACrD,IAAI,UAAU,KAAK,0BAAkB;QAAE,OAAO,MAAM,CAAC;IACrD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,KAAkC;IACtE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,cAAc,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,KAAa;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,eAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAChE,KAAK,CACN,CAAC;QAEF,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAW,CAAC,CAAC;QAEzD,OAAO;YACL,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;YACvB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YACpB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC9B,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC/B,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YACnC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YACtB,KAAK;SACN,CAAC;IACJ,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,KAAkC;IACxE,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACpC,8BAA8B;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/calldata/signature-lookup.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Function Signature Lookup
+ *
+ * Resolves 4-byte function selectors to full function signatures.
+ * Uses local registry first, then falls back to 4byte.directory API.
+ */
+/**
+ * Look up function signature in local registry
+ *
+ * @param selector - The 4-byte function selector (e.g., "0x8f2a0bb0")
+ * @returns The function signature if found, null otherwise
+ */
+export declare function lookupLocalSignature(selector: string): string | null;
+/**
+ * Query 4byte.directory API with caching
+ *
+ * @param selector - The 4-byte function selector
+ * @returns The function signature if found, null otherwise
+ */
+export declare function lookup4byteDirectory(selector: string): Promise<string | null>;
+/**
+ * Look up function signature from all sources
+ *
+ * Priority:
+ * 1. Local registry (instant)
+ * 2. 4byte.directory API (with caching)
+ *
+ * @param selector - The 4-byte function selector (e.g., "0x8f2a0bb0")
+ * @returns Object with signature and source, or null signature if not found
+ */
+export declare function lookupSignature(selector: string): Promise<{
+    signature: string | null;
+    source: "local" | "api" | "failed";
+}>;
+/**
+ * Extract function name from signature
+ *
+ * @param signature - Full function signature (e.g., "transfer(address,uint256)")
+ * @returns Function name (e.g., "transfer")
+ */
+export declare function extractFunctionName(signature: string): string;
+/**
+ * Clear the signature cache (useful for testing)
+ */
+export declare function clearSignatureCache(): void;
+//# sourceMappingURL=signature-lookup.d.ts.map

package/dist/calldata/signature-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-lookup.d.ts","sourceRoot":"","sources":["../../src/calldata/signature-lookup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoEH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyCnF;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;CAAE,CAAC,CAc3E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/calldata/signature-lookup.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Function Signature Lookup
+ *
+ * Resolves 4-byte function selectors to full function signatures.
+ * Uses local registry first, then falls back to 4byte.directory API.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookupLocalSignature = lookupLocalSignature;
+exports.lookup4byteDirectory = lookup4byteDirectory;
+exports.lookupSignature = lookupSignature;
+exports.extractFunctionName = extractFunctionName;
+exports.clearSignatureCache = clearSignatureCache;
+const debug_1 = __importDefault(require("debug"));
+const debug = (0, debug_1.default)("gov-tracker:calldata");
+/**
+ * Local registry of common governance function signatures
+ * Priority 1: Checked before API lookup
+ */
+const LOCAL_SIGNATURES = {
+    // Timelock operations
+    "0x01d5062a": "schedule(address,uint256,bytes,bytes32,bytes32,uint256)",
+    "0x8f2a0bb0": "scheduleBatch(address[],uint256[],bytes[],bytes32,bytes32,uint256)",
+    "0x134008d3": "execute(address,uint256,bytes,bytes32,bytes32)",
+    "0xe38335e5": "executeBatch(address[],uint256[],bytes[],bytes32,bytes32)",
+    "0xc4d252f5": "cancel(bytes32)",
+    "0xd45c4435": "hashOperation(address,uint256,bytes,bytes32,bytes32)",
+    "0xb1c5f427": "hashOperationBatch(address[],uint256[],bytes[],bytes32,bytes32)",
+    // Cross-chain messaging
+    "0x928c169a": "sendTxToL1(address,bytes)",
+    // UpgradeExecutor
+    "0x1cff79cd": "execute(address,bytes)",
+    "0x61461954": "executeCall(address,bytes)",
+    // ERC20
+    "0xa9059cbb": "transfer(address,uint256)",
+    "0x095ea7b3": "approve(address,uint256)",
+    "0x23b872dd": "transferFrom(address,address,uint256)",
+    "0x70a08231": "balanceOf(address)",
+    "0xdd62ed3e": "allowance(address,address)",
+    // Proxy upgrades
+    "0x3659cfe6": "upgradeTo(address)",
+    "0x4f1ef286": "upgradeToAndCall(address,bytes)",
+    "0x0900f010": "upgrade(address)",
+    "0x99a88ec4": "upgrade(address,address)",
+    // Ownership
+    "0x13af4035": "setOwner(address)",
+    "0xf2fde38b": "transferOwnership(address)",
+    "0x715018a6": "renounceOwnership()",
+    "0x8da5cb5b": "owner()",
+    // Governor
+    "0x7d5e81e2": "propose(address[],uint256[],bytes[],string)",
+    "0xfe0d94c1": "execute(uint256)",
+    "0xddf0b009": "queue(uint256)",
+    "0x56781388": "castVote(uint256,uint8)",
+    "0x3bccf4fd": "castVoteWithReason(uint256,uint8,string)",
+    // Security Council
+    "0xbf396750": "replaceCohort(address[],address[])",
+    "0xb147f40c": "perform()",
+};
+/**
+ * In-memory cache for API lookups (session cache)
+ */
+const signatureCache = new Map();
+/**
+ * API timeout in milliseconds
+ */
+const API_TIMEOUT_MS = 5000;
+/**
+ * Look up function signature in local registry
+ *
+ * @param selector - The 4-byte function selector (e.g., "0x8f2a0bb0")
+ * @returns The function signature if found, null otherwise
+ */
+function lookupLocalSignature(selector) {
+    const normalizedSelector = selector.toLowerCase();
+    return LOCAL_SIGNATURES[normalizedSelector] ?? null;
+}
+/**
+ * Query 4byte.directory API with caching
+ *
+ * @param selector - The 4-byte function selector
+ * @returns The function signature if found, null otherwise
+ */
+async function lookup4byteDirectory(selector) {
+    const normalizedSelector = selector.toLowerCase();
+    // Check session cache
+    if (signatureCache.has(normalizedSelector)) {
+        return signatureCache.get(normalizedSelector) ?? null;
+    }
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+        const url = `https://www.4byte.directory/api/v1/signatures/?hex_signature=${normalizedSelector}`;
+        const response = await fetch(url, { signal: controller.signal });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            debug("4byte.directory API error: %d", response.status);
+            signatureCache.set(normalizedSelector, null);
+            return null;
+        }
+        const data = (await response.json());
+        if (data.results && data.results.length > 0) {
+            // Return the first (most common) signature
+            const signature = data.results[0].text_signature;
+            signatureCache.set(normalizedSelector, signature);
+            debug("4byte.directory found: %s -> %s", normalizedSelector, signature);
+            return signature;
+        }
+        signatureCache.set(normalizedSelector, null);
+        return null;
+    }
+    catch (error) {
+        debug("4byte.directory lookup failed: %O", error);
+        signatureCache.set(normalizedSelector, null);
+        return null;
+    }
+}
+/**
+ * Look up function signature from all sources
+ *
+ * Priority:
+ * 1. Local registry (instant)
+ * 2. 4byte.directory API (with caching)
+ *
+ * @param selector - The 4-byte function selector (e.g., "0x8f2a0bb0")
+ * @returns Object with signature and source, or null signature if not found
+ */
+async function lookupSignature(selector) {
+    // Try local registry first
+    const localResult = lookupLocalSignature(selector);
+    if (localResult) {
+        return { signature: localResult, source: "local" };
+    }
+    // Fall back to 4byte.directory API
+    const apiResult = await lookup4byteDirectory(selector);
+    if (apiResult) {
+        return { signature: apiResult, source: "api" };
+    }
+    return { signature: null, source: "failed" };
+}
+/**
+ * Extract function name from signature
+ *
+ * @param signature - Full function signature (e.g., "transfer(address,uint256)")
+ * @returns Function name (e.g., "transfer")
+ */
+function extractFunctionName(signature) {
+    const parenIndex = signature.indexOf("(");
+    return parenIndex > 0 ? signature.slice(0, parenIndex) : signature;
+}
+/**
+ * Clear the signature cache (useful for testing)
+ */
+function clearSignatureCache() {
+    signatureCache.clear();
+}
+//# sourceMappingURL=signature-lookup.js.map