npm - @sage-protocol/sdk - Versions diffs - 0.1.2 → 0.1.7 - Mend

@sage-protocol/sdk 0.1.2 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/node/index.cjs CHANGED Viewed

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.1.2",
+      version: "0.1.4",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -50,10 +50,10 @@ var require_package = __commonJS({
       ],
       sideEffects: false,
       browser: {
+        child_process: false,
         fs: false,
-        path: false,
         os: false,
-        child_process: false
+        path: false
       },
       repository: {
         type: "git",
@@ -82,6 +82,18 @@ var require_package = __commonJS({
         sinon: "^17.0.1",
         tsup: "^8.1.0",
         typescript: "^5.4.0"
+      },
+      peerDependencies: {
+        react: "^18.0.0 || ^19.0.0",
+        swr: "^2.0.0"
+      },
+      peerDependenciesMeta: {
+        react: {
+          optional: true
+        },
+        swr: {
+          optional: true
+        }
       }
     };
   }
@@ -529,9 +541,9 @@ var require_subgraph = __commonJS({
        * Canonical proposal timeline. Tries common fields first, then event-style fallbacks.
        * Returns { id, createdAt, queuedAt, executedAt, canceledAt, eta, state } (numbers/strings may be null when unavailable).
        */
-      async getProposalTimeline({ url, id }) {
+      async getProposalTimeline({ url, id: id2 }) {
         if (!url) throw new Error("subgraph url required");
-        const pid = typeof id === "bigint" ? id.toString() : String(id);
+        const pid = typeof id2 === "bigint" ? id2.toString() : String(id2);
         try {
           const data = await query(url, `
         query($id: ID!) {
@@ -719,10 +731,10 @@ var require_subgraph = __commonJS({
           updatedAt: Number(p.updatedAt || 0)
         } : null;
       },
-      async getProposalById({ url, id }) {
+      async getProposalById({ url, id: id2 }) {
         if (!url) throw new Error("subgraph url required");
         const doc = `query($id: ID!){ proposal(id:$id){ id proposer description createdAt updatedAt state eta targets values calldatas } }`;
-        const data = await query(url, doc, { id: String(id) });
+        const data = await query(url, doc, { id: String(id2) });
         const p = data?.proposal;
         if (!p) return null;
         return {
@@ -770,7 +782,7 @@ var require_ipfs = __commonJS({
   "src/ipfs/index.js"(exports2, module2) {
     var axiosDefault = require("axios");
     var FormData = require("form-data");
-    var { ethers } = require("ethers");
+    var { ethers: ethers2 } = require("ethers");
     var DEFAULT_GATEWAY = "https://ipfs.dev.sageprotocol.io/ipfs";
     function toLowerSafe(value, fallback = "") {
       if (value == null) return fallback;
@@ -825,14 +837,14 @@ var require_ipfs = __commonJS({
       }
       return Array.from(urls);
     }
-    function ensureLeadingSlash(path, fallback = "") {
-      const value = path || fallback;
+    function ensureLeadingSlash(path2, fallback = "") {
+      const value = path2 || fallback;
       if (!value) return fallback;
       return value.startsWith("/") ? value : `/${value}`;
     }
     function generateDeterministicCid(payload) {
       const content = Buffer.isBuffer(payload) ? payload : typeof payload === "string" ? Buffer.from(payload) : Buffer.from(JSON.stringify(payload));
-      const hash = ethers.keccak256(content);
+      const hash = ethers2.keccak256(content);
       const hashStr = hash.slice(2);
       const cidSuffix = (hashStr + hashStr).slice(0, 44);
       return `Qm${cidSuffix}`;
@@ -904,7 +916,7 @@ var require_ipfs = __commonJS({
       }
       function workerUrl(kind, cid) {
         const base = workerBaseUrl();
-        const ensure = (path) => path.startsWith("/") ? path : `/${path}`;
+        const ensure = (path2) => path2.startsWith("/") ? path2 : `/${path2}`;
         if (base) {
           if (kind === "challenge") return `${base}${ensure(config.worker.challengePath || "/auth/challenge")}`;
           if (kind === "upload") return `${base}${ensure(config.worker.uploadPath || "/ipfs/upload")}`;
@@ -1226,18 +1238,18 @@ var require_ipfs = __commonJS({
         return postWorkerJson("discoveryEventsPath", "/discover/events", payload);
       }
       async function recordMcpUsageEvent({ promptId, metadata, address } = {}) {
-        const id = typeof promptId === "string" ? promptId.trim() : "";
-        if (!id) throw new Error("promptId required");
-        const payload = { promptId: id };
+        const id2 = typeof promptId === "string" ? promptId.trim() : "";
+        if (!id2) throw new Error("promptId required");
+        const payload = { promptId: id2 };
         if (metadata && typeof metadata === "object") payload.metadata = metadata;
         const actor = address || config.worker.address;
         if (actor) payload.address = actor;
         return postWorkerJson("discoveryMcpPath", "/discover/mcp", payload);
       }
       async function recordLaunchEvent({ promptId, metadata, address } = {}) {
-        const id = typeof promptId === "string" ? promptId.trim() : "";
-        if (!id) throw new Error("promptId required");
-        const payload = { promptId: id };
+        const id2 = typeof promptId === "string" ? promptId.trim() : "";
+        if (!id2) throw new Error("promptId required");
+        const payload = { promptId: id2 };
         if (metadata && typeof metadata === "object") payload.metadata = metadata;
         const actor = address || config.worker.address;
         if (actor) payload.address = actor;
@@ -1267,11 +1279,11 @@ var require_ipfs = __commonJS({
       }
       async function reviewGovernanceReport(payload = {}) {
         if (!payload || typeof payload !== "object") throw new Error("payload required");
-        const id = typeof payload.id === "string" ? payload.id.trim() : "";
-        if (!id) throw new Error("report id required");
+        const id2 = typeof payload.id === "string" ? payload.id.trim() : "";
+        if (!id2) throw new Error("report id required");
         const status = typeof payload.status === "string" ? payload.status.trim() : "";
         if (!status) throw new Error("status required");
-        const body = { id, status };
+        const body = { id: id2, status };
         if (typeof payload.note === "string") body.note = payload.note;
         if (typeof payload.action === "string") body.action = payload.action;
         return postWorkerJson("governanceReviewPath", "/governance/report/review", body);
@@ -1597,18 +1609,18 @@ var require_validation = __commonJS({
       } catch (_) {
       }
     }
-    function normaliseSchemaPaths(schemaPaths, { path }) {
+    function normaliseSchemaPaths(schemaPaths, { path: path2 }) {
       if (Array.isArray(schemaPaths) && schemaPaths.length) {
         return schemaPaths;
       }
       return [
-        path.join(process.cwd(), "docs", "schemas", "manifest.schema.json"),
-        path.join(__dirname, "..", "..", "docs", "schemas", "manifest.schema.json")
+        path2.join(process.cwd(), "docs", "schemas", "manifest.schema.json"),
+        path2.join(__dirname, "..", "..", "docs", "schemas", "manifest.schema.json")
       ];
     }
-    function safeJsonParse(fs, file) {
+    function safeJsonParse(fs2, file) {
       try {
-        const raw = fs.readFileSync(file, "utf8");
+        const raw = fs2.readFileSync(file, "utf8");
         return JSON.parse(raw);
       } catch (_) {
         return null;
@@ -1634,17 +1646,17 @@ var require_validation = __commonJS({
     }
     function createManifestValidator(options = {}) {
       const {
-        fs = fsDefault,
-        path = pathDefault,
+        fs: fs2 = fsDefault,
+        path: path2 = pathDefault,
         ajvFactory = defaultAjvFactory,
         addFormats = defaultAddFormats,
         schemaPaths
       } = options;
-      const searchPaths = normaliseSchemaPaths(schemaPaths, { path });
+      const searchPaths = normaliseSchemaPaths(schemaPaths, { path: path2 });
       function loadSchema() {
         for (const schemaPath of searchPaths) {
-          if (!fs.existsSync(schemaPath)) continue;
-          const schema = safeJsonParse(fs, schemaPath);
+          if (!fs2.existsSync(schemaPath)) continue;
+          const schema = safeJsonParse(fs2, schemaPath);
           if (schema) return { schema, schemaPath };
         }
         return { schema: null, schemaPath: null };
@@ -1717,7 +1729,7 @@ var require_validation = __commonJS({
         if (!manifestPath) {
           throw new Error("manifestPath required");
         }
-        const data = safeJsonParse(fs, manifestPath);
+        const data = safeJsonParse(fs2, manifestPath);
         if (!data) {
           return {
             ok: false,
@@ -1750,8 +1762,8 @@ var require_validation = __commonJS({
           seenKeys.add(key);
           const files = Array.isArray(prompt.files) ? prompt.files : [];
           for (const file of files) {
-            const resolved = path.isAbsolute(file) ? file : manifestPath ? path.join(path.dirname(manifestPath), file) : file;
-            if (!fs.existsSync(resolved)) {
+            const resolved = path2.isAbsolute(file) ? file : manifestPath ? path2.join(path2.dirname(manifestPath), file) : file;
+            if (!fs2.existsSync(resolved)) {
               issues.push({
                 type: "missing_file",
                 message: `File not found: ${file}`,
@@ -1774,7 +1786,7 @@ var require_validation = __commonJS({
       }
       function bestPracticeCheckFile(manifestPath, options2 = {}) {
         if (!manifestPath) throw new Error("manifestPath required");
-        const data = safeJsonParse(fs, manifestPath);
+        const data = safeJsonParse(fs2, manifestPath);
         if (!data) {
           return [{ type: "parse_error", message: `Failed to parse JSON at ${manifestPath}`, manifestPath }];
         }
@@ -1797,7 +1809,7 @@ var require_validation = __commonJS({
 // src/library/index.js
 var require_library = __commonJS({
   "src/library/index.js"(exports2, module2) {
-    var { Contract, getAddress, keccak256, toUtf8Bytes } = require("ethers");
+    var { Contract, getAddress, keccak256, toUtf8Bytes, AbiCoder } = require("ethers");
     var { Interface } = require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -1836,17 +1848,31 @@ var require_library = __commonJS({
         promptCount: Number(promptCount)
       };
     }
+    function _computeLibraryKey(subdao, libraryId) {
+      const coder = AbiCoder.defaultAbiCoder ? AbiCoder.defaultAbiCoder() : new AbiCoder();
+      const encoded = coder.encode(["address", "string"], [getAddress(subdao), String(libraryId)]);
+      return keccak256(encoded);
+    }
     async function getLatestLibrary({ provider, registry, subdao, libraryId = "main" }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normalise(registry, "registry");
       const sub = normalise(subdao, "subdao");
       const contract = new Contract(addr, ABI.LibraryRegistry, provider);
-      const key = keccak256(toUtf8Bytes(`${sub.toLowerCase()}::${libraryId}`));
+      const key = _computeLibraryKey(sub, libraryId);
       const latestCID = await contract.subdaoLibraryLatest(key).catch(() => "");
       if (!latestCID || latestCID.length === 0) return null;
       const info = await getManifestInfo({ provider, registry: addr, manifestCID: latestCID });
       return info;
     }
+    async function getBeforeAfterForUpdate({ provider, registry, subdao, libraryId = "main", newCid }) {
+      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
+      const addr = normalise(registry, "registry");
+      const sub = normalise(subdao, "subdao");
+      const contract = new Contract(addr, ABI.LibraryRegistry, provider);
+      const key = _computeLibraryKey(sub, libraryId);
+      const prev = await contract.subdaoLibraryLatest(key).catch(() => "");
+      return { previousCID: prev || null, newCID: String(newCid), libraryId: String(libraryId) };
+    }
     async function hasScopedOwnership({ provider, registry, subdao, manifestCID }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normalise(registry, "registry");
@@ -1872,6 +1898,8 @@ var require_library = __commonJS({
       getLatestLibrary,
       hasScopedOwnership,
       buildUpdateLibraryForSubDAOTx,
+      _computeLibraryKey,
+      getBeforeAfterForUpdate,
       /** Build an authorizeTimelock(timelock, subdao) call for a LibraryRegistry. */
       buildAuthorizeTimelockTx: function buildAuthorizeTimelockTx({ registry, timelock, subdao }) {
         const to = normalise(registry, "registry");
@@ -1958,11 +1986,11 @@ var require_governance = __commonJS({
         stakeAmount
       };
     }
-    async function getProposal({ provider, governor, id }) {
+    async function getProposal({ provider, governor, id: id2 }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normaliseGovernor(governor);
       const g = new Contract(addr, ABI.Governor, provider);
-      const pid = typeof id === "bigint" ? id : String(id).startsWith("0x") ? BigInt(id) : BigInt(String(id));
+      const pid = typeof id2 === "bigint" ? id2 : String(id2).startsWith("0x") ? BigInt(id2) : BigInt(String(id2));
       const [state, snapshot, deadline, votes] = await Promise.all([
         g.state(pid),
         g.proposalSnapshot(pid),
@@ -2016,12 +2044,12 @@ var require_governance = __commonJS({
       }
       return proposals;
     }
-    async function getProposalMetadata({ provider, governor, id, fromBlock = 0, toBlock = "latest" }) {
+    async function getProposalMetadata({ provider, governor, id: id2, fromBlock = 0, toBlock = "latest" }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normaliseGovernor(governor);
       const iface = new Interface([ABI.Events.ProposalCreated]);
       const topic = iface.getEvent("ProposalCreated").topicHash;
-      const pid = typeof id === "bigint" ? id : String(id).startsWith("0x") ? BigInt(id) : BigInt(String(id));
+      const pid = typeof id2 === "bigint" ? id2 : String(id2).startsWith("0x") ? BigInt(id2) : BigInt(String(id2));
       const logs = await provider.getLogs({ address: addr, fromBlock, toBlock, topics: [topic] });
       for (const log of logs) {
         try {
@@ -2082,10 +2110,10 @@ var require_governance = __commonJS({
     function buildCastVoteTx({ governor, proposalId, support, reason }) {
       const addr = normaliseGovernor(governor);
       const iface = new Interface(ABI.Governor);
-      const id = typeof proposalId === "bigint" ? proposalId : String(proposalId).startsWith("0x") ? BigInt(proposalId) : BigInt(String(proposalId));
+      const id2 = typeof proposalId === "bigint" ? proposalId : String(proposalId).startsWith("0x") ? BigInt(proposalId) : BigInt(String(proposalId));
       const s = Number(support);
       const hasReason = reason && String(reason).length > 0;
-      const data = hasReason ? iface.encodeFunctionData("castVoteWithReason(uint256,uint8,string)", [id, s, String(reason)]) : iface.encodeFunctionData("castVote(uint256,uint8)", [id, s]);
+      const data = hasReason ? iface.encodeFunctionData("castVoteWithReason(uint256,uint8,string)", [id2, s, String(reason)]) : iface.encodeFunctionData("castVote(uint256,uint8)", [id2, s]);
       return { to: addr, data, value: BigIntZero };
     }
     function cueTx(fn, { governor, targets = [], values = [], calldatas = [], descriptionOrHash = "" }) {
@@ -2106,17 +2134,73 @@ var require_governance = __commonJS({
     function buildQueueByIdTx({ governor, proposalId }) {
       const addr = normaliseGovernor(governor);
       const iface = new Interface(ABI.Governor);
-      const id = typeof proposalId === "bigint" ? proposalId : String(proposalId).startsWith("0x") ? BigInt(proposalId) : BigInt(String(proposalId));
-      const data = iface.encodeFunctionData("queue(uint256)", [id]);
+      const id2 = typeof proposalId === "bigint" ? proposalId : String(proposalId).startsWith("0x") ? BigInt(proposalId) : BigInt(String(proposalId));
+      const data = iface.encodeFunctionData("queue(uint256)", [id2]);
       return { to: addr, data, value: BigIntZero };
     }
     function buildExecuteByIdTx({ governor, proposalId }) {
       const addr = normaliseGovernor(governor);
       const iface = new Interface(ABI.Governor);
-      const id = typeof proposalId === "bigint" ? proposalId : String(proposalId).startsWith("0x") ? BigInt(proposalId) : BigInt(String(proposalId));
-      const data = iface.encodeFunctionData("execute(uint256)", [id]);
+      const id2 = typeof proposalId === "bigint" ? proposalId : String(proposalId).startsWith("0x") ? BigInt(proposalId) : BigInt(String(proposalId));
+      const data = iface.encodeFunctionData("execute(uint256)", [id2]);
       return { to: addr, data, value: BigIntZero };
     }
+    async function decodeProposalEffects({ provider, governor, proposalId, fromBlock = 0, toBlock = "latest" }) {
+      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
+      const govAddr = normaliseGovernor(governor);
+      const iface = new Interface([ABI.Events.ProposalCreated]);
+      const topic = iface.getEvent("ProposalCreated").topicHash;
+      const id2 = typeof proposalId === "bigint" ? proposalId : String(proposalId).startsWith("0x") ? BigInt(proposalId) : BigInt(String(proposalId));
+      let parsed = null;
+      let logTxHash = null;
+      const logs = await provider.getLogs({ address: govAddr, fromBlock, toBlock, topics: [topic] });
+      for (const log of logs) {
+        try {
+          const p = iface.parseLog(log);
+          if (BigInt(p.args.id.toString()) === id2) {
+            parsed = p;
+            logTxHash = log.transactionHash;
+            break;
+          }
+        } catch (_) {
+        }
+      }
+      if (!parsed) throw new Error("ProposalCreated event not found");
+      const targets = parsed.args.targets.map(getAddress);
+      const calldatas = parsed.args.calldatas.map((d) => typeof d === "string" ? d : "0x" + Buffer.from(d).toString("hex"));
+      const LibraryIface = new Interface(["function updateLibraryForSubDAO(address,string,string,uint256)", "function subdaoLibraryLatest(bytes32) view returns (string)"]);
+      const PromptIface = new Interface(["function updatePromptByGovernance(string,string)"]);
+      const coder = AbiCoder.defaultAbiCoder ? AbiCoder.defaultAbiCoder() : new AbiCoder();
+      const effects = [];
+      for (let i = 0; i < calldatas.length; i++) {
+        const data = calldatas[i];
+        const sel = data.slice(0, 10);
+        try {
+          const decoded = LibraryIface.decodeFunctionData("updateLibraryForSubDAO", data);
+          const [subdao, libraryId, newCid, promptCount] = decoded;
+          let previousCID = null;
+          try {
+            const reg = new Contract(targets[i], ["function subdaoLibraryLatest(bytes32) view returns (string)"], provider);
+            const key = keccak256(coder.encode(["address", "string"], [getAddress(subdao), String(libraryId)]));
+            const prev = await reg.subdaoLibraryLatest(key).catch(() => "");
+            previousCID = prev && prev.length ? String(prev) : null;
+          } catch (_) {
+          }
+          effects.push({ type: "libraryUpdate", index: i, target: targets[i], subdao: getAddress(subdao), libraryId: String(libraryId), previousCid: previousCID, newCid: String(newCid), promptCount: Number(promptCount) });
+          continue;
+        } catch (_) {
+        }
+        try {
+          const decodedP = PromptIface.decodeFunctionData("updatePromptByGovernance", data);
+          const [key, newCid] = decodedP;
+          effects.push({ type: "promptUpdate", index: i, target: targets[i], key: String(key), newCid: String(newCid) });
+          continue;
+        } catch (_) {
+        }
+        effects.push({ type: "unknown", index: i, target: targets[i], selector: sel });
+      }
+      return { governor: govAddr, proposalId: id2, tx: logTxHash, actions: { count: calldatas.length }, effects };
+    }
     async function getQuorumAt({ provider, governor, blockTag }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normaliseGovernor(governor);
@@ -2246,6 +2330,7 @@ var require_governance = __commonJS({
       buildExecuteTx,
       buildQueueByIdTx,
       buildExecuteByIdTx,
+      decodeProposalEffects,
       makeProposalDescription,
       stripProposalSalt,
       getQuorumAt,
@@ -2952,7 +3037,7 @@ var require_openzeppelin = __commonJS({
         for (const log of logs) {
           try {
             const parsed = iface.parseLog(log);
-            const id = BigInt(parsed.args.id.toString());
+            const id2 = BigInt(parsed.args.id.toString());
             const proposer = getAddress(parsed.args.proposer);
             const targets = parsed.args.targets.map(getAddress);
             const values = parsed.args.values.map((v) => BigInt(v.toString()));
@@ -2962,7 +3047,7 @@ var require_openzeppelin = __commonJS({
             const block = await provider.getBlock(log.blockNumber).catch(() => ({ timestamp: 0 }));
             const quorum = await governance.getQuorumAt({ provider, governor: addr, blockTag: BigInt(endBlock || log.blockNumber) }).catch(() => null);
             const signatures = await getSignatureList({ provider, targets, calldatas, abiResolver, selectorResolver, chainId: resolvedChainId });
-            items.push({ id, proposer, createdAt: Number(block.timestamp || 0), startBlock, endBlock, quorum, txHash: log.transactionHash, targets, values, calldatas, signatures });
+            items.push({ id: id2, proposer, createdAt: Number(block.timestamp || 0), startBlock, endBlock, quorum, txHash: log.transactionHash, targets, values, calldatas, signatures });
           } catch (_) {
           }
         }
@@ -2970,10 +3055,10 @@ var require_openzeppelin = __commonJS({
       }
       return { items, nextCursor: null };
     }
-    async function getTimelineOnchain({ provider, governor, id, fromBlock = 0, toBlock = "latest" }) {
+    async function getTimelineOnchain({ provider, governor, id: id2, fromBlock = 0, toBlock = "latest" }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normaliseGovernor(governor);
-      const pid = typeof id === "bigint" ? id : String(id).startsWith("0x") ? BigInt(id) : BigInt(String(id));
+      const pid = typeof id2 === "bigint" ? id2 : String(id2).startsWith("0x") ? BigInt(id2) : BigInt(String(id2));
       const iface = new Interface([Events.ProposalQueued, Events.ProposalExecuted, Events.ProposalCanceled]);
       const topics = [
         iface.getEvent("ProposalQueued").topicHash,
@@ -3206,9 +3291,9 @@ var require_operations = __commonJS({
         throw new SageSDKError(CODES.INVALID_ARGS, "invalid governor address", { cause: error });
       }
     }
-    function normaliseProposalId(id) {
-      if (typeof id === "bigint") return id;
-      const value = String(id);
+    function normaliseProposalId(id2) {
+      if (typeof id2 === "bigint") return id2;
+      const value = String(id2);
       try {
         return value.startsWith("0x") ? BigInt(value) : BigInt(value);
       } catch (error) {
@@ -3230,7 +3315,7 @@ var require_operations = __commonJS({
       if (!load || !save) return null;
       return { load, save };
     }
-    function normaliseTuple(governor, id, metadata) {
+    function normaliseTuple(governor, id2, metadata) {
       const targets = Array.isArray(metadata.targets) ? metadata.targets.map((t) => getAddress(t)) : [];
       let values = Array.isArray(metadata.values) ? metadata.values.map((v) => BigInt(v)) : new Array(targets.length).fill(BigIntZero);
       const calldatas = Array.isArray(metadata.calldatas) ? metadata.calldatas.map(String) : [];
@@ -3240,7 +3325,7 @@ var require_operations = __commonJS({
       const description = metadata.description || metadata.body || "";
       const descriptionHash = metadata.descriptionHash || (typeof metadata.hashDescription === "function" ? metadata.hashDescription(description) : keccak256(toUtf8Bytes(String(description || ""))));
       return {
-        id,
+        id: id2,
         governor,
         targets,
         values,
@@ -3265,10 +3350,10 @@ var require_operations = __commonJS({
     }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const govAddr = normaliseGovernor(governor);
-      const id = normaliseProposalId(proposalId);
+      const id2 = normaliseProposalId(proposalId);
       const cacheAdapter = wrapCache(cache);
       if (!refresh && cacheAdapter) {
-        const cached = await cacheAdapter.load(govAddr, id);
+        const cached = await cacheAdapter.load(govAddr, id2);
         if (cached) return cached;
       }
       if (helperAddress) {
@@ -3277,10 +3362,10 @@ var require_operations = __commonJS({
             "function getProposalTuple(uint256) view returns (address[] targets,uint256[] values,bytes[] calldatas,bytes32 descriptionHash,bool exists)"
           ];
           const helper = new Contract(helperAddress, helperAbi, provider);
-          const res = await helper.getProposalTuple(id);
+          const res = await helper.getProposalTuple(id2);
           if (res && res.exists) {
             const tuple2 = {
-              id,
+              id: id2,
               governor: normaliseGovernor(governor),
               targets: res.targets || [],
               values: (res.values || []).map((v) => BigInt(v)),
@@ -3289,7 +3374,7 @@ var require_operations = __commonJS({
               descriptionHash: res.descriptionHash || null,
               createdBlock: null
             };
-            if (cacheAdapter) await cacheAdapter.save(governor, id, tuple2);
+            if (cacheAdapter) await cacheAdapter.save(governor, id2, tuple2);
             return tuple2;
           }
         } catch (_) {
@@ -3297,7 +3382,7 @@ var require_operations = __commonJS({
       }
       let metadata = null;
       try {
-        metadata = await governance.getProposalMetadata({ provider, governor: govAddr, id });
+        metadata = await governance.getProposalMetadata({ provider, governor: govAddr, id: id2 });
       } catch (_) {
         metadata = null;
       }
@@ -3306,7 +3391,7 @@ var require_operations = __commonJS({
         try {
           const govAbi = new Interface(ABI.Governor);
           const govC = new Contract(govAddr, govAbi, provider);
-          const snapshot = hints.snapshot ?? await govC.proposalSnapshot(id).catch(() => null);
+          const snapshot = hints.snapshot ?? await govC.proposalSnapshot(id2).catch(() => null);
           const votingDelay = hints.votingDelay ?? await govC.votingDelay().catch(() => null);
           if (snapshot !== null && votingDelay !== null) {
             const approxCreation = Number(snapshot) - Number(votingDelay);
@@ -3329,9 +3414,9 @@ var require_operations = __commonJS({
                   try {
                     const parsed = govC.interface.parseLog(log);
                     const pid = normaliseProposalId(parsed.args.proposalId);
-                    if (pid === id) {
+                    if (pid === id2) {
                       metadata = {
-                        id,
+                        id: id2,
                         governor: govAddr,
                         targets: Array.from(parsed.args.targets || [], String),
                         values: Array.from(parsed.args.values || [], (v) => BigInt(v.toString())),
@@ -3356,7 +3441,7 @@ var require_operations = __commonJS({
           const page = await governance.listProposals({ provider, governor: govAddr, fromBlock, toBlock: "latest" });
           metadata = page.find((entry) => {
             try {
-              return normaliseProposalId(entry.id || entry.proposalId) === id;
+              return normaliseProposalId(entry.id || entry.proposalId) === id2;
             } catch (_) {
               return false;
             }
@@ -3366,9 +3451,9 @@ var require_operations = __commonJS({
       if (!metadata) {
         throw new SageSDKError(CODES.NOT_FOUND, "proposal tuple not found");
       }
-      const tuple = normaliseTuple(govAddr, id, metadata);
+      const tuple = normaliseTuple(govAddr, id2, metadata);
       if (cacheAdapter) {
-        await cacheAdapter.save(govAddr, id, tuple);
+        await cacheAdapter.save(govAddr, id2, tuple);
       }
       return tuple;
     }
@@ -3664,6 +3749,91 @@ var require_operations = __commonJS({
   }
 });
+// src/governance/grants.js
+var require_grants = __commonJS({
+  "src/governance/grants.js"(exports2, module2) {
+    var { Interface, getAddress, isAddress, parseUnits } = require("ethers");
+    var { SageSDKError, CODES } = require_errors();
+    function normalizeAddress(label, value) {
+      if (!value) throw new SageSDKError(CODES.INVALID_ARGS, `${label} required`);
+      if (!isAddress(value)) throw new SageSDKError(CODES.INVALID_ARGS, `${label} invalid`);
+      return getAddress(value);
+    }
+    async function buildGrantProposal({ provider = null, vault, token, recipient, amount, decimals = null, raw = false, description = null }) {
+      const vaultAddr = normalizeAddress("vault", vault);
+      const tokenAddr = normalizeAddress("token", token);
+      const rcptAddr = normalizeAddress("recipient", recipient);
+      if (amount == null) throw new SageSDKError(CODES.INVALID_ARGS, "amount required");
+      let resolvedDecimals = decimals != null ? Number(decimals) : null;
+      let symbol = null;
+      if (provider && resolvedDecimals == null) {
+        try {
+          const erc20 = new (require("ethers")).Contract(tokenAddr, ["function decimals() view returns (uint8)", "function symbol() view returns (string)"], provider);
+          resolvedDecimals = Number(await erc20.decimals());
+          symbol = await erc20.symbol().catch(() => null);
+        } catch (_) {
+        }
+      }
+      if (resolvedDecimals == null) resolvedDecimals = 18;
+      let amtWei;
+      if (raw) {
+        amtWei = BigInt(String(amount));
+      } else {
+        amtWei = parseUnits(String(amount), resolvedDecimals);
+      }
+      const iface = new Interface(["function withdraw(address token,uint256 amount,address recipient)"]);
+      const data = iface.encodeFunctionData("withdraw", [tokenAddr, amtWei, rcptAddr]);
+      const targets = [vaultAddr];
+      const values = [0n];
+      const calldatas = [data];
+      const desc = description && description.length ? description : `Grant ${String(amount)}${symbol ? " " + symbol : ""} to ${rcptAddr}`;
+      return { targets, values, calldatas, description: desc };
+    }
+    module2.exports = {
+      buildGrantProposal,
+      /**
+       * Build a batched proposal for multiple grants. Each item can specify its own vault
+       * or inherit from defaultVault. Decimals are resolved per-token when provider is present.
+       * items: Array<{ vault?, token, recipient, amount, decimals?, raw? }>
+       */
+      buildBatchGrantProposal: async function buildBatchGrantProposal({ provider = null, items = [], defaultVault = null, description = null }) {
+        if (!Array.isArray(items) || items.length === 0) {
+          throw new SageSDKError(CODES.INVALID_ARGS, "items required");
+        }
+        const targets = [];
+        const values = [];
+        const calldatas = [];
+        const iface = new Interface(["function withdraw(address token,uint256 amount,address recipient)"]);
+        for (const [i, it] of items.entries()) {
+          const vault = it.vault || defaultVault;
+          if (!vault) throw new SageSDKError(CODES.INVALID_ARGS, `item[${i}]: vault missing and no defaultVault provided`);
+          const vaultAddr = normalizeAddress("vault", vault);
+          const tokenAddr = normalizeAddress("token", it.token);
+          const rcptAddr = normalizeAddress("recipient", it.recipient);
+          let resolvedDecimals = it.decimals != null ? Number(it.decimals) : null;
+          if (provider && resolvedDecimals == null && !it.raw) {
+            try {
+              const erc20 = new (require("ethers")).Contract(tokenAddr, ["function decimals() view returns (uint8)"], provider);
+              resolvedDecimals = Number(await erc20.decimals());
+            } catch (_) {
+            }
+          }
+          if (resolvedDecimals == null) resolvedDecimals = 18;
+          let amtWei;
+          if (it.raw) amtWei = BigInt(String(it.amount));
+          else amtWei = parseUnits(String(it.amount), resolvedDecimals);
+          const data = iface.encodeFunctionData("withdraw", [tokenAddr, amtWei, rcptAddr]);
+          targets.push(vaultAddr);
+          values.push(0n);
+          calldatas.push(data);
+        }
+        const desc = description && description.length ? description : `Batch Grants: ${items.length} transfer(s)`;
+        return { targets, values, calldatas, description: desc };
+      }
+    };
+  }
+});
 // src/timelock/index.js
 var require_timelock = __commonJS({
   "src/timelock/index.js"(exports2, module2) {
@@ -3726,8 +3896,8 @@ var require_timelock = __commonJS({
       for (const log of logs) {
         try {
           const parsed = iface.parseLog(log);
-          const id = parsed.args.id;
-          const op = operations.get(id) || { id, scheduled: [], executed: [], cancelled: false };
+          const id2 = parsed.args.id;
+          const op = operations.get(id2) || { id: id2, scheduled: [], executed: [], cancelled: false };
           if (parsed.name === "CallScheduled") {
             op.scheduled.push({
               index: Number(parsed.args.index),
@@ -3749,7 +3919,7 @@ var require_timelock = __commonJS({
           } else if (parsed.name === "Cancelled") {
             op.cancelled = true;
           }
-          operations.set(id, op);
+          operations.set(id2, op);
         } catch (err) {
           continue;
         }
@@ -3772,10 +3942,10 @@ var require_timelock = __commonJS({
         ]);
         return { to, data: payload, value: 0n };
       },
-      buildCancelTx: ({ timelock, id }) => {
-        if (!id) throw new SageSDKError(CODES.INVALID_ARGS, "operation id required");
+      buildCancelTx: ({ timelock, id: id2 }) => {
+        if (!id2) throw new SageSDKError(CODES.INVALID_ARGS, "operation id required");
         const addr = normalise(timelock, "timelock");
-        const payload = TimelockInterface.encodeFunctionData("cancel", [id]);
+        const payload = TimelockInterface.encodeFunctionData("cancel", [id2]);
         return { to: addr, data: payload, value: 0n };
       },
       buildExecuteTx: ({ timelock, target, value = 0n, data = "0x", predecessor = "0x0000000000000000000000000000000000000000000000000000000000000000", salt = "0x0000000000000000000000000000000000000000000000000000000000000000" }) => {
@@ -3884,10 +4054,10 @@ var require_factory = __commonJS({
       const moduleContract = new Contract(templateAddr, ABI.TemplateModule, provider);
       const ids = await moduleContract.getActiveTemplates().catch(() => []);
       const templates = [];
-      for (const id of ids) {
-        const template = await moduleContract.getTemplateStruct(id);
+      for (const id2 of ids) {
+        const template = await moduleContract.getTemplateStruct(id2);
         templates.push({
-          id: Number(id),
+          id: Number(id2),
           name: template[0],
           description: template[1],
           accessModel: Number(template[2]),
@@ -4342,8 +4512,8 @@ var require_prompt = __commonJS({
         for (let i = 1; i <= upto; i++) ids.push(i);
       }
       const results = [];
-      for (const id of ids) {
-        const key = await contract.getPromptKey(id).catch(() => null);
+      for (const id2 of ids) {
+        const key = await contract.getPromptKey(id2).catch(() => null);
         if (!key) continue;
         results.push(await getPromptData({ provider, registry: addr, key }));
       }
@@ -4355,8 +4525,8 @@ var require_prompt = __commonJS({
       const contract = new Contract(addr, ABI.PromptRegistry, provider);
       const ids = await contract.getByTagPage(tagHash, BigInt(offset), BigInt(Math.min(Number(limit), 100)));
       const out = [];
-      for (const id of ids) {
-        const key = await contract.getPromptKey(id).catch(() => null);
+      for (const id2 of ids) {
+        const key = await contract.getPromptKey(id2).catch(() => null);
         if (!key) continue;
         out.push(await getPromptData({ provider, registry: addr, key }));
       }
@@ -4368,8 +4538,8 @@ var require_prompt = __commonJS({
       const contract = new Contract(addr, ABI.PromptRegistry, provider);
       const ids = await contract.getByCreatorPage(getAddress(creator), BigInt(offset), BigInt(Math.min(Number(limit), 100)));
       const out = [];
-      for (const id of ids) {
-        const key = await contract.getPromptKey(id).catch(() => null);
+      for (const id2 of ids) {
+        const key = await contract.getPromptKey(id2).catch(() => null);
         if (!key) continue;
         out.push(await getPromptData({ provider, registry: addr, key }));
       }
@@ -4381,8 +4551,8 @@ var require_prompt = __commonJS({
       const contract = new Contract(addr, ABI.PromptRegistry, provider);
       const ids = await contract.getByCategoryPage(Number(category), BigInt(offset), BigInt(Math.min(Number(limit), 100)));
       const out = [];
-      for (const id of ids) {
-        const key = await contract.getPromptKey(id).catch(() => null);
+      for (const id2 of ids) {
+        const key = await contract.getPromptKey(id2).catch(() => null);
         if (!key) continue;
         out.push(await getPromptData({ provider, registry: addr, key }));
       }
@@ -4472,9 +4642,9 @@ var require_ipns = __commonJS({
     function removeTrailingSlash(str) {
       return str ? str.replace(/\/$/, "") : str;
     }
-    function ensureLeadingSlash(path) {
-      if (!path) return "/";
-      return path.startsWith("/") ? path : `/${path}`;
+    function ensureLeadingSlash(path2) {
+      if (!path2) return "/";
+      return path2.startsWith("/") ? path2 : `/${path2}`;
     }
     function dedupe(list = []) {
       const seen = /* @__PURE__ */ new Set();
@@ -4569,10 +4739,10 @@ var require_ipns = __commonJS({
       }
       return null;
     }
-    async function fetchWithGateways(path, axiosInstance, gateways, { timeout, attempts = 3, baseDelay = 500, jitterMs = 250 } = {}) {
+    async function fetchWithGateways(path2, axiosInstance, gateways, { timeout, attempts = 3, baseDelay = 500, jitterMs = 250 } = {}) {
       const errors = [];
       const unique = dedupe(gateways);
-      const suffix = path.replace(/^\/+/, "");
+      const suffix = path2.replace(/^\/+/, "");
       for (let attempt = 0; attempt < attempts; attempt += 1) {
         const delayMs = attempt === 0 ? 0 : jitter(baseDelay * attempt, jitterMs);
         if (delayMs) await delay(delayMs);
@@ -4594,7 +4764,7 @@ var require_ipns = __commonJS({
           }
         }
       }
-      const failure = new Error(`Failed to fetch ${path} from gateways`);
+      const failure = new Error(`Failed to fetch ${path2} from gateways`);
       failure.attempts = errors;
       throw failure;
     }
@@ -5021,7 +5191,7 @@ var require_token = __commonJS({
 // src/personal/helpers.js
 var require_helpers = __commonJS({
   "src/personal/helpers.js"(exports2, module2) {
-    var { getAddress, ZeroAddress, id } = require("ethers");
+    var { getAddress, ZeroAddress, id: id2 } = require("ethers");
     function normaliseAddress(addr, label) {
       if (!addr) throw new Error(`[personal] missing ${label}`);
       const value = addr.toString();
@@ -5032,7 +5202,7 @@ var require_helpers = __commonJS({
       if (typeof key === "string" && key.startsWith("0x") && key.length === 66) {
         return key;
       }
-      return id(key);
+      return id2(key);
     }
     module2.exports = {
       normaliseAddress,
@@ -5061,8 +5231,8 @@ var require_receipt = __commonJS({
       const receiptAddress = normaliseAddress(receipt, "receipt");
       const holderAddress = normaliseAddress(holder, "holder");
       const contract = new Contract(receiptAddress, ABI.PersonalLicenseReceipt, provider);
-      const id = typeof receiptId === "bigint" ? receiptId : BigInt(receiptId);
-      const balance = await contract.balanceOf(holderAddress, id);
+      const id2 = typeof receiptId === "bigint" ? receiptId : BigInt(receiptId);
+      const balance = await contract.balanceOf(holderAddress, id2);
       return typeof balance === "bigint" ? balance : BigInt(balance.toString());
     }
     module2.exports = {
@@ -5441,12 +5611,12 @@ var require_treasury = __commonJS({
         idList = Array.from({ length: total - start }, (_, i) => start + i);
       }
       const withdrawals = [];
-      for (const id of idList) {
-        const entry = await contract.pendingWithdrawals(id).catch(() => null);
+      for (const id2 of idList) {
+        const entry = await contract.pendingWithdrawals(id2).catch(() => null);
         if (!entry || !entry.exists) continue;
         const [token, recipient, amount, value, requester, balanceBefore, recipientBalanceBefore, depositSnapshot, isLP, isEmergency] = entry;
         withdrawals.push({
-          id: Number(id),
+          id: Number(id2),
           token: token && token !== ZERO_ADDRESS ? getAddress(token) : null,
           recipient: recipient && recipient !== ZERO_ADDRESS ? getAddress(recipient) : null,
           amount: toBigInt(amount),
@@ -5621,17 +5791,17 @@ var require_treasury = __commonJS({
         id: parsed?.id != null ? Number(parsed.id) : null
       };
     }
-    async function confirmWithdrawal({ signer, treasury, id, waitMs }) {
+    async function confirmWithdrawal({ signer, treasury, id: id2, waitMs }) {
       const contract = createWriteContract({ signer, treasury });
-      const tx = await contract.confirmWithdrawal(Number(id));
+      const tx = await contract.confirmWithdrawal(Number(id2));
       const receipt = await waitForReceipt({ signer, tx, waitMs });
-      return { transaction: tx, receipt, id: Number(id) };
+      return { transaction: tx, receipt, id: Number(id2) };
     }
-    async function cancelWithdrawal({ signer, treasury, id, waitMs }) {
+    async function cancelWithdrawal({ signer, treasury, id: id2, waitMs }) {
       const contract = createWriteContract({ signer, treasury });
-      const tx = await contract.cancelWithdrawal(Number(id));
+      const tx = await contract.cancelWithdrawal(Number(id2));
       const receipt = await waitForReceipt({ signer, tx, waitMs });
-      return { transaction: tx, receipt, id: Number(id) };
+      return { transaction: tx, receipt, id: Number(id2) };
     }
     async function setPriceOverride({ signer, treasury, token, price, ttlSeconds, waitMs }) {
       const contract = createWriteContract({ signer, treasury });
@@ -5685,7 +5855,23 @@ var require_treasury = __commonJS({
       confirmWithdrawal,
       cancelWithdrawal,
       setPriceOverride,
-      clearPriceOverride
+      clearPriceOverride,
+      // TX builders for app usage
+      buildApproveTx: ({ token, spender, amount, decimals = 18 }) => {
+        if (!token || !spender) throw new SageSDKError(CODES.INVALID_ARGS, "token and spender required");
+        const iface = new Interface(["function approve(address,uint256)"]);
+        return { to: getAddress(token), data: iface.encodeFunctionData("approve", [getAddress(spender), BigInt(amount.toString ? amount.toString() : amount)]), value: 0n };
+      },
+      buildTransferTx: ({ token, to, amount, decimals = 18 }) => {
+        if (!token || !to) throw new SageSDKError(CODES.INVALID_ARGS, "token and to required");
+        const iface = new Interface(["function transfer(address,uint256)"]);
+        return { to: getAddress(token), data: iface.encodeFunctionData("transfer", [getAddress(to), BigInt(amount.toString ? amount.toString() : amount)]), value: 0n };
+      },
+      buildWrapEthTx: ({ weth, amountWei }) => {
+        if (!weth) throw new SageSDKError(CODES.INVALID_ARGS, "weth required");
+        const iface = new Interface(["function deposit() payable"]);
+        return { to: getAddress(weth), data: iface.encodeFunctionData("deposit", []), value: BigInt(amountWei.toString ? amountWei.toString() : amountWei) };
+      }
     };
   }
 });
@@ -5897,8 +6083,8 @@ var require_bounty = __commonJS({
         ["function approveBountyCompletion(uint256,string)"],
         signer
       );
-      const id = BigInt(bountyId);
-      const tx = await bountyContract.approveBountyCompletion(id, String(deliverable));
+      const id2 = BigInt(bountyId);
+      const tx = await bountyContract.approveBountyCompletion(id2, String(deliverable));
       return tx.wait();
     }
     async function proposeApproveWinner({
@@ -5916,14 +6102,14 @@ var require_bounty = __commonJS({
       const context = await subdao.getSubDAOInfo({ provider, subdao: subdaoAddress });
       const governor = normaliseAddress("governor", context.governor);
       const iface = new Interface(["function approveBountyCompletion(uint256,string)"]);
-      const id = BigInt(bountyId);
-      const data = iface.encodeFunctionData("approveBountyCompletion", [id, String(deliverable)]);
+      const id2 = BigInt(bountyId);
+      const data = iface.encodeFunctionData("approveBountyCompletion", [id2, String(deliverable)]);
       const proposalCall = governance.buildProposeTx({
         governor,
         targets: [bountySystemAddress],
         values: [0n],
         calldatas: [data],
-        description: `Approve bounty completion for id=${id}`
+        description: `Approve bounty completion for id=${id2}`
       });
       return { governor, proposalCall };
     }
@@ -5936,248 +6122,6 @@ var require_bounty = __commonJS({
   }
 });
-// src/bond/index.js
-var require_bond = __commonJS({
-  "src/bond/index.js"(exports2, module2) {
-    var {
-      Contract,
-      Interface,
-      MaxUint256,
-      WeiPerEther,
-      formatUnits,
-      getAddress,
-      parseUnits
-    } = require("ethers");
-    var ABI = require_abi();
-    var { SageSDKError, CODES } = require_errors();
-    function normalise(address, label) {
-      if (!address) throw new SageSDKError(CODES.INVALID_ARGS, `${label} required`);
-      try {
-        return getAddress(address);
-      } catch (err) {
-        throw new SageSDKError(CODES.INVALID_ARGS, `invalid ${label}`, { cause: err });
-      }
-    }
-    var ERC20 = [
-      "function decimals() view returns (uint8)",
-      "function allowance(address owner, address spender) view returns (uint256)",
-      "function approve(address spender, uint256 value) returns (bool)",
-      "function balanceOf(address) view returns (uint256)"
-    ];
-    var BondInterface = new Interface(ABI.BondDepository);
-    async function getInfo({ provider, bond }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const addr = normalise(bond, "bond");
-      const c = new Contract(addr, ABI.BondDepository, provider);
-      const [terms, price, priceUsd, totalDebt, payoutToken, principalToken, treasury] = await Promise.all([
-        c.terms(),
-        c.bondPrice(),
-        c.bondPriceInUSD().catch(() => 0n),
-        // totalDebt is keyed by payout token in this implementation
-        c.payoutToken().then((pt) => c.totalDebt(pt)).catch(() => 0n),
-        c.payoutToken(),
-        c.principalToken(),
-        c.treasury()
-      ]);
-      return {
-        bond: addr,
-        payoutToken,
-        principalToken,
-        treasury,
-        terms: {
-          controlVariable: BigInt(terms.controlVariable?.toString?.() || terms[0]?.toString?.() || "0"),
-          minimumPrice: BigInt(terms.minimumPrice?.toString?.() || terms[1]?.toString?.() || "0"),
-          maxPayoutBps: BigInt(terms.maxPayout?.toString?.() || terms[2]?.toString?.() || "0"),
-          maxDebt: BigInt(terms.maxDebt?.toString?.() || terms[3]?.toString?.() || "0"),
-          vestingTerm: BigInt(terms.vestingTerm?.toString?.() || terms[4]?.toString?.() || "0"),
-          feeBps: BigInt(terms.fee?.toString?.() || terms[5]?.toString?.() || "0")
-        },
-        price: BigInt(price.toString()),
-        priceUSD: BigInt(priceUsd.toString()),
-        totalDebt: BigInt(totalDebt.toString())
-      };
-    }
-    async function getPrice({ provider, bond }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const c = new Contract(normalise(bond, "bond"), ABI.BondDepository, provider);
-      return c.bondPrice();
-    }
-    async function getUserStatus({ provider, bond, user }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const addr = normalise(bond, "bond");
-      const who = normalise(user, "user");
-      const c = new Contract(addr, ABI.BondDepository, provider);
-      const [info, pending, vested] = await Promise.all([
-        c.bondInfo(who),
-        c.pendingPayout(who),
-        c.percentVestedFor(who).catch(() => 0n)
-      ]);
-      return {
-        address: who,
-        bond: addr,
-        payoutRemaining: BigInt(info?.payout?.toString?.() || info[0]?.toString?.() || "0"),
-        vestingBlocks: BigInt(info?.vesting?.toString?.() || info[1]?.toString?.() || "0"),
-        lastInteractionBlock: BigInt(info?.lastBlock?.toString?.() || info[2]?.toString?.() || "0"),
-        pricePaid: BigInt(info?.pricePaid?.toString?.() || info[3]?.toString?.() || "0"),
-        pendingPayout: BigInt(pending.toString()),
-        percentVestedBps: BigInt(vested.toString())
-      };
-    }
-    function buildDepositTx({ bond, amount, maxPrice }) {
-      const to = normalise(bond, "bond");
-      const iface = new Interface(ABI.BondDepository);
-      const data = iface.encodeFunctionData("deposit", [
-        BigInt(amount ?? 0n),
-        // principal amount in token units
-        BigInt(maxPrice ?? 0n)
-        // scaled by 1e18
-      ]);
-      return { to, data, value: 0n };
-    }
-    function buildRedeemTx({ bond, recipient, stake = false }) {
-      const to = normalise(bond, "bond");
-      const iface = new Interface(ABI.BondDepository);
-      const data = iface.encodeFunctionData("redeem", [normalise(recipient, "recipient"), !!stake]);
-      return { to, data, value: 0n };
-    }
-    async function getTokenDecimals({ provider, token }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const c = new Contract(normalise(token, "token"), ERC20, provider);
-      const d = await c.decimals().catch(() => 18);
-      return Number(d);
-    }
-    async function getPrincipalAndPayout({ provider, bond }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const c = new Contract(normalise(bond, "bond"), ABI.BondDepository, provider);
-      const [payoutToken, principalToken] = await Promise.all([
-        c.payoutToken(),
-        c.principalToken()
-      ]);
-      return { payoutToken, principalToken };
-    }
-    async function estimatePayout({ provider, bond, amount, principalDecimals, payoutDecimals }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      if (amount == null) throw new SageSDKError(CODES.INVALID_ARGS, "amount required");
-      const { principalToken, payoutToken } = await getPrincipalAndPayout({ provider, bond });
-      const principalDec = principalDecimals ?? await getTokenDecimals({ provider, token: principalToken });
-      const payoutDec = payoutDecimals ?? await getTokenDecimals({ provider, token: payoutToken });
-      const amountUnits = parseUnits(String(amount), principalDec);
-      const price = await getPrice({ provider, bond });
-      if (price === 0n) {
-        throw new SageSDKError(CODES.RPC_ERROR, "bond price returned zero");
-      }
-      const payoutUnits = amountUnits * WeiPerEther / price;
-      return {
-        inputAmount: String(amount),
-        expectedPayout: formatUnits(payoutUnits, payoutDec),
-        bondPrice: formatUnits(price, 18),
-        principalToken,
-        payoutToken,
-        principalDecimals: principalDec,
-        payoutDecimals: payoutDec
-      };
-    }
-    async function ensurePrincipalAllowance({ signer, bond, amount, principalToken }) {
-      if (!signer) throw new SageSDKError(CODES.INVALID_ARGS, "signer required");
-      const owner = await signer.getAddress();
-      const provider = signer.provider;
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "signer requires provider");
-      const bondAddress = normalise(bond, "bond");
-      const tokenAddress = principalToken ? normalise(principalToken, "principalToken") : (await getPrincipalAndPayout({ provider, bond: bondAddress })).principalToken;
-      const principal = new Contract(tokenAddress, ERC20, signer);
-      const allowance = await principal.allowance(owner, bondAddress);
-      if (allowance >= amount) {
-        return { approved: false, transactionHash: null };
-      }
-      const approvalTx = await principal.approve(bondAddress, MaxUint256);
-      const receipt = await approvalTx.wait();
-      return {
-        approved: true,
-        transactionHash: receipt.hash ?? approvalTx.hash ?? null
-      };
-    }
-    async function purchase({ signer, bond, amount, maxPrice }) {
-      if (!signer) throw new SageSDKError(CODES.INVALID_ARGS, "signer required");
-      if (amount == null) throw new SageSDKError(CODES.INVALID_ARGS, "amount required");
-      if (maxPrice == null) throw new SageSDKError(CODES.INVALID_ARGS, "maxPrice required");
-      const provider = signer.provider;
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "signer requires provider");
-      const bondAddress = normalise(bond, "bond");
-      const bondContract = new Contract(bondAddress, ABI.BondDepository, signer);
-      const { principalToken, payoutToken } = await getPrincipalAndPayout({ provider, bond: bondAddress });
-      const principalDec = await getTokenDecimals({ provider, token: principalToken });
-      const payoutDec = await getTokenDecimals({ provider, token: payoutToken });
-      const amountUnits = parseUnits(String(amount), principalDec);
-      const maxPriceUnits = parseUnits(String(maxPrice), 18);
-      const currentPrice = await getPrice({ provider, bond: bondAddress });
-      if (currentPrice > maxPriceUnits) {
-        throw new SageSDKError(CODES.INVALID_ARGS, "current bond price exceeds max price", {
-          currentPrice: formatUnits(currentPrice, 18),
-          maxPrice: String(maxPrice)
-        });
-      }
-      await ensurePrincipalAllowance({ signer, bond: bondAddress, amount: amountUnits, principalToken });
-      const tx = await bondContract.deposit(amountUnits, maxPriceUnits);
-      const receipt = await tx.wait();
-      let depositEvent = null;
-      for (const log of receipt.logs || []) {
-        try {
-          const parsed = BondInterface.parseLog(log);
-          if (parsed?.name === "BondCreated") {
-            depositEvent = parsed.args;
-            break;
-          }
-        } catch (_) {
-        }
-      }
-      return {
-        transactionHash: receipt.hash ?? tx.hash ?? null,
-        deposit: formatUnits(depositEvent?.deposit ?? amountUnits, principalDec),
-        payout: depositEvent?.payout != null ? formatUnits(depositEvent.payout, payoutDec) : null,
-        expires: depositEvent?.expires ?? null,
-        price: formatUnits(currentPrice, 18)
-      };
-    }
-    async function redeem({ signer, bond, recipient, stake = false }) {
-      if (!signer) throw new SageSDKError(CODES.INVALID_ARGS, "signer required");
-      const provider = signer.provider;
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "signer requires provider");
-      const bondAddress = normalise(bond, "bond");
-      const user = normalise(recipient || await signer.getAddress(), "recipient");
-      const bondContract = new Contract(bondAddress, ABI.BondDepository, signer);
-      const { payoutToken } = await getPrincipalAndPayout({ provider, bond: bondAddress });
-      const payoutDec = await getTokenDecimals({ provider, token: payoutToken });
-      const pending = await bondContract.pendingPayout(user);
-      if (pending === 0n) {
-        return {
-          transactionHash: null,
-          redeemed: "0",
-          message: "No bonds available for redemption"
-        };
-      }
-      const tx = await bondContract.redeem(user, !!stake);
-      const receipt = await tx.wait();
-      return {
-        transactionHash: receipt.hash ?? tx.hash ?? null,
-        redeemed: formatUnits(pending, payoutDec)
-      };
-    }
-    module2.exports = {
-      getInfo,
-      getPrice,
-      getUserStatus,
-      buildDepositTx,
-      buildRedeemTx,
-      getTokenDecimals,
-      getPrincipalAndPayout,
-      estimatePayout,
-      ensurePrincipalAllowance,
-      purchase,
-      redeem
-    };
-  }
-});
 // src/utils/provider.js
 var require_provider = __commonJS({
   "src/utils/provider.js"(exports2, module2) {
@@ -6201,7 +6145,7 @@ var require_provider = __commonJS({
 // src/wallet/index.js
 var require_wallet = __commonJS({
   "src/wallet/index.js"(exports2, module2) {
-    var { ethers } = require("ethers");
+    var { ethers: ethers2 } = require("ethers");
     var { SageSDKError, CODES } = require_errors();
     var { getProvider } = require_provider();
     function isBrowser() {
@@ -6228,7 +6172,7 @@ var require_wallet = __commonJS({
           const rpcUrl = src.rpcUrl || getDefaultRpc();
           const provider = getProvider({ rpcUrl });
           const pk = src.privateKey.startsWith("0x") ? src.privateKey : "0x" + src.privateKey;
-          const signer = new ethers.Wallet(pk, provider);
+          const signer = new ethers2.Wallet(pk, provider);
           return { signer, provider };
         }
         case "pkEnv": {
@@ -6237,7 +6181,7 @@ var require_wallet = __commonJS({
           if (!pk) throw new SageSDKError(CODES.INVALID_ARGS, `${envName} not set`);
           const rpcUrl = src.rpcUrl || getDefaultRpc();
           const provider = getProvider({ rpcUrl });
-          const signer = new ethers.Wallet(pk.startsWith("0x") ? pk : "0x" + pk, provider);
+          const signer = new ethers2.Wallet(pk.startsWith("0x") ? pk : "0x" + pk, provider);
           return { signer, provider };
         }
         case "rpc": {
@@ -6248,7 +6192,7 @@ var require_wallet = __commonJS({
         case "injected": {
           if (!isBrowser()) throw new SageSDKError(CODES.MISSING_DEPENDENCY, "Injected provider only available in browser");
           try {
-            const provider = new ethers.BrowserProvider(window.ethereum);
+            const provider = new ethers2.BrowserProvider(window.ethereum);
             const signer = await provider.getSigner();
             return { signer, provider };
           } catch (e) {
@@ -6276,7 +6220,7 @@ var require_wallet = __commonJS({
       return process.env.RPC_URL || process.env.BASE_SEPOLIA_RPC_URL || process.env.BASE_SEPOLIA_RPC || "https://base-sepolia.publicnode.com";
     }
     function create() {
-      const wallet = ethers.Wallet.createRandom();
+      const wallet = ethers2.Wallet.createRandom();
       return {
         address: wallet.address,
         // Intentionally do not expose privateKey by default to avoid accidental leaks
@@ -6289,7 +6233,7 @@ var require_wallet = __commonJS({
         throw new SageSDKError(CODES.INVALID_ARGS, "secret required to import wallet");
       }
       const pk = secret.startsWith("0x") ? secret : "0x" + secret;
-      const wallet = new ethers.Wallet(pk);
+      const wallet = new ethers2.Wallet(pk);
       return { address: wallet.address, _wallet: wallet };
     }
     function exportWallet(w) {
@@ -6324,7 +6268,7 @@ var require_wallet = __commonJS({
         } catch (_) {
           if (!opts || !opts.mnemonic || !opts.rpcUrl) throw new SageSDKError(CODES.INVALID_ARGS, "mnemonic and rpcUrl required");
           const provider = getProvider({ rpcUrl: opts.rpcUrl });
-          const wallet = ethers.HDNodeWallet.fromPhrase(opts.mnemonic, opts.path);
+          const wallet = ethers2.HDNodeWallet.fromPhrase(opts.mnemonic, opts.path);
           const signer = wallet.connect(provider);
           return { signer, provider };
         }
@@ -6336,7 +6280,7 @@ var require_wallet = __commonJS({
         } catch (_) {
           if (!opts || !opts.json || !opts.password || !opts.rpcUrl) throw new SageSDKError(CODES.INVALID_ARGS, "json, password, rpcUrl required");
           const provider = getProvider({ rpcUrl: opts.rpcUrl });
-          const signer = await ethers.Wallet.fromEncryptedJson(opts.json, opts.password);
+          const signer = await ethers2.Wallet.fromEncryptedJson(opts.json, opts.password);
           return { signer: signer.connect(provider), provider };
         }
       },
@@ -6421,7 +6365,7 @@ var require_session = __commonJS({
 // src/wallet/cast-manager.js
 var require_cast_manager = __commonJS({
-  "src/wallet/cast-manager.js"(exports2, module2) {
+  "src/wallet/cast-manager.js"(exports, module) {
     var { spawn } = require("child_process");
     var { ethers } = require("ethers");
     var fs = require("fs");
@@ -6438,6 +6382,32 @@ var require_cast_manager = __commonJS({
       blue: (text) => `\x1B[34m${text}\x1B[0m`,
       cyan: (text) => `\x1B[36m${text}\x1B[0m`
     };
+    function optionalRequire(id) {
+      try {
+        const req = typeof __non_webpack_require__ === "function" ? __non_webpack_require__ : eval("require");
+        return req(id);
+      } catch (_) {
+        return null;
+      }
+    }
+    function loadConfigBridge() {
+      const shared = optionalRequire("@sage-protocol/shared");
+      if (shared) {
+        if (shared.ConfigManager) return shared.ConfigManager;
+        if (typeof shared.getProjectDir === "function" || typeof shared.readProfiles === "function") {
+          return shared;
+        }
+      }
+      const local = optionalRequire("./config");
+      if (local) {
+        if (local.ConfigManager) return local.ConfigManager;
+        return local;
+      }
+      return {
+        getProjectDir: () => process.cwd(),
+        readProfiles: () => ({ profiles: {}, activeProfile: "default" })
+      };
+    }
     var CastSigner = class extends ethers.VoidSigner {
       constructor(address, provider, castWalletManager) {
         super(address, provider);
@@ -6572,13 +6542,8 @@ var require_cast_manager = __commonJS({
         if (!address) return;
         try {
           const normalized = ethers.getAddress(address);
-          let cfgModule;
-          try {
-            ({ ConfigManager: cfgModule } = require("@sage-protocol/shared"));
-          } catch (_) {
-            cfgModule = require("./config");
-          }
-          const projectDir = cfgModule.getProjectDir ? cfgModule.getProjectDir() : process.cwd();
+          const cfgModule = loadConfigBridge();
+          const projectDir = typeof cfgModule.getProjectDir === "function" ? cfgModule.getProjectDir() : process.cwd();
           const cfgPath = path.join(projectDir, ".sage", "config.json");
           const current = fs.existsSync(cfgPath) ? JSON.parse(fs.readFileSync(cfgPath, "utf8") || "{}") : {};
           const active = current.activeProfile || "default";
@@ -6664,14 +6629,9 @@ var require_cast_manager = __commonJS({
           console.log(colors.blue("\u{1F517} Connecting wallet using Cast keystore..."));
           this.ensureKeystoreDir();
           try {
-            let cliConfig;
-            try {
-              ({ ConfigManager: cliConfig } = require("@sage-protocol/shared"));
-            } catch (_) {
-              cliConfig = require("./config");
-            }
-            const profiles = cliConfig.readProfiles();
-            const active = profiles.activeProfile || "default";
+            const cliConfig = loadConfigBridge();
+            const profiles = typeof cliConfig.readProfiles === "function" ? cliConfig.readProfiles() : { profiles: {}, activeProfile: "default" };
+            const active = profiles?.activeProfile || "default";
             const wanted = profiles?.profiles?.[active]?.wallet?.defaultAccount;
             if (wanted && this.keystoreDir && fs.existsSync(this.keystoreDir)) {
               const files = fs.readdirSync(this.keystoreDir);
@@ -6707,7 +6667,7 @@ var require_cast_manager = __commonJS({
             this.ensureAccountSynced(walletData.address, walletData.keystorePath, { silent: true });
           }
           try {
-            const { checkRpcHealth } = require("./utils/rpc-health");
+            const { checkRpcHealth } = optionalRequire("./utils/rpc-health") || {};
             const candidates = [
               this.rpcUrl,
               process.env.BASE_SEPOLIA_RPC,
@@ -7663,16 +7623,16 @@ ${error}` : ""}`;
         return fullPath;
       }
     };
-    module2.exports = CastWalletManager;
+    module.exports = CastWalletManager;
   }
 });
 // src/wallet/cdp-manager.js
 var require_cdp_manager = __commonJS({
   "src/wallet/cdp-manager.js"(exports2, module2) {
-    var fs = require("fs");
-    var path = require("path");
-    var { ethers } = require("ethers");
+    var fs2 = require("fs");
+    var path2 = require("path");
+    var { ethers: ethers2 } = require("ethers");
     var MinimalCdpSigner = class {
       constructor(manager, provider) {
         this._mgr = manager;
@@ -7701,7 +7661,7 @@ var require_cdp_manager = __commonJS({
         this.provider = null;
         this.signer = null;
         this.connected = false;
-        this._profilePath = path.join(process.cwd(), ".cdp-wallet.json");
+        this._profilePath = path2.join(process.cwd(), ".cdp-wallet.json");
         this._client = null;
         this._userId = null;
         this._walletId = null;
@@ -7724,9 +7684,9 @@ var require_cdp_manager = __commonJS({
         }
       }
       _loadProfile() {
-        if (fs.existsSync(this._profilePath)) {
+        if (fs2.existsSync(this._profilePath)) {
           try {
-            const x = JSON.parse(fs.readFileSync(this._profilePath, "utf8"));
+            const x = JSON.parse(fs2.readFileSync(this._profilePath, "utf8"));
             this._userId = x.userId || null;
             this._walletId = x.walletId || null;
             this.account = x.address || null;
@@ -7736,14 +7696,14 @@ var require_cdp_manager = __commonJS({
       }
       _saveProfile() {
         const payload = { userId: this._userId, walletId: this._walletId, address: this.account };
-        fs.writeFileSync(this._profilePath, JSON.stringify(payload, null, 2));
+        fs2.writeFileSync(this._profilePath, JSON.stringify(payload, null, 2));
       }
       async connect() {
         if (!process.env.CDP_API_KEY_ID || !process.env.CDP_API_KEY_SECRET) {
           throw new Error("Missing CDP_API_KEY_ID/CDP_API_KEY_SECRET in env");
         }
         const rpc = process.env.RPC_URL || "https://base-sepolia.publicnode.com";
-        this.provider = new ethers.JsonRpcProvider(rpc);
+        this.provider = new ethers2.JsonRpcProvider(rpc);
         this._loadProfile();
         let client;
         try {
@@ -7755,7 +7715,7 @@ var require_cdp_manager = __commonJS({
           const email = process.env.CDP_USER_EMAIL || await this._promptEmail();
           const fakeUserId = `user_${Buffer.from(email).toString("hex").slice(0, 8)}`;
           const fakeWalletId = `w_${Date.now()}`;
-          const fakeAddress = this.account || ethers.Wallet.createRandom().address;
+          const fakeAddress = this.account || ethers2.Wallet.createRandom().address;
           this._userId = fakeUserId;
           this._walletId = fakeWalletId;
           this.account = fakeAddress;
@@ -7769,7 +7729,7 @@ var require_cdp_manager = __commonJS({
           console.log("\u{1F4CD} Address:", this.account);
           try {
             const bal = await this.getBalance();
-            console.log("\u{1F4B0} Balance:", ethers.formatEther(bal), "ETH");
+            console.log("\u{1F4B0} Balance:", ethers2.formatEther(bal), "ETH");
           } catch (_) {
           }
         }
@@ -7794,7 +7754,7 @@ var require_cdp_manager = __commonJS({
         if (!process.env.SAGE_QUIET_JSON) {
           console.log("\u{1F4DD} Transaction Details:");
           console.log("To:", to);
-          console.log("Value:", ethers.formatEther(value));
+          console.log("Value:", ethers2.formatEther(value));
           console.log("Data:", data);
           console.log("\u{1F4E8} Check your email/app to approve the transaction...");
         }
@@ -7846,7 +7806,7 @@ var require_cdp_manager = __commonJS({
 // src/wallet/typed.js
 var require_typed = __commonJS({
   "src/wallet/typed.js"(exports2, module2) {
-    var { ethers } = require("ethers");
+    var { ethers: ethers2 } = require("ethers");
     function buildGovernorDomain({ name, chainId, verifyingContract }) {
       if (!name || !chainId || !verifyingContract) throw new Error("name, chainId, verifyingContract required");
       return { name, version: "1", chainId: Number(chainId), verifyingContract };
@@ -7963,12 +7923,40 @@ var require_doppler = __commonJS({
       }
       return { auctionAddress, note: "Lens API not available in this doppler-sdk version" };
     }
+    async function listAuctions(sdk, { limit = 10, cursor } = {}) {
+      const lens = sdk.lens;
+      if (lens) {
+        if (typeof lens.listAuctions === "function") {
+          try {
+            return await lens.listAuctions({ limit, cursor });
+          } catch (e) {
+          }
+        }
+        if (typeof lens.getAuctions === "function") {
+          try {
+            return await lens.getAuctions({ limit, cursor });
+          } catch (e) {
+          }
+        }
+      }
+      const fac = sdk.factory;
+      if (fac && typeof fac.listAuctions === "function") {
+        try {
+          return await fac.listAuctions({ limit, cursor });
+        } catch (e) {
+        }
+      }
+      return { ok: false, error: "LIST_UNSUPPORTED", message: "Listing auctions not supported by this doppler-sdk version" };
+    }
     async function buyTokens(sdk, { auctionAddress, numeraireAmount }) {
       const trade = sdk.trade || sdk.swap || sdk.auction;
       if (trade && typeof trade.buy === "function") {
-        return await trade.buy({ auctionAddress, numeraireAmount });
+        try {
+          return await trade.buy({ auctionAddress, numeraireAmount });
+        } catch (e) {
+        }
       }
-      throw new Error("Buy is not supported by the current doppler-sdk version");
+      return { ok: false, error: "BUY_UNSUPPORTED", message: "Buy not supported by this doppler-sdk version. Use executeV3BuyExactIn/urExecute helpers or upgrade doppler-sdk." };
     }
     async function migrate(sdk, asset) {
       if (sdk.airlock && typeof sdk.airlock.migrate === "function") {
@@ -7980,6 +7968,7 @@ var require_doppler = __commonJS({
       initDoppler,
       deployDynamicAuction,
       getAuctionStatus,
+      listAuctions,
       buyTokens,
       migrate
     };
@@ -8134,6 +8123,952 @@ var require_doppler = __commonJS({
   }
 });
+// src/services/utils/cache.js
+var require_cache = __commonJS({
+  "src/services/utils/cache.js"(exports2, module2) {
+    var SimpleCache = class {
+      constructor(options = {}) {
+        this.enabled = options.enabled !== false;
+        this.defaultTTL = options.ttl || 3e4;
+        this.maxSize = options.maxSize || 100;
+        this._store = /* @__PURE__ */ new Map();
+      }
+      /**
+       * Get value from cache
+       * @param {string} key - Cache key
+       * @returns {any|null} - Cached value or null if expired/missing
+       */
+      get(key) {
+        if (!this.enabled) return null;
+        const entry = this._store.get(key);
+        if (!entry) return null;
+        if (Date.now() > entry.expires) {
+          this._store.delete(key);
+          return null;
+        }
+        return entry.data;
+      }
+      /**
+       * Set value in cache with TTL
+       * @param {string} key - Cache key
+       * @param {any} data - Data to cache
+       * @param {number} ttl - Time to live in milliseconds (optional)
+       */
+      set(key, data, ttl) {
+        if (!this.enabled) return;
+        if (this._store.size >= this.maxSize && !this._store.has(key)) {
+          const firstKey = this._store.keys().next().value;
+          this._store.delete(firstKey);
+        }
+        this._store.set(key, {
+          data,
+          expires: Date.now() + (ttl || this.defaultTTL)
+        });
+      }
+      /**
+       * Clear all cached entries
+       */
+      clear() {
+        this._store.clear();
+      }
+      /**
+       * Delete specific key
+       * @param {string} key - Cache key to delete
+       */
+      delete(key) {
+        this._store.delete(key);
+      }
+      /**
+       * Get cache statistics
+       * @returns {object} - Cache stats (size, enabled)
+       */
+      stats() {
+        return {
+          size: this._store.size,
+          maxSize: this.maxSize,
+          enabled: this.enabled
+        };
+      }
+    };
+    module2.exports = { SimpleCache };
+  }
+});
+// src/services/utils/retry.js
+var require_retry = __commonJS({
+  "src/services/utils/retry.js"(exports2, module2) {
+    async function retryWithBackoff(fn, options = {}) {
+      const {
+        attempts = 3,
+        baseDelay = 1e3,
+        maxDelay = 1e4,
+        onRetry = null
+      } = options;
+      let lastError;
+      for (let i = 0; i < attempts; i++) {
+        try {
+          return await fn();
+        } catch (error) {
+          lastError = error;
+          if (i === attempts - 1) {
+            break;
+          }
+          const delay = Math.min(baseDelay * Math.pow(2, i), maxDelay);
+          if (onRetry) {
+            onRetry({
+              attempt: i + 1,
+              totalAttempts: attempts,
+              delay,
+              error
+            });
+          }
+          await sleep(delay);
+        }
+      }
+      throw lastError;
+    }
+    function sleep(ms) {
+      return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    module2.exports = { retryWithBackoff, sleep };
+  }
+});
+// src/errors/index.js
+var require_errors2 = __commonJS({
+  "src/errors/index.js"(exports2, module2) {
+    var SageSDKError = class extends Error {
+      constructor(message, code, retryable = false, originalError = null) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.retryable = retryable;
+        this.originalError = originalError;
+      }
+    };
+    var SubgraphError = class extends SageSDKError {
+      /**
+       * @param {string} message - Error message
+       * @param {'TIMEOUT'|'NETWORK'|'INVALID_RESPONSE'|'NOT_FOUND'|'QUERY_FAILED'} code - Error code
+       * @param {boolean} retryable - Whether error is retryable
+       * @param {Error} originalError - Original error (optional)
+       */
+      constructor(message, code, retryable = false, originalError = null) {
+        super(message, code, retryable, originalError);
+      }
+    };
+    var IPFSError = class extends SageSDKError {
+      /**
+       * @param {string} message - Error message
+       * @param {'TIMEOUT'|'PIN_FAILED'|'INVALID_CID'|'NOT_FOUND'|'GATEWAY_FAILED'|'UPLOAD_FAILED'} code - Error code
+       * @param {boolean} retryable - Whether error is retryable
+       * @param {Error} originalError - Original error (optional)
+       */
+      constructor(message, code, retryable = false, originalError = null) {
+        super(message, code, retryable, originalError);
+      }
+    };
+    function formatErrorMessage(error) {
+      if (!error) return "An unknown error occurred";
+      if (error instanceof SubgraphError || error instanceof IPFSError) {
+        switch (error.code) {
+          case "TIMEOUT":
+            return "Request timed out. Please try again.";
+          case "NETWORK":
+            return "Network error. Check your connection and try again.";
+          case "INVALID_RESPONSE":
+            return "Received invalid data from server.";
+          case "NOT_FOUND":
+            return "Content not found.";
+          case "PIN_FAILED":
+            return "Failed to pin content to IPFS. Please try again.";
+          case "INVALID_CID":
+            return "Invalid content identifier (CID).";
+          case "GATEWAY_FAILED":
+            return "All IPFS gateways failed. Content may be temporarily unavailable.";
+          case "UPLOAD_FAILED":
+            return "Failed to upload content. Please try again.";
+          case "QUERY_FAILED":
+            return "Failed to query data. Please try again.";
+          default:
+            return error.message || "An error occurred";
+        }
+      }
+      return error.message || "An error occurred";
+    }
+    function isRetryable(error) {
+      if (error instanceof SageSDKError) {
+        return error.retryable;
+      }
+      if (error.name === "AbortError" || error.name === "TimeoutError") {
+        return true;
+      }
+      const message = String(error.message || "").toLowerCase();
+      const retryablePatterns = [
+        "timeout",
+        "network",
+        "econnrefused",
+        "econnreset",
+        "etimedout",
+        "fetch failed"
+      ];
+      return retryablePatterns.some((pattern) => message.includes(pattern));
+    }
+    module2.exports = {
+      SageSDKError,
+      SubgraphError,
+      IPFSError,
+      formatErrorMessage,
+      isRetryable
+    };
+  }
+});
+// src/services/subgraph/client.js
+var require_client = __commonJS({
+  "src/services/subgraph/client.js"(exports2, module2) {
+    var subgraph = require_subgraph();
+    var { SimpleCache } = require_cache();
+    var { retryWithBackoff } = require_retry();
+    var { SubgraphError } = require_errors2();
+    var SubgraphService = class {
+      /**
+       * @param {object} config - Service configuration
+       * @param {string} config.url - Subgraph GraphQL endpoint
+       * @param {number} [config.timeout=10000] - Request timeout in ms
+       * @param {number} [config.retries=3] - Number of retry attempts
+       * @param {object} [config.cache] - Cache configuration
+       * @param {boolean} [config.cache.enabled=true] - Enable caching
+       * @param {number} [config.cache.ttl=30000] - Cache TTL in ms
+       * @param {number} [config.cache.maxSize=100] - Max cache entries
+       */
+      constructor(config) {
+        if (!config || !config.url) {
+          throw new Error("SubgraphService requires a url in config");
+        }
+        this.url = config.url;
+        this.timeout = config.timeout || 1e4;
+        this.retries = config.retries || 3;
+        this._cache = new SimpleCache({
+          enabled: config.cache?.enabled !== false,
+          ttl: config.cache?.ttl || 3e4,
+          maxSize: config.cache?.maxSize || 100
+        });
+      }
+      /**
+       * Get list of SubDAOs
+       * @param {object} [options] - Query options
+       * @param {number} [options.limit=50] - Max results
+       * @param {number} [options.skip=0] - Results to skip
+       * @param {boolean} [options.cache=true] - Use cache
+       * @returns {Promise<Array>} - List of SubDAOs
+       */
+      async getSubDAOs(options = {}) {
+        const { limit = 50, skip = 0, cache = true } = options;
+        const cacheKey = `subdaos:${limit}:${skip}`;
+        if (cache) {
+          const cached = this._cache.get(cacheKey);
+          if (cached) return cached;
+        }
+        try {
+          const result = await retryWithBackoff(
+            () => this._querySubDAOs({ limit, skip }),
+            { attempts: this.retries }
+          );
+          if (cache) {
+            this._cache.set(cacheKey, result);
+          }
+          return result;
+        } catch (error) {
+          throw new SubgraphError(
+            `Failed to fetch SubDAOs: ${error.message}`,
+            "QUERY_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Get list of proposals
+       * @param {object} [options] - Query options
+       * @param {string} [options.governor] - Filter by governor address
+       * @param {string} [options.subdao] - Filter by SubDAO address
+       * @param {string[]} [options.states] - Filter by proposal states
+       * @param {number} [options.fromTimestamp] - Filter by creation time (>=)
+       * @param {number} [options.toTimestamp] - Filter by creation time (<=)
+       * @param {number} [options.limit=20] - Max results
+       * @param {number} [options.skip=0] - Results to skip
+       * @param {boolean} [options.cache=true] - Use cache
+       * @returns {Promise<Array>} - List of proposals
+       */
+      async getProposals(options = {}) {
+        const {
+          governor,
+          subdao,
+          states,
+          fromTimestamp,
+          toTimestamp,
+          limit = 20,
+          skip = 0,
+          cache = true
+        } = options;
+        const cacheKey = `proposals:${JSON.stringify({
+          governor,
+          subdao,
+          states,
+          fromTimestamp,
+          toTimestamp,
+          limit,
+          skip
+        })}`;
+        if (cache) {
+          const cached = this._cache.get(cacheKey);
+          if (cached) return cached;
+        }
+        try {
+          const result = await retryWithBackoff(
+            () => this._queryProposals({
+              governor,
+              subdao,
+              states,
+              fromTimestamp,
+              toTimestamp,
+              limit,
+              skip
+            }),
+            { attempts: this.retries }
+          );
+          if (cache) {
+            this._cache.set(cacheKey, result);
+          }
+          return result;
+        } catch (error) {
+          throw new SubgraphError(
+            `Failed to fetch proposals: ${error.message}`,
+            "QUERY_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Get proposal by ID
+       * @param {string} id - Proposal ID
+       * @param {object} [options] - Query options
+       * @param {boolean} [options.cache=true] - Use cache
+       * @returns {Promise<object|null>} - Proposal or null
+       */
+      async getProposalById(id2, options = {}) {
+        const { cache = true } = options;
+        const cacheKey = `proposal:${id2}`;
+        if (cache) {
+          const cached = this._cache.get(cacheKey);
+          if (cached !== null) return cached;
+        }
+        try {
+          const result = await retryWithBackoff(
+            () => subgraph.getProposalById({ url: this.url, id: id2 }),
+            { attempts: this.retries }
+          );
+          if (cache) {
+            this._cache.set(cacheKey, result);
+          }
+          return result;
+        } catch (error) {
+          throw new SubgraphError(
+            `Failed to fetch proposal ${id2}: ${error.message}`,
+            "QUERY_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Get libraries
+       * @param {object} [options] - Query options
+       * @param {string} [options.subdao] - Filter by SubDAO address
+       * @param {number} [options.limit=50] - Max results
+       * @param {number} [options.skip=0] - Results to skip
+       * @param {boolean} [options.cache=true] - Use cache
+       * @returns {Promise<Array>} - List of libraries
+       */
+      async getLibraries(options = {}) {
+        const { subdao, limit = 50, skip = 0, cache = true } = options;
+        const cacheKey = `libraries:${subdao || "all"}:${limit}:${skip}`;
+        if (cache) {
+          const cached = this._cache.get(cacheKey);
+          if (cached) return cached;
+        }
+        try {
+          const result = await retryWithBackoff(
+            () => subgraph.listLibraries({ url: this.url, subdao, first: limit, skip }),
+            { attempts: this.retries }
+          );
+          if (cache) {
+            this._cache.set(cacheKey, result);
+          }
+          return result;
+        } catch (error) {
+          throw new SubgraphError(
+            `Failed to fetch libraries: ${error.message}`,
+            "QUERY_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Get prompts by tag
+       * @param {object} options - Query options
+       * @param {string} options.tagsHash - Tag hash to filter by
+       * @param {string} [options.registry] - Filter by registry address
+       * @param {number} [options.limit=50] - Max results
+       * @param {number} [options.skip=0] - Results to skip
+       * @param {boolean} [options.cache=true] - Use cache
+       * @returns {Promise<Array>} - List of prompts
+       */
+      async getPromptsByTag(options) {
+        if (!options || !options.tagsHash) {
+          throw new Error("tagsHash is required");
+        }
+        const { tagsHash, registry, limit = 50, skip = 0, cache = true } = options;
+        const cacheKey = `prompts-tag:${tagsHash}:${registry || "all"}:${limit}:${skip}`;
+        if (cache) {
+          const cached = this._cache.get(cacheKey);
+          if (cached) return cached;
+        }
+        try {
+          const result = await retryWithBackoff(
+            () => subgraph.listPromptsByTag({
+              url: this.url,
+              tagsHash,
+              registry,
+              first: limit,
+              skip
+            }),
+            { attempts: this.retries }
+          );
+          if (cache) {
+            this._cache.set(cacheKey, result);
+          }
+          return result;
+        } catch (error) {
+          throw new SubgraphError(
+            `Failed to fetch prompts by tag: ${error.message}`,
+            "QUERY_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Get registry prompts
+       * @param {object} options - Query options
+       * @param {string} options.registry - Registry address
+       * @param {number} [options.limit=50] - Max results
+       * @param {number} [options.skip=0] - Results to skip
+       * @param {boolean} [options.cache=true] - Use cache
+       * @returns {Promise<Array>} - List of prompts
+       */
+      async getRegistryPrompts(options) {
+        if (!options || !options.registry) {
+          throw new Error("registry is required");
+        }
+        const { registry, limit = 50, skip = 0, cache = true } = options;
+        const cacheKey = `registry-prompts:${registry}:${limit}:${skip}`;
+        if (cache) {
+          const cached = this._cache.get(cacheKey);
+          if (cached) return cached;
+        }
+        try {
+          const result = await retryWithBackoff(
+            () => subgraph.listRegistryPrompts({
+              url: this.url,
+              registry,
+              first: limit,
+              skip
+            }),
+            { attempts: this.retries }
+          );
+          if (cache) {
+            this._cache.set(cacheKey, result);
+          }
+          return result;
+        } catch (error) {
+          throw new SubgraphError(
+            `Failed to fetch registry prompts: ${error.message}`,
+            "QUERY_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Clear cache
+       */
+      clearCache() {
+        this._cache.clear();
+      }
+      /**
+       * Get cache statistics
+       * @returns {object} - Cache stats
+       */
+      getCacheStats() {
+        return this._cache.stats();
+      }
+      // Private methods
+      async _querySubDAOs({ limit, skip }) {
+        const data = await subgraph.query(
+          this.url,
+          `
+      query($first: Int!, $skip: Int!) {
+        subDAOs(first: $first, skip: $skip, orderBy: createdAt, orderDirection: desc) {
+          id
+          address
+          name
+          description
+          governor
+          registry
+          token
+          createdAt
+        }
+      }
+    `,
+          { first: limit, skip }
+        );
+        return data?.subDAOs || [];
+      }
+      async _queryProposals({ governor, subdao, states, fromTimestamp, toTimestamp, limit, skip }) {
+        return await subgraph.listProposalsFiltered({
+          url: this.url,
+          governor,
+          states,
+          fromTimestamp,
+          toTimestamp,
+          first: limit,
+          skip
+        });
+      }
+    };
+    module2.exports = { SubgraphService };
+  }
+});
+// src/services/ipfs/client.js
+var require_client2 = __commonJS({
+  "src/services/ipfs/client.js"(exports2, module2) {
+    var ipfs = require_ipfs();
+    var { SimpleCache } = require_cache();
+    var { retryWithBackoff } = require_retry();
+    var { IPFSError } = require_errors2();
+    var IPFSService = class {
+      /**
+       * @param {object} config - Service configuration
+       * @param {string} config.workerBaseUrl - IPFS worker base URL
+       * @param {string} config.gateway - Primary IPFS gateway URL
+       * @param {object} [config.signer] - ethers v6 signer for worker auth
+       * @param {Function} [config.getAuth] - Function to get auth credentials
+       * @param {string} [config.workerToken] - Bearer token for worker auth
+       * @param {number} [config.timeout=15000] - Request timeout in ms
+       * @param {number} [config.retries=2] - Number of retry attempts
+       * @param {object} [config.cache] - Cache configuration
+       * @param {boolean} [config.cache.enabled=true] - Enable caching
+       * @param {number} [config.cache.ttl=300000] - Cache TTL in ms (default 5min for immutable CIDs)
+       * @param {number} [config.cache.maxSize=50] - Max cache entries
+       */
+      constructor(config) {
+        if (!config) {
+          throw new Error("IPFSService requires a config object");
+        }
+        this.workerBaseUrl = config.workerBaseUrl;
+        this.gateway = config.gateway;
+        this.timeout = config.timeout || 15e3;
+        this.retries = config.retries || 2;
+        this._client = ipfs.createClient({
+          workerBaseUrl: config.workerBaseUrl,
+          gateway: config.gateway,
+          workerSigner: config.signer,
+          workerGetAuth: config.getAuth,
+          workerToken: config.workerToken,
+          timeoutMs: this.timeout,
+          retries: this.retries
+        });
+        this._cache = new SimpleCache({
+          enabled: config.cache?.enabled !== false,
+          ttl: config.cache?.ttl || 3e5,
+          // 5 minutes
+          maxSize: config.cache?.maxSize || 50
+        });
+      }
+      /**
+       * Upload content to IPFS worker
+       * @param {any} content - Content to upload (will be JSON stringified)
+       * @param {object} [options] - Upload options
+       * @param {string} [options.name] - Content name
+       * @param {boolean} [options.warm=false] - Warm gateways after upload
+       * @returns {Promise<string>} - CID of uploaded content
+       */
+      async upload(content, options = {}) {
+        const { name = "upload", warm = false } = options;
+        try {
+          const result = await retryWithBackoff(
+            () => this._client.uploadJson(content, name, {
+              provider: "worker",
+              warm
+            }),
+            { attempts: this.retries }
+          );
+          return result.cid;
+        } catch (error) {
+          throw new IPFSError(
+            `Failed to upload content: ${error.message}`,
+            "UPLOAD_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Fetch JSON content by CID with parallel gateway fetching
+       * @param {string} cid - IPFS CID
+       * @param {object} [options] - Fetch options
+       * @param {boolean} [options.cache=true] - Use cache
+       * @param {number} [options.timeout=5000] - Timeout per gateway in ms
+       * @param {string[]} [options.extraGateways] - Additional gateways to try
+       * @returns {Promise<any|null>} - Parsed JSON content or null
+       */
+      async fetchByCID(cid, options = {}) {
+        if (!cid) {
+          throw new IPFSError("CID is required", "INVALID_CID", false);
+        }
+        const { cache = true, timeout = 5e3, extraGateways = [] } = options;
+        if (cache) {
+          const cached = this._cache.get(cid);
+          if (cached) return cached;
+        }
+        const urls = this._client.buildGatewayUrls(cid, extraGateways);
+        try {
+          const result = await this._parallelFetch(urls, timeout);
+          if (result === null) {
+            throw new IPFSError(
+              `All gateways failed for CID ${cid}`,
+              "GATEWAY_FAILED",
+              true
+            );
+          }
+          if (cache) {
+            this._cache.set(cid, result);
+          }
+          return result;
+        } catch (error) {
+          if (error instanceof IPFSError) throw error;
+          throw new IPFSError(
+            `Failed to fetch CID ${cid}: ${error.message}`,
+            "GATEWAY_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Pin CIDs to IPFS worker
+       * @param {string|string[]} cids - CID or array of CIDs to pin
+       * @param {object} [options] - Pin options
+       * @param {boolean} [options.warm=false] - Warm gateways after pinning
+       * @returns {Promise<void>}
+       */
+      async pin(cids, options = {}) {
+        const { warm = false } = options;
+        const cidList = Array.isArray(cids) ? cids : [cids];
+        if (cidList.length === 0) {
+          throw new IPFSError("At least one CID is required", "INVALID_CID", false);
+        }
+        try {
+          await retryWithBackoff(
+            () => this._client.pin({ cids: cidList, warm }),
+            { attempts: this.retries }
+          );
+        } catch (error) {
+          throw new IPFSError(
+            `Failed to pin CIDs: ${error.message}`,
+            "PIN_FAILED",
+            true,
+            error
+          );
+        }
+      }
+      /**
+       * Warm gateways for a CID (prefetch)
+       * @param {string} cid - CID to warm
+       * @param {object} [options] - Warm options
+       * @param {string[]} [options.gateways] - Specific gateways to warm
+       * @returns {Promise<object>} - Warm result
+       */
+      async warm(cid, options = {}) {
+        const { gateways } = options;
+        try {
+          return await this._client.warmGateways(cid, { gateways });
+        } catch (error) {
+          return { warmed: [] };
+        }
+      }
+      /**
+       * Clear cache
+       */
+      clearCache() {
+        this._cache.clear();
+      }
+      /**
+       * Get cache statistics
+       * @returns {object} - Cache stats
+       */
+      getCacheStats() {
+        return this._cache.stats();
+      }
+      // Private methods
+      /**
+       * Fetch from multiple gateways in parallel
+       * @param {string[]} urls - Gateway URLs to try
+       * @param {number} timeout - Timeout per gateway in ms
+       * @returns {Promise<any|null>} - First successful result or null
+       * @private
+       */
+      async _parallelFetch(urls, timeout) {
+        if (!urls || urls.length === 0) {
+          return null;
+        }
+        const fetchOne = async (url) => {
+          const controller = new AbortController();
+          const timeoutId = setTimeout(() => controller.abort(), timeout);
+          try {
+            const response = await fetch(url, {
+              signal: controller.signal,
+              headers: { Accept: "application/json" }
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+              return null;
+            }
+            const text = await response.text();
+            try {
+              return JSON.parse(text);
+            } catch {
+              return text;
+            }
+          } catch (error) {
+            clearTimeout(timeoutId);
+            return null;
+          }
+        };
+        const results = await Promise.allSettled(urls.map((url) => fetchOne(url)));
+        for (const result of results) {
+          if (result.status === "fulfilled" && result.value !== null) {
+            return result.value;
+          }
+        }
+        return null;
+      }
+    };
+    module2.exports = { IPFSService };
+  }
+});
+// src/hooks/useSubDAOs.js
+var require_useSubDAOs = __commonJS({
+  "src/hooks/useSubDAOs.js"(exports2, module2) {
+    var useSWR = require("swr");
+    function useSubDAOs(subgraphService, options = {}) {
+      const {
+        limit = 50,
+        skip = 0,
+        cache = true,
+        refreshInterval,
+        revalidateOnFocus = true,
+        revalidateOnReconnect = true
+      } = options;
+      const cacheKey = subgraphService ? ["subdaos", subgraphService.url, limit, skip] : null;
+      const fetcher = async () => {
+        if (!subgraphService) {
+          throw new Error("SubgraphService is required");
+        }
+        return await subgraphService.getSubDAOs({ limit, skip, cache });
+      };
+      return useSWR(cacheKey, fetcher, {
+        refreshInterval,
+        revalidateOnFocus,
+        revalidateOnReconnect,
+        dedupingInterval: cache ? 3e4 : 0
+        // Match service cache TTL
+      });
+    }
+    module2.exports = { useSubDAOs };
+  }
+});
+// src/hooks/useProposals.js
+var require_useProposals = __commonJS({
+  "src/hooks/useProposals.js"(exports2, module2) {
+    var useSWR = require("swr");
+    function useProposals(subgraphService, options = {}) {
+      const {
+        governor,
+        subdao,
+        states,
+        fromTimestamp,
+        toTimestamp,
+        limit = 20,
+        skip = 0,
+        cache = true,
+        refreshInterval,
+        revalidateOnFocus = true,
+        revalidateOnReconnect = true
+      } = options;
+      const cacheKey = subgraphService ? [
+        "proposals",
+        subgraphService.url,
+        governor,
+        subdao,
+        states?.join(","),
+        fromTimestamp,
+        toTimestamp,
+        limit,
+        skip
+      ] : null;
+      const fetcher = async () => {
+        if (!subgraphService) {
+          throw new Error("SubgraphService is required");
+        }
+        return await subgraphService.getProposals({
+          governor,
+          subdao,
+          states,
+          fromTimestamp,
+          toTimestamp,
+          limit,
+          skip,
+          cache
+        });
+      };
+      return useSWR(cacheKey, fetcher, {
+        refreshInterval,
+        revalidateOnFocus,
+        revalidateOnReconnect,
+        dedupingInterval: cache ? 3e4 : 0
+        // Match service cache TTL
+      });
+    }
+    module2.exports = { useProposals };
+  }
+});
+// src/hooks/useFetchCID.js
+var require_useFetchCID = __commonJS({
+  "src/hooks/useFetchCID.js"(exports2, module2) {
+    var useSWR = require("swr");
+    function useFetchCID(ipfsService, cid, options = {}) {
+      const {
+        cache = true,
+        timeout = 5e3,
+        extraGateways = [],
+        refreshInterval,
+        revalidateOnFocus = false,
+        // CIDs are immutable
+        revalidateOnReconnect = false
+        // CIDs are immutable
+      } = options;
+      const cacheKey = ipfsService && cid ? ["ipfs-cid", cid] : null;
+      const fetcher = async () => {
+        if (!ipfsService) {
+          throw new Error("IPFSService is required");
+        }
+        if (!cid) {
+          throw new Error("CID is required");
+        }
+        return await ipfsService.fetchByCID(cid, {
+          cache,
+          timeout,
+          extraGateways
+        });
+      };
+      return useSWR(cacheKey, fetcher, {
+        refreshInterval,
+        revalidateOnFocus,
+        revalidateOnReconnect,
+        dedupingInterval: cache ? 3e5 : 0,
+        // Match service cache TTL (5min)
+        // CIDs are immutable, so we can cache errors too
+        shouldRetryOnError: true,
+        errorRetryInterval: 5e3,
+        errorRetryCount: 3
+      });
+    }
+    module2.exports = { useFetchCID };
+  }
+});
+// src/hooks/useUpload.js
+var require_useUpload = __commonJS({
+  "src/hooks/useUpload.js"(exports2, module2) {
+    var { useState, useCallback } = require("react");
+    function useUpload(ipfsService) {
+      const [isUploading, setIsUploading] = useState(false);
+      const [error, setError] = useState(null);
+      const [data, setData] = useState(null);
+      const upload = useCallback(
+        async (content, options = {}) => {
+          if (!ipfsService) {
+            const err = new Error("IPFSService is required");
+            setError(err);
+            throw err;
+          }
+          setIsUploading(true);
+          setError(null);
+          try {
+            const cid = await ipfsService.upload(content, options);
+            setData(cid);
+            return cid;
+          } catch (err) {
+            setError(err);
+            throw err;
+          } finally {
+            setIsUploading(false);
+          }
+        },
+        [ipfsService]
+      );
+      const reset = useCallback(() => {
+        setIsUploading(false);
+        setError(null);
+        setData(null);
+      }, []);
+      return {
+        upload,
+        isUploading,
+        error,
+        data,
+        reset
+      };
+    }
+    module2.exports = { useUpload };
+  }
+});
+// src/hooks/index.js
+var require_hooks = __commonJS({
+  "src/hooks/index.js"(exports2, module2) {
+    var { useSubDAOs } = require_useSubDAOs();
+    var { useProposals } = require_useProposals();
+    var { useFetchCID } = require_useFetchCID();
+    var { useUpload } = require_useUpload();
+    module2.exports = {
+      useSubDAOs,
+      useProposals,
+      useFetchCID,
+      useUpload
+    };
+  }
+});
 // src/index.js
 var require_src = __commonJS({
   "src/index.js"(exports2, module2) {
@@ -8143,6 +9078,7 @@ var require_src = __commonJS({
     governance.intents = require_intents();
     var governanceTemplates = require_templates();
     governance.operations = require_operations();
+    governance.grants = require_grants();
     var subdao = require_subdao();
     var timelock = require_timelock();
     var factory = require_factory();
@@ -8159,7 +9095,6 @@ var require_src = __commonJS({
     var treasury = require_treasury();
     var boost = require_boost();
     var bounty = require_bounty();
-    var bond = require_bond();
     var wallet = require_wallet();
     wallet.session = require_session();
     var walletCastManager = require_cast_manager();
@@ -8174,6 +9109,16 @@ var require_src = __commonJS({
         openzeppelin: require_openzeppelin()
       }
     };
+    var { SubgraphService } = require_client();
+    var { IPFSService } = require_client2();
+    var serviceErrors = require_errors2();
+    var { SimpleCache } = require_cache();
+    var { retryWithBackoff } = require_retry();
+    var hooks = null;
+    try {
+      hooks = require_hooks();
+    } catch (err) {
+    }
     module2.exports = {
       version: pkg.version,
       getProvider: utils.getProvider,
@@ -8192,7 +9137,7 @@ var require_src = __commonJS({
       personal,
       treasury,
       boost,
-      bond,
+      // bond module removed; bonds deprecated in CLI/SDK
       subgraph,
       utils: { ...utils, privateTx, safe },
       bounty,
@@ -8204,6 +9149,18 @@ var require_src = __commonJS({
       errors,
       doppler,
       adapters,
+      // New service layer exports
+      services: {
+        SubgraphService,
+        IPFSService
+      },
+      serviceErrors,
+      serviceUtils: {
+        SimpleCache,
+        retryWithBackoff
+      },
+      // React hooks (optional - requires react + swr peer dependencies)
+      hooks,
       // Legacy exports (deprecated): maintain compatibility while consumers migrate
       resolveGovernanceContext: async function legacyResolveGovernanceContext(args) {
         console.warn("[@sage-protocol/sdk] resolveGovernanceContext is deprecated. Use governance helpers instead.");