@arkiv-network/sdk 0.6.8 → 0.7.0-dev.1

package/dist/types/index.cjs

@@ -1 +1,4 @@
-require('../types-o3zWarRp.cjs');
+const require_entity = require('../entity-BhSXaB23.cjs');
+require('../types-a8gm_IaQ.cjs');
+
+exports.EntityOperationType = require_entity.EntityOperationType;

package/dist/types/index.d.cts

@@ -1,2 +1,2 @@
-import { A as RpcIncludeData, C as CreateEntityReturnType, E as GetBlockTimingReturnType, M as RpcQueryOptions, N as MimeType, O as ArkivRpcSchema, S as CreateEntityParameters, T as ChangeOwnershipReturnType, _ as UpdateEntityReturnType, a as Entity, b as DeleteEntityParameters, c as OnEntityDeletedEvent, d as OnEntityOwnerChangedEvent, f as OnEntityUpdatedEvent, g as UpdateEntityParameters, h as MutateEntitiesReturnType, i as QueryReturnType, j as RpcOrderByAttribute, k as RpcEntity, l as OnEntityExpiredEvent, m as MutateEntitiesParameters, n as QueryOptionsIncludeData, o as TxParams, p as Attribute, r as QueryOptionsOrderBy, s as OnEntityCreatedEvent, t as QueryOptions, u as OnEntityExpiresInExtendedEvent, v as ExtendEntityParameters, w as ChangeOwnershipParameters, x as DeleteEntityReturnType, y as ExtendEntityReturnType } from "../query-CO6f35AE.cjs";
-export { ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType };
+import { A as RpcEntity, C as QueryOptions, D as GetBlockTimingReturnType, E as QueryReturnType, M as RpcOrderByAttribute, N as RpcQueryOptions, P as MimeType, S as ChangeOwnershipReturnType, T as QueryOptionsOrderBy, _ as DeleteEntityParameters, a as OnEntityDeletedEvent, b as CreateEntityReturnType, c as OnEntityOwnerChangedEvent, d as MutateEntitiesParameters, f as MutateEntitiesReturnType, g as ExtendEntityReturnType, h as ExtendEntityParameters, i as OnEntityCreatedEvent, j as RpcIncludeData, k as ArkivRpcSchema, l as OnEntityUpdatedEvent, m as UpdateEntityReturnType, n as EntityOperationType, o as OnEntityExpiredEvent, p as UpdateEntityParameters, r as TxParams, s as OnEntityExpiresInExtendedEvent, t as Entity, u as Attribute, v as DeleteEntityReturnType, w as QueryOptionsIncludeData, x as ChangeOwnershipParameters, y as CreateEntityParameters } from "../entity-CN41IOrq.cjs";
+export { ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityOperationType, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType };

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-import { A as RpcIncludeData, C as CreateEntityReturnType, E as GetBlockTimingReturnType, M as RpcQueryOptions, N as MimeType, O as ArkivRpcSchema, S as CreateEntityParameters, T as ChangeOwnershipReturnType, _ as UpdateEntityReturnType, a as Entity, b as DeleteEntityParameters, c as OnEntityDeletedEvent, d as OnEntityOwnerChangedEvent, f as OnEntityUpdatedEvent, g as UpdateEntityParameters, h as MutateEntitiesReturnType, i as QueryReturnType, j as RpcOrderByAttribute, k as RpcEntity, l as OnEntityExpiredEvent, m as MutateEntitiesParameters, n as QueryOptionsIncludeData, o as TxParams, p as Attribute, r as QueryOptionsOrderBy, s as OnEntityCreatedEvent, t as QueryOptions, u as OnEntityExpiresInExtendedEvent, v as ExtendEntityParameters, w as ChangeOwnershipParameters, x as DeleteEntityReturnType, y as ExtendEntityReturnType } from "../query-BhdmAzYg.js";
-export { ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType };
+import { A as RpcEntity, C as QueryOptions, D as GetBlockTimingReturnType, E as QueryReturnType, M as RpcOrderByAttribute, N as RpcQueryOptions, P as MimeType, S as ChangeOwnershipReturnType, T as QueryOptionsOrderBy, _ as DeleteEntityParameters, a as OnEntityDeletedEvent, b as CreateEntityReturnType, c as OnEntityOwnerChangedEvent, d as MutateEntitiesParameters, f as MutateEntitiesReturnType, g as ExtendEntityReturnType, h as ExtendEntityParameters, i as OnEntityCreatedEvent, j as RpcIncludeData, k as ArkivRpcSchema, l as OnEntityUpdatedEvent, m as UpdateEntityReturnType, n as EntityOperationType, o as OnEntityExpiredEvent, p as UpdateEntityParameters, r as TxParams, s as OnEntityExpiresInExtendedEvent, t as Entity, u as Attribute, v as DeleteEntityReturnType, w as QueryOptionsIncludeData, x as ChangeOwnershipParameters, y as CreateEntityParameters } from "../entity-NnEVlePN.js";
+export { ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityOperationType, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType };

package/dist/types/index.js

@@ -1 +1,4 @@
-import "../types-H-TSmRpm.js";
+import { n as EntityOperationType } from "../entity-DGfVyB-a.js";
+import "../types-Ci4BRClw.js";
+
+export { EntityOperationType };

package/dist/utils/index.cjs

@@ -1,4 +1,5 @@
-const require_payload = require('../payload-vwU3Rc6P.cjs');
+const require_consts = require('../consts-CxT1-RXU.cjs');
+const require_payload = require('../payload-D8YLKcJj.cjs');
 
 //#region src/utils/expirationTime.ts
 const ExpirationTime = {
@@ -9,18 +10,11 @@ const ExpirationTime = {
 	fromWeeks: (weeks) => weeks * 7 * 24 * 60 * 60,
 	fromMonths: (months) => months * 30 * 24 * 60 * 60,
 	fromYears: (years) => years * 365 * 24 * 60 * 60,
-	fromBlocks: (blocks) => blocks * require_payload.BLOCK_TIME,
+	fromBlocks: (blocks) => blocks * require_consts.BLOCK_TIME,
 	fromDate: (date) => Math.floor(date.getTime() / 1e3) - Math.floor(Date.now() / 1e3)
 };
 
 //#endregion
 exports.ExpirationTime = ExpirationTime;
 exports.jsonToPayload = require_payload.jsonToPayload;
-exports.stringToPayload = require_payload.stringToPayload;
-var viem_utils = require("viem/utils");
-Object.keys(viem_utils).forEach(function (k) {
-  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: function () { return viem_utils[k]; }
-  });
-});
+exports.stringToPayload = require_payload.stringToPayload;

package/dist/utils/index.d.cts

@@ -1,5 +1,4 @@
 import { n as stringToPayload, t as jsonToPayload } from "../payload-CJN8fTvX.cjs";
-export * from "viem/utils";
 
 //#region src/utils/expirationTime.d.ts
 declare const ExpirationTime: {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/expirationTime.ts"],"sourcesContent":[],"mappings":";;;;cAEa;;;;;EAAA,SAAA,EAAA,CAAA,KAUZ,EAAA,MAAA,EAAA,GADkB,MAAI;;;;mBAAJ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/expirationTime.ts"],"sourcesContent":[],"mappings":";;;cAEa;;;EAAA,SAAA,EAAA,CAAA,KAUZ,EAAA,MAAA,EAAA,GADkB,MAAI;;;;;;mBAAJ"}

package/dist/utils/index.d.ts

@@ -1,5 +1,4 @@
-import { n as stringToPayload, t as jsonToPayload } from "../payload-Da9gJMG5.js";
-export * from "viem/utils";
+import { n as stringToPayload, t as jsonToPayload } from "../payload-C2KHOUoj.js";
 
 //#region src/utils/expirationTime.d.ts
 declare const ExpirationTime: {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/utils/expirationTime.ts"],"sourcesContent":[],"mappings":";;;;cAEa;;;;;EAAA,SAAA,EAAA,CAAA,KAUZ,EAAA,MAAA,EAAA,GADkB,MAAI;;;;mBAAJ"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/utils/expirationTime.ts"],"sourcesContent":[],"mappings":";;;cAEa;;;EAAA,SAAA,EAAA,CAAA,KAUZ,EAAA,MAAA,EAAA,GADkB,MAAI;;;;;;mBAAJ"}

package/dist/utils/index.js

@@ -1,6 +1,5 @@
-import { i as BLOCK_TIME, n as stringToPayload, t as jsonToPayload } from "../payload-DKBYYjeA.js";
-
-export * from "viem/utils"
+import { n as BLOCK_TIME } from "../consts-Bz0LZQZY.js";
+import { n as stringToPayload, t as jsonToPayload } from "../payload-BpNUPOnY.js";
 
 //#region src/utils/expirationTime.ts
 const ExpirationTime = {

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/utils/expirationTime.ts"],"sourcesContent":["import { BLOCK_TIME } from \"../consts\"\n\nexport const ExpirationTime = {\n  fromSeconds: (seconds: number) => seconds,\n  fromMinutes: (minutes: number) => minutes * 60,\n  fromHours: (hours: number) => hours * 60 * 60,\n  fromDays: (days: number) => days * 24 * 60 * 60,\n  fromWeeks: (weeks: number) => weeks * 7 * 24 * 60 * 60,\n  fromMonths: (months: number) => months * 30 * 24 * 60 * 60,\n  fromYears: (years: number) => years * 365 * 24 * 60 * 60,\n  fromBlocks: (blocks: number) => blocks * BLOCK_TIME,\n  fromDate: (date: Date) => Math.floor(date.getTime() / 1000) - Math.floor(Date.now() / 1000),\n}\n"],"mappings":";;;;;AAEA,MAAa,iBAAiB;CAC5B,cAAc,YAAoB;CAClC,cAAc,YAAoB,UAAU;CAC5C,YAAY,UAAkB,QAAQ,KAAK;CAC3C,WAAW,SAAiB,OAAO,KAAK,KAAK;CAC7C,YAAY,UAAkB,QAAQ,IAAI,KAAK,KAAK;CACpD,aAAa,WAAmB,SAAS,KAAK,KAAK,KAAK;CACxD,YAAY,UAAkB,QAAQ,MAAM,KAAK,KAAK;CACtD,aAAa,WAAmB,SAAS;CACzC,WAAW,SAAe,KAAK,MAAM,KAAK,SAAS,GAAG,IAAK,GAAG,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;CAC5F"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/utils/expirationTime.ts"],"sourcesContent":["import { BLOCK_TIME } from \"../consts\"\n\nexport const ExpirationTime = {\n  fromSeconds: (seconds: number) => seconds,\n  fromMinutes: (minutes: number) => minutes * 60,\n  fromHours: (hours: number) => hours * 60 * 60,\n  fromDays: (days: number) => days * 24 * 60 * 60,\n  fromWeeks: (weeks: number) => weeks * 7 * 24 * 60 * 60,\n  fromMonths: (months: number) => months * 30 * 24 * 60 * 60,\n  fromYears: (years: number) => years * 365 * 24 * 60 * 60,\n  fromBlocks: (blocks: number) => blocks * BLOCK_TIME,\n  fromDate: (date: Date) => Math.floor(date.getTime() / 1000) - Math.floor(Date.now() / 1000),\n}\n"],"mappings":";;;;AAEA,MAAa,iBAAiB;CAC5B,cAAc,YAAoB;CAClC,cAAc,YAAoB,UAAU;CAC5C,YAAY,UAAkB,QAAQ,KAAK;CAC3C,WAAW,SAAiB,OAAO,KAAK,KAAK;CAC7C,YAAY,UAAkB,QAAQ,IAAI,KAAK,KAAK;CACpD,aAAa,WAAmB,SAAS,KAAK,KAAK,KAAK;CACxD,YAAY,UAAkB,QAAQ,MAAM,KAAK,KAAK;CACtD,aAAa,WAAmB,SAAS;CACzC,WAAW,SAAe,KAAK,MAAM,KAAK,SAAS,GAAG,IAAK,GAAG,KAAK,MAAM,KAAK,KAAK,GAAG,IAAK;CAC5F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkiv-network/sdk",
-  "version": "0.6.8",
+  "version": "0.7.0-dev.1",
   "description": "TypeScript client library for Arkiv's blockchains interactions",
   "type": "module",
   "target": "esnext",
@@ -15,12 +15,6 @@
       "require": "./dist/index.cjs",
       "default": "./dist/index.js"
     },
-    "./accounts": {
-      "bun": "./src/accounts/index.ts",
-      "import": "./dist/accounts/index.js",
-      "require": "./dist/accounts/index.cjs",
-      "default": "./dist/accounts/index.js"
-    },
     "./chains": {
       "bun": "./src/chains/index.ts",
       "import": "./dist/chains/index.js",
@@ -52,9 +46,6 @@
       "chains": [
         "./dist/_types/chains/index.d.ts"
       ],
-      "accounts": [
-        "./dist/_types/accounts/index.d.ts"
-      ],
       "utils": [
         "./dist/_types/utils/index.d.ts"
       ],
@@ -90,13 +81,20 @@
     "@types/bun": "latest",
     "rimraf": "^6.0.1",
     "tsdown": "^0.16.0",
-    "typedoc": "^0.28.14"
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.9.2",
+    "viem": "^2.38.2"
   },
   "peerDependencies": {
-    "typescript": "^5.0.0"
+    "typescript": ">=5.0.0",
+    "viem": "^2.0.0"
   },
   "peerDependenciesMeta": {
     "typescript": {
+      "optional": true
+    },
+    "viem": {
       "optional": false
     }
   },
@@ -118,8 +116,6 @@
   },
   "homepage": "https://arkiv.network",
   "dependencies": {
-    "brotli-wasm": "^3.0.1",
-    "typedoc-plugin-markdown": "^4.9.0",
-    "viem": "^2.38.2"
+    "brotli-wasm": "^3.0.1"
   }
 }

package/src/actions/public/buildQuery.ts

@@ -1,6 +1,10 @@
 import type { ArkivClient } from "../../clients/baseClient"
 import { QueryBuilder } from "../../query/queryBuilder"
 
+/**
+ * @deprecated Use `client.select()` (see SelectQueryBuilder) instead. `buildQuery()` returns
+ * only the entity `key` unless data is explicitly opted in to, which is an easy mistake.
+ */
 export async function buildQuery(client: ArkivClient) {
   return new QueryBuilder(client)
 }

package/src/actions/public/query.ts

@@ -9,6 +9,11 @@ export type QueryOptionsIncludeData = {
   payload?: boolean
   metadata?: boolean
 }
+/**
+ * @deprecated Server-side ordering is not supported by the network. Sort the fetched
+ * entities in JavaScript instead (e.g. `entities.sort(...)`). This type will be removed
+ * in a future release.
+ */
 export type QueryOptionsOrderBy = {
   name: string
   type: "string" | "numeric"
@@ -18,6 +23,11 @@ export type QueryOptionsOrderBy = {
 export type QueryOptions = {
   includeData?: QueryOptionsIncludeData
   atBlock?: bigint
+  /**
+   * @deprecated Server-side ordering is not supported by the network, so this option has no
+   * effect on the returned order. Sort the fetched entities in JavaScript instead
+   * (e.g. `entities.sort(...)`). This option will be removed in a future release.
+   */
   orderBy?: QueryOptionsOrderBy[]
   resultsPerPage?: number | undefined
   cursor?: string | undefined

package/src/actions/public/subscribeEntityEvents.ts

@@ -1,6 +1,7 @@
-import { decodeEventLog, type Hex, parseAbi, toHex } from "viem"
+import { decodeEventLog, type Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { PublicArkivClient } from "../../clients/createPublicClient"
+import { EntityOperationType } from "../../types/entity"
 import type {
   OnEntityCreatedEvent,
   OnEntityDeletedEvent,
@@ -9,18 +10,12 @@ import type {
   OnEntityOwnerChangedEvent,
   OnEntityUpdatedEvent,
 } from "../../types/events"
+import { ENTITY_OPERATION_EVENT_ABI } from "../../utils/arkivTransactions"
 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)",
-  "event ArkivEntityUpdated(uint256 indexed entityKey, address indexed ownerAddress, uint256 oldExpirationBlock, uint256 newExpirationBlock, uint256 cost)",
-  "event ArkivEntityExpired(uint256 indexed entityKey, address indexed ownerAddress)",
-  "event ArkivEntityDeleted(uint256 indexed entityKey, address indexed ownerAddress)",
-  "event ArkivEntityBTLExtended(uint256 indexed entityKey, address indexed ownerAddress, uint256 oldExpirationBlock, uint256 newExpirationBlock, uint256 cost)",
-  "event ArkivEntityOwnerChanged(uint256 indexed entityKey, address indexed oldOwnerAddress, address indexed newOwnerAddress)",
-])
+export const arkivABI = ENTITY_OPERATION_EVENT_ABI
 
 export async function subscribeEntityEvents(
   client: ArkivClient,
@@ -57,54 +52,33 @@ export async function subscribeEntityEvents(
           data: log.data,
         })
         logger("event from subscribeEntityEvents %o", event)
-        switch (event.eventName) {
-          case "ArkivEntityCreated":
-            onEntityCreated?.({
-              entityKey: toHex(event.args.entityKey, { size: 32 }),
-              owner: event.args.ownerAddress,
-              expirationBlock: Number(event.args.expirationBlock),
-              cost: event.args.cost,
-            })
-            break
-          case "ArkivEntityUpdated":
-            onEntityUpdated?.({
-              entityKey: toHex(event.args.entityKey, { size: 32 }),
-              owner: event.args.ownerAddress,
-              oldExpirationBlock: Number(event.args.oldExpirationBlock),
-              newExpirationBlock: Number(event.args.newExpirationBlock),
-              cost: event.args.cost,
-            })
+
+        if (event.eventName !== "EntityOperation") continue
+
+        const entityKey = event.args.entityKey as Hex
+        const owner = event.args.owner
+        const expiresAt = event.args.expiresAt
+        const entityHash = event.args.entityHash as Hex
+        const opType = Number(event.args.operationType)
+
+        switch (opType) {
+          case EntityOperationType.Create:
+            onEntityCreated?.({ entityKey, owner, expiresAt, entityHash })
             break
-          case "ArkivEntityDeleted":
-            onEntityDeleted?.({
-              entityKey: toHex(event.args.entityKey, { size: 32 }),
-              owner: event.args.ownerAddress,
-            })
+          case EntityOperationType.Update:
+            onEntityUpdated?.({ entityKey, owner, expiresAt, entityHash })
             break
-          case "ArkivEntityBTLExtended":
-            onEntityExpiresInExtended?.({
-              entityKey: toHex(event.args.entityKey, { size: 32 }),
-              owner: event.args.ownerAddress,
-              oldExpirationBlock: Number(event.args.oldExpirationBlock),
-              newExpirationBlock: Number(event.args.newExpirationBlock),
-              cost: event.args.cost,
-            })
+          case EntityOperationType.Extend:
+            onEntityExpiresInExtended?.({ entityKey, owner, expiresAt, entityHash })
             break
-          case "ArkivEntityExpired":
-            onEntityExpired?.({
-              entityKey: toHex(event.args.entityKey, { size: 32 }),
-              owner: event.args.ownerAddress,
-            })
+          case EntityOperationType.Transfer:
+            onEntityOwnerChanged?.({ entityKey, owner, entityHash })
             break
-          case "ArkivEntityOwnerChanged":
-            onEntityOwnerChanged?.({
-              entityKey: toHex(event.args.entityKey, { size: 32 }),
-              oldOwner: event.args.oldOwnerAddress,
-              newOwner: event.args.newOwnerAddress,
-            })
+          case EntityOperationType.Delete:
+            onEntityDeleted?.({ entityKey, owner })
             break
           default:
-            console.warn("unknown event from subscribeEntityEvents", event)
+            onEntityExpired?.({ entityKey, owner })
             break
         }
       }

package/src/actions/wallet/changeOwnership.ts

@@ -1,14 +1,15 @@
 import type { Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { TxParams } from "../../types"
-import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { sendArkivTransaction } from "../../utils/arkivTransactions"
 import { getLogger } from "../../utils/logger"
 
 const logger = getLogger("actions:wallet:change-ownership")
 
 /**
- * Parameters for the deleteEntity function.
- * - entityKey: The key of the entity to delete.
+ * Parameters for the changeOwnership function.
+ * - entityKey: The key of the entity.
+ * - newOwner: The address of the new owner.
  */
 export type ChangeOwnershipParameters = {
   entityKey: Hex
@@ -16,7 +17,7 @@ export type ChangeOwnershipParameters = {
 }
 
 /**
- * Return type for the deleteEntity function.
+ * Return type for the changeOwnership function.
  * - entityKey: The key of the entity.
  * - txHash: The transaction hash.
  */
@@ -31,8 +32,7 @@ export async function changeOwnership(
   txParams?: TxParams,
 ): Promise<ChangeOwnershipReturnType> {
   logger("changeOwnership %o", data)
-  const txData = opsToTxData({ ownershipChanges: [data] })
-  const receipt = await sendArkivTransaction(client, txData, txParams)
+  const { receipt } = await sendArkivTransaction(client, { ownershipChanges: [data] }, txParams)
 
   logger("Receipt from changeOwnership %o", receipt)
 

package/src/actions/wallet/createEntity.ts

@@ -1,7 +1,7 @@
 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 { sendArkivTransaction } from "../../utils/arkivTransactions"
 import { getLogger } from "../../utils/logger"
 
 const logger = getLogger("actions:wallet:create-entity")
@@ -9,14 +9,24 @@ const logger = getLogger("actions:wallet:create-entity")
 /**
  * Parameters for the createEntity function.
  * - payload: The payload of the entity.
- * - attributes: The attributes of the entity.
+ * - attributes: The attributes of the entity. Attribute values may be strings
+ *   or numbers, but numeric values **must be integers**. To store a non-integer,
+ *   scale it to an integer (e.g. `1.5` -> `1500`) to preserve numeric ordering,
+ *   or pass it as a string (e.g. `"1.5"`). A non-integer numeric value throws an
+ *   {@link InvalidAttributeError}.
  * - contentType: The content type of the entity.
- * - expiresIn: The expires in of the entity in seconds.
+ * - expiresIn: How long until the entity expires, in seconds. Because Arkiv
+ *   measures expiration in blocks (1 block = 2 seconds), this **must be a
+ *   positive integer and a multiple of the block time (2 seconds)**
+ *   Invalid values throw an {@link InvalidExpirationError}.
  */
 export type CreateEntityParameters = {
   payload: Uint8Array
+  /** Entity attributes. Numeric values must be integers (scale non-integers, e.g. `1.5` -> `1500`, or use a string). Throws {@link InvalidAttributeError} otherwise. */
   attributes: Attribute[]
   contentType: MimeType | string
+  /** Seconds until expiry. Must be a positive integer and a multiple of the 2s block time.
+   * Throws {@link InvalidExpirationError} otherwise. */
   expiresIn: number
 }
 
@@ -36,13 +46,16 @@ export async function createEntity(
   txParams?: TxParams,
 ): Promise<CreateEntityReturnType> {
   logger("createEntity %o", data)
-  const txData = opsToTxData({ creates: [data] })
-  const receipt = await sendArkivTransaction(client, txData, txParams)
+  const { receipt, createdEntityKeys } = await sendArkivTransaction(
+    client,
+    { creates: [data] },
+    txParams,
+  )
 
   logger("Receipt from createEntity %o", receipt)
 
   return {
     txHash: receipt.transactionHash as Hash,
-    entityKey: receipt.logs[0].topics[1] as Hex,
+    entityKey: createdEntityKeys[0],
   }
 }

package/src/actions/wallet/deleteEntity.ts

@@ -1,7 +1,7 @@
 import type { Hash, Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { TxParams } from "../../types"
-import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { sendArkivTransaction } from "../../utils/arkivTransactions"
 import { getLogger } from "../../utils/logger"
 
 const logger = getLogger("actions:wallet:delete-entity")
@@ -30,8 +30,7 @@ export async function deleteEntity(
   txParams?: TxParams,
 ): Promise<DeleteEntityReturnType> {
   logger("deleteEntity %o", data)
-  const txData = opsToTxData({ deletes: [data] })
-  const receipt = await sendArkivTransaction(client, txData, txParams)
+  const { receipt } = await sendArkivTransaction(client, { deletes: [data] }, txParams)
 
   logger("Receipt from deleteEntity %o", receipt)
 

package/src/actions/wallet/extendEntity.ts

@@ -1,7 +1,7 @@
 import type { Hash, Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import type { TxParams } from "../../types"
-import { opsToTxData, sendArkivTransaction } from "../../utils/arkivTransactions"
+import { sendArkivTransaction } from "../../utils/arkivTransactions"
 import { getLogger } from "../../utils/logger"
 
 const logger = getLogger("actions:wallet:extend-entity")
@@ -9,10 +9,15 @@ const logger = getLogger("actions:wallet:extend-entity")
 /**
  * Parameters for the extendEntity function.
  * - entityKey: The key of the entity to extend.
- * - expiresIn: The expires in of the entity in seconds.
+ * - expiresIn: How long to extend the entity by, in seconds. Because Arkiv
+ *   measures expiration in blocks (1 block = 2 seconds), this **must be a
+ *   positive integer and a multiple of the block time (2 seconds)**.
+ *   Invalid values throw an {@link InvalidExpirationError}.
  */
 export type ExtendEntityParameters = {
   entityKey: Hex
+  /** Seconds to extend by. Must be a positive integer and a multiple of the 2s block time.
+   * Throws {@link InvalidExpirationError} otherwise. */
   expiresIn: number
 }
 
@@ -32,13 +37,12 @@ export async function extendEntity(
   txParams?: TxParams,
 ): Promise<ExtendEntityReturnType> {
   logger("extendEntity %o", data)
-  const txData = opsToTxData({ extensions: [data] })
-  const receipt = await sendArkivTransaction(client, txData, txParams)
+  const { receipt } = await sendArkivTransaction(client, { extensions: [data] }, txParams)
 
   logger("Receipt from extendEntity %o", receipt)
 
   return {
     txHash: receipt.transactionHash as Hash,
-    entityKey: receipt.logs[0].topics[1] as Hex,
+    entityKey: data.entityKey,
   }
 }

package/src/actions/wallet/mutateEntities.ts

@@ -1,17 +1,16 @@
-import type { Hash, Hex, TransactionReceipt } 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 { 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"
 import type { UpdateEntityParameters } from "./updateEntity"
 
+const logger = getLogger("actions:wallet:mutate-entities")
+
 /**
  * Parameters for the mutateEntities function.
  * - creates: The creates to perform.
@@ -27,39 +26,6 @@ export type MutateEntitiesParameters = {
   ownershipChanges?: ChangeOwnershipParameters[]
 }
 
-function parseReceipt(receipt: TransactionReceipt, params: MutateEntitiesParameters) {
-  const createdEntities: Hex[] = []
-  const updatedEntities: Hex[] = []
-  const deletedEntities: Hex[] = []
-  const extendedEntities: Hex[] = []
-  const ownershipChanges: Hex[] = []
-
-  const totalCreates = params.creates?.length ?? 0
-  const totalUpdates = params.updates?.length ?? 0
-  const totalDeletes = params.deletes?.length ?? 0
-  const totalExtensions = params.extensions?.length ?? 0
-
-  // iterate over all logs and parse the event
-  // logs go in the following order: creates, deleted, updates, extends, ownership changes
-  for (let index = 0; index < receipt.logs.length; index++) {
-    const log = receipt.logs[index]
-
-    if (index < totalCreates) {
-      createdEntities.push(log.topics[1] as Hex)
-    } else if (index < totalCreates + totalDeletes) {
-      deletedEntities.push(log.topics[1] as Hex)
-    } else if (index < totalCreates + totalUpdates + totalDeletes) {
-      updatedEntities.push(log.topics[1] as Hex)
-    } else if (index < totalCreates + totalUpdates + totalDeletes + totalExtensions) {
-      extendedEntities.push(log.topics[1] as Hex)
-    } else {
-      ownershipChanges.push(log.topics[1] as Hex)
-    }
-  }
-
-  return { createdEntities, updatedEntities, deletedEntities, extendedEntities, ownershipChanges }
-}
-
 /**
  * Return type for the mutateEntities function.
  * - txHash: The transaction hash.
@@ -77,6 +43,7 @@ export type MutateEntitiesReturnType = {
   extendedEntities: Hex[]
   ownershipChanges: Hex[]
 }
+
 export async function mutateEntities(
   client: ArkivClient,
   data: MutateEntitiesParameters,
@@ -86,26 +53,16 @@ export async function mutateEntities(
     throw new Error("No operations to perform")
   }
 
-  const txData = opsToTxData({
-    creates: data.creates ?? [],
-    updates: data.updates ?? [],
-    deletes: data.deletes ?? [],
-    extensions: data.extensions ?? [],
-    ownershipChanges: data.ownershipChanges ?? [],
-  })
-
-  const receipt = await sendArkivTransaction(client, txData, txParams)
+  const { receipt, createdEntityKeys } = await sendArkivTransaction(client, data, txParams)
 
   logger("Receipt from mutateEntities %o", receipt)
 
-  const { createdEntities, updatedEntities, deletedEntities, extendedEntities, ownershipChanges } =
-    parseReceipt(receipt, data)
   return {
     txHash: receipt.transactionHash as Hash,
-    createdEntities,
-    updatedEntities,
-    deletedEntities,
-    extendedEntities,
-    ownershipChanges,
+    createdEntities: createdEntityKeys,
+    updatedEntities: (data.updates ?? []).map((u) => u.entityKey),
+    deletedEntities: (data.deletes ?? []).map((d) => d.entityKey),
+    extendedEntities: (data.extensions ?? []).map((e) => e.entityKey),
+    ownershipChanges: (data.ownershipChanges ?? []).map((o) => o.entityKey),
   }
 }

package/src/actions/wallet/updateEntity.ts

@@ -1,7 +1,7 @@
 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 { sendArkivTransaction } from "../../utils/arkivTransactions"
 import { getLogger } from "../../utils/logger"
 
 const logger = getLogger("actions:wallet:update-entity")
@@ -10,15 +10,25 @@ const logger = getLogger("actions:wallet:update-entity")
  * Parameters for the updateEntity function.
  * - entityKey: The key of the entity to update.
  * - payload: The payload of the entity.
- * - attributes: The attributes of the entity.
+ * - attributes: The attributes of the entity. Attribute values may be strings
+ *   or numbers, but numeric values **must be integers**. To store a non-integer,
+ *   scale it to an integer (e.g. `1.5` -> `1500`) to preserve numeric ordering,
+ *   or pass it as a string (e.g. `"1.5"`). A non-integer numeric value throws an
+ *   {@link InvalidAttributeError}.
  * - contentType: The content type of the entity.
- * - expiresIn: The expires in of the entity in seconds.
+ * - expiresIn: How long until the entity expires, in seconds. Because Arkiv
+ *   measures expiration in blocks (1 block = 2 seconds), this **must be a
+ *   positive integer and a multiple of the block time (2 seconds)**.
+ *   Invalid values throw an {@link InvalidExpirationError}.
  */
 export type UpdateEntityParameters = {
   entityKey: Hex
   payload: Uint8Array
+  /** Entity attributes. Numeric values must be integers (scale non-integers, e.g. `1.5` -> `1500`, or use a string). Throws {@link InvalidAttributeError} otherwise. */
   attributes: Attribute[]
   contentType: MimeType | string
+  /** Seconds until expiry. Must be a positive integer and a multiple of the 2s block time.
+   * Throws {@link InvalidExpirationError} otherwise. */
   expiresIn: number
 }
 
@@ -38,13 +48,12 @@ export async function updateEntity(
   txParams?: TxParams,
 ): Promise<UpdateEntityReturnType> {
   logger("updateEntity %o", data)
-  const txData = opsToTxData({ updates: [data] })
-  const receipt = await sendArkivTransaction(client, txData, txParams)
+  const { receipt } = await sendArkivTransaction(client, { updates: [data] }, txParams)
 
   logger("Receipt from updateEntity %o", receipt)
 
   return {
     txHash: receipt.transactionHash as Hash,
-    entityKey: receipt.logs[0].topics[1] as Hex,
+    entityKey: data.entityKey,
   }
 }

package/src/clients/createPublicClient.test.ts

@@ -20,6 +20,8 @@ test("creates", () => {
   expect(typeof client.getEntity).toBe("function")
   expect(client.buildQuery).toBeDefined()
   expect(typeof client.buildQuery).toBe("function")
+  expect(client.select).toBeDefined()
+  expect(typeof client.select).toBe("function")
   expect(client.query).toBeDefined()
   expect(typeof client.query).toBe("function")
   expect(client.getEntityCount).toBeDefined()