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

package/dist/{index-DVYFaXNV.d.ts → index-CIcHPx2j.d.cts}

@@ -45,8 +45,7 @@ type UserTypeTag = Exclude<TypeTag, "bytes">;
 /**
  * Marks a value as having passed its constructor's validation. The symbol is module-private, so a
  * hand-written object literal is not assignable to {@link ArkivValue} — every value crossing the
- * wire has been range-, length- and format-checked by {@link i32}, {@link u256}, {@link dec}, and
- * friends.
+ * wire has been range-, length- and format-checked by `i32`, `u256`, `dec`, and friends.
  */
 declare const validated: unique symbol;
 /**
@@ -78,7 +77,7 @@ type U256Value = Value<"u256", bigint>;
 type DecValue = Value<"dec", string>;
 /** 32 opaque bytes, as lowercase `0x` hex. */
 type Bytes32Value = Value<"bytes32", Hex>;
-/** A UTF-8 string of at most 128 bytes. */
+/** A UTF-8 string of at most 128 bytes, free of C0 control characters and DEL. */
 type StrValue = Value<"str", string>;
 /** A 20-byte Ethereum address, as EIP-55 checksummed hex. */
 type AddrValue = Value<"addr", Address>;
@@ -205,7 +204,11 @@ declare function decFromUnits(units: bigint): DecValue;
  *
  * The limit is on **bytes**, not characters: a string of 128 emoji does not fit.
  *
- * @throws {InvalidValueError} If the string exceeds 128 UTF-8 bytes.
+ * C0 control characters and DEL are rejected: the query language writes a `str` as `str('...')`,
+ * whose only escape is a doubled quote, so a control character could be stored but never queried.
+ *
+ * @throws {InvalidValueError} If the value is not a string, holds a control character, or exceeds
+ * 128 UTF-8 bytes.
  *
  * @example
  * str("Bob")
@@ -296,11 +299,15 @@ declare function toValue(input: ValueInput, attributeName?: string): ArkivValue;
  * The most attribute cells one operation may carry.
  */
 declare const MAX_ATTRIBUTES = 32;
+/**
+ * The largest payload an entity may carry, in bytes. The payload travels as the `$payload` system
+ * cell, so this is a bound on that one attribute rather than on the operation as a whole.
+ */
 declare const MAX_PAYLOAD_BYTES: number;
 /**
  * The attributes written on an entity, as a plain object keyed by attribute name.
  *
- * Values may be tagged ({@link ValueInput}) or bare where the type is unambiguous — see
+ * Values may be tagged ({@link ArkivValue}) or bare where the type is unambiguous — see
  * {@link toValue} for the bare-form defaults.
  *
  * @example
@@ -414,4 +421,4 @@ declare function validateAttributeName(name: string): void;
 declare function isValidAttributeName(name: string): boolean;
 //#endregion
 export { i32 as A, Bytes32Value as B, ValueInput as C, dec as D, bytes32 as E, u64 as F, StrValue as G, DecValue as H, AddrValue as I, U64Value as J, TypeTag as K, AnyArkivValue as L, str as M, toValue as N, decFromUnits as O, u256 as P, ArkivValue as R, U64_MAX as S, bool as T, I32Value as U, BytesValue as V, KeyValue as W, isArkivValue as X, UserTypeTag as Y, MAX_PAYLOAD_BYTES as _, InvalidAttributeNameError as a, MAX_STRING_BYTES as b, TooManyAttributesError as c, DECIMAL_SCALE as d, DECIMAL_UNIT as f, MAX_ATTRIBUTES as g, Attributes as h, ConflictingMutationError as i, key as j, decUnits as k, UnknownAttributeTypeError as l, AttributeSchema as m, isValidAttributeName as n, InvalidValueError as o, AttributeInputs as p, U256Value as q, validateAttributeName as r, MissingValueError as s, MAX_NAME_BYTES as t, UntypedValueError as u, I32_MAX as v, addr as w, U256_MAX as x, I32_MIN as y, BoolValue as z };
-//# sourceMappingURL=index-DVYFaXNV.d.ts.map
+//# sourceMappingURL=index-CIcHPx2j.d.cts.map

package/dist/index-CIcHPx2j.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CIcHPx2j.d.cts","names":[],"sources":["../src/attr/types.ts","../src/attr/values.ts","../src/attr/attributes.ts","../src/attr/decimal.ts","../src/attr/errors.ts","../src/attr/names.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/{index-D8LZt-3J.d.cts → index-Cd2aaWme.d.ts}

@@ -45,8 +45,7 @@ type UserTypeTag = Exclude<TypeTag, "bytes">;
 /**
  * Marks a value as having passed its constructor's validation. The symbol is module-private, so a
  * hand-written object literal is not assignable to {@link ArkivValue} — every value crossing the
- * wire has been range-, length- and format-checked by {@link i32}, {@link u256}, {@link dec}, and
- * friends.
+ * wire has been range-, length- and format-checked by `i32`, `u256`, `dec`, and friends.
  */
 declare const validated: unique symbol;
 /**
@@ -78,7 +77,7 @@ type U256Value = Value<"u256", bigint>;
 type DecValue = Value<"dec", string>;
 /** 32 opaque bytes, as lowercase `0x` hex. */
 type Bytes32Value = Value<"bytes32", Hex>;
-/** A UTF-8 string of at most 128 bytes. */
+/** A UTF-8 string of at most 128 bytes, free of C0 control characters and DEL. */
 type StrValue = Value<"str", string>;
 /** A 20-byte Ethereum address, as EIP-55 checksummed hex. */
 type AddrValue = Value<"addr", Address>;
@@ -205,7 +204,11 @@ declare function decFromUnits(units: bigint): DecValue;
  *
  * The limit is on **bytes**, not characters: a string of 128 emoji does not fit.
  *
- * @throws {InvalidValueError} If the string exceeds 128 UTF-8 bytes.
+ * C0 control characters and DEL are rejected: the query language writes a `str` as `str('...')`,
+ * whose only escape is a doubled quote, so a control character could be stored but never queried.
+ *
+ * @throws {InvalidValueError} If the value is not a string, holds a control character, or exceeds
+ * 128 UTF-8 bytes.
  *
  * @example
  * str("Bob")
@@ -296,11 +299,15 @@ declare function toValue(input: ValueInput, attributeName?: string): ArkivValue;
  * The most attribute cells one operation may carry.
  */
 declare const MAX_ATTRIBUTES = 32;
+/**
+ * The largest payload an entity may carry, in bytes. The payload travels as the `$payload` system
+ * cell, so this is a bound on that one attribute rather than on the operation as a whole.
+ */
 declare const MAX_PAYLOAD_BYTES: number;
 /**
  * The attributes written on an entity, as a plain object keyed by attribute name.
  *
- * Values may be tagged ({@link ValueInput}) or bare where the type is unambiguous — see
+ * Values may be tagged ({@link ArkivValue}) or bare where the type is unambiguous — see
  * {@link toValue} for the bare-form defaults.
  *
  * @example
@@ -414,4 +421,4 @@ declare function validateAttributeName(name: string): void;
 declare function isValidAttributeName(name: string): boolean;
 //#endregion
 export { i32 as A, Bytes32Value as B, ValueInput as C, dec as D, bytes32 as E, u64 as F, StrValue as G, DecValue as H, AddrValue as I, U64Value as J, TypeTag as K, AnyArkivValue as L, str as M, toValue as N, decFromUnits as O, u256 as P, ArkivValue as R, U64_MAX as S, bool as T, I32Value as U, BytesValue as V, KeyValue as W, isArkivValue as X, UserTypeTag as Y, MAX_PAYLOAD_BYTES as _, InvalidAttributeNameError as a, MAX_STRING_BYTES as b, TooManyAttributesError as c, DECIMAL_SCALE as d, DECIMAL_UNIT as f, MAX_ATTRIBUTES as g, Attributes as h, ConflictingMutationError as i, key as j, decUnits as k, UnknownAttributeTypeError as l, AttributeSchema as m, isValidAttributeName as n, InvalidValueError as o, AttributeInputs as p, U256Value as q, validateAttributeName as r, MissingValueError as s, MAX_NAME_BYTES as t, UntypedValueError as u, I32_MAX as v, addr as w, U256_MAX as x, I32_MIN as y, BoolValue as z };
-//# sourceMappingURL=index-D8LZt-3J.d.cts.map
+//# sourceMappingURL=index-Cd2aaWme.d.ts.map

package/dist/index-Cd2aaWme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Cd2aaWme.d.ts","names":[],"sources":["../src/attr/types.ts","../src/attr/values.ts","../src/attr/attributes.ts","../src/attr/decimal.ts","../src/attr/errors.ts","../src/attr/names.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/{index-ClgIuxJ8.d.ts → index-ezMZ2-JH.d.ts}

@@ -11,7 +11,7 @@ declare class InvalidCreationFlagsError extends Error {
 }
 /** A key salt was outside the `uint128` the wire carries. */
 declare class InvalidSaltError extends Error {
-  constructor(salt: bigint);
+  constructor(salt: unknown);
 }
 /** No cryptographic randomness was available to generate a salt. */
 declare class NoRandomSourceError extends Error {
@@ -103,6 +103,16 @@ type EntityEventName = (typeof ENTITY_EVENTS_ABI)[number]["name"];
 //#region src/entity/key.d.ts
 /** The widest salt the `uint128` wire field carries. */
 declare const MAX_SALT: bigint;
+/**
+ * Opts a create out of salting, as {@link CreateEntityParameters.salt}: the key is then derived
+ * from the owner and its nonce alone, so anyone who knows both can work it out before the create
+ * lands.
+ */
+declare const NO_SALT: unique symbol;
+/**
+ * A salt as a caller expresses it: an explicit `uint128`, or {@link NO_SALT} to opt out of salting.
+ */
+type SaltInput = bigint | typeof NO_SALT;
 /**
  * A cryptographically random 128-bit salt — what {@link CreateEntityParameters.salt} defaults to.
  *
@@ -134,8 +144,8 @@ declare function predictEntityKey({
    * create in a batch uses `nonce + n`.
    */
   nonce: bigint;
-  /** The salt the create will carry. */
-  salt: bigint;
+  /** The salt the create will carry, or {@link NO_SALT} if it carries none. */
+  salt: SaltInput;
   /** The chain the entity is being created on — half of the derivation domain. */
   chainId: number;
 }): Hex;
@@ -155,5 +165,5 @@ declare const OperationType: {
 };
 type OperationType = (typeof OperationType)[keyof typeof OperationType];
 //#endregion
-export { randomSalt as a, InvalidCreationFlagsError as c, NoRandomSourceError as d, predictEntityKey as i, InvalidExpiryError as l, OperationType as n, ENTITY_EVENTS_ABI as o, MAX_SALT as r, EntityEventName as s, MAX_EXPIRES_AT as t, InvalidSaltError as u };
-//# sourceMappingURL=index-ClgIuxJ8.d.ts.map
+export { SaltInput as a, ENTITY_EVENTS_ABI as c, InvalidExpiryError as d, InvalidSaltError as f, NO_SALT as i, EntityEventName as l, OperationType as n, predictEntityKey as o, NoRandomSourceError as p, MAX_SALT as r, randomSalt as s, MAX_EXPIRES_AT as t, InvalidCreationFlagsError as u };
+//# sourceMappingURL=index-ezMZ2-JH.d.ts.map

package/dist/index-ezMZ2-JH.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-ezMZ2-JH.d.ts","names":[],"sources":["../src/entity/errors.ts","../src/entity/events.ts","../src/entity/key.ts","../src/entity/params.ts"],"sourcesContent":[],"mappings":";;;;cACa,kBAAA,SAA2B,KAAA;;AAAxC;AAQA;AAQa,cARA,yBAAA,SAAkC,KAAA,CAQJ;EAY9B,WAAA,CAAA,MAAA,EAAA,MAAoB;;;cAZpB,gBAAA,SAAyB,KAAA;ECXzB,WAAA,CAAA,IAAA,EAAA,OAMX;AAGF;;cDca,mBAAA,SAA4B,KAAA;;AEvBzC;;;;;;AFLA;AAQa,cCHA,iBDG0B,EAAA,SAAa,CAAA;EAQvC,SAAA,IAAA,EAAA,eAAyB;EAYzB,SAAA,IAAA,EAAA,OAAoB;;;;ICvBpB,SAAA,OAMX,EAAA,IAAA;EAGU,CAAA,EAAA;;;;ECTC,CAAA,EAAA;IAOA,SAA2B,IAAA,EAAA,QAAA;IAK5B,SAAS,IAAA,EAAA,WAAmB;EAWxB,CAAA,EAAA;IAkCA,SAAA,IAAA,EAAgB,OAAA;IAC9B,SAAA,IAAA,EAAA,eAAA;EACA,CAAA,CAAA;CACA,EAAA;EACA,SAAA,IAAA,EAAA,eAAA;EAGO,SAAA,IAAA,EAAA,OAAA;EAOD,SAAA,MAAA,EAAA,SAAA,CAAA;IAGJ,SAAA,IAAA,EAAA,SAAA;IAAG,SAAA,IAAA,EAAA,WAAA;;;;IC7EM,SAAA,IAA+B,EAAA,OAAA;IAG/B,SAAA,OAMH,EAAA,IAAA;EAEE,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KFCA,eAAA,WAA0B;;;;cCTzB;AFLb;AAQA;AAQA;AAYA;;cEhBa;;ADPb;AASA;KCGY,SAAA,mBAA4B;;;AAZxC;AAOA;AAKA;AAWA;AAkCA;;;AAGE,iBArCc,UAAA,CAAA,CAqCd,EAAA,MAAA;;;AC/DF;AAGA;AAQA;;;;iBDiDgB,gBAAA;;;;;;;SAOP;;;;;;;QAOD;;;IAGJ;;;;;;AF/ES,cGEA,cHFmB,EAAQ,MAAK;AAQ7C;AAQa,cGXA,aHWyB,EAAA;EAYzB,SAAA,MAAA,EAAA,CAAA;;;;ECvBA,SAAA,MAAA,EAAA,CAAA;AASb,CAAA;KEDY,aAAA,WAAwB,4BAA4B"}

package/dist/{index-Cgw1u5aY.d.cts → index-rINthNuU.d.cts}

@@ -1,5 +1,5 @@
-import { K as TypeTag } from "./index-D8LZt-3J.cjs";
-import { R as RpcSelect, d as Expression, i as SelectArg, j as ArkivClient, k as Entity } from "./selection-BvK6yX0g.cjs";
+import { K as TypeTag } from "./index-CIcHPx2j.cjs";
+import { R as RpcSelect, d as Expression, i as SelectArg, j as ArkivClient, k as Entity } from "./selection-Bv8_o-7i.cjs";
 import { Hex } from "viem";
 
 //#region src/query/engine.d.ts
@@ -43,7 +43,7 @@ declare function runQuery(client: ArkivClient, request: QueryRequest): Promise<Q
  * | | `=` `!=` | `<` `<=` `>` `>=` | `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 |
  */
@@ -275,4 +275,4 @@ declare class SelectQueryBuilder<TEntity = Entity> {
 }
 //#endregion
 export { QueryErrorKind as a, QueryRequest as c, QueryError as i, QueryResponse as l, QueryResult as n, UnsupportedOperatorError as o, InvalidPredicateError as r, MAX_LIMIT as s, SelectQueryBuilder as t, runQuery as u };
-//# sourceMappingURL=index-Cgw1u5aY.d.cts.map
+//# sourceMappingURL=index-rINthNuU.d.cts.map

package/dist/{index-Cgw1u5aY.d.cts.map → index-rINthNuU.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-Cgw1u5aY.d.cts","names":[],"sources":["../src/query/engine.ts","../src/query/errors.ts","../src/query/queryResult.ts","../src/query/queryBuilder.ts"],"sourcesContent":[],"mappings":";;;;;cAUa,SAAA;;AAAA,KAGD,YAAA,GAHU;EAGV;EAcA,KAAA,EAAA,MAAA;EAaU;EAAiB,MAAA,EAvB7B,SAuB6B;EAAsB;EAAuB,KAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAR;EAAO,MAAA,CAAA,EAAA,MAAA,GAAA,SAAA;;;;ACxBnF;AAMgB,KDKJ,aAAA,GCLI;EAE4C,QAAA,EDIhD,MCJgD,EAAA;EARd;EAAK,WAAA,EAAA,MAAA;EAyBtC;EAgBD,MAAA,EAAA,MAAA,GAAc,SAAA;AAwC1B,CAAA;;;;;;iBDzDsB,QAAA,SAAiB,sBAAsB,eAAe,QAAQ;;;;;;;AA9BpF;AAGA;AAcA;AAaA;;;;;;;cCxBa,wBAAA,SAAiC,KAAA;;EAAjC,SAAA,aAAA,EAAA,MAAyB;EAMtB;EAE4C,SAAA,QAAA,EAAA,MAAA;EARd;EAAK,SAAA,GAAA,EAMnC,OANmC;EAyBtC,WAAA,CAAA,aAAsB,EAAA,MAAA,EAAA,QAAa,EAAA,MAAA,EAAA,GAAA,EAjBY,OAiBZ,EAAA,IAAA,CAAA,EAAA,MAAA;AAgBhD;AAwCA;;;;;cAxDa,qBAAA,SAA8B,KAAA;;;ECrCtC,WAAA,CAAS,OAAA,EAAA,MAAA,EAAA,aAAA,CAAA,EAAA,MAAA;;;;;AAgBd;;AAE8B,KDmClB,cAAA;;+GCSwB;kHAApB;;;ACzBhB,0DAA0C,OAAA;;;;;;;;;;;;;;;;;cFwD7B,UAAA,SAAmB,KAAA;;iBAEf;;;;;;;oBAQG;;;;;KCvGf,yCAAyC,QAAQ,YAAY;;;AFMlE;AAGA;AAcA;AAaA;;;;;;;;;ACxBa,cCIA,WDJyB,CAAA,UCIH,MDJG,CAAA,CAAA;EAMtB;EAE4C,SAAA,QAAA,EAAA,SCF9B,ODE8B,EAAA;EARd;;AAyB9C;AAgBA;AAwCA;;EAUoB,SAAA,WAAA,EAAA,MAAA;EAVY;EAAK,SAAA,MAAA,EAAA,MAAA,GAAA,SAAA;;iCC7Dd,uEAGR,UAAU;;AAtCoB;;;;;EAmBhC,WAAA,CAAA,CAAA,EAAW,OAAA;EAAW;;;;;;;EA8CnB,IAAA,CAAA,CAAA,EAAA,OAAA,CAAQ,WAAR,CAAoB,OAApB,CAAA,CAAA;;;;AFrDhB;AAcA;AAaA;;;;;;;;;ACxBA;;;;;AAyBA;AAgBA;AAwCA;;;;;;;;AChG6C;;;;AAGQ,cCqCxC,kBDrCwC,CAAA,UCqCX,MDrCW,CAAA,CAAA;EAgBxC,iBAAW,OAAA;EAAW,iBAAA,OAAA;EAEL,iBAAA,QAAA;EAcP,QAAA,QAAA;EAGE,QAAA,UAAA;EAAV,QAAA,MAAA;EA2BqB,QAAA,OAAA;EAAZ,QAAA,QAAA;EAAR,WAAA,CAAA,MAAA,ECfM,WDeN,EAAA,SAAA,CAAA,ECf+B,SDe/B;EAAO;;;;ACzBvB;;;;;;EAuCiB,KAAA,CAAA,WAAA,EAAA,SAda,UAcb,EAAA,CAAA,EAAA,IAAA;EAWI,KAAA,CAAA,GAAA,WAAA,EAxBG,UAwBH,EAAA,CAAA,EAAA,IAAA;EAuEgB;;;;;;;iBAlFpB;;;;;;;qBAWI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAuEJ,QAAQ,YAAY;;;;;;;;;GAqB3B,MAAA,CAAO,aAAA,KAAkB,eAAe"}
+{"version":3,"file":"index-rINthNuU.d.cts","names":[],"sources":["../src/query/engine.ts","../src/query/errors.ts","../src/query/queryResult.ts","../src/query/queryBuilder.ts"],"sourcesContent":[],"mappings":";;;;;cAUa,SAAA;;AAAA,KAGD,YAAA,GAHU;EAGV;EAcA,KAAA,EAAA,MAAA;EAaU;EAAiB,MAAA,EAvB7B,SAuB6B;EAAsB;EAAuB,KAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAR;EAAO,MAAA,CAAA,EAAA,MAAA,GAAA,SAAA;;;;ACxBnF;AAMgB,KDKJ,aAAA,GCLI;EAE4C,QAAA,EDIhD,MCJgD,EAAA;EARd;EAAK,WAAA,EAAA,MAAA;EAyBtC;EAgBD,MAAA,EAAA,MAAA,GAAc,SAAA;AAwC1B,CAAA;;;;;;iBDzDsB,QAAA,SAAiB,sBAAsB,eAAe,QAAQ;;;;;;;AA9BpF;AAGA;AAcA;AAaA;;;;;;;cCxBa,wBAAA,SAAiC,KAAA;;EAAjC,SAAA,aAAA,EAAA,MAAyB;EAMtB;EAE4C,SAAA,QAAA,EAAA,MAAA;EARd;EAAK,SAAA,GAAA,EAMnC,OANmC;EAyBtC,WAAA,CAAA,aAAsB,EAAA,MAAA,EAAA,QAAa,EAAA,MAAA,EAAA,GAAA,EAjBY,OAiBZ,EAAA,IAAA,CAAA,EAAA,MAAA;AAgBhD;AAwCA;;;;;cAxDa,qBAAA,SAA8B,KAAA;;;ECrCtC,WAAA,CAAS,OAAA,EAAA,MAAA,EAAA,aAAA,CAAA,EAAA,MAAA;;;;;AAgBd;;AAE8B,KDmClB,cAAA;;+GCSwB;kHAApB;;;ACzBhB,0DAA0C,OAAA;;;;;;;;;;;;;;;;;cFwD7B,UAAA,SAAmB,KAAA;;iBAEf;;;;;;;oBAQG;;;;;KCvGf,yCAAyC,QAAQ,YAAY;;;AFMlE;AAGA;AAcA;AAaA;;;;;;;;;ACxBa,cCIA,WDJyB,CAAA,UCIH,MDJG,CAAA,CAAA;EAMtB;EAE4C,SAAA,QAAA,EAAA,SCF9B,ODE8B,EAAA;EARd;;AAyB9C;AAgBA;AAwCA;;EAUoB,SAAA,WAAA,EAAA,MAAA;EAVY;EAAK,SAAA,MAAA,EAAA,MAAA,GAAA,SAAA;;iCC7Dd,uEAGR,UAAU;;AAtCoB;;;;;EAmBhC,WAAA,CAAA,CAAA,EAAW,OAAA;EAAW;;;;;;;EA8CnB,IAAA,CAAA,CAAA,EAAA,OAAA,CAAQ,WAAR,CAAoB,OAApB,CAAA,CAAA;;;;AFrDhB;AAcA;AAaA;;;;;;;;;ACxBA;;;;;AAyBA;AAgBA;AAwCA;;;;;;;;AChG6C;;;;AAGQ,cCqCxC,kBDrCwC,CAAA,UCqCX,MDrCW,CAAA,CAAA;EAgBxC,iBAAW,OAAA;EAAW,iBAAA,OAAA;EAEL,iBAAA,QAAA;EAcP,QAAA,QAAA;EAGE,QAAA,UAAA;EAAV,QAAA,MAAA;EA2BqB,QAAA,OAAA;EAAZ,QAAA,QAAA;EAAR,WAAA,CAAA,MAAA,ECfM,WDeN,EAAA,SAAA,CAAA,ECf+B,SDe/B;EAAO;;;;ACzBvB;;;;;;EAuCiB,KAAA,CAAA,WAAA,EAAA,SAda,UAcb,EAAA,CAAA,EAAA,IAAA;EAWI,KAAA,CAAA,GAAA,WAAA,EAxBG,UAwBH,EAAA,CAAA,EAAA,IAAA;EAuEgB;;;;;;;iBAlFpB;;;;;;;qBAWI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAuEJ,QAAQ,YAAY;;;;;;;;;GAqB3B,MAAA,CAAO,aAAA,KAAkB,eAAe"}

package/dist/index.cjs

@@ -1,13 +1,13 @@
-const require_chains = require('./chains-BYRTTipa.cjs');
-const require_attr = require('./attr-BvxHN99W.cjs');
-const require_queryBuilder = require('./queryBuilder-BXDvX1K_.cjs');
-const require_errors = require('./errors-D-eJkGVc.cjs');
-const require_flags = require('./flags-Ct8k0gpB.cjs');
+const require_chains = require('./chains-BfNQliHU.cjs');
+const require_attr = require('./attr-BXTkpnoc.cjs');
+const require_queryBuilder = require('./queryBuilder-DaLxNgeI.cjs');
+const require_errors = require('./errors-DhV00966.cjs');
+const require_flags = require('./flags-DCD26uhe.cjs');
 const require_entity = require('./entity-B0t6sN7F.cjs');
-const require_expiry = require('./expiry-BUYIXTGb.cjs');
-const require_entity$1 = require('./entity-wfBnZd91.cjs');
+const require_expiry = require('./expiry-CG9GhVXv.cjs');
+const require_entity$1 = require('./entity-DJ0Gml9c.cjs');
 require('./types-CKPddlfS.cjs');
-const require_payload = require('./payload-Bnw1hrvb.cjs');
+const require_payload = require('./payload-DqFweqiO.cjs');
 let viem = require("viem");
 let viem_actions = require("viem/actions");
 
@@ -182,7 +182,7 @@ async function getEntityNonce(client, owner) {
 *
 * 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}
@@ -192,7 +192,7 @@ async function getEntityNonce(client, owner) {
 * 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 },
 *     {
@@ -223,7 +223,7 @@ async function predictEntityKeys(client, { owner, count, salts }) {
 function resolveSalts(count, salts) {
 	if (salts !== void 0) {
 		if (salts.length === 0) throw new Error("predictEntityKeys: `salts` is empty — there is nothing to predict");
-		return salts.map(require_entity$1.validateSalt);
+		return salts.map(require_entity$1.resolveSalt);
 	}
 	if (count === void 0) throw new Error("predictEntityKeys: pass either `count` or `salts`");
 	if (!Number.isInteger(count) || count <= 0) throw new Error(`predictEntityKeys: \`count\` must be a positive whole number, got ${count}`);
@@ -420,14 +420,14 @@ function publicArkivActions(client) {
 //#endregion
 //#region src/clients/createPublicClient.ts
 /**
-* Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).
+* Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/chains/introduction).
 *
-* - Docs: https://docs.arkiv.network/ts-sdk/clients/public
-*
-* A Public Client is an interface to "public" [Ethereum JSON-RPC API](https://ethereum.org/en/developers/docs/apis/json-rpc/), [Arkiv JSON-RPC API](https://docs.arkiv.network/json-rpc/), and [Cheesecake JSON-RPC API](https://rpc.cheesecake.db-chain.devnet.gobas.me) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).
+* A Public Client is an interface to the "public" [Ethereum JSON-RPC API](https://ethereum.org/en/developers/docs/apis/json-rpc/)
+* and the Arkiv JSON-RPC API — retrieving block numbers and transactions, reading from
+* contracts, and querying entities — through {@link PublicArkivActions}.
 *
 * @param parameters - Configuration object for the public client (chain, transport, etc.)
-* @returns A Arkiv Public Client. {@link PublicArkivClient}
+* @returns An Arkiv Public Client. {@link PublicArkivClient}
 *
 * @example
 * import { createPublicClient } from "@arkiv-network/sdk"
@@ -562,7 +562,7 @@ async function sendArkivTransaction(client, ops, txParams) {
 	const createOps = (creates ?? []).map((item) => {
 		validateContentType(item.contentType);
 		return createOperation({
-			salt: item.salt === void 0 ? require_entity$1.randomSalt() : require_entity$1.validateSalt(item.salt),
+			salt: item.salt === void 0 ? require_entity$1.randomSalt() : require_entity$1.resolveSalt(item.salt),
 			expiry: require_expiry.resolveExpiry(item.expires, expiryContext),
 			creationFlags: require_flags.encodeCreationFlags(item.flags),
 			attributes: require_attr.encodeAttributes(item.attributes, {
@@ -599,8 +599,9 @@ async function sendArkivTransaction(client, ops, txParams) {
 	];
 	if (operations.length === 0) throw new Error("No operations to perform");
 	logger$6("Sending execute with %d operations %o", operations.length, operations);
+	let txHash;
 	try {
-		const txHash = await walletClient.writeContract({
+		txHash = await walletClient.writeContract({
 			address: require_expiry.ARKIV_ADDRESS,
 			abi: EXECUTE_ABI$1,
 			functionName: "execute",
@@ -624,9 +625,12 @@ async function sendArkivTransaction(client, ops, txParams) {
 			} catch (err) {
 				const error = err;
 				const reason = describeEntityRevert(err) ?? error.shortMessage ?? error.cause?.details ?? "No reason provided by backend.";
-				throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} reverted. Reason: ${reason}`);
+				throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} reverted. Reason: ${reason}`, {
+					cause: err,
+					txHash: receipt.transactionHash
+				});
 			}
-			throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} reverted. No reason provided by backend.`);
+			throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} reverted. No reason provided by backend.`, { txHash: receipt.transactionHash });
 		}
 		return {
 			receipt,
@@ -637,7 +641,10 @@ async function sendArkivTransaction(client, ops, txParams) {
 		};
 	} catch (error) {
 		const described = error instanceof require_queryBuilder.EntityMutationError ? void 0 : describeEntityRevert(error);
-		if (described !== void 0) throw new require_queryBuilder.EntityMutationError(`Transaction failed: ${described}`, { cause: error });
+		if (described !== void 0) throw new require_queryBuilder.EntityMutationError(`Transaction failed: ${described}`, {
+			cause: error,
+			txHash
+		});
 		let message = "Transaction failed";
 		if (error instanceof viem.TransactionExecutionError) message += `: ${error.details}`;
 		else if (error instanceof viem.ContractFunctionExecutionError) {
@@ -646,7 +653,10 @@ async function sendArkivTransaction(client, ops, txParams) {
 			else message += ": Execution error without revert data";
 		} else if (error instanceof require_queryBuilder.EntityMutationError) throw error;
 		else if (error instanceof Error) message += `: ${error.message}`;
-		throw new require_queryBuilder.EntityMutationError(message, { cause: error });
+		throw new require_queryBuilder.EntityMutationError(message, {
+			cause: error,
+			txHash
+		});
 	}
 }
 /**
@@ -687,7 +697,7 @@ function decodeEntityLog(log) {
 }
 function assertCount(receipt, what, got, want) {
 	if (got === want) return;
-	throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} succeeded — do not retry it — but emitted ${got} ${what} event(s) for ${want} ${what} operation(s). The batch was applied; the SDK cannot say which entity each operation produced, so read them back to find them.`);
+	throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} succeeded — do not retry it — but emitted ${got} ${what} event(s) for ${want} ${what} operation(s). The batch was applied; the SDK cannot say which entity each operation produced, so read them back to find them.`, { txHash: receipt.transactionHash });
 }
 
 //#endregion
@@ -712,7 +722,7 @@ async function createEntity(client, data, txParams) {
 	logger$4("Receipt from createEntity %o", receipt);
 	const [entityKey] = createdEntityKeys;
 	const [expiresAt] = createdExpiries;
-	if (entityKey === void 0 || expiresAt === void 0) throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} succeeded, but the receipt did not carry the expected entity key or expiry.`);
+	if (entityKey === void 0 || expiresAt === void 0) throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} succeeded, but the receipt did not carry the expected entity key or expiry.`, { txHash: receipt.transactionHash });
 	return {
 		txHash: receipt.transactionHash,
 		entityKey,
@@ -734,27 +744,11 @@ async function deleteEntity(client, data, txParams) {
 }
 
 //#endregion
-//#region src/actions/wallet/extendEntity.ts
-const logger$2 = require_queryBuilder.getLogger("actions:wallet:extend-entity");
-async function extendEntity(client, data, txParams) {
-	logger$2("extendEntity %o", data);
-	const { receipt, extendedExpiries } = await sendArkivTransaction(client, { extensions: [data] }, txParams);
-	logger$2("Receipt from extendEntity %o", receipt);
-	const [expiresAt] = extendedExpiries;
-	if (expiresAt === void 0) throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} succeeded, but the receipt did not carry the expected entity expiry.`);
-	return {
-		txHash: receipt.transactionHash,
-		entityKey: data.entityKey,
-		expiresAt
-	};
-}
-
-//#endregion
-//#region src/actions/wallet/mutateEntities.ts
-const logger$1 = require_queryBuilder.getLogger("actions:wallet:mutate-entities");
-async function mutateEntities(client, data, txParams) {
+//#region src/actions/wallet/executeBatch.ts
+const logger$2 = require_queryBuilder.getLogger("actions:wallet:execute-batch");
+async function executeBatch(client, data, txParams) {
 	const { receipt, createdEntityKeys } = await sendArkivTransaction(client, data, txParams);
-	logger$1("Receipt from mutateEntities %o", receipt);
+	logger$2("Receipt from executeBatch %o", receipt);
 	return {
 		txHash: receipt.transactionHash,
 		createdEntities: createdEntityKeys,
@@ -765,6 +759,22 @@ async function mutateEntities(client, data, txParams) {
 	};
 }
 
+//#endregion
+//#region src/actions/wallet/extendEntity.ts
+const logger$1 = require_queryBuilder.getLogger("actions:wallet:extend-entity");
+async function extendEntity(client, data, txParams) {
+	logger$1("extendEntity %o", data);
+	const { receipt, extendedExpiries } = await sendArkivTransaction(client, { extensions: [data] }, txParams);
+	logger$1("Receipt from extendEntity %o", receipt);
+	const [expiresAt] = extendedExpiries;
+	if (expiresAt === void 0) throw new require_queryBuilder.EntityMutationError(`Transaction ${receipt.transactionHash} succeeded, but the receipt did not carry the expected entity expiry.`, { txHash: receipt.transactionHash });
+	return {
+		txHash: receipt.transactionHash,
+		entityKey: data.entityKey,
+		expiresAt
+	};
+}
+
 //#endregion
 //#region src/actions/wallet/patchEntity.ts
 const logger = require_queryBuilder.getLogger("actions:wallet:patch-entity");
@@ -787,7 +797,7 @@ function walletArkivActions(client) {
 		deleteEntity: (data, txParams) => deleteEntity(client, data, txParams),
 		extendEntity: (data, txParams) => extendEntity(client, data, txParams),
 		changeOwnership: (data, txParams) => changeOwnership(client, data, txParams),
-		mutateEntities: (data, txParams) => mutateEntities(client, data, txParams)
+		executeBatch: (data, txParams) => executeBatch(client, data, txParams)
 	};
 }
 
@@ -795,16 +805,14 @@ function walletArkivActions(client) {
 //#region src/clients/createWalletClient.ts
 /**
 * Creates a Wallet Client with a given [Transport](https://viem.sh/docs/clients/intro) configured
-* for a [Chain](https://viem.sh/docs/clients/chains) and an account.
-*
-* - Docs: https://docs.arkiv.network/ts-sdk/clients/wallet
+* for a [Chain](https://viem.sh/docs/chains/introduction) and an account.
 *
 * A Wallet Client signs and sends transactions, so it carries an `account` and exposes everything
 * that mutates state — `createEntity`, `patchEntity`, `deleteEntity`, `extendEntity`,
-* `changeOwnership` and `mutateEntities` — on top of the read actions a Public Client has.
+* `changeOwnership` and `executeBatch` — on top of the read actions a Public Client has.
 *
 * @param parameters - Configuration object for the wallet client (chain, transport, account, etc.)
-* @returns A Arkiv Wallet Client. {@link WalletArkivClient}
+* @returns An Arkiv Wallet Client. {@link WalletArkivClient}
 *
 * @example
 * import { createWalletClient } from "@arkiv-network/sdk"
@@ -866,6 +874,7 @@ exports.MAX_PAYLOAD_BYTES = require_attr.MAX_PAYLOAD_BYTES;
 exports.MAX_SALT = require_entity$1.MAX_SALT;
 exports.MAX_STRING_BYTES = require_attr.MAX_STRING_BYTES;
 exports.MissingValueError = require_attr.MissingValueError;
+exports.NO_SALT = require_entity$1.NO_SALT;
 exports.NoEntityFoundError = require_queryBuilder.NoEntityFoundError;
 exports.NoMoreResultsError = require_queryBuilder.NoMoreResultsError;
 exports.NoRandomSourceError = require_errors.NoRandomSourceError;