@sage-protocol/sdk 0.1.2 → 0.1.7

package/dist/index.mjs

@@ -17,10 +17,10 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
 
 // package.json
 var require_package = __commonJS({
-  "package.json"(exports, module) {
-    module.exports = {
+  "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",
@@ -56,10 +56,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",
@@ -88,6 +88,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
+        }
       }
     };
   }
@@ -95,7 +107,7 @@ var require_package = __commonJS({
 
 // src/abi/index.js
 var require_abi = __commonJS({
-  "src/abi/index.js"(exports, module) {
+  "src/abi/index.js"(exports2, module2) {
     var SubDAO = [
       "function governor() view returns (address)",
       "function timelock() view returns (address)",
@@ -301,7 +313,7 @@ var require_abi = __commonJS({
     var Events = {
       ProposalCreated: "event ProposalCreated(uint256 id, address proposer, address[] targets, uint256[] values, string[] signatures, bytes[] calldatas, uint256 startBlock, uint256 endBlock, string description)"
     };
-    module.exports = {
+    module2.exports = {
       SubDAO,
       Factory,
       FactoryRead,
@@ -327,9 +339,9 @@ var require_abi = __commonJS({
 
 // src/types.js
 var require_types = __commonJS({
-  "src/types.js"(exports, module) {
+  "src/types.js"(exports2, module2) {
     var BigIntZero = 0n;
-    module.exports = {
+    module2.exports = {
       BigIntZero
     };
   }
@@ -337,7 +349,7 @@ var require_types = __commonJS({
 
 // src/utils/errors.js
 var require_errors = __commonJS({
-  "src/utils/errors.js"(exports, module) {
+  "src/utils/errors.js"(exports2, module2) {
     var SageSDKError = class extends Error {
       constructor(code, message, details) {
         super(message);
@@ -354,7 +366,7 @@ var require_errors = __commonJS({
       MISSING_DEPENDENCY: "ERR_MISSING_DEPENDENCY",
       API_REQUEST_FAILED: "ERR_API_REQUEST_FAILED"
     };
-    module.exports = {
+    module2.exports = {
       SageSDKError,
       CODES
     };
@@ -363,7 +375,7 @@ var require_errors = __commonJS({
 
 // src/utils/description.js
 var require_description = __commonJS({
-  "src/utils/description.js"(exports, module) {
+  "src/utils/description.js"(exports2, module2) {
     var { randomBytes, hexlify } = __require("ethers");
     var SALT_RE = /\n\n\[SALT:0x[0-9a-fA-F]{64}\]$/;
     function generateSaltHex() {
@@ -394,7 +406,7 @@ var require_description = __commonJS({
         return String(desc || "");
       }
     }
-    module.exports = {
+    module2.exports = {
       makeProposalDescription,
       stripProposalSalt
     };
@@ -403,7 +415,7 @@ var require_description = __commonJS({
 
 // src/subgraph/index.js
 var require_subgraph = __commonJS({
-  "src/subgraph/index.js"(exports, module) {
+  "src/subgraph/index.js"(exports2, module2) {
     var axios = __require("axios");
     var { getAddress } = __require("ethers");
     var { keccak256, toUtf8Bytes } = __require("ethers");
@@ -526,7 +538,7 @@ var require_subgraph = __commonJS({
         createdAt: Number(lib.createdAt || 0)
       }));
     }
-    module.exports = {
+    module2.exports = {
       query,
       listProposals,
       listProposalsFiltered,
@@ -535,9 +547,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!) {
@@ -725,10 +737,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 {
@@ -750,7 +762,7 @@ var require_subgraph = __commonJS({
 
 // src/adapters/transports.js
 var require_transports = __commonJS({
-  "src/adapters/transports.js"(exports, module) {
+  "src/adapters/transports.js"(exports2, module2) {
     function createTransports({ provider, signer = null, subgraph = null }) {
       return function resolve(kind) {
         switch (kind) {
@@ -765,7 +777,7 @@ var require_transports = __commonJS({
         }
       };
     }
-    module.exports = {
+    module2.exports = {
       createTransports
     };
   }
@@ -773,10 +785,10 @@ var require_transports = __commonJS({
 
 // src/ipfs/index.js
 var require_ipfs = __commonJS({
-  "src/ipfs/index.js"(exports, module) {
+  "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;
@@ -831,14 +843,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}`;
@@ -910,7 +922,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")}`;
@@ -1232,18 +1244,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;
@@ -1273,11 +1285,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);
@@ -1393,7 +1405,7 @@ var require_ipfs = __commonJS({
         verified
       };
     }
-    module.exports = {
+    module2.exports = {
       DEFAULT_GATEWAY,
       createClient,
       buildGatewayUrls,
@@ -1405,7 +1417,7 @@ var require_ipfs = __commonJS({
 
 // src/library/search.js
 var require_search = __commonJS({
-  "src/library/search.js"(exports, module) {
+  "src/library/search.js"(exports2, module2) {
     var { Contract, getAddress } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -1576,7 +1588,7 @@ var require_search = __commonJS({
         }
       };
     }
-    module.exports = {
+    module2.exports = {
       searchRegistry
     };
   }
@@ -1584,7 +1596,7 @@ var require_search = __commonJS({
 
 // src/library/validation.js
 var require_validation = __commonJS({
-  "src/library/validation.js"(exports, module) {
+  "src/library/validation.js"(exports2, module2) {
     var fsDefault = __require("fs");
     var pathDefault = __require("path");
     function defaultAjvFactory() {
@@ -1603,18 +1615,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;
@@ -1640,17 +1652,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 };
@@ -1723,7 +1735,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,
@@ -1756,8 +1768,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}`,
@@ -1780,7 +1792,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 }];
         }
@@ -1794,7 +1806,7 @@ var require_validation = __commonJS({
         bestPracticeCheckFile
       };
     }
-    module.exports = {
+    module2.exports = {
       createManifestValidator
     };
   }
@@ -1802,8 +1814,8 @@ var require_validation = __commonJS({
 
 // src/library/index.js
 var require_library = __commonJS({
-  "src/library/index.js"(exports, module) {
-    var { Contract, getAddress, keccak256, toUtf8Bytes } = __require("ethers");
+  "src/library/index.js"(exports2, module2) {
+    var { Contract, getAddress, keccak256, toUtf8Bytes, AbiCoder } = __require("ethers");
     var { Interface } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -1842,17 +1854,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,12 +1898,14 @@ var require_library = __commonJS({
       ]);
       return { to, data, value: 0n };
     }
-    module.exports = {
+    module2.exports = {
       listManifests,
       getManifestInfo,
       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");
@@ -1914,7 +1942,7 @@ var require_library = __commonJS({
 
 // src/governance/index.js
 var require_governance = __commonJS({
-  "src/governance/index.js"(exports, module) {
+  "src/governance/index.js"(exports2, module2) {
     var { Contract, Interface, AbiCoder, getAddress, hexlify, keccak256, toUtf8Bytes } = __require("ethers");
     var ABI = require_abi();
     var { BigIntZero } = require_types();
@@ -1964,11 +1992,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),
@@ -2022,12 +2050,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 {
@@ -2088,10 +2116,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 = "" }) {
@@ -2112,17 +2140,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);
@@ -2240,7 +2324,7 @@ var require_governance = __commonJS({
       const token = await g.sxxxToken();
       return buildDelegateTx({ token, delegatee: account });
     }
-    module.exports = {
+    module2.exports = {
       getGovernorInfo,
       getProposal,
       listProposals,
@@ -2252,6 +2336,7 @@ var require_governance = __commonJS({
       buildExecuteTx,
       buildQueueByIdTx,
       buildExecuteByIdTx,
+      decodeProposalEffects,
       makeProposalDescription,
       stripProposalSalt,
       getQuorumAt,
@@ -2509,7 +2594,7 @@ var require_governance = __commonJS({
 
 // src/governance/intents.js
 var require_intents = __commonJS({
-  "src/governance/intents.js"(exports, module) {
+  "src/governance/intents.js"(exports2, module2) {
     var { Interface, getAddress } = __require("ethers");
     var { SageSDKError, CODES } = require_errors();
     function normalise(addr, label) {
@@ -2533,7 +2618,7 @@ var require_intents = __commonJS({
       "function setPremiumRevSplit(address,uint16,uint16,uint16)",
       "function setCreatorStakeBps(address,uint256)"
     ]);
-    module.exports = {
+    module2.exports = {
       // Governor targets
       buildUpdateQuorumTx: ({ governor, quorumPercent }) => ({ to: normalise(governor, "governor"), data: GovIface.encodeFunctionData("updateQuorumNumerator", [Number(quorumPercent)]), value: 0n }),
       buildSetVotingPeriodTx: ({ governor, blocks }) => ({ to: normalise(governor, "governor"), data: GovIface.encodeFunctionData("setVotingPeriodBlocks", [Number(blocks)]), value: 0n }),
@@ -2551,7 +2636,7 @@ var require_intents = __commonJS({
 
 // src/utils/logs.js
 var require_logs = __commonJS({
-  "src/utils/logs.js"(exports, module) {
+  "src/utils/logs.js"(exports2, module2) {
     async function fetchLogsChunked({ provider, address, topics = [], fromBlock = 0, toBlock = "latest", chunkSize = 5e4 }) {
       if (!provider) throw new Error("provider required");
       const latest = toBlock === "latest" ? await provider.getBlockNumber() : Number(toBlock);
@@ -2565,7 +2650,7 @@ var require_logs = __commonJS({
       }
       return logs;
     }
-    module.exports = {
+    module2.exports = {
       fetchLogsChunked
     };
   }
@@ -2573,7 +2658,7 @@ var require_logs = __commonJS({
 
 // src/subdao/index.js
 var require_subdao = __commonJS({
-  "src/subdao/index.js"(exports, module) {
+  "src/subdao/index.js"(exports2, module2) {
     var { Contract, Interface, getAddress } = __require("ethers");
     var ABI = require_abi();
     var { fetchLogsChunked } = require_logs();
@@ -2671,7 +2756,7 @@ var require_subdao = __commonJS({
       const data = SubDAOInterface.encodeFunctionData("unstake", [BigInt(amount)]);
       return { to: addr, data, value: 0n };
     }
-    module.exports = {
+    module2.exports = {
       discoverSubDAOs,
       getSubDAOInfo,
       getSubDAOUserStats,
@@ -2784,16 +2869,16 @@ var require_subdao = __commonJS({
       const op = await makeOperator({ signer, subdao: created.subdao, operator, grantAdmin });
       return { ...created, operatorResult: op };
     }
-    module.exports.ensureSxxxBurnAllowance = ensureSxxxBurnAllowance;
-    module.exports.createSubDAO = createSubDAO;
-    module.exports.makeOperator = makeOperator;
-    module.exports.createOperatorSubDAO = createOperatorSubDAO;
+    module2.exports.ensureSxxxBurnAllowance = ensureSxxxBurnAllowance;
+    module2.exports.createSubDAO = createSubDAO;
+    module2.exports.makeOperator = makeOperator;
+    module2.exports.createOperatorSubDAO = createOperatorSubDAO;
   }
 });
 
 // src/governance/templates.js
 var require_templates = __commonJS({
-  "src/governance/templates.js"(exports, module) {
+  "src/governance/templates.js"(exports2, module2) {
     var { Contract, ZeroAddress, getAddress, isAddress } = __require("ethers");
     var subdao = require_subdao();
     var abi = require_abi();
@@ -2903,7 +2988,7 @@ var require_templates = __commonJS({
       const receipts = await executeSequence(actions);
       return { governor, timelock, receipts };
     }
-    module.exports = {
+    module2.exports = {
       communityDraftsBoardExec,
       tokenDemocracy
     };
@@ -2912,7 +2997,7 @@ var require_templates = __commonJS({
 
 // src/adapters/governance/openzeppelin.js
 var require_openzeppelin = __commonJS({
-  "src/adapters/governance/openzeppelin.js"(exports, module) {
+  "src/adapters/governance/openzeppelin.js"(exports2, module2) {
     var { Contract, Interface, getAddress } = __require("ethers");
     var axios = __require("axios");
     var ABI = require_abi();
@@ -2958,7 +3043,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()));
@@ -2968,7 +3053,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 (_) {
           }
         }
@@ -2976,10 +3061,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,
@@ -3144,7 +3229,7 @@ var require_openzeppelin = __commonJS({
       }
       return out;
     }
-    module.exports = {
+    module2.exports = {
       getProposals,
       getTimelineOnchain,
       getSignatureList,
@@ -3199,7 +3284,7 @@ var require_openzeppelin = __commonJS({
 
 // src/governance/operations.js
 var require_operations = __commonJS({
-  "src/governance/operations.js"(exports, module) {
+  "src/governance/operations.js"(exports2, module2) {
     var { Contract, getAddress, Interface, ZeroAddress, ZeroHash, keccak256, toUtf8Bytes, formatEther } = __require("ethers");
     var governance = require_governance();
     var ABI = require_abi();
@@ -3212,9 +3297,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) {
@@ -3236,7 +3321,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) : [];
@@ -3246,7 +3331,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,
@@ -3271,10 +3356,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) {
@@ -3283,10 +3368,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)),
@@ -3295,7 +3380,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 (_) {
@@ -3303,7 +3388,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;
       }
@@ -3312,7 +3397,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);
@@ -3335,9 +3420,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())),
@@ -3362,7 +3447,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;
             }
@@ -3372,9 +3457,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;
     }
@@ -3659,7 +3744,7 @@ var require_operations = __commonJS({
       }
       return results;
     }
-    module.exports = {
+    module2.exports = {
       resolveProposalTuple,
       queueProposal,
       executeProposal,
@@ -3670,9 +3755,94 @@ 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"(exports, module) {
+  "src/timelock/index.js"(exports2, module2) {
     var { Contract, Interface, getAddress } = __require("ethers");
     var { SageSDKError, CODES } = require_errors();
     var TimelockABI = [
@@ -3732,8 +3902,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),
@@ -3755,14 +3925,14 @@ var require_timelock = __commonJS({
           } else if (parsed.name === "Cancelled") {
             op.cancelled = true;
           }
-          operations.set(id, op);
+          operations.set(id2, op);
         } catch (err) {
           continue;
         }
       }
       return Array.from(operations.values());
     }
-    module.exports = {
+    module2.exports = {
       getTimelockInfo,
       listQueuedOperations,
       buildScheduleTx: ({ timelock, target, value = 0n, data = "0x", predecessor = "0x0000000000000000000000000000000000000000000000000000000000000000", salt = "0x0000000000000000000000000000000000000000000000000000000000000000", delay = 0n }) => {
@@ -3778,10 +3948,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" }) => {
@@ -3801,7 +3971,7 @@ var require_timelock = __commonJS({
 
 // src/factory/index.js
 var require_factory = __commonJS({
-  "src/factory/index.js"(exports, module) {
+  "src/factory/index.js"(exports2, module2) {
     var { Contract, Interface, getAddress } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -3890,10 +4060,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]),
@@ -4072,7 +4242,7 @@ var require_factory = __commonJS({
         return null;
       }
     }
-    module.exports = {
+    module2.exports = {
       getFactoryConfig,
       getFactoryStats,
       listSubDAOs,
@@ -4090,7 +4260,7 @@ var require_factory = __commonJS({
 
 // src/prompt/execute.js
 var require_execute = __commonJS({
-  "src/prompt/execute.js"(exports, module) {
+  "src/prompt/execute.js"(exports2, module2) {
     var axios = __require("axios");
     var { createEchoOpenAI } = __require("@merit-systems/echo-typescript-sdk");
     var { generateText } = __require("ai");
@@ -4280,13 +4450,13 @@ ${JSON.stringify(residual, null, 2)}`
         forkDepth: Number(data.forkDepth || 0)
       };
     };
-    module.exports = { SageEchoExecutor };
+    module2.exports = { SageEchoExecutor };
   }
 });
 
 // src/prompt/index.js
 var require_prompt = __commonJS({
-  "src/prompt/index.js"(exports, module) {
+  "src/prompt/index.js"(exports2, module2) {
     var { Contract, getAddress } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -4348,8 +4518,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 }));
       }
@@ -4361,8 +4531,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 }));
       }
@@ -4374,8 +4544,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 }));
       }
@@ -4387,8 +4557,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 }));
       }
@@ -4412,7 +4582,7 @@ var require_prompt = __commonJS({
       const contract = new Contract(addr, ABI.PromptRegistry, provider);
       return contract.usageCount(key).catch(() => 0);
     }
-    module.exports = {
+    module2.exports = {
       getPromptData,
       listPrompts,
       listByTagPage,
@@ -4461,7 +4631,7 @@ var require_prompt = __commonJS({
 
 // src/ipns/index.js
 var require_ipns = __commonJS({
-  "src/ipns/index.js"(exports, module) {
+  "src/ipns/index.js"(exports2, module2) {
     var axiosDefault = __require("axios");
     var contentHashLib = null;
     try {
@@ -4478,9 +4648,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();
@@ -4575,10 +4745,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);
@@ -4600,7 +4770,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;
     }
@@ -4843,7 +5013,7 @@ var require_ipns = __commonJS({
         }
       };
     }
-    module.exports = {
+    module2.exports = {
       createClient,
       normalizeIpnsName,
       normalizeCid,
@@ -4854,7 +5024,7 @@ var require_ipns = __commonJS({
 
 // src/token/index.js
 var require_token = __commonJS({
-  "src/token/index.js"(exports, module) {
+  "src/token/index.js"(exports2, module2) {
     var { Contract, Interface, getAddress } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -5006,7 +5176,7 @@ var require_token = __commonJS({
     function getBurnConstants() {
       return { ...BURN_CONSTANTS };
     }
-    module.exports = {
+    module2.exports = {
       getBalance,
       getVotes,
       getTotalSupply,
@@ -5026,8 +5196,8 @@ var require_token = __commonJS({
 
 // src/personal/helpers.js
 var require_helpers = __commonJS({
-  "src/personal/helpers.js"(exports, module) {
-    var { getAddress, ZeroAddress, id } = __require("ethers");
+  "src/personal/helpers.js"(exports2, module2) {
+    var { getAddress, ZeroAddress, id: id2 } = __require("ethers");
     function normaliseAddress(addr, label) {
       if (!addr) throw new Error(`[personal] missing ${label}`);
       const value = addr.toString();
@@ -5038,9 +5208,9 @@ var require_helpers = __commonJS({
       if (typeof key === "string" && key.startsWith("0x") && key.length === 66) {
         return key;
       }
-      return id(key);
+      return id2(key);
     }
-    module.exports = {
+    module2.exports = {
       normaliseAddress,
       toBytes32Key
     };
@@ -5049,7 +5219,7 @@ var require_helpers = __commonJS({
 
 // src/personal/receipt.js
 var require_receipt = __commonJS({
-  "src/personal/receipt.js"(exports, module) {
+  "src/personal/receipt.js"(exports2, module2) {
     var { Contract, getAddress, solidityPackedKeccak256 } = __require("ethers");
     var ABI = require_abi();
     var { normaliseAddress, toBytes32Key } = require_helpers();
@@ -5067,11 +5237,11 @@ 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());
     }
-    module.exports = {
+    module2.exports = {
       computeReceiptId,
       getReceiptBalance
     };
@@ -5080,7 +5250,7 @@ var require_receipt = __commonJS({
 
 // src/personal/access.js
 var require_access = __commonJS({
-  "src/personal/access.js"(exports, module) {
+  "src/personal/access.js"(exports2, module2) {
     var { uint8arrayToString } = __require("@lit-protocol/uint8arrays");
     var subgraph = require_subgraph();
     var { normaliseAddress, toBytes32Key } = require_helpers();
@@ -5255,7 +5425,7 @@ var require_access = __commonJS({
       }
       return uint8arrayToString(response.decryptedData, "utf8");
     }
-    module.exports = {
+    module2.exports = {
       resolveEncryptedResource,
       decryptWithLit
     };
@@ -5264,7 +5434,7 @@ var require_access = __commonJS({
 
 // src/personal/index.js
 var require_personal = __commonJS({
-  "src/personal/index.js"(exports, module) {
+  "src/personal/index.js"(exports2, module2) {
     var { Interface } = __require("ethers");
     var ABI = require_abi();
     var { normaliseAddress, toBytes32Key } = require_helpers();
@@ -5292,7 +5462,7 @@ var require_personal = __commonJS({
       ]);
       return { to, data, value: 0n };
     }
-    module.exports = {
+    module2.exports = {
       buildCreatePersonalRegistryTx,
       buildSetPriceTx,
       buildBuyTx,
@@ -5304,7 +5474,7 @@ var require_personal = __commonJS({
 
 // src/utils/privateTx.js
 var require_privateTx = __commonJS({
-  "src/utils/privateTx.js"(exports, module) {
+  "src/utils/privateTx.js"(exports2, module2) {
     var axios = __require("axios");
     async function sendPrivateRaw({ privateRpcUrl, signedTx, preferences = {} }) {
       const body = {
@@ -5336,7 +5506,7 @@ var require_privateTx = __commonJS({
       const sent = await signer.sendTransaction(tx);
       return { hash: sent.hash, tx: sent };
     }
-    module.exports = {
+    module2.exports = {
       sendTransaction
     };
   }
@@ -5344,7 +5514,7 @@ var require_privateTx = __commonJS({
 
 // src/utils/safe.js
 var require_safe = __commonJS({
-  "src/utils/safe.js"(exports, module) {
+  "src/utils/safe.js"(exports2, module2) {
     function toSafeTx(tx, opts = {}) {
       const op = Number(opts.operation ?? 0);
       return {
@@ -5360,13 +5530,13 @@ var require_safe = __commonJS({
     function toSafeTxList(txs, opts = {}) {
       return txs.map((t, i) => toSafeTx(t, { ...opts, nonce: opts.nonce != null ? Number(opts.nonce) + i : void 0 }));
     }
-    module.exports = { toSafeTx, toSafeTxList };
+    module2.exports = { toSafeTx, toSafeTxList };
   }
 });
 
 // src/treasury/index.js
 var require_treasury = __commonJS({
-  "src/treasury/index.js"(exports, module) {
+  "src/treasury/index.js"(exports2, module2) {
     var { Contract, Interface, getAddress } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -5447,12 +5617,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),
@@ -5627,17 +5797,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 });
@@ -5679,7 +5849,7 @@ var require_treasury = __commonJS({
       }
       return null;
     }
-    module.exports = {
+    module2.exports = {
       getTreasuryInfo,
       getPendingWithdrawals,
       getCanonicalLiquidityPlans,
@@ -5691,14 +5861,30 @@ 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) };
+      }
     };
   }
 });
 
 // src/boost/index.js
 var require_boost = __commonJS({
-  "src/boost/index.js"(exports, module) {
+  "src/boost/index.js"(exports2, module2) {
     var { Contract, Interface, getAddress } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -5777,7 +5963,7 @@ var require_boost = __commonJS({
       const data = DirectInterface.encodeFunctionData("fund", [Number(proposalId), BigInt(amount ?? 0n)]);
       return { to: addr, data, value: 0n };
     }
-    module.exports = {
+    module2.exports = {
       getMerkleConfig,
       buildMerkleFundTx,
       buildMerkleSetRootTx,
@@ -5790,7 +5976,7 @@ var require_boost = __commonJS({
 
 // src/bounty/index.js
 var require_bounty = __commonJS({
-  "src/bounty/index.js"(exports, module) {
+  "src/bounty/index.js"(exports2, module2) {
     var { Contract, Interface, getAddress, isAddress } = __require("ethers");
     var subdao = require_subdao();
     var governance = require_governance();
@@ -5903,8 +6089,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({
@@ -5922,18 +6108,18 @@ 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 };
     }
-    module.exports = {
+    module2.exports = {
       configureWinnerMode,
       fundFromTreasury,
       approveWinner,
@@ -5942,251 +6128,9 @@ var require_bounty = __commonJS({
   }
 });
 
-// src/bond/index.js
-var require_bond = __commonJS({
-  "src/bond/index.js"(exports, module) {
-    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)
-      };
-    }
-    module.exports = {
-      getInfo,
-      getPrice,
-      getUserStatus,
-      buildDepositTx,
-      buildRedeemTx,
-      getTokenDecimals,
-      getPrincipalAndPayout,
-      estimatePayout,
-      ensurePrincipalAllowance,
-      purchase,
-      redeem
-    };
-  }
-});
-
 // src/utils/provider.js
 var require_provider = __commonJS({
-  "src/utils/provider.js"(exports, module) {
+  "src/utils/provider.js"(exports2, module2) {
     var { JsonRpcProvider } = __require("ethers");
     function assertString(value, name) {
       if (typeof value !== "string" || value.trim().length === 0) {
@@ -6197,7 +6141,7 @@ var require_provider = __commonJS({
       assertString(rpcUrl, "rpcUrl");
       return new JsonRpcProvider(rpcUrl);
     }
-    module.exports = {
+    module2.exports = {
       getProvider,
       assertString
     };
@@ -6206,8 +6150,8 @@ var require_provider = __commonJS({
 
 // src/wallet/index.js
 var require_wallet = __commonJS({
-  "src/wallet/index.js"(exports, module) {
-    var { ethers } = __require("ethers");
+  "src/wallet/index.js"(exports2, module2) {
+    var { ethers: ethers2 } = __require("ethers");
     var { SageSDKError, CODES } = require_errors();
     var { getProvider } = require_provider();
     function isBrowser() {
@@ -6234,7 +6178,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": {
@@ -6243,7 +6187,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": {
@@ -6254,7 +6198,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) {
@@ -6282,7 +6226,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
@@ -6295,7 +6239,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) {
@@ -6314,7 +6258,7 @@ var require_wallet = __commonJS({
     async function connectInjected() {
       return loadSigner("injected");
     }
-    module.exports = {
+    module2.exports = {
       listProviders,
       loadSigner,
       connectInjected,
@@ -6330,7 +6274,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 };
         }
@@ -6342,7 +6286,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 };
         }
       },
@@ -6388,7 +6332,7 @@ var require_wallet = __commonJS({
 
 // src/wallet/session.js
 var require_session = __commonJS({
-  "src/wallet/session.js"(exports, module) {
+  "src/wallet/session.js"(exports2, module2) {
     var DEFAULT_WALLET_TYPE = "cast";
     function resolveWalletType({ config, env = process.env } = {}) {
       const envType = String(env.WALLET_TYPE || "").trim();
@@ -6416,7 +6360,7 @@ var require_session = __commonJS({
         return false;
       }
     }
-    module.exports = {
+    module2.exports = {
       DEFAULT_WALLET_TYPE,
       resolveWalletType,
       shouldAllowInsecurePrivateKey,
@@ -6444,6 +6388,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);
@@ -6578,13 +6548,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";
@@ -6670,14 +6635,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);
@@ -6713,7 +6673,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,
@@ -7675,10 +7635,10 @@ ${error}` : ""}`;
 
 // src/wallet/cdp-manager.js
 var require_cdp_manager = __commonJS({
-  "src/wallet/cdp-manager.js"(exports, module) {
-    var fs = __require("fs");
-    var path = __require("path");
-    var { ethers } = __require("ethers");
+  "src/wallet/cdp-manager.js"(exports2, module2) {
+    var fs2 = __require("fs");
+    var path2 = __require("path");
+    var { ethers: ethers2 } = __require("ethers");
     var MinimalCdpSigner = class {
       constructor(manager, provider) {
         this._mgr = manager;
@@ -7707,7 +7667,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;
@@ -7730,9 +7690,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;
@@ -7742,14 +7702,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 {
@@ -7761,7 +7721,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;
@@ -7775,7 +7735,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 (_) {
           }
         }
@@ -7800,7 +7760,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...");
         }
@@ -7845,14 +7805,14 @@ var require_cdp_manager = __commonJS({
         if (!process.env.SAGE_QUIET_JSON) console.log("\u2705 CDP wallet disconnected");
       }
     };
-    module.exports = CDPWalletManager;
+    module2.exports = CDPWalletManager;
   }
 });
 
 // src/wallet/typed.js
 var require_typed = __commonJS({
-  "src/wallet/typed.js"(exports, module) {
-    var { ethers } = __require("ethers");
+  "src/wallet/typed.js"(exports2, module2) {
+    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 };
@@ -7888,7 +7848,7 @@ var require_typed = __commonJS({
       const typed = { owner, spender, value, nonce, deadline };
       return await signer.signTypedData(domain, PermitTypes, typed);
     }
-    module.exports = {
+    module2.exports = {
       buildGovernorDomain,
       BallotTypes,
       signVoteBySig,
@@ -7901,7 +7861,7 @@ var require_typed = __commonJS({
 
 // src/doppler/index.js
 var require_doppler = __commonJS({
-  "src/doppler/index.js"(exports, module) {
+  "src/doppler/index.js"(exports2, module2) {
     var { createPublicClient, createWalletClient, http } = __require("viem");
     var { privateKeyToAccount } = __require("viem/accounts");
     var { erc20Abi } = __require("viem");
@@ -7969,12 +7929,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") {
@@ -7982,14 +7970,15 @@ var require_doppler = __commonJS({
       }
       throw new Error("Migrate is not supported by the current doppler-sdk version");
     }
-    module.exports = {
+    module2.exports = {
       initDoppler,
       deployDynamicAuction,
       getAuctionStatus,
+      listAuctions,
       buyTokens,
       migrate
     };
-    module.exports.deployStaticAuction = async function deployStaticAuction(sdk, user, p) {
+    module2.exports.deployStaticAuction = async function deployStaticAuction(sdk, user, p) {
       const StaticAuctionBuilder = dopplerLib.StaticAuctionBuilder || dopplerLib.default?.StaticAuctionBuilder;
       if (!StaticAuctionBuilder) throw new Error("StaticAuctionBuilder missing from doppler-sdk");
       const builder = new StaticAuctionBuilder().tokenConfig({ name: p.token.name, symbol: p.token.symbol, tokenURI: p.token.tokenURI }).saleConfig({ initialSupply: p.sale.initialSupply, numTokensToSell: p.sale.numTokensToSell, numeraire: p.sale.numeraire }).poolByTicks({ startTick: p.pool.startTick, endTick: p.pool.endTick, fee: p.pool.fee, numPositions: p.pool.numPositions || 15 }).withUserAddress(user);
@@ -8001,11 +7990,11 @@ var require_doppler = __commonJS({
       const res = await sdk.factory.createStaticAuction(params);
       return res;
     };
-    module.exports.getStaticPoolInfo = async function getStaticPoolInfo(sdk, poolAddress) {
+    module2.exports.getStaticPoolInfo = async function getStaticPoolInfo(sdk, poolAddress) {
       const auction = await sdk.getStaticAuction(poolAddress);
       return auction.getPoolInfo();
     };
-    module.exports.quoteV3ExactIn = async function quoteV3ExactIn(sdk, { tokenIn, tokenOut, amountIn, fee, sqrtPriceLimitX96 = 0n }) {
+    module2.exports.quoteV3ExactIn = async function quoteV3ExactIn(sdk, { tokenIn, tokenOut, amountIn, fee, sqrtPriceLimitX96 = 0n }) {
       return sdk.quoter.quoteExactInputV3({ tokenIn, tokenOut, amountIn, fee, sqrtPriceLimitX96 });
     };
     var WETH_ABI = [
@@ -8013,7 +8002,7 @@ var require_doppler = __commonJS({
       { type: "function", name: "withdraw", stateMutability: "nonpayable", inputs: [{ name: "wad", type: "uint256" }], outputs: [] },
       { type: "function", name: "balanceOf", stateMutability: "view", inputs: [{ name: "a", type: "address" }], outputs: [{ type: "uint256" }] }
     ];
-    module.exports.wrapEthToWethIfNeeded = async function wrapEthToWethIfNeeded({ rpcUrl, chainId, privateKey, weth, owner, minAmount }) {
+    module2.exports.wrapEthToWethIfNeeded = async function wrapEthToWethIfNeeded({ rpcUrl, chainId, privateKey, weth, owner, minAmount }) {
       const chain = getChainById(chainId);
       const accountObj = privateKeyToAccount(privateKey.startsWith("0x") ? privateKey : `0x${privateKey}`);
       const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
@@ -8025,17 +8014,17 @@ var require_doppler = __commonJS({
       await publicClient.waitForTransactionReceipt({ hash });
       return { deposited: needed, hash };
     };
-    module.exports.getDynamicHookInfo = async function getDynamicHookInfo(sdk, hookAddress) {
+    module2.exports.getDynamicHookInfo = async function getDynamicHookInfo(sdk, hookAddress) {
       const auction = await sdk.getDynamicAuction(hookAddress);
       return auction.getHookInfo();
     };
-    module.exports.quoteV4ExactIn = async function quoteV4ExactIn(sdk, { poolKey, zeroForOne, exactAmount, hookData }) {
+    module2.exports.quoteV4ExactIn = async function quoteV4ExactIn(sdk, { poolKey, zeroForOne, exactAmount, hookData }) {
       return sdk.quoter.quoteExactInputV4({ poolKey, zeroForOne, exactAmount, hookData });
     };
     var UR_ABI = [
       { name: "execute", type: "function", stateMutability: "payable", inputs: [{ name: "commands", type: "bytes" }, { name: "inputs", type: "bytes[]" }], outputs: [] }
     ];
-    module.exports.urExecute = async function urExecute({ rpcUrl, chainId, privateKey, universalRouter, commands, inputs, value }) {
+    module2.exports.urExecute = async function urExecute({ rpcUrl, chainId, privateKey, universalRouter, commands, inputs, value }) {
       const chain = getChainById(chainId);
       const accountObj = privateKeyToAccount(privateKey.startsWith("0x") ? privateKey : `0x${privateKey}`);
       const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
@@ -8044,7 +8033,7 @@ var require_doppler = __commonJS({
       const receipt = await publicClient.waitForTransactionReceipt({ hash });
       return { hash, receipt };
     };
-    module.exports.simulateCreateStaticAuction = async function simulateCreateStaticAuction(sdk, builderParams) {
+    module2.exports.simulateCreateStaticAuction = async function simulateCreateStaticAuction(sdk, builderParams) {
       const StaticAuctionBuilder = dopplerLib.StaticAuctionBuilder || dopplerLib.default?.StaticAuctionBuilder;
       if (!StaticAuctionBuilder) throw new Error("StaticAuctionBuilder missing from doppler-sdk");
       const builder = new StaticAuctionBuilder().tokenConfig(builderParams.token).saleConfig(builderParams.sale).poolByTicks(builderParams.pool).withUserAddress(builderParams.userAddress);
@@ -8055,10 +8044,10 @@ var require_doppler = __commonJS({
       const params = builder.build();
       return sdk.factory.simulateCreateStaticAuction(params);
     };
-    module.exports.simulateBundleExactOut = async function simulateBundleExactOut(sdk, createParams, { tokenIn, tokenOut, amount, fee, sqrtPriceLimitX96 = 0n }) {
+    module2.exports.simulateBundleExactOut = async function simulateBundleExactOut(sdk, createParams, { tokenIn, tokenOut, amount, fee, sqrtPriceLimitX96 = 0n }) {
       return sdk.factory.simulateBundleExactOutput(createParams, { tokenIn, tokenOut, amount, fee, sqrtPriceLimitX96 });
     };
-    module.exports.factoryBundle = async function factoryBundle(sdk, createParams, { commands, inputs, value }) {
+    module2.exports.factoryBundle = async function factoryBundle(sdk, createParams, { commands, inputs, value }) {
       return sdk.factory.bundle(createParams, commands, inputs, { value });
     };
     var V3_SWAP_ROUTER_ABI = [
@@ -8085,7 +8074,7 @@ var require_doppler = __commonJS({
         outputs: [{ name: "amountOut", type: "uint256" }]
       }
     ];
-    module.exports.executeV3BuyExactIn = async function executeV3BuyExactIn({
+    module2.exports.executeV3BuyExactIn = async function executeV3BuyExactIn({
       rpcUrl,
       chainId,
       privateKey,
@@ -8140,15 +8129,962 @@ 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"(exports, module) {
+  "src/index.js"(exports2, module2) {
     var pkg = require_package();
     var abi = require_abi();
     var governance = require_governance();
     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();
@@ -8165,7 +9101,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();
@@ -8180,7 +9115,17 @@ var require_src = __commonJS({
         openzeppelin: require_openzeppelin()
       }
     };
-    module.exports = {
+    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,
       abi,
@@ -8198,7 +9143,7 @@ var require_src = __commonJS({
       personal,
       treasury,
       boost,
-      bond,
+      // bond module removed; bonds deprecated in CLI/SDK
       subgraph,
       utils: { ...utils, privateTx, safe },
       bounty,
@@ -8210,6 +9155,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.");