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

package/dist/{queryBuilder-n9ocnT4P.cjs → queryBuilder-DEkfSiCF.cjs}

@@ -82,8 +82,8 @@ function processPredicates(predicates) {
 	}).join(" && ");
 }
 async function processQuery(client, queryParams) {
-	const { predicates, limit, cursor, ownedBy, validAtBlock, withAttributes, withMetadata, withPayload } = queryParams;
-	console.debug(`Processing query with params: predicates: ${predicates}, cursor: ${cursor}, limit: ${limit}, ownedBy: ${ownedBy}, validAtBlock: ${validAtBlock}, withAttributes: ${withAttributes}, withMetadata: ${withMetadata}, withPayload: ${withPayload}`);
+	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}`);
 	let query = processPredicates(predicates);
 	if (ownedBy) query += ` && $owner=${ownedBy}`;
 	query = query.trim();
@@ -99,9 +99,11 @@ async function processQuery(client, queryParams) {
 	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({
 		includeData: queryOptions.includeData,
 		atBlock: queryOptions.atBlock?.toString(),
+		orderBy: queryOptions.orderBy,
 		resultsPerPage: queryOptions.resultsPerPage,
 		cursor: queryOptions.cursor
 	})}`);
@@ -155,6 +157,38 @@ var QueryResult = class {
 //#endregion
 //#region src/query/queryBuilder.ts
 /**
+* Helper function to create an ascending order by attribute
+* @param attributeName - The name of the attribute to order by
+* @param attributeType - The type of the attribute to order by (string or number)
+* @returns The OrderByAttribute instance
+*
+* @example
+* const ascAttribute = asc("name", "string")
+*/
+function asc(attributeName, attributeType) {
+	return {
+		name: attributeName,
+		type: attributeType,
+		order: "asc"
+	};
+}
+/**
+* Helper function to create a descending order by attribute
+* @param attributeName - The name of the attribute to order by
+* @param attributeType - The type of the attribute to order by (string or number)
+* @returns The OrderByAttribute instance
+*
+* @example
+* const descAttribute = desc("name", "string")
+*/
+function desc(attributeName, attributeType) {
+	return {
+		name: attributeName,
+		type: attributeType,
+		order: "desc"
+	};
+}
+/**
 * QueryBuilder is a helper class to build queries to the Arkiv DBChains.
 * It can be used to fetch entities from the Arkiv DBChains. It follows the Builder pattern allowing chaining of methods.
 * @param client - The Arkiv client
@@ -163,6 +197,7 @@ var QueryResult = class {
 var QueryBuilder = class {
 	_client;
 	_ownedBy;
+	_orderBy;
 	_validAtBlock;
 	_withAttributes;
 	_withMetadata;
@@ -187,6 +222,25 @@ var QueryBuilder = class {
 		this._ownedBy = ownedBy;
 		return this;
 	}
+	orderBy(attributeNameOrOrderByAttribute, attributeType, order = "asc") {
+		if (!this._orderBy) this._orderBy = [];
+		const pushOrderByAttribute = ({ name, type, order: order$1 }) => {
+			this._orderBy?.push({
+				name,
+				type: type === "number" ? "numeric" : type,
+				desc: order$1 === "desc"
+			});
+		};
+		if (typeof attributeNameOrOrderByAttribute === "string") {
+			if (!attributeType) throw new Error("attributeType is required when using positional orderBy arguments");
+			pushOrderByAttribute({
+				name: attributeNameOrOrderByAttribute,
+				type: attributeType,
+				order
+			});
+		} else pushOrderByAttribute(attributeNameOrOrderByAttribute);
+		return this;
+	}
 	/**
 	* Sets the withAttributes flag which will return the attributes for the entities if true
 	* @param withAttributes - The boolean value to set
@@ -303,6 +357,7 @@ var QueryBuilder = class {
 			limit: this._limit,
 			cursor: this._cursor,
 			ownedBy: this._ownedBy,
+			orderBy: this._orderBy,
 			validAtBlock: this._validAtBlock,
 			withAttributes: this._withAttributes,
 			withMetadata: this._withMetadata,
@@ -328,6 +383,7 @@ var QueryBuilder = class {
 			limit: this._limit,
 			cursor: this._cursor,
 			ownedBy: this._ownedBy,
+			orderBy: void 0,
 			validAtBlock: this._validAtBlock,
 			withAttributes: false,
 			withMetadata: false,
@@ -373,6 +429,18 @@ Object.defineProperty(exports, 'QueryResult', {
     return QueryResult;
   }
 });
+Object.defineProperty(exports, 'asc', {
+  enumerable: true,
+  get: function () {
+    return asc;
+  }
+});
+Object.defineProperty(exports, 'desc', {
+  enumerable: true,
+  get: function () {
+    return desc;
+  }
+});
 Object.defineProperty(exports, 'entityFromRpcResult', {
   enumerable: true,
   get: function () {

package/dist/{queryBuilder-Bm1zGqKA.d.cts → queryBuilder-Dc_ii8LH.d.cts}

@@ -1,4 +1,4 @@
-import { g as ArkivClient, t as Entity } from "./entity-OY78HYxA.cjs";
+import { g as ArkivClient, t as Entity } from "./entity-0JJeFAgO.cjs";
 import { Hex } from "viem";
 
 //#region src/query/predicate.d.ts
@@ -129,6 +129,31 @@ declare class QueryResult {
 }
 //#endregion
 //#region src/query/queryBuilder.d.ts
+type OrderByAttribute = {
+  name: string;
+  type: "string" | "number";
+  order: "asc" | "desc";
+};
+/**
+ * Helper function to create an ascending order by attribute
+ * @param attributeName - The name of the attribute to order by
+ * @param attributeType - The type of the attribute to order by (string or number)
+ * @returns The OrderByAttribute instance
+ *
+ * @example
+ * const ascAttribute = asc("name", "string")
+ */
+declare function asc(attributeName: string, attributeType: "string" | "number"): OrderByAttribute;
+/**
+ * Helper function to create a descending order by attribute
+ * @param attributeName - The name of the attribute to order by
+ * @param attributeType - The type of the attribute to order by (string or number)
+ * @returns The OrderByAttribute instance
+ *
+ * @example
+ * const descAttribute = desc("name", "string")
+ */
+declare function desc(attributeName: string, attributeType: "string" | "number"): OrderByAttribute;
 /**
  * QueryBuilder is a helper class to build queries to the Arkiv DBChains.
  * It can be used to fetch entities from the Arkiv DBChains. It follows the Builder pattern allowing chaining of methods.
@@ -138,6 +163,7 @@ declare class QueryResult {
 declare class QueryBuilder {
   private _client;
   private _ownedBy;
+  private _orderBy;
   private _validAtBlock;
   private _withAttributes;
   private _withMetadata;
@@ -156,6 +182,33 @@ declare class QueryBuilder {
    * builder.ownedBy("0x1234567890123456789012345678901234567890")
    */
   ownedBy(ownedBy: Hex): this;
+  /**
+   * Sets the orderBy for the query.
+   * It can be called multiple times to order by multiple attributes.
+   * The order of the attributes is important. The first attribute is the primary order by attribute.
+   * @param attributeName - The name of the attribute to order by
+   * @param attributeType - The type of the attribute to order by (string or number)
+   * @param order - The order to set the order by (asc or desc)
+   * @returns The QueryBuilder instance
+   *
+   * @example
+   * const builder = new QueryBuilder(client)
+   * builder.orderBy("name", "string", "desc")
+   */
+  orderBy(attributeName: string, attributeType: "string" | "number", order?: "asc" | "desc"): this;
+  /**
+   * Sets the orderBy for the query.
+   * This method takes the OrderByAttribute object as an argument and is mainly
+   * used to use the helper functions asc() and desc() to create the OrderByAttribute instances.
+   * @param orderByAttribute - The OrderByAttribute instance to set
+   * @returns The QueryBuilder instance
+   *
+   * @example
+   * const builder = new QueryBuilder(client)
+   * builder.orderBy(asc("name", "string"))
+   * builder.orderBy(desc("name", "string"))
+   */
+  orderBy(orderByAttribute: OrderByAttribute): this;
   /**
    * Sets the withAttributes flag which will return the attributes for the entities if true
    * @param withAttributes - The boolean value to set
@@ -257,5 +310,5 @@ declare class QueryBuilder {
   count(): Promise<1>;
 }
 //#endregion
-export { PredicateType as a, gt as c, lte as d, neq as f, PredicateContainerType as i, gte as l, or as m, QueryResult as n, and as o, not as p, Predicate as r, eq as s, QueryBuilder as t, lt as u };
-//# sourceMappingURL=queryBuilder-Bm1zGqKA.d.cts.map
+export { Predicate as a, and as c, gte as d, lt as f, or as g, not as h, QueryResult as i, eq as l, neq as m, asc as n, PredicateContainerType as o, lte as p, desc as r, PredicateType as s, QueryBuilder as t, gt as u };
+//# sourceMappingURL=queryBuilder-Dc_ii8LH.d.cts.map

package/dist/queryBuilder-Dc_ii8LH.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryBuilder-Dc_ii8LH.d.cts","names":[],"sources":["../src/query/predicate.ts","../src/query/queryResult.ts","../src/query/queryBuilder.ts"],"sourcesContent":[],"mappings":";;;;KAAY,aAAA;KACA,sBAAA;KAEA,SAAA;QAEA;EALA,GAAA,EAAA,MAAA;EACA,KAAA,EAAA,MAAA,GAAA,MAAA;AAEZ,CAAA,GAAY;EAEA,IAAA,EAKA,sBALA;EAKA,UAAA,EACM,SADN,EAAA;CACM;;AAclB;AAeA;AAcA;AAcA;AAcA;AAcA;AAcA;AAcA;AAaA;;iBAhHgB,EAAA,aAAe,cAAc;;ACrB7C;;;;;;;;;;ACIK,iBFgCW,GAAA,CEhCK,UAAA,EFgCW,SEhCX,EAAA,CAAA,EFgCyB,SEhCzB;AAerB;AAiBA;AAaA;;;;;;;;AAmPa,iBFlPG,EAAA,CEkPH,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA,GAAA,MAAA,CAAA,EFlP4C,SEkP5C;;;;;;;;;;;iBFpOG,GAAA,uCAA0C;;;;;;;;;;;iBAc1C,EAAA,uCAAyC;;;;;;;;;;;iBAczC,GAAA,uCAA0C;;;;;;;;;;;iBAc1C,EAAA,uCAAyC;;;;;;;;;;;iBAczC,GAAA,uCAA0C;;;;;;;;;;iBAa1C,GAAA,eAAkB;;;cCrIrB,WAAA;YACD;EDLA,QAAA,eAAa;EACb,QAAA,OAAA;EAEA,QAAA,MAAS;EAET,QAAA,aAAA;EAKA,QAAA,aAAA;EACM,IAAA,YAAA,CAAA,CAAA,ECEI,YDFJ;EAAS,IAAA,MAAA,CAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAcX,WAAE,CAAA,QAAa,ECHjB,MDG+B,EAAA,EAAA,YAAS,ECFpC,YDEoC,EAAA,MAAA,EAAA,MAAA,GAAA,SAAA,EAAA,KAAA,EAAA,MAAA,GAAA,SAAA,EAAA,YAAA,EAAA,MAAA,GAAA,SAAA;EAetC,IAAA,CAAA,CAAG,ECJP,ODIO,CAAA,IAAa,CAAA;EAchB,WAAE,CAAA,CAAA,EAAA,OAAuC;AAczD;;;AApEA,KEQK,gBAAA,GFRoB;EACb,IAAA,EAAA,MAAA;EAEA,IAAA,EAAA,QAAS,GAAA,QAAA;EAET,KAAA,EAAA,KAAA,GAAA,MAAA;CAKA;;;AAeZ;AAeA;AAcA;AAcA;AAcA;AAcA;AAcA;AAcgB,iBErGA,GAAA,CFqG0C,aAAS,EAAA,MAAA,EAAA,aAAA,EAAA,QAAA,GAAA,QAAA,CAAA,EErGa,gBFqGb;AAanE;;;;ACrIA;;;;;AAgCY,iBCII,IAAA,CDJJ,aAAA,EAAA,MAAA,EAAA,aAAA,EAAA,QAAA,GAAA,QAAA,CAAA,ECIqE,gBDJrE;;;;;AC9B+B;AAiB3C;AAiBgB,cAaH,YAAA,CAboE;EAapE,QAAA,OAAY;EAYH,QAAA,QAAA;EAcH,QAAA,QAAA;EA+BS,QAAA,aAAA;EAuIR,QAAA,eAAA;EAAc,QAAA,aAAA;EAmBrB,QAAA,YAAA;EAAA,QAAA,MAAA;EAgCA,QAAA,OAAA;EAAA,QAAA,WAAA;sBAvOS;;;;;;;;;;mBAcH;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA+BS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAuIR,cAAc;;;;;;;;;;;WAmBrB,QAAA;;;;;;;;;;WAgCA"}

package/dist/types/index.cjs

@@ -0,0 +1 @@
+require('../types-CBTc19th.cjs');

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-OY78HYxA.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-0JJeFAgO.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-o4fwHXKf.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-BG8YycYJ.js";
 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.js

@@ -0,0 +1 @@
+import "../types-Cv8NMtbo.js";

package/dist/utils/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/expirationTime.ts","../../src/utils/payload.ts"],"sourcesContent":[],"mappings":";;;cAEa;;;EAAA,SAAA,EAAA,CAAA,KAUZ,EAAA,MAAA,EAAA,GADkB,MAAI;;;;ECTP,SAAA,EAAA,CAAA,KAAa,EAAA,MAAA,EAAgB,GAAA,MAAA;EAI7B,UAAA,EAAA,CAAA,MAAe,EAAA,MAAA,EAAgB,GAAA,MAAA;mBDK5B;;;;iBCTH,aAAA,gBAA6B;iBAI7B,eAAA,gBAA+B"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/expirationTime.ts","../../src/utils/payload.ts"],"sourcesContent":[],"mappings":";;;cAEa;;;EAAA,SAAA,EAAA,CAAA,KAUZ,EAAA,MAAA,EAAA,GADkB,MAAI;;;;ECTP,SAAA,EAAA,CAAA,KAAa,EAAA,MAAA,EAAA,GAAgB,MAAA;EAI7B,UAAA,EAAA,CAAA,MAAe,EAAA,MAAA,EAAA,GAAgB,MAAA;mBDK5B;;;;iBCTH,aAAA,gBAA6B;iBAI7B,eAAA,gBAA+B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkiv-network/sdk",
-  "version": "0.3.2-dev.0",
+  "version": "0.3.2-dev.2",
   "description": "TypeScript client library for Arkiv's blockchains interactions",
   "type": "module",
   "target": "esnext",

package/src/clients/createPublicClient.ts

@@ -25,9 +25,9 @@ export type PublicArkivClient<
 /**
  * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).
  *
- * - Docs: https://docs.golemdb.io/ts-sdk/clients/public
+ * - Docs: https://docs.arkiv.network/ts-sdk/clients/public
  *
- * A Public Client is an interface to "public" [Ethereum JSON-RPC API](https://ethereum.org/en/developers/docs/apis/json-rpc/), [Arkiv JSON-RPC API](https://docs.golemdb.io/json-rpc/), and [Kaolin JSON-RPC API](https://kaolin.holesky.golemdb.io/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).
+ * A Public Client is an interface to "public" [Ethereum JSON-RPC API](https://ethereum.org/en/developers/docs/apis/json-rpc/), [Arkiv JSON-RPC API](https://docs.arkiv.network/json-rpc/), and [Kaolin JSON-RPC API](https://kaolin.holesky.arkiv.network/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).
  *
  * @param config - {@link PublicClientConfig}
  * @returns A Arkiv Public Client. {@link PublicArkivClient}

package/src/clients/createWalletClient.ts

@@ -25,9 +25,9 @@ export type WalletArkivClient<
 /**
  * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).
  *
- * - Docs: https://docs.golemdb.io/ts-sdk/clients/public
+ * - Docs: https://docs.arkiv.network/ts-sdk/clients/public
  *
- * A Public Client is an interface to "public" [Ethereum JSON-RPC API](https://ethereum.org/en/developers/docs/apis/json-rpc/), [Arkiv JSON-RPC API](https://docs.golemdb.io/json-rpc/), and [Kaolin JSON-RPC API](https://kaolin.holesky.golemdb.io/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).
+ * A Public Client is an interface to "public" [Ethereum JSON-RPC API](https://ethereum.org/en/developers/docs/apis/json-rpc/), [Arkiv JSON-RPC API](https://docs.arkiv.network/json-rpc/), and [Kaolin JSON-RPC API](https://kaolin.holesky.arkiv.network/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).
  *
  * @param config - {@link PublicClientConfig}
  * @returns A Arkiv Public Client. {@link PublicArkivClient}

package/src/clients/decorators/arkivPublic.ts

@@ -34,7 +34,7 @@ export type PublicArkivActions<
   /**
    * Returns the entity with the given key.
    *
-   * - Docs: https://docs.golemdb.io/ts-sdk/actions/public/getEntity
+   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/getEntity
    *
    * @param args - {entityKey}
    * @returns The entity with the given key. {@link Entity}
@@ -59,7 +59,7 @@ export type PublicArkivActions<
    * Returns a QueryBuilder instance for building and executing queries.
    * The QueryBuilder object follows the Builder pattern, allowing you to chain methods to build a query and then execute it.
    *
-   * - Docs: https://docs.golemdb.io/ts-sdk/actions/public/query
+   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/query
    *
    * @returns A QueryBuilder instance for building and executing queries. {@link QueryBuilder}
    *

package/src/clients/decorators/arkivWallet.ts

@@ -49,7 +49,8 @@ export type WalletArkivActions<
     /**
      * Returns the entity with the given key.
      *
-     * - Docs: https://docs.golemdb.io/ts-sdk/actions/public/getEntity
+     * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/getEntity
+     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)
      *
      * @param args - {entityKey}
      * @returns The entity with the given key. {@link Entity}
@@ -82,8 +83,8 @@ export type WalletArkivActions<
     /**
      * Updates the entity with the given key.
      *
-     * - Docs: https://docs.golemdb.io/ts-sdk/actions/wallet/updateEntity
-     * - JSON-RPC Methods: [`golembase_updateEntity`](https://docs.golemdb.io/dev/json-rpc-api/#golembase_updateEntity)
+     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/updateEntity
+     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)
      *
      * @param args - {entityKey, data}
      * @returns The entity with the given key. {@link Entity}
@@ -105,8 +106,8 @@ export type WalletArkivActions<
     /**
      * Deletes the entity with the given key.
      *
-     * - Docs: https://docs.golemdb.io/ts-sdk/actions/wallet/deleteEntity
-     * - JSON-RPC Methods: [`golembase_deleteEntity`](https://docs.golemdb.io/dev/json-rpc-api/#golembase_deleteEntity)
+     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/deleteEntity
+     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)
      *
      * @param args - {entityKey}
      * @returns The entity with the given key. {@link Entity}
@@ -135,8 +136,8 @@ export type WalletArkivActions<
     /**
      * Extends the entity with the given key.
      *
-     * - Docs: https://docs.golemdb.io/ts-sdk/actions/wallet/extendEntity
-     * - JSON-RPC Methods: [`golembase_extendEntity`](https://docs.golemdb.io/dev/json-rpc-api/#golembase_extendEntity)
+     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/extendEntity
+     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)
      *
      * @param args - {entityKey, data}
      * @returns The entity with the given key. {@link Entity}
@@ -167,8 +168,8 @@ export type WalletArkivActions<
     /**
      * Changes the ownership of the entity with the given address.
      *
-     * - Docs: https://docs.golemdb.io/ts-sdk/actions/wallet/changeOwnership
-     * - JSON-RPC Methods: [`golembase_ownershipChange`](https://docs.golemdb.io/dev/json-rpc-api/#golembase_ownershipChange)
+     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/changeOwnership
+     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)
      *
      * @param args - {entityKey, newOwner}
      * @returns The entity with the given address. {@link Entity}
@@ -181,8 +182,8 @@ export type WalletArkivActions<
     /**
      * Mutates the entities with the given keys.
      *
-     * - Docs: https://docs.golemdb.io/ts-sdk/actions/wallet/mutateEntities
-     * - JSON-RPC Methods: [`golembase_mutateEntities`](https://docs.golemdb.io/dev/json-rpc-api/#golembase_mutateEntities)
+     * - 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)
      *
      * @param args - {data}
      * @returns The entity with the given key. {@link Entity}

package/src/index.ts

@@ -1,15 +1,5 @@
-// Re-export commonly used viem types for convenience
-export type {
-  Account,
-  Address,
-  Chain,
-  Hex,
-  PublicClientConfig,
-  RpcSchema,
-  Transport,
-} from "viem"
-
-export { http, toBytes, toHex, toRlp, webSocket } from "viem"
+// Re-export all viem stuff
+export * from "viem"
 
 // export main arkiv stuff
 export type { ArkivClient } from "./clients/baseClient"
@@ -19,25 +9,4 @@ export type { WalletArkivClient } from "./clients/createWalletClient"
 export { createWalletClient } from "./clients/createWalletClient"
 
 // re-export arkiv types in main index file
-export type {
-  ArkivRpcSchema,
-  Attribute,
-  ChangeOwnershipParameters,
-  ChangeOwnershipReturnType,
-  CreateEntityParameters,
-  CreateEntityReturnType,
-  DeleteEntityParameters,
-  DeleteEntityReturnType,
-  Entity,
-  ExtendEntityParameters,
-  ExtendEntityReturnType,
-  MimeType,
-  MutateEntitiesParameters,
-  MutateEntitiesReturnType,
-  RpcEntity,
-  RpcIncludeData,
-  RpcQueryOptions,
-  TxParams,
-  UpdateEntityParameters,
-  UpdateEntityReturnType,
-} from "./types"
+export * from "./types"

package/src/query/engine.test.ts

@@ -15,6 +15,7 @@ describe("processQuery tests", () => {
       limit: undefined,
       cursor: undefined,
       ownedBy: undefined,
+      orderBy: undefined,
       validAtBlock: undefined,
       withAttributes: undefined,
       withMetadata: undefined,
@@ -53,6 +54,7 @@ describe("processQuery tests", () => {
       limit: undefined,
       cursor: undefined,
       ownedBy: undefined,
+      orderBy: undefined,
       validAtBlock: undefined,
       withAttributes: undefined,
       withMetadata: undefined,
@@ -92,6 +94,7 @@ describe("processQuery tests", () => {
       limit: undefined,
       cursor: undefined,
       ownedBy: undefined,
+      orderBy: undefined,
       validAtBlock: undefined,
       withAttributes: undefined,
       withMetadata: undefined,
@@ -131,6 +134,7 @@ describe("processQuery tests", () => {
       limit: undefined,
       cursor: undefined,
       ownedBy: undefined,
+      orderBy: undefined,
       validAtBlock: undefined,
       withAttributes: undefined,
       withMetadata: undefined,
@@ -176,6 +180,7 @@ describe("processQuery tests", () => {
       limit: undefined,
       cursor: undefined,
       ownedBy: undefined,
+      orderBy: undefined,
       validAtBlock: undefined,
       withAttributes: undefined,
       withMetadata: undefined,
@@ -203,6 +208,7 @@ describe("processQuery tests", () => {
     const predicates = [{ type: "eq" as const, key: "key", value: "value" }]
     await processQuery(client, {
       predicates,
+      orderBy: undefined,
       limit: undefined,
       cursor: undefined,
       ownedBy: "0x123",
@@ -232,6 +238,7 @@ describe("processQuery tests", () => {
       predicates,
       limit: undefined,
       cursor: undefined,
+      orderBy: undefined,
       validAtBlock: undefined,
       withAttributes: undefined,
       withMetadata: undefined,
@@ -256,12 +263,74 @@ describe("processQuery tests", () => {
     })
   })
 
+  it("should process simple predicates with orderBy", async () => {
+    const predicates = [{ type: "eq" as const, key: "key", value: "value" }]
+    await processQuery(client, {
+      predicates,
+      orderBy: [{ name: "key", type: "string", desc: true }],
+      limit: undefined,
+      cursor: undefined,
+      ownedBy: undefined,
+    })
+
+    expect(client.request).lastCalledWith({
+      method: "arkiv_query",
+      params: [
+        `key = "value"`,
+        {
+          orderBy: [{ name: "key", type: "string", desc: true }],
+          includeData: {
+            key: true,
+            attributes: false,
+            contentType: false,
+            payload: false,
+            expiration: false,
+            owner: false,
+          },
+        },
+      ],
+    })
+  })
+
+  it("should process only orderBy", async () => {
+    const predicates = [] as Predicate[]
+    await processQuery(client, {
+      predicates,
+      limit: undefined,
+      cursor: undefined,
+      ownedBy: undefined,
+      orderBy: [{ name: "key", type: "string", desc: true }],
+      validAtBlock: undefined,
+      withAttributes: undefined,
+      withMetadata: undefined,
+    })
+
+    expect(client.request).lastCalledWith({
+      method: "arkiv_query",
+      params: [
+        "",
+        {
+          orderBy: [{ name: "key", type: "string", desc: true }],
+          includeData: {
+            key: true,
+            attributes: false,
+            contentType: false,
+            payload: false,
+            expiration: false,
+            owner: false,
+          },
+        },
+      ],
+    })
+  })
+
   it("should process simple predicate with validAtBlock and paging", async () => {
     const predicates = [{ type: "eq" as const, key: "key", value: "value" }]
     await processQuery(client, {
       predicates,
       limit: 10,
       cursor: undefined,
+      orderBy: undefined,
       validAtBlock: 123n,
       ownedBy: "0x123",
     })

package/src/query/engine.ts

@@ -1,6 +1,6 @@
 import type { Hex } from "viem"
 import type { ArkivClient } from "../clients/baseClient"
-import type { RpcQueryOptions } from "../types/rpcSchema"
+import type { RpcOrderByAttribute, RpcQueryOptions } from "../types/rpcSchema"
 import type { Predicate } from "./predicate"
 
 function processPredicates(predicates: Predicate[]): string {
@@ -45,6 +45,7 @@ export async function processQuery(
     limit: number | undefined
     cursor: string | undefined
     ownedBy: Hex | undefined
+    orderBy: RpcOrderByAttribute[] | undefined
     validAtBlock?: bigint | undefined
     withAttributes?: boolean | undefined
     withMetadata?: boolean | undefined
@@ -56,6 +57,7 @@ export async function processQuery(
     limit,
     cursor,
     ownedBy,
+    orderBy,
     validAtBlock,
     withAttributes,
     withMetadata,
@@ -63,7 +65,7 @@ export async function processQuery(
   } = queryParams
 
   console.debug(
-    `Processing query with params: predicates: ${predicates}, cursor: ${cursor}, limit: ${limit}, ownedBy: ${ownedBy}, validAtBlock: ${validAtBlock}, withAttributes: ${withAttributes}, withMetadata: ${withMetadata}, withPayload: ${withPayload}`,
+    `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}`,
   )
 
   let query = processPredicates(predicates)
@@ -97,9 +99,12 @@ export async function processQuery(
   if (cursor !== undefined) {
     queryOptions.cursor = cursor
   }
+  if (orderBy !== undefined) {
+    queryOptions.orderBy = orderBy
+  }
 
   console.debug(
-    `Built query to send: ${query}, queryOptions: ${JSON.stringify({ includeData: queryOptions.includeData, atBlock: queryOptions.atBlock?.toString(), resultsPerPage: queryOptions.resultsPerPage, cursor: queryOptions.cursor })}`,
+    `Built query to send: ${query}, queryOptions: ${JSON.stringify({ includeData: queryOptions.includeData, atBlock: queryOptions.atBlock?.toString(), orderBy: queryOptions.orderBy, resultsPerPage: queryOptions.resultsPerPage, cursor: queryOptions.cursor })}`,
   )
 
   const result = await client.request({