genlayer-js 0.27.8 → 0.28.0

package/dist/index.d.cts

@@ -1,11 +1,11 @@
 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 GenLayerChain } from './chains-D6DgvIVA.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-DQCfqVjw.cjs';
 import * as abitype from 'abitype';
 import * as viem__types_types_authorization from 'viem/_types/types/authorization';
 import * as viem_accounts from 'viem/accounts';
-export { i as chains } from './index-BvRcfXce.cjs';
+export { i as chains } from './index-_c6eHw3s.cjs';
 
 interface ClientConfig {
     chain?: {

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 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 GenLayerChain } from './chains-D6DgvIVA.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-DDgbU3hK.js';
 import * as abitype from 'abitype';
 import * as viem__types_types_authorization from 'viem/_types/types/authorization';
 import * as viem_accounts from 'viem/accounts';
-export { i as chains } from './index-BZj9d30J.js';
+export { i as chains } from './index-BCPb0x30.js';
 
 interface ClientConfig {
     chain?: {

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   studionet,
   testnetAsimov,
   testnetBradbury
-} from "./chunk-C4Z24PT6.js";
+} from "./chunk-SGAVFNGA.js";
 import {
   CalldataAddress,
   executionResultNumberToName,
@@ -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",
@@ -718,6 +718,54 @@ var contractActions = (client, publicClient) => {
       });
       return minBond;
     },
+    /** Returns the current consensus round number for a transaction. */
+    getRoundNumber: async (args) => {
+      if (!client.chain.roundsStorageContract?.address) {
+        throw new Error("getRoundNumber not supported on this chain (missing roundsStorageContract)");
+      }
+      return publicClient.readContract({
+        address: client.chain.roundsStorageContract.address,
+        abi: client.chain.roundsStorageContract.abi,
+        functionName: "getRoundNumber",
+        args: [args.txId]
+      });
+    },
+    /** Returns detailed data for a specific consensus round. */
+    getRoundData: async (args) => {
+      if (!client.chain.roundsStorageContract?.address) {
+        throw new Error("getRoundData not supported on this chain (missing roundsStorageContract)");
+      }
+      return publicClient.readContract({
+        address: client.chain.roundsStorageContract.address,
+        abi: client.chain.roundsStorageContract.abi,
+        functionName: "getRoundData",
+        args: [args.txId, args.round]
+      });
+    },
+    /** Returns the current round number and its data for a transaction. */
+    getLastRoundData: async (args) => {
+      if (!client.chain.roundsStorageContract?.address) {
+        throw new Error("getLastRoundData not supported on this chain (missing roundsStorageContract)");
+      }
+      return publicClient.readContract({
+        address: client.chain.roundsStorageContract.address,
+        abi: client.chain.roundsStorageContract.abi,
+        functionName: "getLastRoundData",
+        args: [args.txId]
+      });
+    },
+    /** Checks if a transaction can be appealed. */
+    canAppeal: async (args) => {
+      if (!client.chain.appealsContract?.address) {
+        throw new Error("canAppeal not supported on this chain (missing appealsContract)");
+      }
+      return publicClient.readContract({
+        address: client.chain.appealsContract.address,
+        abi: client.chain.appealsContract.abi,
+        functionName: "canAppeal",
+        args: [args.txId]
+      });
+    },
     /** Appeals a consensus transaction to trigger a new round of validation. */
     appealTransaction: async (args) => {
       const { account, txId } = args;
@@ -744,13 +792,61 @@ var contractActions = (client, publicClient) => {
       }
       const senderAccount = account || client.account;
       const encodedData = _encodeSubmitAppealData({ client, txId });
-      return _sendTransaction({
-        client,
-        publicClient,
-        encodedData,
-        senderAccount,
-        value
-      });
+      const validatedAccount = validateAccount(senderAccount);
+      if (!client.chain.consensusMainContract?.address) {
+        throw new Error("Consensus main contract not initialized.");
+      }
+      const nonce = await client.getCurrentNonce({ address: validatedAccount.address });
+      let estimatedGas;
+      try {
+        estimatedGas = await client.estimateTransactionGas({
+          to: client.chain.consensusMainContract.address,
+          data: encodedData,
+          value,
+          nonce
+        });
+      } catch (err) {
+        console.error("Gas estimation failed, using default 200_000:", err);
+        estimatedGas = 200000n;
+      }
+      const gasPriceHex = await client.request({ method: "eth_gasPrice" });
+      const txRequest = {
+        account: validatedAccount,
+        to: client.chain.consensusMainContract.address,
+        data: encodedData,
+        value,
+        gas: estimatedGas,
+        gasPrice: BigInt(gasPriceHex),
+        nonce,
+        chainId: client.chain.id
+      };
+      if (validatedAccount.type === "local") {
+        if (!validatedAccount.signTransaction) {
+          throw new Error("Local account does not support signTransaction.");
+        }
+        const serializedTransaction = await validatedAccount.signTransaction(txRequest);
+        const evmHash = await client.sendRawTransaction({ serializedTransaction });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash: evmHash });
+        if (receipt.status === "reverted") {
+          throw new Error(`Appeal reverted: EVM tx ${evmHash}`);
+        }
+      } else {
+        const evmHash = await client.request({
+          method: "eth_sendTransaction",
+          params: [{
+            from: validatedAccount.address,
+            to: client.chain.consensusMainContract.address,
+            data: encodedData,
+            value: value ? `0x${value.toString(16)}` : void 0,
+            gas: `0x${estimatedGas.toString(16)}`
+          }]
+        });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash: evmHash });
+        if (receipt.status === "reverted") {
+          throw new Error(`Appeal reverted: EVM tx ${evmHash}`);
+        }
+      }
+      return txId;
     }
   };
 };
@@ -762,6 +858,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 +983,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 +1011,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 +1030,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 +1050,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 +1090,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 +1378,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 +1393,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 +1498,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 { G as GenLayerChain } from '../chains-DqSbucSW.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-DQCfqVjw.cjs';
+export { G as GenLayerChain } from '../chains-D6DgvIVA.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 { G as GenLayerChain } from '../chains-DqSbucSW.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-DDgbU3hK.js';
+export { G as GenLayerChain } from '../chains-D6DgvIVA.js';

package/package.json

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