@arkiv-network/sdk 0.8.0-dev.1 → 0.8.0-dev.2

package/dist/{queryBuilder-BXDvX1K_.cjs → queryBuilder-zHGhDmaG.cjs}

@@ -1,5 +1,5 @@
-const require_attr = require('./attr-BvxHN99W.cjs');
-const require_flags = require('./flags-Ct8k0gpB.cjs');
+const require_attr = require('./attr-BXTkpnoc.cjs');
+const require_flags = require('./flags-DCD26uhe.cjs');
 const require_entity = require('./entity-B0t6sN7F.cjs');
 let viem = require("viem");
 
@@ -240,7 +240,7 @@ function toFlagsByte(value) {
 * | | `=` `!=` | `<` `<=` `>` `>=` | `STARTSWITH` |
 * | --- | --- | --- | --- |
 * | `bool` | yes | no | no |
-* | `i32` `u256` `dec` | yes | yes | no |
+* | `i32` `u64` `u256` `dec` | yes | yes | no |
 * | `str` | yes | no | yes |
 * | `addr` `key` `bytes32` | yes | no | no |
 */
@@ -490,7 +490,7 @@ function ne(name, value) {
 	return comparison(name, "!=", value);
 }
 /**
-* Attribute is greater than value. Ordered types only (`i32`, `u256`, `dec`).
+* Attribute is greater than value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
 *
 * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
 *
@@ -502,7 +502,7 @@ function gt(name, value) {
 	return comparison(name, ">", value);
 }
 /**
-* Attribute is greater than or equal to value. Ordered types only (`i32`, `u256`, `dec`).
+* Attribute is greater than or equal to value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
 *
 * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
 *
@@ -513,7 +513,7 @@ function gte(name, value) {
 	return comparison(name, ">=", value);
 }
 /**
-* Attribute is less than value. Ordered types only (`i32`, `u256`, `dec`).
+* Attribute is less than value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
 *
 * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
 *
@@ -524,7 +524,7 @@ function lt(name, value) {
 	return comparison(name, "<", value);
 }
 /**
-* Attribute is less than or equal to value. Ordered types only (`i32`, `u256`, `dec`).
+* Attribute is less than or equal to value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
 *
 * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
 *
@@ -541,7 +541,9 @@ function lte(name, value) {
 * `startsWith("name", "é")` matches only the same byte sequence, not another normal form of it.
 *
 * @param prefix - The prefix, as a bare string or a `str` value.
-* @throws {UnsupportedOperatorError} If given a value that is not a `str`.
+* @throws {InvalidPredicateError} If the name is not a queryable attribute.
+* @throws {UnsupportedOperatorError} If given a value that is not a `str`, or a system attribute
+* (none of which is a `str`).
 *
 * @example
 * startsWith("desc", "ab") // desc STARTSWITH str('ab')
@@ -580,7 +582,8 @@ function exists(name) {
 * Useful when the same name is written with different types across entities — a comparison already
 * asserts the type, so this is for asking about the type alone.
 *
-* @param tag - The type tag: `bool`, `i32`, `u256`, `dec`, `bytes32`, `str`, `addr` or `key`.
+* @param tag - The type tag: `bool`, `i32`, `u64`, `u256`, `dec`, `bytes32`, `str`, `addr` or
+* `key`.
 * @throws {InvalidPredicateError} If the tag is not a settable type, or the name is a system
 * attribute (whose type is fixed).
 *
@@ -590,7 +593,7 @@ function exists(name) {
 function hasType(name, tag) {
 	const system = resolveReference(name);
 	if (system !== void 0) throw new InvalidPredicateError(`"${name}" is always a ${system} — a system attribute has a fixed type, so TYPEOF(${name}) is a constant.`, name);
-	if (!isUserTypeTag(tag)) throw new InvalidPredicateError(`"${tag}" is not a settable attribute type. Use one of bool, i32, u256, dec, bytes32, str, addr, key.`, name);
+	if (!isUserTypeTag(tag)) throw new InvalidPredicateError(`"${tag}" is not a settable attribute type. Use one of bool, i32, u64, u256, dec, bytes32, str, addr, key.`, name);
 	return node({
 		kind: "typeOf",
 		name,

package/dist/{selection-BvK6yX0g.d.cts → selection-Bv8_o-7i.d.cts}

@@ -1,4 +1,4 @@
-import { C as ValueInput, G as StrValue, R as ArkivValue, Y as UserTypeTag, h as Attributes, m as AttributeSchema } from "./index-D8LZt-3J.cjs";
+import { C as ValueInput, G as StrValue, R as ArkivValue, Y as UserTypeTag, h as Attributes, m as AttributeSchema } from "./index-CIcHPx2j.cjs";
 import { n as ResolvedCreationFlags } from "./flags-0Vl5rrHq.cjs";
 import { Account, Chain, Client, Hex, RpcSchema, Transport } from "viem";
 
@@ -68,6 +68,7 @@ type RpcSelect = {
   attributeSchema?: boolean;
   attributes?: boolean | Record<string, boolean>;
 };
+/** The second parameter of `arkiv_query` — what to return, and where in the results to start. */
 type RpcQueryOptions = {
   /** Block height to read at, as a hex quantity. Defaults to the head, and must be within the node's retained range. */
   atBlock?: Hex;
@@ -163,6 +164,10 @@ declare class Entity implements EntityFields {
 }
 //#endregion
 //#region src/query/expression.d.ts
+/**
+ * The comparison operators the query language defines. `<` `<=` `>` `>=` need an ordered type —
+ * `i32`, `u64`, `u256` or `dec`; every type accepts `=` and `!=`.
+ */
 type ComparisonOperator = "=" | "!=" | "<" | "<=" | ">" | ">=";
 /** A comparison between an attribute and a typed literal. */
 type ComparisonNode = {
@@ -239,7 +244,7 @@ declare function eq(name: string, value: ValueInput): ComparisonNode;
  */
 declare function ne(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is greater than value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is greater than value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -249,7 +254,7 @@ declare function ne(name: string, value: ValueInput): ComparisonNode;
  */
 declare function gt(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is greater than or equal to value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is greater than or equal to value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -258,7 +263,7 @@ declare function gt(name: string, value: ValueInput): ComparisonNode;
  */
 declare function gte(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is less than value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is less than value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -267,7 +272,7 @@ declare function gte(name: string, value: ValueInput): ComparisonNode;
  */
 declare function lt(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is less than or equal to value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is less than or equal to value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -282,7 +287,9 @@ declare function lte(name: string, value: ValueInput): ComparisonNode;
  * `startsWith("name", "é")` matches only the same byte sequence, not another normal form of it.
  *
  * @param prefix - The prefix, as a bare string or a `str` value.
- * @throws {UnsupportedOperatorError} If given a value that is not a `str`.
+ * @throws {InvalidPredicateError} If the name is not a queryable attribute.
+ * @throws {UnsupportedOperatorError} If given a value that is not a `str`, or a system attribute
+ * (none of which is a `str`).
  *
  * @example
  * startsWith("desc", "ab") // desc STARTSWITH str('ab')
@@ -305,7 +312,8 @@ declare function exists(name: string): ExistsNode;
  * Useful when the same name is written with different types across entities — a comparison already
  * asserts the type, so this is for asking about the type alone.
  *
- * @param tag - The type tag: `bool`, `i32`, `u256`, `dec`, `bytes32`, `str`, `addr` or `key`.
+ * @param tag - The type tag: `bool`, `i32`, `u64`, `u256`, `dec`, `bytes32`, `str`, `addr` or
+ * `key`.
  * @throws {InvalidPredicateError} If the tag is not a settable type, or the name is a system
  * attribute (whose type is fixed).
  *
@@ -430,4 +438,4 @@ type FullEntity = ProjectedEntity<AllSelected>;
 declare function toRpcSelect(selection?: SelectArg): RpcSelect;
 //#endregion
 export { EntityFields as A, lte as C, render as D, or as E, RpcCreationFlags as F, RpcEntity as I, RpcQueryOptions as L, ArkivRpcSchema as M, RpcAttribute as N, startsWith as O, RpcAttributeSchemaEntry as P, RpcSelect as R, lt as S, not as T, eq as _, SelectionFields as a, gte as b, ComparisonNode as c, Expression as d, NotNode as f, and as g, TypeOfNode as h, SelectArg as i, ArkivClient as j, Entity as k, ComparisonOperator as l, StartsWithNode as m, FullEntity as n, toRpcSelect as o, OrNode as p, ProjectedEntity as r, AndNode as s, EntitySelection as t, ExistsNode as u, exists as v, ne as w, hasType as x, gt as y };
-//# sourceMappingURL=selection-BvK6yX0g.d.cts.map
+//# sourceMappingURL=selection-Bv8_o-7i.d.cts.map

package/dist/selection-Bv8_o-7i.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-Bv8_o-7i.d.cts","names":[],"sources":["../src/types/rpcSchema.ts","../src/clients/baseClient.ts","../src/types/entity.ts","../src/query/expression.ts","../src/query/selection.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/{selection-fpmI3ADQ.d.ts → selection-ox7zdtVm.d.ts}

@@ -1,4 +1,4 @@
-import { C as ValueInput, G as StrValue, R as ArkivValue, Y as UserTypeTag, h as Attributes, m as AttributeSchema } from "./index-DVYFaXNV.js";
+import { C as ValueInput, G as StrValue, R as ArkivValue, Y as UserTypeTag, h as Attributes, m as AttributeSchema } from "./index-Cd2aaWme.js";
 import { n as ResolvedCreationFlags } from "./flags-wmcMoAnN.js";
 import { Account, Chain, Client, Hex, RpcSchema, Transport } from "viem";
 
@@ -68,6 +68,7 @@ type RpcSelect = {
   attributeSchema?: boolean;
   attributes?: boolean | Record<string, boolean>;
 };
+/** The second parameter of `arkiv_query` — what to return, and where in the results to start. */
 type RpcQueryOptions = {
   /** Block height to read at, as a hex quantity. Defaults to the head, and must be within the node's retained range. */
   atBlock?: Hex;
@@ -163,6 +164,10 @@ declare class Entity implements EntityFields {
 }
 //#endregion
 //#region src/query/expression.d.ts
+/**
+ * The comparison operators the query language defines. `<` `<=` `>` `>=` need an ordered type —
+ * `i32`, `u64`, `u256` or `dec`; every type accepts `=` and `!=`.
+ */
 type ComparisonOperator = "=" | "!=" | "<" | "<=" | ">" | ">=";
 /** A comparison between an attribute and a typed literal. */
 type ComparisonNode = {
@@ -239,7 +244,7 @@ declare function eq(name: string, value: ValueInput): ComparisonNode;
  */
 declare function ne(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is greater than value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is greater than value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -249,7 +254,7 @@ declare function ne(name: string, value: ValueInput): ComparisonNode;
  */
 declare function gt(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is greater than or equal to value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is greater than or equal to value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -258,7 +263,7 @@ declare function gt(name: string, value: ValueInput): ComparisonNode;
  */
 declare function gte(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is less than value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is less than value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -267,7 +272,7 @@ declare function gte(name: string, value: ValueInput): ComparisonNode;
  */
 declare function lt(name: string, value: ValueInput): ComparisonNode;
 /**
- * Attribute is less than or equal to value. Ordered types only (`i32`, `u256`, `dec`).
+ * Attribute is less than or equal to value. Ordered types only (`i32`, `u64`, `u256`, `dec`).
  *
  * @throws {UnsupportedOperatorError} If the value's type carries no ordered index.
  *
@@ -282,7 +287,9 @@ declare function lte(name: string, value: ValueInput): ComparisonNode;
  * `startsWith("name", "é")` matches only the same byte sequence, not another normal form of it.
  *
  * @param prefix - The prefix, as a bare string or a `str` value.
- * @throws {UnsupportedOperatorError} If given a value that is not a `str`.
+ * @throws {InvalidPredicateError} If the name is not a queryable attribute.
+ * @throws {UnsupportedOperatorError} If given a value that is not a `str`, or a system attribute
+ * (none of which is a `str`).
  *
  * @example
  * startsWith("desc", "ab") // desc STARTSWITH str('ab')
@@ -305,7 +312,8 @@ declare function exists(name: string): ExistsNode;
  * Useful when the same name is written with different types across entities — a comparison already
  * asserts the type, so this is for asking about the type alone.
  *
- * @param tag - The type tag: `bool`, `i32`, `u256`, `dec`, `bytes32`, `str`, `addr` or `key`.
+ * @param tag - The type tag: `bool`, `i32`, `u64`, `u256`, `dec`, `bytes32`, `str`, `addr` or
+ * `key`.
  * @throws {InvalidPredicateError} If the tag is not a settable type, or the name is a system
  * attribute (whose type is fixed).
  *
@@ -430,4 +438,4 @@ type FullEntity = ProjectedEntity<AllSelected>;
 declare function toRpcSelect(selection?: SelectArg): RpcSelect;
 //#endregion
 export { EntityFields as A, lte as C, render as D, or as E, RpcCreationFlags as F, RpcEntity as I, RpcQueryOptions as L, ArkivRpcSchema as M, RpcAttribute as N, startsWith as O, RpcAttributeSchemaEntry as P, RpcSelect as R, lt as S, not as T, eq as _, SelectionFields as a, gte as b, ComparisonNode as c, Expression as d, NotNode as f, and as g, TypeOfNode as h, SelectArg as i, ArkivClient as j, Entity as k, ComparisonOperator as l, StartsWithNode as m, FullEntity as n, toRpcSelect as o, OrNode as p, ProjectedEntity as r, AndNode as s, EntitySelection as t, ExistsNode as u, exists as v, ne as w, hasType as x, gt as y };
-//# sourceMappingURL=selection-fpmI3ADQ.d.ts.map
+//# sourceMappingURL=selection-ox7zdtVm.d.ts.map

package/dist/selection-ox7zdtVm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-ox7zdtVm.d.ts","names":[],"sources":["../src/types/rpcSchema.ts","../src/clients/baseClient.ts","../src/types/entity.ts","../src/query/expression.ts","../src/query/selection.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/types/index.d.cts

@@ -1,7 +1,7 @@
-import "../index-D8LZt-3J.cjs";
-import "../index-D0CmtiWT.cjs";
+import "../index-CIcHPx2j.cjs";
+import "../index-BGp2plHs.cjs";
 import "../expiry-DRV29F1r.cjs";
 import "../flags-0Vl5rrHq.cjs";
-import { A as EntityFields, F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, k as Entity } from "../selection-BvK6yX0g.cjs";
-import { C as OwnershipTransferredEvent, D as PredictEntityKeysReturnType, E as PredictEntityKeysParameters, O as PredictedEntityKey, S as ExpiryExtendedEvent, T as QueryReturnType, _ as EntityCreatedEvent, a as MutateEntitiesParameters, b as EntityEventContext, c as PatchEntityReturnType, d as DeleteEntityParameters, f as DeleteEntityReturnType, g as WatchEntityEventsParameters, h as GetBlockTimingReturnType, i as MimeType, l as ExtendEntityParameters, m as CreateEntityReturnType, n as ChangeOwnershipReturnType, o as MutateEntitiesReturnType, p as CreateEntityParameters, r as TxParams, s as PatchEntityParameters, t as ChangeOwnershipParameters, u as ExtendEntityReturnType, v as EntityDeletedEvent, w as QueryOptions, x as EntityPatchedEvent, y as EntityEvent } from "../changeOwnership-B7bEgla4.cjs";
-export { ArkivRpcSchema, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityCreatedEvent, EntityDeletedEvent, EntityEvent, EntityEventContext, EntityFields, EntityPatchedEvent, ExpiryExtendedEvent, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, OwnershipTransferredEvent, PatchEntityParameters, PatchEntityReturnType, PredictEntityKeysParameters, PredictEntityKeysReturnType, PredictedEntityKey, QueryOptions, QueryReturnType, RpcAttribute, RpcAttributeSchemaEntry, RpcCreationFlags, RpcEntity, RpcQueryOptions, RpcSelect, TxParams, WatchEntityEventsParameters };
+import { A as EntityFields, F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, k as Entity } from "../selection-Bv8_o-7i.cjs";
+import { C as QueryOptions, D as PredictedEntityKey, E as PredictEntityKeysReturnType, O as GetBlockTimingReturnType, S as OwnershipTransferredEvent, T as PredictEntityKeysParameters, _ as EntityDeletedEvent, a as ExecuteBatchParameters, b as EntityPatchedEvent, c as PatchEntityReturnType, d as DeleteEntityParameters, f as DeleteEntityReturnType, g as EntityCreatedEvent, h as WatchEntityEventsParameters, i as MimeType, l as ExtendEntityParameters, m as CreateEntityReturnType, n as ChangeOwnershipReturnType, o as ExecuteBatchReturnType, p as CreateEntityParameters, r as TxParams, s as PatchEntityParameters, t as ChangeOwnershipParameters, u as ExtendEntityReturnType, v as EntityEvent, w as QueryReturnType, x as ExpiryExtendedEvent, y as EntityEventContext } from "../changeOwnership-BofkLnXJ.cjs";
+export { ArkivRpcSchema, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityCreatedEvent, EntityDeletedEvent, EntityEvent, EntityEventContext, EntityFields, EntityPatchedEvent, ExecuteBatchParameters, ExecuteBatchReturnType, ExpiryExtendedEvent, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, OwnershipTransferredEvent, PatchEntityParameters, PatchEntityReturnType, PredictEntityKeysParameters, PredictEntityKeysReturnType, PredictedEntityKey, QueryOptions, QueryReturnType, RpcAttribute, RpcAttributeSchemaEntry, RpcCreationFlags, RpcEntity, RpcQueryOptions, RpcSelect, TxParams, WatchEntityEventsParameters };

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
-import "../index-DVYFaXNV.js";
-import "../index-ClgIuxJ8.js";
+import "../index-Cd2aaWme.js";
+import "../index-ezMZ2-JH.js";
 import "../expiry-BxOlvVWC.js";
 import "../flags-wmcMoAnN.js";
-import { A as EntityFields, F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, k as Entity } from "../selection-fpmI3ADQ.js";
-import { C as OwnershipTransferredEvent, D as PredictEntityKeysReturnType, E as PredictEntityKeysParameters, O as PredictedEntityKey, S as ExpiryExtendedEvent, T as QueryReturnType, _ as EntityCreatedEvent, a as MutateEntitiesParameters, b as EntityEventContext, c as PatchEntityReturnType, d as DeleteEntityParameters, f as DeleteEntityReturnType, g as WatchEntityEventsParameters, h as GetBlockTimingReturnType, i as MimeType, l as ExtendEntityParameters, m as CreateEntityReturnType, n as ChangeOwnershipReturnType, o as MutateEntitiesReturnType, p as CreateEntityParameters, r as TxParams, s as PatchEntityParameters, t as ChangeOwnershipParameters, u as ExtendEntityReturnType, v as EntityDeletedEvent, w as QueryOptions, x as EntityPatchedEvent, y as EntityEvent } from "../changeOwnership-DwgtdSFc.js";
-export { ArkivRpcSchema, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityCreatedEvent, EntityDeletedEvent, EntityEvent, EntityEventContext, EntityFields, EntityPatchedEvent, ExpiryExtendedEvent, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, MutateEntitiesParameters, MutateEntitiesReturnType, OwnershipTransferredEvent, PatchEntityParameters, PatchEntityReturnType, PredictEntityKeysParameters, PredictEntityKeysReturnType, PredictedEntityKey, QueryOptions, QueryReturnType, RpcAttribute, RpcAttributeSchemaEntry, RpcCreationFlags, RpcEntity, RpcQueryOptions, RpcSelect, TxParams, WatchEntityEventsParameters };
+import { A as EntityFields, F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, k as Entity } from "../selection-ox7zdtVm.js";
+import { C as QueryOptions, D as PredictedEntityKey, E as PredictEntityKeysReturnType, O as GetBlockTimingReturnType, S as OwnershipTransferredEvent, T as PredictEntityKeysParameters, _ as EntityDeletedEvent, a as ExecuteBatchParameters, b as EntityPatchedEvent, c as PatchEntityReturnType, d as DeleteEntityParameters, f as DeleteEntityReturnType, g as EntityCreatedEvent, h as WatchEntityEventsParameters, i as MimeType, l as ExtendEntityParameters, m as CreateEntityReturnType, n as ChangeOwnershipReturnType, o as ExecuteBatchReturnType, p as CreateEntityParameters, r as TxParams, s as PatchEntityParameters, t as ChangeOwnershipParameters, u as ExtendEntityReturnType, v as EntityEvent, w as QueryReturnType, x as ExpiryExtendedEvent, y as EntityEventContext } from "../changeOwnership-B0ar96ub.js";
+export { ArkivRpcSchema, ChangeOwnershipParameters, ChangeOwnershipReturnType, CreateEntityParameters, CreateEntityReturnType, DeleteEntityParameters, DeleteEntityReturnType, Entity, EntityCreatedEvent, EntityDeletedEvent, EntityEvent, EntityEventContext, EntityFields, EntityPatchedEvent, ExecuteBatchParameters, ExecuteBatchReturnType, ExpiryExtendedEvent, ExtendEntityParameters, ExtendEntityReturnType, GetBlockTimingReturnType, MimeType, OwnershipTransferredEvent, PatchEntityParameters, PatchEntityReturnType, PredictEntityKeysParameters, PredictEntityKeysReturnType, PredictedEntityKey, QueryOptions, QueryReturnType, RpcAttribute, RpcAttributeSchemaEntry, RpcCreationFlags, RpcEntity, RpcQueryOptions, RpcSelect, TxParams, WatchEntityEventsParameters };

package/dist/utils/index.cjs

@@ -1,6 +1,6 @@
-require('../errors-D-eJkGVc.cjs');
-require('../expiry-BUYIXTGb.cjs');
-const require_payload = require('../payload-Bnw1hrvb.cjs');
+require('../errors-DhV00966.cjs');
+require('../expiry-CG9GhVXv.cjs');
+const require_payload = require('../payload-DqFweqiO.cjs');
 
 exports.ExpirationTime = require_payload.ExpirationTime;
 exports.jsonToPayload = require_payload.jsonToPayload;

package/dist/utils/index.d.cts

@@ -1,3 +1,3 @@
 import "../expiry-DRV29F1r.cjs";
-import { i as ExpirationTime, n as stringToPayload, r as DeadlineOptions, t as jsonToPayload } from "../payload-P0nWyjLg.cjs";
+import { i as ExpirationTime, n as stringToPayload, r as DeadlineOptions, t as jsonToPayload } from "../payload-Dfu30njp.cjs";
 export { DeadlineOptions, ExpirationTime, jsonToPayload, stringToPayload };

package/dist/utils/index.d.ts

@@ -1,3 +1,3 @@
 import "../expiry-BxOlvVWC.js";
-import { i as ExpirationTime, n as stringToPayload, r as DeadlineOptions, t as jsonToPayload } from "../payload-Dgx3PQeK.js";
+import { i as ExpirationTime, n as stringToPayload, r as DeadlineOptions, t as jsonToPayload } from "../payload-CGvVPZQX.js";
 export { DeadlineOptions, ExpirationTime, jsonToPayload, stringToPayload };

package/dist/utils/index.js

@@ -1,5 +1,5 @@
-import "../errors-DGB8AgT2.js";
-import "../expiry-DGRzrSan.js";
-import { n as stringToPayload, r as ExpirationTime, t as jsonToPayload } from "../payload-CIxSn_DW.js";
+import "../errors-D2E1GRjw.js";
+import "../expiry-Cgdb_dbq.js";
+import { n as stringToPayload, r as ExpirationTime, t as jsonToPayload } from "../payload-DE7wMztL.js";
 
 export { ExpirationTime, jsonToPayload, stringToPayload };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkiv-network/sdk",
-  "version": "0.8.0-dev.1",
+  "version": "0.8.0-dev.2",
   "description": "TypeScript client library for Arkiv's blockchains interactions",
   "type": "module",
   "target": "esnext",
@@ -85,8 +85,6 @@
     "lint": "biome check src/",
     "lint:fix": "biome check --write src/",
     "test:unit": "bun test src/**/*",
-    "docs": "bunx typedoc --plugin typedoc-plugin-markdown",
-    "docs:verify": "bunx typedoc --emit none --plugin typedoc-plugin-markdown",
     "package": "rimraf arkiv-network-sdk-*.tgz && bun run build && bun pm pack --no-cache",
     "package:test": "bun run package && mv arkiv-network-sdk-*.tgz arkiv-network-sdk-latest.tgz",
     "prepublishOnly": "bun run build && bun run package && mv arkiv-network-sdk-*.tgz arkiv-network-sdk-latest.tgz",
@@ -102,8 +100,6 @@
     "@types/bun": "latest",
     "rimraf": "^6.0.1",
     "tsdown": "^0.16.0",
-    "typedoc": "^0.28.14",
-    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.2",
     "viem": "^2.38.2"
   },

package/src/actions/public/getEntity.ts

@@ -5,6 +5,7 @@ import { NoEntityFoundError } from "../../errors"
 import { runQuery } from "../../query/engine"
 import { eq } from "../../query/expression"
 import { type FullEntity, toRpcSelect } from "../../query/selection"
+import type { Entity } from "../../types/entity"
 
 /**
  * Reads one entity by key, with every field selected.

package/src/actions/public/predictEntityKeys.test.ts

@@ -2,7 +2,7 @@ import { describe, expect, it, vi } from "bun:test"
 import { encodeFunctionResult, type Hex } from "viem"
 import type { ArkivClient } from "../../clients/baseClient"
 import { ARKIV_ADDRESS } from "../../consts"
-import { predictEntityKey } from "../../entity/key"
+import { NO_SALT, predictEntityKey } from "../../entity/key"
 import { ENTITY_NONCE_ABI } from "../../entity/operations"
 import { getEntityNonce } from "./getEntityNonce"
 import { predictEntityKeys } from "./predictEntityKeys"
@@ -105,6 +105,22 @@ describe("predictEntityKeys", () => {
     )
   })
 
+  it("takes NO_SALT in a slot, and pairs the key with the zero it resolves to", async () => {
+    const { client } = makeClient(4n)
+    const [first, second] = await predictEntityKeys(client, {
+      owner: OWNER,
+      salts: [NO_SALT, 5n],
+    })
+    expect(first).toEqual({
+      salt: 0n,
+      key: predictEntityKey({ owner: OWNER, nonce: 4n, salt: 0n, chainId: CHAIN_ID }),
+    })
+    expect(second).toEqual({
+      salt: 5n,
+      key: predictEntityKey({ owner: OWNER, nonce: 5n, salt: 5n, chainId: CHAIN_ID }),
+    })
+  })
+
   it("prefers the salts it was given over the count", async () => {
     const { client } = makeClient(0n)
     const pairs = await predictEntityKeys(client, { owner: OWNER, count: 5, salts: [9n] })

package/src/actions/public/predictEntityKeys.ts

@@ -1,7 +1,13 @@
 import type { Address, Hex } from "viem"
 import { getChainId } from "viem/actions"
 import type { ArkivClient } from "../../clients/baseClient"
-import { predictEntityKey, randomSalt, validateSalt } from "../../entity/key"
+import {
+  NO_SALT,
+  predictEntityKey,
+  randomSalt,
+  resolveSalt,
+  type SaltInput,
+} from "../../entity/key"
 import { getEntityNonce } from "./getEntityNonce"
 
 /**
@@ -13,14 +19,18 @@ import { getEntityNonce } from "./getEntityNonce"
 export type PredictedEntityKey = {
   /** The key the create will be given. */
   key: Hex
-  /** The salt the create must carry for its key to come out as {@link PredictedEntityKey.key}. */
+  /**
+   * The salt the create must carry for its key to come out as {@link PredictedEntityKey.key}.
+   * Always a plain `uint128` — a requested {@link NO_SALT} comes back as the `0n` it resolves to,
+   * which a create accepts just the same.
+   */
   salt: bigint
 }
 
-/** Parameters for {@link predictEntityKeys}. */
+/** Parameters for `client.predictEntityKeys`. */
 export type PredictEntityKeysParameters<
   TCount extends number = number,
-  TSalts extends readonly bigint[] | undefined = readonly bigint[] | undefined,
+  TSalts extends readonly SaltInput[] | undefined = readonly SaltInput[] | undefined,
 > = {
   /** The account that will sign the creates. Its nonce is what the keys are derived from. */
   owner: Address
@@ -34,7 +44,8 @@ export type PredictEntityKeysParameters<
   count?: TCount | undefined
   /**
    * The salt each create will carry, in batch order. Defaults to `count` fresh random salts —
-   * either way each key comes back paired with the salt that mints it.
+   * either way each key comes back paired with the salt that mints it. Pass {@link NO_SALT} in a
+   * slot whose create opts out of salting.
    */
   salts?: TSalts
 }
@@ -46,13 +57,13 @@ export type PredictEntityKeysParameters<
  * tuple, gives a fixed-length tuple; a count computed at runtime gives a plain array.
  *
  * `TSalts` is wrapped in a tuple to stop the conditional distributing over it. Left naked, the
- * `readonly bigint[] | undefined` default would take both branches and union a tuple with an array,
- * which widens the length straight back to `number`.
+ * `readonly SaltInput[] | undefined` default would take both branches and union a tuple with an
+ * array, which widens the length straight back to `number`.
  */
 export type PredictEntityKeysReturnType<
   TCount extends number = number,
-  TSalts extends readonly bigint[] | undefined = readonly bigint[] | undefined,
-> = [TSalts] extends [readonly bigint[]]
+  TSalts extends readonly SaltInput[] | undefined = readonly SaltInput[] | undefined,
+> = [TSalts] extends [readonly SaltInput[]]
   ? { -readonly [Index in keyof TSalts]: PredictedEntityKey }
   : Repeat<PredictedEntityKey, TCount>
 
@@ -79,7 +90,7 @@ type Repeat<T, TLength extends number, TAcc extends T[] = []> = number extends T
  *
  * The prediction is valid only while nothing else from this owner is in flight. Every create that
  * lands first takes the nonce with it and moves these keys. For a key you can rely on
- * unconditionally, read it back from the create instead — `createEntity` and `mutateEntities`
+ * unconditionally, read it back from the create instead — `createEntity` and `executeBatch`
  * report the keys the engine actually minted.
  *
  * @param parameters - Owner, and either a count or the salts. {@link PredictEntityKeysParameters}
@@ -89,7 +100,7 @@ type Repeat<T, TLength extends number, TAcc extends T[] = []> = number extends T
  * import { key } from "@arkiv-network/sdk/attr"
  *
  * const [parent, child] = await client.predictEntityKeys({ owner: account.address, count: 2 })
- * await wallet.mutateEntities({
+ * await client.executeBatch({
  *   creates: [
  *     { payload, contentType, expires, salt: parent.salt },
  *     {
@@ -104,7 +115,7 @@ type Repeat<T, TLength extends number, TAcc extends T[] = []> = number extends T
  */
 export async function predictEntityKeys<
   const TCount extends number = number,
-  const TSalts extends readonly bigint[] | undefined = undefined,
+  const TSalts extends readonly SaltInput[] | undefined = undefined,
 >(
   client: ArkivClient,
   { owner, count, salts }: PredictEntityKeysParameters<TCount, TSalts>,
@@ -121,12 +132,15 @@ export async function predictEntityKeys<
 }
 
 /** The salts to derive from: the ones given, or `count` fresh random ones. */
-function resolveSalts(count: number | undefined, salts: readonly bigint[] | undefined): bigint[] {
+function resolveSalts(
+  count: number | undefined,
+  salts: readonly SaltInput[] | undefined,
+): bigint[] {
   if (salts !== undefined) {
     if (salts.length === 0) {
       throw new Error("predictEntityKeys: `salts` is empty — there is nothing to predict")
     }
-    return salts.map(validateSalt)
+    return salts.map(resolveSalt)
   }
   if (count === undefined) {
     throw new Error("predictEntityKeys: pass either `count` or `salts`")

package/src/actions/wallet/createEntity.ts

@@ -1,10 +1,11 @@
 import type { Hash, Hex } from "viem"
 import type { AttributeInputs } from "../../attr"
 import type { ArkivClient } from "../../clients/baseClient"
-import type { CreationFlags, Expiry } from "../../entity"
+import type { CreationFlags, Expiry, NO_SALT, SaltInput } from "../../entity"
 import { EntityMutationError } from "../../errors"
 import type { MimeType, TxParams } from "../../types"
 import { sendArkivTransaction } from "../../utils/arkivTransactions"
+import type { ExpirationTime } from "../../utils/expirationTime"
 import { getLogger } from "../../utils/logger"
 
 const logger = getLogger("actions:wallet:create-entity")
@@ -66,8 +67,8 @@ export type CreateEntityParameters = {
   contentType: MimeType | (string & {})
   /**
    * The entity's queryable attributes, keyed by name. Values are the tagged constructors from
-   * `@arkiv-network/sdk/attr` — `i32`, `u256`, `dec`, `str`, `addr`, `key`, `bytes32`, `bool` — or
-   * a bare `boolean`, `number`, `bigint` or `string` where the type is unambiguous.
+   * `@arkiv-network/sdk/attr` — `i32`, `u64`, `u256`, `dec`, `str`, `addr`, `key`, `bytes32`,
+   * `bool` — or a bare `boolean`, `number`, `bigint` or `string` where the type is unambiguous.
    *
    * @throws {InvalidAttributeNameError} If a name violates the attribute-name grammar.
    * @throws {InvalidValueError} If a value does not fit the type it names or defaults to.
@@ -82,10 +83,10 @@ export type CreateEntityParameters = {
    * The salt mixed into the entity key. Defaults to 128 random bits, which makes the key
    * unpredictable to everyone but the creator.
    *
-   * Pass `0n` for a key derived from the owner and nonce alone — predictable by anyone, which is
-   * what you want only when a third party must be able to compute the key in advance.
+   * Pass {@link NO_SALT} for a key derived from the owner and nonce alone — predictable by anyone,
+   * which is what you want only when a third party must be able to compute the key in advance.
    */
-  salt?: bigint | undefined
+  salt?: SaltInput | undefined
 }
 
 /**

package/src/actions/wallet/{mutateEntities.test.ts → executeBatch.test.ts}

@@ -1,6 +1,6 @@
 import { describe, expect, it, vi } from "bun:test"
 import type { ArkivClient } from "../../clients/baseClient"
-import { mutateEntities } from "./mutateEntities"
+import { executeBatch } from "./executeBatch"
 
 const ENTITY_KEY = `0x${"ab".repeat(32)}` as const
 const NEW_OWNER = "0x2222222222222222222222222222222222222222"
@@ -29,7 +29,7 @@ describe("the empty-batch guard", () => {
     // An ownership-only batch is a batch: it used to be rejected because the guard listed
     // creates/updates/deletes/extensions and forgot ownershipChanges.
     const { client, writeContract } = makeClient()
-    const result = await mutateEntities(client, {
+    const result = await executeBatch(client, {
       ownershipChanges: [{ entityKey: ENTITY_KEY, newOwner: NEW_OWNER }],
     })
     expect(writeContract).toHaveBeenCalledTimes(1)
@@ -38,9 +38,9 @@ describe("the empty-batch guard", () => {
 
   it("rejects a batch with nothing in it", async () => {
     const { client, writeContract } = makeClient()
-    await expect(mutateEntities(client, {})).rejects.toThrow(/No operations/)
+    await expect(executeBatch(client, {})).rejects.toThrow(/No operations/)
     // Present but empty is just as empty — the engine would revert with EmptyBatch().
-    await expect(mutateEntities(client, { deletes: [], ownershipChanges: [] })).rejects.toThrow(
+    await expect(executeBatch(client, { deletes: [], ownershipChanges: [] })).rejects.toThrow(
       /No operations/,
     )
     expect(writeContract).not.toHaveBeenCalled()
@@ -52,10 +52,10 @@ describe("the empty-batch guard", () => {
     // keys would score this batch as non-empty and then drop it on the way to the wire, sending
     // execute([]) — so the guard counts the five kinds that actually reach the transaction.
     const stale = { updates: [{ entityKey: ENTITY_KEY, set: { level: 1 } }] } as never
-    await expect(mutateEntities(client, stale)).rejects.toThrow(/No operations/)
+    await expect(executeBatch(client, stale)).rejects.toThrow(/No operations/)
     // A typo is the same mistake with a different name.
     await expect(
-      mutateEntities(client, { delete: [{ entityKey: ENTITY_KEY }] } as never),
+      executeBatch(client, { delete: [{ entityKey: ENTITY_KEY }] } as never),
     ).rejects.toThrow(/No operations/)
     expect(writeContract).not.toHaveBeenCalled()
   })
@@ -65,7 +65,7 @@ describe("the empty-batch guard", () => {
     // The dangerous shape: the creates apply and the transaction succeeds, so nothing surfaces the
     // fact that the `updates` never happened. The guard cannot catch this one — only the caller's
     // types can — but the result must at least not claim they did.
-    const result = await mutateEntities(client, {
+    const result = await executeBatch(client, {
       deletes: [{ entityKey: ENTITY_KEY }],
       updates: [{ entityKey: ENTITY_KEY, set: { level: 1 } }],
     } as never)