near-safe 0.9.0 → 0.9.1

package/dist/cjs/decode/sign-request.d.ts

@@ -1,4 +1,6 @@
-import { DecodedTxData, SafeEncodedSignRequest } from "../types";
+import { EvmMessage } from "near-ca";
+import { TransactionSerializable } from "viem";
+import { DecodedTxData, SafeEncodedSignRequest, UserOperation } from "../types";
 /**
  * Decodes transaction data for a given EVM transaction and extracts relevant details.
  *
@@ -6,3 +8,19 @@ import { DecodedTxData, SafeEncodedSignRequest } from "../types";
  * @returns {DecodedTxData} - An object containing the chain ID, estimated cost, and a list of decoded meta-transactions.
  */
 export declare function decodeTxData({ evmMessage, chainId, }: Omit<SafeEncodedSignRequest, "hashToSign">): DecodedTxData;
+/**
+ * Represents different types of broadcastable messages
+ */
+export type BroadcastTarget = {
+    type: "evm";
+    transaction: TransactionSerializable;
+} | {
+    type: "bundler";
+    userOp: UserOperation;
+};
+/**
+ * Determines where and how an EVM message should be broadcast
+ * @param evmMessage - The message to be analyzed
+ * @returns Information about how to broadcast the message, or null if invalid
+ */
+export declare function determineBroadcastTarget(evmMessage: EvmMessage): BroadcastTarget | null;

package/dist/cjs/decode/sign-request.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.decodeTxData = decodeTxData;
+exports.determineBroadcastTarget = determineBroadcastTarget;
 const near_ca_1 = require("near-ca");
+const viem_1 = require("viem");
 const types_1 = require("../types");
 const util_1 = require("./util");
 /**
@@ -42,3 +44,40 @@ function decodeTxData({ evmMessage, chainId, }) {
     console.warn("Unrecognized txData format,", chainId, data);
     throw new Error(`decodeTxData: Invalid or unsupported message format ${data}`);
 }
+/**
+ * Determines where and how an EVM message should be broadcast
+ * @param evmMessage - The message to be analyzed
+ * @returns Information about how to broadcast the message, or null if invalid
+ */
+function determineBroadcastTarget(evmMessage) {
+    // Case 1: User Operation
+    if (typeof evmMessage === "string") {
+        try {
+            const parsed = (0, types_1.parseUserOperation)(evmMessage);
+            if (parsed) {
+                return {
+                    type: "bundler",
+                    userOp: parsed,
+                };
+            }
+        }
+        catch (error) {
+            console.warn("Failed to parse potential UserOperation:", error);
+        }
+    }
+    // Case 2: RLP Encoded EVM transaction
+    if ((0, near_ca_1.isRlpHex)(evmMessage)) {
+        return {
+            type: "evm",
+            transaction: (0, viem_1.parseTransaction)(evmMessage),
+        };
+    }
+    // Case 3: Serializable Transaction
+    if ((0, near_ca_1.isTransactionSerializable)(evmMessage)) {
+        return {
+            type: "evm",
+            transaction: evmMessage,
+        };
+    }
+    return null;
+}

package/dist/cjs/index.d.ts

@@ -4,4 +4,4 @@ export * from "./util";
 export * from "./constants";
 export * from "./decode";
 export * from "./lib/safe-message";
-export { Network, BaseTx, SignRequestData, populateTx, NetworkFields, signatureFromOutcome, signatureFromTxHash, requestRouter as mpcRequestRouter, EthTransactionParams, } from "near-ca";
+export { Network, BaseTx, SignRequestData, populateTx, NetworkFields, signatureFromOutcome, signatureFromTxHash, requestRouter as mpcRequestRouter, EthTransactionParams, isRlpHex, } from "near-ca";

package/dist/cjs/index.js

@@ -14,16 +14,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mpcRequestRouter = exports.signatureFromTxHash = exports.signatureFromOutcome = exports.populateTx = exports.Network = void 0;
+exports.isRlpHex = exports.mpcRequestRouter = exports.signatureFromTxHash = exports.signatureFromOutcome = exports.populateTx = exports.Network = void 0;
 __exportStar(require("./near-safe"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./util"), exports);
 __exportStar(require("./constants"), exports);
 __exportStar(require("./decode"), exports);
 __exportStar(require("./lib/safe-message"), exports);
+// TODO: Improve re-exports...
 var near_ca_1 = require("near-ca");
 Object.defineProperty(exports, "Network", { enumerable: true, get: function () { return near_ca_1.Network; } });
 Object.defineProperty(exports, "populateTx", { enumerable: true, get: function () { return near_ca_1.populateTx; } });
 Object.defineProperty(exports, "signatureFromOutcome", { enumerable: true, get: function () { return near_ca_1.signatureFromOutcome; } });
 Object.defineProperty(exports, "signatureFromTxHash", { enumerable: true, get: function () { return near_ca_1.signatureFromTxHash; } });
 Object.defineProperty(exports, "mpcRequestRouter", { enumerable: true, get: function () { return near_ca_1.requestRouter; } });
+Object.defineProperty(exports, "isRlpHex", { enumerable: true, get: function () { return near_ca_1.isRlpHex; } });

package/dist/esm/decode/sign-request.d.ts

@@ -1,4 +1,6 @@
-import { DecodedTxData, SafeEncodedSignRequest } from "../types";
+import { EvmMessage } from "near-ca";
+import { TransactionSerializable } from "viem";
+import { DecodedTxData, SafeEncodedSignRequest, UserOperation } from "../types";
 /**
  * Decodes transaction data for a given EVM transaction and extracts relevant details.
  *
@@ -6,3 +8,19 @@ import { DecodedTxData, SafeEncodedSignRequest } from "../types";
  * @returns {DecodedTxData} - An object containing the chain ID, estimated cost, and a list of decoded meta-transactions.
  */
 export declare function decodeTxData({ evmMessage, chainId, }: Omit<SafeEncodedSignRequest, "hashToSign">): DecodedTxData;
+/**
+ * Represents different types of broadcastable messages
+ */
+export type BroadcastTarget = {
+    type: "evm";
+    transaction: TransactionSerializable;
+} | {
+    type: "bundler";
+    userOp: UserOperation;
+};
+/**
+ * Determines where and how an EVM message should be broadcast
+ * @param evmMessage - The message to be analyzed
+ * @returns Information about how to broadcast the message, or null if invalid
+ */
+export declare function determineBroadcastTarget(evmMessage: EvmMessage): BroadcastTarget | null;

package/dist/esm/decode/sign-request.js

@@ -1,4 +1,5 @@
 import { isRlpHex, isTransactionSerializable } from "near-ca";
+import { parseTransaction } from "viem";
 import { parseEip712TypedData, parseUserOperation, } from "../types";
 import { decodeRlpHex, decodeTransactionSerializable, decodeTypedData, decodeUserOperation, } from "./util";
 /**
@@ -39,3 +40,40 @@ export function decodeTxData({ evmMessage, chainId, }) {
     console.warn("Unrecognized txData format,", chainId, data);
     throw new Error(`decodeTxData: Invalid or unsupported message format ${data}`);
 }
+/**
+ * Determines where and how an EVM message should be broadcast
+ * @param evmMessage - The message to be analyzed
+ * @returns Information about how to broadcast the message, or null if invalid
+ */
+export function determineBroadcastTarget(evmMessage) {
+    // Case 1: User Operation
+    if (typeof evmMessage === "string") {
+        try {
+            const parsed = parseUserOperation(evmMessage);
+            if (parsed) {
+                return {
+                    type: "bundler",
+                    userOp: parsed,
+                };
+            }
+        }
+        catch (error) {
+            console.warn("Failed to parse potential UserOperation:", error);
+        }
+    }
+    // Case 2: RLP Encoded EVM transaction
+    if (isRlpHex(evmMessage)) {
+        return {
+            type: "evm",
+            transaction: parseTransaction(evmMessage),
+        };
+    }
+    // Case 3: Serializable Transaction
+    if (isTransactionSerializable(evmMessage)) {
+        return {
+            type: "evm",
+            transaction: evmMessage,
+        };
+    }
+    return null;
+}

package/dist/esm/index.d.ts

@@ -4,4 +4,4 @@ export * from "./util";
 export * from "./constants";
 export * from "./decode";
 export * from "./lib/safe-message";
-export { Network, BaseTx, SignRequestData, populateTx, NetworkFields, signatureFromOutcome, signatureFromTxHash, requestRouter as mpcRequestRouter, EthTransactionParams, } from "near-ca";
+export { Network, BaseTx, SignRequestData, populateTx, NetworkFields, signatureFromOutcome, signatureFromTxHash, requestRouter as mpcRequestRouter, EthTransactionParams, isRlpHex, } from "near-ca";

package/dist/esm/index.js

@@ -4,4 +4,5 @@ export * from "./util";
 export * from "./constants";
 export * from "./decode";
 export * from "./lib/safe-message";
-export { Network, populateTx, signatureFromOutcome, signatureFromTxHash, requestRouter as mpcRequestRouter, } from "near-ca";
+// TODO: Improve re-exports...
+export { Network, populateTx, signatureFromOutcome, signatureFromTxHash, requestRouter as mpcRequestRouter, isRlpHex, } from "near-ca";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "near-safe",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "license": "MIT",
   "description": "An SDK for controlling Ethereum Smart Accounts via ERC4337 from a Near Account.",
   "author": "bh2smith",