@sage-protocol/sdk 0.1.2 → 0.1.6

package/dist/browser/index.mjs

@@ -20,7 +20,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.1.2",
+      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",
@@ -250,20 +250,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))",
@@ -275,29 +274,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)"
     };
@@ -316,10 +292,10 @@ var require_abi = __commonJS({
       PersonalLibraryFacet,
       PersonalMarketplace,
       PersonalLicenseReceipt,
-      SageTreasury,
+      TreasuryWrapper,
+      // Protocol treasury (replaces SageTreasury)
       GovernanceBoostMerkle,
       GovernanceBoostDirect,
-      BondDepository,
       Events
     };
   }
@@ -1803,7 +1779,7 @@ 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");
+    var { Contract, getAddress, keccak256, toUtf8Bytes, AbiCoder } = __require("ethers");
     var { Interface } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
@@ -1842,17 +1818,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");
@@ -1878,6 +1868,8 @@ var require_library = __commonJS({
       getLatestLibrary,
       hasScopedOwnership,
       buildUpdateLibraryForSubDAOTx,
+      _computeLibraryKey,
+      getBeforeAfterForUpdate,
       /** Build an authorizeTimelock(timelock, subdao) call for a LibraryRegistry. */
       buildAuthorizeTimelockTx: function buildAuthorizeTimelockTx({ registry, timelock, subdao }) {
         const to = normalise(registry, "registry");
@@ -2123,6 +2115,62 @@ var require_governance = __commonJS({
       const data = iface.encodeFunctionData("execute(uint256)", [id]);
       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 id = 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()) === id) {
+            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: id, 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);
@@ -2252,6 +2300,7 @@ var require_governance = __commonJS({
       buildExecuteTx,
       buildQueueByIdTx,
       buildExecuteByIdTx,
+      decodeProposalEffects,
       makeProposalDescription,
       stripProposalSalt,
       getQuorumAt,
@@ -4091,7 +4140,7 @@ var require_factory = __commonJS({
 // src/browser/library.js
 var require_library2 = __commonJS({
   "src/browser/library.js"(exports, module) {
-    var { Contract, getAddress, keccak256, toUtf8Bytes, Interface } = __require("ethers");
+    var { Contract, getAddress, keccak256, AbiCoder, Interface } = __require("ethers");
     var ABI = require_abi();
     var { SageSDKError, CODES } = require_errors();
     var { searchRegistry } = require_search();
@@ -4128,12 +4177,17 @@ var require_library2 = __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 });
@@ -4158,6 +4212,15 @@ var require_library2 = __commonJS({
       ]);
       return { to, data, value: 0n };
     }
+    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) };
+    }
     function buildAuthorizeTimelockTx({ registry, timelock, subdao }) {
       const to = normalise(registry, "registry");
       const iface = new Interface(["function authorizeTimelock(address,address)"]);
@@ -4170,6 +4233,7 @@ var require_library2 = __commonJS({
       getLatestLibrary,
       hasScopedOwnership,
       buildUpdateLibraryForSubDAOTx,
+      getBeforeAfterForUpdate,
       buildAuthorizeTimelockTx,
       searchRegistry
     };
@@ -5779,7 +5843,23 @@ var require_treasury = __commonJS({
       confirmWithdrawal,
       cancelWithdrawal,
       setPriceOverride,
-      clearPriceOverride
+      clearPriceOverride,
+      // TX builders for app usage
+      buildApproveTx: ({ token, spender, amount, decimals = 18 }) => {
+        if (!token || !spender) throw new SageSDKError(CODES.INVALID_ARGS, "token and spender required");
+        const iface = new Interface(["function approve(address,uint256)"]);
+        return { to: getAddress(token), data: iface.encodeFunctionData("approve", [getAddress(spender), BigInt(amount.toString ? amount.toString() : amount)]), value: 0n };
+      },
+      buildTransferTx: ({ token, to, amount, decimals = 18 }) => {
+        if (!token || !to) throw new SageSDKError(CODES.INVALID_ARGS, "token and to required");
+        const iface = new Interface(["function transfer(address,uint256)"]);
+        return { to: getAddress(token), data: iface.encodeFunctionData("transfer", [getAddress(to), BigInt(amount.toString ? amount.toString() : amount)]), value: 0n };
+      },
+      buildWrapEthTx: ({ weth, amountWei }) => {
+        if (!weth) throw new SageSDKError(CODES.INVALID_ARGS, "weth required");
+        const iface = new Interface(["function deposit() payable"]);
+        return { to: getAddress(weth), data: iface.encodeFunctionData("deposit", []), value: BigInt(amountWei.toString ? amountWei.toString() : amountWei) };
+      }
     };
   }
 });
@@ -6120,12 +6200,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") {
@@ -6137,6 +6245,7 @@ var require_doppler = __commonJS({
       initDoppler,
       deployDynamicAuction,
       getAuctionStatus,
+      listAuctions,
       buyTokens,
       migrate
     };