@sage-protocol/sdk 0.1.18 → 0.1.23

package/README.md

@@ -62,6 +62,7 @@ Module Overview
 | `timelock` | Min delay, queued operation inspection, schedule/cancel builders | Safe workflows, monitoring |
 | `factory` | Config reads, template enumeration, SubDAO create/fork builders | Launch tooling, analytics |
 | `library` | Manifest listings & scoped ownership checks | Prompt library browsers |
+| `lineage` | Library fork ancestry, per-library fork fees | Fork tracking, royalty analytics |
 | `prompt` | Prompt metadata, fork counts, usage counters | UI prompt catalogues, agent prompt selection |
 | `ipfs` | Upload helpers + discovery/governance worker APIs | CLI sandbox, dashboards, worker automation |
 | `subdao` | Discovery, staking helpers, per-user stats | SubDAO directories, onboarding |
@@ -371,6 +372,8 @@ Important
 Deprecations
 ------------
 - `resolveGovernanceContext` is still exported for compatibility but now logs a deprecation warning. Use the richer `governance` + `subdao` helpers instead.
+- **Prompt-level forking** is deprecated. On-chain prompt forking via `SubDAO.forkPrompt()` and `SubDAO.forkPromptWithStable()` is no longer supported. Use `forked_from` metadata in prompt frontmatter instead. Library-level forks (entire SubDAOs) remain fully supported via the factory.
+- **Prompt fork fees** (stable fee configuration for prompt forks) have been removed. Per-library SXXX fork fees are now the standard model for monetizing library forks. See the `lineage` module documentation above.
 
 Next Phases
 -----------
@@ -402,7 +405,7 @@ const mapped = await sdk.factory.getSubDAORegistry({ provider, factory, subdao }
 
 Registry preflight as timelock
 ```js
-const { to, data } = sdk.library.buildUpdateLibraryForSubDAOTx({ registry, subdao, manifestCID, promptCount, libraryId: 'main' });
+const { to, data } = sdk.library.buildUpdateLibraryTx({ registry, subdao, manifestCID, version: '1.0.0' });
 const sim = await sdk.library.simulateAsTimelock({ provider, registry, to, data, timelock });
 if (!sim.ok) throw new Error(`registry preflight failed: ${sim.error?.message}`);
 ```
@@ -649,6 +652,100 @@ const profileCid = 'bafy...'; // CID of dao-profile.json on IPFS
 const { to, data, value } = sdk.subdao.buildSetProfileCidTx({ subdao: res.subdao, profileCid });
 // Example: schedule via timelock or propose via Governor, depending on your governance mode
 ```
+
+# Library Lineage and Fork Fees
+
+The `lineage` module provides helpers for tracking library fork relationships and per-library SXXX fork fees.
+
+## Fork Ancestry
+
+Libraries can be forked from other libraries. The `lineage` module tracks this ancestry:
+
+```js
+import sdk from '@sage-protocol/sdk';
+
+const provider = sdk.getProvider({ rpcUrl: process.env.RPC_URL });
+const registry = '0xLibraryRegistry';
+const subdao = '0xSubDAO';
+
+// Check if a library was forked from another
+const isFork = await sdk.lineage.isFork({ provider, registry, subdao });
+// → true if this library has a parent
+
+// Get the parent library (null if original)
+const parent = await sdk.lineage.getParentLibrary({ provider, registry, subdao });
+// → '0xParentSubDAO' or null
+
+// Get full ancestry chain from root to current
+const chain = await sdk.lineage.getLineageChain({ provider, registry, subdao });
+// → { chain: ['0xRoot', '0xChild', '0xGrandchild'], depth: 2, root: '0xRoot' }
+```
+
+## Per-Library Fork Fees
+
+Library owners can set an SXXX fee for forking their library. This fee is paid by the forker to the parent library's treasury when creating a forked SubDAO.
+
+```js
+// Get the SXXX fork fee for a library (0n = free fork)
+const fee = await sdk.lineage.getLibraryForkFee({ provider, registry, subdao });
+// → 1000000000000000000n (1 SXXX in wei)
+
+// Get comprehensive library info including fork fee
+const info = await sdk.lineage.getLibraryInfo({ provider, registry, subdao });
+// → {
+//     parentDAO: '0xParent' | null,
+//     forkFee: 1000000000000000000n,
+//     manifestCID: 'Qm...',
+//     version: '1.0.0'
+//   }
+```
+
+## Setting Fork Fees (via Governance)
+
+Fork fees can only be set by the library's timelock. This is typically done through a governance proposal:
+
+```js
+import { ethers } from 'ethers';
+
+// Build the setLibraryForkFee transaction (for use in a proposal)
+const registryIface = new ethers.Interface([
+  'function setLibraryForkFee(address dao, uint256 fee)'
+]);
+
+const feeInWei = ethers.parseUnits('10', 18); // 10 SXXX
+const calldata = registryIface.encodeFunctionData('setLibraryForkFee', [subdao, feeInWei]);
+
+// Include in a governance proposal
+const proposeTx = sdk.governance.buildProposeTx({
+  governor,
+  targets: [registry],
+  values: [0n],
+  calldatas: [calldata],
+  descriptionOrHash: 'Set library fork fee to 10 SXXX'
+});
+```
+
+## Fork Fee Flow
+
+When a SubDAO is forked via the factory:
+
+1. Factory reads the parent library's fork fee from LibraryRegistry
+2. If fee > 0, SXXX is transferred from forker to parent's treasury
+3. `LibraryForkFeePaid(parentDAO, forker, amount)` event is emitted
+4. Fork proceeds with standard SubDAO creation
+
+Note: Forkers must approve SXXX to the factory before forking a library with a fee set.
+
+## Deprecation: Prompt-Level Forks
+
+On-chain prompt forking is deprecated. Prompt forks are now tracked via metadata only:
+
+1. Add `forked_from: <original-cid>` to your prompt frontmatter
+2. Upload the new prompt to IPFS
+3. Register via governance proposal
+
+Library-level forks (entire SubDAOs) continue to work and are tracked via `LibraryRegistry.registerForkedDAO()`.
+
 # Governance Adapter (OpenZeppelin)
 
 Normalize proposals/timelines across OZ governors with a compact adapter, inspired by Boardroom’s pattern.

package/dist/browser/index.mjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.1.18",
+      version: "0.1.23",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -119,7 +119,12 @@ var require_abi = __commonJS({
       "function userForkCount(address) view returns (uint256)",
       "function forkCount(string) view returns (uint256)",
       "function stake(uint256)",
-      "function unstake(uint256)"
+      "function unstake(uint256)",
+      // Fork functions
+      "function forkSubDAO(string,string)",
+      "function forkSubDAO(string,string,bool)",
+      "function forkSubDAOWithStable(string,string,(uint256,uint256,uint8,bytes32,bytes32))",
+      "function forkSubDAOWithStable(string,string,(uint256,uint256,uint8,bytes32,bytes32),bool)"
     ];
     var Factory = [
       "event SubDAOGovernanceDeployed(address indexed subDAO, address indexed governor, address timelock, address treasury)"
@@ -130,7 +135,6 @@ var require_abi = __commonJS({
       "function stableCreationFee() view returns (uint256)",
       "function stableFeeReceiver() view returns (address)",
       "function stableCreationEnabled() view returns (bool)",
-      "function stablePromptForkFee() view returns (uint256)",
       "function stableForkFee() view returns (uint256)",
       // Core factory reads
       "function timelockMinDelay() view returns (uint256)",
@@ -160,8 +164,8 @@ var require_abi = __commonJS({
       "function createSubDAOOperatorWithStableAdvanced(string name, string description, uint8 accessModel, uint256 minStakeAmount, address operatorExecutor, address operatorAdmin, bool anyoneExec, bool governorProposer, (uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s) permit) returns (address subDAO, address registry)",
       "function createSubDAOOperator(string name, string description, uint8 accessModel, uint256 minStakeAmount, uint256 burnAmount, address operatorExecutor, address operatorAdmin) returns (address subDAO, address registry)",
       "function createSubDAOOperatorAdvanced(string name, string description, uint8 accessModel, uint256 minStakeAmount, uint256 burnAmount, address operatorExecutor, address operatorAdmin, bool anyoneExec, bool governorProposer) returns (address subDAO, address registry)",
-      "function createForkedSubDAO(string newName, string newDescription, string originalName, address originalSubDAO, address forker) returns (address subDAO, address registry)",
-      "function createForkedSubDAOWithStable(string newName, string newDescription, string originalName, address originalSubDAO, address forker, uint64 authorizationNonce, (uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s) permit) returns (address subDAO, address registry)"
+      "function createForkedSubDAO(string newName, string newDescription, string originalName, address originalSubDAO, address forker, bool copyLibrary) returns (address subDAO, address registry)",
+      "function createForkedSubDAOWithStable(string newName, string newDescription, string originalName, address originalSubDAO, address forker, uint64 authorizationNonce, (uint256 value,uint256 deadline,uint8 v,bytes32 r,bytes32 s) permit, bool copyLibrary) returns (address subDAO, address registry)"
     ];
     var TemplateModule = [
       "function getActiveTemplates() view returns (uint256[])",
@@ -172,13 +176,19 @@ var require_abi = __commonJS({
       "function maxCreationBurn() view returns (uint256)"
     ];
     var LibraryRegistry = [
-      "function libraryByDAO(address) view returns (string manifestCID, address lastUpdater, uint256 lastUpdated, string version)",
+      "function libraryByDAO(address) view returns (string manifestCID, address lastUpdater, uint256 lastUpdated, string version, address forkedFromDAO, uint256 sxxxForkFee)",
       "function daoTimelock(address) view returns (address)",
-      "function getLibrary(address) view returns (tuple(string manifestCID, address lastUpdater, uint256 lastUpdated, string version))",
+      "function getLibrary(address) view returns (tuple(string manifestCID, address lastUpdater, uint256 lastUpdated, string version, address forkedFromDAO, uint256 sxxxForkFee))",
+      "function getLibraryForkFee(address dao) view returns (uint256)",
+      "function setLibraryForkFee(address dao, uint256 fee)",
       "function updateLibrary(address dao, string manifestCID, string version)",
       "function registerDAO(address dao, address timelock)",
+      "function registerForkedDAO(address childDAO, address childTimelock, address parentDAO, string manifestCID, string version)",
+      "function initializeLibraryFromFork(address sourceDao, address forkedDao)",
       "event LibraryUpdated(address indexed dao, string manifestCID, address indexed timelock, string version)",
-      "event DAORegistered(address indexed dao, address indexed timelock)"
+      "event DAORegistered(address indexed dao, address indexed timelock)",
+      "event LibraryForked(address indexed sourceDao, address indexed forkedDao, string manifestCID)",
+      "event LibraryForkFeeUpdated(address indexed dao, uint256 fee)"
     ];
     var PromptRegistry = [
       "function prompts(string key) view returns (string cid, uint256 version, uint256 timestamp, address author, string forkedFromCID, address originalAuthor, bool isFork, uint256 forkDepth)",
@@ -1103,19 +1113,37 @@ var require_subgraph = __commonJS({
           updatedAt: Number(p.updatedAt || 0)
         };
       },
-      async getProposalById({ url, id }) {
+      async getProposalById({ url, id, governor }) {
         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 p = data?.proposal;
+        let p = null;
+        if (governor) {
+          const govLower = String(governor).toLowerCase();
+          const compositeId = `${govLower}-${String(id)}`;
+          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: compositeId });
+          p = data?.proposal;
+        }
+        if (!p && governor) {
+          const govLower = String(governor).toLowerCase();
+          const doc = `query($gov: Bytes!, $first: Int!){ proposals(where:{governor:$gov}, first:$first, orderBy:createdAt, orderDirection:desc){ id proposer description createdAt updatedAt state eta targets values calldatas } }`;
+          const data = await query(url, doc, { gov: govLower, first: 100 });
+          const proposals = data?.proposals || [];
+          p = proposals.find((prop) => {
+            const parts = String(prop.id || "").split("-");
+            const propId = parts.length > 1 ? parts[parts.length - 1] : prop.id;
+            return String(propId) === String(id) || propId && String(BigInt(propId)) === String(BigInt(id));
+          });
+        }
         if (!p) return null;
         try {
           const proposer = safeGetAddress(p.proposer);
           if (!proposer) return null;
           const targets = (p.targets || []).map((t) => safeGetAddress(t)).filter(Boolean);
           if (!targets.length && (p.targets || []).length) return null;
+          const idParts = String(p.id || "").split("-");
+          const actualId = idParts.length > 1 ? idParts[idParts.length - 1] : p.id;
           return {
-            id: BigInt(p.id),
+            id: BigInt(actualId),
             proposer,
             description: p.description || "",
             createdAt: Number(p.createdAt || 0),
@@ -1383,7 +1411,6 @@ var require_ipfs = __commonJS({
             headers["X-Wallet-Address"] = auth.address;
             headers["X-Wallet-Signature"] = auth.signature;
             headers["X-Wallet-Nonce"] = auth.nonce;
-            headers["X-Wallet-Message"] = auth.message;
           }
           return { headers, auth };
         }
@@ -1404,8 +1431,7 @@ var require_ipfs = __commonJS({
             ...extraHeaders,
             "X-Wallet-Address": auth.address,
             "X-Wallet-Signature": auth.signature,
-            "X-Wallet-Nonce": auth.nonce,
-            "X-Wallet-Message": auth.message
+            "X-Wallet-Nonce": auth.nonce
           };
           return { headers, auth };
         }
@@ -1790,8 +1816,7 @@ var require_ipfs = __commonJS({
         "Content-Type": "application/json",
         "X-Wallet-Address": address,
         "X-Wallet-Signature": signature,
-        "X-Wallet-Nonce": nonce,
-        "X-Wallet-Message": message
+        "X-Wallet-Nonce": nonce
       };
       let verified = false;
       try {