genlayer-js 0.27.7 → 0.27.9

package/README.md

@@ -170,39 +170,44 @@ console.log(trace.genvm_log);    // detailed GenVM execution logs
 
 ### Using with a wallet provider (MetaMask)
 
-When building a browser dApp, pass the wallet address and EIP-1193 provider. The SDK routes signing operations through the wallet and all reads directly to the GenLayer RPC.
+When building a browser dApp, create two clients: one for reads (no wallet needed) and one for writes (signed by the wallet). This follows the standard viem pattern and keeps concerns separated.
 
 ```typescript
 import { createClient } from "genlayer-js";
 import { testnetBradbury } from "genlayer-js/chains";
 import { TransactionStatus } from "genlayer-js/types";
 
-// Get address and provider from your wallet connection
-const address = "0x..."; // from wallet
-const provider = window.ethereum; // or from a wallet SDK
+// Read client — talks directly to GenLayer RPC, no wallet needed
+const readClient = createClient({
+  chain: testnetBradbury,
+});
 
-const client = createClient({
+// Write client — signs transactions through the wallet
+const writeClient = createClient({
   chain: testnetBradbury,
-  account: address as `0x${string}`,
-  provider,
+  account: address as `0x${string}`, // from wallet connection
+  provider: window.ethereum,          // or from a wallet SDK
 });
 
-// Reads go directly to GenLayer RPC — no wallet involved
-const result = await client.readContract({
+// Use readClient for all reads
+const result = await readClient.readContract({
   address: contractAddress,
   functionName: "get_storage",
   args: [],
 });
 
-// Writes are signed by the wallet (MetaMask popup)
-const txHash = await client.writeContract({
+const tx = await readClient.getTransaction({ hash: txHash });
+
+// Use writeClient for transactions (MetaMask popup)
+const txHash = await writeClient.writeContract({
   address: contractAddress,
   functionName: "update_storage",
   args: ["new_value"],
   value: BigInt(0),
 });
 
-const receipt = await client.waitForTransactionReceipt({
+// Either client can wait for receipts
+const receipt = await readClient.waitForTransactionReceipt({
   hash: txHash,
   status: TransactionStatus.ACCEPTED,
 });

package/dist/{index-9P6HoP_s.d.cts → index-CX8nErk-.d.cts}

@@ -2889,6 +2889,9 @@ type GenLayerClient<TGenLayerChain extends GenLayerChain> = Omit<Client<Transpor
         hash: TransactionHash;
         round?: number;
     }) => Promise<DebugTraceResult>;
+    getTransactionQueuePosition: (args: {
+        hash: TransactionHash;
+    }) => Promise<number>;
     cancelTransaction: (args: {
         hash: TransactionHash;
     }) => Promise<{

package/dist/{index-Bf1V-aai.d.ts → index-DPzGu_2l.d.ts}

@@ -2889,6 +2889,9 @@ type GenLayerClient<TGenLayerChain extends GenLayerChain> = Omit<Client<Transpor
         hash: TransactionHash;
         round?: number;
     }) => Promise<DebugTraceResult>;
+    getTransactionQueuePosition: (args: {
+        hash: TransactionHash;
+    }) => Promise<number>;
     cancelTransaction: (args: {
         hash: TransactionHash;
     }) => Promise<{

package/dist/index.cjs

@@ -533,7 +533,7 @@ var contractActions = (client, publicClient) => {
     /** Retrieves the source code of a deployed contract. Localnet only. */
     getContractCode: async (address) => {
       if (client.chain.id !== _chunkNOMVZBCRcjs.localnet.id) {
-        throw new Error("Getting contract code is not supported on this network");
+        throw new Error(`getContractCode is only available on localnet (current chain: ${client.chain.name})`);
       }
       const result = await client.request({
         method: "gen_getContractCode",
@@ -545,7 +545,7 @@ var contractActions = (client, publicClient) => {
     /** Gets the schema (methods and constructor) of a deployed contract. Localnet only. */
     getContractSchema: async (address) => {
       if (client.chain.id !== _chunkNOMVZBCRcjs.localnet.id) {
-        throw new Error("Contract schema is not supported on this network");
+        throw new Error(`getContractSchema is only available on localnet (current chain: ${client.chain.name})`);
       }
       const schema = await client.request({
         method: "gen_getContractSchema",
@@ -556,7 +556,7 @@ var contractActions = (client, publicClient) => {
     /** Generates a schema for contract code without deploying it. Localnet only. */
     getContractSchemaForCode: async (contractCode) => {
       if (client.chain.id !== _chunkNOMVZBCRcjs.localnet.id) {
-        throw new Error("Contract schema is not supported on this network");
+        throw new Error(`getContractSchema is only available on localnet (current chain: ${client.chain.name})`);
       }
       const schema = await client.request({
         method: "gen_getContractSchemaForCode",
@@ -762,6 +762,17 @@ var validateAccount = (Account4) => {
   }
   return Account4;
 };
+var CREATED_TRANSACTION_EVENT_ABI = [
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "bytes32", name: "txId", type: "bytes32" },
+      { indexed: false, internalType: "uint256", name: "txSlot", type: "uint256" }
+    ],
+    name: "CreatedTransaction",
+    type: "event"
+  }
+];
 var ADD_TRANSACTION_ABI_V5 = [
   {
     type: "function",
@@ -876,6 +887,25 @@ var isAddTransactionAbiMismatchError = (error) => {
   ].filter(Boolean).join(" ").toLowerCase();
   return errorMessage.includes("invalid pointer in tuple") || errorMessage.includes("invalid pointer") || errorMessage.includes("could not decode") || errorMessage.includes("invalid arrayify value") || errorMessage.includes("types/value length mismatch");
 };
+var extractTxIdFromLogs = (client, logs) => {
+  const newTxEvents = _viem.parseEventLogs.call(void 0, {
+    abi: _optionalChain([client, 'access', _33 => _33.chain, 'access', _34 => _34.consensusMainContract, 'optionalAccess', _35 => _35.abi]),
+    eventName: "NewTransaction",
+    logs
+  });
+  if (newTxEvents.length > 0) {
+    return newTxEvents[0].args["txId"];
+  }
+  const createdTxEvents = _viem.parseEventLogs.call(void 0, {
+    abi: CREATED_TRANSACTION_EVENT_ABI,
+    eventName: "CreatedTransaction",
+    logs
+  });
+  if (createdTxEvents.length > 0) {
+    return createdTxEvents[0].args["txId"];
+  }
+  return null;
+};
 var _sendTransaction = async ({
   client,
   publicClient,
@@ -884,8 +914,8 @@ var _sendTransaction = async ({
   senderAccount,
   value = 0n
 }) => {
-  if (!_optionalChain([client, 'access', _33 => _33.chain, 'access', _34 => _34.consensusMainContract, 'optionalAccess', _35 => _35.address])) {
-    throw new Error("Consensus main contract not initialized. Please ensure client is properly initialized.");
+  if (!_optionalChain([client, 'access', _36 => _36.chain, 'access', _37 => _37.consensusMainContract, 'optionalAccess', _38 => _38.address])) {
+    throw new Error(`Consensus main contract address not found in chain config for "${client.chain.name}".`);
   }
   const validatedSenderAccount = validateAccount(senderAccount);
   const nonce = await client.getCurrentNonce({ address: validatedSenderAccount.address });
@@ -894,7 +924,7 @@ var _sendTransaction = async ({
     try {
       estimatedGas = await client.estimateTransactionGas({
         from: validatedSenderAccount.address,
-        to: _optionalChain([client, 'access', _36 => _36.chain, 'access', _37 => _37.consensusMainContract, 'optionalAccess', _38 => _38.address]),
+        to: _optionalChain([client, 'access', _39 => _39.chain, 'access', _40 => _40.consensusMainContract, 'optionalAccess', _41 => _41.address]),
         data: encodedDataForSend,
         value
       });
@@ -902,16 +932,16 @@ var _sendTransaction = async ({
       console.error("Gas estimation failed, using default 200_000:", err);
       estimatedGas = 200000n;
     }
-    if (_optionalChain([validatedSenderAccount, 'optionalAccess', _39 => _39.type]) === "local") {
-      if (!_optionalChain([validatedSenderAccount, 'optionalAccess', _40 => _40.signTransaction])) {
-        throw new Error("Account does not support signTransaction");
+    if (_optionalChain([validatedSenderAccount, 'optionalAccess', _42 => _42.type]) === "local") {
+      if (!_optionalChain([validatedSenderAccount, 'optionalAccess', _43 => _43.signTransaction])) {
+        throw new Error("Local account does not support signTransaction. Use a private key account created via privateKeyToAccount().");
       }
       const gasPriceHex2 = await client.request({
         method: "eth_gasPrice"
       });
       const transactionRequest = {
         account: validatedSenderAccount,
-        to: _optionalChain([client, 'access', _41 => _41.chain, 'access', _42 => _42.consensusMainContract, 'optionalAccess', _43 => _43.address]),
+        to: _optionalChain([client, 'access', _44 => _44.chain, 'access', _45 => _45.consensusMainContract, 'optionalAccess', _46 => _46.address]),
         data: encodedDataForSend,
         type: "legacy",
         nonce: Number(nonce),
@@ -924,17 +954,15 @@ var _sendTransaction = async ({
       const txHash = await client.sendRawTransaction({ serializedTransaction });
       const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
       if (receipt.status === "reverted") {
-        throw new Error("Transaction reverted");
+        throw new Error(`Transaction reverted: EVM tx ${txHash} to consensus contract ${_optionalChain([client, 'access', _47 => _47.chain, 'access', _48 => _48.consensusMainContract, 'optionalAccess', _49 => _49.address])} was reverted.`);
       }
-      const newTxEvents = _viem.parseEventLogs.call(void 0, {
-        abi: _optionalChain([client, 'access', _44 => _44.chain, 'access', _45 => _45.consensusMainContract, 'optionalAccess', _46 => _46.abi]),
-        eventName: "NewTransaction",
-        logs: receipt.logs
-      });
-      if (newTxEvents.length === 0) {
-        throw new Error("Transaction not processed by consensus");
+      const txId = extractTxIdFromLogs(client, receipt.logs);
+      if (!txId) {
+        throw new Error(
+          `Transaction not processed by consensus: EVM tx ${txHash} succeeded but no NewTransaction or CreatedTransaction event was found in the receipt logs.`
+        );
       }
-      return newTxEvents[0].args["txId"];
+      return txId;
     }
     let gasPriceHex;
     try {
@@ -950,7 +978,7 @@ var _sendTransaction = async ({
     const nonceBigInt = typeof nonce === "bigint" ? nonce : typeof nonce === "string" ? BigInt(nonce) : BigInt(Number(nonce));
     const formattedRequest = {
       from: validatedSenderAccount.address,
-      to: _optionalChain([client, 'access', _47 => _47.chain, 'access', _48 => _48.consensusMainContract, 'optionalAccess', _49 => _49.address]),
+      to: _optionalChain([client, 'access', _50 => _50.chain, 'access', _51 => _51.consensusMainContract, 'optionalAccess', _52 => _52.address]),
       data: encodedDataForSend,
       value: `0x${value.toString(16)}`,
       gas: `0x${estimatedGas.toString(16)}`,
@@ -966,17 +994,15 @@ var _sendTransaction = async ({
     });
     const externalReceipt = await publicClient.waitForTransactionReceipt({ hash: evmTxHash });
     if (externalReceipt.status === "reverted") {
-      throw new Error("Transaction reverted");
+      throw new Error(`Transaction reverted: EVM tx ${evmTxHash} to consensus contract ${_optionalChain([client, 'access', _53 => _53.chain, 'access', _54 => _54.consensusMainContract, 'optionalAccess', _55 => _55.address])} was reverted.`);
     }
-    const externalNewTxEvents = _viem.parseEventLogs.call(void 0, {
-      abi: _optionalChain([client, 'access', _50 => _50.chain, 'access', _51 => _51.consensusMainContract, 'optionalAccess', _52 => _52.abi]),
-      eventName: "NewTransaction",
-      logs: externalReceipt.logs
-    });
-    if (externalNewTxEvents.length === 0) {
-      throw new Error("Transaction not processed by consensus");
+    const externalTxId = extractTxIdFromLogs(client, externalReceipt.logs);
+    if (!externalTxId) {
+      throw new Error(
+        `Transaction not processed by consensus: EVM tx ${evmTxHash} succeeded but no NewTransaction or CreatedTransaction event was found in the receipt logs.`
+      );
     }
-    return externalNewTxEvents[0].args["txId"];
+    return externalTxId;
   };
   try {
     return await sendWithEncodedData(encodedData);
@@ -1093,7 +1119,7 @@ var decodeTransaction = (tx) => {
     txData,
     txDataDecoded,
     currentTimestamp: tx.currentTimestamp.toString(),
-    numOfInitialValidators: _nullishCoalesce(_optionalChain([numOfInitialValidators, 'optionalAccess', _53 => _53.toString, 'call', _54 => _54()]), () => ( "0")),
+    numOfInitialValidators: _nullishCoalesce(_optionalChain([numOfInitialValidators, 'optionalAccess', _56 => _56.toString, 'call', _57 => _57()]), () => ( "0")),
     txSlot: tx.txSlot.toString(),
     createdTimestamp: tx.createdTimestamp.toString(),
     lastVoteTimestamp: tx.lastVoteTimestamp.toString(),
@@ -1101,9 +1127,9 @@ var decodeTransaction = (tx) => {
     numOfRounds: tx.numOfRounds.toString(),
     readStateBlockRange: {
       ...tx.readStateBlockRange,
-      activationBlock: _nullishCoalesce(_optionalChain([tx, 'access', _55 => _55.readStateBlockRange, 'optionalAccess', _56 => _56.activationBlock, 'optionalAccess', _57 => _57.toString, 'call', _58 => _58()]), () => ( "0")),
-      processingBlock: _nullishCoalesce(_optionalChain([tx, 'access', _59 => _59.readStateBlockRange, 'optionalAccess', _60 => _60.processingBlock, 'optionalAccess', _61 => _61.toString, 'call', _62 => _62()]), () => ( "0")),
-      proposalBlock: _nullishCoalesce(_optionalChain([tx, 'access', _63 => _63.readStateBlockRange, 'optionalAccess', _64 => _64.proposalBlock, 'optionalAccess', _65 => _65.toString, 'call', _66 => _66()]), () => ( "0"))
+      activationBlock: _nullishCoalesce(_optionalChain([tx, 'access', _58 => _58.readStateBlockRange, 'optionalAccess', _59 => _59.activationBlock, 'optionalAccess', _60 => _60.toString, 'call', _61 => _61()]), () => ( "0")),
+      processingBlock: _nullishCoalesce(_optionalChain([tx, 'access', _62 => _62.readStateBlockRange, 'optionalAccess', _63 => _63.processingBlock, 'optionalAccess', _64 => _64.toString, 'call', _65 => _65()]), () => ( "0")),
+      proposalBlock: _nullishCoalesce(_optionalChain([tx, 'access', _66 => _66.readStateBlockRange, 'optionalAccess', _67 => _67.proposalBlock, 'optionalAccess', _68 => _68.toString, 'call', _69 => _69()]), () => ( "0"))
     },
     statusName: _chunkGJXSECNHcjs.transactionsStatusNumberToName[String(tx.status)],
     resultName: _chunkGJXSECNHcjs.transactionResultNumberToName[String(tx.result)],
@@ -1111,13 +1137,13 @@ var decodeTransaction = (tx) => {
     txExecutionResultName: tx.txExecutionResult !== void 0 ? _chunkGJXSECNHcjs.executionResultNumberToName[String(tx.txExecutionResult)] : void 0,
     lastRound: {
       ...tx.lastRound,
-      round: _nullishCoalesce(_optionalChain([tx, 'access', _67 => _67.lastRound, 'optionalAccess', _68 => _68.round, 'optionalAccess', _69 => _69.toString, 'call', _70 => _70()]), () => ( "0")),
-      leaderIndex: _nullishCoalesce(_optionalChain([tx, 'access', _71 => _71.lastRound, 'optionalAccess', _72 => _72.leaderIndex, 'optionalAccess', _73 => _73.toString, 'call', _74 => _74()]), () => ( "0")),
-      votesCommitted: _nullishCoalesce(_optionalChain([tx, 'access', _75 => _75.lastRound, 'optionalAccess', _76 => _76.votesCommitted, 'optionalAccess', _77 => _77.toString, 'call', _78 => _78()]), () => ( "0")),
-      votesRevealed: _nullishCoalesce(_optionalChain([tx, 'access', _79 => _79.lastRound, 'optionalAccess', _80 => _80.votesRevealed, 'optionalAccess', _81 => _81.toString, 'call', _82 => _82()]), () => ( "0")),
-      appealBond: _nullishCoalesce(_optionalChain([tx, 'access', _83 => _83.lastRound, 'optionalAccess', _84 => _84.appealBond, 'optionalAccess', _85 => _85.toString, 'call', _86 => _86()]), () => ( "0")),
-      rotationsLeft: _nullishCoalesce(_optionalChain([tx, 'access', _87 => _87.lastRound, 'optionalAccess', _88 => _88.rotationsLeft, 'optionalAccess', _89 => _89.toString, 'call', _90 => _90()]), () => ( "0")),
-      validatorVotesName: (_nullishCoalesce(_optionalChain([tx, 'access', _91 => _91.lastRound, 'optionalAccess', _92 => _92.validatorVotes]), () => ( []))).map(
+      round: _nullishCoalesce(_optionalChain([tx, 'access', _70 => _70.lastRound, 'optionalAccess', _71 => _71.round, 'optionalAccess', _72 => _72.toString, 'call', _73 => _73()]), () => ( "0")),
+      leaderIndex: _nullishCoalesce(_optionalChain([tx, 'access', _74 => _74.lastRound, 'optionalAccess', _75 => _75.leaderIndex, 'optionalAccess', _76 => _76.toString, 'call', _77 => _77()]), () => ( "0")),
+      votesCommitted: _nullishCoalesce(_optionalChain([tx, 'access', _78 => _78.lastRound, 'optionalAccess', _79 => _79.votesCommitted, 'optionalAccess', _80 => _80.toString, 'call', _81 => _81()]), () => ( "0")),
+      votesRevealed: _nullishCoalesce(_optionalChain([tx, 'access', _82 => _82.lastRound, 'optionalAccess', _83 => _83.votesRevealed, 'optionalAccess', _84 => _84.toString, 'call', _85 => _85()]), () => ( "0")),
+      appealBond: _nullishCoalesce(_optionalChain([tx, 'access', _86 => _86.lastRound, 'optionalAccess', _87 => _87.appealBond, 'optionalAccess', _88 => _88.toString, 'call', _89 => _89()]), () => ( "0")),
+      rotationsLeft: _nullishCoalesce(_optionalChain([tx, 'access', _90 => _90.lastRound, 'optionalAccess', _91 => _91.rotationsLeft, 'optionalAccess', _92 => _92.toString, 'call', _93 => _93()]), () => ( "0")),
+      validatorVotesName: (_nullishCoalesce(_optionalChain([tx, 'access', _94 => _94.lastRound, 'optionalAccess', _95 => _95.validatorVotes]), () => ( []))).map(
         (vote) => _chunkGJXSECNHcjs.voteTypeNumberToName[String(vote)]
       )
     }
@@ -1199,7 +1225,7 @@ var simplifyTransactionReceipt = (tx) => {
 var decodeLocalnetTransaction = (tx) => {
   if (!tx.data) return tx;
   try {
-    const leaderReceipt = _optionalChain([tx, 'access', _93 => _93.consensus_data, 'optionalAccess', _94 => _94.leader_receipt]);
+    const leaderReceipt = _optionalChain([tx, 'access', _96 => _96.consensus_data, 'optionalAccess', _97 => _97.leader_receipt]);
     if (leaderReceipt) {
       const receipts = Array.isArray(leaderReceipt) ? leaderReceipt : [leaderReceipt];
       receipts.forEach((receipt) => {
@@ -1230,7 +1256,7 @@ var decodeLocalnetTransaction = (tx) => {
         }
       });
     }
-    if (_optionalChain([tx, 'access', _95 => _95.data, 'optionalAccess', _96 => _96.calldata]) && typeof tx.data.calldata === "string") {
+    if (_optionalChain([tx, 'access', _98 => _98.data, 'optionalAccess', _99 => _99.calldata]) && typeof tx.data.calldata === "string") {
       tx.data.calldata = {
         base64: tx.data.calldata,
         ...calldataToUserFriendlyJson(b64ToArray(tx.data.calldata))
@@ -1256,7 +1282,7 @@ var receiptActions = (client, publicClient) => ({
       hash
     });
     if (!transaction) {
-      throw new Error("Transaction not found");
+      throw new Error(`Transaction not found: ${hash}`);
     }
     const transactionStatusString = String(transaction.status);
     const requestedStatus = _chunkGJXSECNHcjs.transactionsStatusNameToNumber[status];
@@ -1271,7 +1297,7 @@ var receiptActions = (client, publicClient) => ({
       return finalTransaction;
     }
     if (retries === 0) {
-      throw new Error("Transaction status is not " + status);
+      throw new Error(`Timed out waiting for transaction ${hash} to reach status "${status}" (current status: ${transactionStatusString}).`);
     }
     await sleep(interval);
     return receiptActions(client, publicClient).waitForTransactionReceipt({
@@ -1293,8 +1319,8 @@ var transactionActions = (client, publicClient) => ({
       transaction2.statusName = localnetStatus;
       return decodeLocalnetTransaction(transaction2);
     }
-    const contractAddress = _optionalChain([client, 'access', _97 => _97.chain, 'access', _98 => _98.consensusDataContract, 'optionalAccess', _99 => _99.address]);
-    const contractAbi = _optionalChain([client, 'access', _100 => _100.chain, 'access', _101 => _101.consensusDataContract, 'optionalAccess', _102 => _102.abi]);
+    const contractAddress = _optionalChain([client, 'access', _100 => _100.chain, 'access', _101 => _101.consensusDataContract, 'optionalAccess', _102 => _102.address]);
+    const contractAbi = _optionalChain([client, 'access', _103 => _103.chain, 'access', _104 => _104.consensusDataContract, 'optionalAccess', _105 => _105.abi]);
     const [txDataRaw, allDataRaw] = await Promise.all([
       publicClient.readContract({
         address: contractAddress,
@@ -1324,12 +1350,12 @@ var transactionActions = (client, publicClient) => ({
       return _nullishCoalesce(tx2.triggered_transactions, () => ( []));
     }
     const tx = await transactionActions(client, publicClient).getTransaction({ hash });
-    const proposalBlock = BigInt(_nullishCoalesce(_optionalChain([tx, 'access', _103 => _103.readStateBlockRange, 'optionalAccess', _104 => _104.proposalBlock]), () => ( "0")));
+    const proposalBlock = BigInt(_nullishCoalesce(_optionalChain([tx, 'access', _106 => _106.readStateBlockRange, 'optionalAccess', _107 => _107.proposalBlock]), () => ( "0")));
     if (proposalBlock === BigInt(0)) return [];
     const scanRange = BigInt(100);
     const latestBlock = await publicClient.getBlockNumber();
     const toBlock = proposalBlock + scanRange < latestBlock ? proposalBlock + scanRange : latestBlock;
-    const consensusAddress = _optionalChain([client, 'access', _105 => _105.chain, 'access', _106 => _106.consensusMainContract, 'optionalAccess', _107 => _107.address]);
+    const consensusAddress = _optionalChain([client, 'access', _108 => _108.chain, 'access', _109 => _109.consensusMainContract, 'optionalAccess', _110 => _110.address]);
     const internalMessageProcessedTopic = _viem.keccak256.call(void 0, _viem.stringToBytes.call(void 0, "InternalMessageProcessed(bytes32,address,address)"));
     const logs = await publicClient.getLogs({
       address: consensusAddress,
@@ -1376,10 +1402,36 @@ var transactionActions = (client, publicClient) => ({
       params: [hash, signature]
     });
   },
+  /** Returns the queue slot position of a transaction in the pending queue. */
+  getTransactionQueuePosition: async ({ hash }) => {
+    const consensusAddress = _optionalChain([client, 'access', _111 => _111.chain, 'access', _112 => _112.consensusMainContract, 'optionalAccess', _113 => _113.address]);
+    const consensusAbi = _optionalChain([client, 'access', _114 => _114.chain, 'access', _115 => _115.consensusMainContract, 'optionalAccess', _116 => _116.abi]);
+    const queuesAddress = await publicClient.readContract({
+      address: consensusAddress,
+      abi: consensusAbi,
+      functionName: "queues"
+    });
+    const QUEUES_ABI = [
+      {
+        inputs: [{ internalType: "bytes32", name: "txId", type: "bytes32" }],
+        name: "getTransactionQueuePosition",
+        outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+        stateMutability: "view",
+        type: "function"
+      }
+    ];
+    const position = await publicClient.readContract({
+      address: queuesAddress,
+      abi: QUEUES_ABI,
+      functionName: "getTransactionQueuePosition",
+      args: [hash]
+    });
+    return Number(position);
+  },
   /** Estimates gas required for a transaction. */
   estimateTransactionGas: async (transactionParams) => {
     const formattedParams = {
-      from: transactionParams.from || _optionalChain([client, 'access', _108 => _108.account, 'optionalAccess', _109 => _109.address]),
+      from: transactionParams.from || _optionalChain([client, 'access', _117 => _117.account, 'optionalAccess', _118 => _118.address]),
       to: transactionParams.to,
       data: transactionParams.data || "0x",
       value: transactionParams.value ? `0x${transactionParams.value.toString(16)}` : "0x0"
@@ -1422,7 +1474,7 @@ var connect = async (client, network = "studionet", snapSource = "npm") => {
     chainName: selectedNetwork.name,
     rpcUrls: selectedNetwork.rpcUrls.default.http,
     nativeCurrency: selectedNetwork.nativeCurrency,
-    blockExplorerUrls: [_optionalChain([selectedNetwork, 'access', _110 => _110.blockExplorers, 'optionalAccess', _111 => _111.default, 'access', _112 => _112.url])]
+    blockExplorerUrls: [_optionalChain([selectedNetwork, 'access', _119 => _119.blockExplorers, 'optionalAccess', _120 => _120.default, 'access', _121 => _121.url])]
   };
   const currentChainId = await window.ethereum.request({ method: "eth_chainId" });
   if (currentChainId !== chainIdHex) {
@@ -1456,10 +1508,10 @@ var metamaskClient = async (snapSource = "npm") => {
   }
   const isFlask = async () => {
     try {
-      const clientVersion = await _optionalChain([window, 'access', _113 => _113.ethereum, 'optionalAccess', _114 => _114.request, 'call', _115 => _115({
+      const clientVersion = await _optionalChain([window, 'access', _122 => _122.ethereum, 'optionalAccess', _123 => _123.request, 'call', _124 => _124({
         method: "web3_clientVersion"
       })]);
-      return _optionalChain([clientVersion, 'optionalAccess', _116 => _116.includes, 'call', _117 => _117("flask")]);
+      return _optionalChain([clientVersion, 'optionalAccess', _125 => _125.includes, 'call', _126 => _126("flask")]);
     } catch (error) {
       console.error("Error detecting Flask:", error);
       return false;
@@ -1467,7 +1519,7 @@ var metamaskClient = async (snapSource = "npm") => {
   };
   const installedSnaps = async () => {
     try {
-      return await _optionalChain([window, 'access', _118 => _118.ethereum, 'optionalAccess', _119 => _119.request, 'call', _120 => _120({
+      return await _optionalChain([window, 'access', _127 => _127.ethereum, 'optionalAccess', _128 => _128.request, 'call', _129 => _129({
         method: "wallet_getSnaps"
       })]);
     } catch (error) {
@@ -1554,7 +1606,7 @@ function extractRevertReason(err) {
     }
     const revertError = err.walk((e) => e instanceof _viem.ContractFunctionRevertedError);
     if (revertError instanceof _viem.ContractFunctionRevertedError) {
-      if (_optionalChain([revertError, 'access', _121 => _121.data, 'optionalAccess', _122 => _122.errorName])) {
+      if (_optionalChain([revertError, 'access', _130 => _130.data, 'optionalAccess', _131 => _131.errorName])) {
         return revertError.data.errorName;
       }
       return revertError.reason || "Unknown reason";
@@ -1642,7 +1694,7 @@ var stakingActions = (client, publicClient) => {
   };
   const getStakingAddress = () => {
     const stakingConfig = client.chain.stakingContract;
-    if (!_optionalChain([stakingConfig, 'optionalAccess', _123 => _123.address]) || stakingConfig.address === "0x0000000000000000000000000000000000000000") {
+    if (!_optionalChain([stakingConfig, 'optionalAccess', _132 => _132.address]) || stakingConfig.address === "0x0000000000000000000000000000000000000000") {
       throw new Error("Staking is not supported on studio-based networks. Use testnet-asimov for staking operations.");
     }
     return stakingConfig.address;
@@ -1727,10 +1779,10 @@ var stakingActions = (client, publicClient) => {
     },
     /** Claims pending validator withdrawals. */
     validatorClaim: async (options) => {
-      if (!_optionalChain([options, 'optionalAccess', _124 => _124.validator]) && !client.account) {
+      if (!_optionalChain([options, 'optionalAccess', _133 => _133.validator]) && !client.account) {
         throw new Error("Either provide validator address or initialize client with an account");
       }
-      const validatorAddress = _optionalChain([options, 'optionalAccess', _125 => _125.validator]) || client.account.address;
+      const validatorAddress = _optionalChain([options, 'optionalAccess', _134 => _134.validator]) || client.account.address;
       const data = _viem.encodeFunctionData.call(void 0, {
         abi: _chunkNOMVZBCRcjs.STAKING_ABI,
         functionName: "validatorClaim",

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as viem from 'viem';
 import { Account, Address, Hex } from 'viem';
 import { G as GenLayerChain } from './chains-DqSbucSW.cjs';
-import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement, S as STAKING_ABI, V as VALIDATOR_WALLET_ABI, d as ContractSchema } from './index-9P6HoP_s.cjs';
+import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement, S as STAKING_ABI, V as VALIDATOR_WALLET_ABI, d as ContractSchema } from './index-CX8nErk-.cjs';
 import * as abitype from 'abitype';
 import * as viem__types_types_authorization from 'viem/_types/types/authorization';
 import * as viem_accounts from 'viem/accounts';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as viem from 'viem';
 import { Account, Address, Hex } from 'viem';
 import { G as GenLayerChain } from './chains-DqSbucSW.js';
-import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement, S as STAKING_ABI, V as VALIDATOR_WALLET_ABI, d as ContractSchema } from './index-Bf1V-aai.js';
+import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement, S as STAKING_ABI, V as VALIDATOR_WALLET_ABI, d as ContractSchema } from './index-DPzGu_2l.js';
 import * as abitype from 'abitype';
 import * as viem__types_types_authorization from 'viem/_types/types/authorization';
 import * as viem_accounts from 'viem/accounts';

package/dist/index.js

@@ -533,7 +533,7 @@ var contractActions = (client, publicClient) => {
     /** Retrieves the source code of a deployed contract. Localnet only. */
     getContractCode: async (address) => {
       if (client.chain.id !== localnet.id) {
-        throw new Error("Getting contract code is not supported on this network");
+        throw new Error(`getContractCode is only available on localnet (current chain: ${client.chain.name})`);
       }
       const result = await client.request({
         method: "gen_getContractCode",
@@ -545,7 +545,7 @@ var contractActions = (client, publicClient) => {
     /** Gets the schema (methods and constructor) of a deployed contract. Localnet only. */
     getContractSchema: async (address) => {
       if (client.chain.id !== localnet.id) {
-        throw new Error("Contract schema is not supported on this network");
+        throw new Error(`getContractSchema is only available on localnet (current chain: ${client.chain.name})`);
       }
       const schema = await client.request({
         method: "gen_getContractSchema",
@@ -556,7 +556,7 @@ var contractActions = (client, publicClient) => {
     /** Generates a schema for contract code without deploying it. Localnet only. */
     getContractSchemaForCode: async (contractCode) => {
       if (client.chain.id !== localnet.id) {
-        throw new Error("Contract schema is not supported on this network");
+        throw new Error(`getContractSchema is only available on localnet (current chain: ${client.chain.name})`);
       }
       const schema = await client.request({
         method: "gen_getContractSchemaForCode",
@@ -762,6 +762,17 @@ var validateAccount = (Account4) => {
   }
   return Account4;
 };
+var CREATED_TRANSACTION_EVENT_ABI = [
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "bytes32", name: "txId", type: "bytes32" },
+      { indexed: false, internalType: "uint256", name: "txSlot", type: "uint256" }
+    ],
+    name: "CreatedTransaction",
+    type: "event"
+  }
+];
 var ADD_TRANSACTION_ABI_V5 = [
   {
     type: "function",
@@ -876,6 +887,25 @@ var isAddTransactionAbiMismatchError = (error) => {
   ].filter(Boolean).join(" ").toLowerCase();
   return errorMessage.includes("invalid pointer in tuple") || errorMessage.includes("invalid pointer") || errorMessage.includes("could not decode") || errorMessage.includes("invalid arrayify value") || errorMessage.includes("types/value length mismatch");
 };
+var extractTxIdFromLogs = (client, logs) => {
+  const newTxEvents = parseEventLogs({
+    abi: client.chain.consensusMainContract?.abi,
+    eventName: "NewTransaction",
+    logs
+  });
+  if (newTxEvents.length > 0) {
+    return newTxEvents[0].args["txId"];
+  }
+  const createdTxEvents = parseEventLogs({
+    abi: CREATED_TRANSACTION_EVENT_ABI,
+    eventName: "CreatedTransaction",
+    logs
+  });
+  if (createdTxEvents.length > 0) {
+    return createdTxEvents[0].args["txId"];
+  }
+  return null;
+};
 var _sendTransaction = async ({
   client,
   publicClient,
@@ -885,7 +915,7 @@ var _sendTransaction = async ({
   value = 0n
 }) => {
   if (!client.chain.consensusMainContract?.address) {
-    throw new Error("Consensus main contract not initialized. Please ensure client is properly initialized.");
+    throw new Error(`Consensus main contract address not found in chain config for "${client.chain.name}".`);
   }
   const validatedSenderAccount = validateAccount(senderAccount);
   const nonce = await client.getCurrentNonce({ address: validatedSenderAccount.address });
@@ -904,7 +934,7 @@ var _sendTransaction = async ({
     }
     if (validatedSenderAccount?.type === "local") {
       if (!validatedSenderAccount?.signTransaction) {
-        throw new Error("Account does not support signTransaction");
+        throw new Error("Local account does not support signTransaction. Use a private key account created via privateKeyToAccount().");
       }
       const gasPriceHex2 = await client.request({
         method: "eth_gasPrice"
@@ -924,17 +954,15 @@ var _sendTransaction = async ({
       const txHash = await client.sendRawTransaction({ serializedTransaction });
       const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
       if (receipt.status === "reverted") {
-        throw new Error("Transaction reverted");
+        throw new Error(`Transaction reverted: EVM tx ${txHash} to consensus contract ${client.chain.consensusMainContract?.address} was reverted.`);
       }
-      const newTxEvents = parseEventLogs({
-        abi: client.chain.consensusMainContract?.abi,
-        eventName: "NewTransaction",
-        logs: receipt.logs
-      });
-      if (newTxEvents.length === 0) {
-        throw new Error("Transaction not processed by consensus");
+      const txId = extractTxIdFromLogs(client, receipt.logs);
+      if (!txId) {
+        throw new Error(
+          `Transaction not processed by consensus: EVM tx ${txHash} succeeded but no NewTransaction or CreatedTransaction event was found in the receipt logs.`
+        );
       }
-      return newTxEvents[0].args["txId"];
+      return txId;
     }
     let gasPriceHex;
     try {
@@ -966,17 +994,15 @@ var _sendTransaction = async ({
     });
     const externalReceipt = await publicClient.waitForTransactionReceipt({ hash: evmTxHash });
     if (externalReceipt.status === "reverted") {
-      throw new Error("Transaction reverted");
+      throw new Error(`Transaction reverted: EVM tx ${evmTxHash} to consensus contract ${client.chain.consensusMainContract?.address} was reverted.`);
     }
-    const externalNewTxEvents = parseEventLogs({
-      abi: client.chain.consensusMainContract?.abi,
-      eventName: "NewTransaction",
-      logs: externalReceipt.logs
-    });
-    if (externalNewTxEvents.length === 0) {
-      throw new Error("Transaction not processed by consensus");
+    const externalTxId = extractTxIdFromLogs(client, externalReceipt.logs);
+    if (!externalTxId) {
+      throw new Error(
+        `Transaction not processed by consensus: EVM tx ${evmTxHash} succeeded but no NewTransaction or CreatedTransaction event was found in the receipt logs.`
+      );
     }
-    return externalNewTxEvents[0].args["txId"];
+    return externalTxId;
   };
   try {
     return await sendWithEncodedData(encodedData);
@@ -1256,7 +1282,7 @@ var receiptActions = (client, publicClient) => ({
       hash
     });
     if (!transaction) {
-      throw new Error("Transaction not found");
+      throw new Error(`Transaction not found: ${hash}`);
     }
     const transactionStatusString = String(transaction.status);
     const requestedStatus = transactionsStatusNameToNumber[status];
@@ -1271,7 +1297,7 @@ var receiptActions = (client, publicClient) => ({
       return finalTransaction;
     }
     if (retries === 0) {
-      throw new Error("Transaction status is not " + status);
+      throw new Error(`Timed out waiting for transaction ${hash} to reach status "${status}" (current status: ${transactionStatusString}).`);
     }
     await sleep(interval);
     return receiptActions(client, publicClient).waitForTransactionReceipt({
@@ -1376,6 +1402,32 @@ var transactionActions = (client, publicClient) => ({
       params: [hash, signature]
     });
   },
+  /** Returns the queue slot position of a transaction in the pending queue. */
+  getTransactionQueuePosition: async ({ hash }) => {
+    const consensusAddress = client.chain.consensusMainContract?.address;
+    const consensusAbi = client.chain.consensusMainContract?.abi;
+    const queuesAddress = await publicClient.readContract({
+      address: consensusAddress,
+      abi: consensusAbi,
+      functionName: "queues"
+    });
+    const QUEUES_ABI = [
+      {
+        inputs: [{ internalType: "bytes32", name: "txId", type: "bytes32" }],
+        name: "getTransactionQueuePosition",
+        outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+        stateMutability: "view",
+        type: "function"
+      }
+    ];
+    const position = await publicClient.readContract({
+      address: queuesAddress,
+      abi: QUEUES_ABI,
+      functionName: "getTransactionQueuePosition",
+      args: [hash]
+    });
+    return Number(position);
+  },
   /** Estimates gas required for a transaction. */
   estimateTransactionGas: async (transactionParams) => {
     const formattedParams = {

package/dist/types/index.d.cts

@@ -1,3 +1,3 @@
 export { Account, Address } from 'viem';
-export { O as BannedValidatorInfo, e as CalldataAddress, C as CalldataEncodable, j as ContractMethod, i as ContractMethodBase, g as ContractParamsArraySchemaElement, h as ContractParamsSchema, d as ContractSchema, o as DECIDED_STATES, z as DebugTraceResult, a as DecodedCallData, D as DecodedDeployData, a7 as DelegatorClaimOptions, a6 as DelegatorExitOptions, a5 as DelegatorJoinOptions, Z as DelegatorJoinResult, R as EpochData, U as EpochInfo, E as ExecutionResult, G as GenLayerClient, f as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, L as LeaderReceipt, M as MethodDescription, N as Network, P as PendingDeposit, K as PendingWithdrawal, a4 as SetIdentityOptions, a3 as SetOperatorOptions, A as SnapSource, Q as StakeInfo, a8 as StakingActions, B as StakingContract, X as StakingTransactionResult, k as TransactionHash, y as TransactionHashVariant, m as TransactionResult, r as TransactionResultNameToNumber, l as TransactionStatus, x as TransactionType, a1 as ValidatorClaimOptions, $ as ValidatorDepositOptions, a0 as ValidatorExitOptions, I as ValidatorIdentity, J as ValidatorInfo, _ as ValidatorJoinOptions, Y as ValidatorJoinResult, a2 as ValidatorPrimeOptions, F as ValidatorView, u as VoteType, W as WithdrawalCommit, s as executionResultNumberToName, p as isDecidedState, q as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, w as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-9P6HoP_s.cjs';
+export { O as BannedValidatorInfo, e as CalldataAddress, C as CalldataEncodable, j as ContractMethod, i as ContractMethodBase, g as ContractParamsArraySchemaElement, h as ContractParamsSchema, d as ContractSchema, o as DECIDED_STATES, z as DebugTraceResult, a as DecodedCallData, D as DecodedDeployData, a7 as DelegatorClaimOptions, a6 as DelegatorExitOptions, a5 as DelegatorJoinOptions, Z as DelegatorJoinResult, R as EpochData, U as EpochInfo, E as ExecutionResult, G as GenLayerClient, f as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, L as LeaderReceipt, M as MethodDescription, N as Network, P as PendingDeposit, K as PendingWithdrawal, a4 as SetIdentityOptions, a3 as SetOperatorOptions, A as SnapSource, Q as StakeInfo, a8 as StakingActions, B as StakingContract, X as StakingTransactionResult, k as TransactionHash, y as TransactionHashVariant, m as TransactionResult, r as TransactionResultNameToNumber, l as TransactionStatus, x as TransactionType, a1 as ValidatorClaimOptions, $ as ValidatorDepositOptions, a0 as ValidatorExitOptions, I as ValidatorIdentity, J as ValidatorInfo, _ as ValidatorJoinOptions, Y as ValidatorJoinResult, a2 as ValidatorPrimeOptions, F as ValidatorView, u as VoteType, W as WithdrawalCommit, s as executionResultNumberToName, p as isDecidedState, q as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, w as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-CX8nErk-.cjs';
 export { G as GenLayerChain } from '../chains-DqSbucSW.cjs';

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
 export { Account, Address } from 'viem';
-export { O as BannedValidatorInfo, e as CalldataAddress, C as CalldataEncodable, j as ContractMethod, i as ContractMethodBase, g as ContractParamsArraySchemaElement, h as ContractParamsSchema, d as ContractSchema, o as DECIDED_STATES, z as DebugTraceResult, a as DecodedCallData, D as DecodedDeployData, a7 as DelegatorClaimOptions, a6 as DelegatorExitOptions, a5 as DelegatorJoinOptions, Z as DelegatorJoinResult, R as EpochData, U as EpochInfo, E as ExecutionResult, G as GenLayerClient, f as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, L as LeaderReceipt, M as MethodDescription, N as Network, P as PendingDeposit, K as PendingWithdrawal, a4 as SetIdentityOptions, a3 as SetOperatorOptions, A as SnapSource, Q as StakeInfo, a8 as StakingActions, B as StakingContract, X as StakingTransactionResult, k as TransactionHash, y as TransactionHashVariant, m as TransactionResult, r as TransactionResultNameToNumber, l as TransactionStatus, x as TransactionType, a1 as ValidatorClaimOptions, $ as ValidatorDepositOptions, a0 as ValidatorExitOptions, I as ValidatorIdentity, J as ValidatorInfo, _ as ValidatorJoinOptions, Y as ValidatorJoinResult, a2 as ValidatorPrimeOptions, F as ValidatorView, u as VoteType, W as WithdrawalCommit, s as executionResultNumberToName, p as isDecidedState, q as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, w as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-Bf1V-aai.js';
+export { O as BannedValidatorInfo, e as CalldataAddress, C as CalldataEncodable, j as ContractMethod, i as ContractMethodBase, g as ContractParamsArraySchemaElement, h as ContractParamsSchema, d as ContractSchema, o as DECIDED_STATES, z as DebugTraceResult, a as DecodedCallData, D as DecodedDeployData, a7 as DelegatorClaimOptions, a6 as DelegatorExitOptions, a5 as DelegatorJoinOptions, Z as DelegatorJoinResult, R as EpochData, U as EpochInfo, E as ExecutionResult, G as GenLayerClient, f as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, L as LeaderReceipt, M as MethodDescription, N as Network, P as PendingDeposit, K as PendingWithdrawal, a4 as SetIdentityOptions, a3 as SetOperatorOptions, A as SnapSource, Q as StakeInfo, a8 as StakingActions, B as StakingContract, X as StakingTransactionResult, k as TransactionHash, y as TransactionHashVariant, m as TransactionResult, r as TransactionResultNameToNumber, l as TransactionStatus, x as TransactionType, a1 as ValidatorClaimOptions, $ as ValidatorDepositOptions, a0 as ValidatorExitOptions, I as ValidatorIdentity, J as ValidatorInfo, _ as ValidatorJoinOptions, Y as ValidatorJoinResult, a2 as ValidatorPrimeOptions, F as ValidatorView, u as VoteType, W as WithdrawalCommit, s as executionResultNumberToName, p as isDecidedState, q as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, w as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-DPzGu_2l.js';
 export { G as GenLayerChain } from '../chains-DqSbucSW.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "genlayer-js",
   "type": "module",
-  "version": "0.27.7",
+  "version": "0.27.9",
   "description": "GenLayer JavaScript SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",