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

package/dist/{index-CA4V7Pdh.d.cts → index-JP31fjyM.d.ts}

@@ -8,6 +8,56 @@ type Operation = {
   operationData: Hex;
 };
 //#endregion
+//#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.
+ *
+ * The salt exists for unpredictability, not uniqueness: the per-owner nonce already guarantees
+ * distinct keys. Random bits mean only the creator can predict the key of an entity they are about
+ * to create, so nobody else can reference or squat it in advance.
+ *
+ * @throws {NoRandomSourceError} If the runtime has no `crypto.getRandomValues`.
+ */
+declare function randomSalt(): bigint;
+/**
+ * The key an entity will be created with, derived exactly as the engine derives it:
+ * `keccak256(domain ++ owner ++ nonce ++ salt)`.
+ *
+ * Deriving it client-side is what lets a batch compose: predict the key of a create, then have a
+ * later operation in the same transaction reference it, or store it as a `key` attribute on a
+ * sibling entity.
+ */
+declare function predictEntityKey({
+  owner,
+  nonce,
+  salt,
+  chainId
+}: {
+  /** The account creating the entity. */
+  owner: Address;
+  /**
+   * The owner's entity-nonce at creation time. Each create in a batch consumes one, so the *n*th
+   * create in a batch uses `nonce + n`.
+   */
+  nonce: 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;
+//#endregion
 //#region src/entity/errors.d.ts
 /** An expiry could not be expressed, or would be rejected by the engine. */
 declare class InvalidExpiryError extends Error {
@@ -19,7 +69,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 {
@@ -108,46 +158,6 @@ declare const ENTITY_EVENTS_ABI: readonly [{
 /** The name of each event in {@link ENTITY_EVENTS_ABI}. */
 type EntityEventName = (typeof ENTITY_EVENTS_ABI)[number]["name"];
 //#endregion
-//#region src/entity/key.d.ts
-/** The widest salt the `uint128` wire field carries. */
-declare const MAX_SALT: bigint;
-/**
- * A cryptographically random 128-bit salt — what {@link CreateEntityParameters.salt} defaults to.
- *
- * The salt exists for unpredictability, not uniqueness: the per-owner nonce already guarantees
- * distinct keys. Random bits mean only the creator can predict the key of an entity they are about
- * to create, so nobody else can reference or squat it in advance.
- *
- * @throws {NoRandomSourceError} If the runtime has no `crypto.getRandomValues`.
- */
-declare function randomSalt(): bigint;
-/**
- * The key an entity will be created with, derived exactly as the engine derives it:
- * `keccak256(domain ++ owner ++ nonce ++ salt)`.
- *
- * Deriving it client-side is what lets a batch compose: predict the key of a create, then have a
- * later operation in the same transaction reference it, or store it as a `key` attribute on a
- * sibling entity.
- */
-declare function predictEntityKey({
-  owner,
-  nonce,
-  salt,
-  chainId
-}: {
-  /** The account creating the entity. */
-  owner: Address;
-  /**
-   * The owner's entity-nonce at creation time. Each create in a batch consumes one, so the *n*th
-   * create in a batch uses `nonce + n`.
-   */
-  nonce: bigint;
-  /** The salt the create will carry. */
-  salt: bigint;
-  /** The chain the entity is being created on — half of the derivation domain. */
-  chainId: number;
-}): Hex;
-//#endregion
 //#region src/entity/params.d.ts
 /**
  * Max uint64 value
@@ -163,5 +173,5 @@ declare const OperationType: {
 };
 type OperationType = (typeof OperationType)[keyof typeof OperationType];
 //#endregion
-export { randomSalt as a, InvalidCreationFlagsError as c, NoRandomSourceError as d, Operation as f, 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-CA4V7Pdh.d.cts.map
+export { InvalidCreationFlagsError as a, NoRandomSourceError as c, SaltInput as d, predictEntityKey as f, EntityEventName as i, MAX_SALT as l, Operation as m, OperationType as n, InvalidExpiryError as o, randomSalt as p, ENTITY_EVENTS_ABI as r, InvalidSaltError as s, MAX_EXPIRES_AT as t, NO_SALT as u };
+//# sourceMappingURL=index-JP31fjyM.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-JP31fjyM.d.ts","names":[],"sources":["../src/entity/operations.ts","../src/entity/key.ts","../src/entity/errors.ts","../src/entity/events.ts","../src/entity/params.ts"],"sourcesContent":[],"mappings":";;;;;KAiDY,SAAA;;iBAEK;;;;;cC7CJ;AD2Cb;;;;AC3CA;AAOa,cAAA,OAA2B,EAAA,OAAA,MAAA;AAKxC;AAWA;AAkCA;AACE,KA9CU,SAAA,GA8CV,MAAA,GAAA,OA9CsC,OA8CtC;;;;;;;;;;iBAnCc,UAAA,CAAA;;AEvBhB;AASA;;;;ACZA;AAGA;AAQY,iBHiDI,gBAAA,CGjDoB;EAAA,KAA4B;EAAA,KAAA;EAAA,IAAA;EAAa;CAAA,EAAA;;SHwDpE;;;;;;;QAOD;;;IAGJ;;;;cC/ES,kBAAA,SAA2B,KAAA;;AFgDxC;;cExCa,yBAAA,SAAkC,KAAA;;ADH/C;AAOA;AAKY,cCDC,gBAAA,SAAyB,KAAA,CDCS;EAW/B,WAAA,CAAA,IAAU,EAAA,OAAA;AAkC1B;;AAEE,cCpCW,mBAAA,SAA4B,KAAA,CDoCvC;EACA,WAAA,CAAA;;;;;;;ADjBF;cG3Ca;;;EFAA,SAAA,MAA0B,EAAA,SAAA,CAAA;IAO1B,SAA2B,IAAA,EAAA,SAAA;IAK5B,SAAS,IAAA,EAAA,WAAmB;IAWxB,SAAU,OAAA,EAAA,IAAA;EAkCV,CAAA,EAAA;IACd,SAAA,IAAA,EAAA,SAAA;IACA,SAAA,IAAA,EAAA,OAAA;IACA,SAAA,OAAA,EAAA,IAAA;EACA,CAAA,EAAA;IAGO,SAAA,IAAA,EAAA,QAAA;IAOD,SAAA,IAAA,EAAA,WAAA;EAGJ,CAAA,EAAA;IAAG,SAAA,IAAA,EAAA,OAAA;;;;EC/EM,SAAA,IAAA,EAAA,eAAmB;EAQnB,SAAA,IAAA,EAAA,OAAA;EAQA,SAAA,MAAA,EAAA,SAAiB,CAAA;IAYjB,SAAA,IAAA,EAAA,SAAoB;;;;ICvBpB,SAAA,IAAA,EAAA,SAMX;IAGU,SAAA,IAAA,EAAe,OAAA;;;;ECZd,SAAA,IAAA,EAAA,gBAA+B;EAG/B,SAAA,IAAA,EAAA,OAMH;EAEE,SAAA,MAAA,EAAa,SAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KDCb,eAAA,WAA0B;;;;;;AHkC1B,cI9CC,cJgDO,EAAA,MAAA;;cI7CP;;EHAA,SAAA,KAA0B,EAAA,CAAA;EAO1B,SAAA,YAA2B,EAAA,CAAA;EAK5B,SAAA,iBAA4B,EAAA,CAAA;EAWxB,SAAA,MAAU,EAAA,CAAA;AAkC1B,CAAA;AACE,KGlDU,aAAA,GHkDV,CAAA,OGlDkC,aHkDlC,CAAA,CAAA,MAAA,OGlD8D,aHkD9D,CAAA"}

package/dist/{index-CV5zCdpa.d.cts → index-NbfnXxgr.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-CV5zCdpa.d.cts.map
+//# sourceMappingURL=index-NbfnXxgr.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-NbfnXxgr.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.cjs

@@ -1,17 +1,17 @@
-const require_chains = require('./chains-BYRTTipa.cjs');
-const require_expiry = require('./expiry-BELY2Kpw.cjs');
-const require_advanced = require('./advanced-fPImL6lW.cjs');
-const require_attributes = require('./attributes-Df9IsCVs.cjs');
-const require_key = require('./key-WKhXnXuU.cjs');
-const require_errors = require('./errors-BVbjKVMN.cjs');
-const require_flags = require('./flags-kr276q6i.cjs');
+const require_chains = require('./chains-BfNQliHU.cjs');
+const require_expiry = require('./expiry-xr6mx4f7.cjs');
+const require_advanced = require('./advanced-Ds2XRflQ.cjs');
+const require_attributes = require('./attributes-CMJlp1wn.cjs');
+const require_key = require('./key-E7mv0BYf.cjs');
+const require_errors = require('./errors-51znTSB1.cjs');
+const require_flags = require('./flags-Bh0HJldY.cjs');
 const require_logger = require('./logger-Cr15lPAQ.cjs');
 require('./attr-DlmErkvR.cjs');
 const require_entity = require('./entity-B00Li04j.cjs');
-const require_queryBuilder = require('./queryBuilder-DbUMEZln.cjs');
+const require_queryBuilder = require('./queryBuilder-BXR-HxD9.cjs');
 require('./entity-B7G8q_Eo.cjs');
 require('./types-NRqymi6S.cjs');
-const require_payload = require('./payload-KC14SDlN.cjs');
+const require_payload = require('./payload-Cvrir3Q-.cjs');
 let viem = require("viem");
 let viem_actions = require("viem/actions");
 
@@ -102,7 +102,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}
@@ -112,7 +112,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 },
 *     {
@@ -143,7 +143,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_key.validateSalt);
+		return salts.map(require_key.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}`);
@@ -358,14 +358,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"
@@ -429,13 +429,29 @@ async function deleteEntity(client, data, txParams) {
 	};
 }
 
+//#endregion
+//#region src/actions/wallet/executeBatch.ts
+const logger$2 = require_logger.getLogger("actions:wallet:execute-batch");
+async function executeBatch(client, data, txParams) {
+	const { receipt, createdEntityKeys } = await require_advanced.sendArkivTransaction(client, data, txParams);
+	logger$2("Receipt from executeBatch %o", receipt);
+	return {
+		txHash: receipt.transactionHash,
+		createdEntities: createdEntityKeys,
+		patchedEntities: (data.patches ?? []).map((p) => p.entityKey),
+		deletedEntities: (data.deletes ?? []).map((d) => d.entityKey),
+		extendedEntities: (data.extensions ?? []).map((e) => e.entityKey),
+		ownershipChanges: (data.ownershipChanges ?? []).map((o) => o.entityKey)
+	};
+}
+
 //#endregion
 //#region src/actions/wallet/extendEntity.ts
-const logger$2 = require_logger.getLogger("actions:wallet:extend-entity");
+const logger$1 = require_logger.getLogger("actions:wallet:extend-entity");
 async function extendEntity(client, data, txParams) {
-	logger$2("extendEntity %o", data);
+	logger$1("extendEntity %o", data);
 	const { receipt, extendedExpiries } = await require_advanced.sendArkivTransaction(client, { extensions: [data] }, txParams);
-	logger$2("Receipt from extendEntity %o", receipt);
+	logger$1("Receipt from extendEntity %o", receipt);
 	const [expiresAt] = extendedExpiries;
 	if (expiresAt === void 0) throw new require_logger.EntityMutationError(`Transaction ${receipt.transactionHash} succeeded, but the receipt did not carry the expected entity expiry.`);
 	return {
@@ -445,22 +461,6 @@ async function extendEntity(client, data, txParams) {
 	};
 }
 
-//#endregion
-//#region src/actions/wallet/mutateEntities.ts
-const logger$1 = require_logger.getLogger("actions:wallet:mutate-entities");
-async function mutateEntities(client, data, txParams) {
-	const { receipt, createdEntityKeys } = await require_advanced.sendArkivTransaction(client, data, txParams);
-	logger$1("Receipt from mutateEntities %o", receipt);
-	return {
-		txHash: receipt.transactionHash,
-		createdEntities: createdEntityKeys,
-		patchedEntities: (data.patches ?? []).map((p) => p.entityKey),
-		deletedEntities: (data.deletes ?? []).map((d) => d.entityKey),
-		extendedEntities: (data.extensions ?? []).map((e) => e.entityKey),
-		ownershipChanges: (data.ownershipChanges ?? []).map((o) => o.entityKey)
-	};
-}
-
 //#endregion
 //#region src/actions/wallet/patchEntity.ts
 const logger = require_logger.getLogger("actions:wallet:patch-entity");
@@ -483,7 +483,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),
 		advanced: walletAdvancedActions(client)
 	};
 }
@@ -492,16 +492,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"
@@ -563,6 +561,7 @@ exports.MAX_PAYLOAD_BYTES = require_attributes.MAX_PAYLOAD_BYTES;
 exports.MAX_SALT = require_key.MAX_SALT;
 exports.MAX_STRING_BYTES = require_attributes.MAX_STRING_BYTES;
 exports.MissingValueError = require_attributes.MissingValueError;
+exports.NO_SALT = require_key.NO_SALT;
 exports.NoEntityFoundError = require_logger.NoEntityFoundError;
 exports.NoMoreResultsError = require_logger.NoMoreResultsError;
 exports.NoRandomSourceError = require_errors.NoRandomSourceError;