@arkiv-network/sdk 0.6.8-dev.5 → 0.7.0-dev.1

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["logger","bytes: Uint8Array","rpcQueryOptions: RpcQueryOptions","query","logger","logger","zlib: typeof import(\"zlib\") | null","brotli: BrotliWasmType | null","logger","logger","logger","logger","logger","logger","createdEntities: Hex[]","updatedEntities: Hex[]","deletedEntities: Hex[]","extendedEntities: Hex[]","ownershipChanges: Hex[]","chains"],"sources":["../src/actions/public/getBlockTiming.ts","../src/actions/public/getEntity.ts","../src/actions/public/getEntityCount.ts","../src/actions/public/query.ts","../src/actions/public/subscribeEntityEvents.ts","../src/clients/decorators/arkivPublic.ts","../src/clients/createPublicClient.ts","../src/utils/compression.ts","../src/utils/validation.ts","../src/utils/arkivTransactions.ts","../src/actions/wallet/changeOwnership.ts","../src/actions/wallet/createEntity.ts","../src/actions/wallet/deleteEntity.ts","../src/actions/wallet/extendEntity.ts","../src/actions/wallet/mutateEntities.ts","../src/actions/wallet/updateEntity.ts","../src/clients/decorators/arkivWallet.ts","../src/clients/createWalletClient.ts","../src/utils/chains.ts"],"sourcesContent":["import type { ArkivClient } from \"../../clients/baseClient\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:public:get-block-timing\")\n\nexport type GetBlockTimingReturnType = {\n  currentBlock: bigint\n  currentBlockTime: number\n  blockDuration: number\n}\n\nexport async function getBlockTiming(client: ArkivClient) {\n  const blockTiming = await client.request({\n    method: \"arkiv_getBlockTiming\",\n    params: [],\n  })\n  logger(\"Block timing %o\", blockTiming)\n  return {\n    currentBlock: BigInt(blockTiming.current_block),\n    currentBlockTime: blockTiming.current_block_time,\n    blockDuration: blockTiming.duration,\n  }\n}\n","import { bytesToHex, type Hex, hexToBytes } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport { NoEntityFoundError } from \"../../errors\"\nimport { entityFromRpcResult } from \"../../utils/entities\"\n\nexport async function getEntity(client: ArkivClient, key: Hex) {\n  // Normalize the key into bytes\n  let bytes: Uint8Array\n  try {\n    bytes = hexToBytes(key)\n  } catch {\n    throw new Error(`Invalid key format: ${key}. Key must be a valid hex string.`)\n  }\n\n  if (bytes.length !== 32) {\n    throw new Error(\n      `Invalid key length: ${bytes.length} bytes. Key must be 32 bytes (64 hex characters) long.`,\n    )\n  }\n\n  const hexKey = bytesToHex(bytes)\n\n  const result = await client.request({\n    method: \"arkiv_query\",\n    params: [\n      `$key = ${hexKey}`,\n      {\n        includeData: {\n          key: true,\n          attributes: true,\n          payload: true,\n          contentType: true,\n          expiration: true,\n          owner: true,\n          creator: true,\n          createdAtBlock: true,\n          lastModifiedAtBlock: true,\n          transactionIndexInBlock: true,\n          operationIndexInTransaction: true,\n        },\n      },\n    ],\n  })\n\n  if (!result.data.length) {\n    throw new NoEntityFoundError()\n  }\n\n  return await entityFromRpcResult(result.data[0])\n}\n","import type { ArkivClient } from \"../../clients/baseClient\"\n\nexport async function getEntityCount(client: ArkivClient) {\n  const count = await client.request({\n    method: \"arkiv_getEntityCount\",\n    params: [],\n  })\n\n  return count\n}\n","import { numberToHex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { Entity } from \"../../types/entity\"\nimport type { RpcQueryOptions } from \"../../types/rpcSchema\"\nimport { entityFromRpcResult } from \"../../utils/entities\"\n\nexport type QueryOptionsIncludeData = {\n  attributes?: boolean\n  payload?: boolean\n  metadata?: boolean\n}\n/**\n * @deprecated Server-side ordering is not supported by the network. Sort the fetched\n * entities in JavaScript instead (e.g. `entities.sort(...)`). This type will be removed\n * in a future release.\n */\nexport type QueryOptionsOrderBy = {\n  name: string\n  type: \"string\" | \"numeric\"\n  desc: \"asc\" | \"desc\"\n}\n\nexport type QueryOptions = {\n  includeData?: QueryOptionsIncludeData\n  atBlock?: bigint\n  /**\n   * @deprecated Server-side ordering is not supported by the network, so this option has no\n   * effect on the returned order. Sort the fetched entities in JavaScript instead\n   * (e.g. `entities.sort(...)`). This option will be removed in a future release.\n   */\n  orderBy?: QueryOptionsOrderBy[]\n  resultsPerPage?: number | undefined\n  cursor?: string | undefined\n}\n\nexport type QueryReturnType = {\n  entities: Entity[]\n  cursor: string | undefined\n  blockNumber: bigint | undefined\n}\n\nexport async function query(client: ArkivClient, query: string, queryOptions?: QueryOptions) {\n  const rpcQueryOptions: RpcQueryOptions = {\n    includeData: {\n      key: true,\n      payload: queryOptions?.includeData?.payload ?? true,\n      attributes: queryOptions?.includeData?.attributes ?? false,\n      contentType: queryOptions?.includeData?.metadata ?? false,\n      expiration: queryOptions?.includeData?.metadata ?? false,\n      owner: queryOptions?.includeData?.metadata ?? false,\n      creator: queryOptions?.includeData?.metadata ?? false,\n      createdAtBlock: queryOptions?.includeData?.metadata ?? false,\n      lastModifiedAtBlock: queryOptions?.includeData?.metadata ?? false,\n      transactionIndexInBlock: queryOptions?.includeData?.metadata ?? false,\n      operationIndexInTransaction: queryOptions?.includeData?.metadata ?? false,\n    },\n    ...(queryOptions?.atBlock !== undefined && { atBlock: numberToHex(queryOptions.atBlock) }),\n    ...(queryOptions?.orderBy && {\n      orderBy: queryOptions?.orderBy.map((order) => ({\n        name: order.name,\n        type: order.type,\n        desc: order.desc === \"desc\",\n      })),\n    }),\n    ...(queryOptions?.resultsPerPage !== undefined && {\n      resultsPerPage: numberToHex(queryOptions.resultsPerPage),\n    }),\n    ...(queryOptions?.cursor !== undefined && { cursor: queryOptions?.cursor }),\n  }\n\n  const result = await client.request({\n    method: \"arkiv_query\",\n    params: [query, rpcQueryOptions],\n  })\n\n  const entities = await Promise.all(result.data.map((entity) => entityFromRpcResult(entity)))\n\n  return {\n    entities,\n    cursor: result.cursor,\n    blockNumber: BigInt(result.blockNumber),\n  }\n}\n","import { decodeEventLog, type Hex, parseAbi, toHex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { PublicArkivClient } from \"../../clients/createPublicClient\"\nimport type {\n  OnEntityCreatedEvent,\n  OnEntityDeletedEvent,\n  OnEntityExpiredEvent,\n  OnEntityExpiresInExtendedEvent,\n  OnEntityOwnerChangedEvent,\n  OnEntityUpdatedEvent,\n} from \"../../types/events\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:public:subscribe-entity-events\")\n\nexport const arkivABI = parseAbi([\n  \"event ArkivEntityCreated(uint256 indexed entityKey, address indexed ownerAddress, uint256 expirationBlock, uint256 cost)\",\n  \"event ArkivEntityUpdated(uint256 indexed entityKey, address indexed ownerAddress, uint256 oldExpirationBlock, uint256 newExpirationBlock, uint256 cost)\",\n  \"event ArkivEntityExpired(uint256 indexed entityKey, address indexed ownerAddress)\",\n  \"event ArkivEntityDeleted(uint256 indexed entityKey, address indexed ownerAddress)\",\n  \"event ArkivEntityBTLExtended(uint256 indexed entityKey, address indexed ownerAddress, uint256 oldExpirationBlock, uint256 newExpirationBlock, uint256 cost)\",\n  \"event ArkivEntityOwnerChanged(uint256 indexed entityKey, address indexed oldOwnerAddress, address indexed newOwnerAddress)\",\n])\n\nexport async function subscribeEntityEvents(\n  client: ArkivClient,\n  {\n    onError,\n    onEntityCreated,\n    onEntityUpdated,\n    onEntityDeleted,\n    onEntityExpired,\n    onEntityExpiresInExtended,\n    onEntityOwnerChanged,\n  }: {\n    onError: ((error: Error) => void) | undefined\n    onEntityCreated?: ((event: OnEntityCreatedEvent) => void) | undefined\n    onEntityUpdated?: ((event: OnEntityUpdatedEvent) => void) | undefined\n    onEntityDeleted?: ((event: OnEntityDeletedEvent) => void) | undefined\n    onEntityExpired?: ((event: OnEntityExpiredEvent) => void) | undefined\n    onEntityExpiresInExtended?: ((event: OnEntityExpiresInExtendedEvent) => void) | undefined\n    onEntityOwnerChanged?: ((event: OnEntityOwnerChangedEvent) => void) | undefined\n  },\n  pollingInterval?: number,\n  fromBlock?: bigint,\n): Promise<() => void> {\n  const unsubscribe = (client as PublicArkivClient).watchEvent({\n    pollingInterval: pollingInterval ?? 1000,\n    fromBlock,\n    events: arkivABI,\n    onLogs: (logs) => {\n      logger(\"logs from subscribeEntityEvents %o\", logs)\n      for (const log of logs) {\n        const event = decodeEventLog({\n          abi: arkivABI,\n          topics: log.topics as [Hex, ...Hex[]] | [],\n          data: log.data,\n        })\n        logger(\"event from subscribeEntityEvents %o\", event)\n        switch (event.eventName) {\n          case \"ArkivEntityCreated\":\n            onEntityCreated?.({\n              entityKey: toHex(event.args.entityKey, { size: 32 }),\n              owner: event.args.ownerAddress,\n              expirationBlock: Number(event.args.expirationBlock),\n              cost: event.args.cost,\n            })\n            break\n          case \"ArkivEntityUpdated\":\n            onEntityUpdated?.({\n              entityKey: toHex(event.args.entityKey, { size: 32 }),\n              owner: event.args.ownerAddress,\n              oldExpirationBlock: Number(event.args.oldExpirationBlock),\n              newExpirationBlock: Number(event.args.newExpirationBlock),\n              cost: event.args.cost,\n            })\n            break\n          case \"ArkivEntityDeleted\":\n            onEntityDeleted?.({\n              entityKey: toHex(event.args.entityKey, { size: 32 }),\n              owner: event.args.ownerAddress,\n            })\n            break\n          case \"ArkivEntityBTLExtended\":\n            onEntityExpiresInExtended?.({\n              entityKey: toHex(event.args.entityKey, { size: 32 }),\n              owner: event.args.ownerAddress,\n              oldExpirationBlock: Number(event.args.oldExpirationBlock),\n              newExpirationBlock: Number(event.args.newExpirationBlock),\n              cost: event.args.cost,\n            })\n            break\n          case \"ArkivEntityExpired\":\n            onEntityExpired?.({\n              entityKey: toHex(event.args.entityKey, { size: 32 }),\n              owner: event.args.ownerAddress,\n            })\n            break\n          case \"ArkivEntityOwnerChanged\":\n            onEntityOwnerChanged?.({\n              entityKey: toHex(event.args.entityKey, { size: 32 }),\n              oldOwner: event.args.oldOwnerAddress,\n              newOwner: event.args.newOwnerAddress,\n            })\n            break\n          default:\n            console.warn(\"unknown event from subscribeEntityEvents\", event)\n            break\n        }\n      }\n    },\n    onError: (error) => {\n      console.error(\"error from subscribeEntityEvents\", error)\n      onError?.(error)\n    },\n  })\n\n  return unsubscribe\n}\n","import type { Account, Chain, Client, Hex, PublicActions, Transport } from \"viem\"\nimport { getBlockTiming } from \"../../actions/public/getBlockTiming\"\nimport { getEntity } from \"../../actions/public/getEntity\"\nimport { getEntityCount } from \"../../actions/public/getEntityCount\"\nimport { type QueryOptions, type QueryReturnType, query } from \"../../actions/public/query\"\nimport { subscribeEntityEvents } from \"../../actions/public/subscribeEntityEvents\"\nimport { QueryBuilder, SelectQueryBuilder } from \"../../query/queryBuilder\"\nimport type { EntitySelection, FullEntity, ProjectedEntity, SelectArg } from \"../../query/selection\"\nimport type { Entity } from \"../../types/entity\"\nimport type {\n  OnEntityCreatedEvent,\n  OnEntityDeletedEvent,\n  OnEntityExpiredEvent,\n  OnEntityExpiresInExtendedEvent,\n  OnEntityUpdatedEvent,\n} from \"../../types/events\"\n\nexport type PublicArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n> = Pick<\n  PublicActions<transport, chain, account>,\n  | \"getBalance\"\n  | \"getBlock\"\n  | \"getBlockNumber\"\n  | \"getChainId\"\n  | \"getLogs\"\n  | \"getTransaction\"\n  | \"getTransactionCount\"\n  | \"getTransactionReceipt\"\n  | \"waitForTransactionReceipt\"\n  | \"watchEvent\"\n> & {\n  /**\n   * Returns the entity with the given key.\n   *\n   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/getEntity\n   *\n   * @param key - The entity key (hex string)\n   * @returns The entity with the given key. {@link Entity}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const entity = await client.getEntity(\"0x123\")\n   * // {\n   * //   key: \"0x123\",\n   * //   value: \"0x123\",\n   * // }\n   */\n  getEntity: (key: Hex) => Promise<Entity>\n\n  /**\n   * Returns a SelectQueryBuilder for building and executing queries — the recommended way to\n   * read entities. You declare up front which parts of an entity you want returned, so results\n   * always contain exactly the data you asked for.\n   *\n   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/query\n   *\n   * @param selection - What to include in the results. Omit it (or pass `\"*\"`) to select everything,\n   *   or pass an object to select specific parts (at least one field is required). Every part is\n   *   opt-in, including the `key`. The selection is flat — each field maps to an entity field.\n   *   {@link SelectArg}\n   * @returns A SelectQueryBuilder instance for building and executing queries. {@link SelectQueryBuilder}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   * import { eq } from 'arkiv/query'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * // select everything\n   * await client.select().where(eq(\"category\", \"docs\")).fetch()\n   * await client.select(\"*\").where(eq(\"category\", \"docs\")).fetch()\n   * // only the key\n   * await client.select({ key: true }).where(eq(\"category\", \"docs\")).fetch()\n   * // select specific fields — result typed { owner: Hex; attributes: Attribute[] }\n   * await client.select({ owner: true, attributes: true }).fetch()\n   * // a single field — result typed { owner: Hex }\n   * await client.select({ owner: true }).fetch()\n   */\n  select: {\n    /** Select every field. Pass nothing or `\"*\"`; the returned entities contain all fields. */\n    (selection?: \"*\"): SelectQueryBuilder<FullEntity>\n    /**\n     * Pick the entity fields to return. Set the ones you want to `true` (at least one is required);\n     * the result is typed to exactly those fields, so reading anything else is a compile error.\n     *\n     * Available fields: `key`, `owner`, `creator`, `contentType`, `payload`, `attributes`,\n     * `expiresAtBlock`, `createdAtBlock`, `lastModifiedAtBlock`, `transactionIndexInBlock`,\n     * `operationIndexInTransaction`.\n     *\n     * Pass the selection inline so its fields stay literal `true`. A selection stored in a `let`/\n     * `const` variable widens to `boolean` and the result type can no longer be narrowed — annotate\n     * it `as const` (e.g. `const sel = { owner: true } as const`) in that case.\n     *\n     * @example\n     * client.select({ owner: true, attributes: true }) // entities typed { owner, attributes }\n     * client.select({ key: true, payload: true })       // includes payload → toText()/toJson() too\n     */\n    <const S extends EntitySelection>(selection: S): SelectQueryBuilder<ProjectedEntity<S>>\n    /**\n     * Dynamic selection: accepts a value typed {@link SelectArg} (e.g. built at runtime). The\n     * result cannot be narrowed in this case, so the entities are typed as the full entity.\n     */\n    (selection: SelectArg): SelectQueryBuilder<FullEntity>\n  }\n\n  /**\n   * Returns a QueryBuilder instance for building and executing queries.\n   * The QueryBuilder object follows the Builder pattern, allowing you to chain methods to build a query and then execute it.\n   *\n   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/query\n   *\n   * @deprecated Use {@link select} instead. `buildQuery()` returns only the entity `key` unless\n   * you remember to opt in to data with `withAttributes()`/`withMetadata()`/`withPayload()`, which\n   * is an easy mistake. `select()` makes the selection explicit. This method remains for backwards\n   * compatibility and will be removed in a future release.\n   *\n   * @returns A QueryBuilder instance for building and executing queries. {@link QueryBuilder}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const query = client.buildQuery()\n   * const entities = await query.where(\"key\", \"=\", \"value\").ownedBy(\"0x123\").fetch()\n   *\n   */\n  buildQuery: () => QueryBuilder\n\n  /**\n   * Returns a QueryResult instance for fetching the results of a raw query.\n   * If no query options are provided, all payload is included, but no metadata (like owner, expiredAt, etc.) and attributes.\n   * @param query - The raw query string\n   * @param queryOptions - The optional query options - {@link QueryOptions}\n   * @returns A QueryReturnType instance - {@link QueryReturnType}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const queryResult = client.query('key = value && $owner = 0x123')\n   * // queryResult = { entities: [{ key: \"0x123\", value: \"0x123\" }], cursor: undefined, blockNumber: undefined }\n   * const queryResultWithOptions = client.query('key = value && $owner = 0x123', {\n   *   includeData: {\n   *     attributes: false,\n   *     payload: true,\n   *     metadata: true,\n   *   },\n   *   resultsPerPage: 10,\n   *   cursor: undefined,\n   *   atBlock: undefined,\n   * })\n   * // queryResultWithOptions = { entities: [{ key: \"0x123\", value: \"0x123\" }], cursor: \"...\", blockNumber: 32223n }\n   */\n  query: (query: string, queryOptions?: QueryOptions) => Promise<QueryReturnType>\n\n  /**\n   * Returns the number of entities in the DBChain.\n   * @returns The number of entities in the DBChain\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const entityCount = await client.getEntityCount()\n   * // entityCount = 0\n   */\n  getEntityCount: () => Promise<number>\n\n  /**\n   * Returns the current block timing.\n   * @returns The current block timing. {@link GetBlockTimingReturnType}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const blockTiming = await client.getBlockTiming()\n   * // {\n   * //   currentBlock: 10n, // block number\n   * //   currentBlockTime: 1234567890, // block timestamp\n   * //   blockDuration: 2, // in seconds\n   * // }\n   */\n  getBlockTiming: () => Promise<{\n    currentBlock: bigint\n    currentBlockTime: number\n    blockDuration: number\n  }>\n\n  /**\n   * Subscribes to entity events.\n   * Takes an object with event handlers: {onError, onEntityCreated, onEntityUpdated, onEntityDeleted, onEntityExpiresInExtended}\n   * @param pollingInterval - The polling interval in milliseconds\n   * @param fromBlock - The block number to start from\n   * @returns A function to unsubscribe from the events\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const unsubscribe = await client.subscribeEntityEvents({\n   *   onError: (error) => console.error(\"subscribeEntityEvents error\", error),\n   * })\n   * unsubscribe() // unsubscribe from the events\n   */\n  subscribeEntityEvents: (\n    {\n      onError,\n      onEntityCreated,\n      onEntityUpdated,\n      onEntityDeleted,\n      onEntityExpiresInExtended,\n    }: {\n      onError?: (error: Error) => void\n      onEntityCreated?: (event: OnEntityCreatedEvent) => void\n      onEntityUpdated?: (event: OnEntityUpdatedEvent) => void\n      onEntityDeleted?: (event: OnEntityDeletedEvent) => void\n      onEntityExpired?: (event: OnEntityExpiredEvent) => void\n      onEntityExpiresInExtended?: (event: OnEntityExpiresInExtendedEvent) => void\n    },\n    pollingInterval?: number,\n    fromBlock?: bigint,\n  ) => Promise<() => void>\n}\n\nexport function publicArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n>(client: Client<transport, chain, account>) {\n  return {\n    getEntity: (key: Hex) => getEntity(client, key),\n    query: (rawQuery: string, queryOptions?: QueryOptions) => query(client, rawQuery, queryOptions),\n    buildQuery: () => new QueryBuilder(client),\n    select: (selection?: SelectArg) => new SelectQueryBuilder(client, selection),\n    getBlockTiming: () => getBlockTiming(client),\n    getEntityCount: () => getEntityCount(client),\n    subscribeEntityEvents: (\n      {\n        onError,\n        onEntityCreated,\n        onEntityUpdated,\n        onEntityDeleted,\n        onEntityExpired,\n        onEntityExpiresInExtended,\n      }: {\n        onError?: (error: Error) => void\n        onEntityCreated?: (event: OnEntityCreatedEvent) => void\n        onEntityUpdated?: (event: OnEntityUpdatedEvent) => void\n        onEntityDeleted?: (event: OnEntityDeletedEvent) => void\n        onEntityExpired?: (event: OnEntityExpiredEvent) => void\n        onEntityExpiresInExtended?: (event: OnEntityExpiresInExtendedEvent) => void\n      },\n      pollingInterval?: number,\n      fromBlock?: bigint,\n    ) =>\n      subscribeEntityEvents(\n        client,\n        {\n          onError,\n          onEntityCreated,\n          onEntityUpdated,\n          onEntityDeleted,\n          onEntityExpired,\n          onEntityExpiresInExtended,\n        },\n        pollingInterval,\n        fromBlock,\n      ),\n  }\n}\n","import type {\n  Account,\n  Address,\n  Chain,\n  Client,\n  ParseAccount,\n  Prettify,\n  PublicClientConfig,\n  RpcSchema,\n  Transport,\n} from \"viem\"\nimport { createClient, publicActions } from \"viem\"\nimport type { ArkivRpcSchema } from \"../types/rpcSchema\"\nimport { type PublicArkivActions, publicArkivActions } from \"./decorators/arkivPublic\"\n\nexport type PublicArkivClient<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  accountOrAddress extends Account | undefined = undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n> = Prettify<\n  Client<transport, chain, accountOrAddress, rpcSchema, PublicArkivActions<transport, chain>>\n>\n\n/**\n * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).\n *\n * - Docs: https://docs.arkiv.network/ts-sdk/clients/public\n *\n * 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 [Braga JSON-RPC API](https://braga.holesky.arkiv.network/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).\n *\n * @param parameters - Configuration object for the public client (chain, transport, etc.)\n * @returns A Arkiv Public Client. {@link PublicArkivClient}\n *\n * @example\n * import { createPublicClient, http } from 'arkiv'\n * import { braga } from 'arkiv/chains'\n *\n * const client = createPublicClient({\n *   chain: braga,\n *   transport: http(),\n * })\n */\nexport function createPublicClient<\n  transport extends Transport,\n  chain extends Chain | undefined = undefined,\n  accountOrAddress extends Account | Address | undefined = undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n>(\n  parameters: PublicClientConfig<transport, chain, accountOrAddress, rpcSchema>,\n): PublicArkivClient<transport, chain, ParseAccount<accountOrAddress>, rpcSchema> {\n  const { key = \"public\", name = \"Public Client\" } = parameters\n  const client = createClient({\n    ...parameters,\n    key,\n    name,\n  })\n\n  return client.extend(publicActions).extend(publicArkivActions) as unknown as PublicArkivClient<\n    transport,\n    chain,\n    ParseAccount<accountOrAddress>,\n    rpcSchema\n  >\n}\n","// src/utils/compression.ts\n\nimport type { BrotliWasmType } from \"brotli-wasm\"\nimport { getLogger } from \"./logger\"\n\nconst logger = getLogger(\"utils:compression\")\n\n// Detect if we're in Node.js environment\nconst isNode = typeof process !== \"undefined\" && process.versions?.node != null\n\nlet zlib: typeof import(\"zlib\") | null = null\nlet brotli: BrotliWasmType | null = null\n\n// Lazy load zlib (Node.js only)\nasync function getZlib(): Promise<typeof import(\"zlib\") | null> {\n  if (!isNode) return null\n\n  if (!zlib) {\n    try {\n      zlib = await import(\"zlib\")\n    } catch (error) {\n      console.error(\"Error importing zlib\", error)\n      return null\n    }\n  }\n  return zlib\n}\n\n// Lazy load brotli-wasm (browser/fallback)\nasync function getBrotli(): Promise<BrotliWasmType | null> {\n  if (brotli) return brotli\n\n  try {\n    const brotliModule = await import(\"brotli-wasm\")\n    brotli = (brotliModule.default ? await brotliModule.default : brotliModule) as BrotliWasmType\n  } catch (error) {\n    console.error(\"Error importing brotli-wasm\", error)\n    return null\n  }\n\n  return brotli\n}\n\nexport async function compress(data: Uint8Array): Promise<Uint8Array> {\n  logger(\"Compressing data size %d\", data.length)\n\n  // Try Node.js zlib first (if available)\n  if (isNode) {\n    const zlibModule = await getZlib()\n    if (zlibModule) {\n      try {\n        // zlib.brotliCompress expects Buffer, returns Buffer\n        const buffer = Buffer.from(data)\n        const compressed = zlibModule.brotliCompressSync(buffer)\n        const result = new Uint8Array(compressed)\n        logger(\"Brotli compressed with zlib size %d\", result.length)\n        return result\n      } catch (error) {\n        console.warn(\"zlib compression failed, falling back to brotli-wasm\", error)\n      }\n    }\n  }\n\n  // Fallback to brotli-wasm (browser or if zlib fails)\n  const brotliInstance = await getBrotli()\n  if (!brotliInstance) {\n    console.warn(\"Brotli instance not found, not compressing data\")\n    return data\n  }\n\n  const brotliCompressed = brotliInstance.compress(data)\n  logger(\"Brotli compressed with wasm size %d\", brotliCompressed.length)\n  return brotliCompressed\n}\n\nexport async function decompress(data: Uint8Array): Promise<Uint8Array> {\n  // Try Node.js zlib first (if available)\n  if (isNode) {\n    const zlibModule = await getZlib()\n    if (zlibModule) {\n      try {\n        // zlib.brotliDecompress expects Buffer, returns Buffer\n        const buffer = Buffer.from(data)\n        const decompressed = zlibModule.brotliDecompressSync(buffer)\n        const result = new Uint8Array(decompressed)\n        logger(\"Brotli decompressed with zlib size %d\", result.length)\n        return result\n      } catch (error) {\n        console.warn(\"zlib decompression failed, falling back to brotli-wasm\", error)\n      }\n    }\n  }\n\n  // Fallback to brotli-wasm (browser or if zlib fails)\n  const brotliInstance = await getBrotli()\n  if (!brotliInstance) {\n    console.warn(\"Brotli instance not found, not decompressing data\")\n    return data\n  }\n\n  return brotliInstance.decompress(data)\n}\n","import { BLOCK_TIME } from \"../consts\"\nimport { InvalidAttributeError, InvalidExpirationError } from \"../errors\"\nimport type { Attribute } from \"../types\"\n\n/**\n * Expiration on Arkiv is measured in blocks (1 block =\n * 2 seconds), so the value must be a positive integer that is\n * a multiple of the block time.\n *\n * @param expiresIn - The expiration in seconds.\n * @throws {InvalidExpirationError} If the value is not a positive integer that\n * is a multiple of the block time.\n */\nexport function validateExpiresIn(expiresIn: number): void {\n  if (!Number.isInteger(expiresIn) || expiresIn <= 0 || expiresIn % BLOCK_TIME !== 0) {\n    throw new InvalidExpirationError(expiresIn)\n  }\n}\n\n/**\n * Validates a single attribute. Arkiv supports string and number attribute\n * values, but numeric values must be integers.\n *\n * @param attribute - The attribute to validate.\n * @throws {InvalidAttributeError} If the attribute has a non-integer numeric\n * value.\n */\nexport function validateAttribute(attribute: Attribute): void {\n  if (typeof attribute.value === \"number\" && !Number.isInteger(attribute.value)) {\n    throw new InvalidAttributeError(attribute.key, attribute.value)\n  }\n}\n","import { type Hex, hexToString, TransactionExecutionError, toBytes, toHex, toRlp } from \"viem\"\nimport type { ChangeOwnershipParameters } from \"../actions/wallet/changeOwnership\"\nimport type { CreateEntityParameters } from \"../actions/wallet/createEntity\"\nimport type { DeleteEntityParameters } from \"../actions/wallet/deleteEntity\"\nimport type { ExtendEntityParameters } from \"../actions/wallet/extendEntity\"\nimport type { UpdateEntityParameters } from \"../actions/wallet/updateEntity\"\nimport type { ArkivClient } from \"../clients/baseClient\"\nimport type { WalletArkivClient } from \"../clients/createWalletClient\"\nimport { ARKIV_ADDRESS, BLOCK_TIME } from \"../consts\"\nimport { EntityMutationError } from \"../errors\"\nimport type { TxParams } from \"../types\"\nimport { compress } from \"./compression\"\nimport { getLogger } from \"./logger\"\nimport { validateAttribute, validateExpiresIn } from \"./validation\"\n\nconst logger = getLogger(\"utils:arkiv-transactions\")\n\nexport function opsToTxData({\n  creates,\n  updates,\n  deletes,\n  extensions,\n  ownershipChanges,\n}: {\n  creates?: CreateEntityParameters[]\n  updates?: UpdateEntityParameters[]\n  deletes?: DeleteEntityParameters[]\n  extensions?: ExtendEntityParameters[]\n  ownershipChanges?: ChangeOwnershipParameters[]\n}) {\n  function formatAttributes<T extends string | number | bigint | boolean>(attribute: {\n    key: string\n    value: T\n  }): [Hex, Hex] {\n    return [\n      toHex(attribute.key),\n      toHex(typeof attribute.value === \"number\" && attribute.value === 0 ? \"\" : attribute.value),\n    ]\n  }\n\n  const payload = [\n    //creates\n    (creates ?? []).map((item) => {\n      validateExpiresIn(item.expiresIn)\n      item.attributes.forEach(validateAttribute)\n      return [\n        toHex(item.expiresIn / BLOCK_TIME),\n        toHex(item.contentType),\n        toHex(item.payload),\n        item.attributes\n          .filter((attribute) => typeof attribute.value === \"string\")\n          .map(formatAttributes),\n        item.attributes\n          .filter((attribute) => typeof attribute.value === \"number\")\n          .map(formatAttributes),\n      ]\n    }),\n    //updates\n    (updates ?? []).map((item) => {\n      validateExpiresIn(item.expiresIn)\n      item.attributes.forEach(validateAttribute)\n      return [\n        item.entityKey,\n        toHex(item.contentType),\n        toHex(item.expiresIn / BLOCK_TIME),\n        toHex(item.payload),\n        item.attributes\n          .filter((attribute) => typeof attribute.value === \"string\")\n          .map(formatAttributes),\n        item.attributes\n          .filter((attribute) => typeof attribute.value === \"number\")\n          .map(formatAttributes),\n      ]\n    }),\n    //deletes\n    (deletes ?? []).map((item) => item.entityKey),\n    //extends\n    (extensions ?? []).map((item) => {\n      validateExpiresIn(item.expiresIn)\n      return [item.entityKey, toHex(item.expiresIn / BLOCK_TIME)]\n    }),\n    //ownershipChanges TODO\n    (ownershipChanges ?? []).map((item) => [item.entityKey, item.newOwner]),\n  ]\n\n  logger(\"txData to send as RLP %o length %d\", payload, payload.length)\n\n  return toRlp(payload)\n}\n\nexport async function sendArkivTransaction(client: ArkivClient, data: Hex, txParams?: TxParams) {\n  if (!client.account) throw new Error(\"Account required\")\n  const walletClient = client as WalletArkivClient\n\n  logger(\"Sending transaction %o\", {\n    account: client.account,\n    chain: client.chain,\n    to: ARKIV_ADDRESS,\n    value: 0n,\n    data,\n    ...txParams,\n  })\n\n  try {\n    const compressed = await compress(toBytes(data))\n    const txHash = await walletClient.sendTransaction({\n      account: client.account,\n      chain: client.chain,\n      to: ARKIV_ADDRESS,\n      value: 0n,\n      data: toHex(compressed),\n      ...txParams,\n    })\n\n    const receipt = await walletClient.waitForTransactionReceipt({ hash: txHash })\n    logger(\"Tx receipt %o\", receipt)\n    if (receipt.status === \"reverted\") {\n      try {\n        const callResult = await walletClient.call({\n          account: client.account,\n          to: ARKIV_ADDRESS,\n          value: 0n,\n          data: toHex(compressed),\n          ...txParams,\n        })\n        throw new EntityMutationError(\n          `Transaction ${receipt.transactionHash} reverted. Please make sure the data for entities doesn't contain invalid characters or invalid data types.\n          Reason: ${callResult.data ? hexToString(callResult.data) : \"No reason provided by backend.\"}`,\n        )\n      } catch (err) {\n        const error = err as { cause?: { details?: string } }\n        const reason = error.cause?.details ?? \"No reason provided by backend.\"\n        logger(\n          \"Error while calling to get more details about reverted transaction. Reason: %s\",\n          reason,\n        )\n        throw new EntityMutationError(\n          `Transaction ${receipt.transactionHash} reverted. Reason: ${reason}`,\n        )\n      }\n    }\n\n    return receipt\n  } catch (error) {\n    let message = \"Transaction failed\"\n    if (error instanceof TransactionExecutionError) {\n      message += `: ${error.details}`\n    } else if (error instanceof EntityMutationError) {\n      throw error\n    }\n\n    logger(\"%s Detailed error stack: %o\", message, error)\n    throw new EntityMutationError(message)\n  }\n}\n","import type { Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { opsToTxData, sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:change-ownership\")\n\n/**\n * Parameters for the deleteEntity function.\n * - entityKey: The key of the entity to delete.\n */\nexport type ChangeOwnershipParameters = {\n  entityKey: Hex\n  newOwner: Hex\n}\n\n/**\n * Return type for the deleteEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type ChangeOwnershipReturnType = {\n  entityKey: Hex\n  txHash: string\n}\n\nexport async function changeOwnership(\n  client: ArkivClient,\n  data: ChangeOwnershipParameters,\n  txParams?: TxParams,\n): Promise<ChangeOwnershipReturnType> {\n  logger(\"changeOwnership %o\", data)\n  const txData = opsToTxData({ ownershipChanges: [data] })\n  const receipt = await sendArkivTransaction(client, txData, txParams)\n\n  logger(\"Receipt from changeOwnership %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash,\n    entityKey: data.entityKey,\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { Attribute, MimeType, TxParams } from \"../../types\"\nimport { opsToTxData, sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:create-entity\")\n\n/**\n * Parameters for the createEntity function.\n * - payload: The payload of the entity.\n * - attributes: The attributes of the entity. Attribute values may be strings\n *   or numbers, but numeric values **must be integers**. To store a non-integer,\n *   scale it to an integer (e.g. `1.5` -> `1500`) to preserve numeric ordering,\n *   or pass it as a string (e.g. `\"1.5\"`). A non-integer numeric value throws an\n *   {@link InvalidAttributeError}.\n * - contentType: The content type of the entity.\n * - expiresIn: How long until the entity expires, in seconds. Because Arkiv\n *   measures expiration in blocks (1 block = 2 seconds), this **must be a\n *   positive integer and a multiple of the block time (2 seconds)**\n *   Invalid values throw an {@link InvalidExpirationError}.\n */\nexport type CreateEntityParameters = {\n  payload: Uint8Array\n  /** Entity attributes. Numeric values must be integers (scale non-integers, e.g. `1.5` -> `1500`, or use a string). Throws {@link InvalidAttributeError} otherwise. */\n  attributes: Attribute[]\n  contentType: MimeType | string\n  /** Seconds until expiry. Must be a positive integer and a multiple of the 2s block time.\n   * Throws {@link InvalidExpirationError} otherwise. */\n  expiresIn: number\n}\n\n/**\n * Return type for the createEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type CreateEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function createEntity(\n  client: ArkivClient,\n  data: CreateEntityParameters,\n  txParams?: TxParams,\n): Promise<CreateEntityReturnType> {\n  logger(\"createEntity %o\", data)\n  const txData = opsToTxData({ creates: [data] })\n  const receipt = await sendArkivTransaction(client, txData, txParams)\n\n  logger(\"Receipt from createEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: receipt.logs[0].topics[1] as Hex,\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { opsToTxData, sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:delete-entity\")\n\n/**\n * Parameters for the deleteEntity function.\n * - entityKey: The key of the entity to delete.\n */\nexport type DeleteEntityParameters = {\n  entityKey: Hex\n}\n\n/**\n * Return type for the deleteEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type DeleteEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function deleteEntity(\n  client: ArkivClient,\n  data: DeleteEntityParameters,\n  txParams?: TxParams,\n): Promise<DeleteEntityReturnType> {\n  logger(\"deleteEntity %o\", data)\n  const txData = opsToTxData({ deletes: [data] })\n  const receipt = await sendArkivTransaction(client, txData, txParams)\n\n  logger(\"Receipt from deleteEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: data.entityKey,\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { opsToTxData, sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:extend-entity\")\n\n/**\n * Parameters for the extendEntity function.\n * - entityKey: The key of the entity to extend.\n * - expiresIn: How long to extend the entity by, in seconds. Because Arkiv\n *   measures expiration in blocks (1 block = 2 seconds), this **must be a\n *   positive integer and a multiple of the block time (2 seconds)**.\n *   Invalid values throw an {@link InvalidExpirationError}.\n */\nexport type ExtendEntityParameters = {\n  entityKey: Hex\n  /** Seconds to extend by. Must be a positive integer and a multiple of the 2s block time.\n   * Throws {@link InvalidExpirationError} otherwise. */\n  expiresIn: number\n}\n\n/**\n * Return type for the extendEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type ExtendEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function extendEntity(\n  client: ArkivClient,\n  data: ExtendEntityParameters,\n  txParams?: TxParams,\n): Promise<ExtendEntityReturnType> {\n  logger(\"extendEntity %o\", data)\n  const txData = opsToTxData({ extensions: [data] })\n  const receipt = await sendArkivTransaction(client, txData, txParams)\n\n  logger(\"Receipt from extendEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: receipt.logs[0].topics[1] as Hex,\n  }\n}\n","import type { Hash, Hex, TransactionReceipt } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { opsToTxData, sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\nimport type { ChangeOwnershipParameters } from \"./changeOwnership\"\n\nconst logger = getLogger(\"actions:wallet:mutate-entities\")\n\nimport type { CreateEntityParameters } from \"./createEntity\"\nimport type { DeleteEntityParameters } from \"./deleteEntity\"\nimport type { ExtendEntityParameters } from \"./extendEntity\"\nimport type { UpdateEntityParameters } from \"./updateEntity\"\n\n/**\n * Parameters for the mutateEntities function.\n * - creates: The creates to perform.\n * - updates: The updates to perform.\n * - deletes: The deletes to perform.\n * - extensions: The extensions to perform.\n */\nexport type MutateEntitiesParameters = {\n  creates?: CreateEntityParameters[]\n  updates?: UpdateEntityParameters[]\n  deletes?: DeleteEntityParameters[]\n  extensions?: ExtendEntityParameters[]\n  ownershipChanges?: ChangeOwnershipParameters[]\n}\n\nfunction parseReceipt(receipt: TransactionReceipt, params: MutateEntitiesParameters) {\n  const createdEntities: Hex[] = []\n  const updatedEntities: Hex[] = []\n  const deletedEntities: Hex[] = []\n  const extendedEntities: Hex[] = []\n  const ownershipChanges: Hex[] = []\n\n  const totalCreates = params.creates?.length ?? 0\n  const totalUpdates = params.updates?.length ?? 0\n  const totalDeletes = params.deletes?.length ?? 0\n  const totalExtensions = params.extensions?.length ?? 0\n\n  // iterate over all logs and parse the event\n  // logs go in the following order: creates, deleted, updates, extends, ownership changes\n  for (let index = 0; index < receipt.logs.length; index++) {\n    const log = receipt.logs[index]\n\n    if (index < totalCreates) {\n      createdEntities.push(log.topics[1] as Hex)\n    } else if (index < totalCreates + totalDeletes) {\n      deletedEntities.push(log.topics[1] as Hex)\n    } else if (index < totalCreates + totalUpdates + totalDeletes) {\n      updatedEntities.push(log.topics[1] as Hex)\n    } else if (index < totalCreates + totalUpdates + totalDeletes + totalExtensions) {\n      extendedEntities.push(log.topics[1] as Hex)\n    } else {\n      ownershipChanges.push(log.topics[1] as Hex)\n    }\n  }\n\n  return { createdEntities, updatedEntities, deletedEntities, extendedEntities, ownershipChanges }\n}\n\n/**\n * Return type for the mutateEntities function.\n * - txHash: The transaction hash.\n * - createdEntities: The keys of the created entities.\n * - updatedEntities: The keys of the updated entities.\n * - deletedEntities: The keys of the deleted entities.\n * - extendedEntities: The keys of the extended entities.\n * - ownershipChanges: The keys of the ownership changes.\n */\nexport type MutateEntitiesReturnType = {\n  txHash: Hash\n  createdEntities: Hex[]\n  updatedEntities: Hex[]\n  deletedEntities: Hex[]\n  extendedEntities: Hex[]\n  ownershipChanges: Hex[]\n}\nexport async function mutateEntities(\n  client: ArkivClient,\n  data: MutateEntitiesParameters,\n  txParams?: TxParams,\n): Promise<MutateEntitiesReturnType> {\n  if (!data.creates && !data.updates && !data.deletes && !data.extensions) {\n    throw new Error(\"No operations to perform\")\n  }\n\n  const txData = opsToTxData({\n    creates: data.creates ?? [],\n    updates: data.updates ?? [],\n    deletes: data.deletes ?? [],\n    extensions: data.extensions ?? [],\n    ownershipChanges: data.ownershipChanges ?? [],\n  })\n\n  const receipt = await sendArkivTransaction(client, txData, txParams)\n\n  logger(\"Receipt from mutateEntities %o\", receipt)\n\n  const { createdEntities, updatedEntities, deletedEntities, extendedEntities, ownershipChanges } =\n    parseReceipt(receipt, data)\n  return {\n    txHash: receipt.transactionHash as Hash,\n    createdEntities,\n    updatedEntities,\n    deletedEntities,\n    extendedEntities,\n    ownershipChanges,\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { Attribute, MimeType, TxParams } from \"../../types\"\nimport { opsToTxData, sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:update-entity\")\n\n/**\n * Parameters for the updateEntity function.\n * - entityKey: The key of the entity to update.\n * - payload: The payload of the entity.\n * - attributes: The attributes of the entity. Attribute values may be strings\n *   or numbers, but numeric values **must be integers**. To store a non-integer,\n *   scale it to an integer (e.g. `1.5` -> `1500`) to preserve numeric ordering,\n *   or pass it as a string (e.g. `\"1.5\"`). A non-integer numeric value throws an\n *   {@link InvalidAttributeError}.\n * - contentType: The content type of the entity.\n * - expiresIn: How long until the entity expires, in seconds. Because Arkiv\n *   measures expiration in blocks (1 block = 2 seconds), this **must be a\n *   positive integer and a multiple of the block time (2 seconds)**.\n *   Invalid values throw an {@link InvalidExpirationError}.\n */\nexport type UpdateEntityParameters = {\n  entityKey: Hex\n  payload: Uint8Array\n  /** Entity attributes. Numeric values must be integers (scale non-integers, e.g. `1.5` -> `1500`, or use a string). Throws {@link InvalidAttributeError} otherwise. */\n  attributes: Attribute[]\n  contentType: MimeType | string\n  /** Seconds until expiry. Must be a positive integer and a multiple of the 2s block time.\n   * Throws {@link InvalidExpirationError} otherwise. */\n  expiresIn: number\n}\n\n/**\n * Return type for the updateEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type UpdateEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function updateEntity(\n  client: ArkivClient,\n  data: UpdateEntityParameters,\n  txParams?: TxParams,\n): Promise<UpdateEntityReturnType> {\n  logger(\"updateEntity %o\", data)\n  const txData = opsToTxData({ updates: [data] })\n  const receipt = await sendArkivTransaction(client, txData, txParams)\n\n  logger(\"Receipt from updateEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: receipt.logs[0].topics[1] as Hex,\n  }\n}\n","import type { Account, Chain, Client, PublicActions, Transport, WalletActions } from \"viem\"\nimport type {\n  ChangeOwnershipParameters,\n  ChangeOwnershipReturnType,\n} from \"../../actions/wallet/changeOwnership\"\nimport { changeOwnership } from \"../../actions/wallet/changeOwnership\"\nimport {\n  type CreateEntityParameters,\n  type CreateEntityReturnType,\n  createEntity,\n} from \"../../actions/wallet/createEntity\"\nimport type {\n  DeleteEntityParameters,\n  DeleteEntityReturnType,\n} from \"../../actions/wallet/deleteEntity\"\nimport { deleteEntity } from \"../../actions/wallet/deleteEntity\"\nimport type {\n  ExtendEntityParameters,\n  ExtendEntityReturnType,\n} from \"../../actions/wallet/extendEntity\"\nimport { extendEntity } from \"../../actions/wallet/extendEntity\"\nimport type {\n  MutateEntitiesParameters,\n  MutateEntitiesReturnType,\n} from \"../../actions/wallet/mutateEntities\"\nimport { mutateEntities } from \"../../actions/wallet/mutateEntities\"\nimport type {\n  UpdateEntityParameters,\n  UpdateEntityReturnType,\n} from \"../../actions/wallet/updateEntity\"\nimport { updateEntity } from \"../../actions/wallet/updateEntity\"\nimport type { TxParams } from \"../../types\"\n\nexport type WalletArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n> = Pick<PublicActions<transport, chain, account>, \"waitForTransactionReceipt\" | \"call\"> &\n  Pick<\n    WalletActions<chain, account>,\n    | \"addChain\"\n    | \"sendCalls\"\n    | \"waitForCallsStatus\"\n    | \"sendTransaction\"\n    | \"sendRawTransaction\"\n    | \"signMessage\"\n    | \"signTransaction\"\n  > & {\n    /**\n     * Creates a new entity.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/createEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity creation parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The created entity with transaction hash\n     *\n     * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer\n     * that is a multiple of the block time (2 seconds).\n     * @throws {InvalidAttributeError} If a numeric attribute value is not an\n     * integer.\n     *\n     * @example\n     * import { createPublicClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createPublicClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.createEntity({\n     *   payload: toBytes(JSON.stringify({ entity: { entityType: \"testType\", entityId: \"testId\" } })),\n     *   attributes: [{ key: \"testKey\", value: \"testValue\" }],\n     *   expiresIn: 1000,\n     * })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    createEntity: (\n      data: CreateEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<CreateEntityReturnType>\n\n    /**\n     * Updates the entity with the given key.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/updateEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity update parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The updated entity with transaction hash\n     *\n     * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer\n     * that is a multiple of the block time (2 seconds).\n     * @throws {InvalidAttributeError} If a numeric attribute value is not an\n     * integer.\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     */\n    updateEntity: (\n      data: UpdateEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<UpdateEntityReturnType>\n\n    /**\n     * Deletes the entity with the given key.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/deleteEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity deletion parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The deleted entity with transaction hash\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.deleteEntity({ entityKey: \"0x123\" })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    deleteEntity: (\n      data: DeleteEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<DeleteEntityReturnType>\n\n    /**\n     * Extends the entity with the given key.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/extendEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity update parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The updated entity with transaction hash\n     *\n     * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer\n     * that is a multiple of the block time (2 seconds).\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.extendEntity(\"0x123\", {\n     *   expiresIn: 1000,\n     * })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    extendEntity: (\n      data: ExtendEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<ExtendEntityReturnType>\n\n    /**\n     * Changes the ownership of the entity with the given address.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/changeOwnership\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The ownership change parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The entity with updated ownership and transaction hash\n     */\n    changeOwnership: (\n      data: ChangeOwnershipParameters,\n      txParams?: TxParams,\n    ) => Promise<ChangeOwnershipReturnType>\n\n    /**\n     * Mutates the entities with the given keys.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/mutateEntities\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The mutation parameters (creates, updates, deletes, extensions)\n     * @param txParams - Optional transaction parameters\n     * @returns The mutation result with transaction hash\n     *\n     * @throws {InvalidExpirationError} If any create/update/extension `expiresIn`\n     * is not a positive integer that is a multiple of the block time (2 seconds).\n     * @throws {InvalidAttributeError} If a numeric attribute value is not an\n     * integer.\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.mutateEntities({\n     *   creates: [{\n     *     payload: toBytes(JSON.stringify({ entity: { entityType: \"testType\", entityId: \"testId\" } })),\n     *     attriubutes: [{ key: \"testKey\", value: \"testValue\" }],\n     *     expiresIn: 1000,\n     *   }],\n     *   updates: [{\n     *     entityKey: \"0x123\",\n     *     payload: toBytes(JSON.stringify({ entity: { entityType: \"testType\", entityId: \"testId\" } })),\n     *     attributes: [{ key: \"testKey\", value: \"testValue\" }],\n     *     expiresIn: 1000,\n     *   }],\n     *   deletes: [{\n     *     entityKey: \"0x321\",\n     *   }],\n     *   extensions: [{\n     *     entityKey: \"0x1234\",\n     *     expiresIn: 1000,\n     *   }],\n     * })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    mutateEntities: (\n      data: MutateEntitiesParameters,\n      txParams?: TxParams,\n    ) => Promise<MutateEntitiesReturnType>\n  }\n\nexport function walletArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n>(client: Client<transport, chain, account>) {\n  return {\n    createEntity: (data: CreateEntityParameters, txParams?: TxParams) =>\n      createEntity(client, data, txParams),\n    updateEntity: (data: UpdateEntityParameters, txParams?: TxParams) =>\n      updateEntity(client, data, txParams),\n    deleteEntity: (data: DeleteEntityParameters, txParams?: TxParams) =>\n      deleteEntity(client, data, txParams),\n    extendEntity: (data: ExtendEntityParameters, txParams?: TxParams) =>\n      extendEntity(client, data, txParams),\n    changeOwnership: (data: ChangeOwnershipParameters, txParams?: TxParams) =>\n      changeOwnership(client, data, txParams),\n    mutateEntities: (data: MutateEntitiesParameters, txParams?: TxParams) =>\n      mutateEntities(client, data, txParams),\n  }\n}\n","import type {\n  Account,\n  Address,\n  Chain,\n  Client,\n  ParseAccount,\n  Prettify,\n  RpcSchema,\n  Transport,\n  WalletClientConfig,\n} from \"viem\"\nimport { createClient, publicActions, walletActions } from \"viem\"\nimport type { ArkivRpcSchema } from \"../types/rpcSchema\"\nimport { type WalletArkivActions, walletArkivActions } from \"./decorators/arkivWallet\"\n\nexport type WalletArkivClient<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n> = Prettify<\n  Client<transport, chain, account, rpcSchema, WalletArkivActions<transport, chain, account>>\n>\n\n/**\n * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).\n *\n * - Docs: https://docs.arkiv.network/ts-sdk/clients/public\n *\n * 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 [Braga JSON-RPC API](https://braga.holesky.arkiv.network/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).\n *\n * @param parameters - Configuration object for the wallet client (chain, transport, account, etc.)\n * @returns A Arkiv Wallet Client. {@link WalletArkivClient}\n *\n * @example\n * import { createPublicClient, http } from 'arkiv'\n * import { braga } from 'arkiv/chains'\n *\n * const client = createPublicClient({\n *   chain: braga,\n *   transport: http(),\n * })\n */\nexport function createWalletClient<\n  transport extends Transport,\n  chain extends Chain | undefined = undefined,\n  accountOrAddress extends Account | Address | undefined = undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n>(\n  parameters: WalletClientConfig<transport, chain, accountOrAddress, rpcSchema>,\n): WalletArkivClient<transport, chain, ParseAccount<accountOrAddress>, rpcSchema> {\n  const { key = \"wallet\", name = \"Wallet Client\" } = parameters\n  const client = createClient({\n    ...parameters,\n    key,\n    name,\n  })\n\n  return client\n    .extend(publicActions)\n    .extend(walletActions)\n    .extend(walletArkivActions) as unknown as WalletArkivClient<\n    transport,\n    chain,\n    ParseAccount<accountOrAddress>,\n    rpcSchema\n  >\n}\n","import type { Chain } from \"viem\"\nimport * as chains from \"../chains\"\n\n// Create a lookup map from all exported chains\nconst chainMap = new Map(Object.entries(chains).map(([key, value]) => [key.toLowerCase(), value]))\n\n/**\n * Get a chain from its name\n * @param name - The name of the chain, case insensitive\n * @returns The chain\n * @throws An error if the chain is not found\n */\nexport function chainFromName(name: string): Chain {\n  const chain = chainMap.get(name.toLowerCase())\n  if (!chain) {\n    throw new Error(`Unknown chain: ${name}`)\n  }\n  return chain as Chain\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["logger","bytes: Uint8Array","rpcQueryOptions: RpcQueryOptions","query","logger","ZERO_ADDRESS: Address","AttributeValueType","ownerNonce: bigint","createdEntityKeys: Hex[]","logger","logger","logger","logger","logger","logger","chains"],"sources":["../src/actions/public/getBlockTiming.ts","../src/actions/public/getEntity.ts","../src/actions/public/getEntityCount.ts","../src/actions/public/query.ts","../src/utils/arkivTransactions.ts","../src/actions/public/subscribeEntityEvents.ts","../src/clients/decorators/arkivPublic.ts","../src/clients/createPublicClient.ts","../src/actions/wallet/changeOwnership.ts","../src/actions/wallet/createEntity.ts","../src/actions/wallet/deleteEntity.ts","../src/actions/wallet/extendEntity.ts","../src/actions/wallet/mutateEntities.ts","../src/actions/wallet/updateEntity.ts","../src/clients/decorators/arkivWallet.ts","../src/clients/createWalletClient.ts","../src/utils/chains.ts"],"sourcesContent":["import type { ArkivClient } from \"../../clients/baseClient\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:public:get-block-timing\")\n\nexport type GetBlockTimingReturnType = {\n  currentBlock: bigint\n  currentBlockTime: number\n  blockDuration: number\n}\n\nexport async function getBlockTiming(client: ArkivClient) {\n  const blockTiming = await client.request({\n    method: \"arkiv_getBlockTiming\",\n    params: [],\n  })\n  logger(\"Block timing %o\", blockTiming)\n  return {\n    currentBlock: BigInt(blockTiming.current_block),\n    currentBlockTime: blockTiming.current_block_time,\n    blockDuration: blockTiming.duration,\n  }\n}\n","import { bytesToHex, type Hex, hexToBytes } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport { NoEntityFoundError } from \"../../errors\"\nimport { entityFromRpcResult } from \"../../utils/entities\"\n\nexport async function getEntity(client: ArkivClient, key: Hex) {\n  // Normalize the key into bytes\n  let bytes: Uint8Array\n  try {\n    bytes = hexToBytes(key)\n  } catch {\n    throw new Error(`Invalid key format: ${key}. Key must be a valid hex string.`)\n  }\n\n  if (bytes.length !== 32) {\n    throw new Error(\n      `Invalid key length: ${bytes.length} bytes. Key must be 32 bytes (64 hex characters) long.`,\n    )\n  }\n\n  const hexKey = bytesToHex(bytes)\n\n  const result = await client.request({\n    method: \"arkiv_query\",\n    params: [\n      `$key = ${hexKey}`,\n      {\n        includeData: {\n          key: true,\n          attributes: true,\n          payload: true,\n          contentType: true,\n          expiration: true,\n          owner: true,\n          creator: true,\n          createdAtBlock: true,\n          lastModifiedAtBlock: true,\n          transactionIndexInBlock: true,\n          operationIndexInTransaction: true,\n        },\n      },\n    ],\n  })\n\n  if (!result.data.length) {\n    throw new NoEntityFoundError()\n  }\n\n  return await entityFromRpcResult(result.data[0])\n}\n","import type { ArkivClient } from \"../../clients/baseClient\"\n\nexport async function getEntityCount(client: ArkivClient) {\n  const count = await client.request({\n    method: \"arkiv_getEntityCount\",\n    params: [],\n  })\n\n  return count\n}\n","import { numberToHex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { Entity } from \"../../types/entity\"\nimport type { RpcQueryOptions } from \"../../types/rpcSchema\"\nimport { entityFromRpcResult } from \"../../utils/entities\"\n\nexport type QueryOptionsIncludeData = {\n  attributes?: boolean\n  payload?: boolean\n  metadata?: boolean\n}\n/**\n * @deprecated Server-side ordering is not supported by the network. Sort the fetched\n * entities in JavaScript instead (e.g. `entities.sort(...)`). This type will be removed\n * in a future release.\n */\nexport type QueryOptionsOrderBy = {\n  name: string\n  type: \"string\" | \"numeric\"\n  desc: \"asc\" | \"desc\"\n}\n\nexport type QueryOptions = {\n  includeData?: QueryOptionsIncludeData\n  atBlock?: bigint\n  /**\n   * @deprecated Server-side ordering is not supported by the network, so this option has no\n   * effect on the returned order. Sort the fetched entities in JavaScript instead\n   * (e.g. `entities.sort(...)`). This option will be removed in a future release.\n   */\n  orderBy?: QueryOptionsOrderBy[]\n  resultsPerPage?: number | undefined\n  cursor?: string | undefined\n}\n\nexport type QueryReturnType = {\n  entities: Entity[]\n  cursor: string | undefined\n  blockNumber: bigint | undefined\n}\n\nexport async function query(client: ArkivClient, query: string, queryOptions?: QueryOptions) {\n  const rpcQueryOptions: RpcQueryOptions = {\n    includeData: {\n      key: true,\n      payload: queryOptions?.includeData?.payload ?? true,\n      attributes: queryOptions?.includeData?.attributes ?? false,\n      contentType: queryOptions?.includeData?.metadata ?? false,\n      expiration: queryOptions?.includeData?.metadata ?? false,\n      owner: queryOptions?.includeData?.metadata ?? false,\n      creator: queryOptions?.includeData?.metadata ?? false,\n      createdAtBlock: queryOptions?.includeData?.metadata ?? false,\n      lastModifiedAtBlock: queryOptions?.includeData?.metadata ?? false,\n      transactionIndexInBlock: queryOptions?.includeData?.metadata ?? false,\n      operationIndexInTransaction: queryOptions?.includeData?.metadata ?? false,\n    },\n    ...(queryOptions?.atBlock !== undefined && { atBlock: numberToHex(queryOptions.atBlock) }),\n    ...(queryOptions?.orderBy && {\n      orderBy: queryOptions?.orderBy.map((order) => ({\n        name: order.name,\n        type: order.type,\n        desc: order.desc === \"desc\",\n      })),\n    }),\n    ...(queryOptions?.resultsPerPage !== undefined && {\n      resultsPerPage: numberToHex(queryOptions.resultsPerPage),\n    }),\n    ...(queryOptions?.cursor !== undefined && { cursor: queryOptions?.cursor }),\n  }\n\n  const result = await client.request({\n    method: \"arkiv_query\",\n    params: [query, rpcQueryOptions],\n  })\n\n  const entities = await Promise.all(result.data.map((entity) => entityFromRpcResult(entity)))\n\n  return {\n    entities,\n    cursor: result.cursor,\n    blockNumber: BigInt(result.blockNumber),\n  }\n}\n","import {\n  type Address,\n  ContractFunctionExecutionError,\n  ContractFunctionRevertedError,\n  encodePacked,\n  type Hex,\n  keccak256,\n  parseAbi,\n  stringToBytes,\n  TransactionExecutionError,\n  type TransactionReceipt,\n  toBytes,\n  toHex,\n} from \"viem\"\nimport type { ChangeOwnershipParameters } from \"../actions/wallet/changeOwnership\"\nimport type { CreateEntityParameters } from \"../actions/wallet/createEntity\"\nimport type { DeleteEntityParameters } from \"../actions/wallet/deleteEntity\"\nimport type { ExtendEntityParameters } from \"../actions/wallet/extendEntity\"\nimport type { UpdateEntityParameters } from \"../actions/wallet/updateEntity\"\nimport type { ArkivClient } from \"../clients/baseClient\"\nimport type { WalletArkivClient } from \"../clients/createWalletClient\"\nimport { ARKIV_ADDRESS, BLOCK_TIME } from \"../consts\"\nimport { DuplicateAttributeError, EntityMutationError, InvalidContentTypeError } from \"../errors\"\nimport type { TxParams } from \"../types\"\nimport { EntityOperationType } from \"../types/entity\"\nimport { RpcAttributeValueType as AttributeValueType } from \"../types/rpcSchema\"\n\nimport { getLogger } from \"./logger\"\nimport { isEntityKey, validateAttribute, validateExpiresIn } from \"./validation\"\n\nconst logger = getLogger(\"utils:arkiv-transactions\")\n\n// RFC 2045 token chars, lowercase only. Rejects uppercase to prevent text/plain vs Text/Plain ambiguity.\nconst MIME_REGEX = /^[a-z][a-z0-9!#$&\\-^_]*\\/[a-z0-9][a-z0-9!#$&\\-^_.+]*$/\n\nfunction validateContentType(contentType: string): void {\n  if (!MIME_REGEX.test(contentType)) {\n    throw new InvalidContentTypeError(contentType)\n  }\n}\n\n// Mime128 = struct { bytes32[4] data }  (128-byte fixed MIME type container)\n// Attribute = struct { bytes32 name, uint8 valueType, bytes32[4] value }\n// BlockNumber = type BlockNumber is uint32\nexport const ENTITY_EXECUTE_ABI = parseAbi([\n  \"function execute((uint8 operationType, bytes32 entityKey, bytes payload, (bytes32[4] data) contentType, (bytes32 name, uint8 valueType, bytes32[4] value)[] attributes, uint32 expiresIn, address newOwner)[] ops) external\",\n])\n\nexport const ENTITY_OPERATION_EVENT_ABI = parseAbi([\n  \"event EntityOperation(bytes32 indexed entityKey, uint8 indexed operationType, address indexed owner, uint32 expiresAt, bytes32 entityHash)\",\n])\n\nexport const ENTITY_ERRORS_ABI = parseAbi([\n  \"error EmptyBatch()\",\n  \"error AttributesNotSorted()\",\n  \"error InvalidValueType(bytes32 name, uint8 valueType)\",\n  \"error InvalidOpType(uint8 operationType)\",\n  \"error ExpiryInPast(uint32 expiresAt, uint32 currentBlock)\",\n  \"error TooManyAttributes(uint256 count, uint256 maxCount)\",\n  \"error EntityNotFound(bytes32 entityKey)\",\n  \"error NotOwner(bytes32 entityKey, address caller, address owner)\",\n  \"error EntityExpired(bytes32 entityKey, uint32 expiresAt)\",\n  \"error ExpiryNotExtended(bytes32 entityKey, uint32 newExpiresAt, uint32 currentExpiresAt)\",\n  \"error TransferToZeroAddress(bytes32 entityKey)\",\n  \"error TransferToSelf(bytes32 entityKey)\",\n  \"error EntityNotExpired(bytes32 entityKey, uint32 expiresAt)\",\n  \"error Ident32Empty()\",\n  \"error Ident32TooLong(uint256 length)\",\n  \"error Ident32InvalidByte(uint256 position, bytes1 value)\",\n  \"error MimeEmpty()\",\n  \"error MimeTooLong(uint256 length, uint256 maxLength)\",\n  \"error MimeInvalidByte(uint256 position, bytes1 value)\",\n  \"error MimeIncomplete()\",\n])\n\nconst EXECUTE_ABI = [...ENTITY_EXECUTE_ABI, ...ENTITY_ERRORS_ABI]\n\nconst ENTITY_NONCE_ABI = parseAbi([\"function nonces(address owner) view returns (uint32)\"])\n\nconst ZERO_ADDRESS: Address = \"0x0000000000000000000000000000000000000000\"\nconst ZERO_32 = `0x${\"00\".repeat(32)}` as Hex\nconst EMPTY_BYTES128 = [ZERO_32, ZERO_32, ZERO_32, ZERO_32] as const\n\n// Encode a string or bytes into a bytes32[4] (128-byte) container, left-aligned.\nfunction encodeBytes128(data: Uint8Array): readonly [Hex, Hex, Hex, Hex] {\n  const padded = new Uint8Array(128)\n  padded.set(data.slice(0, 128))\n  return [\n    toHex(padded.slice(0, 32)),\n    toHex(padded.slice(32, 64)),\n    toHex(padded.slice(64, 96)),\n    toHex(padded.slice(96, 128)),\n  ]\n}\n\n// Mime128 struct: bytes32[4] data, string packed left-aligned into 128 bytes.\nfunction encodeMime128(contentType: string): { data: readonly [Hex, Hex, Hex, Hex] } {\n  return { data: contentType ? encodeBytes128(stringToBytes(contentType)) : EMPTY_BYTES128 }\n}\n\nfunction encodeAttribute(attr: { key: string; value: Hex | string | number }) {\n  validateAttribute(attr)\n  const name = toHex(attr.key, { size: 32 })\n\n  if (typeof attr.value === \"string\") {\n    // Only exact 32-byte hex (an entity key) gets the EntityKey type; shorter or\n    // longer hex-looking strings are stored as plain strings so they round-trip\n    // unchanged and stay matchable by quoted string queries.\n    if (isEntityKey(attr.value)) {\n      return {\n        name,\n        valueType: AttributeValueType.EntityKey,\n        value: [toHex(toBytes(attr.value), { size: 32 }), ZERO_32, ZERO_32, ZERO_32] as const,\n      }\n    }\n    return {\n      name,\n      valueType: AttributeValueType.String,\n      // stringToBytes, not toBytes: toBytes hex-decodes hex-looking strings, which\n      // would corrupt string values like \"0xab\" instead of UTF-8 encoding them\n      value: encodeBytes128(stringToBytes(attr.value)),\n    }\n  }\n\n  return {\n    name,\n    valueType: AttributeValueType.Uint,\n    value: [toHex(BigInt(attr.value), { size: 32 }), ZERO_32, ZERO_32, ZERO_32] as const,\n  }\n}\n\n// The registry requires attributes strictly ascending by their bytes32 name — the\n// canonical serialization hashes into the state root, and strict ordering doubles as\n// the uniqueness check (AttributesNotSorted). Sort here so callers can pass any order;\n// duplicates would revert on-chain, so reject them client-side with a clear error.\nfunction encodeAttributes(attrs: { key: string; value: Hex | string | number }[]) {\n  const encoded = attrs\n    .map((attr) => ({ key: attr.key, ...encodeAttribute(attr) }))\n    .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))\n  for (let i = 1; i < encoded.length; i++) {\n    if (encoded[i].name === encoded[i - 1].name) {\n      throw new DuplicateAttributeError(encoded[i].key)\n    }\n  }\n  return encoded.map(({ key: _, ...attr }) => attr)\n}\n\nfunction toBTL(expiresIn: number): number {\n  validateExpiresIn(expiresIn)\n  return Math.ceil(expiresIn / BLOCK_TIME)\n}\n\n// entityKey = keccak256(chainId || registryAddress || ownerAddress || nonce)\nfunction deriveEntityKey(chainId: number, owner: Address, nonce: bigint): Hex {\n  return keccak256(\n    encodePacked(\n      [\"uint256\", \"address\", \"address\", \"uint32\"],\n      [BigInt(chainId), ARKIV_ADDRESS, owner, Number(nonce)],\n    ),\n  )\n}\n\nexport type SendArkivTransactionResult = {\n  receipt: TransactionReceipt\n  createdEntityKeys: Hex[]\n}\n\nexport async function sendArkivTransaction(\n  client: ArkivClient,\n  ops: {\n    creates?: CreateEntityParameters[]\n    updates?: UpdateEntityParameters[]\n    deletes?: DeleteEntityParameters[]\n    extensions?: ExtendEntityParameters[]\n    ownershipChanges?: ChangeOwnershipParameters[]\n  },\n  txParams?: TxParams,\n): Promise<SendArkivTransactionResult> {\n  if (!client.account) throw new Error(\"Account required\")\n  if (!client.chain) throw new Error(\"Chain required\")\n  const walletClient = client as WalletArkivClient\n\n  const { creates, updates, deletes, extensions, ownershipChanges } = ops\n  const owner = client.account.address as Address\n\n  const ownerNonce: bigint = creates?.length\n    ? BigInt(\n        await walletClient.readContract({\n          address: ARKIV_ADDRESS,\n          abi: ENTITY_NONCE_ABI,\n          functionName: \"nonces\",\n          args: [owner],\n        }),\n      )\n    : 0n\n\n  const createdEntityKeys: Hex[] = (creates ?? []).map((_, i) =>\n    deriveEntityKey(client.chain!.id, owner, ownerNonce + BigInt(i)),\n  )\n\n  for (const item of creates ?? []) validateContentType(item.contentType)\n  for (const item of updates ?? []) validateContentType(item.contentType)\n\n  const operations = [\n    ...(creates ?? []).map((item, i) => ({\n      operationType: EntityOperationType.Create,\n      entityKey: createdEntityKeys[i],\n      payload: toHex(item.payload),\n      contentType: encodeMime128(item.contentType),\n      attributes: encodeAttributes(item.attributes),\n      expiresIn: toBTL(item.expiresIn),\n      newOwner: ZERO_ADDRESS,\n    })),\n    ...(updates ?? []).map((item) => ({\n      operationType: EntityOperationType.Update,\n      entityKey: item.entityKey,\n      payload: toHex(item.payload),\n      contentType: encodeMime128(item.contentType),\n      attributes: encodeAttributes(item.attributes),\n      expiresIn: 0, // contract ignores expiresAt on UPDATE\n      newOwner: ZERO_ADDRESS,\n    })),\n    ...(deletes ?? []).map((item) => ({\n      operationType: EntityOperationType.Delete,\n      entityKey: item.entityKey,\n      payload: \"0x\" as Hex,\n      contentType: encodeMime128(\"\"),\n      attributes: [] as never[],\n      expiresIn: 0,\n      newOwner: ZERO_ADDRESS,\n    })),\n    ...(extensions ?? []).map((item) => ({\n      operationType: EntityOperationType.Extend,\n      entityKey: item.entityKey,\n      payload: \"0x\" as Hex,\n      contentType: encodeMime128(\"\"),\n      attributes: [] as never[],\n      expiresIn: toBTL(item.expiresIn),\n      newOwner: ZERO_ADDRESS,\n    })),\n    ...(ownershipChanges ?? []).map((item) => ({\n      operationType: EntityOperationType.Transfer,\n      entityKey: item.entityKey,\n      payload: \"0x\" as Hex,\n      contentType: encodeMime128(\"\"),\n      attributes: [] as never[],\n      expiresIn: 0,\n      newOwner: item.newOwner as Address,\n    })),\n  ]\n\n  logger(\"Sending execute with %d operations %s\", operations.length, JSON.stringify(operations))\n\n  try {\n    const txHash = await walletClient.writeContract({\n      address: ARKIV_ADDRESS,\n      abi: EXECUTE_ABI,\n      functionName: \"execute\",\n      args: [operations],\n      account: client.account,\n      chain: client.chain,\n      ...txParams,\n    })\n\n    const receipt = await walletClient.waitForTransactionReceipt({ hash: txHash })\n    logger(\"Tx receipt %o\", receipt)\n\n    if (receipt.status === \"reverted\") {\n      try {\n        await walletClient.simulateContract({\n          address: ARKIV_ADDRESS,\n          abi: EXECUTE_ABI,\n          functionName: \"execute\",\n          args: [operations],\n          account: client.account,\n          chain: client.chain,\n        })\n      } catch (err) {\n        const error = err as { shortMessage?: string; cause?: { details?: string } }\n        const reason =\n          error.shortMessage ?? error.cause?.details ?? \"No reason provided by backend.\"\n        throw new EntityMutationError(\n          `Transaction ${receipt.transactionHash} reverted. Reason: ${reason}`,\n        )\n      }\n      throw new EntityMutationError(\n        `Transaction ${receipt.transactionHash} reverted. No reason provided by backend.`,\n      )\n    }\n\n    return { receipt, createdEntityKeys }\n  } catch (error) {\n    let message = \"Transaction failed\"\n    if (error instanceof TransactionExecutionError) {\n      message += `: ${error.details}`\n    } else if (error instanceof ContractFunctionExecutionError) {\n      logger(\"Contract function execution error data:\", error.shortMessage)\n      if (error.cause instanceof ContractFunctionRevertedError) {\n        message += `: ${error.cause.message}`\n      } else {\n        message += \": Execution error without revert data\"\n      }\n    } else if (error instanceof EntityMutationError) {\n      throw error\n    }\n\n    throw new EntityMutationError(message)\n  }\n}\n","import { decodeEventLog, type Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { PublicArkivClient } from \"../../clients/createPublicClient\"\nimport { EntityOperationType } from \"../../types/entity\"\nimport type {\n  OnEntityCreatedEvent,\n  OnEntityDeletedEvent,\n  OnEntityExpiredEvent,\n  OnEntityExpiresInExtendedEvent,\n  OnEntityOwnerChangedEvent,\n  OnEntityUpdatedEvent,\n} from \"../../types/events\"\nimport { ENTITY_OPERATION_EVENT_ABI } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:public:subscribe-entity-events\")\n\nexport const arkivABI = ENTITY_OPERATION_EVENT_ABI\n\nexport async function subscribeEntityEvents(\n  client: ArkivClient,\n  {\n    onError,\n    onEntityCreated,\n    onEntityUpdated,\n    onEntityDeleted,\n    onEntityExpired,\n    onEntityExpiresInExtended,\n    onEntityOwnerChanged,\n  }: {\n    onError: ((error: Error) => void) | undefined\n    onEntityCreated?: ((event: OnEntityCreatedEvent) => void) | undefined\n    onEntityUpdated?: ((event: OnEntityUpdatedEvent) => void) | undefined\n    onEntityDeleted?: ((event: OnEntityDeletedEvent) => void) | undefined\n    onEntityExpired?: ((event: OnEntityExpiredEvent) => void) | undefined\n    onEntityExpiresInExtended?: ((event: OnEntityExpiresInExtendedEvent) => void) | undefined\n    onEntityOwnerChanged?: ((event: OnEntityOwnerChangedEvent) => void) | undefined\n  },\n  pollingInterval?: number,\n  fromBlock?: bigint,\n): Promise<() => void> {\n  const unsubscribe = (client as PublicArkivClient).watchEvent({\n    pollingInterval: pollingInterval ?? 1000,\n    fromBlock,\n    events: arkivABI,\n    onLogs: (logs) => {\n      logger(\"logs from subscribeEntityEvents %o\", logs)\n      for (const log of logs) {\n        const event = decodeEventLog({\n          abi: arkivABI,\n          topics: log.topics as [Hex, ...Hex[]] | [],\n          data: log.data,\n        })\n        logger(\"event from subscribeEntityEvents %o\", event)\n\n        if (event.eventName !== \"EntityOperation\") continue\n\n        const entityKey = event.args.entityKey as Hex\n        const owner = event.args.owner\n        const expiresAt = event.args.expiresAt\n        const entityHash = event.args.entityHash as Hex\n        const opType = Number(event.args.operationType)\n\n        switch (opType) {\n          case EntityOperationType.Create:\n            onEntityCreated?.({ entityKey, owner, expiresAt, entityHash })\n            break\n          case EntityOperationType.Update:\n            onEntityUpdated?.({ entityKey, owner, expiresAt, entityHash })\n            break\n          case EntityOperationType.Extend:\n            onEntityExpiresInExtended?.({ entityKey, owner, expiresAt, entityHash })\n            break\n          case EntityOperationType.Transfer:\n            onEntityOwnerChanged?.({ entityKey, owner, entityHash })\n            break\n          case EntityOperationType.Delete:\n            onEntityDeleted?.({ entityKey, owner })\n            break\n          default:\n            onEntityExpired?.({ entityKey, owner })\n            break\n        }\n      }\n    },\n    onError: (error) => {\n      console.error(\"error from subscribeEntityEvents\", error)\n      onError?.(error)\n    },\n  })\n\n  return unsubscribe\n}\n","import type { Account, Chain, Client, Hex, PublicActions, Transport } from \"viem\"\nimport { getBlockTiming } from \"../../actions/public/getBlockTiming\"\nimport { getEntity } from \"../../actions/public/getEntity\"\nimport { getEntityCount } from \"../../actions/public/getEntityCount\"\nimport { type QueryOptions, type QueryReturnType, query } from \"../../actions/public/query\"\nimport { subscribeEntityEvents } from \"../../actions/public/subscribeEntityEvents\"\nimport { QueryBuilder, SelectQueryBuilder } from \"../../query/queryBuilder\"\nimport type { EntitySelection, FullEntity, ProjectedEntity, SelectArg } from \"../../query/selection\"\nimport type { Entity } from \"../../types/entity\"\nimport type {\n  OnEntityCreatedEvent,\n  OnEntityDeletedEvent,\n  OnEntityExpiredEvent,\n  OnEntityExpiresInExtendedEvent,\n  OnEntityUpdatedEvent,\n} from \"../../types/events\"\n\nexport type PublicArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n> = Pick<\n  PublicActions<transport, chain, account>,\n  | \"getBalance\"\n  | \"getBlock\"\n  | \"getBlockNumber\"\n  | \"getChainId\"\n  | \"getLogs\"\n  | \"getTransaction\"\n  | \"getTransactionCount\"\n  | \"getTransactionReceipt\"\n  | \"waitForTransactionReceipt\"\n  | \"watchEvent\"\n> & {\n  /**\n   * Returns the entity with the given key.\n   *\n   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/getEntity\n   *\n   * @param key - The entity key (hex string)\n   * @returns The entity with the given key. {@link Entity}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const entity = await client.getEntity(\"0x123\")\n   * // {\n   * //   key: \"0x123\",\n   * //   value: \"0x123\",\n   * // }\n   */\n  getEntity: (key: Hex) => Promise<Entity>\n\n  /**\n   * Returns a SelectQueryBuilder for building and executing queries — the recommended way to\n   * read entities. You declare up front which parts of an entity you want returned, so results\n   * always contain exactly the data you asked for.\n   *\n   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/query\n   *\n   * @param selection - What to include in the results. Omit it (or pass `\"*\"`) to select everything,\n   *   or pass an object to select specific parts (at least one field is required). Every part is\n   *   opt-in, including the `key`. The selection is flat — each field maps to an entity field.\n   *   {@link SelectArg}\n   * @returns A SelectQueryBuilder instance for building and executing queries. {@link SelectQueryBuilder}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   * import { eq } from 'arkiv/query'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * // select everything\n   * await client.select().where(eq(\"category\", \"docs\")).fetch()\n   * await client.select(\"*\").where(eq(\"category\", \"docs\")).fetch()\n   * // only the key\n   * await client.select({ key: true }).where(eq(\"category\", \"docs\")).fetch()\n   * // select specific fields — result typed { owner: Hex; attributes: Attribute[] }\n   * await client.select({ owner: true, attributes: true }).fetch()\n   * // a single field — result typed { owner: Hex }\n   * await client.select({ owner: true }).fetch()\n   */\n  select: {\n    /** Select every field. Pass nothing or `\"*\"`; the returned entities contain all fields. */\n    (selection?: \"*\"): SelectQueryBuilder<FullEntity>\n    /**\n     * Pick the entity fields to return. Set the ones you want to `true` (at least one is required);\n     * the result is typed to exactly those fields, so reading anything else is a compile error.\n     *\n     * Available fields: `key`, `owner`, `creator`, `contentType`, `payload`, `attributes`,\n     * `expiresAtBlock`, `createdAtBlock`, `lastModifiedAtBlock`, `transactionIndexInBlock`,\n     * `operationIndexInTransaction`.\n     *\n     * Pass the selection inline so its fields stay literal `true`. A selection stored in a `let`/\n     * `const` variable widens to `boolean` and the result type can no longer be narrowed — annotate\n     * it `as const` (e.g. `const sel = { owner: true } as const`) in that case.\n     *\n     * @example\n     * client.select({ owner: true, attributes: true }) // entities typed { owner, attributes }\n     * client.select({ key: true, payload: true })       // includes payload → toText()/toJson() too\n     */\n    <const S extends EntitySelection>(selection: S): SelectQueryBuilder<ProjectedEntity<S>>\n    /**\n     * Dynamic selection: accepts a value typed {@link SelectArg} (e.g. built at runtime). The\n     * result cannot be narrowed in this case, so the entities are typed as the full entity.\n     */\n    (selection: SelectArg): SelectQueryBuilder<FullEntity>\n  }\n\n  /**\n   * Returns a QueryBuilder instance for building and executing queries.\n   * The QueryBuilder object follows the Builder pattern, allowing you to chain methods to build a query and then execute it.\n   *\n   * - Docs: https://docs.arkiv.network/ts-sdk/actions/public/query\n   *\n   * @deprecated Use {@link select} instead. `buildQuery()` returns only the entity `key` unless\n   * you remember to opt in to data with `withAttributes()`/`withMetadata()`/`withPayload()`, which\n   * is an easy mistake. `select()` makes the selection explicit. This method remains for backwards\n   * compatibility and will be removed in a future release.\n   *\n   * @returns A QueryBuilder instance for building and executing queries. {@link QueryBuilder}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const query = client.buildQuery()\n   * const entities = await query.where(\"key\", \"=\", \"value\").ownedBy(\"0x123\").fetch()\n   *\n   */\n  buildQuery: () => QueryBuilder\n\n  /**\n   * Returns a QueryResult instance for fetching the results of a raw query.\n   * If no query options are provided, all payload is included, but no metadata (like owner, expiredAt, etc.) and attributes.\n   * @param query - The raw query string\n   * @param queryOptions - The optional query options - {@link QueryOptions}\n   * @returns A QueryReturnType instance - {@link QueryReturnType}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const queryResult = client.query('key = value && $owner = 0x123')\n   * // queryResult = { entities: [{ key: \"0x123\", value: \"0x123\" }], cursor: undefined, blockNumber: undefined }\n   * const queryResultWithOptions = client.query('key = value && $owner = 0x123', {\n   *   includeData: {\n   *     attributes: false,\n   *     payload: true,\n   *     metadata: true,\n   *   },\n   *   resultsPerPage: 10,\n   *   cursor: undefined,\n   *   atBlock: undefined,\n   * })\n   * // queryResultWithOptions = { entities: [{ key: \"0x123\", value: \"0x123\" }], cursor: \"...\", blockNumber: 32223n }\n   */\n  query: (query: string, queryOptions?: QueryOptions) => Promise<QueryReturnType>\n\n  /**\n   * Returns the number of entities in the DBChain.\n   * @returns The number of entities in the DBChain\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const entityCount = await client.getEntityCount()\n   * // entityCount = 0\n   */\n  getEntityCount: () => Promise<number>\n\n  /**\n   * Returns the current block timing.\n   * @returns The current block timing. {@link GetBlockTimingReturnType}\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const blockTiming = await client.getBlockTiming()\n   * // {\n   * //   currentBlock: 10n, // block number\n   * //   currentBlockTime: 1234567890, // block timestamp\n   * //   blockDuration: 2, // in seconds\n   * // }\n   */\n  getBlockTiming: () => Promise<{\n    currentBlock: bigint\n    currentBlockTime: number\n    blockDuration: number\n  }>\n\n  /**\n   * Subscribes to entity events.\n   * Takes an object with event handlers: {onError, onEntityCreated, onEntityUpdated, onEntityDeleted, onEntityExpiresInExtended}\n   * @param pollingInterval - The polling interval in milliseconds\n   * @param fromBlock - The block number to start from\n   * @returns A function to unsubscribe from the events\n   *\n   * @example\n   * import { createPublicClient, http } from 'arkiv'\n   * import { braga } from 'arkiv/chains'\n   *\n   * const client = createPublicClient({\n   *   chain: braga,\n   *   transport: http(),\n   * })\n   * const unsubscribe = await client.subscribeEntityEvents({\n   *   onError: (error) => console.error(\"subscribeEntityEvents error\", error),\n   * })\n   * unsubscribe() // unsubscribe from the events\n   */\n  subscribeEntityEvents: (\n    {\n      onError,\n      onEntityCreated,\n      onEntityUpdated,\n      onEntityDeleted,\n      onEntityExpiresInExtended,\n    }: {\n      onError?: (error: Error) => void\n      onEntityCreated?: (event: OnEntityCreatedEvent) => void\n      onEntityUpdated?: (event: OnEntityUpdatedEvent) => void\n      onEntityDeleted?: (event: OnEntityDeletedEvent) => void\n      onEntityExpired?: (event: OnEntityExpiredEvent) => void\n      onEntityExpiresInExtended?: (event: OnEntityExpiresInExtendedEvent) => void\n    },\n    pollingInterval?: number,\n    fromBlock?: bigint,\n  ) => Promise<() => void>\n}\n\nexport function publicArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n>(client: Client<transport, chain, account>) {\n  return {\n    getEntity: (key: Hex) => getEntity(client, key),\n    query: (rawQuery: string, queryOptions?: QueryOptions) => query(client, rawQuery, queryOptions),\n    buildQuery: () => new QueryBuilder(client),\n    select: (selection?: SelectArg) => new SelectQueryBuilder(client, selection),\n    getBlockTiming: () => getBlockTiming(client),\n    getEntityCount: () => getEntityCount(client),\n    subscribeEntityEvents: (\n      {\n        onError,\n        onEntityCreated,\n        onEntityUpdated,\n        onEntityDeleted,\n        onEntityExpired,\n        onEntityExpiresInExtended,\n      }: {\n        onError?: (error: Error) => void\n        onEntityCreated?: (event: OnEntityCreatedEvent) => void\n        onEntityUpdated?: (event: OnEntityUpdatedEvent) => void\n        onEntityDeleted?: (event: OnEntityDeletedEvent) => void\n        onEntityExpired?: (event: OnEntityExpiredEvent) => void\n        onEntityExpiresInExtended?: (event: OnEntityExpiresInExtendedEvent) => void\n      },\n      pollingInterval?: number,\n      fromBlock?: bigint,\n    ) =>\n      subscribeEntityEvents(\n        client,\n        {\n          onError,\n          onEntityCreated,\n          onEntityUpdated,\n          onEntityDeleted,\n          onEntityExpired,\n          onEntityExpiresInExtended,\n        },\n        pollingInterval,\n        fromBlock,\n      ),\n  }\n}\n","import type {\n  Account,\n  Address,\n  Chain,\n  Client,\n  ParseAccount,\n  Prettify,\n  PublicClientConfig,\n  RpcSchema,\n  Transport,\n} from \"viem\"\nimport { createClient, publicActions } from \"viem\"\nimport type { ArkivRpcSchema } from \"../types/rpcSchema\"\nimport { type PublicArkivActions, publicArkivActions } from \"./decorators/arkivPublic\"\n\nexport type PublicArkivClient<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  accountOrAddress extends Account | undefined = undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n> = Prettify<\n  Client<transport, chain, accountOrAddress, rpcSchema, PublicArkivActions<transport, chain>>\n>\n\n/**\n * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).\n *\n * - Docs: https://docs.arkiv.network/ts-sdk/clients/public\n *\n * 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 [Braga JSON-RPC API](https://braga.holesky.arkiv.network/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).\n *\n * @param parameters - Configuration object for the public client (chain, transport, etc.)\n * @returns A Arkiv Public Client. {@link PublicArkivClient}\n *\n * @example\n * import { createPublicClient, http } from 'arkiv'\n * import { braga } from 'arkiv/chains'\n *\n * const client = createPublicClient({\n *   chain: braga,\n *   transport: http(),\n * })\n */\nexport function createPublicClient<\n  transport extends Transport,\n  chain extends Chain | undefined = undefined,\n  accountOrAddress extends Account | Address | undefined = undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n>(\n  parameters: PublicClientConfig<transport, chain, accountOrAddress, rpcSchema>,\n): PublicArkivClient<transport, chain, ParseAccount<accountOrAddress>, rpcSchema> {\n  const { key = \"public\", name = \"Public Client\" } = parameters\n  const client = createClient({\n    ...parameters,\n    key,\n    name,\n  })\n\n  return client.extend(publicActions).extend(publicArkivActions) as unknown as PublicArkivClient<\n    transport,\n    chain,\n    ParseAccount<accountOrAddress>,\n    rpcSchema\n  >\n}\n","import type { Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:change-ownership\")\n\n/**\n * Parameters for the changeOwnership function.\n * - entityKey: The key of the entity.\n * - newOwner: The address of the new owner.\n */\nexport type ChangeOwnershipParameters = {\n  entityKey: Hex\n  newOwner: Hex\n}\n\n/**\n * Return type for the changeOwnership function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type ChangeOwnershipReturnType = {\n  entityKey: Hex\n  txHash: string\n}\n\nexport async function changeOwnership(\n  client: ArkivClient,\n  data: ChangeOwnershipParameters,\n  txParams?: TxParams,\n): Promise<ChangeOwnershipReturnType> {\n  logger(\"changeOwnership %o\", data)\n  const { receipt } = await sendArkivTransaction(client, { ownershipChanges: [data] }, txParams)\n\n  logger(\"Receipt from changeOwnership %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash,\n    entityKey: data.entityKey,\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { Attribute, MimeType, TxParams } from \"../../types\"\nimport { sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:create-entity\")\n\n/**\n * Parameters for the createEntity function.\n * - payload: The payload of the entity.\n * - attributes: The attributes of the entity. Attribute values may be strings\n *   or numbers, but numeric values **must be integers**. To store a non-integer,\n *   scale it to an integer (e.g. `1.5` -> `1500`) to preserve numeric ordering,\n *   or pass it as a string (e.g. `\"1.5\"`). A non-integer numeric value throws an\n *   {@link InvalidAttributeError}.\n * - contentType: The content type of the entity.\n * - expiresIn: How long until the entity expires, in seconds. Because Arkiv\n *   measures expiration in blocks (1 block = 2 seconds), this **must be a\n *   positive integer and a multiple of the block time (2 seconds)**\n *   Invalid values throw an {@link InvalidExpirationError}.\n */\nexport type CreateEntityParameters = {\n  payload: Uint8Array\n  /** Entity attributes. Numeric values must be integers (scale non-integers, e.g. `1.5` -> `1500`, or use a string). Throws {@link InvalidAttributeError} otherwise. */\n  attributes: Attribute[]\n  contentType: MimeType | string\n  /** Seconds until expiry. Must be a positive integer and a multiple of the 2s block time.\n   * Throws {@link InvalidExpirationError} otherwise. */\n  expiresIn: number\n}\n\n/**\n * Return type for the createEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type CreateEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function createEntity(\n  client: ArkivClient,\n  data: CreateEntityParameters,\n  txParams?: TxParams,\n): Promise<CreateEntityReturnType> {\n  logger(\"createEntity %o\", data)\n  const { receipt, createdEntityKeys } = await sendArkivTransaction(\n    client,\n    { creates: [data] },\n    txParams,\n  )\n\n  logger(\"Receipt from createEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: createdEntityKeys[0],\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:delete-entity\")\n\n/**\n * Parameters for the deleteEntity function.\n * - entityKey: The key of the entity to delete.\n */\nexport type DeleteEntityParameters = {\n  entityKey: Hex\n}\n\n/**\n * Return type for the deleteEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type DeleteEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function deleteEntity(\n  client: ArkivClient,\n  data: DeleteEntityParameters,\n  txParams?: TxParams,\n): Promise<DeleteEntityReturnType> {\n  logger(\"deleteEntity %o\", data)\n  const { receipt } = await sendArkivTransaction(client, { deletes: [data] }, txParams)\n\n  logger(\"Receipt from deleteEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: data.entityKey,\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:extend-entity\")\n\n/**\n * Parameters for the extendEntity function.\n * - entityKey: The key of the entity to extend.\n * - expiresIn: How long to extend the entity by, in seconds. Because Arkiv\n *   measures expiration in blocks (1 block = 2 seconds), this **must be a\n *   positive integer and a multiple of the block time (2 seconds)**.\n *   Invalid values throw an {@link InvalidExpirationError}.\n */\nexport type ExtendEntityParameters = {\n  entityKey: Hex\n  /** Seconds to extend by. Must be a positive integer and a multiple of the 2s block time.\n   * Throws {@link InvalidExpirationError} otherwise. */\n  expiresIn: number\n}\n\n/**\n * Return type for the extendEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type ExtendEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function extendEntity(\n  client: ArkivClient,\n  data: ExtendEntityParameters,\n  txParams?: TxParams,\n): Promise<ExtendEntityReturnType> {\n  logger(\"extendEntity %o\", data)\n  const { receipt } = await sendArkivTransaction(client, { extensions: [data] }, txParams)\n\n  logger(\"Receipt from extendEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: data.entityKey,\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { TxParams } from \"../../types\"\nimport { sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\nimport type { ChangeOwnershipParameters } from \"./changeOwnership\"\nimport type { CreateEntityParameters } from \"./createEntity\"\nimport type { DeleteEntityParameters } from \"./deleteEntity\"\nimport type { ExtendEntityParameters } from \"./extendEntity\"\nimport type { UpdateEntityParameters } from \"./updateEntity\"\n\nconst logger = getLogger(\"actions:wallet:mutate-entities\")\n\n/**\n * Parameters for the mutateEntities function.\n * - creates: The creates to perform.\n * - updates: The updates to perform.\n * - deletes: The deletes to perform.\n * - extensions: The extensions to perform.\n */\nexport type MutateEntitiesParameters = {\n  creates?: CreateEntityParameters[]\n  updates?: UpdateEntityParameters[]\n  deletes?: DeleteEntityParameters[]\n  extensions?: ExtendEntityParameters[]\n  ownershipChanges?: ChangeOwnershipParameters[]\n}\n\n/**\n * Return type for the mutateEntities function.\n * - txHash: The transaction hash.\n * - createdEntities: The keys of the created entities.\n * - updatedEntities: The keys of the updated entities.\n * - deletedEntities: The keys of the deleted entities.\n * - extendedEntities: The keys of the extended entities.\n * - ownershipChanges: The keys of the ownership changes.\n */\nexport type MutateEntitiesReturnType = {\n  txHash: Hash\n  createdEntities: Hex[]\n  updatedEntities: Hex[]\n  deletedEntities: Hex[]\n  extendedEntities: Hex[]\n  ownershipChanges: Hex[]\n}\n\nexport async function mutateEntities(\n  client: ArkivClient,\n  data: MutateEntitiesParameters,\n  txParams?: TxParams,\n): Promise<MutateEntitiesReturnType> {\n  if (!data.creates && !data.updates && !data.deletes && !data.extensions) {\n    throw new Error(\"No operations to perform\")\n  }\n\n  const { receipt, createdEntityKeys } = await sendArkivTransaction(client, data, txParams)\n\n  logger(\"Receipt from mutateEntities %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    createdEntities: createdEntityKeys,\n    updatedEntities: (data.updates ?? []).map((u) => u.entityKey),\n    deletedEntities: (data.deletes ?? []).map((d) => d.entityKey),\n    extendedEntities: (data.extensions ?? []).map((e) => e.entityKey),\n    ownershipChanges: (data.ownershipChanges ?? []).map((o) => o.entityKey),\n  }\n}\n","import type { Hash, Hex } from \"viem\"\nimport type { ArkivClient } from \"../../clients/baseClient\"\nimport type { Attribute, MimeType, TxParams } from \"../../types\"\nimport { sendArkivTransaction } from \"../../utils/arkivTransactions\"\nimport { getLogger } from \"../../utils/logger\"\n\nconst logger = getLogger(\"actions:wallet:update-entity\")\n\n/**\n * Parameters for the updateEntity function.\n * - entityKey: The key of the entity to update.\n * - payload: The payload of the entity.\n * - attributes: The attributes of the entity. Attribute values may be strings\n *   or numbers, but numeric values **must be integers**. To store a non-integer,\n *   scale it to an integer (e.g. `1.5` -> `1500`) to preserve numeric ordering,\n *   or pass it as a string (e.g. `\"1.5\"`). A non-integer numeric value throws an\n *   {@link InvalidAttributeError}.\n * - contentType: The content type of the entity.\n * - expiresIn: How long until the entity expires, in seconds. Because Arkiv\n *   measures expiration in blocks (1 block = 2 seconds), this **must be a\n *   positive integer and a multiple of the block time (2 seconds)**.\n *   Invalid values throw an {@link InvalidExpirationError}.\n */\nexport type UpdateEntityParameters = {\n  entityKey: Hex\n  payload: Uint8Array\n  /** Entity attributes. Numeric values must be integers (scale non-integers, e.g. `1.5` -> `1500`, or use a string). Throws {@link InvalidAttributeError} otherwise. */\n  attributes: Attribute[]\n  contentType: MimeType | string\n  /** Seconds until expiry. Must be a positive integer and a multiple of the 2s block time.\n   * Throws {@link InvalidExpirationError} otherwise. */\n  expiresIn: number\n}\n\n/**\n * Return type for the updateEntity function.\n * - entityKey: The key of the entity.\n * - txHash: The transaction hash.\n */\nexport type UpdateEntityReturnType = {\n  entityKey: Hex\n  txHash: Hash\n}\n\nexport async function updateEntity(\n  client: ArkivClient,\n  data: UpdateEntityParameters,\n  txParams?: TxParams,\n): Promise<UpdateEntityReturnType> {\n  logger(\"updateEntity %o\", data)\n  const { receipt } = await sendArkivTransaction(client, { updates: [data] }, txParams)\n\n  logger(\"Receipt from updateEntity %o\", receipt)\n\n  return {\n    txHash: receipt.transactionHash as Hash,\n    entityKey: data.entityKey,\n  }\n}\n","import type { Account, Chain, Client, PublicActions, Transport, WalletActions } from \"viem\"\nimport type {\n  ChangeOwnershipParameters,\n  ChangeOwnershipReturnType,\n} from \"../../actions/wallet/changeOwnership\"\nimport { changeOwnership } from \"../../actions/wallet/changeOwnership\"\nimport {\n  type CreateEntityParameters,\n  type CreateEntityReturnType,\n  createEntity,\n} from \"../../actions/wallet/createEntity\"\nimport type {\n  DeleteEntityParameters,\n  DeleteEntityReturnType,\n} from \"../../actions/wallet/deleteEntity\"\nimport { deleteEntity } from \"../../actions/wallet/deleteEntity\"\nimport type {\n  ExtendEntityParameters,\n  ExtendEntityReturnType,\n} from \"../../actions/wallet/extendEntity\"\nimport { extendEntity } from \"../../actions/wallet/extendEntity\"\nimport type {\n  MutateEntitiesParameters,\n  MutateEntitiesReturnType,\n} from \"../../actions/wallet/mutateEntities\"\nimport { mutateEntities } from \"../../actions/wallet/mutateEntities\"\nimport type {\n  UpdateEntityParameters,\n  UpdateEntityReturnType,\n} from \"../../actions/wallet/updateEntity\"\nimport { updateEntity } from \"../../actions/wallet/updateEntity\"\nimport type { TxParams } from \"../../types\"\n\nexport type WalletArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n> = Pick<\n  PublicActions<transport, chain, account>,\n  \"waitForTransactionReceipt\" | \"call\" | \"simulateContract\" | \"readContract\" | \"getBlockNumber\"\n> &\n  Pick<\n    WalletActions<chain, account>,\n    | \"addChain\"\n    | \"sendCalls\"\n    | \"waitForCallsStatus\"\n    | \"sendTransaction\"\n    | \"sendRawTransaction\"\n    | \"signMessage\"\n    | \"signTransaction\"\n    | \"writeContract\"\n  > & {\n    /**\n     * Creates a new entity.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/createEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity creation parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The created entity with transaction hash\n     *\n     * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer\n     * that is a multiple of the block time (2 seconds).\n     * @throws {InvalidAttributeError} If a numeric attribute value is not an\n     * integer.\n     *\n     * @example\n     * import { createPublicClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createPublicClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.createEntity({\n     *   payload: toBytes(JSON.stringify({ entity: { entityType: \"testType\", entityId: \"testId\" } })),\n     *   attributes: [{ key: \"testKey\", value: \"testValue\" }],\n     *   expiresIn: 1000,\n     * })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    createEntity: (\n      data: CreateEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<CreateEntityReturnType>\n\n    /**\n     * Updates the entity with the given key.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/updateEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity update parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The updated entity with transaction hash\n     *\n     * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer\n     * that is a multiple of the block time (2 seconds).\n     * @throws {InvalidAttributeError} If a numeric attribute value is not an\n     * integer.\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     */\n    updateEntity: (\n      data: UpdateEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<UpdateEntityReturnType>\n\n    /**\n     * Deletes the entity with the given key.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/deleteEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity deletion parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The deleted entity with transaction hash\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.deleteEntity({ entityKey: \"0x123\" })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    deleteEntity: (\n      data: DeleteEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<DeleteEntityReturnType>\n\n    /**\n     * Extends the entity with the given key.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/extendEntity\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The entity update parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The updated entity with transaction hash\n     *\n     * @throws {InvalidExpirationError} If `expiresIn` is not a positive integer\n     * that is a multiple of the block time (2 seconds).\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.extendEntity(\"0x123\", {\n     *   expiresIn: 1000,\n     * })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    extendEntity: (\n      data: ExtendEntityParameters,\n      txParams?: TxParams,\n    ) => Promise<ExtendEntityReturnType>\n\n    /**\n     * Changes the ownership of the entity with the given address.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/changeOwnership\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The ownership change parameters\n     * @param txParams - Optional transaction parameters\n     * @returns The entity with updated ownership and transaction hash\n     */\n    changeOwnership: (\n      data: ChangeOwnershipParameters,\n      txParams?: TxParams,\n    ) => Promise<ChangeOwnershipReturnType>\n\n    /**\n     * Mutates the entities with the given keys.\n     *\n     * - Docs: https://docs.arkiv.network/ts-sdk/actions/wallet/mutateEntities\n     * - JSON-RPC Methods: [`eth_sendRawTransaction`](https://docs.arkiv.network/dev/json-rpc-api/#mutateEntities)\n     *\n     * @param data - The mutation parameters (creates, updates, deletes, extensions)\n     * @param txParams - Optional transaction parameters\n     * @returns The mutation result with transaction hash\n     *\n     * @throws {InvalidExpirationError} If any create/update/extension `expiresIn`\n     * is not a positive integer that is a multiple of the block time (2 seconds).\n     * @throws {InvalidAttributeError} If a numeric attribute value is not an\n     * integer.\n     *\n     * @example\n     * import { createWalletClient, http } from 'arkiv'\n     * import { braga } from 'arkiv/chains'\n     *\n     * const client = createWalletClient({\n     *   chain: braga,\n     *   transport: http(),\n     * })\n     * const { entityKey, txHash } = await client.mutateEntities({\n     *   creates: [{\n     *     payload: toBytes(JSON.stringify({ entity: { entityType: \"testType\", entityId: \"testId\" } })),\n     *     attriubutes: [{ key: \"testKey\", value: \"testValue\" }],\n     *     expiresIn: 1000,\n     *   }],\n     *   updates: [{\n     *     entityKey: \"0x123\",\n     *     payload: toBytes(JSON.stringify({ entity: { entityType: \"testType\", entityId: \"testId\" } })),\n     *     attributes: [{ key: \"testKey\", value: \"testValue\" }],\n     *     expiresIn: 1000,\n     *   }],\n     *   deletes: [{\n     *     entityKey: \"0x321\",\n     *   }],\n     *   extensions: [{\n     *     entityKey: \"0x1234\",\n     *     expiresIn: 1000,\n     *   }],\n     * })\n     * console.log(\"entityKey\", entityKey)\n     * console.log(\"txHash\", txHash)\n     * // {\n     * //   entityKey: \"0x123\",\n     * //   txHash: \"0x123\",\n     * // }\n     */\n    mutateEntities: (\n      data: MutateEntitiesParameters,\n      txParams?: TxParams,\n    ) => Promise<MutateEntitiesReturnType>\n  }\n\nexport function walletArkivActions<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n>(client: Client<transport, chain, account>) {\n  return {\n    createEntity: (data: CreateEntityParameters, txParams?: TxParams) =>\n      createEntity(client, data, txParams),\n    updateEntity: (data: UpdateEntityParameters, txParams?: TxParams) =>\n      updateEntity(client, data, txParams),\n    deleteEntity: (data: DeleteEntityParameters, txParams?: TxParams) =>\n      deleteEntity(client, data, txParams),\n    extendEntity: (data: ExtendEntityParameters, txParams?: TxParams) =>\n      extendEntity(client, data, txParams),\n    changeOwnership: (data: ChangeOwnershipParameters, txParams?: TxParams) =>\n      changeOwnership(client, data, txParams),\n    mutateEntities: (data: MutateEntitiesParameters, txParams?: TxParams) =>\n      mutateEntities(client, data, txParams),\n  }\n}\n","import type {\n  Account,\n  Address,\n  Chain,\n  Client,\n  ParseAccount,\n  Prettify,\n  RpcSchema,\n  Transport,\n  WalletClientConfig,\n} from \"viem\"\nimport { createClient, publicActions, walletActions } from \"viem\"\nimport type { ArkivRpcSchema } from \"../types/rpcSchema\"\nimport { type WalletArkivActions, walletArkivActions } from \"./decorators/arkivWallet\"\n\nexport type WalletArkivClient<\n  transport extends Transport = Transport,\n  chain extends Chain | undefined = Chain | undefined,\n  account extends Account | undefined = Account | undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n> = Prettify<\n  Client<transport, chain, account, rpcSchema, WalletArkivActions<transport, chain, account>>\n>\n\n/**\n * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).\n *\n * - Docs: https://docs.arkiv.network/ts-sdk/clients/public\n *\n * 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 [Braga JSON-RPC API](https://braga.holesky.arkiv.network/rpc) methods such as retrieving block numbers, transactions, reading from smart contracts, etc through [Public Actions](/docs/actions/public/introduction).\n *\n * @param parameters - Configuration object for the wallet client (chain, transport, account, etc.)\n * @returns A Arkiv Wallet Client. {@link WalletArkivClient}\n *\n * @example\n * import { createPublicClient, http } from 'arkiv'\n * import { braga } from 'arkiv/chains'\n *\n * const client = createPublicClient({\n *   chain: braga,\n *   transport: http(),\n * })\n */\nexport function createWalletClient<\n  transport extends Transport,\n  chain extends Chain | undefined = undefined,\n  accountOrAddress extends Account | Address | undefined = undefined,\n  rpcSchema extends RpcSchema | undefined = ArkivRpcSchema,\n>(\n  parameters: WalletClientConfig<transport, chain, accountOrAddress, rpcSchema>,\n): WalletArkivClient<transport, chain, ParseAccount<accountOrAddress>, rpcSchema> {\n  const { key = \"wallet\", name = \"Wallet Client\" } = parameters\n  const client = createClient({\n    ...parameters,\n    key,\n    name,\n  })\n\n  return client\n    .extend(publicActions)\n    .extend(walletActions)\n    .extend(walletArkivActions) as unknown as WalletArkivClient<\n    transport,\n    chain,\n    ParseAccount<accountOrAddress>,\n    rpcSchema\n  >\n}\n","import type { Chain } from \"viem\"\nimport * as chains from \"../chains\"\n\n// Create a lookup map from all exported chains\nconst chainMap = new Map(Object.entries(chains).map(([key, value]) => [key.toLowerCase(), value]))\n\n/**\n * Get a chain from its name\n * @param name - The name of the chain, case insensitive\n * @returns The chain\n * @throws An error if the chain is not found\n */\nexport function chainFromName(name: string): Chain {\n  const chain = chainMap.get(name.toLowerCase())\n  if (!chain) {\n    throw new Error(`Unknown chain: ${name}`)\n  }\n  return chain as Chain\n}\n"],"mappings":"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"}

package/dist/{payload-Claf2jUO.js → payload-BpNUPOnY.js}

@@ -1,13 +1,13 @@
-import { toBytes } from "viem";
+import { stringToBytes, toBytes } from "viem";
 
 //#region src/utils/payload.ts
 function jsonToPayload(json) {
 	return toBytes(JSON.stringify(json));
 }
 function stringToPayload(data) {
-	return toBytes(data);
+	return stringToBytes(data);
 }
 
 //#endregion
 export { stringToPayload as n, jsonToPayload as t };
-//# sourceMappingURL=payload-Claf2jUO.js.map
+//# sourceMappingURL=payload-BpNUPOnY.js.map

package/dist/payload-BpNUPOnY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-BpNUPOnY.js","names":[],"sources":["../src/utils/payload.ts"],"sourcesContent":["import { stringToBytes, toBytes } from \"viem\"\n\nexport function jsonToPayload(json: object): Uint8Array {\n  return toBytes(JSON.stringify(json))\n}\n\nexport function stringToPayload(data: string): Uint8Array {\n  // stringToBytes, not toBytes: toBytes hex-decodes hex-looking strings, which\n  // would corrupt payloads like \"0xab\" instead of UTF-8 encoding them\n  return stringToBytes(data)\n}\n"],"mappings":";;;AAEA,SAAgB,cAAc,MAA0B;AACtD,QAAO,QAAQ,KAAK,UAAU,KAAK,CAAC;;AAGtC,SAAgB,gBAAgB,MAA0B;AAGxD,QAAO,cAAc,KAAK"}

package/dist/{payload-B2kFJyah.d.ts → payload-C2KHOUoj.d.ts}

@@ -3,4 +3,4 @@ declare function jsonToPayload(json: object): Uint8Array;
 declare function stringToPayload(data: string): Uint8Array;
 //#endregion
 export { stringToPayload as n, jsonToPayload as t };
-//# sourceMappingURL=payload-B2kFJyah.d.ts.map
+//# sourceMappingURL=payload-C2KHOUoj.d.ts.map

package/dist/{payload-B2kFJyah.d.ts.map → payload-C2KHOUoj.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"payload-B2kFJyah.d.ts","names":[],"sources":["../src/utils/payload.ts"],"sourcesContent":[],"mappings":";iBAEgB,aAAA,gBAA6B;AAA7B,iBAIA,eAAA,CAJ6B,IAAU,EAAA,MAAA,CAAA,EAIR,UAJQ"}
+{"version":3,"file":"payload-C2KHOUoj.d.ts","names":[],"sources":["../src/utils/payload.ts"],"sourcesContent":[],"mappings":";iBAEgB,aAAA,gBAA6B;AAA7B,iBAIA,eAAA,CAJ6B,IAAU,EAAA,MAAA,CAAA,EAIR,UAJQ"}

package/dist/{payload-DpA5PA-w.cjs → payload-D8YLKcJj.cjs}

@@ -5,7 +5,7 @@ function jsonToPayload(json) {
 	return (0, viem.toBytes)(JSON.stringify(json));
 }
 function stringToPayload(data) {
-	return (0, viem.toBytes)(data);
+	return (0, viem.stringToBytes)(data);
 }
 
 //#endregion

package/dist/query/index.cjs

@@ -1,5 +1,6 @@
-const require_queryBuilder = require('../queryBuilder-UW2MCaX4.cjs');
-require('../consts-AUoL-v42.cjs');
+const require_queryBuilder = require('../queryBuilder-J37buGCi.cjs');
+require('../consts-CxT1-RXU.cjs');
+require('../entity-BhSXaB23.cjs');
 
 //#region src/query/predicate.ts
 function or(...predicates) {

package/dist/query/index.d.cts

@@ -1,3 +1,3 @@
-import "../entity-B6g_EPm1.cjs";
-import { C as neq, S as lte, T as or, _ as and, a as asc, b as gte, c as FullEntity, d as SelectionFields, f as selectionToIncludeData, g as PredicateType, h as PredicateContainerType, i as SelectQueryBuilder, l as ProjectedEntity, m as Predicate, n as OrderByAttribute, o as desc, p as QueryResult, r as QueryBuilder, s as EntitySelection, t as BaseQueryBuilder, u as SelectArg, v as eq, w as not, x as lt, y as gt } from "../index-Ds9dwqb5.cjs";
+import "../entity-CN41IOrq.cjs";
+import { C as neq, S as lte, T as or, _ as and, a as asc, b as gte, c as FullEntity, d as SelectionFields, f as selectionToIncludeData, g as PredicateType, h as PredicateContainerType, i as SelectQueryBuilder, l as ProjectedEntity, m as Predicate, n as OrderByAttribute, o as desc, p as QueryResult, r as QueryBuilder, s as EntitySelection, t as BaseQueryBuilder, u as SelectArg, v as eq, w as not, x as lt, y as gt } from "../index-w4qop0Pe.cjs";
 export { BaseQueryBuilder, EntitySelection, FullEntity, OrderByAttribute, Predicate, PredicateContainerType, PredicateType, ProjectedEntity, QueryBuilder, QueryResult, SelectArg, SelectQueryBuilder, SelectionFields, and, asc, desc, eq, gt, gte, lt, lte, neq, not, or, selectionToIncludeData };

package/dist/query/index.d.ts

@@ -1,3 +1,3 @@
-import "../entity-qoLMAuuk.js";
-import { C as neq, S as lte, T as or, _ as and, a as asc, b as gte, c as FullEntity, d as SelectionFields, f as selectionToIncludeData, g as PredicateType, h as PredicateContainerType, i as SelectQueryBuilder, l as ProjectedEntity, m as Predicate, n as OrderByAttribute, o as desc, p as QueryResult, r as QueryBuilder, s as EntitySelection, t as BaseQueryBuilder, u as SelectArg, v as eq, w as not, x as lt, y as gt } from "../index-DdspxNAA.js";
+import "../entity-NnEVlePN.js";
+import { C as neq, S as lte, T as or, _ as and, a as asc, b as gte, c as FullEntity, d as SelectionFields, f as selectionToIncludeData, g as PredicateType, h as PredicateContainerType, i as SelectQueryBuilder, l as ProjectedEntity, m as Predicate, n as OrderByAttribute, o as desc, p as QueryResult, r as QueryBuilder, s as EntitySelection, t as BaseQueryBuilder, u as SelectArg, v as eq, w as not, x as lt, y as gt } from "../index-ClkpS6s_.js";
 export { BaseQueryBuilder, EntitySelection, FullEntity, OrderByAttribute, Predicate, PredicateContainerType, PredicateType, ProjectedEntity, QueryBuilder, QueryResult, SelectArg, SelectQueryBuilder, SelectionFields, and, asc, desc, eq, gt, gte, lt, lte, neq, not, or, selectionToIncludeData };

package/dist/query/index.js

@@ -1,5 +1,6 @@
-import { a as desc, i as asc, n as QueryBuilder, o as selectionToIncludeData, r as SelectQueryBuilder, s as QueryResult, t as BaseQueryBuilder } from "../queryBuilder-D2uwP9jI.js";
-import "../consts-BV4PR-de.js";
+import { a as desc, i as asc, n as QueryBuilder, o as selectionToIncludeData, r as SelectQueryBuilder, s as QueryResult, t as BaseQueryBuilder } from "../queryBuilder-BE_XhLLa.js";
+import "../consts-Bz0LZQZY.js";
+import "../entity-DGfVyB-a.js";
 
 //#region src/query/predicate.ts
 function or(...predicates) {

package/dist/query/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/query/predicate.ts"],"sourcesContent":["export type PredicateType = \"eq\" | \"neq\" | \"gt\" | \"gte\" | \"lt\" | \"lte\" | \"not\"\nexport type PredicateContainerType = \"or\" | \"and\"\n\nexport type Predicate =\n  | {\n      type: PredicateType\n      key: string\n      value: string | number\n    }\n  | {\n      type: PredicateContainerType\n      predicates: Predicate[]\n    }\n\n/**\n * Creates an OR predicate\n * @param predicates - The predicates to combine, either as a single array or as separate arguments\n * @returns The OR predicate\n *\n * @example\n * const result = or(eq(\"name\", \"John\"), eq(\"age\", 30))\n * // or equivalently: or([eq(\"name\", \"John\"), eq(\"age\", 30)])\n * // result = { type: \"or\", predicates: [eq(\"name\", \"John\"), eq(\"age\", 30)] }\n *\n */\nexport function or(predicates: Predicate[]): Predicate\nexport function or(...predicates: Predicate[]): Predicate\nexport function or(...predicates: (Predicate | Predicate[])[]): Predicate {\n  return { type: \"or\", predicates: predicates.flat() }\n}\n\n/**\n * Creates an AND predicate\n * @param predicates - The predicates to combine, either as a single array or as separate arguments\n * @returns The AND predicate\n *\n * @example\n * const result = and(eq(\"name\", \"John\"), eq(\"age\", 30))\n * // or equivalently: and([eq(\"name\", \"John\"), eq(\"age\", 30)])\n * // result = { type: \"and\", predicates: [eq(\"name\", \"John\"), eq(\"age\", 30)] }\n *\n */\nexport function and(predicates: Predicate[]): Predicate\nexport function and(...predicates: Predicate[]): Predicate\nexport function and(...predicates: (Predicate | Predicate[])[]): Predicate {\n  return { type: \"and\", predicates: predicates.flat() }\n}\n\n/**\n * Creates an equality predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The equality predicate\n *\n * @example\n * const predicate = eq(\"name\", \"John\")\n * // result = { type: \"eq\", key: \"name\", value: \"John\" }\n */\nexport function eq(key: string, value: string | number): Predicate {\n  return { type: \"eq\", key, value }\n}\n\n/**\n * Creates a not equal predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The not equal predicate\n *\n * @example\n * const predicate = neq(\"name\", \"John\")\n * // result = { type: \"neq\", key: \"name\", value: \"John\" }\n */\nexport function neq(key: string, value: string | number): Predicate {\n  return { type: \"neq\", key, value }\n}\n\n/**\n * Creates a greater than predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The greater than predicate\n *\n * @example\n * const predicate = gt(\"name\", \"John\")\n * // result = { type: \"gt\", key: \"name\", value: \"John\" }\n */\nexport function gt(key: string, value: string | number): Predicate {\n  return { type: \"gt\", key, value }\n}\n\n/**\n * Creates a greater than or equal predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The greater than or equal predicate\n *\n * @example\n * const predicate = gte(\"name\", \"John\")\n * // result = { type: \"gte\", key: \"name\", value: \"John\" }\n */\nexport function gte(key: string, value: string | number): Predicate {\n  return { type: \"gte\", key, value }\n}\n\n/**\n * Creates a less than predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The less than predicate\n *\n * @example\n * const predicate = lt(\"name\", \"John\")\n * // result = { type: \"lt\", key: \"name\", value: \"John\" }\n */\nexport function lt(key: string, value: string | number): Predicate {\n  return { type: \"lt\", key, value }\n}\n\n/**\n * Creates a less than or equal predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The less than or equal predicate\n *\n * @example\n * const predicate = lte(\"name\", \"John\")\n * // result = { type: \"lte\", key: \"name\", value: \"John\" }\n */\nexport function lte(key: string, value: string | number): Predicate {\n  return { type: \"lte\", key, value }\n}\n\n/**\n * Creates a not predicate\n * @param key - The key to compare\n * @returns The not predicate\n *\n * @example\n * const predicate = not(\"name\")\n * // result = { type: \"not\", key: \"name\", value: \"\" }\n */\nexport function not(key: string): Predicate {\n  return { type: \"not\", key, value: \"\" }\n}\n"],"mappings":";;;;AA2BA,SAAgB,GAAG,GAAG,YAAoD;AACxE,QAAO;EAAE,MAAM;EAAM,YAAY,WAAW,MAAM;EAAE;;AAgBtD,SAAgB,IAAI,GAAG,YAAoD;AACzE,QAAO;EAAE,MAAM;EAAO,YAAY,WAAW,MAAM;EAAE;;;;;;;;;;;;AAavD,SAAgB,GAAG,KAAa,OAAmC;AACjE,QAAO;EAAE,MAAM;EAAM;EAAK;EAAO;;;;;;;;;;;;AAanC,SAAgB,IAAI,KAAa,OAAmC;AAClE,QAAO;EAAE,MAAM;EAAO;EAAK;EAAO;;;;;;;;;;;;AAapC,SAAgB,GAAG,KAAa,OAAmC;AACjE,QAAO;EAAE,MAAM;EAAM;EAAK;EAAO;;;;;;;;;;;;AAanC,SAAgB,IAAI,KAAa,OAAmC;AAClE,QAAO;EAAE,MAAM;EAAO;EAAK;EAAO;;;;;;;;;;;;AAapC,SAAgB,GAAG,KAAa,OAAmC;AACjE,QAAO;EAAE,MAAM;EAAM;EAAK;EAAO;;;;;;;;;;;;AAanC,SAAgB,IAAI,KAAa,OAAmC;AAClE,QAAO;EAAE,MAAM;EAAO;EAAK;EAAO;;;;;;;;;;;AAYpC,SAAgB,IAAI,KAAwB;AAC1C,QAAO;EAAE,MAAM;EAAO;EAAK,OAAO;EAAI"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/query/predicate.ts"],"sourcesContent":["export type PredicateType = \"eq\" | \"neq\" | \"gt\" | \"gte\" | \"lt\" | \"lte\" | \"not\"\nexport type PredicateContainerType = \"or\" | \"and\"\n\nexport type Predicate =\n  | {\n      type: PredicateType\n      key: string\n      value: string | number\n    }\n  | {\n      type: PredicateContainerType\n      predicates: Predicate[]\n    }\n\n/**\n * Creates an OR predicate\n * @param predicates - The predicates to combine, either as a single array or as separate arguments\n * @returns The OR predicate\n *\n * @example\n * const result = or(eq(\"name\", \"John\"), eq(\"age\", 30))\n * // or equivalently: or([eq(\"name\", \"John\"), eq(\"age\", 30)])\n * // result = { type: \"or\", predicates: [eq(\"name\", \"John\"), eq(\"age\", 30)] }\n *\n */\nexport function or(predicates: Predicate[]): Predicate\nexport function or(...predicates: Predicate[]): Predicate\nexport function or(...predicates: (Predicate | Predicate[])[]): Predicate {\n  return { type: \"or\", predicates: predicates.flat() }\n}\n\n/**\n * Creates an AND predicate\n * @param predicates - The predicates to combine, either as a single array or as separate arguments\n * @returns The AND predicate\n *\n * @example\n * const result = and(eq(\"name\", \"John\"), eq(\"age\", 30))\n * // or equivalently: and([eq(\"name\", \"John\"), eq(\"age\", 30)])\n * // result = { type: \"and\", predicates: [eq(\"name\", \"John\"), eq(\"age\", 30)] }\n *\n */\nexport function and(predicates: Predicate[]): Predicate\nexport function and(...predicates: Predicate[]): Predicate\nexport function and(...predicates: (Predicate | Predicate[])[]): Predicate {\n  return { type: \"and\", predicates: predicates.flat() }\n}\n\n/**\n * Creates an equality predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The equality predicate\n *\n * @example\n * const predicate = eq(\"name\", \"John\")\n * // result = { type: \"eq\", key: \"name\", value: \"John\" }\n */\nexport function eq(key: string, value: string | number): Predicate {\n  return { type: \"eq\", key, value }\n}\n\n/**\n * Creates a not equal predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The not equal predicate\n *\n * @example\n * const predicate = neq(\"name\", \"John\")\n * // result = { type: \"neq\", key: \"name\", value: \"John\" }\n */\nexport function neq(key: string, value: string | number): Predicate {\n  return { type: \"neq\", key, value }\n}\n\n/**\n * Creates a greater than predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The greater than predicate\n *\n * @example\n * const predicate = gt(\"name\", \"John\")\n * // result = { type: \"gt\", key: \"name\", value: \"John\" }\n */\nexport function gt(key: string, value: string | number): Predicate {\n  return { type: \"gt\", key, value }\n}\n\n/**\n * Creates a greater than or equal predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The greater than or equal predicate\n *\n * @example\n * const predicate = gte(\"name\", \"John\")\n * // result = { type: \"gte\", key: \"name\", value: \"John\" }\n */\nexport function gte(key: string, value: string | number): Predicate {\n  return { type: \"gte\", key, value }\n}\n\n/**\n * Creates a less than predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The less than predicate\n *\n * @example\n * const predicate = lt(\"name\", \"John\")\n * // result = { type: \"lt\", key: \"name\", value: \"John\" }\n */\nexport function lt(key: string, value: string | number): Predicate {\n  return { type: \"lt\", key, value }\n}\n\n/**\n * Creates a less than or equal predicate\n * @param key - The key to compare\n * @param value - The value to compare\n * @returns The less than or equal predicate\n *\n * @example\n * const predicate = lte(\"name\", \"John\")\n * // result = { type: \"lte\", key: \"name\", value: \"John\" }\n */\nexport function lte(key: string, value: string | number): Predicate {\n  return { type: \"lte\", key, value }\n}\n\n/**\n * Creates a not predicate\n * @param key - The key to compare\n * @returns The not predicate\n *\n * @example\n * const predicate = not(\"name\")\n * // result = { type: \"not\", key: \"name\", value: \"\" }\n */\nexport function not(key: string): Predicate {\n  return { type: \"not\", key, value: \"\" }\n}\n"],"mappings":";;;;;AA2BA,SAAgB,GAAG,GAAG,YAAoD;AACxE,QAAO;EAAE,MAAM;EAAM,YAAY,WAAW,MAAM;EAAE;;AAgBtD,SAAgB,IAAI,GAAG,YAAoD;AACzE,QAAO;EAAE,MAAM;EAAO,YAAY,WAAW,MAAM;EAAE;;;;;;;;;;;;AAavD,SAAgB,GAAG,KAAa,OAAmC;AACjE,QAAO;EAAE,MAAM;EAAM;EAAK;EAAO;;;;;;;;;;;;AAanC,SAAgB,IAAI,KAAa,OAAmC;AAClE,QAAO;EAAE,MAAM;EAAO;EAAK;EAAO;;;;;;;;;;;;AAapC,SAAgB,GAAG,KAAa,OAAmC;AACjE,QAAO;EAAE,MAAM;EAAM;EAAK;EAAO;;;;;;;;;;;;AAanC,SAAgB,IAAI,KAAa,OAAmC;AAClE,QAAO;EAAE,MAAM;EAAO;EAAK;EAAO;;;;;;;;;;;;AAapC,SAAgB,GAAG,KAAa,OAAmC;AACjE,QAAO;EAAE,MAAM;EAAM;EAAK;EAAO;;;;;;;;;;;;AAanC,SAAgB,IAAI,KAAa,OAAmC;AAClE,QAAO;EAAE,MAAM;EAAO;EAAK;EAAO;;;;;;;;;;;AAYpC,SAAgB,IAAI,KAAwB;AAC1C,QAAO;EAAE,MAAM;EAAO;EAAK,OAAO;EAAI"}