@sage-protocol/sdk 0.0.8 → 0.1.6

package/dist/index.cjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.0.8",
+      version: "0.1.6",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -24,9 +24,21 @@ var require_package = __commonJS({
       exports: {
         ".": {
           types: "./types/index.d.ts",
-          require: "./dist/index.cjs",
+          browser: "./dist/browser/index.mjs",
           import: "./dist/index.mjs",
-          default: "./dist/index.cjs"
+          require: "./dist/index.cjs",
+          default: "./dist/index.mjs"
+        },
+        "./browser": {
+          types: "./types/index.d.ts",
+          import: "./dist/browser/index.mjs",
+          default: "./dist/browser/index.mjs"
+        },
+        "./node": {
+          types: "./types/index.d.ts",
+          import: "./dist/node/index.mjs",
+          require: "./dist/node/index.cjs",
+          default: "./dist/node/index.mjs"
         },
         "./package.json": "./package.json",
         "./types/*": "./types/*"
@@ -37,6 +49,12 @@ var require_package = __commonJS({
         "README.md"
       ],
       sideEffects: false,
+      browser: {
+        fs: false,
+        path: false,
+        os: false,
+        child_process: false
+      },
       repository: {
         type: "git",
         url: "git+https://github.com/sage-protocol/sdk.git"
@@ -226,20 +244,19 @@ var require_abi = __commonJS({
     var PersonalLicenseReceipt = [
       "function balanceOf(address account, uint256 id) view returns (uint256)"
     ];
-    var SageTreasury = [
-      "function totalReserves() view returns (uint256)",
-      "function totalPOL() view returns (uint256)",
-      "function totalDebt() view returns (uint256)",
-      "function canonicalPool() view returns (address)",
-      "function routerOrVault() view returns (address)",
-      "function maxWithdrawalRate() view returns (uint256)",
-      "function emergencyWithdrawalLimit() view returns (uint256)",
-      "function getReserveTokens() view returns (address[])",
-      "function getReserve(address token) view returns (address tokenAddress,uint256 amount,uint256 value,bool isLP,bool isActive)",
-      "function pendingWithdrawals(uint256) view returns (address token,address recipient,uint256 amount,uint256 value,address requester,uint256 balanceBefore,uint256 recipientBalanceBefore,uint256 depositSnapshot,bool isLP,bool isEmergency,bool exists)",
-      "function nextWithdrawalId() view returns (uint256)",
-      "function manualPrices(address token) view returns (uint256 price,uint256 expiresAt,bool active)",
-      "function lpContributions(address,address) view returns (uint256)"
+    var TreasuryWrapper = [
+      "function execute(address,uint256,bytes,bytes32) returns (bool)",
+      "function allowedTargets(address) view returns (bool)",
+      "function allowedSelectors(bytes4) view returns (bool)",
+      "function owners(address) view returns (bool)",
+      "function ownerCount() view returns (uint256)",
+      "function registry() view returns (address)",
+      "event TreasuryAction(address indexed caller, address indexed target, uint256 value, bytes data, bytes32 refId)",
+      "event AllowedTargetUpdated(address indexed target, bool allowed)",
+      "event AllowedSelectorUpdated(bytes4 indexed selector, bool allowed)",
+      "event OwnerAdded(address indexed owner)",
+      "event OwnerRemoved(address indexed owner)",
+      "event TokensSwept(address indexed token, address indexed to, uint256 amount)"
     ];
     var GovernanceBoostMerkle = [
       "function getProposalConfig(uint256) view returns (tuple(uint256 proposalId,address token,uint256 totalAmount,uint64 startTime,uint64 endTime,uint256 merkleRoot))",
@@ -251,29 +268,6 @@ var require_abi = __commonJS({
       "function create(uint256 proposalId, address token, uint256 perVoter, uint256 maxVoters)",
       "function fund(uint256 proposalId, uint256 amount)"
     ];
-    var BondDepository = [
-      // Core getters
-      "function payoutToken() view returns (address)",
-      "function principalToken() view returns (address)",
-      "function treasury() view returns (address)",
-      // Terms
-      "function terms() view returns (tuple(uint256 controlVariable,uint256 minimumPrice,uint256 maxPayout,uint256 maxDebt,uint256 vestingTerm,uint256 fee))",
-      "function totalDebt(address) view returns (uint256)",
-      // Pricing
-      "function bondPrice() view returns (uint256)",
-      "function bondPrice(address) view returns (uint256)",
-      "function bondPriceInUSD() view returns (uint256)",
-      "function currentDebt() view returns (uint256)",
-      "function debtRatio() view returns (uint256)",
-      "function standardizedDebtRatio() view returns (uint256)",
-      // User views
-      "function bondInfo(address) view returns (tuple(uint256 payout,uint256 vesting,uint256 lastBlock,uint256 pricePaid))",
-      "function pendingPayout(address) view returns (uint256)",
-      "function percentVestedFor(address) view returns (uint256)",
-      // Actions
-      "function deposit(uint256 _amount, uint256 _maxPrice) returns (uint256 payout_)",
-      "function redeem(address _recipient, bool _stake) returns (uint256)"
-    ];
     var Events = {
       ProposalCreated: "event ProposalCreated(uint256 id, address proposer, address[] targets, uint256[] values, string[] signatures, bytes[] calldatas, uint256 startBlock, uint256 endBlock, string description)"
     };
@@ -292,10 +286,10 @@ var require_abi = __commonJS({
       PersonalLibraryFacet,
       PersonalMarketplace,
       PersonalLicenseReceipt,
-      SageTreasury,
+      TreasuryWrapper,
+      // Protocol treasury (replaces SageTreasury)
       GovernanceBoostMerkle,
       GovernanceBoostDirect,
-      BondDepository,
       Events
     };
   }
@@ -511,9 +505,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!) {
@@ -701,10 +695,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 {
@@ -752,7 +746,7 @@ var require_ipfs = __commonJS({
   "src/ipfs/index.js"(exports2, module2) {
     var axiosDefault = require("axios");
     var FormData = require("form-data");
-    var { ethers } = require("ethers");
+    var { ethers: ethers2 } = require("ethers");
     var DEFAULT_GATEWAY = "https://ipfs.dev.sageprotocol.io/ipfs";
     function toLowerSafe(value, fallback = "") {
       if (value == null) return fallback;
@@ -807,14 +801,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}`;
@@ -848,7 +842,17 @@ var require_ipfs = __commonJS({
           pinUrl: removeTrailingSlash(options.workerPinUrl || env.SAGE_IPFS_WORKER_PIN_URL || ""),
           warmUrl: removeTrailingSlash(options.workerWarmUrl || env.SAGE_IPFS_WORKER_WARM_URL || ""),
           signer: options.workerSigner || options.signer || null,
-          getAuth: options.workerGetAuth || null
+          getAuth: options.workerGetAuth || null,
+          address: options.workerAddress || env.SAGE_SANDBOX_ADDRESS || "",
+          discoveryEventsPath: options.workerDiscoveryEventsPath || env.SAGE_IPFS_WORKER_DISCOVERY_EVENTS_PATH || "/discover/events",
+          discoveryMcpPath: options.workerDiscoveryMcpPath || env.SAGE_IPFS_WORKER_DISCOVERY_MCP_PATH || "/discover/mcp",
+          discoveryLaunchPath: options.workerDiscoveryLaunchPath || env.SAGE_IPFS_WORKER_DISCOVERY_LAUNCH_PATH || "/discover/launch",
+          discoveryFeedPath: options.workerDiscoveryFeedPath || env.SAGE_IPFS_WORKER_DISCOVERY_FEED_PATH || "/discover",
+          discoveryMetricsPath: options.workerDiscoveryMetricsPath || env.SAGE_IPFS_WORKER_DISCOVERY_METRICS_PATH || "/discover/metrics",
+          governanceReportPath: options.workerGovernanceReportPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REPORT_PATH || "/governance/report",
+          governanceReportsPath: options.workerGovernanceReportsPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REPORTS_PATH || "/governance/reports",
+          governanceReviewPath: options.workerGovernanceReviewPath || env.SAGE_IPFS_WORKER_GOVERNANCE_REVIEW_PATH || "/governance/report/review",
+          governanceBatchPath: options.workerGovernanceBatchPath || env.SAGE_IPFS_WORKER_GOVERNANCE_BATCH_PATH || "/governance/report/batch"
         },
         web3: {
           token: options.web3Token || env.W3S_TOKEN || env.WEB3_STORAGE_TOKEN || ""
@@ -876,7 +880,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")}`;
@@ -892,6 +896,28 @@ var require_ipfs = __commonJS({
         if (kind === "delete" && config.worker.pinUrl) return `${ensureEndsWith(config.worker.pinUrl, "/pin")}/${cid}`;
         throw new Error(`Worker endpoint for ${kind} not configured`);
       }
+      function workerPath(key, fallback) {
+        return ensureLeadingSlash(config.worker[key] || fallback);
+      }
+      function workerEndpoint(key, fallback) {
+        const base = workerBaseUrl();
+        if (!base) throw new Error("worker_base_url_required");
+        return `${base}${workerPath(key, fallback)}`;
+      }
+      async function postWorkerJson(pathKey, fallback, payload = {}, extraHeaders = {}) {
+        const url = workerEndpoint(pathKey, fallback);
+        const { headers, auth } = await buildWorkerAuthHeaders({ ...extraHeaders, "Content-Type": "application/json" });
+        const body = { ...payload };
+        if (auth && body.auth == null) body.auth = auth;
+        const response = await axiosInstance.post(url, body, { headers, timeout: config.timeoutMs });
+        return response?.data;
+      }
+      async function getWorkerJson(pathKey, fallback, params = {}, extraHeaders = {}) {
+        const url = workerEndpoint(pathKey, fallback);
+        const { headers } = await buildWorkerAuthHeaders({ "Accept": "application/json", ...extraHeaders });
+        const response = await axiosInstance.get(url, { headers, params, timeout: config.timeoutMs });
+        return response?.data;
+      }
       async function buildWorkerAuthHeaders(extraHeaders = {}) {
         if (config.worker.token) {
           return { headers: { ...extraHeaders, Authorization: `Bearer ${config.worker.token}` }, auth: null };
@@ -1168,6 +1194,83 @@ var require_ipfs = __commonJS({
         }
         return { provider: null, ok: true };
       }
+      async function recordDiscoveryEvent(event = {}) {
+        if (!event || typeof event !== "object") throw new Error("event required");
+        const promptId = typeof event.promptId === "string" ? event.promptId.trim() : "";
+        if (!promptId) throw new Error("promptId required");
+        const payload = { ...event, promptId };
+        return postWorkerJson("discoveryEventsPath", "/discover/events", payload);
+      }
+      async function recordMcpUsageEvent({ promptId, metadata, address } = {}) {
+        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 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("discoveryLaunchPath", "/discover/launch", payload);
+      }
+      async function submitGovernanceReport(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const promptId = typeof payload.promptId === "string" ? payload.promptId.trim() : "";
+        if (!promptId) throw new Error("promptId required");
+        const body = { promptId };
+        const reporter = payload.address || config.worker.address;
+        if (reporter) body.address = reporter;
+        if (typeof payload.reason === "string") body.reason = payload.reason;
+        if (typeof payload.note === "string") body.note = payload.note;
+        if (payload.weight !== void 0) {
+          const weight = Number(payload.weight);
+          if (Number.isFinite(weight) && weight > 0) body.weight = weight;
+        }
+        return postWorkerJson("governanceReportPath", "/governance/report", body);
+      }
+      async function listGovernanceReports(params = {}) {
+        const query = {};
+        if (params.status) query.status = params.status;
+        if (params.limit !== void 0) query.limit = params.limit;
+        if (params.cursor !== void 0) query.cursor = params.cursor;
+        return getWorkerJson("governanceReportsPath", "/governance/reports", query);
+      }
+      async function reviewGovernanceReport(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload 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: 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);
+      }
+      async function batchGovernanceReports(payload = {}) {
+        if (!payload || typeof payload !== "object") throw new Error("payload required");
+        const ids = Array.isArray(payload.ids) ? payload.ids.map(String).filter(Boolean) : [];
+        if (!ids.length) throw new Error("ids required");
+        const action = typeof payload.action === "string" ? payload.action.trim() : "";
+        if (!action) throw new Error("action required");
+        const body = { ids, action };
+        if (typeof payload.note === "string") body.note = payload.note;
+        return postWorkerJson("governanceBatchPath", "/governance/report/batch", body);
+      }
+      async function fetchDiscovery(params = {}) {
+        const query = {};
+        if (params.filter) query.filter = params.filter;
+        if (params.limit !== void 0) query.limit = params.limit;
+        return getWorkerJson("discoveryFeedPath", "/discover", query);
+      }
+      async function fetchDiscoveryMetrics(params = {}) {
+        return getWorkerJson("discoveryMetricsPath", "/discover/metrics", params);
+      }
       return {
         config,
         hasPinataCreds,
@@ -1180,6 +1283,15 @@ var require_ipfs = __commonJS({
         warmGateways,
         buildGatewayUrls: (cid, extra) => buildGatewayUrls(cid, config.gateway, extra),
         pin,
+        recordDiscoveryEvent,
+        recordMcpUsage: recordMcpUsageEvent,
+        recordLaunchEvent,
+        submitGovernanceReport,
+        listGovernanceReports,
+        reviewGovernanceReport,
+        batchGovernanceReports,
+        fetchDiscovery,
+        fetchDiscoveryMetrics,
         generateCid
       };
     }
@@ -1461,18 +1573,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;
@@ -1498,17 +1610,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 };
@@ -1581,7 +1693,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,
@@ -1614,8 +1726,8 @@ var require_validation = __commonJS({
           seenKeys.add(key);
           const files = Array.isArray(prompt2.files) ? prompt2.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}`,
@@ -1638,7 +1750,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 }];
         }
@@ -1661,7 +1773,7 @@ var require_validation = __commonJS({
 // src/library/index.js
 var require_library = __commonJS({
   "src/library/index.js"(exports2, module2) {
-    var { Contract, getAddress, keccak256, toUtf8Bytes } = require("ethers");
+    var { Contract, getAddress, keccak256, toUtf8Bytes, AbiCoder } = require("ethers");
     var { Interface } = require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -1700,17 +1812,31 @@ var require_library = __commonJS({
         promptCount: Number(promptCount)
       };
     }
+    function _computeLibraryKey(subdao2, libraryId) {
+      const coder = AbiCoder.defaultAbiCoder ? AbiCoder.defaultAbiCoder() : new AbiCoder();
+      const encoded = coder.encode(["address", "string"], [getAddress(subdao2), String(libraryId)]);
+      return keccak256(encoded);
+    }
     async function getLatestLibrary({ provider, registry, subdao: subdao2, libraryId = "main" }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normalise(registry, "registry");
       const sub = normalise(subdao2, "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: subdao2, libraryId = "main", newCid }) {
+      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
+      const addr = normalise(registry, "registry");
+      const sub = normalise(subdao2, "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: subdao2, manifestCID }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
       const addr = normalise(registry, "registry");
@@ -1736,6 +1862,8 @@ var require_library = __commonJS({
       getLatestLibrary,
       hasScopedOwnership,
       buildUpdateLibraryForSubDAOTx,
+      _computeLibraryKey,
+      getBeforeAfterForUpdate,
       /** Build an authorizeTimelock(timelock, subdao) call for a LibraryRegistry. */
       buildAuthorizeTimelockTx: function buildAuthorizeTimelockTx({ registry, timelock: timelock2, subdao: subdao2 }) {
         const to = normalise(registry, "registry");
@@ -1822,11 +1950,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),
@@ -1880,12 +2008,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 {
@@ -1946,10 +2074,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 = "" }) {
@@ -1970,17 +2098,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 [subdao2, 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(subdao2), 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(subdao2), 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);
@@ -2110,6 +2294,7 @@ var require_governance = __commonJS({
       buildExecuteTx,
       buildQueueByIdTx,
       buildExecuteByIdTx,
+      decodeProposalEffects,
       makeProposalDescription,
       stripProposalSalt,
       getQuorumAt,
@@ -2816,7 +3001,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()));
@@ -2826,7 +3011,7 @@ var require_openzeppelin = __commonJS({
             const block = await provider.getBlock(log.blockNumber).catch(() => ({ timestamp: 0 }));
             const quorum = await governance2.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 (_) {
           }
         }
@@ -2834,10 +3019,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,
@@ -3070,9 +3255,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) {
@@ -3094,7 +3279,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) : [];
@@ -3104,7 +3289,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,
@@ -3120,38 +3305,119 @@ var require_operations = __commonJS({
       proposalId,
       refresh = false,
       cache = null,
-      fromBlock = 0
+      fromBlock = 0,
+      helperAddress = null,
+      hints = {},
+      chunkSizeBlocks = 1e4,
+      lookBackBlocks = 2e3,
+      lookAheadBlocks = 2e3
     }) {
       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) {
+        try {
+          const helperAbi = [
+            "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(id2);
+          if (res && res.exists) {
+            const tuple2 = {
+              id: id2,
+              governor: normaliseGovernor(governor),
+              targets: res.targets || [],
+              values: (res.values || []).map((v) => BigInt(v)),
+              calldatas: (res.calldatas || []).map(String),
+              description: "",
+              descriptionHash: res.descriptionHash || null,
+              createdBlock: null
+            };
+            if (cacheAdapter) await cacheAdapter.save(governor, id2, tuple2);
+            return tuple2;
+          }
+        } catch (_) {
+        }
+      }
       let metadata = null;
       try {
-        metadata = await governance2.getProposalMetadata({ provider, governor: govAddr, id });
+        metadata = await governance2.getProposalMetadata({ provider, governor: govAddr, id: id2 });
       } catch (_) {
         metadata = null;
       }
       if (!metadata) {
-        const page = await governance2.listProposals({ provider, governor: govAddr, fromBlock, toBlock: "latest" });
-        metadata = page.find((entry) => {
-          try {
-            return normaliseProposalId(entry.id || entry.proposalId) === id;
-          } catch (_) {
-            return false;
+        let lower = fromBlock || 0;
+        try {
+          const govAbi = new Interface(ABI.Governor);
+          const govC = new Contract(govAddr, govAbi, provider);
+          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);
+            lower = approxCreation > 0 ? approxCreation : 0;
+            const upper = lower + Number(lookAheadBlocks);
+            const from = lower > lookBackBlocks ? lower - Number(lookBackBlocks) : 0;
+            const toBlock = await provider.getBlockNumber();
+            const max = Math.min(upper + Number(lookBackBlocks), Number(toBlock));
+            const topic = govC.interface.getEvent("ProposalCreated").topicHash;
+            for (let start = from; start <= max; start += Number(chunkSizeBlocks)) {
+              const end = Math.min(max, start + Number(chunkSizeBlocks));
+              try {
+                const logs = await provider.getLogs({
+                  address: govAddr,
+                  topics: [topic],
+                  fromBlock: start,
+                  toBlock: end
+                });
+                for (const log of logs) {
+                  try {
+                    const parsed = govC.interface.parseLog(log);
+                    const pid = normaliseProposalId(parsed.args.proposalId);
+                    if (pid === id2) {
+                      metadata = {
+                        id: id2,
+                        governor: govAddr,
+                        targets: Array.from(parsed.args.targets || [], String),
+                        values: Array.from(parsed.args.values || [], (v) => BigInt(v.toString())),
+                        calldatas: Array.from(parsed.args.calldatas || [], (b) => String(b)),
+                        description: String(parsed.args.description || ""),
+                        descriptionHash: governance2.hashDescription ? governance2.hashDescription(String(parsed.args.description || "")) : keccak256(toUtf8Bytes(String(parsed.args.description || ""))),
+                        createdBlock: log.blockNumber
+                      };
+                      break;
+                    }
+                  } catch (_) {
+                  }
+                }
+                if (metadata) break;
+              } catch (_) {
+              }
+            }
           }
-        }) || null;
+        } catch (_) {
+        }
+        if (!metadata) {
+          const page = await governance2.listProposals({ provider, governor: govAddr, fromBlock, toBlock: "latest" });
+          metadata = page.find((entry) => {
+            try {
+              return normaliseProposalId(entry.id || entry.proposalId) === id2;
+            } catch (_) {
+              return false;
+            }
+          }) || null;
+        }
       }
       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;
     }
@@ -3342,10 +3608,11 @@ var require_operations = __commonJS({
       proposalId,
       refresh = false,
       cache = null,
-      includeTimeline = false
+      includeTimeline = false,
+      helperAddress = null
     }) {
       if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const tuple = await resolveProposalTuple({ provider, governor, proposalId, refresh, cache });
+      const tuple = await resolveProposalTuple({ provider, governor, proposalId, refresh, cache, helperAddress });
       let proposal = null;
       try {
         proposal = await governance2.getProposal({ provider, governor: tuple.governor, id: tuple.id });
@@ -3446,6 +3713,91 @@ var require_operations = __commonJS({
   }
 });
 
+// src/governance/grants.js
+var require_grants = __commonJS({
+  "src/governance/grants.js"(exports2, module2) {
+    var { Interface, getAddress, isAddress, parseUnits } = require("ethers");
+    var { SageSDKError, CODES } = require_errors();
+    function normalizeAddress(label, value) {
+      if (!value) throw new SageSDKError(CODES.INVALID_ARGS, `${label} required`);
+      if (!isAddress(value)) throw new SageSDKError(CODES.INVALID_ARGS, `${label} invalid`);
+      return getAddress(value);
+    }
+    async function buildGrantProposal({ provider = null, vault, token: token2, recipient, amount, decimals = null, raw = false, description = null }) {
+      const vaultAddr = normalizeAddress("vault", vault);
+      const tokenAddr = normalizeAddress("token", token2);
+      const rcptAddr = normalizeAddress("recipient", recipient);
+      if (amount == null) throw new SageSDKError(CODES.INVALID_ARGS, "amount required");
+      let resolvedDecimals = decimals != null ? Number(decimals) : null;
+      let symbol = null;
+      if (provider && resolvedDecimals == null) {
+        try {
+          const erc20 = new (require("ethers")).Contract(tokenAddr, ["function decimals() view returns (uint8)", "function symbol() view returns (string)"], provider);
+          resolvedDecimals = Number(await erc20.decimals());
+          symbol = await erc20.symbol().catch(() => null);
+        } catch (_) {
+        }
+      }
+      if (resolvedDecimals == null) resolvedDecimals = 18;
+      let amtWei;
+      if (raw) {
+        amtWei = BigInt(String(amount));
+      } else {
+        amtWei = parseUnits(String(amount), resolvedDecimals);
+      }
+      const iface = new Interface(["function withdraw(address token,uint256 amount,address recipient)"]);
+      const data = iface.encodeFunctionData("withdraw", [tokenAddr, amtWei, rcptAddr]);
+      const targets = [vaultAddr];
+      const values = [0n];
+      const calldatas = [data];
+      const desc = description && description.length ? description : `Grant ${String(amount)}${symbol ? " " + symbol : ""} to ${rcptAddr}`;
+      return { targets, values, calldatas, description: desc };
+    }
+    module2.exports = {
+      buildGrantProposal,
+      /**
+       * Build a batched proposal for multiple grants. Each item can specify its own vault
+       * or inherit from defaultVault. Decimals are resolved per-token when provider is present.
+       * items: Array<{ vault?, token, recipient, amount, decimals?, raw? }>
+       */
+      buildBatchGrantProposal: async function buildBatchGrantProposal({ provider = null, items = [], defaultVault = null, description = null }) {
+        if (!Array.isArray(items) || items.length === 0) {
+          throw new SageSDKError(CODES.INVALID_ARGS, "items required");
+        }
+        const targets = [];
+        const values = [];
+        const calldatas = [];
+        const iface = new Interface(["function withdraw(address token,uint256 amount,address recipient)"]);
+        for (const [i, it] of items.entries()) {
+          const vault = it.vault || defaultVault;
+          if (!vault) throw new SageSDKError(CODES.INVALID_ARGS, `item[${i}]: vault missing and no defaultVault provided`);
+          const vaultAddr = normalizeAddress("vault", vault);
+          const tokenAddr = normalizeAddress("token", it.token);
+          const rcptAddr = normalizeAddress("recipient", it.recipient);
+          let resolvedDecimals = it.decimals != null ? Number(it.decimals) : null;
+          if (provider && resolvedDecimals == null && !it.raw) {
+            try {
+              const erc20 = new (require("ethers")).Contract(tokenAddr, ["function decimals() view returns (uint8)"], provider);
+              resolvedDecimals = Number(await erc20.decimals());
+            } catch (_) {
+            }
+          }
+          if (resolvedDecimals == null) resolvedDecimals = 18;
+          let amtWei;
+          if (it.raw) amtWei = BigInt(String(it.amount));
+          else amtWei = parseUnits(String(it.amount), resolvedDecimals);
+          const data = iface.encodeFunctionData("withdraw", [tokenAddr, amtWei, rcptAddr]);
+          targets.push(vaultAddr);
+          values.push(0n);
+          calldatas.push(data);
+        }
+        const desc = description && description.length ? description : `Batch Grants: ${items.length} transfer(s)`;
+        return { targets, values, calldatas, description: desc };
+      }
+    };
+  }
+});
+
 // src/timelock/index.js
 var require_timelock = __commonJS({
   "src/timelock/index.js"(exports2, module2) {
@@ -3508,8 +3860,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),
@@ -3531,7 +3883,7 @@ var require_timelock = __commonJS({
           } else if (parsed.name === "Cancelled") {
             op.cancelled = true;
           }
-          operations.set(id, op);
+          operations.set(id2, op);
         } catch (err) {
           continue;
         }
@@ -3554,10 +3906,10 @@ var require_timelock = __commonJS({
         ]);
         return { to, data: payload, value: 0n };
       },
-      buildCancelTx: ({ timelock: timelock2, id }) => {
-        if (!id) throw new SageSDKError(CODES.INVALID_ARGS, "operation id required");
+      buildCancelTx: ({ timelock: timelock2, id: id2 }) => {
+        if (!id2) throw new SageSDKError(CODES.INVALID_ARGS, "operation id required");
         const addr = normalise(timelock2, "timelock");
-        const payload = TimelockInterface.encodeFunctionData("cancel", [id]);
+        const payload = TimelockInterface.encodeFunctionData("cancel", [id2]);
         return { to: addr, data: payload, value: 0n };
       },
       buildExecuteTx: ({ timelock: timelock2, target, value = 0n, data = "0x", predecessor = "0x0000000000000000000000000000000000000000000000000000000000000000", salt = "0x0000000000000000000000000000000000000000000000000000000000000000" }) => {
@@ -3666,10 +4018,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]),
@@ -4124,8 +4476,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 }));
       }
@@ -4137,8 +4489,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 }));
       }
@@ -4150,8 +4502,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 }));
       }
@@ -4163,8 +4515,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 }));
       }
@@ -4254,9 +4606,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();
@@ -4351,10 +4703,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 errors2 = [];
       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);
@@ -4376,7 +4728,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 = errors2;
       throw failure;
     }
@@ -4803,7 +5155,7 @@ var require_token = __commonJS({
 // src/personal/helpers.js
 var require_helpers = __commonJS({
   "src/personal/helpers.js"(exports2, module2) {
-    var { getAddress, ZeroAddress, id } = require("ethers");
+    var { getAddress, ZeroAddress, id: id2 } = require("ethers");
     function normaliseAddress(addr, label) {
       if (!addr) throw new Error(`[personal] missing ${label}`);
       const value = addr.toString();
@@ -4814,7 +5166,7 @@ var require_helpers = __commonJS({
       if (typeof key === "string" && key.startsWith("0x") && key.length === 66) {
         return key;
       }
-      return id(key);
+      return id2(key);
     }
     module2.exports = {
       normaliseAddress,
@@ -4843,8 +5195,8 @@ var require_receipt = __commonJS({
       const receiptAddress = normaliseAddress(receipt, "receipt");
       const holderAddress = normaliseAddress(holder, "holder");
       const contract = new Contract(receiptAddress, ABI.PersonalLicenseReceipt, provider);
-      const id = typeof receiptId === "bigint" ? receiptId : BigInt(receiptId);
-      const balance = await contract.balanceOf(holderAddress, id);
+      const id2 = typeof receiptId === "bigint" ? receiptId : BigInt(receiptId);
+      const balance = await contract.balanceOf(holderAddress, id2);
       return typeof balance === "bigint" ? balance : BigInt(balance.toString());
     }
     module2.exports = {
@@ -5223,12 +5575,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 [token2, recipient, amount, value, requester, balanceBefore, recipientBalanceBefore, depositSnapshot, isLP, isEmergency] = entry;
         withdrawals.push({
-          id: Number(id),
+          id: Number(id2),
           token: token2 && token2 !== ZERO_ADDRESS ? getAddress(token2) : null,
           recipient: recipient && recipient !== ZERO_ADDRESS ? getAddress(recipient) : null,
           amount: toBigInt(amount),
@@ -5403,17 +5755,17 @@ var require_treasury = __commonJS({
         id: parsed?.id != null ? Number(parsed.id) : null
       };
     }
-    async function confirmWithdrawal({ signer, treasury: treasury2, id, waitMs }) {
+    async function confirmWithdrawal({ signer, treasury: treasury2, id: id2, waitMs }) {
       const contract = createWriteContract({ signer, treasury: treasury2 });
-      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: treasury2, id, waitMs }) {
+    async function cancelWithdrawal({ signer, treasury: treasury2, id: id2, waitMs }) {
       const contract = createWriteContract({ signer, treasury: treasury2 });
-      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: treasury2, token: token2, price, ttlSeconds, waitMs }) {
       const contract = createWriteContract({ signer, treasury: treasury2 });
@@ -5467,7 +5819,23 @@ var require_treasury = __commonJS({
       confirmWithdrawal,
       cancelWithdrawal,
       setPriceOverride,
-      clearPriceOverride
+      clearPriceOverride,
+      // TX builders for app usage
+      buildApproveTx: ({ token: token2, spender, amount, decimals = 18 }) => {
+        if (!token2 || !spender) throw new SageSDKError(CODES.INVALID_ARGS, "token and spender required");
+        const iface = new Interface(["function approve(address,uint256)"]);
+        return { to: getAddress(token2), data: iface.encodeFunctionData("approve", [getAddress(spender), BigInt(amount.toString ? amount.toString() : amount)]), value: 0n };
+      },
+      buildTransferTx: ({ token: token2, to, amount, decimals = 18 }) => {
+        if (!token2 || !to) throw new SageSDKError(CODES.INVALID_ARGS, "token and to required");
+        const iface = new Interface(["function transfer(address,uint256)"]);
+        return { to: getAddress(token2), 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) };
+      }
     };
   }
 });
@@ -5679,8 +6047,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({
@@ -5698,14 +6066,14 @@ var require_bounty = __commonJS({
       const context = await subdao2.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 = governance2.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 };
     }
@@ -5718,248 +6086,6 @@ var require_bounty = __commonJS({
   }
 });
 
-// src/bond/index.js
-var require_bond = __commonJS({
-  "src/bond/index.js"(exports2, module2) {
-    var {
-      Contract,
-      Interface,
-      MaxUint256,
-      WeiPerEther,
-      formatUnits,
-      getAddress,
-      parseUnits
-    } = require("ethers");
-    var ABI = require_abi();
-    var { SageSDKError, CODES } = require_errors();
-    function normalise(address, label) {
-      if (!address) throw new SageSDKError(CODES.INVALID_ARGS, `${label} required`);
-      try {
-        return getAddress(address);
-      } catch (err) {
-        throw new SageSDKError(CODES.INVALID_ARGS, `invalid ${label}`, { cause: err });
-      }
-    }
-    var ERC20 = [
-      "function decimals() view returns (uint8)",
-      "function allowance(address owner, address spender) view returns (uint256)",
-      "function approve(address spender, uint256 value) returns (bool)",
-      "function balanceOf(address) view returns (uint256)"
-    ];
-    var BondInterface = new Interface(ABI.BondDepository);
-    async function getInfo({ provider, bond: bond2 }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const addr = normalise(bond2, "bond");
-      const c = new Contract(addr, ABI.BondDepository, provider);
-      const [terms, price, priceUsd, totalDebt, payoutToken, principalToken, treasury2] = 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: treasury2,
-        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: bond2 }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const c = new Contract(normalise(bond2, "bond"), ABI.BondDepository, provider);
-      return c.bondPrice();
-    }
-    async function getUserStatus({ provider, bond: bond2, user }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const addr = normalise(bond2, "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: bond2, amount, maxPrice }) {
-      const to = normalise(bond2, "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: bond2, recipient, stake = false }) {
-      const to = normalise(bond2, "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: token2 }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const c = new Contract(normalise(token2, "token"), ERC20, provider);
-      const d = await c.decimals().catch(() => 18);
-      return Number(d);
-    }
-    async function getPrincipalAndPayout({ provider, bond: bond2 }) {
-      if (!provider) throw new SageSDKError(CODES.INVALID_ARGS, "provider required");
-      const c = new Contract(normalise(bond2, "bond"), ABI.BondDepository, provider);
-      const [payoutToken, principalToken] = await Promise.all([
-        c.payoutToken(),
-        c.principalToken()
-      ]);
-      return { payoutToken, principalToken };
-    }
-    async function estimatePayout({ provider, bond: bond2, 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: bond2 });
-      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: bond2 });
-      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: bond2, 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(bond2, "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: bond2, 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(bond2, "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: bond2, 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(bond2, "bond");
-      const user = normalise(recipient || await signer.getAddress(), "recipient");
-      const bondContract = new Contract(bondAddress, ABI.BondDepository, signer);
-      const { payoutToken } = await getPrincipalAndPayout({ provider, bond: bondAddress });
-      const payoutDec = await getTokenDecimals({ provider, token: payoutToken });
-      const pending = await bondContract.pendingPayout(user);
-      if (pending === 0n) {
-        return {
-          transactionHash: null,
-          redeemed: "0",
-          message: "No bonds available for redemption"
-        };
-      }
-      const tx = await bondContract.redeem(user, !!stake);
-      const receipt = await tx.wait();
-      return {
-        transactionHash: receipt.hash ?? tx.hash ?? null,
-        redeemed: formatUnits(pending, payoutDec)
-      };
-    }
-    module2.exports = {
-      getInfo,
-      getPrice,
-      getUserStatus,
-      buildDepositTx,
-      buildRedeemTx,
-      getTokenDecimals,
-      getPrincipalAndPayout,
-      estimatePayout,
-      ensurePrincipalAllowance,
-      purchase,
-      redeem
-    };
-  }
-});
-
 // src/utils/provider.js
 var require_provider = __commonJS({
   "src/utils/provider.js"(exports2, module2) {
@@ -5983,7 +6109,7 @@ var require_provider = __commonJS({
 // src/wallet/index.js
 var require_wallet = __commonJS({
   "src/wallet/index.js"(exports2, module2) {
-    var { ethers } = require("ethers");
+    var { ethers: ethers2 } = require("ethers");
     var { SageSDKError, CODES } = require_errors();
     var { getProvider } = require_provider();
     function isBrowser() {
@@ -6010,7 +6136,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": {
@@ -6019,7 +6145,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": {
@@ -6030,7 +6156,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) {
@@ -6058,7 +6184,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 wallet2 = ethers.Wallet.createRandom();
+      const wallet2 = ethers2.Wallet.createRandom();
       return {
         address: wallet2.address,
         // Intentionally do not expose privateKey by default to avoid accidental leaks
@@ -6071,7 +6197,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 wallet2 = new ethers.Wallet(pk);
+      const wallet2 = new ethers2.Wallet(pk);
       return { address: wallet2.address, _wallet: wallet2 };
     }
     function exportWallet(w) {
@@ -6106,7 +6232,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 wallet2 = ethers.HDNodeWallet.fromPhrase(opts.mnemonic, opts.path);
+          const wallet2 = ethers2.HDNodeWallet.fromPhrase(opts.mnemonic, opts.path);
           const signer = wallet2.connect(provider);
           return { signer, provider };
         }
@@ -6118,7 +6244,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 };
         }
       },
@@ -6203,7 +6329,7 @@ var require_session = __commonJS({
 
 // src/wallet/cast-manager.js
 var require_cast_manager = __commonJS({
-  "src/wallet/cast-manager.js"(exports2, module2) {
+  "src/wallet/cast-manager.js"(exports, module) {
     var { spawn } = require("child_process");
     var { ethers } = require("ethers");
     var fs = require("fs");
@@ -6220,6 +6346,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);
@@ -6354,13 +6506,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";
@@ -6446,14 +6593,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);
@@ -6489,7 +6631,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,
@@ -7445,16 +7587,16 @@ ${error}` : ""}`;
         return fullPath;
       }
     };
-    module2.exports = CastWalletManager;
+    module.exports = CastWalletManager;
   }
 });
 
 // src/wallet/cdp-manager.js
 var require_cdp_manager = __commonJS({
   "src/wallet/cdp-manager.js"(exports2, module2) {
-    var fs = require("fs");
-    var path = require("path");
-    var { ethers } = require("ethers");
+    var fs2 = require("fs");
+    var path2 = require("path");
+    var { ethers: ethers2 } = require("ethers");
     var MinimalCdpSigner = class {
       constructor(manager, provider) {
         this._mgr = manager;
@@ -7483,7 +7625,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;
@@ -7506,9 +7648,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;
@@ -7518,14 +7660,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 {
@@ -7537,7 +7679,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;
@@ -7551,7 +7693,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 (_) {
           }
         }
@@ -7576,7 +7718,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...");
         }
@@ -7628,7 +7770,7 @@ var require_cdp_manager = __commonJS({
 // src/wallet/typed.js
 var require_typed = __commonJS({
   "src/wallet/typed.js"(exports2, module2) {
-    var { ethers } = require("ethers");
+    var { ethers: ethers2 } = require("ethers");
     function buildGovernorDomain({ name, chainId, verifyingContract }) {
       if (!name || !chainId || !verifyingContract) throw new Error("name, chainId, verifyingContract required");
       return { name, version: "1", chainId: Number(chainId), verifyingContract };
@@ -7745,12 +7887,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") {
@@ -7762,6 +7932,7 @@ var require_doppler = __commonJS({
       initDoppler,
       deployDynamicAuction,
       getAuctionStatus,
+      listAuctions,
       buyTokens,
       migrate
     };
@@ -7923,6 +8094,7 @@ 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();
@@ -7939,7 +8111,6 @@ var safe = require_safe();
 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();
@@ -7972,7 +8143,7 @@ module.exports = {
   personal,
   treasury,
   boost,
-  bond,
+  // bond module removed; bonds deprecated in CLI/SDK
   subgraph,
   utils: { ...utils, privateTx, safe },
   bounty,