@inkd/sdk 0.9.0

package/dist/errors.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * @file errors.ts
+ * @description Custom error classes for the Inkd Protocol SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadError = exports.EncryptionError = exports.MaxSupplyReached = exports.TransactionFailed = exports.ArweaveNotConnected = exports.ClientNotConnected = exports.NotTokenOwner = exports.InscriptionNotFound = exports.TokenNotFound = exports.InsufficientFunds = exports.NotInkdHolder = exports.InkdError = void 0;
+/** Base error class for all Inkd SDK errors. */
+class InkdError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "InkdError";
+        this.code = code;
+    }
+}
+exports.InkdError = InkdError;
+/** Thrown when a wallet does not hold any InkdToken. */
+class NotInkdHolder extends InkdError {
+    address;
+    constructor(address) {
+        super(`Address ${address} does not hold any InkdToken. Mint or purchase one first.`, "NOT_INKD_HOLDER");
+        this.name = "NotInkdHolder";
+        this.address = address;
+    }
+}
+exports.NotInkdHolder = NotInkdHolder;
+/** Thrown when there are insufficient funds for an operation. */
+class InsufficientFunds extends InkdError {
+    required;
+    available;
+    constructor(required, available) {
+        super(`Insufficient funds: need ${required} wei, have ${available} wei`, "INSUFFICIENT_FUNDS");
+        this.name = "InsufficientFunds";
+        this.required = required;
+        this.available = available;
+    }
+}
+exports.InsufficientFunds = InsufficientFunds;
+/** Thrown when a token ID does not exist. */
+class TokenNotFound extends InkdError {
+    tokenId;
+    constructor(tokenId) {
+        super(`InkdToken #${tokenId} does not exist`, "TOKEN_NOT_FOUND");
+        this.name = "TokenNotFound";
+        this.tokenId = tokenId;
+    }
+}
+exports.TokenNotFound = TokenNotFound;
+/** Thrown when an inscription index is out of bounds. */
+class InscriptionNotFound extends InkdError {
+    tokenId;
+    index;
+    constructor(tokenId, index) {
+        super(`Inscription ${index} not found on InkdToken #${tokenId}`, "INSCRIPTION_NOT_FOUND");
+        this.name = "InscriptionNotFound";
+        this.tokenId = tokenId;
+        this.index = index;
+    }
+}
+exports.InscriptionNotFound = InscriptionNotFound;
+/** Thrown when the caller is not the owner of the token. */
+class NotTokenOwner extends InkdError {
+    tokenId;
+    caller;
+    constructor(tokenId, caller) {
+        super(`Address ${caller} is not the owner of InkdToken #${tokenId}`, "NOT_TOKEN_OWNER");
+        this.name = "NotTokenOwner";
+        this.tokenId = tokenId;
+        this.caller = caller;
+    }
+}
+exports.NotTokenOwner = NotTokenOwner;
+/** Thrown when the client is not connected. */
+class ClientNotConnected extends InkdError {
+    constructor() {
+        super("InkdClient is not connected. Call connect() first.", "CLIENT_NOT_CONNECTED");
+        this.name = "ClientNotConnected";
+    }
+}
+exports.ClientNotConnected = ClientNotConnected;
+/** Thrown when the Arweave client is not connected. */
+class ArweaveNotConnected extends InkdError {
+    constructor() {
+        super("Arweave client is not connected. Call connectArweave() first.", "ARWEAVE_NOT_CONNECTED");
+        this.name = "ArweaveNotConnected";
+    }
+}
+exports.ArweaveNotConnected = ArweaveNotConnected;
+/** Thrown when a transaction fails on-chain. */
+class TransactionFailed extends InkdError {
+    txHash;
+    constructor(message, txHash) {
+        super(message, "TRANSACTION_FAILED");
+        this.name = "TransactionFailed";
+        this.txHash = txHash;
+    }
+}
+exports.TransactionFailed = TransactionFailed;
+/** Thrown when max supply has been reached. */
+class MaxSupplyReached extends InkdError {
+    constructor() {
+        super("InkdToken max supply of 10,000 has been reached", "MAX_SUPPLY_REACHED");
+        this.name = "MaxSupplyReached";
+    }
+}
+exports.MaxSupplyReached = MaxSupplyReached;
+/** Thrown when encryption/decryption fails. */
+class EncryptionError extends InkdError {
+    constructor(message) {
+        super(message, "ENCRYPTION_ERROR");
+        this.name = "EncryptionError";
+    }
+}
+exports.EncryptionError = EncryptionError;
+/** Thrown when an Arweave upload fails. */
+class UploadError extends InkdError {
+    constructor(message) {
+        super(message, "UPLOAD_ERROR");
+        this.name = "UploadError";
+    }
+}
+exports.UploadError = UploadError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,gDAAgD;AAChD,MAAa,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AARD,8BAQC;AAED,wDAAwD;AACxD,MAAa,aAAc,SAAQ,SAAS;IAC1B,OAAO,CAAS;IAEhC,YAAY,OAAe;QACzB,KAAK,CACH,WAAW,OAAO,2DAA2D,EAC7E,iBAAiB,CAClB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAXD,sCAWC;AAED,iEAAiE;AACjE,MAAa,iBAAkB,SAAQ,SAAS;IAC9B,QAAQ,CAAS;IACjB,SAAS,CAAS;IAElC,YAAY,QAAgB,EAAE,SAAiB;QAC7C,KAAK,CACH,4BAA4B,QAAQ,cAAc,SAAS,MAAM,EACjE,oBAAoB,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAbD,8CAaC;AAED,6CAA6C;AAC7C,MAAa,aAAc,SAAQ,SAAS;IAC1B,OAAO,CAAS;IAEhC,YAAY,OAAe;QACzB,KAAK,CAAC,cAAc,OAAO,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AARD,sCAQC;AAED,yDAAyD;AACzD,MAAa,mBAAoB,SAAQ,SAAS;IAChC,OAAO,CAAS;IAChB,KAAK,CAAS;IAE9B,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CACH,eAAe,KAAK,4BAA4B,OAAO,EAAE,EACzD,uBAAuB,CACxB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAbD,kDAaC;AAED,4DAA4D;AAC5D,MAAa,aAAc,SAAQ,SAAS;IAC1B,OAAO,CAAS;IAChB,MAAM,CAAS;IAE/B,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CACH,WAAW,MAAM,mCAAmC,OAAO,EAAE,EAC7D,iBAAiB,CAClB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAbD,sCAaC;AAED,+CAA+C;AAC/C,MAAa,kBAAmB,SAAQ,SAAS;IAC/C;QACE,KAAK,CACH,oDAAoD,EACpD,sBAAsB,CACvB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AARD,gDAQC;AAED,uDAAuD;AACvD,MAAa,mBAAoB,SAAQ,SAAS;IAChD;QACE,KAAK,CACH,+DAA+D,EAC/D,uBAAuB,CACxB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AARD,kDAQC;AAED,gDAAgD;AAChD,MAAa,iBAAkB,SAAQ,SAAS;IAC9B,MAAM,CAAU;IAEhC,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AARD,8CAQC;AAED,+CAA+C;AAC/C,MAAa,gBAAiB,SAAQ,SAAS;IAC7C;QACE,KAAK,CACH,iDAAiD,EACjD,oBAAoB,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AARD,4CAQC;AAED,+CAA+C;AAC/C,MAAa,eAAgB,SAAQ,SAAS;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,2CAA2C;AAC3C,MAAa,WAAY,SAAQ,SAAS;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AALD,kCAKC"}

package/dist/events.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @file events.ts
+ * @description viem watchContractEvent wrappers for InkdRegistry.sol events.
+ *              Provides typed, reactive subscriptions to ProjectCreated and
+ *              VersionPushed — the two core lifecycle events of the protocol.
+ *
+ * @example
+ * ```ts
+ * import { watchProjectCreated, watchVersionPushed } from "@inkd/sdk/events";
+ * import { createPublicClient, http } from "viem";
+ * import { baseSepolia } from "viem/chains";
+ *
+ * const publicClient = createPublicClient({
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ *
+ * // Subscribe to all new projects
+ * const unwatch = watchProjectCreated(publicClient, "0xRegistry...", (event) => {
+ *   console.log("New project:", event.projectId, event.name, "by", event.owner);
+ * });
+ *
+ * // Filter to a specific project's versions
+ * const unwatch2 = watchVersionPushed(
+ *   publicClient,
+ *   "0xRegistry...",
+ *   (event) => console.log("Version pushed:", event.versionTag, event.arweaveHash),
+ *   { projectId: 42n }
+ * );
+ *
+ * // Stop watching
+ * unwatch();
+ * unwatch2();
+ * ```
+ */
+import type { PublicClient } from "viem";
+import type { Address } from "./ProjectRegistry.js";
+/**
+ * Decoded ProjectCreated event payload.
+ * Emitted by InkdRegistry.sol when a new project is registered.
+ */
+export interface ProjectCreatedEvent {
+    /** On-chain project identifier (auto-incrementing). */
+    projectId: bigint;
+    /** Initial project owner address. */
+    owner: Address;
+    /** Project name as stored on-chain. */
+    name: string;
+    /** SPDX license identifier (e.g. "MIT"). */
+    license: string;
+    /** Raw viem log metadata (block, tx hash, etc.). */
+    _log: unknown;
+}
+/**
+ * Decoded VersionPushed event payload.
+ * Emitted by InkdRegistry.sol when a new version is pushed to a project.
+ */
+export interface VersionPushedEvent {
+    /** ID of the project that received the new version. */
+    projectId: bigint;
+    /** Arweave transaction hash of the uploaded artifact. */
+    arweaveHash: string;
+    /** Human-readable version tag, e.g. "v1.2.0" or "checkpoint-42". */
+    versionTag: string;
+    /** Address that called pushVersion(). */
+    pushedBy: Address;
+    /** Raw viem log metadata (block, tx hash, etc.). */
+    _log: unknown;
+}
+/**
+ * Unsubscribe function returned by all watch* helpers.
+ * Call to stop polling / disconnect the underlying filter.
+ */
+export type Unwatch = () => void;
+/**
+ * Optional filters for watchProjectCreated.
+ * Only indexed arguments can be filtered at the RPC level.
+ */
+export interface ProjectCreatedFilter {
+    /** Filter events by project owner address. */
+    owner?: Address;
+}
+/**
+ * Optional filters for watchVersionPushed.
+ * Only indexed arguments can be filtered at the RPC level.
+ */
+export interface VersionPushedFilter {
+    /** Filter events by project ID. */
+    projectId?: bigint;
+}
+/**
+ * Subscribe to ProjectCreated events from InkdRegistry.
+ *
+ * Uses viem's watchContractEvent under the hood, which polls getLogs
+ * on a configurable interval (default 4 s on most public RPCs).
+ *
+ * @param publicClient  A connected viem PublicClient.
+ * @param registryAddress  Address of the InkdRegistry proxy contract.
+ * @param onEvent  Callback invoked for each matching event.
+ * @param filter   Optional indexed-arg filters (owner).
+ * @returns An unsubscribe function — call it to stop watching.
+ */
+export declare function watchProjectCreated(publicClient: PublicClient, registryAddress: Address, onEvent: (_event: ProjectCreatedEvent) => void, filter?: ProjectCreatedFilter): Unwatch;
+/**
+ * Subscribe to VersionPushed events from InkdRegistry.
+ *
+ * @param publicClient  A connected viem PublicClient.
+ * @param registryAddress  Address of the InkdRegistry proxy contract.
+ * @param onEvent  Callback invoked for each matching event.
+ * @param filter   Optional indexed-arg filters (projectId).
+ * @returns An unsubscribe function — call it to stop watching.
+ */
+export declare function watchVersionPushed(publicClient: PublicClient, registryAddress: Address, onEvent: (_event: VersionPushedEvent) => void, filter?: VersionPushedFilter): Unwatch;
+/**
+ * Watch both ProjectCreated and VersionPushed in one call.
+ *
+ * @example
+ * ```ts
+ * const { unwatchAll } = watchRegistryEvents(publicClient, "0xRegistry...", {
+ *   onProjectCreated: (e) => console.log("Created:", e.name),
+ *   onVersionPushed:  (e) => console.log("Version:", e.versionTag),
+ * });
+ *
+ * // Stop both
+ * unwatchAll();
+ * ```
+ */
+export declare function watchRegistryEvents(publicClient: PublicClient, registryAddress: Address, handlers: {
+    onProjectCreated?: (_event: ProjectCreatedEvent) => void;
+    onVersionPushed?: (_event: VersionPushedEvent) => void;
+    projectCreatedFilter?: ProjectCreatedFilter;
+    versionPushedFilter?: VersionPushedFilter;
+}): {
+    unwatchAll: Unwatch;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;AAEjC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,EAC9C,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAmBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,EAC7C,MAAM,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAmBT;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,QAAQ,EAAE;IACR,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACzD,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACvD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,GACA;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CA4BzB"}

package/dist/events.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * @file events.ts
+ * @description viem watchContractEvent wrappers for InkdRegistry.sol events.
+ *              Provides typed, reactive subscriptions to ProjectCreated and
+ *              VersionPushed — the two core lifecycle events of the protocol.
+ *
+ * @example
+ * ```ts
+ * import { watchProjectCreated, watchVersionPushed } from "@inkd/sdk/events";
+ * import { createPublicClient, http } from "viem";
+ * import { baseSepolia } from "viem/chains";
+ *
+ * const publicClient = createPublicClient({
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * });
+ *
+ * // Subscribe to all new projects
+ * const unwatch = watchProjectCreated(publicClient, "0xRegistry...", (event) => {
+ *   console.log("New project:", event.projectId, event.name, "by", event.owner);
+ * });
+ *
+ * // Filter to a specific project's versions
+ * const unwatch2 = watchVersionPushed(
+ *   publicClient,
+ *   "0xRegistry...",
+ *   (event) => console.log("Version pushed:", event.versionTag, event.arweaveHash),
+ *   { projectId: 42n }
+ * );
+ *
+ * // Stop watching
+ * unwatch();
+ * unwatch2();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchProjectCreated = watchProjectCreated;
+exports.watchVersionPushed = watchVersionPushed;
+exports.watchRegistryEvents = watchRegistryEvents;
+const ProjectRegistry_js_1 = require("./ProjectRegistry.js");
+// ─── Watchers ─────────────────────────────────────────────────────────────────
+/**
+ * Subscribe to ProjectCreated events from InkdRegistry.
+ *
+ * Uses viem's watchContractEvent under the hood, which polls getLogs
+ * on a configurable interval (default 4 s on most public RPCs).
+ *
+ * @param publicClient  A connected viem PublicClient.
+ * @param registryAddress  Address of the InkdRegistry proxy contract.
+ * @param onEvent  Callback invoked for each matching event.
+ * @param filter   Optional indexed-arg filters (owner).
+ * @returns An unsubscribe function — call it to stop watching.
+ */
+function watchProjectCreated(publicClient, registryAddress, onEvent, filter) {
+    return publicClient.watchContractEvent({
+        address: registryAddress,
+        abi: ProjectRegistry_js_1.INKD_REGISTRY_ABI,
+        eventName: "ProjectCreated",
+        args: filter?.owner ? { owner: filter.owner } : undefined,
+        onLogs(logs) {
+            for (const log of logs) {
+                const args = log.args ?? {};
+                onEvent({
+                    projectId: args.projectId ?? 0n,
+                    owner: args.owner ?? "0x",
+                    name: args.name ?? "",
+                    license: args.license ?? "",
+                    _log: log,
+                });
+            }
+        },
+    });
+}
+/**
+ * Subscribe to VersionPushed events from InkdRegistry.
+ *
+ * @param publicClient  A connected viem PublicClient.
+ * @param registryAddress  Address of the InkdRegistry proxy contract.
+ * @param onEvent  Callback invoked for each matching event.
+ * @param filter   Optional indexed-arg filters (projectId).
+ * @returns An unsubscribe function — call it to stop watching.
+ */
+function watchVersionPushed(publicClient, registryAddress, onEvent, filter) {
+    return publicClient.watchContractEvent({
+        address: registryAddress,
+        abi: ProjectRegistry_js_1.INKD_REGISTRY_ABI,
+        eventName: "VersionPushed",
+        args: filter?.projectId !== undefined ? { projectId: filter.projectId } : undefined,
+        onLogs(logs) {
+            for (const log of logs) {
+                const args = log.args ?? {};
+                onEvent({
+                    projectId: args.projectId ?? 0n,
+                    arweaveHash: args.arweaveHash ?? "",
+                    versionTag: args.versionTag ?? "",
+                    pushedBy: args.pushedBy ?? "0x",
+                    _log: log,
+                });
+            }
+        },
+    });
+}
+// ─── Batch Helper ─────────────────────────────────────────────────────────────
+/**
+ * Watch both ProjectCreated and VersionPushed in one call.
+ *
+ * @example
+ * ```ts
+ * const { unwatchAll } = watchRegistryEvents(publicClient, "0xRegistry...", {
+ *   onProjectCreated: (e) => console.log("Created:", e.name),
+ *   onVersionPushed:  (e) => console.log("Version:", e.versionTag),
+ * });
+ *
+ * // Stop both
+ * unwatchAll();
+ * ```
+ */
+function watchRegistryEvents(publicClient, registryAddress, handlers) {
+    const cleanups = [];
+    if (handlers.onProjectCreated) {
+        cleanups.push(watchProjectCreated(publicClient, registryAddress, handlers.onProjectCreated, handlers.projectCreatedFilter));
+    }
+    if (handlers.onVersionPushed) {
+        cleanups.push(watchVersionPushed(publicClient, registryAddress, handlers.onVersionPushed, handlers.versionPushedFilter));
+    }
+    return {
+        unwatchAll: () => cleanups.forEach((fn) => fn()),
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { useInkd } from "./useInkd";
+export { useToken } from "./useToken";
+export { useInscriptions } from "./useInscriptions";
+export { useInkdHolder } from "./useInkdHolder";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInkdHolder = exports.useInscriptions = exports.useToken = exports.useInkd = void 0;
+var useInkd_1 = require("./useInkd");
+Object.defineProperty(exports, "useInkd", { enumerable: true, get: function () { return useInkd_1.useInkd; } });
+var useToken_1 = require("./useToken");
+Object.defineProperty(exports, "useToken", { enumerable: true, get: function () { return useToken_1.useToken; } });
+var useInscriptions_1 = require("./useInscriptions");
+Object.defineProperty(exports, "useInscriptions", { enumerable: true, get: function () { return useInscriptions_1.useInscriptions; } });
+var useInkdHolder_1 = require("./useInkdHolder");
+Object.defineProperty(exports, "useInkdHolder", { enumerable: true, get: function () { return useInkdHolder_1.useInkdHolder; } });
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/dist/hooks/useInkd.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file useInkd.ts
+ * @description React hook for the Inkd Protocol client.
+ */
+import { InkdClient } from "../InkdClient";
+import type { InkdClientConfig, InkdTokenData, Inscription, TransactionResult, InscribeOptions, InscribeResult, ProtocolStats, Address } from "../types";
+import type { PublicClient, WalletClient, Account, Chain, Transport } from "viem";
+interface UseInkdReturn {
+    client: InkdClient;
+    connected: boolean;
+    connect: (walletClient: WalletClient<Transport, Chain, Account>, publicClient: PublicClient) => void;
+    connectArweave: (privateKey: string) => Promise<void>;
+    mintToken: (quantity?: number) => Promise<TransactionResult>;
+    inscribe: (tokenId: bigint, data: Buffer | Uint8Array | string, options?: InscribeOptions) => Promise<InscribeResult>;
+    getToken: (tokenId: bigint) => Promise<InkdTokenData>;
+    getInscriptions: (tokenId: bigint) => Promise<Inscription[]>;
+    hasInkdToken: (address: Address) => Promise<boolean>;
+    getStats: () => Promise<ProtocolStats>;
+    error: Error | null;
+}
+/** Main React hook for Inkd Protocol interaction. */
+export declare function useInkd(config: InkdClientConfig): UseInkdReturn;
+export {};
+//# sourceMappingURL=useInkd.d.ts.map

package/dist/hooks/useInkd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInkd.d.ts","sourceRoot":"","sources":["../../src/hooks/useInkd.ts"],"names":[],"mappings":"AACA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,OAAO,EACR,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAElF,UAAU,aAAa;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IACrG,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7D,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACtH,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,QAAQ,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAwG/D"}

package/dist/hooks/useInkd.js

@@ -0,0 +1,109 @@
+"use strict";
+/* eslint-disable no-unused-vars, @typescript-eslint/no-unused-vars */
+/**
+ * @file useInkd.ts
+ * @description React hook for the Inkd Protocol client.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInkd = useInkd;
+const react_1 = require("react");
+const InkdClient_1 = require("../InkdClient");
+/** Main React hook for Inkd Protocol interaction. */
+function useInkd(config) {
+    const clientRef = (0, react_1.useRef)(new InkdClient_1.InkdClient(config));
+    const [connected, setConnected] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const connect = (0, react_1.useCallback)((walletClient, publicClient) => {
+        clientRef.current.connect(walletClient, publicClient);
+        setConnected(true);
+        setError(null);
+    }, []);
+    const connectArweave = (0, react_1.useCallback)(async (privateKey) => {
+        try {
+            await clientRef.current.connectArweave(privateKey);
+            setError(null);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+    }, []);
+    const mintToken = (0, react_1.useCallback)(async (quantity) => {
+        try {
+            const result = await clientRef.current.mintToken({ quantity });
+            setError(null);
+            return result;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+    }, []);
+    const inscribe = (0, react_1.useCallback)(async (tokenId, data, options) => {
+        try {
+            const result = await clientRef.current.inscribe(tokenId, data, options);
+            setError(null);
+            return result;
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+    }, []);
+    const getToken = (0, react_1.useCallback)(async (tokenId) => {
+        try {
+            return await clientRef.current.getToken(tokenId);
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+    }, []);
+    const getInscriptions = (0, react_1.useCallback)(async (tokenId) => {
+        try {
+            return await clientRef.current.getInscriptions(tokenId);
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+    }, []);
+    const hasInkdToken = (0, react_1.useCallback)(async (address) => {
+        try {
+            return await clientRef.current.hasInkdToken(address);
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+    }, []);
+    const getStats = (0, react_1.useCallback)(async () => {
+        try {
+            return await clientRef.current.getStats();
+        }
+        catch (err) {
+            const e = err instanceof Error ? err : new Error(String(err));
+            setError(e);
+            throw e;
+        }
+    }, []);
+    return {
+        client: clientRef.current,
+        connected,
+        connect,
+        connectArweave,
+        mintToken,
+        inscribe,
+        getToken,
+        getInscriptions,
+        hasInkdToken,
+        getStats,
+        error,
+    };
+}
+//# sourceMappingURL=useInkd.js.map

package/dist/hooks/useInkd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInkd.js","sourceRoot":"","sources":["../../src/hooks/useInkd.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useInkdHolder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file useInkdHolder.ts
+ * @description React hook to check if an address holds an InkdToken.
+ */
+import type { InkdClient } from "../InkdClient";
+import type { Address } from "../types";
+interface UseInkdHolderReturn {
+    isHolder: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/** Check if a given address holds at least one InkdToken. */
+export declare function useInkdHolder(client: InkdClient, address: Address): UseInkdHolderReturn;
+export {};
+//# sourceMappingURL=useInkdHolder.d.ts.map

package/dist/hooks/useInkdHolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInkdHolder.d.ts","sourceRoot":"","sources":["../../src/hooks/useInkdHolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAsCvF"}

package/dist/hooks/useInkdHolder.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * @file useInkdHolder.ts
+ * @description React hook to check if an address holds an InkdToken.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInkdHolder = useInkdHolder;
+const react_1 = require("react");
+/** Check if a given address holds at least one InkdToken. */
+function useInkdHolder(client, address) {
+    const [isHolder, setIsHolder] = (0, react_1.useState)(false);
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [refetchKey, setRefetchKey] = (0, react_1.useState)(0);
+    (0, react_1.useEffect)(() => {
+        let cancelled = false;
+        async function checkHolder() {
+            setLoading(true);
+            setError(null);
+            try {
+                const result = await client.hasInkdToken(address);
+                if (!cancelled) {
+                    setIsHolder(result);
+                }
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            finally {
+                if (!cancelled) {
+                    setLoading(false);
+                }
+            }
+        }
+        void checkHolder();
+        return () => {
+            cancelled = true;
+        };
+    }, [client, address, refetchKey]);
+    const refetch = () => setRefetchKey((k) => k + 1);
+    return { isHolder, loading, error, refetch };
+}
+//# sourceMappingURL=useInkdHolder.js.map

package/dist/hooks/useInkdHolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInkdHolder.js","sourceRoot":"","sources":["../../src/hooks/useInkdHolder.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAcH,sCAsCC;AAlDD,iCAA4C;AAW5C,6DAA6D;AAC7D,SAAgB,aAAa,CAAC,MAAkB,EAAE,OAAgB;IAChE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,IAAA,gBAAQ,EAAC,CAAC,CAAC,CAAC;IAEhD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,KAAK,UAAU,WAAW;YACxB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAClD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,WAAW,CAAC,MAAM,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,WAAW,EAAE,CAAC;QAEnB,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAElD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}