@arkiv-network/sdk 0.8.0-advanced.2 → 0.8.0-advanced.3

package/dist/{selection-DPg0uyJf.d.cts → selection-C6KeWJ7g.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-CV5zCdpa.cjs";
+import { C as ValueInput, G as StrValue, R as ArkivValue, Y as UserTypeTag, h as Attributes, m as AttributeSchema } from "./index-NbfnXxgr.cjs";
 import { n as ResolvedCreationFlags } from "./flags-CRjPpoh3.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;
@@ -105,6 +106,10 @@ type ArkivRpcSchema = [{
 type ArkivClient<transport extends Transport = Transport, chain extends Chain | undefined = Chain | undefined, accountOrAddress extends Account | undefined = Account | undefined, rpcSchema extends RpcSchema | undefined = ArkivRpcSchema> = Client<transport, chain, accountOrAddress, rpcSchema>;
 //#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 = {
@@ -181,7 +186,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.
  *
@@ -191,7 +196,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.
  *
@@ -200,7 +205,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.
  *
@@ -209,7 +214,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.
  *
@@ -224,7 +229,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')
@@ -247,7 +254,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 { startsWith as A, hasType as C, not as D, ne as E, RpcCreationFlags as F, RpcEntity as I, RpcQueryOptions as L, ArkivRpcSchema as M, RpcAttribute as N, or as O, RpcAttributeSchemaEntry as P, RpcSelect as R, gte as S, lte as T, TypeOfNode as _, SelectionFields as a, exists as b, EntityFields as c, ComparisonOperator as d, ExistsNode as f, StartsWithNode as g, OrNode as h, SelectArg as i, ArkivClient as j, render as k, AndNode as l, NotNode as m, FullEntity as n, toRpcSelect as o, Expression as p, ProjectedEntity as r, Entity as s, EntitySelection as t, ComparisonNode as u, and as v, lt as w, gt as x, eq as y };
-//# sourceMappingURL=selection-DPg0uyJf.d.cts.map
+//# sourceMappingURL=selection-C6KeWJ7g.d.cts.map

package/dist/selection-C6KeWJ7g.d.cts.map

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

package/dist/{selection-C4UhsMOO.d.ts → selection-mjiiAGDO.d.ts}

@@ -1,5 +1,5 @@
-import { m as UserTypeTag, r as ArkivValue, u as StrValue } from "./codec-Car3KkFF.js";
-import { C as ValueInput, h as Attributes, m as AttributeSchema } from "./index-DvYvrkdk.js";
+import { m as UserTypeTag, r as ArkivValue, u as StrValue } from "./codec-M74UR1_0.js";
+import { C as ValueInput, h as Attributes, m as AttributeSchema } from "./index-D0IzFwMX.js";
 import { n as ResolvedCreationFlags } from "./flags-5dTNRnow.js";
 import { Account, Chain, Client, Hex, RpcSchema, Transport } from "viem";
 
@@ -69,6 +69,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;
@@ -106,6 +107,10 @@ type ArkivRpcSchema = [{
 type ArkivClient<transport extends Transport = Transport, chain extends Chain | undefined = Chain | undefined, accountOrAddress extends Account | undefined = Account | undefined, rpcSchema extends RpcSchema | undefined = ArkivRpcSchema> = Client<transport, chain, accountOrAddress, rpcSchema>;
 //#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 = {
@@ -182,7 +187,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.
  *
@@ -192,7 +197,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.
  *
@@ -201,7 +206,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.
  *
@@ -210,7 +215,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.
  *
@@ -225,7 +230,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')
@@ -248,7 +255,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).
  *
@@ -431,4 +439,4 @@ type FullEntity = ProjectedEntity<AllSelected>;
 declare function toRpcSelect(selection?: SelectArg): RpcSelect;
 //#endregion
 export { startsWith as A, hasType as C, not as D, ne as E, RpcCreationFlags as F, RpcEntity as I, RpcQueryOptions as L, ArkivRpcSchema as M, RpcAttribute as N, or as O, RpcAttributeSchemaEntry as P, RpcSelect as R, gte as S, lte as T, TypeOfNode as _, SelectionFields as a, exists as b, EntityFields as c, ComparisonOperator as d, ExistsNode as f, StartsWithNode as g, OrNode as h, SelectArg as i, ArkivClient as j, render as k, AndNode as l, NotNode as m, FullEntity as n, toRpcSelect as o, Expression as p, ProjectedEntity as r, Entity as s, EntitySelection as t, ComparisonNode as u, and as v, lt as w, gt as x, eq as y };
-//# sourceMappingURL=selection-C4UhsMOO.d.ts.map
+//# sourceMappingURL=selection-mjiiAGDO.d.ts.map

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

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

package/dist/types/index.d.cts

@@ -1,7 +1,7 @@
-import { F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, c as EntityFields, s as Entity } from "../selection-DPg0uyJf.cjs";
-import "../index-CV5zCdpa.cjs";
+import { F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, c as EntityFields, s as Entity } from "../selection-C6KeWJ7g.cjs";
+import "../index-NbfnXxgr.cjs";
 import "../expiry-DRV29F1r.cjs";
-import "../index-CA4V7Pdh.cjs";
-import { A as PredictEntityKeysParameters, C as EntityEvent, D as OwnershipTransferredEvent, E as ExpiryExtendedEvent, M as PredictedEntityKey, N as GetBlockTimingReturnType, O as QueryOptions, S as EntityDeletedEvent, T as EntityPatchedEvent, _ as DeleteEntityReturnType, b as WatchEntityEventsParameters, c as TxParams, d as PatchEntityReturnType, f as MutateEntitiesParameters, g as DeleteEntityParameters, h as ExtendEntityReturnType, j as PredictEntityKeysReturnType, k as QueryReturnType, l as MimeType, m as ExtendEntityParameters, o as ChangeOwnershipParameters, p as MutateEntitiesReturnType, s as ChangeOwnershipReturnType, u as PatchEntityParameters, v as CreateEntityParameters, w as EntityEventContext, x as EntityCreatedEvent, y as CreateEntityReturnType } from "../arkivTransactions-D74gERHG.cjs";
+import "../index-DZxwz2Ky.cjs";
+import { A as PredictEntityKeysParameters, C as EntityEvent, D as OwnershipTransferredEvent, E as ExpiryExtendedEvent, M as PredictedEntityKey, N as GetBlockTimingReturnType, O as QueryOptions, S as EntityDeletedEvent, T as EntityPatchedEvent, _ as DeleteEntityReturnType, b as WatchEntityEventsParameters, c as TxParams, d as PatchEntityReturnType, f as ExtendEntityParameters, g as DeleteEntityParameters, h as ExecuteBatchReturnType, j as PredictEntityKeysReturnType, k as QueryReturnType, l as MimeType, m as ExecuteBatchParameters, o as ChangeOwnershipParameters, p as ExtendEntityReturnType, s as ChangeOwnershipReturnType, u as PatchEntityParameters, v as CreateEntityParameters, w as EntityEventContext, x as EntityCreatedEvent, y as CreateEntityReturnType } from "../arkivTransactions-BpARZOsH.cjs";
 import "../flags-CRjPpoh3.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 };
+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,8 +1,8 @@
-import { F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, c as EntityFields, s as Entity } from "../selection-C4UhsMOO.js";
-import "../codec-Car3KkFF.js";
+import { F as RpcCreationFlags, I as RpcEntity, L as RpcQueryOptions, M as ArkivRpcSchema, N as RpcAttribute, P as RpcAttributeSchemaEntry, R as RpcSelect, c as EntityFields, s as Entity } from "../selection-mjiiAGDO.js";
+import "../codec-M74UR1_0.js";
 import "../expiry-nDbCgZX4.js";
-import "../index-fX_XyqLp.js";
-import { A as PredictEntityKeysParameters, C as EntityEvent, D as OwnershipTransferredEvent, E as ExpiryExtendedEvent, M as PredictedEntityKey, N as GetBlockTimingReturnType, O as QueryOptions, S as EntityDeletedEvent, T as EntityPatchedEvent, _ as DeleteEntityReturnType, b as WatchEntityEventsParameters, c as TxParams, d as PatchEntityReturnType, f as MutateEntitiesParameters, g as DeleteEntityParameters, h as ExtendEntityReturnType, j as PredictEntityKeysReturnType, k as QueryReturnType, l as MimeType, m as ExtendEntityParameters, o as ChangeOwnershipParameters, p as MutateEntitiesReturnType, s as ChangeOwnershipReturnType, u as PatchEntityParameters, v as CreateEntityParameters, w as EntityEventContext, x as EntityCreatedEvent, y as CreateEntityReturnType } from "../arkivTransactions-NtGD6uk5.js";
-import "../index-DvYvrkdk.js";
+import "../index-JP31fjyM.js";
+import { A as PredictEntityKeysParameters, C as EntityEvent, D as OwnershipTransferredEvent, E as ExpiryExtendedEvent, M as PredictedEntityKey, N as GetBlockTimingReturnType, O as QueryOptions, S as EntityDeletedEvent, T as EntityPatchedEvent, _ as DeleteEntityReturnType, b as WatchEntityEventsParameters, c as TxParams, d as PatchEntityReturnType, f as ExtendEntityParameters, g as DeleteEntityParameters, h as ExecuteBatchReturnType, j as PredictEntityKeysReturnType, k as QueryReturnType, l as MimeType, m as ExecuteBatchParameters, o as ChangeOwnershipParameters, p as ExtendEntityReturnType, s as ChangeOwnershipReturnType, u as PatchEntityParameters, v as CreateEntityParameters, w as EntityEventContext, x as EntityCreatedEvent, y as CreateEntityReturnType } from "../arkivTransactions-DfZ_yVDD.js";
+import "../index-D0IzFwMX.js";
 import "../flags-5dTNRnow.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 };
+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('../expiry-BELY2Kpw.cjs');
-require('../errors-BVbjKVMN.cjs');
-const require_payload = require('../payload-KC14SDlN.cjs');
+require('../expiry-xr6mx4f7.cjs');
+require('../errors-51znTSB1.cjs');
+const require_payload = require('../payload-Cvrir3Q-.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-BNoud2KZ.cjs";
+import { i as ExpirationTime, n as stringToPayload, r as DeadlineOptions, t as jsonToPayload } from "../payload-hluX1rc0.cjs";
 export { DeadlineOptions, ExpirationTime, jsonToPayload, stringToPayload };

package/dist/utils/index.d.ts

@@ -1,3 +1,3 @@
 import "../expiry-nDbCgZX4.js";
-import { i as ExpirationTime, n as stringToPayload, r as DeadlineOptions, t as jsonToPayload } from "../payload-CcUj85ys.js";
+import { i as ExpirationTime, n as stringToPayload, r as DeadlineOptions, t as jsonToPayload } from "../payload-D53ms-Mg.js";
 export { DeadlineOptions, ExpirationTime, jsonToPayload, stringToPayload };

package/dist/utils/index.js

@@ -1,5 +1,5 @@
-import "../expiry-BjpxZZQU.js";
-import "../errors-LTe7bOYS.js";
-import { n as stringToPayload, r as ExpirationTime, t as jsonToPayload } from "../payload-Bz6651ax.js";
+import "../expiry-CZErShX6.js";
+import "../errors-CwPJ16bn.js";
+import { n as stringToPayload, r as ExpirationTime, t as jsonToPayload } from "../payload-DaPzUvEh.js";
 
 export { ExpirationTime, jsonToPayload, stringToPayload };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkiv-network/sdk",
-  "version": "0.8.0-advanced.2",
+  "version": "0.8.0-advanced.3",
   "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/advanced/index.ts

@@ -1,7 +1,7 @@
 /**
  * The advanced path: send, ping and read results as separate, single-RPC-call steps.
  *
- * The everyday actions (`createEntity`, `mutateEntities`, …) bundle send + wait + decode into one
+ * The everyday actions (`createEntity`, `executeBatch`, …) bundle send + wait + decode into one
  * call, which is convenient and spends several RPC requests. These actions unbundle that so a
  * caller can hit the theoretical minimum:
  *

package/src/actions/advanced/sendMutation.ts

@@ -31,7 +31,7 @@ export type SendMutationReturnType = {
 /**
  * Signs and sends a mutation batch, returning as soon as the transaction is submitted.
  *
- * The fire-and-forget half of the advanced path. Unlike `mutateEntities`, this does **not** wait
+ * The fire-and-forget half of the advanced path. Unlike `executeBatch`, this does **not** wait
  * for a receipt, does not poll, and runs no revert diagnosis — it spends only what submitting
  * costs. With `options.currentBlock` and full `txParams` (nonce, gas, fees) that is exactly one
  * RPC call; each omitted piece adds only the lookup viem needs to fill it.

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)

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

@@ -4,19 +4,19 @@ import type { TxParams } from "../../types"
 import { type EntityMutationOps, sendArkivTransaction } from "../../utils/arkivTransactions"
 import { getLogger } from "../../utils/logger"
 
-const logger = getLogger("actions:wallet:mutate-entities")
+const logger = getLogger("actions:wallet:execute-batch")
 
 /**
- * Parameters for the mutateEntities function — the same batch shape the advanced path takes
+ * Parameters for the executeBatch function — the same batch shape the advanced path takes
  * ({@link EntityMutationOps}), so the two surfaces cannot drift apart.
  *
  * At least one operation is required; a batch with nothing in it throws rather than spending gas on
  * an empty transaction.
  */
-export type MutateEntitiesParameters = EntityMutationOps
+export type ExecuteBatchParameters = EntityMutationOps
 
-/** Return type for the mutateEntities function. */
-export type MutateEntitiesReturnType = {
+/** Return type for the executeBatch function. */
+export type ExecuteBatchReturnType = {
   /** The transaction hash. */
   txHash: Hash
   /** The keys of the created entities, in batch order. */
@@ -31,14 +31,14 @@ export type MutateEntitiesReturnType = {
   ownershipChanges: Hex[]
 }
 
-export async function mutateEntities(
+export async function executeBatch(
   client: ArkivClient,
-  data: MutateEntitiesParameters,
+  data: ExecuteBatchParameters,
   txParams?: TxParams,
-): Promise<MutateEntitiesReturnType> {
+): Promise<ExecuteBatchReturnType> {
   const { receipt, createdEntityKeys } = await sendArkivTransaction(client, data, txParams)
 
-  logger("Receipt from mutateEntities %o", receipt)
+  logger("Receipt from executeBatch %o", receipt)
 
   return {
     txHash: receipt.transactionHash as Hash,

package/src/actions/wallet/extendEntity.ts

@@ -4,6 +4,7 @@ import type { Expiry } from "../../entity"
 import { EntityMutationError } from "../../errors"
 import type { TxParams } from "../../types"
 import { sendArkivTransaction } from "../../utils/arkivTransactions"
+import type { ExpirationTime } from "../../utils/expirationTime"
 import { getLogger } from "../../utils/logger"
 
 const logger = getLogger("actions:wallet:extend-entity")