genlayer-js 0.18.1 → 0.18.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 
 
+## 0.18.3 (2025-11-03)
+
+
+### Bug Fixes
+
+* default to zero address for read operations when account not provided ([#121](https://github.com/genlayerlabs/genlayer-js/issues/121)) ([6a1b47a](https://github.com/genlayerlabs/genlayer-js/commit/6a1b47aeafaeb807d5219abbb88e10041c03030e))
+
+## 0.18.2 (2025-09-18)
+
+
+### Bug Fixes
+
+* **transactions:** handle all DECIDED states in waitForTransactionReceipt ([#116](https://github.com/genlayerlabs/genlayer-js/issues/116)) ([78433d7](https://github.com/genlayerlabs/genlayer-js/commit/78433d7224298ab418ca16a87de497149b66b5f7))
+
 ## 0.18.1 (2025-09-11)
 
 

package/dist/{chunk-GACCNOPJ.js → chunk-47QDX7IX.js}

@@ -75,6 +75,19 @@ var transactionsStatusNameToNumber = {
   ["VALIDATORS_TIMEOUT" /* VALIDATORS_TIMEOUT */]: "12",
   ["LEADER_TIMEOUT" /* LEADER_TIMEOUT */]: "13"
 };
+var DECIDED_STATES = [
+  "ACCEPTED" /* ACCEPTED */,
+  "UNDETERMINED" /* UNDETERMINED */,
+  "LEADER_TIMEOUT" /* LEADER_TIMEOUT */,
+  "VALIDATORS_TIMEOUT" /* VALIDATORS_TIMEOUT */,
+  "CANCELED" /* CANCELED */,
+  "FINALIZED" /* FINALIZED */
+];
+function isDecidedState(status) {
+  return DECIDED_STATES.some(
+    (state) => transactionsStatusNameToNumber[state] === status
+  );
+}
 var transactionResultNumberToName = {
   "0": "IDLE" /* IDLE */,
   "1": "AGREE" /* AGREE */,
@@ -129,6 +142,8 @@ export {
   TransactionResult,
   transactionsStatusNumberToName,
   transactionsStatusNameToNumber,
+  DECIDED_STATES,
+  isDecidedState,
   transactionResultNumberToName,
   TransactionResultNameToNumber,
   VoteType,

package/dist/{chunk-H4ZYXVV2.cjs → chunk-FPZNF3JH.cjs}

@@ -75,6 +75,19 @@ var transactionsStatusNameToNumber = {
   ["VALIDATORS_TIMEOUT" /* VALIDATORS_TIMEOUT */]: "12",
   ["LEADER_TIMEOUT" /* LEADER_TIMEOUT */]: "13"
 };
+var DECIDED_STATES = [
+  "ACCEPTED" /* ACCEPTED */,
+  "UNDETERMINED" /* UNDETERMINED */,
+  "LEADER_TIMEOUT" /* LEADER_TIMEOUT */,
+  "VALIDATORS_TIMEOUT" /* VALIDATORS_TIMEOUT */,
+  "CANCELED" /* CANCELED */,
+  "FINALIZED" /* FINALIZED */
+];
+function isDecidedState(status) {
+  return DECIDED_STATES.some(
+    (state) => transactionsStatusNameToNumber[state] === status
+  );
+}
 var transactionResultNumberToName = {
   "0": "IDLE" /* IDLE */,
   "1": "AGREE" /* AGREE */,
@@ -135,4 +148,6 @@ var TransactionHashVariant = /* @__PURE__ */ ((TransactionHashVariant2) => {
 
 
 
-exports.CalldataAddress = CalldataAddress; exports.TransactionStatus = TransactionStatus; exports.TransactionResult = TransactionResult; exports.transactionsStatusNumberToName = transactionsStatusNumberToName; exports.transactionsStatusNameToNumber = transactionsStatusNameToNumber; exports.transactionResultNumberToName = transactionResultNumberToName; exports.TransactionResultNameToNumber = TransactionResultNameToNumber; exports.VoteType = VoteType; exports.voteTypeNumberToName = voteTypeNumberToName; exports.voteTypeNameToNumber = voteTypeNameToNumber; exports.TransactionHashVariant = TransactionHashVariant;
+
+
+exports.CalldataAddress = CalldataAddress; exports.TransactionStatus = TransactionStatus; exports.TransactionResult = TransactionResult; exports.transactionsStatusNumberToName = transactionsStatusNumberToName; exports.transactionsStatusNameToNumber = transactionsStatusNameToNumber; exports.DECIDED_STATES = DECIDED_STATES; exports.isDecidedState = isDecidedState; exports.transactionResultNumberToName = transactionResultNumberToName; exports.TransactionResultNameToNumber = TransactionResultNameToNumber; exports.VoteType = VoteType; exports.voteTypeNumberToName = voteTypeNumberToName; exports.voteTypeNameToNumber = voteTypeNameToNumber; exports.TransactionHashVariant = TransactionHashVariant;

package/dist/{index-BJebZa37.d.ts → index-Rls_T310.d.ts}

@@ -80,6 +80,8 @@ declare const transactionsStatusNameToNumber: {
     VALIDATORS_TIMEOUT: string;
     LEADER_TIMEOUT: string;
 };
+declare const DECIDED_STATES: TransactionStatus[];
+declare function isDecidedState(status: string): boolean;
 declare const transactionResultNumberToName: {
     "0": TransactionResult;
     "1": TransactionResult;
@@ -402,4 +404,4 @@ type GenLayerClient<TGenLayerChain extends GenLayerChain> = Omit<Client<Transpor
     }) => Promise<any>;
 };
 
-export { type CalldataEncodable as C, type DecodedDeployData as D, type GenLayerClient as G, type Hash as H, type MethodDescription as M, type Network as N, type SnapSource as S, type TransactionDataElement as T, VoteType as V, type DecodedCallData as a, type GenLayerRawTransaction as b, type GenLayerTransaction as c, CalldataAddress as d, type GenLayerMethod as e, type ContractParamsArraySchemaElement as f, type ContractParamsSchema as g, type ContractMethodBase as h, type ContractMethod as i, type ContractSchema as j, type TransactionHash as k, TransactionStatus as l, TransactionResult as m, transactionsStatusNameToNumber as n, transactionResultNumberToName as o, TransactionResultNameToNumber as p, voteTypeNameToNumber as q, type TransactionType as r, TransactionHashVariant as s, transactionsStatusNumberToName as t, voteTypeNumberToName as v };
+export { type CalldataEncodable as C, type DecodedDeployData as D, type GenLayerClient as G, type Hash as H, type MethodDescription as M, type Network as N, type SnapSource as S, type TransactionDataElement as T, VoteType as V, type DecodedCallData as a, type GenLayerRawTransaction as b, type GenLayerTransaction as c, CalldataAddress as d, type GenLayerMethod as e, type ContractParamsArraySchemaElement as f, type ContractParamsSchema as g, type ContractMethodBase as h, type ContractMethod as i, type ContractSchema as j, type TransactionHash as k, TransactionStatus as l, TransactionResult as m, transactionsStatusNameToNumber as n, DECIDED_STATES as o, isDecidedState as p, transactionResultNumberToName as q, TransactionResultNameToNumber as r, voteTypeNameToNumber as s, transactionsStatusNumberToName as t, type TransactionType as u, voteTypeNumberToName as v, TransactionHashVariant as w };

package/dist/{index-C_GfhvDJ.d.cts → index-tixobC8m.d.cts}

@@ -80,6 +80,8 @@ declare const transactionsStatusNameToNumber: {
     VALIDATORS_TIMEOUT: string;
     LEADER_TIMEOUT: string;
 };
+declare const DECIDED_STATES: TransactionStatus[];
+declare function isDecidedState(status: string): boolean;
 declare const transactionResultNumberToName: {
     "0": TransactionResult;
     "1": TransactionResult;
@@ -402,4 +404,4 @@ type GenLayerClient<TGenLayerChain extends GenLayerChain> = Omit<Client<Transpor
     }) => Promise<any>;
 };
 
-export { type CalldataEncodable as C, type DecodedDeployData as D, type GenLayerClient as G, type Hash as H, type MethodDescription as M, type Network as N, type SnapSource as S, type TransactionDataElement as T, VoteType as V, type DecodedCallData as a, type GenLayerRawTransaction as b, type GenLayerTransaction as c, CalldataAddress as d, type GenLayerMethod as e, type ContractParamsArraySchemaElement as f, type ContractParamsSchema as g, type ContractMethodBase as h, type ContractMethod as i, type ContractSchema as j, type TransactionHash as k, TransactionStatus as l, TransactionResult as m, transactionsStatusNameToNumber as n, transactionResultNumberToName as o, TransactionResultNameToNumber as p, voteTypeNameToNumber as q, type TransactionType as r, TransactionHashVariant as s, transactionsStatusNumberToName as t, voteTypeNumberToName as v };
+export { type CalldataEncodable as C, type DecodedDeployData as D, type GenLayerClient as G, type Hash as H, type MethodDescription as M, type Network as N, type SnapSource as S, type TransactionDataElement as T, VoteType as V, type DecodedCallData as a, type GenLayerRawTransaction as b, type GenLayerTransaction as c, CalldataAddress as d, type GenLayerMethod as e, type ContractParamsArraySchemaElement as f, type ContractParamsSchema as g, type ContractMethodBase as h, type ContractMethod as i, type ContractSchema as j, type TransactionHash as k, TransactionStatus as l, TransactionResult as m, transactionsStatusNameToNumber as n, DECIDED_STATES as o, isDecidedState as p, transactionResultNumberToName as q, TransactionResultNameToNumber as r, voteTypeNameToNumber as s, transactionsStatusNumberToName as t, type TransactionType as u, voteTypeNumberToName as v, TransactionHashVariant as w };

package/dist/index.cjs

@@ -10,7 +10,8 @@ var _chunkZKBMABRAcjs = require('./chunk-ZKBMABRA.cjs');
 
 
 
-var _chunkH4ZYXVV2cjs = require('./chunk-H4ZYXVV2.cjs');
+
+var _chunkFPZNF3JHcjs = require('./chunk-FPZNF3JH.cjs');
 
 
 var _chunk75ZPJI57cjs = require('./chunk-75ZPJI57.cjs');
@@ -183,7 +184,7 @@ function encodeImpl(to, data) {
         }
       } else if (data instanceof Map) {
         encodeMap(to, data);
-      } else if (data instanceof _chunkH4ZYXVV2cjs.CalldataAddress) {
+      } else if (data instanceof _chunkFPZNF3JHcjs.CalldataAddress) {
         to.push(SPECIAL_ADDR);
         for (const c of data.bytes) {
           to.push(c);
@@ -258,7 +259,7 @@ function decodeImpl(data, index) {
     case BigInt(SPECIAL_ADDR): {
       const res = data.slice(index.i, index.i + 20);
       index.i += 20;
-      return new (0, _chunkH4ZYXVV2cjs.CalldataAddress)(res);
+      return new (0, _chunkFPZNF3JHcjs.CalldataAddress)(res);
     }
   }
   const type = Number(cur & 0xffn) & (1 << BITS_IN_TYPE) - 1;
@@ -370,7 +371,7 @@ function toStringImpl(data, to) {
         to.push("]");
       } else if (data instanceof Map) {
         toStringImplMap(data.entries(), to);
-      } else if (data instanceof _chunkH4ZYXVV2cjs.CalldataAddress) {
+      } else if (data instanceof _chunkFPZNF3JHcjs.CalldataAddress) {
         to.push("addr#");
         for (const c of data.bytes) {
           to.push(c.toString(16));
@@ -493,7 +494,7 @@ function _toJsonSafeDeep(value, seen) {
       }
       return obj;
     }
-    if (value instanceof _chunkH4ZYXVV2cjs.CalldataAddress) {
+    if (value instanceof _chunkFPZNF3JHcjs.CalldataAddress) {
       return _viem.toHex.call(void 0, value.bytes);
     }
     if (Object.getPrototypeOf(value) === Object.prototype) {
@@ -554,7 +555,7 @@ var contractActions = (client, publicClient) => {
       } = args;
       const encodedData = [encode(makeCalldataObject(functionName, callArgs, kwargs)), leaderOnly];
       const serializedData = serialize(encodedData);
-      const senderAddress = _nullishCoalesce(_optionalChain([account, 'optionalAccess', _5 => _5.address]), () => ( _optionalChain([client, 'access', _6 => _6.account, 'optionalAccess', _7 => _7.address])));
+      const senderAddress = _nullishCoalesce(_nullishCoalesce(_optionalChain([account, 'optionalAccess', _5 => _5.address]), () => ( _optionalChain([client, 'access', _6 => _6.account, 'optionalAccess', _7 => _7.address]))), () => ( _viem.zeroAddress));
       const requestParams = {
         type: "read",
         to: address,
@@ -589,7 +590,7 @@ var contractActions = (client, publicClient) => {
       } = args;
       const encodedData = [encode(makeCalldataObject(functionName, callArgs, kwargs)), leaderOnly];
       const serializedData = serialize(encodedData);
-      const senderAddress = _nullishCoalesce(_optionalChain([account, 'optionalAccess', _8 => _8.address]), () => ( _optionalChain([client, 'access', _9 => _9.account, 'optionalAccess', _10 => _10.address])));
+      const senderAddress = _nullishCoalesce(_nullishCoalesce(_optionalChain([account, 'optionalAccess', _8 => _8.address]), () => ( _optionalChain([client, 'access', _9 => _9.account, 'optionalAccess', _10 => _10.address]))), () => ( _viem.zeroAddress));
       const requestParams = {
         type: "write",
         to: address,
@@ -896,8 +897,8 @@ var decodeTransaction = (tx) => {
       processingBlock: tx.readStateBlockRange.processingBlock.toString(),
       proposalBlock: tx.readStateBlockRange.proposalBlock.toString()
     },
-    statusName: _chunkH4ZYXVV2cjs.transactionsStatusNumberToName[String(tx.status)],
-    resultName: _chunkH4ZYXVV2cjs.transactionResultNumberToName[String(tx.result)],
+    statusName: _chunkFPZNF3JHcjs.transactionsStatusNumberToName[String(tx.status)],
+    resultName: _chunkFPZNF3JHcjs.transactionResultNumberToName[String(tx.result)],
     lastRound: {
       ...tx.lastRound,
       round: tx.lastRound.round.toString(),
@@ -907,7 +908,7 @@ var decodeTransaction = (tx) => {
       appealBond: tx.lastRound.appealBond.toString(),
       rotationsLeft: tx.lastRound.rotationsLeft.toString(),
       validatorVotesName: tx.lastRound.validatorVotes.map(
-        (vote) => _chunkH4ZYXVV2cjs.voteTypeNumberToName[String(vote)]
+        (vote) => _chunkFPZNF3JHcjs.voteTypeNumberToName[String(vote)]
       )
     }
   };
@@ -1046,9 +1047,8 @@ var receiptActions = (client, publicClient) => ({
       throw new Error("Transaction not found");
     }
     const transactionStatusString = String(transaction.status);
-    const transactionStatusFinalized = _chunkH4ZYXVV2cjs.transactionsStatusNameToNumber["FINALIZED" /* FINALIZED */];
-    const requestedStatus = _chunkH4ZYXVV2cjs.transactionsStatusNameToNumber[status];
-    if (transactionStatusString === requestedStatus || status === "ACCEPTED" /* ACCEPTED */ && transactionStatusString === transactionStatusFinalized) {
+    const requestedStatus = _chunkFPZNF3JHcjs.transactionsStatusNameToNumber[status];
+    if (transactionStatusString === requestedStatus || status === "ACCEPTED" /* ACCEPTED */ && _chunkFPZNF3JHcjs.isDecidedState.call(void 0, transactionStatusString)) {
       let finalTransaction = transaction;
       if (client.chain.id === _chunkZKBMABRAcjs.localnet.id) {
         finalTransaction = decodeLocalnetTransaction(transaction);
@@ -1076,7 +1076,7 @@ var transactionActions = (client, publicClient) => ({
     if (client.chain.id === _chunkZKBMABRAcjs.localnet.id) {
       const transaction2 = await client.getTransaction({ hash });
       const localnetStatus = transaction2.status === "ACTIVATED" ? "PENDING" /* PENDING */ : transaction2.status;
-      transaction2.status = Number(_chunkH4ZYXVV2cjs.transactionsStatusNameToNumber[localnetStatus]);
+      transaction2.status = Number(_chunkFPZNF3JHcjs.transactionsStatusNameToNumber[localnetStatus]);
       transaction2.statusName = localnetStatus;
       return decodeLocalnetTransaction(transaction2);
     }

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-BYSCF33g.cjs';
-import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-C_GfhvDJ.cjs';
+import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-tixobC8m.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-BYSCF33g.js';
-import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-BJebZa37.js';
+import { G as GenLayerClient, D as DecodedDeployData, a as DecodedCallData, b as GenLayerRawTransaction, c as GenLayerTransaction, C as CalldataEncodable, T as TransactionDataElement } from './index-Rls_T310.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

@@ -6,11 +6,12 @@ import {
 } from "./chunk-GEN4SJ6K.js";
 import {
   CalldataAddress,
+  isDecidedState,
   transactionResultNumberToName,
   transactionsStatusNameToNumber,
   transactionsStatusNumberToName,
   voteTypeNumberToName
-} from "./chunk-GACCNOPJ.js";
+} from "./chunk-47QDX7IX.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";
@@ -554,7 +555,7 @@ var contractActions = (client, publicClient) => {
       } = args;
       const encodedData = [encode(makeCalldataObject(functionName, callArgs, kwargs)), leaderOnly];
       const serializedData = serialize(encodedData);
-      const senderAddress = account?.address ?? client.account?.address;
+      const senderAddress = account?.address ?? client.account?.address ?? zeroAddress;
       const requestParams = {
         type: "read",
         to: address,
@@ -589,7 +590,7 @@ var contractActions = (client, publicClient) => {
       } = args;
       const encodedData = [encode(makeCalldataObject(functionName, callArgs, kwargs)), leaderOnly];
       const serializedData = serialize(encodedData);
-      const senderAddress = account?.address ?? client.account?.address;
+      const senderAddress = account?.address ?? client.account?.address ?? zeroAddress;
       const requestParams = {
         type: "write",
         to: address,
@@ -1046,9 +1047,8 @@ var receiptActions = (client, publicClient) => ({
       throw new Error("Transaction not found");
     }
     const transactionStatusString = String(transaction.status);
-    const transactionStatusFinalized = transactionsStatusNameToNumber["FINALIZED" /* FINALIZED */];
     const requestedStatus = transactionsStatusNameToNumber[status];
-    if (transactionStatusString === requestedStatus || status === "ACCEPTED" /* ACCEPTED */ && transactionStatusString === transactionStatusFinalized) {
+    if (transactionStatusString === requestedStatus || status === "ACCEPTED" /* ACCEPTED */ && isDecidedState(transactionStatusString)) {
       let finalTransaction = transaction;
       if (client.chain.id === localnet.id) {
         finalTransaction = decodeLocalnetTransaction(transaction);

package/dist/types/index.cjs

@@ -10,7 +10,9 @@
 
 
 
-var _chunkH4ZYXVV2cjs = require('../chunk-H4ZYXVV2.cjs');
+
+
+var _chunkFPZNF3JHcjs = require('../chunk-FPZNF3JH.cjs');
 require('../chunk-75ZPJI57.cjs');
 
 
@@ -24,4 +26,6 @@ require('../chunk-75ZPJI57.cjs');
 
 
 
-exports.CalldataAddress = _chunkH4ZYXVV2cjs.CalldataAddress; exports.TransactionHashVariant = _chunkH4ZYXVV2cjs.TransactionHashVariant; exports.TransactionResult = _chunkH4ZYXVV2cjs.TransactionResult; exports.TransactionResultNameToNumber = _chunkH4ZYXVV2cjs.TransactionResultNameToNumber; exports.TransactionStatus = _chunkH4ZYXVV2cjs.TransactionStatus; exports.VoteType = _chunkH4ZYXVV2cjs.VoteType; exports.transactionResultNumberToName = _chunkH4ZYXVV2cjs.transactionResultNumberToName; exports.transactionsStatusNameToNumber = _chunkH4ZYXVV2cjs.transactionsStatusNameToNumber; exports.transactionsStatusNumberToName = _chunkH4ZYXVV2cjs.transactionsStatusNumberToName; exports.voteTypeNameToNumber = _chunkH4ZYXVV2cjs.voteTypeNameToNumber; exports.voteTypeNumberToName = _chunkH4ZYXVV2cjs.voteTypeNumberToName;
+
+
+exports.CalldataAddress = _chunkFPZNF3JHcjs.CalldataAddress; exports.DECIDED_STATES = _chunkFPZNF3JHcjs.DECIDED_STATES; exports.TransactionHashVariant = _chunkFPZNF3JHcjs.TransactionHashVariant; exports.TransactionResult = _chunkFPZNF3JHcjs.TransactionResult; exports.TransactionResultNameToNumber = _chunkFPZNF3JHcjs.TransactionResultNameToNumber; exports.TransactionStatus = _chunkFPZNF3JHcjs.TransactionStatus; exports.VoteType = _chunkFPZNF3JHcjs.VoteType; exports.isDecidedState = _chunkFPZNF3JHcjs.isDecidedState; exports.transactionResultNumberToName = _chunkFPZNF3JHcjs.transactionResultNumberToName; exports.transactionsStatusNameToNumber = _chunkFPZNF3JHcjs.transactionsStatusNameToNumber; exports.transactionsStatusNumberToName = _chunkFPZNF3JHcjs.transactionsStatusNumberToName; exports.voteTypeNameToNumber = _chunkFPZNF3JHcjs.voteTypeNameToNumber; exports.voteTypeNumberToName = _chunkFPZNF3JHcjs.voteTypeNumberToName;

package/dist/types/index.d.cts

@@ -1,3 +1,3 @@
 export { Account, Address } from 'viem';
-export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, s as TransactionHashVariant, m as TransactionResult, p as TransactionResultNameToNumber, l as TransactionStatus, r as TransactionType, V as VoteType, o as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, q as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-C_GfhvDJ.cjs';
+export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, o as DECIDED_STATES, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, w as TransactionHashVariant, m as TransactionResult, r as TransactionResultNameToNumber, l as TransactionStatus, u as TransactionType, V as VoteType, p as isDecidedState, q as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, s as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-tixobC8m.cjs';
 export { G as GenLayerChain } from '../chains-BYSCF33g.cjs';

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
 export { Account, Address } from 'viem';
-export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, s as TransactionHashVariant, m as TransactionResult, p as TransactionResultNameToNumber, l as TransactionStatus, r as TransactionType, V as VoteType, o as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, q as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-BJebZa37.js';
+export { d as CalldataAddress, C as CalldataEncodable, i as ContractMethod, h as ContractMethodBase, f as ContractParamsArraySchemaElement, g as ContractParamsSchema, j as ContractSchema, o as DECIDED_STATES, a as DecodedCallData, D as DecodedDeployData, G as GenLayerClient, e as GenLayerMethod, b as GenLayerRawTransaction, c as GenLayerTransaction, H as Hash, M as MethodDescription, N as Network, S as SnapSource, k as TransactionHash, w as TransactionHashVariant, m as TransactionResult, r as TransactionResultNameToNumber, l as TransactionStatus, u as TransactionType, V as VoteType, p as isDecidedState, q as transactionResultNumberToName, n as transactionsStatusNameToNumber, t as transactionsStatusNumberToName, s as voteTypeNameToNumber, v as voteTypeNumberToName } from '../index-Rls_T310.js';
 export { G as GenLayerChain } from '../chains-BYSCF33g.js';

package/dist/types/index.js

@@ -1,24 +1,28 @@
 import {
   CalldataAddress,
+  DECIDED_STATES,
   TransactionHashVariant,
   TransactionResult,
   TransactionResultNameToNumber,
   TransactionStatus,
   VoteType,
+  isDecidedState,
   transactionResultNumberToName,
   transactionsStatusNameToNumber,
   transactionsStatusNumberToName,
   voteTypeNameToNumber,
   voteTypeNumberToName
-} from "../chunk-GACCNOPJ.js";
+} from "../chunk-47QDX7IX.js";
 import "../chunk-MLKGABMK.js";
 export {
   CalldataAddress,
+  DECIDED_STATES,
   TransactionHashVariant,
   TransactionResult,
   TransactionResultNameToNumber,
   TransactionStatus,
   VoteType,
+  isDecidedState,
   transactionResultNumberToName,
   transactionsStatusNameToNumber,
   transactionsStatusNumberToName,

package/package.json

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

package/src/contracts/actions.ts

@@ -71,7 +71,7 @@ export const contractActions = (client: GenLayerClient<GenLayerChain>, publicCli
       const encodedData = [calldata.encode(calldata.makeCalldataObject(functionName, callArgs, kwargs)), leaderOnly];
       const serializedData = serialize(encodedData);
 
-      const senderAddress = account?.address ?? client.account?.address;
+      const senderAddress = account?.address ?? client.account?.address ?? zeroAddress;
 
       const requestParams = {
         type: "read",
@@ -120,7 +120,7 @@ export const contractActions = (client: GenLayerClient<GenLayerChain>, publicCli
       const encodedData = [calldata.encode(calldata.makeCalldataObject(functionName, callArgs, kwargs)), leaderOnly];
       const serializedData = serialize(encodedData);
 
-      const senderAddress = account?.address ?? client.account?.address;
+      const senderAddress = account?.address ?? client.account?.address ?? zeroAddress;
 
       const requestParams = {
         type: "write",

package/src/transactions/actions.ts

@@ -5,6 +5,7 @@ import {
   GenLayerTransaction,
   GenLayerRawTransaction,
   transactionsStatusNameToNumber,
+  isDecidedState,
 } from "../types/transactions";
 import {transactionsConfig} from "../config/transactions";
 import {sleep} from "../utils/async";
@@ -37,11 +38,10 @@ export const receiptActions = (client: GenLayerClient<GenLayerChain>, publicClie
       throw new Error("Transaction not found");
     }
     const transactionStatusString = String(transaction.status);
-    const transactionStatusFinalized = transactionsStatusNameToNumber[TransactionStatus.FINALIZED];
     const requestedStatus = transactionsStatusNameToNumber[status];
     if (
       transactionStatusString === requestedStatus ||
-      (status === TransactionStatus.ACCEPTED && transactionStatusString === transactionStatusFinalized)
+      (status === TransactionStatus.ACCEPTED && isDecidedState(transactionStatusString))
     ) {
       let finalTransaction = transaction;
       if (client.chain.id === localnet.id) {

package/src/types/transactions.ts

@@ -71,6 +71,21 @@ export const transactionsStatusNameToNumber = {
   [TransactionStatus.LEADER_TIMEOUT]: "13",
 };
 
+export const DECIDED_STATES = [
+  TransactionStatus.ACCEPTED,
+  TransactionStatus.UNDETERMINED,
+  TransactionStatus.LEADER_TIMEOUT,
+  TransactionStatus.VALIDATORS_TIMEOUT,
+  TransactionStatus.CANCELED,
+  TransactionStatus.FINALIZED
+];
+
+export function isDecidedState(status: string): boolean {
+  return DECIDED_STATES.some(state => 
+    transactionsStatusNameToNumber[state] === status
+  );
+}
+
 export const transactionResultNumberToName = {
   "0": TransactionResult.IDLE,
   "1": TransactionResult.AGREE,

package/tests/client.test.ts

@@ -5,6 +5,7 @@ import {Address} from "../src/types/accounts";
 import {createAccount, generatePrivateKey} from "../src/accounts/account";
 import {vi} from "vitest";
 import {TransactionHashVariant} from "../src/types/transactions";
+import {zeroAddress} from "viem";
 
 // Setup fetch mock
 const mockFetch = vi.fn();
@@ -168,4 +169,29 @@ describe("Client Overrides", () => {
       },
     ]);
   });
+
+  it("should use zero address when no account is provided anywhere", async () => {
+    const client = createClient({
+      chain: localnet,
+      // No account provided on client
+    });
+
+    const contractAddress = "0x1234567890123456789012345678901234567890";
+    await client.readContract({
+      // No account override either
+      address: contractAddress as Address,
+      functionName: "testFunction",
+      args: ["arg1", "arg2"],
+    });
+
+    expect(lastGenCallParams).toEqual([
+      {
+        type: "read",
+        to: contractAddress,
+        from: zeroAddress, // Should default to zero address
+        data: expect.any(String),
+        transaction_hash_variant: TransactionHashVariant.LATEST_NONFINAL,
+      },
+    ]);
+  });
 });

package/tests/transactions.test.ts

@@ -0,0 +1,142 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { TransactionStatus, DECIDED_STATES, isDecidedState } from "../src/types/transactions";
+import { receiptActions } from "../src/transactions/actions";
+import { localnet } from "../src/chains/localnet";
+
+const mockFetch = vi.fn();
+vi.stubGlobal("fetch", mockFetch);
+
+describe("DECIDED_STATES constant", () => {
+  it("should contain all expected decided states", () => {
+    const expectedStates = [
+      TransactionStatus.ACCEPTED,
+      TransactionStatus.UNDETERMINED,
+      TransactionStatus.LEADER_TIMEOUT,
+      TransactionStatus.VALIDATORS_TIMEOUT,
+      TransactionStatus.CANCELED,
+      TransactionStatus.FINALIZED
+    ];
+    
+    expect(DECIDED_STATES).toEqual(expectedStates);
+  });
+});
+
+describe("isDecidedState utility function", () => {
+  it("should return true for all decided states", () => {
+    const decidedStatusNumbers = ["5", "6", "13", "12", "8", "7"]; // ACCEPTED, UNDETERMINED, LEADER_TIMEOUT, VALIDATORS_TIMEOUT, CANCELED, FINALIZED
+    
+    decidedStatusNumbers.forEach(statusNum => {
+      expect(isDecidedState(statusNum)).toBe(true);
+    });
+  });
+
+  it("should return false for non-decided states", () => {
+    const nonDecidedStatusNumbers = ["0", "1", "2", "3", "4", "9", "10", "11"]; // UNINITIALIZED, PENDING, PROPOSING, COMMITTING, REVEALING, APPEAL_REVEALING, APPEAL_COMMITTING, READY_TO_FINALIZE
+    
+    nonDecidedStatusNumbers.forEach(statusNum => {
+      expect(isDecidedState(statusNum)).toBe(false);
+    });
+  });
+
+  it("should return false for invalid statuses", () => {
+    const invalidStatuses = ["999", "invalid", ""];
+    
+    invalidStatuses.forEach(status => {
+      expect(isDecidedState(status)).toBe(false);
+    });
+  });
+});
+
+describe("waitForTransactionReceipt with DECIDED_STATES", () => {
+  beforeEach(() => {
+    mockFetch.mockReset();
+  });
+
+  it("should accept all decided states when waiting for ACCEPTED", async () => {
+    const decidedStatusNumbers = ["5", "6", "13", "12", "8", "7"]; // All decided states
+    
+    for (const statusNum of decidedStatusNumbers) {
+      const mockTransaction = {
+        hash: "0x4b8037744adab7ea8335b4f839979d20031d83a8ccdf706e0ae61312930335f6",
+        status: statusNum,
+        from_address: "0x123",
+        to_address: "0x456",
+        value: "0",
+        gaslimit: "1000000",
+        nonce: "1",
+        created_at: "2023-01-01T00:00:00Z",
+      };
+
+      const mockClient = {
+        chain: localnet,
+        getTransaction: vi.fn().mockResolvedValue(mockTransaction)
+      };
+
+      const mockPublicClient = {} as any;
+
+      const actions = receiptActions(mockClient as any, mockPublicClient);
+      const result = await actions.waitForTransactionReceipt({
+        hash: "0x4b8037744adab7ea8335b4f839979d20031d83a8ccdf706e0ae61312930335f6" as any,
+        status: TransactionStatus.ACCEPTED,
+      });
+
+      expect(result).toEqual(mockTransaction);
+    }
+  });
+
+  it("should not affect waiting for specific non-ACCEPTED statuses", async () => {
+    const mockTransaction = {
+      hash: "0x4b8037744adab7ea8335b4f839979d20031d83a8ccdf706e0ae61312930335f6",
+      status: "7", // FINALIZED
+      from_address: "0x123",
+      to_address: "0x456",
+      value: "0",
+      gaslimit: "1000000",
+      nonce: "1",
+      created_at: "2023-01-01T00:00:00Z",
+    };
+
+    const mockClient = {
+      chain: localnet,
+      getTransaction: vi.fn().mockResolvedValue(mockTransaction)
+    };
+
+    const mockPublicClient = {} as any;
+
+    const actions = receiptActions(mockClient as any, mockPublicClient);
+    const result = await actions.waitForTransactionReceipt({
+      hash: "0x4b8037744adab7ea8335b4f839979d20031d83a8ccdf706e0ae61312930335f6" as any,
+      status: TransactionStatus.FINALIZED,
+    });
+
+    expect(result).toEqual(mockTransaction);
+  });
+
+  it("should maintain backward compatibility", async () => {
+    const mockTransaction = {
+      hash: "0x4b8037744adab7ea8335b4f839979d20031d83a8ccdf706e0ae61312930335f6",
+      status: "5", // ACCEPTED
+      from_address: "0x123",
+      to_address: "0x456",
+      value: "0",
+      gaslimit: "1000000",
+      nonce: "1",
+      created_at: "2023-01-01T00:00:00Z",
+    };
+
+    const mockClient = {
+      chain: localnet,
+      getTransaction: vi.fn().mockResolvedValue(mockTransaction)
+    };
+
+    const mockPublicClient = {} as any;
+
+    const actions = receiptActions(mockClient as any, mockPublicClient);
+    const result = await actions.waitForTransactionReceipt({
+      hash: "0x4b8037744adab7ea8335b4f839979d20031d83a8ccdf706e0ae61312930335f6" as any,
+      status: TransactionStatus.ACCEPTED,
+    });
+
+    expect(result).toEqual(mockTransaction);
+  });
+});