@inkd/sdk 0.9.0

package/dist/multicall.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * @file multicall.ts
+ * @description Multicall3-powered batch reads for InkdRegistry.
+ *              Fetches multiple projects or versions in a single RPC round-trip,
+ *              dramatically reducing latency when listing/paginating projects.
+ *
+ * Uses viem's built-in `multicall` helper, which targets Multicall3
+ * (0xcA11bde05977b3631167028862bE2a173976CA11 — deployed on Base and Base Sepolia).
+ *
+ * @example
+ * ```ts
+ * import { batchGetProjects, batchGetFees } from "@inkd/sdk";
+ * import { createPublicClient, http } from "viem";
+ * import { baseSepolia } from "viem/chains";
+ *
+ * const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });
+ *
+ * // Fetch 5 projects in one RPC call
+ * const projects = await batchGetProjects(publicClient, "0xRegistry...", [1n, 2n, 3n, 4n, 5n]);
+ *
+ * // Fetch both fees in one RPC call
+ * const fees = await batchGetFees(publicClient, "0xRegistry...");
+ * console.log("Version fee:", fees.versionFee);
+ * console.log("Transfer fee:", fees.transferFee);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchGetProjects = batchGetProjects;
+exports.batchGetVersions = batchGetVersions;
+exports.batchGetFees = batchGetFees;
+exports.batchGetProjectsWithVersions = batchGetProjectsWithVersions;
+const ProjectRegistry_js_1 = require("./ProjectRegistry.js");
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Coerce a raw multicall result into a typed BatchResult<T>.
+ * Handles both viem's `{ result, status }` shape and raw revert cases.
+ */
+function coerceResult(raw) {
+    if (raw.status === "failure" || raw.status === undefined && raw.result === undefined) {
+        return {
+            data: null,
+            success: false,
+            error: raw.error instanceof Error ? raw.error.message : String(raw.error ?? "unknown"),
+        };
+    }
+    return {
+        data: raw.result,
+        success: true,
+    };
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Fetch multiple projects by their on-chain IDs in a **single RPC call**.
+ *
+ * Projects that don't exist (reverted getProject call) will have
+ * `success: false` and `data: null` in the returned array.
+ *
+ * @param publicClient   A connected viem PublicClient (Base or Base Sepolia).
+ * @param registryAddress  Address of the deployed InkdRegistry contract.
+ * @param projectIds  Array of project IDs to fetch (bigint).
+ * @returns Promise resolving to a `BatchResult<ProjectData>[]` in the same order.
+ *
+ * @example
+ * ```ts
+ * const results = await batchGetProjects(client, registry, [1n, 2n, 3n]);
+ * for (const r of results) {
+ *   if (r.success && r.data) console.log(r.data.name);
+ * }
+ * ```
+ */
+async function batchGetProjects(publicClient, registryAddress, projectIds) {
+    if (projectIds.length === 0)
+        return [];
+    const contracts = projectIds.map((id) => ({
+        address: registryAddress,
+        abi: ProjectRegistry_js_1.INKD_REGISTRY_ABI,
+        functionName: "getProject",
+        args: [id],
+    }));
+    const results = await publicClient.multicall({
+        contracts,
+        allowFailure: true,
+    });
+    return results.map((raw) => coerceResult(raw));
+}
+/**
+ * Fetch the latest versions for multiple projects in a **single RPC call**.
+ *
+ * Each element in the returned array corresponds to the project ID at the
+ * same index. Failed calls return `{ success: false, data: null }`.
+ *
+ * @param publicClient   A connected viem PublicClient.
+ * @param registryAddress  Address of the deployed InkdRegistry contract.
+ * @param projectIds  Array of project IDs whose versions to fetch.
+ * @returns Promise resolving to `BatchResult<VersionData[]>[]` in the same order.
+ */
+async function batchGetVersions(publicClient, registryAddress, projectIds) {
+    if (projectIds.length === 0)
+        return [];
+    const contracts = projectIds.map((id) => ({
+        address: registryAddress,
+        abi: ProjectRegistry_js_1.INKD_REGISTRY_ABI,
+        functionName: "getVersions",
+        args: [id],
+    }));
+    const results = await publicClient.multicall({
+        contracts,
+        allowFailure: true,
+    });
+    return results.map((raw) => coerceResult(raw));
+}
+/**
+ * Fetch versionFee, transferFee, and TOKEN_LOCK_AMOUNT in a **single RPC call**.
+ *
+ * Useful before any write operation (create project, push version, transfer)
+ * to confirm the required fee without extra round-trips.
+ *
+ * @param publicClient   A connected viem PublicClient.
+ * @param registryAddress  Address of the deployed InkdRegistry contract.
+ * @returns `RegistryFees` with all three fee values.
+ * @throws  If any of the three calls reverts (should never happen on a valid registry).
+ *
+ * @example
+ * ```ts
+ * const { versionFee, transferFee, tokenLockAmount } = await batchGetFees(client, registry);
+ * ```
+ */
+async function batchGetFees(publicClient, registryAddress) {
+    const contracts = [
+        {
+            address: registryAddress,
+            abi: ProjectRegistry_js_1.INKD_REGISTRY_ABI,
+            functionName: "versionFee",
+            args: [],
+        },
+        {
+            address: registryAddress,
+            abi: ProjectRegistry_js_1.INKD_REGISTRY_ABI,
+            functionName: "transferFee",
+            args: [],
+        },
+        {
+            address: registryAddress,
+            abi: ProjectRegistry_js_1.INKD_REGISTRY_ABI,
+            functionName: "TOKEN_LOCK_AMOUNT",
+            args: [],
+        },
+    ];
+    const results = await publicClient.multicall({
+        contracts,
+        allowFailure: false,
+    });
+    return {
+        versionFee: (results[0].result ?? 0n),
+        transferFee: (results[1].result ?? 0n),
+        tokenLockAmount: (results[2].result ?? 0n),
+    };
+}
+/**
+ * Fetch projects AND their versions for multiple IDs in **two RPC calls** (projects batch, then versions batch).
+ *
+ * This is more efficient than fetching each project + versions individually (2N+N calls → 2 calls).
+ *
+ * @param publicClient   A connected viem PublicClient.
+ * @param registryAddress  Address of the deployed InkdRegistry contract.
+ * @param projectIds  Array of project IDs to hydrate.
+ * @returns Array of `{ project, versions }` objects in the same order as input IDs.
+ */
+async function batchGetProjectsWithVersions(publicClient, registryAddress, projectIds) {
+    if (projectIds.length === 0)
+        return [];
+    const [projects, versions] = await Promise.all([
+        batchGetProjects(publicClient, registryAddress, projectIds),
+        batchGetVersions(publicClient, registryAddress, projectIds),
+    ]);
+    return projectIds.map((_, i) => ({
+        project: projects[i],
+        versions: versions[i],
+    }));
+}
+//# sourceMappingURL=multicall.js.map

package/dist/multicall.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,187 @@
+/**
+ * @file types.ts
+ * @description Core TypeScript types for the Inkd Protocol SDK.
+ */
+export type Address = `0x${string}`;
+/** Common content type values for inscriptions. */
+export declare enum ContentType {
+    JSON = "application/json",
+    PlainText = "text/plain",
+    Markdown = "text/markdown",
+    HTML = "text/html",
+    CSS = "text/css",
+    JavaScript = "application/javascript",
+    TypeScript = "application/typescript",
+    PNG = "image/png",
+    JPEG = "image/jpeg",
+    SVG = "image/svg+xml",
+    GIF = "image/gif",
+    WebP = "image/webp",
+    PDF = "application/pdf",
+    Binary = "application/octet-stream",
+    YAML = "application/yaml",
+    XML = "application/xml",
+    CSV = "text/csv",
+    WASM = "application/wasm"
+}
+/** InkdToken data as stored on-chain. */
+export interface InkdTokenData {
+    /** Unique on-chain token identifier. */
+    tokenId: bigint;
+    /** Current owner address. */
+    owner: Address;
+    /** Timestamp when the token was minted. */
+    mintedAt: bigint;
+    /** Number of active inscriptions on this token. */
+    inscriptionCount: number;
+    /** Token metadata URI (on-chain SVG). */
+    tokenURI: string;
+}
+/** A single inscription stored on an InkdToken. */
+export interface Inscription {
+    /** Arweave transaction ID. */
+    arweaveHash: string;
+    /** MIME type of the data. */
+    contentType: string;
+    /** File size in bytes. */
+    size: bigint;
+    /** Human-readable name. */
+    name: string;
+    /** Timestamp of creation. */
+    createdAt: bigint;
+    /** Whether the inscription has been soft-deleted. */
+    isRemoved: boolean;
+    /** Current version number. */
+    version: bigint;
+}
+/** Access grant for temporary read access. */
+export interface AccessGrant {
+    /** Wallet with access. */
+    grantee: Address;
+    /** Expiry timestamp. */
+    expiresAt: bigint;
+    /** When access was granted. */
+    grantedAt: bigint;
+}
+/** Marketplace listing data. */
+export interface SaleData {
+    /** Token ID being sold. */
+    tokenId: bigint;
+    /** Seller address. */
+    seller: Address;
+    /** Price in wei. */
+    price: bigint;
+    /** When the listing was created. */
+    listedAt: bigint;
+    /** Whether the listing is active. */
+    active: boolean;
+}
+/** Registry registration data. */
+export interface TokenRegistration {
+    /** Token ID. */
+    tokenId: bigint;
+    /** Owner address. */
+    owner: Address;
+    /** Whether the token is publicly discoverable. */
+    isPublic: boolean;
+    /** Registration timestamp. */
+    registeredAt: bigint;
+}
+/** Protocol-wide statistics. */
+export interface ProtocolStats {
+    /** Total registered tokens. */
+    totalTokens: bigint;
+    /** Total tracked inscriptions. */
+    totalInscriptions: bigint;
+    /** Total sales volume in wei. */
+    totalVolume: bigint;
+    /** Total completed sales. */
+    totalSales: bigint;
+}
+/** Configuration for the InkdClient. */
+export interface InkdClientConfig {
+    /** InkdToken proxy contract address. */
+    tokenAddress: Address;
+    /** InkdVault proxy contract address. */
+    vaultAddress: Address;
+    /** InkdRegistry proxy contract address. */
+    registryAddress: Address;
+    /** Chain ID (8453 = Base Mainnet, 84532 = Base Sepolia). */
+    chainId: 8453 | 84532;
+}
+/** Options for inscribing data. */
+export interface InscribeOptions {
+    /** Content type of the file. */
+    contentType?: string;
+    /** Human-readable name. */
+    name?: string;
+    /** Arweave upload tags. */
+    tags?: Record<string, string>;
+    /** ETH value to send (for protocol fee). */
+    value?: bigint;
+}
+/** Options for minting tokens. */
+export interface MintOptions {
+    /** Number of tokens to mint (for batch mint). */
+    quantity?: number;
+}
+/** Result of a successful on-chain transaction. */
+export interface TransactionResult {
+    /** Transaction hash. */
+    hash: Address;
+    /** Token ID (if applicable). */
+    tokenId?: bigint;
+}
+/** Result of a batch mint transaction. */
+export interface BatchTransactionResult {
+    /** Transaction hash. */
+    hash: Address;
+    /** Array of minted token IDs. */
+    tokenIds: bigint[];
+}
+/** Result of an inscription operation. */
+export interface InscribeResult {
+    /** Transaction hash. */
+    hash: Address;
+    /** Inscription index on the token. */
+    inscriptionIndex: bigint;
+    /** Arweave upload result. */
+    upload: UploadResult;
+}
+/** Result of an Arweave upload. */
+export interface UploadResult {
+    /** Arweave transaction hash. */
+    hash: string;
+    /** Full Arweave gateway URL. */
+    url: string;
+    /** Size of uploaded data in bytes. */
+    size: number;
+}
+/** Encryption configuration for Lit Protocol integration. */
+export interface EncryptionConfig {
+    /** Lit Protocol network to use. */
+    network: "datil" | "datil-dev" | "datil-test";
+    /** Chain for access control conditions. */
+    chain: string;
+}
+/** Result of encrypting data via Lit Protocol. */
+export interface EncryptedData {
+    /** Encrypted data blob. */
+    ciphertext: Uint8Array;
+    /** Encrypted symmetric key. */
+    encryptedSymmetricKey: string;
+    /** Access control conditions for decryption. */
+    accessControlConditions: unknown[];
+}
+/** Cost estimate for an inscription operation. */
+export interface InscribeCostEstimate {
+    /** Estimated gas cost in wei. */
+    gas: bigint;
+    /** Arweave storage cost in wei. */
+    arweave: bigint;
+    /** Protocol fee in wei. */
+    protocolFee: bigint;
+    /** Total estimated cost in wei. */
+    total: bigint;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * @file types.ts
+ * @description Core TypeScript types for the Inkd Protocol SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentType = void 0;
+// ─── Content Types ────────────────────────────────────────────────────────────
+/** Common content type values for inscriptions. */
+// eslint-disable-next-line no-unused-vars
+var ContentType;
+(function (ContentType) {
+    ContentType["JSON"] = "application/json";
+    ContentType["PlainText"] = "text/plain";
+    ContentType["Markdown"] = "text/markdown";
+    ContentType["HTML"] = "text/html";
+    ContentType["CSS"] = "text/css";
+    ContentType["JavaScript"] = "application/javascript";
+    ContentType["TypeScript"] = "application/typescript";
+    ContentType["PNG"] = "image/png";
+    ContentType["JPEG"] = "image/jpeg";
+    ContentType["SVG"] = "image/svg+xml";
+    ContentType["GIF"] = "image/gif";
+    ContentType["WebP"] = "image/webp";
+    ContentType["PDF"] = "application/pdf";
+    ContentType["Binary"] = "application/octet-stream";
+    ContentType["YAML"] = "application/yaml";
+    ContentType["XML"] = "application/xml";
+    ContentType["CSV"] = "text/csv";
+    ContentType["WASM"] = "application/wasm";
+})(ContentType || (exports.ContentType = ContentType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAMH,iFAAiF;AAEjF,mDAAmD;AACnD,0CAA0C;AAC1C,IAAY,WAmBX;AAnBD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,uCAAwB,CAAA;IACxB,yCAA0B,CAAA;IAC1B,iCAAkB,CAAA;IAClB,+BAAgB,CAAA;IAChB,oDAAqC,CAAA;IACrC,oDAAqC,CAAA;IACrC,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;IACrB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;IACnB,sCAAuB,CAAA;IACvB,kDAAmC,CAAA;IACnC,wCAAyB,CAAA;IACzB,sCAAuB,CAAA;IACvB,+BAAgB,CAAA;IAChB,wCAAyB,CAAA;AAC3B,CAAC,EAnBW,WAAW,2BAAX,WAAW,QAmBtB"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@inkd/sdk",
+  "version": "0.9.0",
+  "description": "TypeScript SDK for Inkd Protocol \u2014 permanent on-chain file ownership on Base",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./hooks": {
+      "import": "./dist/hooks/index.mjs",
+      "require": "./dist/hooks/index.js",
+      "types": "./dist/hooks/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts --max-warnings 0",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "keywords": [
+    "inkd",
+    "protocol",
+    "base",
+    "blockchain",
+    "arweave",
+    "sdk",
+    "web3",
+    "ai-agents",
+    "nft",
+    "erc721",
+    "inscription",
+    "permanent-storage"
+  ],
+  "author": "Inkd Protocol <dev@inkdprotocol.xyz>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/inkdprotocol/inkd-protocol.git",
+    "directory": "sdk"
+  },
+  "homepage": "https://inkdprotocol.xyz",
+  "bugs": {
+    "url": "https://github.com/inkdprotocol/inkd-protocol/issues"
+  },
+  "peerDependencies": {
+    "viem": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^1.6.1",
+    "typescript": "^5.0.0",
+    "viem": "^2.0.0",
+    "vitest": "^1.6.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}