@inkd/sdk 0.9.0

package/dist/hooks/useInscriptions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file useInscriptions.ts
+ * @description React hook for fetching inscriptions on an InkdToken.
+ */
+import type { InkdClient } from "../InkdClient";
+import type { Inscription } from "../types";
+interface UseInscriptionsReturn {
+    inscriptions: Inscription[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+    activeCount: number;
+}
+/** Fetch inscriptions on a specific InkdToken with loading states. */
+export declare function useInscriptions(client: InkdClient, tokenId: bigint): UseInscriptionsReturn;
+export {};
+//# sourceMappingURL=useInscriptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useInscriptions.d.ts","sourceRoot":"","sources":["../../src/hooks/useInscriptions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,UAAU,qBAAqB;IAC7B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAuC1F"}

package/dist/hooks/useInscriptions.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @file useInscriptions.ts
+ * @description React hook for fetching inscriptions on an InkdToken.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInscriptions = useInscriptions;
+const react_1 = require("react");
+/** Fetch inscriptions on a specific InkdToken with loading states. */
+function useInscriptions(client, tokenId) {
+    const [inscriptions, setInscriptions] = (0, react_1.useState)([]);
+    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 fetchInscriptions() {
+            setLoading(true);
+            setError(null);
+            try {
+                const data = await client.getInscriptions(tokenId);
+                if (!cancelled) {
+                    setInscriptions(data);
+                }
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            finally {
+                if (!cancelled) {
+                    setLoading(false);
+                }
+            }
+        }
+        void fetchInscriptions();
+        return () => {
+            cancelled = true;
+        };
+    }, [client, tokenId, refetchKey]);
+    const refetch = () => setRefetchKey((k) => k + 1);
+    const activeCount = inscriptions.filter((i) => !i.isRemoved).length;
+    return { inscriptions, loading, error, refetch, activeCount };
+}
+//# sourceMappingURL=useInscriptions.js.map

package/dist/hooks/useInscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInscriptions.js","sourceRoot":"","sources":["../../src/hooks/useInscriptions.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAeH,0CAuCC;AApDD,iCAA4C;AAY5C,sEAAsE;AACtE,SAAgB,eAAe,CAAC,MAAkB,EAAE,OAAe;IACjE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,IAAA,gBAAQ,EAAgB,EAAE,CAAC,CAAC;IACpE,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,iBAAiB;YAC9B,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,eAAe,CAAC,IAAI,CAAC,CAAC;gBACxB,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,iBAAiB,EAAE,CAAC;QAEzB,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;IAClD,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IAEpE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAChE,CAAC"}

package/dist/hooks/useToken.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file useToken.ts
+ * @description React hook for fetching InkdToken data with loading states.
+ */
+import type { InkdClient } from "../InkdClient";
+import type { InkdTokenData } from "../types";
+interface UseTokenReturn {
+    token: InkdTokenData | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/** Fetch and watch a specific InkdToken's data. */
+export declare function useToken(client: InkdClient, tokenId: bigint): UseTokenReturn;
+export {};
+//# sourceMappingURL=useToken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useToken.d.ts","sourceRoot":"","sources":["../../src/hooks/useToken.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,UAAU,cAAc;IACtB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAsC5E"}

package/dist/hooks/useToken.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * @file useToken.ts
+ * @description React hook for fetching InkdToken data with loading states.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useToken = useToken;
+const react_1 = require("react");
+/** Fetch and watch a specific InkdToken's data. */
+function useToken(client, tokenId) {
+    const [token, setToken] = (0, react_1.useState)(null);
+    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 fetchToken() {
+            setLoading(true);
+            setError(null);
+            try {
+                const data = await client.getToken(tokenId);
+                if (!cancelled) {
+                    setToken(data);
+                }
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            finally {
+                if (!cancelled) {
+                    setLoading(false);
+                }
+            }
+        }
+        void fetchToken();
+        return () => {
+            cancelled = true;
+        };
+    }, [client, tokenId, refetchKey]);
+    const refetch = () => setRefetchKey((k) => k + 1);
+    return { token, loading, error, refetch };
+}
+//# sourceMappingURL=useToken.js.map

package/dist/hooks/useToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToken.js","sourceRoot":"","sources":["../../src/hooks/useToken.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAcH,4BAsCC;AAlDD,iCAA4C;AAW5C,mDAAmD;AACnD,SAAgB,QAAQ,CAAC,MAAkB,EAAE,OAAe;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAuB,IAAI,CAAC,CAAC;IAC/D,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,UAAU;YACvB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjB,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,UAAU,EAAE,CAAC;QAElB,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,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @inkd/sdk — Inkd Protocol TypeScript SDK
+ * Permanent on-chain project registry on Base
+ */
+export { watchProjectCreated, watchVersionPushed, watchRegistryEvents, } from "./events.js";
+export type { ProjectCreatedEvent, VersionPushedEvent, Unwatch, ProjectCreatedFilter, VersionPushedFilter, } from "./events.js";
+export { batchGetProjects, batchGetVersions, batchGetFees, batchGetProjectsWithVersions, } from "./multicall.js";
+export type { ProjectData, VersionData, RegistryFees, BatchResult, } from "./multicall.js";
+import { type WalletClient, type Address, type Hash } from 'viem';
+export declare const ADDRESSES: {
+    mainnet: {
+        token: Address;
+        registry: Address;
+        treasury: Address;
+    };
+    testnet: {
+        token: Address;
+        registry: Address;
+        treasury: Address;
+    };
+};
+export interface InkdClientOptions {
+    walletClient: WalletClient;
+    network?: 'mainnet' | 'testnet';
+    rpcUrl?: string;
+}
+export declare class InkdClient {
+    private wallet;
+    private public;
+    private addrs;
+    constructor(opts: InkdClientOptions);
+    approveToken(amount?: bigint): Promise<Hash>;
+    tokenBalance(address?: Address): Promise<bigint>;
+    createProject(opts: {
+        name: string;
+        description: string;
+        license?: string;
+        readmeHash?: string;
+        isPublic?: boolean;
+        isAgent?: boolean;
+        agentEndpoint?: string;
+    }): Promise<Hash>;
+    pushVersion(projectId: bigint, opts: {
+        arweaveHash: string;
+        versionTag: string;
+        changelog?: string;
+    }): Promise<Hash>;
+    getProject(projectId: bigint): Promise<unknown>;
+    getVersions(projectId: bigint): Promise<unknown>;
+    getVersionFee(): Promise<bigint>;
+    transferProject(projectId: bigint, newOwner: Address): Promise<Hash>;
+    getAgentProjects(offset?: bigint, limit?: bigint): Promise<readonly bigint[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,OAAO,EACP,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEc,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAC9D,MAAM,MAAM,CAAA;AAkJb,eAAO,MAAM,SAAS;;eAEL,OAAO;kBACJ,OAAO;kBACP,OAAO;;;eAGV,OAAO;kBACJ,OAAO;kBACP,OAAO;;CAE1B,CAAA;AAID,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,YAAY,CAAA;IAC1B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAA0B;gBAE3B,IAAI,EAAE,iBAAiB;IAa7B,YAAY,CAAC,MAAM,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrD,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhD,aAAa,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBX,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QACzC,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcX,UAAU,CAAC,SAAS,EAAE,MAAM;IAS5B,WAAW,CAAC,SAAS,EAAE,MAAM;IAS7B,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQhC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpE,gBAAgB,CAAC,MAAM,SAAK,EAAE,KAAK,SAAO,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;CAQ9E"}

package/dist/index.js

@@ -0,0 +1,290 @@
+"use strict";
+/**
+ * @inkd/sdk — Inkd Protocol TypeScript SDK
+ * Permanent on-chain project registry on Base
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InkdClient = exports.ADDRESSES = exports.batchGetProjectsWithVersions = exports.batchGetFees = exports.batchGetVersions = exports.batchGetProjects = exports.watchRegistryEvents = exports.watchVersionPushed = exports.watchProjectCreated = void 0;
+// ─── Event Subscriptions ─────────────────────────────────────────────────────
+var events_js_1 = require("./events.js");
+Object.defineProperty(exports, "watchProjectCreated", { enumerable: true, get: function () { return events_js_1.watchProjectCreated; } });
+Object.defineProperty(exports, "watchVersionPushed", { enumerable: true, get: function () { return events_js_1.watchVersionPushed; } });
+Object.defineProperty(exports, "watchRegistryEvents", { enumerable: true, get: function () { return events_js_1.watchRegistryEvents; } });
+// ─── Batch Reads (Multicall3) ─────────────────────────────────────────────────
+var multicall_js_1 = require("./multicall.js");
+Object.defineProperty(exports, "batchGetProjects", { enumerable: true, get: function () { return multicall_js_1.batchGetProjects; } });
+Object.defineProperty(exports, "batchGetVersions", { enumerable: true, get: function () { return multicall_js_1.batchGetVersions; } });
+Object.defineProperty(exports, "batchGetFees", { enumerable: true, get: function () { return multicall_js_1.batchGetFees; } });
+Object.defineProperty(exports, "batchGetProjectsWithVersions", { enumerable: true, get: function () { return multicall_js_1.batchGetProjectsWithVersions; } });
+const viem_1 = require("viem");
+const chains_1 = require("viem/chains");
+// ─── ABIs (minimal) ──────────────────────────────────────────────────────────
+const REGISTRY_ABI = [
+    {
+        name: 'createProject',
+        type: 'function',
+        inputs: [
+            { name: 'name', type: 'string' },
+            { name: 'description', type: 'string' },
+            { name: 'license', type: 'string' },
+            { name: 'readmeHash', type: 'string' },
+            { name: 'agentEndpoint', type: 'string' },
+            { name: 'isAgent', type: 'bool' },
+            { name: 'isPublic', type: 'bool' },
+        ],
+        outputs: [{ name: 'projectId', type: 'uint256' }],
+    },
+    {
+        name: 'pushVersion',
+        type: 'function',
+        inputs: [
+            { name: 'projectId', type: 'uint256' },
+            { name: 'arweaveHash', type: 'string' },
+            { name: 'versionTag', type: 'string' },
+            { name: 'changelog', type: 'string' },
+        ],
+        outputs: [],
+    },
+    {
+        name: 'transferProject',
+        type: 'function',
+        inputs: [
+            { name: 'projectId', type: 'uint256' },
+            { name: 'newOwner', type: 'address' },
+        ],
+        outputs: [],
+    },
+    {
+        name: 'addCollaborator',
+        type: 'function',
+        inputs: [
+            { name: 'projectId', type: 'uint256' },
+            { name: 'collaborator', type: 'address' },
+        ],
+        outputs: [],
+    },
+    {
+        name: 'getProject',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'projectId', type: 'uint256' }],
+        outputs: [{
+                type: 'tuple',
+                components: [
+                    { name: 'id', type: 'uint256' },
+                    { name: 'name', type: 'string' },
+                    { name: 'description', type: 'string' },
+                    { name: 'license', type: 'string' },
+                    { name: 'readmeHash', type: 'string' },
+                    { name: 'agentEndpoint', type: 'string' },
+                    { name: 'owner', type: 'address' },
+                    { name: 'isAgent', type: 'bool' },
+                    { name: 'isPublic', type: 'bool' },
+                    { name: 'createdAt', type: 'uint256' },
+                    { name: 'versionCount', type: 'uint256' },
+                    { name: 'exists', type: 'bool' },
+                ]
+            }],
+    },
+    {
+        name: 'getVersions',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'projectId', type: 'uint256' }],
+        outputs: [{
+                type: 'tuple[]',
+                components: [
+                    { name: 'projectId', type: 'uint256' },
+                    { name: 'arweaveHash', type: 'string' },
+                    { name: 'versionTag', type: 'string' },
+                    { name: 'changelog', type: 'string' },
+                    { name: 'pushedBy', type: 'address' },
+                    { name: 'pushedAt', type: 'uint256' },
+                ]
+            }],
+    },
+    {
+        name: 'versionFee',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ type: 'uint256' }],
+    },
+    {
+        name: 'transferFee',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ type: 'uint256' }],
+    },
+    {
+        name: 'getAgentProjects',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'offset', type: 'uint256' },
+            { name: 'limit', type: 'uint256' },
+        ],
+        outputs: [{ type: 'uint256[]' }],
+    },
+];
+const TOKEN_ABI = [
+    {
+        name: 'approve',
+        type: 'function',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ type: 'bool' }],
+    },
+    {
+        name: 'allowance',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ],
+        outputs: [{ type: 'uint256' }],
+    },
+    {
+        name: 'balanceOf',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'account', type: 'address' }],
+        outputs: [{ type: 'uint256' }],
+    },
+];
+// ─── Contract Addresses ───────────────────────────────────────────────────────
+exports.ADDRESSES = {
+    mainnet: {
+        token: '', // TBD post-launch
+        registry: '',
+        treasury: '',
+    },
+    testnet: {
+        token: '', // TBD post-testnet deploy
+        registry: '',
+        treasury: '',
+    },
+};
+class InkdClient {
+    wallet;
+    public;
+    addrs;
+    constructor(opts) {
+        this.wallet = opts.walletClient;
+        const network = opts.network ?? 'testnet';
+        const chain = network === 'mainnet' ? chains_1.base : chains_1.baseSepolia;
+        this.addrs = exports.ADDRESSES[network];
+        this.public = (0, viem_1.createPublicClient)({
+            chain,
+            transport: (0, viem_1.http)(opts.rpcUrl),
+        });
+    }
+    // ─── Token Helpers ──────────────────────────────────────────────────────────
+    async approveToken(amount = (0, viem_1.parseEther)('1')) {
+        const [account] = await this.wallet.getAddresses();
+        return this.wallet.writeContract({
+            address: this.addrs.token,
+            abi: TOKEN_ABI,
+            functionName: 'approve',
+            args: [this.addrs.registry, amount],
+            account,
+            chain: this.wallet.chain,
+        });
+    }
+    async tokenBalance(address) {
+        const [account] = await this.wallet.getAddresses();
+        return this.public.readContract({
+            address: this.addrs.token,
+            abi: TOKEN_ABI,
+            functionName: 'balanceOf',
+            args: [address ?? account],
+        });
+    }
+    // ─── Projects ───────────────────────────────────────────────────────────────
+    async createProject(opts) {
+        const [account] = await this.wallet.getAddresses();
+        return this.wallet.writeContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'createProject',
+            args: [
+                opts.name,
+                opts.description,
+                opts.license ?? 'MIT',
+                opts.readmeHash ?? '',
+                opts.agentEndpoint ?? '',
+                opts.isAgent ?? false,
+                opts.isPublic ?? true,
+            ],
+            account,
+            chain: this.wallet.chain,
+        });
+    }
+    async pushVersion(projectId, opts) {
+        const [account] = await this.wallet.getAddresses();
+        const fee = await this.getVersionFee();
+        return this.wallet.writeContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'pushVersion',
+            args: [projectId, opts.arweaveHash, opts.versionTag, opts.changelog ?? ''],
+            account,
+            chain: this.wallet.chain,
+            value: fee,
+        });
+    }
+    async getProject(projectId) {
+        return this.public.readContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'getProject',
+            args: [projectId],
+        });
+    }
+    async getVersions(projectId) {
+        return this.public.readContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'getVersions',
+            args: [projectId],
+        });
+    }
+    async getVersionFee() {
+        return this.public.readContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'versionFee',
+        });
+    }
+    async transferProject(projectId, newOwner) {
+        const [account] = await this.wallet.getAddresses();
+        const fee = await this.public.readContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'transferFee',
+        });
+        return this.wallet.writeContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'transferProject',
+            args: [projectId, newOwner],
+            account,
+            chain: this.wallet.chain,
+            value: fee,
+        });
+    }
+    async getAgentProjects(offset = 0n, limit = 100n) {
+        return this.public.readContract({
+            address: this.addrs.registry,
+            abi: REGISTRY_ABI,
+            functionName: 'getAgentProjects',
+            args: [offset, limit],
+        });
+    }
+}
+exports.InkdClient = InkdClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/multicall.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @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);
+ * ```
+ */
+import type { PublicClient } from "viem";
+import type { Address } from "./ProjectRegistry.js";
+/** Decoded on-chain project data. Mirrors the InkdRegistry.Project struct. */
+export interface ProjectData {
+    id: bigint;
+    name: string;
+    description: string;
+    license: string;
+    readmeHash: string;
+    owner: Address;
+    isPublic: boolean;
+    isAgent: boolean;
+    agentEndpoint: string;
+    createdAt: bigint;
+    versionCount: bigint;
+    exists: boolean;
+}
+/** Decoded on-chain version data. Mirrors the InkdRegistry.Version struct. */
+export interface VersionData {
+    projectId: bigint;
+    arweaveHash: string;
+    versionTag: string;
+    changelog: string;
+    pushedBy: Address;
+    pushedAt: bigint;
+}
+/** Protocol fee snapshot fetched in a single multicall. */
+export interface RegistryFees {
+    /** Fee in wei required to push a new version. */
+    versionFee: bigint;
+    /** Fee in wei required to transfer project ownership. */
+    transferFee: bigint;
+    /** Amount of $INKD tokens locked per project on creation. */
+    tokenLockAmount: bigint;
+}
+/** Result wrapper for individual multicall calls that may fail. */
+export interface BatchResult<T> {
+    /** The decoded value, or null if the call reverted/failed. */
+    data: T | null;
+    /** True if the call succeeded. */
+    success: boolean;
+    /** Revert reason or error message, if the call failed. */
+    error?: string;
+}
+/**
+ * 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);
+ * }
+ * ```
+ */
+export declare function batchGetProjects(publicClient: PublicClient, registryAddress: Address, projectIds: bigint[]): Promise<BatchResult<ProjectData>[]>;
+/**
+ * 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.
+ */
+export declare function batchGetVersions(publicClient: PublicClient, registryAddress: Address, projectIds: bigint[]): Promise<BatchResult<VersionData[]>[]>;
+/**
+ * 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);
+ * ```
+ */
+export declare function batchGetFees(publicClient: PublicClient, registryAddress: Address): Promise<RegistryFees>;
+/**
+ * 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.
+ */
+export declare function batchGetProjectsWithVersions(publicClient: PublicClient, registryAddress: Address, projectIds: bigint[]): Promise<Array<{
+    project: BatchResult<ProjectData>;
+    versions: BatchResult<VersionData[]>;
+}>>;
+//# sourceMappingURL=multicall.d.ts.map

package/dist/multicall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multicall.d.ts","sourceRoot":"","sources":["../src/multicall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,8DAA8D;IAC9D,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC,CAqBrC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAqBvC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,GACvB,OAAO,CAAC,YAAY,CAAC,CAqCvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,OAAO,EACxB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,CAY7F"}