@arkiv-network/sdk 0.3.2-dev.2 → 0.3.2-dev.4

package/dist/{queryBuilder-CAQ7TDMZ.js → queryBuilder-DVs4ZIyZ.js}

@@ -1,5 +1,11 @@
 import { bytesToString, toBytes } from "viem";
+import createDebug from "debug";
 
+//#region src/utils/logger.ts
+const ROOT_NAMESPACE = "arkiv";
+const getLogger = (scope) => createDebug(`${ROOT_NAMESPACE}:${scope}`);
+
+//#endregion
 //#region src/query/errors.ts
 var NoMoreResultsError = class extends Error {
 	constructor() {
@@ -26,31 +32,41 @@ var NoEntityFoundError = class extends Error {
 //#region src/types/entity.ts
 var Entity = class {
 	key;
+	contentType;
 	owner;
 	expiresAtBlock;
+	createdAtBlock;
+	lastModifiedAtBlock;
+	transactionIndexInBlock;
+	operationIndexInTransaction;
 	payload;
 	attributes;
-	contentType;
-	constructor(key, contentType, owner, expiresAtBlock, payload, attributes) {
+	constructor(key, contentType = void 0, owner = void 0, expiresAtBlock = void 0, createdAtBlock = void 0, lastModifiedAtBlock = void 0, transactionIndexInBlock = void 0, operationIndexInTransaction = void 0, payload = void 0, attributes) {
 		this.key = key;
 		this.owner = owner;
 		this.expiresAtBlock = expiresAtBlock;
+		this.createdAtBlock = createdAtBlock;
+		this.lastModifiedAtBlock = lastModifiedAtBlock;
+		this.transactionIndexInBlock = transactionIndexInBlock;
+		this.operationIndexInTransaction = operationIndexInTransaction;
 		this.payload = payload;
 		this.attributes = attributes;
 		this.contentType = contentType;
 	}
 	toText() {
-		return bytesToString(this.payload);
+		return this.payload ? bytesToString(this.payload) : "";
 	}
 	toJson() {
-		return JSON.parse(bytesToString(this.payload));
+		return this.payload ? JSON.parse(bytesToString(this.payload)) : {};
 	}
 };
 
 //#endregion
 //#region src/utils/entities.ts
+const logger$2 = getLogger("utils:entities");
 async function entityFromRpcResult(rpcEntity) {
-	return new Entity(rpcEntity.key, rpcEntity.contentType, rpcEntity.owner, rpcEntity.expiresAt, toBytes(rpcEntity.value), [...(rpcEntity.stringAttributes ?? []).map(({ key, value }) => ({
+	logger$2("entityFromRpcResult %o", rpcEntity);
+	return new Entity(rpcEntity.key, rpcEntity.contentType, rpcEntity.owner, rpcEntity.expiresAt !== void 0 ? BigInt(rpcEntity.expiresAt) : void 0, rpcEntity.createdAtBlock !== void 0 ? BigInt(rpcEntity.createdAtBlock) : void 0, rpcEntity.lastModifiedAtBlock !== void 0 ? BigInt(rpcEntity.lastModifiedAtBlock) : void 0, rpcEntity.transactionIndexInBlock !== void 0 ? BigInt(rpcEntity.transactionIndexInBlock) : void 0, rpcEntity.operationIndexInTransaction !== void 0 ? BigInt(rpcEntity.operationIndexInTransaction) : void 0, rpcEntity.value !== void 0 ? toBytes(rpcEntity.value) : void 0, [...(rpcEntity.stringAttributes ?? []).map(({ key, value }) => ({
 		key,
 		value
 	})), ...(rpcEntity.numericAttributes ?? []).map(({ key, value }) => ({
@@ -61,6 +77,7 @@ async function entityFromRpcResult(rpcEntity) {
 
 //#endregion
 //#region src/query/engine.ts
+const logger$1 = getLogger("query:engine");
 function processPredicates(predicates) {
 	const processValue = (value) => {
 		if (typeof value === "string") return `"${value}"`;
@@ -83,7 +100,17 @@ function processPredicates(predicates) {
 }
 async function processQuery(client, queryParams) {
 	const { predicates, limit, cursor, ownedBy, orderBy, validAtBlock, withAttributes, withMetadata, withPayload } = queryParams;
-	console.debug(`Processing query with params: predicates: ${JSON.stringify(predicates)}, cursor: ${cursor}, limit: ${limit}, ownedBy: ${ownedBy}, orderBy: ${JSON.stringify(orderBy)}, validAtBlock: ${validAtBlock}, withAttributes: ${withAttributes}, withMetadata: ${withMetadata}, withPayload: ${withPayload}`);
+	logger$1("Processing query with params %o", {
+		predicates,
+		cursor,
+		limit,
+		ownedBy,
+		orderBy,
+		validAtBlock,
+		withAttributes,
+		withMetadata,
+		withPayload
+	});
 	let query = processPredicates(predicates);
 	if (ownedBy) query += ` && $owner=${ownedBy}`;
 	query = query.trim();
@@ -94,29 +121,34 @@ async function processQuery(client, queryParams) {
 		payload: withPayload ?? false,
 		contentType: withMetadata ?? false,
 		expiration: withMetadata ?? false,
-		owner: withMetadata ?? false
+		owner: withMetadata ?? false,
+		createdAtBlock: withMetadata ?? false,
+		lastModifiedAtBlock: withMetadata ?? false,
+		transactionIndexInBlock: withMetadata ?? false,
+		operationIndexInTransaction: withMetadata ?? false
 	} };
 	if (validAtBlock !== void 0) queryOptions.atBlock = Number(validAtBlock);
 	if (limit !== void 0) queryOptions.resultsPerPage = limit;
 	if (cursor !== void 0) queryOptions.cursor = cursor;
 	if (orderBy !== void 0) queryOptions.orderBy = orderBy;
-	console.debug(`Built query to send: ${query}, queryOptions: ${JSON.stringify({
+	logger$1("Built query to send %s %o", query, {
 		includeData: queryOptions.includeData,
 		atBlock: queryOptions.atBlock?.toString(),
 		orderBy: queryOptions.orderBy,
 		resultsPerPage: queryOptions.resultsPerPage,
 		cursor: queryOptions.cursor
-	})}`);
+	});
 	const result = await client.request({
 		method: "arkiv_query",
 		params: [query, queryOptions]
 	});
-	console.debug("Raw result from query: ", result);
+	logger$1("Raw result from query %o", result);
 	return result;
 }
 
 //#endregion
 //#region src/query/queryResult.ts
+const logger = getLogger("query:result");
 var QueryResult = class {
 	entities;
 	_endOfIteration;
@@ -147,7 +179,7 @@ var QueryResult = class {
 		this._queryBuilder = result.queryBuilder;
 		this._endOfIteration = !result.cursor || result.entities.length < this._limit;
 		this._cursor = result.cursor;
-		console.debug("Current block height for next page: ", this._validAtBlock);
+		logger("Current block height for next page %s", this._validAtBlock?.toString() ?? "unknown");
 	}
 	hasNextPage() {
 		return !this._endOfIteration;
@@ -393,5 +425,5 @@ var QueryBuilder = class {
 };
 
 //#endregion
-export { entityFromRpcResult as a, NoMoreResultsError as c, QueryResult as i, OffsetCannotBeLessThanZeroError as l, asc as n, NoCursorOrLimitError as o, desc as r, NoEntityFoundError as s, QueryBuilder as t };
-//# sourceMappingURL=queryBuilder-CAQ7TDMZ.js.map
+export { entityFromRpcResult as a, NoMoreResultsError as c, QueryResult as i, OffsetCannotBeLessThanZeroError as l, asc as n, NoCursorOrLimitError as o, desc as r, NoEntityFoundError as s, QueryBuilder as t, getLogger as u };
+//# sourceMappingURL=queryBuilder-DVs4ZIyZ.js.map

package/dist/queryBuilder-DVs4ZIyZ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryBuilder-DVs4ZIyZ.js","names":["logger","logger","predicate","queryOptions: RpcQueryOptions","order"],"sources":["../src/utils/logger.ts","../src/query/errors.ts","../src/types/entity.ts","../src/utils/entities.ts","../src/query/engine.ts","../src/query/queryResult.ts","../src/query/queryBuilder.ts"],"sourcesContent":["import createDebug from \"debug\"\n\nconst ROOT_NAMESPACE = \"arkiv\"\n\nexport const getLogger = (scope: string) => createDebug(`${ROOT_NAMESPACE}:${scope}`)\n\nexport const enableDebug = (namespaces: string): void => {\n  createDebug.enable(namespaces)\n}\n\nexport const disableDebug = (): void => {\n  createDebug.disable()\n}\n","export class NoMoreResultsError extends Error {\n  constructor() {\n    super(\"No more results\")\n  }\n}\n\nexport class NoCursorOrLimitError extends Error {\n  constructor() {\n    super(\"Cursor and limit must be defined to fetch next\")\n  }\n}\n\nexport class OffsetCannotBeLessThanZeroError extends Error {\n  constructor() {\n    super(\"Offset cannot be less than 0\")\n  }\n}\n\nexport class NoEntityFoundError extends Error {\n  constructor() {\n    super(\"No entity found\")\n  }\n}\n","import { bytesToString, type Hex } from \"viem\"\nimport type { MimeType } from \"../types\"\nimport type { Attribute } from \"./attributes\"\n\nexport class Entity {\n  key: Hex\n  contentType: MimeType | undefined\n  owner: Hex | undefined\n  expiresAtBlock: bigint | undefined\n  createdAtBlock: bigint | undefined\n  lastModifiedAtBlock: bigint | undefined\n  transactionIndexInBlock: bigint | undefined\n  operationIndexInTransaction: bigint | undefined\n  payload: Uint8Array | undefined\n  attributes: Attribute[]\n\n  constructor(\n    key: Hex,\n    contentType: MimeType | undefined = undefined,\n    owner: Hex | undefined = undefined,\n    expiresAtBlock: bigint | undefined = undefined,\n    createdAtBlock: bigint | undefined = undefined,\n    lastModifiedAtBlock: bigint | undefined = undefined,\n    transactionIndexInBlock: bigint | undefined = undefined,\n    operationIndexInTransaction: bigint | undefined = undefined,\n    payload: Uint8Array | undefined = undefined,\n    attributes: Attribute[],\n  ) {\n    this.key = key\n    this.owner = owner\n    this.expiresAtBlock = expiresAtBlock\n    this.createdAtBlock = createdAtBlock\n    this.lastModifiedAtBlock = lastModifiedAtBlock\n    this.transactionIndexInBlock = transactionIndexInBlock\n    this.operationIndexInTransaction = operationIndexInTransaction\n    this.payload = payload\n    this.attributes = attributes\n    this.contentType = contentType\n  }\n\n  toText(): string {\n    return this.payload ? bytesToString(this.payload) : \"\"\n  }\n\n  toJson(): any {\n    return this.payload ? JSON.parse(bytesToString(this.payload)) : {}\n  }\n}\n","import { toBytes } from \"viem\"\nimport { Entity } from \"../types/entity\"\nimport type { RpcEntity } from \"../types/rpcSchema\"\nimport { getLogger } from \"./logger\"\n\nconst logger = getLogger(\"utils:entities\")\n\nexport async function entityFromRpcResult(rpcEntity: RpcEntity) {\n  logger(\"entityFromRpcResult %o\", rpcEntity)\n\n  return new Entity(\n    rpcEntity.key,\n    rpcEntity.contentType,\n    rpcEntity.owner,\n    rpcEntity.expiresAt !== undefined ? BigInt(rpcEntity.expiresAt) : undefined,\n    rpcEntity.createdAtBlock !== undefined ? BigInt(rpcEntity.createdAtBlock) : undefined,\n    rpcEntity.lastModifiedAtBlock !== undefined ? BigInt(rpcEntity.lastModifiedAtBlock) : undefined,\n    rpcEntity.transactionIndexInBlock !== undefined\n      ? BigInt(rpcEntity.transactionIndexInBlock)\n      : undefined,\n    rpcEntity.operationIndexInTransaction !== undefined\n      ? BigInt(rpcEntity.operationIndexInTransaction)\n      : undefined,\n    rpcEntity.value !== undefined ? toBytes(rpcEntity.value) : undefined,\n    [\n      ...(rpcEntity.stringAttributes ?? []).map(({ key, value }) => ({\n        key,\n        value,\n      })),\n      ...(rpcEntity.numericAttributes ?? []).map(({ key, value }) => ({\n        key,\n        value: Number(value),\n      })),\n    ],\n  )\n}\n","import type { Hex } from \"viem\"\nimport type { ArkivClient } from \"../clients/baseClient\"\nimport type { RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions } from \"../types/rpcSchema\"\nimport { getLogger } from \"../utils/logger\"\nimport type { Predicate } from \"./predicate\"\n\nconst logger = getLogger(\"query:engine\")\n\nfunction processPredicates(predicates: Predicate[]): string {\n  const processValue = (value: string | number) => {\n    if (typeof value === \"string\") {\n      return `\"${value}\"`\n    }\n    return value\n  }\n  return predicates\n    .map((predicate) => {\n      switch (predicate.type) {\n        case \"eq\":\n          return `${predicate.key} = ${processValue(predicate.value)}`\n        case \"neq\":\n          return `${predicate.key} != ${processValue(predicate.value)}`\n        case \"gt\":\n          return `${predicate.key} > ${processValue(predicate.value)}`\n        case \"gte\":\n          return `${predicate.key} >= ${processValue(predicate.value)}`\n        case \"lt\":\n          return `${predicate.key} < ${processValue(predicate.value)}`\n        case \"lte\":\n          return `${predicate.key} <= ${processValue(predicate.value)}`\n        case \"not\":\n          return `!${predicate.key}`\n        case \"or\":\n          return `(${predicate.predicates.map((predicate) => processPredicates([predicate])).join(\" || \")})`\n        case \"and\":\n          return `(${predicate.predicates.map((predicate) => processPredicates([predicate])).join(\" && \")})`\n        default:\n          return \"\"\n      }\n    })\n    .join(\" && \")\n}\n\nexport async function processQuery(\n  client: ArkivClient,\n  queryParams: {\n    predicates: Predicate[]\n    limit: number | undefined\n    cursor: string | undefined\n    ownedBy: Hex | undefined\n    orderBy: RpcOrderByAttribute[] | undefined\n    validAtBlock?: bigint | undefined\n    withAttributes?: boolean | undefined\n    withMetadata?: boolean | undefined\n    withPayload?: boolean | undefined\n  },\n) {\n  const {\n    predicates,\n    limit,\n    cursor,\n    ownedBy,\n    orderBy,\n    validAtBlock,\n    withAttributes,\n    withMetadata,\n    withPayload,\n  } = queryParams\n\n  logger(\"Processing query with params %o\", {\n    predicates,\n    cursor,\n    limit,\n    ownedBy,\n    orderBy,\n    validAtBlock,\n    withAttributes,\n    withMetadata,\n    withPayload,\n  })\n\n  let query = processPredicates(predicates)\n  if (ownedBy) {\n    query += ` && $owner=${ownedBy}`\n  }\n\n  // remove leading and trailing spaces and leading &&\n  query = query.trim()\n  if (query.startsWith(\"&& \")) {\n    query = query.slice(3)\n  }\n\n  const queryOptions: RpcQueryOptions = {\n    includeData: {\n      key: true,\n      attributes: withAttributes ?? false,\n      payload: withPayload ?? false,\n      contentType: withMetadata ?? false,\n      expiration: withMetadata ?? false,\n      owner: withMetadata ?? false,\n      createdAtBlock: withMetadata ?? false,\n      lastModifiedAtBlock: withMetadata ?? false,\n      transactionIndexInBlock: withMetadata ?? false,\n      operationIndexInTransaction: withMetadata ?? false,\n    } as RpcIncludeData,\n  }\n\n  if (validAtBlock !== undefined) {\n    queryOptions.atBlock = Number(validAtBlock)\n  }\n  if (limit !== undefined) {\n    queryOptions.resultsPerPage = limit\n  }\n  if (cursor !== undefined) {\n    queryOptions.cursor = cursor\n  }\n  if (orderBy !== undefined) {\n    queryOptions.orderBy = orderBy\n  }\n\n  logger(\"Built query to send %s %o\", query, {\n    includeData: queryOptions.includeData,\n    atBlock: queryOptions.atBlock?.toString(),\n    orderBy: queryOptions.orderBy,\n    resultsPerPage: queryOptions.resultsPerPage,\n    cursor: queryOptions.cursor,\n  })\n\n  const result = await client.request({\n    method: \"arkiv_query\",\n    params: [query, queryOptions],\n  })\n  logger(\"Raw result from query %o\", result)\n\n  return result\n}\n","import type { Entity } from \"../types/entity\"\nimport { getLogger } from \"../utils/logger\"\nimport { NoCursorOrLimitError, NoMoreResultsError } from \"./errors\"\nimport type { QueryBuilder } from \"./queryBuilder\"\n\nconst logger = getLogger(\"query:result\")\n\nexport class QueryResult {\n  entities: Entity[]\n  private _endOfIteration: boolean\n  private _cursor: string | undefined\n  private _limit: number | undefined\n  private _validAtBlock: bigint | undefined\n  private _queryBuilder: QueryBuilder\n\n  // Public getters for internal state\n  get queryBuilder(): QueryBuilder {\n    return this._queryBuilder\n  }\n\n  get cursor(): string | undefined {\n    return this._cursor\n  }\n\n  constructor(\n    entities: Entity[],\n    queryBuilder: QueryBuilder,\n    cursor: string | undefined,\n    limit: number | undefined,\n    validAtBlock: bigint | undefined,\n  ) {\n    this.entities = entities\n    this._queryBuilder = queryBuilder\n    this._endOfIteration = !limit || entities.length < limit\n    this._cursor = cursor\n    this._limit = limit\n    this._validAtBlock = validAtBlock\n  }\n\n  async next() {\n    if (this._cursor === undefined || this._limit === undefined) {\n      throw new NoCursorOrLimitError()\n    }\n    if (this._endOfIteration) {\n      throw new NoMoreResultsError()\n    }\n    this._queryBuilder.cursor(this._cursor)\n    const result = await this._queryBuilder.fetch()\n    this.entities = result.entities\n    // Update the query builder reference\n    this._queryBuilder = result.queryBuilder\n    // Check if we've reached the end (no more cursor or we got fewer entities than limit)\n    this._endOfIteration = !result.cursor || result.entities.length < this._limit\n    // Update the cursor\n    this._cursor = result.cursor\n\n    // TODO check current block height and if it is not too old\n    logger(\"Current block height for next page %s\", this._validAtBlock?.toString() ?? \"unknown\")\n  }\n\n  hasNextPage() {\n    return !this._endOfIteration\n  }\n}\n","import type { Hex } from \"viem\"\nimport type { ArkivClient } from \"../clients/baseClient\"\nimport type { RpcOrderByAttribute } from \"../types/rpcSchema\"\nimport { entityFromRpcResult } from \"../utils/entities\"\nimport { processQuery } from \"./engine\"\nimport type { Predicate } from \"./predicate\"\nimport { QueryResult } from \"./queryResult\"\n\ntype OrderByAttribute = {\n  name: string\n  type: \"string\" | \"number\"\n  order: \"asc\" | \"desc\"\n}\n\n/**\n * Helper function to create an ascending order by attribute\n * @param attributeName - The name of the attribute to order by\n * @param attributeType - The type of the attribute to order by (string or number)\n * @returns The OrderByAttribute instance\n *\n * @example\n * const ascAttribute = asc(\"name\", \"string\")\n */\nexport function asc(attributeName: string, attributeType: \"string\" | \"number\"): OrderByAttribute {\n  return {\n    name: attributeName,\n    type: attributeType,\n    order: \"asc\",\n  }\n}\n\n/**\n * Helper function to create a descending order by attribute\n * @param attributeName - The name of the attribute to order by\n * @param attributeType - The type of the attribute to order by (string or number)\n * @returns The OrderByAttribute instance\n *\n * @example\n * const descAttribute = desc(\"name\", \"string\")\n */\nexport function desc(attributeName: string, attributeType: \"string\" | \"number\"): OrderByAttribute {\n  return {\n    name: attributeName,\n    type: attributeType,\n    order: \"desc\",\n  }\n}\n/**\n * QueryBuilder is a helper class to build queries to the Arkiv DBChains.\n * It can be used to fetch entities from the Arkiv DBChains. It follows the Builder pattern allowing chaining of methods.\n * @param client - The Arkiv client\n * @returns The QueryBuilder instance {@link QueryBuilder}\n */\nexport class QueryBuilder {\n  private _client: ArkivClient\n  private _ownedBy: Hex | undefined\n  private _orderBy: RpcOrderByAttribute[] | undefined\n  private _validAtBlock: bigint | undefined\n  private _withAttributes: boolean | undefined\n  private _withMetadata: boolean | undefined\n  private _withPayload: boolean | undefined\n  private _limit: number | undefined\n  private _cursor: string | undefined\n  private _predicates: Predicate[]\n\n  constructor(client: ArkivClient) {\n    this._client = client\n    this._predicates = []\n  }\n\n  /**\n   * Sets the ownedBy filter\n   * @param ownedBy - The address of the owner\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.ownedBy(\"0x1234567890123456789012345678901234567890\")\n   */\n  ownedBy(ownedBy: Hex) {\n    this._ownedBy = ownedBy\n    return this\n  }\n\n  /**\n   * Sets the orderBy for the query.\n   * It can be called multiple times to order by multiple attributes.\n   * The order of the attributes is important. The first attribute is the primary order by attribute.\n   * @param attributeName - The name of the attribute to order by\n   * @param attributeType - The type of the attribute to order by (string or number)\n   * @param order - The order to set the order by (asc or desc)\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.orderBy(\"name\", \"string\", \"desc\")\n   */\n  orderBy(attributeName: string, attributeType: \"string\" | \"number\", order?: \"asc\" | \"desc\"): this\n  /**\n   * Sets the orderBy for the query.\n   * This method takes the OrderByAttribute object as an argument and is mainly\n   * used to use the helper functions asc() and desc() to create the OrderByAttribute instances.\n   * @param orderByAttribute - The OrderByAttribute instance to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.orderBy(asc(\"name\", \"string\"))\n   * builder.orderBy(desc(\"name\", \"string\"))\n   */\n  orderBy(orderByAttribute: OrderByAttribute): this\n  orderBy(\n    attributeNameOrOrderByAttribute: string | OrderByAttribute,\n    attributeType?: \"string\" | \"number\",\n    order: \"asc\" | \"desc\" = \"asc\",\n  ) {\n    if (!this._orderBy) {\n      this._orderBy = []\n    }\n\n    const pushOrderByAttribute = ({ name, type, order }: OrderByAttribute) => {\n      this._orderBy?.push({\n        name,\n        type: type === \"number\" ? \"numeric\" : type,\n        desc: order === \"desc\",\n      })\n    }\n\n    if (typeof attributeNameOrOrderByAttribute === \"string\") {\n      if (!attributeType) {\n        throw new Error(\"attributeType is required when using positional orderBy arguments\")\n      }\n      pushOrderByAttribute({\n        name: attributeNameOrOrderByAttribute,\n        type: attributeType,\n        order,\n      })\n    } else {\n      pushOrderByAttribute(attributeNameOrOrderByAttribute)\n    }\n\n    return this\n  }\n\n  /**\n   * Sets the withAttributes flag which will return the attributes for the entities if true\n   * @param withAttributes - The boolean value to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.withAttributes(true)\n   */\n  withAttributes(withAttributes: boolean = true) {\n    this._withAttributes = withAttributes\n    return this\n  }\n\n  /**\n   * Sets the withMetadata flag which will return the metadata (like owner, expiredAt, etc.) for the entities if true\n   * @param withMetadata - The boolean value to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.withMetadata(true)\n   */\n  withMetadata(withMetadata: boolean = true) {\n    this._withMetadata = withMetadata\n    return this\n  }\n\n  /**\n   * Sets the withPayload flag which will return the payload for the entities if true\n   * @param withPayload - The boolean value to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.withPayload(true)\n   */\n  withPayload(withPayload: boolean = true) {\n    this._withPayload = withPayload\n    return this\n  }\n\n  /**\n   * Sets the limit for the query\n   * @param limit - The number of entities to return\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.limit(10)\n   */\n  limit(limit: number) {\n    this._limit = limit\n    return this\n  }\n\n  /**\n   * Sets the cursor for the query - it is advances setting which rather shouldn't be used manually but it is provided from query result if limit is used (pagination).\n   * @param cursor - The cursor to set which tells to RPC Query server where to start or continue the query.\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.offset(10)\n   */\n  cursor(cursor: string) {\n    this._cursor = cursor\n    return this\n  }\n\n  /**\n   * Sets the validAtBlock for the query which tells at which block height the state we are intested.\n   * If not set, the latest block is  used.\n   * @param validAtBlock - The block number to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.validAtBlock(10000)\n   */\n  validAtBlock(validAtBlock: bigint) {\n    this._validAtBlock = validAtBlock\n    return this\n  }\n\n  /**\n   * Sets the predicates for the query limiting the results. It can be a single predicate or an array of predicates combined with 'and'.\n   * Predicates can be nested using 'or' and 'and' predicates.\n   * @param predicates - The predicates to set\n   * @returns The QueryBuilder instance\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * builder.where(eq(\"name\", \"John\"))\n   * builder.where([eq(\"name\", \"John\"), eq(\"age\", 30)])\n   * builder.where([eq(\"name\", \"John\"), or([eq(\"age\", 30), eq(\"age\", 31)])])\n   * builder.where([eq(\"name\", \"John\"), and([eq(\"age\", 30), eq(\"age\", 31)])])\n   * builder.where([eq(\"name\", \"John\"), or([eq(\"age\", 30), and([eq(\"age\", 31), eq(\"age\", 32)])])])\n   * builder.where([eq(\"name\", \"John\"), and([eq(\"age\", 30), or([eq(\"age\", 31), eq(\"age\", 32)])])])\n   * builder.where([eq(\"name\", \"John\"), and([eq(\"age\", 30), or([eq(\"age\", 31), and([eq(\"age\", 32), eq(\"age\", 33)])])])])\n   */\n  where(predicates: Predicate[] | Predicate) {\n    if (Array.isArray(predicates)) {\n      this._predicates.push(...predicates)\n    } else {\n      this._predicates.push(predicates)\n    }\n    return this\n  }\n\n  /**\n   * Fetches the entities from the query. Re\n   * It will return a QueryResult instance which can be used to fetch the next and previous pages.\n   * @returns The QueryResult instance {@link QueryResult}\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * const result = await builder.where(eq(\"name\", \"John\")).fetch()\n   * // result = { entities: [Entity, Entity, Entity], next: async () => QueryResult, previous: async () => QueryResult }\n   */\n  async fetch() {\n    const queryResult = await processQuery(this._client, {\n      predicates: this._predicates,\n      limit: this._limit,\n      cursor: this._cursor,\n      ownedBy: this._ownedBy,\n      orderBy: this._orderBy,\n      validAtBlock: this._validAtBlock,\n      withAttributes: this._withAttributes,\n      withMetadata: this._withMetadata,\n      withPayload: this._withPayload,\n    })\n\n    const entities = await Promise.all(\n      queryResult.data.map((entity) => entityFromRpcResult(entity)),\n    )\n\n    this.cursor(queryResult.cursor)\n    this.validAtBlock(queryResult.blockNumber)\n\n    return new QueryResult(entities, this, this._cursor, this._limit, this._validAtBlock)\n  }\n\n  /**\n   * Counts the entities from the query.\n   * @returns The number of entities\n   *\n   * @example\n   * const builder = new QueryBuilder(client)\n   * const result = await builder.where(eq(\"name\", \"John\")).count()\n   * // result = 10\n   */\n  async count() {\n    const queryResult = await processQuery(this._client, {\n      predicates: this._predicates,\n      limit: this._limit,\n      cursor: this._cursor,\n      ownedBy: this._ownedBy,\n      orderBy: undefined,\n      validAtBlock: this._validAtBlock,\n      withAttributes: false,\n      withMetadata: false,\n      withPayload: false,\n    })\n\n    return queryResult.data.length ?? 0\n  }\n}\n"],"mappings":"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"}

package/dist/types/index.d.cts

@@ -1,2 +1,2 @@
-import { _ as ArkivRpcSchema, a as MutateEntitiesReturnType, b as RpcQueryOptions, c as ExtendEntityParameters, d as DeleteEntityReturnType, f as CreateEntityParameters, h as ChangeOwnershipReturnType, i as MutateEntitiesParameters, l as ExtendEntityReturnType, m as ChangeOwnershipParameters, n as TxParams, o as UpdateEntityParameters, p as CreateEntityReturnType, r as Attribute, s as UpdateEntityReturnType, t as Entity, u as DeleteEntityParameters, v as RpcEntity, x as MimeType, y as RpcIncludeData } from "../entity-0JJeFAgO.cjs";
+import { _ as ArkivRpcSchema, a as MutateEntitiesReturnType, b as RpcQueryOptions, c as ExtendEntityParameters, d as DeleteEntityReturnType, f as CreateEntityParameters, h as ChangeOwnershipReturnType, i as MutateEntitiesParameters, l as ExtendEntityReturnType, m as ChangeOwnershipParameters, n as TxParams, o as UpdateEntityParameters, p as CreateEntityReturnType, r as Attribute, s as UpdateEntityReturnType, t as Entity, u as DeleteEntityParameters, v as RpcEntity, x as MimeType, y as RpcIncludeData } from "../entity-Bsvmepwv.cjs";
 export { ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, ExtendEntityParameters, ExtendEntityReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, RpcEntity, RpcIncludeData, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType };

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-import { _ as ArkivRpcSchema, a as MutateEntitiesReturnType, b as RpcQueryOptions, c as ExtendEntityParameters, d as DeleteEntityReturnType, f as CreateEntityParameters, h as ChangeOwnershipReturnType, i as MutateEntitiesParameters, l as ExtendEntityReturnType, m as ChangeOwnershipParameters, n as TxParams, o as UpdateEntityParameters, p as CreateEntityReturnType, r as Attribute, s as UpdateEntityReturnType, t as Entity, u as DeleteEntityParameters, v as RpcEntity, x as MimeType, y as RpcIncludeData } from "../entity-BG8YycYJ.js";
+import { _ as ArkivRpcSchema, a as MutateEntitiesReturnType, b as RpcQueryOptions, c as ExtendEntityParameters, d as DeleteEntityReturnType, f as CreateEntityParameters, h as ChangeOwnershipReturnType, i as MutateEntitiesParameters, l as ExtendEntityReturnType, m as ChangeOwnershipParameters, n as TxParams, o as UpdateEntityParameters, p as CreateEntityReturnType, r as Attribute, s as UpdateEntityReturnType, t as Entity, u as DeleteEntityParameters, v as RpcEntity, x as MimeType, y as RpcIncludeData } from "../entity-ChTOBhd6.js";
 export { ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, ExtendEntityParameters, ExtendEntityReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, RpcEntity, RpcIncludeData, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType };

package/dist/utils/index.cjs

@@ -1,3 +1,4 @@
+const require_queryBuilder = require('../queryBuilder-Cn5JJRMM.cjs');
 const require_consts = require('../consts-BV9DVKgE.cjs');
 let viem = require("viem");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkiv-network/sdk",
-  "version": "0.3.2-dev.2",
+  "version": "0.3.2-dev.4",
   "description": "TypeScript client library for Arkiv's blockchains interactions",
   "type": "module",
   "target": "esnext",
@@ -84,6 +84,7 @@
     "publish-dev:dry": "npm publish ./arkiv-network-sdk-latest.tgz --access public --tag dev --dry-run"
   },
   "devDependencies": {
+    "@types/debug": "^4.1.12",
     "@biomejs/biome": "2.2.4",
     "@types/bun": "latest",
     "rimraf": "^6.0.1",
@@ -116,6 +117,7 @@
   "homepage": "https://arkiv.network",
   "dependencies": {
     "brotli-wasm": "^3.0.1",
-    "viem": "^2.38.2"
+    "viem": "^2.38.2",
+    "debug": "^4.3.7"
   }
 }

package/src/actions/public/getBlockTiming.ts

@@ -1,4 +1,7 @@
 import type { ArkivClient } from "../../clients/baseClient"
+import { getLogger } from "../../utils/logger"
+
+const logger = getLogger("actions:public:get-block-timing")
 
 export type GetBlockTimingReturnType = {
   currentBlock: bigint
@@ -11,7 +14,7 @@ export async function getBlockTiming(client: ArkivClient) {
     method: "arkiv_getBlockTiming",
     params: [],
   })
-  console.debug("Block timing", blockTiming)
+  logger("Block timing %o", blockTiming)
   return {
     currentBlock: blockTiming.current_block,
     currentBlockTime: blockTiming.current_block_time,

package/src/actions/public/getEntity.ts

@@ -1,14 +1,29 @@
-import type { Hex } from "viem"
+import { bytesToHex, type Hex, hexToBytes } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import { NoEntityFoundError } from "../../query/errors"
 import { entityFromRpcResult } from "../../utils/entities"
 
 export async function getEntity(client: ArkivClient, key: Hex) {
+  // Normalize the key into bytes
+  let bytes: Uint8Array
+  try {
+    bytes = hexToBytes(key)
+  } catch {
+    throw new Error(`Invalid key format: ${key}. Key must be a valid hex string.`)
+  }
+
+  if (bytes.length !== 32) {
+    throw new Error(
+      `Invalid key length: ${bytes.length} bytes. Key must be 32 bytes (64 hex characters) long.`,
+    )
+  }
+
+  const hexKey = bytesToHex(bytes)
+
   const result = await client.request({
     method: "arkiv_query",
-    params: [`$key = ${key}`],
+    params: [`$key = ${hexKey}`],
   })
-  console.debug("GetEntity result", result)
 
   if (!result.data) {
     throw new NoEntityFoundError()

package/src/actions/public/subscribeEntityEvents.ts

@@ -9,6 +9,9 @@ import type {
   OnEntityOwnerChangedEvent,
   OnEntityUpdatedEvent,
 } from "../../types/events"
+import { getLogger } from "../../utils/logger"
+
+const logger = getLogger("actions:public:subscribe-entity-events")
 
 export const arkivABI = parseAbi([
   "event ArkivEntityCreated(uint256 indexed entityKey, address indexed ownerAddress, uint256 expirationBlock, uint256 cost)",
@@ -46,14 +49,14 @@ export async function subscribeEntityEvents(
     fromBlock: fromBlock ?? 0n,
     events: arkivABI,
     onLogs: (logs) => {
-      console.debug("logs from subscribeEntityEvents", logs)
+      logger("logs from subscribeEntityEvents %o", logs)
       for (const log of logs) {
         const event = decodeEventLog({
           abi: arkivABI,
-          topics: log.topics,
+          topics: log.topics as [string, string, string] | [string, string, string, string],
           data: log.data,
         })
-        console.debug("event from subscribeEntityEvents", event)
+        logger("event from subscribeEntityEvents %o", event)
         switch (event.eventName) {
           case "ArkivEntityCreated":
             onEntityCreated?.({

package/src/actions/wallet/changeOwnership.ts

@@ -2,6 +2,9 @@ import type { Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { TxParams } from "../../types"
 import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { getLogger } from "../../utils/logger"
+
+const logger = getLogger("actions:wallet:change-ownership")
 
 /**
  * Parameters for the deleteEntity function.
@@ -27,11 +30,11 @@ export async function changeOwnership(
   data: ChangeOwnershipParameters,
   txParams?: TxParams,
 ): Promise<ChangeOwnershipReturnType> {
-  console.debug("changeOwnership", data)
+  logger("changeOwnership %o", data)
   const txData = opsToTxData({ ownershipChanges: [data] })
   const receipt = await sendArkivTransaction(client, txData, txParams)
 
-  console.debug("Receipt from changeOwnership", receipt)
+  logger("Receipt from changeOwnership %o", receipt)
 
   return {
     txHash: receipt.transactionHash,

package/src/actions/wallet/createEntity.ts

@@ -1,7 +1,10 @@
-import type { Hex } from "viem"
+import type { Hash, Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { Attribute, MimeType, TxParams } from "../../types"
 import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { getLogger } from "../../utils/logger"
+
+const logger = getLogger("actions:wallet:create-entity")
 
 /**
  * Parameters for the createEntity function.
@@ -24,7 +27,7 @@ export type CreateEntityParameters = {
  */
 export type CreateEntityReturnType = {
   entityKey: Hex
-  txHash: string
+  txHash: Hash
 }
 
 export async function createEntity(
@@ -32,14 +35,14 @@ export async function createEntity(
   data: CreateEntityParameters,
   txParams?: TxParams,
 ): Promise<CreateEntityReturnType> {
-  console.debug("createEntity", data)
+  logger("createEntity %o", data)
   const txData = opsToTxData({ creates: [data] })
   const receipt = await sendArkivTransaction(client, txData, txParams)
 
-  console.debug("Receipt from createEntity", receipt)
+  logger("Receipt from createEntity %o", receipt)
 
   return {
-    txHash: receipt.transactionHash,
+    txHash: receipt.transactionHash as Hash,
     entityKey: receipt.logs[0].topics[1] as Hex,
   }
 }

package/src/actions/wallet/deleteEntity.ts

@@ -1,7 +1,10 @@
-import type { Hex } from "viem"
+import type { Hash, Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { TxParams } from "../../types"
 import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { getLogger } from "../../utils/logger"
+
+const logger = getLogger("actions:wallet:delete-entity")
 
 /**
  * Parameters for the deleteEntity function.
@@ -18,7 +21,7 @@ export type DeleteEntityParameters = {
  */
 export type DeleteEntityReturnType = {
   entityKey: Hex
-  txHash: string
+  txHash: Hash
 }
 
 export async function deleteEntity(
@@ -26,14 +29,14 @@ export async function deleteEntity(
   data: DeleteEntityParameters,
   txParams?: TxParams,
 ): Promise<DeleteEntityReturnType> {
-  console.debug("deleteEntity", data)
+  logger("deleteEntity %o", data)
   const txData = opsToTxData({ deletes: [data] })
   const receipt = await sendArkivTransaction(client, txData, txParams)
 
-  console.debug("Receipt from deleteEntity", receipt)
+  logger("Receipt from deleteEntity %o", receipt)
 
   return {
-    txHash: receipt.transactionHash,
+    txHash: receipt.transactionHash as Hash,
     entityKey: data.entityKey,
   }
 }

package/src/actions/wallet/extendEntity.ts

@@ -1,7 +1,10 @@
-import type { Hex } from "viem"
+import type { Hash, Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { TxParams } from "../../types"
 import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { getLogger } from "../../utils/logger"
+
+const logger = getLogger("actions:wallet:extend-entity")
 
 /**
  * Parameters for the extendEntity function.
@@ -20,7 +23,7 @@ export type ExtendEntityParameters = {
  */
 export type ExtendEntityReturnType = {
   entityKey: Hex
-  txHash: string
+  txHash: Hash
 }
 
 export async function extendEntity(
@@ -28,14 +31,14 @@ export async function extendEntity(
   data: ExtendEntityParameters,
   txParams?: TxParams,
 ): Promise<ExtendEntityReturnType> {
-  console.debug("extendEntity", data)
+  logger("extendEntity %o", data)
   const txData = opsToTxData({ extensions: [data] })
   const receipt = await sendArkivTransaction(client, txData, txParams)
 
-  console.debug("Receipt from extendEntity", receipt)
+  logger("Receipt from extendEntity %o", receipt)
 
   return {
-    txHash: receipt.transactionHash,
+    txHash: receipt.transactionHash as Hash,
     entityKey: receipt.logs[0].topics[1] as Hex,
   }
 }

package/src/actions/wallet/mutateEntities.ts

@@ -1,8 +1,12 @@
-import type { Hex, TransactionReceipt } from "viem"
+import type { Hash, Hex, TransactionReceipt } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { TxParams } from "../../types"
 import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { getLogger } from "../../utils/logger"
 import type { ChangeOwnershipParameters } from "./changeOwnership"
+
+const logger = getLogger("actions:wallet:mutate-entities")
+
 import type { CreateEntityParameters } from "./createEntity"
 import type { DeleteEntityParameters } from "./deleteEntity"
 import type { ExtendEntityParameters } from "./extendEntity"
@@ -68,7 +72,7 @@ function parseReceipt(receipt: TransactionReceipt, params: MutateEntitiesParamet
  * - ownershipChanges: The keys of the ownership changes.
  */
 export type MutateEntitiesReturnType = {
-  txHash: string
+  txHash: Hash
   createdEntities: Hex[]
   updatedEntities: Hex[]
   deletedEntities: Hex[]
@@ -94,12 +98,12 @@ export async function mutateEntities(
 
   const receipt = await sendArkivTransaction(client, txData, txParams)
 
-  console.debug("Receipt from mutateEntities", receipt)
+  logger("Receipt from mutateEntities %o", receipt)
 
   const { createdEntities, updatedEntities, deletedEntities, extendedEntities, ownershipChanges } =
     parseReceipt(receipt, data)
   return {
-    txHash: receipt.transactionHash,
+    txHash: receipt.transactionHash as Hash,
     createdEntities,
     updatedEntities,
     deletedEntities,

package/src/actions/wallet/updateEntity.ts

@@ -1,7 +1,10 @@
-import type { Hex } from "viem"
+import type { Hash, Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { Attribute, MimeType, TxParams } from "../../types"
 import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { getLogger } from "../../utils/logger"
+
+const logger = getLogger("actions:wallet:update-entity")
 
 /**
  * Parameters for the updateEntity function.
@@ -26,7 +29,7 @@ export type UpdateEntityParameters = {
  */
 export type UpdateEntityReturnType = {
   entityKey: Hex
-  txHash: string
+  txHash: Hash
 }
 
 export async function updateEntity(
@@ -34,14 +37,14 @@ export async function updateEntity(
   data: UpdateEntityParameters,
   txParams?: TxParams,
 ): Promise<UpdateEntityReturnType> {
-  console.debug("updateEntity", data)
+  logger("updateEntity %o", data)
   const txData = opsToTxData({ updates: [data] })
   const receipt = await sendArkivTransaction(client, txData, txParams)
 
-  console.debug("Receipt from updateEntity", receipt)
+  logger("Receipt from updateEntity %o", receipt)
 
   return {
-    txHash: receipt.transactionHash,
+    txHash: receipt.transactionHash as Hash,
     entityKey: receipt.logs[0].topics[1] as Hex,
   }
 }

package/src/clients/decorators/arkivWallet.ts

@@ -183,7 +183,7 @@ export type WalletArkivActions<
      * Mutates the entities with the given keys.
      *
      * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/mutateEntities
-     * - JSON-RPC Methods: [`golembase_mutateEntities`](https://docs.arkiv.network/dev/json-rpc-api/#golembase_mutateEntities)
+     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)
      *
      * @param args - {data}
      * @returns The entity with the given key. {@link Entity}