@sage-protocol/sdk 0.1.18 → 0.1.21

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
 -----------
@@ -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.21",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -130,7 +130,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)",
@@ -172,13 +171,18 @@ 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)",
       "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 parentDAO, address indexed childDAO)",
+      "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)",
@@ -1383,7 +1387,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 +1407,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 +1792,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 {