@arkiv-network/sdk 0.6.8-dev.2 → 0.6.8-dev.3

package/dist/index.cjs

@@ -1,7 +1,8 @@
 const require_chains = require('./chains-BifaY04V.cjs');
-const require_queryBuilder = require('./queryBuilder-BlMPfusd.cjs');
-const require_payload = require('./payload-vwU3Rc6P.cjs');
+const require_queryBuilder = require('./queryBuilder-CTPwve9u.cjs');
+const require_consts = require('./consts-AUoL-v42.cjs');
 require('./types-o3zWarRp.cjs');
+const require_payload = require('./payload-DpA5PA-w.cjs');
 let viem = require("viem");
 
 //#region src/actions/public/getBlockTiming.ts
@@ -282,6 +283,32 @@ async function compress(data) {
 	return brotliCompressed;
 }
 
+//#endregion
+//#region src/utils/validation.ts
+/**
+* Expiration on Arkiv is measured in blocks (1 block =
+* 2 seconds), so the value must be a positive integer that is
+* a multiple of the block time.
+*
+* @param expiresIn - The expiration in seconds.
+* @throws {InvalidExpirationError} If the value is not a positive integer that
+* is a multiple of the block time.
+*/
+function validateExpiresIn(expiresIn) {
+	if (!Number.isInteger(expiresIn) || expiresIn <= 0 || expiresIn % require_consts.BLOCK_TIME !== 0) throw new require_queryBuilder.InvalidExpirationError(expiresIn);
+}
+/**
+* Validates a single attribute. Arkiv supports string and number attribute
+* values, but numeric values must be integers.
+*
+* @param attribute - The attribute to validate.
+* @throws {InvalidAttributeError} If the attribute has a non-integer numeric
+* value.
+*/
+function validateAttribute(attribute) {
+	if (typeof attribute.value === "number" && !Number.isInteger(attribute.value)) throw new require_queryBuilder.InvalidAttributeError(attribute.key, attribute.value);
+}
+
 //#endregion
 //#region src/utils/arkivTransactions.ts
 const logger$6 = require_queryBuilder.getLogger("utils:arkiv-transactions");
@@ -290,23 +317,34 @@ function opsToTxData({ creates, updates, deletes, extensions, ownershipChanges }
 		return [(0, viem.toHex)(attribute.key), (0, viem.toHex)(typeof attribute.value === "number" && attribute.value === 0 ? "" : attribute.value)];
 	}
 	const payload = [
-		(creates ?? []).map((item) => [
-			(0, viem.toHex)(Math.ceil(item.expiresIn / require_payload.BLOCK_TIME)),
-			(0, viem.toHex)(item.contentType),
-			(0, viem.toHex)(item.payload),
-			item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
-			item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
-		]),
-		(updates ?? []).map((item) => [
-			item.entityKey,
-			(0, viem.toHex)(item.contentType),
-			(0, viem.toHex)(Math.ceil(item.expiresIn / require_payload.BLOCK_TIME)),
-			(0, viem.toHex)(item.payload),
-			item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
-			item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
-		]),
+		(creates ?? []).map((item) => {
+			validateExpiresIn(item.expiresIn);
+			item.attributes.forEach(validateAttribute);
+			return [
+				(0, viem.toHex)(item.expiresIn / require_consts.BLOCK_TIME),
+				(0, viem.toHex)(item.contentType),
+				(0, viem.toHex)(item.payload),
+				item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
+				item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
+			];
+		}),
+		(updates ?? []).map((item) => {
+			validateExpiresIn(item.expiresIn);
+			item.attributes.forEach(validateAttribute);
+			return [
+				item.entityKey,
+				(0, viem.toHex)(item.contentType),
+				(0, viem.toHex)(item.expiresIn / require_consts.BLOCK_TIME),
+				(0, viem.toHex)(item.payload),
+				item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
+				item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
+			];
+		}),
 		(deletes ?? []).map((item) => item.entityKey),
-		(extensions ?? []).map((item) => [item.entityKey, (0, viem.toHex)(Math.ceil(item.expiresIn / require_payload.BLOCK_TIME))]),
+		(extensions ?? []).map((item) => {
+			validateExpiresIn(item.expiresIn);
+			return [item.entityKey, (0, viem.toHex)(item.expiresIn / require_consts.BLOCK_TIME)];
+		}),
 		(ownershipChanges ?? []).map((item) => [item.entityKey, item.newOwner])
 	];
 	logger$6("txData to send as RLP %o length %d", payload, payload.length);
@@ -318,7 +356,7 @@ async function sendArkivTransaction(client, data, txParams) {
 	logger$6("Sending transaction %o", {
 		account: client.account,
 		chain: client.chain,
-		to: require_payload.ARKIV_ADDRESS,
+		to: require_consts.ARKIV_ADDRESS,
 		value: 0n,
 		data,
 		...txParams
@@ -328,7 +366,7 @@ async function sendArkivTransaction(client, data, txParams) {
 		const txHash = await walletClient.sendTransaction({
 			account: client.account,
 			chain: client.chain,
-			to: require_payload.ARKIV_ADDRESS,
+			to: require_consts.ARKIV_ADDRESS,
 			value: 0n,
 			data: (0, viem.toHex)(compressed),
 			...txParams
@@ -338,7 +376,7 @@ async function sendArkivTransaction(client, data, txParams) {
 		if (receipt.status === "reverted") try {
 			const callResult = await walletClient.call({
 				account: client.account,
-				to: require_payload.ARKIV_ADDRESS,
+				to: require_consts.ARKIV_ADDRESS,
 				value: 0n,
 				data: (0, viem.toHex)(compressed),
 				...txParams
@@ -535,6 +573,8 @@ function chainFromName(name) {
 
 //#endregion
 exports.EntityMutationError = require_queryBuilder.EntityMutationError;
+exports.InvalidAttributeError = require_queryBuilder.InvalidAttributeError;
+exports.InvalidExpirationError = require_queryBuilder.InvalidExpirationError;
 exports.NoCursorOrLimitError = require_queryBuilder.NoCursorOrLimitError;
 exports.NoEntityFoundError = require_queryBuilder.NoEntityFoundError;
 exports.NoMoreResultsError = require_queryBuilder.NoMoreResultsError;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as RpcIncludeData, C as QueryOptionsIncludeData, D as ArkivClient, E as GetBlockTimingReturnType, M as RpcQueryOptions, N as MimeType, O as ArkivRpcSchema, S as QueryOptions, T as QueryReturnType, _ as DeleteEntityReturnType, a as OnEntityExpiredEvent, b as ChangeOwnershipParameters, c as OnEntityUpdatedEvent, d as MutateEntitiesReturnType, f as UpdateEntityParameters, g as DeleteEntityParameters, h as ExtendEntityReturnType, i as OnEntityDeletedEvent, j as RpcOrderByAttribute, k as RpcEntity, l as Attribute, m as ExtendEntityParameters, n as TxParams, o as OnEntityExpiresInExtendedEvent, p as UpdateEntityReturnType, r as OnEntityCreatedEvent, s as OnEntityOwnerChangedEvent, t as Entity, u as MutateEntitiesParameters, v as CreateEntityParameters, w as QueryOptionsOrderBy, x as ChangeOwnershipReturnType, y as CreateEntityReturnType } from "./entity-B3qWIdug.cjs";
-import { c as FullEntity, i as SelectQueryBuilder, l as ProjectedEntity, r as QueryBuilder, s as EntitySelection, u as SelectArg } from "./index-Dushe05u.cjs";
+import { A as RpcIncludeData, C as QueryOptionsIncludeData, D as ArkivClient, E as GetBlockTimingReturnType, M as RpcQueryOptions, N as MimeType, O as ArkivRpcSchema, S as QueryOptions, T as QueryReturnType, _ as DeleteEntityReturnType, a as OnEntityExpiredEvent, b as ChangeOwnershipParameters, c as OnEntityUpdatedEvent, d as MutateEntitiesReturnType, f as UpdateEntityParameters, g as DeleteEntityParameters, h as ExtendEntityReturnType, i as OnEntityDeletedEvent, j as RpcOrderByAttribute, k as RpcEntity, l as Attribute, m as ExtendEntityParameters, n as TxParams, o as OnEntityExpiresInExtendedEvent, p as UpdateEntityReturnType, r as OnEntityCreatedEvent, s as OnEntityOwnerChangedEvent, t as Entity, u as MutateEntitiesParameters, v as CreateEntityParameters, w as QueryOptionsOrderBy, x as ChangeOwnershipReturnType, y as CreateEntityReturnType } from "./entity-BSU5-vyY.cjs";
+import { c as FullEntity, i as SelectQueryBuilder, l as ProjectedEntity, r as QueryBuilder, s as EntitySelection, u as SelectArg } from "./index-gj33r3rd.cjs";
 import { n as stringToPayload, t as jsonToPayload } from "./payload-CJN8fTvX.cjs";
 import { Account, Address, Chain, Client, Hex, ParseAccount, Prettify, PublicActions, PublicClientConfig, RpcSchema, Transport, WalletActions, WalletClientConfig } from "viem";
 
@@ -254,6 +254,11 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The created entity with transaction hash
    *
+   * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer
+   * that is a multiple of the block time (2 seconds).
+   * @throws {InvalidAttributeError} If a numeric attribute value is not an
+   * integer.
+   *
    * @example
    * import { createPublicClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -285,6 +290,11 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The updated entity with transaction hash
    *
+   * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer
+   * that is a multiple of the block time (2 seconds).
+   * @throws {InvalidAttributeError} If a numeric attribute value is not an
+   * integer.
+   *
    * @example
    * import { createWalletClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -332,6 +342,9 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The updated entity with transaction hash
    *
+   * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer
+   * that is a multiple of the block time (2 seconds).
+   *
    * @example
    * import { createWalletClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -372,6 +385,11 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The mutation result with transaction hash
    *
+   * @throws {InvalidExpirationError} If any create/update/extension `expiresIn`
+   * is not a positive integer that is a multiple of the block time (2 seconds).
+   * @throws {InvalidAttributeError} If a numeric attribute value is not an
+   * integer.
+   *
    * @example
    * import { createWalletClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -437,6 +455,12 @@ declare function createWalletClient<transport extends Transport, chain extends C
 declare class EntityMutationError extends Error {
   constructor(message: string);
 }
+declare class InvalidExpirationError extends Error {
+  constructor(expiresIn: unknown);
+}
+declare class InvalidAttributeError extends Error {
+  constructor(key: string, value: number);
+}
 declare class NoMoreResultsError extends Error {
   constructor();
 }
@@ -456,5 +480,5 @@ declare class NoEntityFoundError extends Error {
  */
 declare function chainFromName(name: string): Chain;
 //#endregion
-export { type ArkivClient, ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityMutationError, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, NoCursorOrLimitError, NoEntityFoundError, NoMoreResultsError, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, type PublicArkivActions, type PublicArkivClient, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType, type WalletArkivActions, type WalletArkivClient, chainFromName, createPublicClient, createWalletClient, jsonToPayload, stringToPayload };
+export { type ArkivClient, ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityMutationError, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, InvalidAttributeError, InvalidExpirationError, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, NoCursorOrLimitError, NoEntityFoundError, NoMoreResultsError, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, type PublicArkivActions, type PublicArkivClient, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType, type WalletArkivActions, type WalletArkivClient, chainFromName, createPublicClient, createWalletClient, jsonToPayload, stringToPayload };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/clients/decorators/arkivPublic.ts","../src/clients/createPublicClient.ts","../src/clients/decorators/arkivWallet.ts","../src/clients/createWalletClient.ts","../src/errors.ts","../src/utils/chains.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/clients/decorators/arkivPublic.ts","../src/clients/createPublicClient.ts","../src/clients/decorators/arkivWallet.ts","../src/clients/createWalletClient.ts","../src/errors.ts","../src/utils/chains.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { A as RpcIncludeData, C as QueryOptionsIncludeData, D as ArkivClient, E as GetBlockTimingReturnType, M as RpcQueryOptions, N as MimeType, O as ArkivRpcSchema, S as QueryOptions, T as QueryReturnType, _ as DeleteEntityReturnType, a as OnEntityExpiredEvent, b as ChangeOwnershipParameters, c as OnEntityUpdatedEvent, d as MutateEntitiesReturnType, f as UpdateEntityParameters, g as DeleteEntityParameters, h as ExtendEntityReturnType, i as OnEntityDeletedEvent, j as RpcOrderByAttribute, k as RpcEntity, l as Attribute, m as ExtendEntityParameters, n as TxParams, o as OnEntityExpiresInExtendedEvent, p as UpdateEntityReturnType, r as OnEntityCreatedEvent, s as OnEntityOwnerChangedEvent, t as Entity, u as MutateEntitiesParameters, v as CreateEntityParameters, w as QueryOptionsOrderBy, x as ChangeOwnershipReturnType, y as CreateEntityReturnType } from "./entity-BOra9GVW.js";
-import { c as FullEntity, i as SelectQueryBuilder, l as ProjectedEntity, r as QueryBuilder, s as EntitySelection, u as SelectArg } from "./index-t3wvdqvC.js";
-import { n as stringToPayload, t as jsonToPayload } from "./payload-Da9gJMG5.js";
+import { A as RpcIncludeData, C as QueryOptionsIncludeData, D as ArkivClient, E as GetBlockTimingReturnType, M as RpcQueryOptions, N as MimeType, O as ArkivRpcSchema, S as QueryOptions, T as QueryReturnType, _ as DeleteEntityReturnType, a as OnEntityExpiredEvent, b as ChangeOwnershipParameters, c as OnEntityUpdatedEvent, d as MutateEntitiesReturnType, f as UpdateEntityParameters, g as DeleteEntityParameters, h as ExtendEntityReturnType, i as OnEntityDeletedEvent, j as RpcOrderByAttribute, k as RpcEntity, l as Attribute, m as ExtendEntityParameters, n as TxParams, o as OnEntityExpiresInExtendedEvent, p as UpdateEntityReturnType, r as OnEntityCreatedEvent, s as OnEntityOwnerChangedEvent, t as Entity, u as MutateEntitiesParameters, v as CreateEntityParameters, w as QueryOptionsOrderBy, x as ChangeOwnershipReturnType, y as CreateEntityReturnType } from "./entity-CHiZ2Qu1.js";
+import { c as FullEntity, i as SelectQueryBuilder, l as ProjectedEntity, r as QueryBuilder, s as EntitySelection, u as SelectArg } from "./index-CzqHiUAo.js";
+import { n as stringToPayload, t as jsonToPayload } from "./payload-B2kFJyah.js";
 import { Account, Address, Chain, Client, Hex, ParseAccount, Prettify, PublicActions, PublicClientConfig, RpcSchema, Transport, WalletActions, WalletClientConfig } from "viem";
 
 //#region src/clients/decorators/arkivPublic.d.ts
@@ -254,6 +254,11 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The created entity with transaction hash
    *
+   * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer
+   * that is a multiple of the block time (2 seconds).
+   * @throws {InvalidAttributeError} If a numeric attribute value is not an
+   * integer.
+   *
    * @example
    * import { createPublicClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -285,6 +290,11 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The updated entity with transaction hash
    *
+   * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer
+   * that is a multiple of the block time (2 seconds).
+   * @throws {InvalidAttributeError} If a numeric attribute value is not an
+   * integer.
+   *
    * @example
    * import { createWalletClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -332,6 +342,9 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The updated entity with transaction hash
    *
+   * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer
+   * that is a multiple of the block time (2 seconds).
+   *
    * @example
    * import { createWalletClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -372,6 +385,11 @@ type WalletArkivActions<transport extends Transport = Transport, chain extends C
    * @param txParams - Optional transaction parameters
    * @returns The mutation result with transaction hash
    *
+   * @throws {InvalidExpirationError} If any create/update/extension `expiresIn`
+   * is not a positive integer that is a multiple of the block time (2 seconds).
+   * @throws {InvalidAttributeError} If a numeric attribute value is not an
+   * integer.
+   *
    * @example
    * import { createWalletClient, http } from 'arkiv'
    * import { braga } from 'arkiv/chains'
@@ -437,6 +455,12 @@ declare function createWalletClient<transport extends Transport, chain extends C
 declare class EntityMutationError extends Error {
   constructor(message: string);
 }
+declare class InvalidExpirationError extends Error {
+  constructor(expiresIn: unknown);
+}
+declare class InvalidAttributeError extends Error {
+  constructor(key: string, value: number);
+}
 declare class NoMoreResultsError extends Error {
   constructor();
 }
@@ -456,5 +480,5 @@ declare class NoEntityFoundError extends Error {
  */
 declare function chainFromName(name: string): Chain;
 //#endregion
-export { type ArkivClient, ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityMutationError, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, NoCursorOrLimitError, NoEntityFoundError, NoMoreResultsError, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, type PublicArkivActions, type PublicArkivClient, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType, type WalletArkivActions, type WalletArkivClient, chainFromName, createPublicClient, createWalletClient, jsonToPayload, stringToPayload };
+export { type ArkivClient, ArkivRpcSchema, Attribute, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityMutationError, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, InvalidAttributeError, InvalidExpirationError, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, NoCursorOrLimitError, NoEntityFoundError, NoMoreResultsError, OnEntityCreatedEvent, OnEntityDeletedEvent, OnEntityExpiredEvent, OnEntityExpiresInExtendedEvent, OnEntityOwnerChangedEvent, OnEntityUpdatedEvent, type PublicArkivActions, type PublicArkivClient, QueryOptions, QueryOptionsIncludeData, QueryOptionsOrderBy, QueryReturnType, RpcEntity, RpcIncludeData, RpcOrderByAttribute, RpcQueryOptions, TxParams, UpdateEntityParameters, UpdateEntityReturnType, type WalletArkivActions, type WalletArkivClient, chainFromName, createPublicClient, createWalletClient, jsonToPayload, stringToPayload };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/clients/decorators/arkivPublic.ts","../src/clients/createPublicClient.ts","../src/clients/decorators/arkivWallet.ts","../src/clients/createWalletClient.ts","../src/errors.ts","../src/utils/chains.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/clients/decorators/arkivPublic.ts","../src/clients/createPublicClient.ts","../src/clients/decorators/arkivWallet.ts","../src/clients/createWalletClient.ts","../src/errors.ts","../src/utils/chains.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.js

@@ -1,7 +1,8 @@
 import { t as chains_exports } from "./chains-CrtkVbBh.js";
-import { c as entityFromRpcResult, d as NoEntityFoundError, f as NoMoreResultsError, l as EntityMutationError, n as QueryBuilder, p as getLogger, r as SelectQueryBuilder, u as NoCursorOrLimitError } from "./queryBuilder-D7iYS0vU.js";
-import { i as BLOCK_TIME, n as stringToPayload, r as ARKIV_ADDRESS, t as jsonToPayload } from "./payload-DKBYYjeA.js";
+import { c as entityFromRpcResult, d as InvalidExpirationError, f as NoCursorOrLimitError, h as getLogger, l as EntityMutationError, m as NoMoreResultsError, n as QueryBuilder, p as NoEntityFoundError, r as SelectQueryBuilder, u as InvalidAttributeError } from "./queryBuilder-D-ACo-g_.js";
+import { n as BLOCK_TIME, t as ARKIV_ADDRESS } from "./consts-BV4PR-de.js";
 import "./types-H-TSmRpm.js";
+import { n as stringToPayload, t as jsonToPayload } from "./payload-Claf2jUO.js";
 import { TransactionExecutionError, bytesToHex, createClient, decodeEventLog, hexToBytes, hexToString, numberToHex, parseAbi, publicActions, toBytes, toHex, toRlp, walletActions } from "viem";
 
 //#region src/actions/public/getBlockTiming.ts
@@ -282,6 +283,32 @@ async function compress(data) {
 	return brotliCompressed;
 }
 
+//#endregion
+//#region src/utils/validation.ts
+/**
+* Expiration on Arkiv is measured in blocks (1 block =
+* 2 seconds), so the value must be a positive integer that is
+* a multiple of the block time.
+*
+* @param expiresIn - The expiration in seconds.
+* @throws {InvalidExpirationError} If the value is not a positive integer that
+* is a multiple of the block time.
+*/
+function validateExpiresIn(expiresIn) {
+	if (!Number.isInteger(expiresIn) || expiresIn <= 0 || expiresIn % BLOCK_TIME !== 0) throw new InvalidExpirationError(expiresIn);
+}
+/**
+* Validates a single attribute. Arkiv supports string and number attribute
+* values, but numeric values must be integers.
+*
+* @param attribute - The attribute to validate.
+* @throws {InvalidAttributeError} If the attribute has a non-integer numeric
+* value.
+*/
+function validateAttribute(attribute) {
+	if (typeof attribute.value === "number" && !Number.isInteger(attribute.value)) throw new InvalidAttributeError(attribute.key, attribute.value);
+}
+
 //#endregion
 //#region src/utils/arkivTransactions.ts
 const logger$6 = getLogger("utils:arkiv-transactions");
@@ -290,23 +317,34 @@ function opsToTxData({ creates, updates, deletes, extensions, ownershipChanges }
 		return [toHex(attribute.key), toHex(typeof attribute.value === "number" && attribute.value === 0 ? "" : attribute.value)];
 	}
 	const payload = [
-		(creates ?? []).map((item) => [
-			toHex(Math.ceil(item.expiresIn / BLOCK_TIME)),
-			toHex(item.contentType),
-			toHex(item.payload),
-			item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
-			item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
-		]),
-		(updates ?? []).map((item) => [
-			item.entityKey,
-			toHex(item.contentType),
-			toHex(Math.ceil(item.expiresIn / BLOCK_TIME)),
-			toHex(item.payload),
-			item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
-			item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
-		]),
+		(creates ?? []).map((item) => {
+			validateExpiresIn(item.expiresIn);
+			item.attributes.forEach(validateAttribute);
+			return [
+				toHex(item.expiresIn / BLOCK_TIME),
+				toHex(item.contentType),
+				toHex(item.payload),
+				item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
+				item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
+			];
+		}),
+		(updates ?? []).map((item) => {
+			validateExpiresIn(item.expiresIn);
+			item.attributes.forEach(validateAttribute);
+			return [
+				item.entityKey,
+				toHex(item.contentType),
+				toHex(item.expiresIn / BLOCK_TIME),
+				toHex(item.payload),
+				item.attributes.filter((attribute) => typeof attribute.value === "string").map(formatAttributes),
+				item.attributes.filter((attribute) => typeof attribute.value === "number").map(formatAttributes)
+			];
+		}),
 		(deletes ?? []).map((item) => item.entityKey),
-		(extensions ?? []).map((item) => [item.entityKey, toHex(Math.ceil(item.expiresIn / BLOCK_TIME))]),
+		(extensions ?? []).map((item) => {
+			validateExpiresIn(item.expiresIn);
+			return [item.entityKey, toHex(item.expiresIn / BLOCK_TIME)];
+		}),
 		(ownershipChanges ?? []).map((item) => [item.entityKey, item.newOwner])
 	];
 	logger$6("txData to send as RLP %o length %d", payload, payload.length);
@@ -534,5 +572,5 @@ function chainFromName(name) {
 }
 
 //#endregion
-export { EntityMutationError, NoCursorOrLimitError, NoEntityFoundError, NoMoreResultsError, chainFromName, createPublicClient, createWalletClient, jsonToPayload, stringToPayload };
+export { EntityMutationError, InvalidAttributeError, InvalidExpirationError, NoCursorOrLimitError, NoEntityFoundError, NoMoreResultsError, chainFromName, createPublicClient, createWalletClient, jsonToPayload, stringToPayload };
 //# sourceMappingURL=index.js.map