@sage-protocol/sdk 0.1.17 → 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.17",
+      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)",
@@ -293,6 +297,186 @@ var require_abi = __commonJS({
       "function create(uint256 proposalId, address token, uint256 perVoter, uint256 maxVoters)",
       "function fund(uint256 proposalId, uint256 amount)"
     ];
+    var VotingMultiplierNFT = [
+      // Constants
+      "function MINTER_ROLE() view returns (bytes32)",
+      "function MAX_NFTS_PER_ACCOUNT() view returns (uint256)",
+      // Tier Management
+      "function createTier(address dao, string name, uint256 multiplier, uint256 maxSupply, uint256 price) returns (uint256 tierId)",
+      "function getTier(uint256 tierId) view returns (tuple(string name, uint256 multiplier, uint256 maxSupply, uint256 minted, uint256 price, address dao))",
+      "function tierCount() view returns (uint256)",
+      "function tiers(uint256) view returns (string name, uint256 multiplier, uint256 maxSupply, uint256 minted, uint256 price, address dao)",
+      // Minting
+      "function mint(address to, uint256 tierId, string uri) returns (uint256 tokenId)",
+      "function publicMint(uint256 tierId, string uri) payable returns (uint256 tokenId)",
+      // Multiplier Functions
+      "function getMultiplier(address account, address dao) view returns (uint256)",
+      "function getPastMultiplier(address account, address dao, uint256 timepoint) view returns (uint256)",
+      "function getTokenMultiplier(uint256 tokenId) view returns (uint256)",
+      "function getTokenDAO(uint256 tokenId) view returns (address)",
+      // Token Info
+      "function tokenMultiplier(uint256) view returns (uint256)",
+      "function tokenDAO(uint256) view returns (address)",
+      "function tokenTier(uint256) view returns (uint256)",
+      "function getTokenInfo(uint256 tokenId) view returns (address owner, uint256 tierId, uint256 multiplier, string uri)",
+      // ERC721 Standard
+      "function balanceOf(address owner) view returns (uint256)",
+      "function ownerOf(uint256 tokenId) view returns (address)",
+      "function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)",
+      "function tokenURI(uint256 tokenId) view returns (string)",
+      "function transferFrom(address from, address to, uint256 tokenId)",
+      "function safeTransferFrom(address from, address to, uint256 tokenId)",
+      "function approve(address to, uint256 tokenId)",
+      "function setApprovalForAll(address operator, bool approved)",
+      "function getApproved(uint256 tokenId) view returns (address)",
+      "function isApprovedForAll(address owner, address operator) view returns (bool)",
+      // Admin
+      "function withdrawFunds(address to)",
+      "function grantRole(bytes32 role, address account)",
+      "function revokeRole(bytes32 role, address account)",
+      "function hasRole(bytes32 role, address account) view returns (bool)",
+      // Events
+      "event TierCreated(uint256 indexed tierId, address indexed dao, string name, uint256 multiplier, uint256 maxSupply, uint256 price)",
+      "event NFTMinted(address indexed to, uint256 indexed tokenId, address indexed dao, uint256 tierId, uint256 multiplier)",
+      "event Transfer(address indexed from, address indexed to, uint256 indexed tokenId)"
+    ];
+    var MultipliedVotes = [
+      // Core IVotes Interface
+      "function getVotes(address account) view returns (uint256)",
+      "function getPastVotes(address account, uint256 timepoint) view returns (uint256)",
+      "function getPastTotalSupply(uint256 timepoint) view returns (uint256)",
+      "function delegates(address account) view returns (address)",
+      "function delegate(address delegatee)",
+      "function delegateBySig(address delegatee, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s)",
+      // IERC6372 Clock Interface
+      "function clock() view returns (uint48)",
+      "function CLOCK_MODE() view returns (string)",
+      // View Helpers
+      "function getVotingBreakdown(address account) view returns (uint256 baseVotes, uint256 multiplier, uint256 effectiveVotes)",
+      "function getPastVotingBreakdown(address account, uint256 timepoint) view returns (uint256 baseVotes, uint256 multiplier, uint256 effectiveVotes)",
+      "function hasMultiplierBonus(address account) view returns (bool)",
+      // Immutable Config
+      "function baseToken() view returns (address)",
+      "function multiplierNFT() view returns (address)",
+      "function dao() view returns (address)",
+      "function BASIS() view returns (uint256)"
+    ];
+    var SageAuctionHouse = [
+      // Core Auction Functions
+      "function createBid(uint256 nftId) payable",
+      "function settleCurrentAndCreateNewAuction()",
+      "function settleAuction()",
+      "function createAuction()",
+      // Current Auction State
+      "function auction() view returns (uint256 nftId, uint256 amount, uint256 startTime, uint256 endTime, address bidder, bool settled)",
+      // Configuration
+      "function nft() view returns (address)",
+      "function treasury() view returns (address)",
+      "function weth() view returns (address)",
+      "function timeBuffer() view returns (uint256)",
+      "function reservePrice() view returns (uint256)",
+      "function minBidIncrementPercentage() view returns (uint256)",
+      "function duration() view returns (uint256)",
+      "function mintTierId() view returns (uint256)",
+      "function defaultTokenURI() view returns (string)",
+      // Admin Functions
+      "function pause()",
+      "function unpause()",
+      "function paused() view returns (bool)",
+      "function setTimeBuffer(uint256 _timeBuffer)",
+      "function setReservePrice(uint256 _reservePrice)",
+      "function setMinBidIncrementPercentage(uint256 _minBidIncrementPercentage)",
+      "function setDuration(uint256 _duration)",
+      "function setMintTierId(uint256 _tierId)",
+      "function setDefaultTokenURI(string _uri)",
+      "function owner() view returns (address)",
+      "function transferOwnership(address newOwner)",
+      // Events
+      "event AuctionCreated(uint256 indexed nftId, uint256 startTime, uint256 endTime)",
+      "event AuctionBid(uint256 indexed nftId, address sender, uint256 value, bool extended)",
+      "event AuctionExtended(uint256 indexed nftId, uint256 endTime)",
+      "event AuctionSettled(uint256 indexed nftId, address winner, uint256 amount)",
+      "event AuctionTimeBufferUpdated(uint256 timeBuffer)",
+      "event AuctionReservePriceUpdated(uint256 reservePrice)",
+      "event AuctionMinBidIncrementPercentageUpdated(uint256 minBidIncrementPercentage)",
+      "event AuctionDurationUpdated(uint256 duration)"
+    ];
+    var SimpleBountySystem = [
+      // Constants
+      "function GOVERNANCE_ROLE() view returns (bytes32)",
+      "function MAX_SUBMISSIONS_PER_BOUNTY() view returns (uint256)",
+      // Bounty Creation
+      "function createBounty(string title, string description, string ipfsCID, uint256 reward, uint256 deadline) returns (uint256)",
+      "function createBountyAdvanced(string title, string description, string ipfsCID, uint256 reward, uint256 deadline, uint256 votingDuration, uint8 mode, uint8 libraryAction, address assignee, string libraryKey) returns (uint256)",
+      // Submission & Claiming
+      "function claimBounty(uint256 bountyId)",
+      "function submitEntry(uint256 bountyId, string promptIPFS, string deliverableIPFS) returns (uint256)",
+      "function completeBounty(uint256 bountyId, string deliverableIPFS)",
+      // Voting (COMPETITIVE mode)
+      "function startVoting(uint256 bountyId)",
+      "function vote(uint256 bountyId, uint256 submissionId)",
+      "function finalizeCompetitive(uint256 bountyId)",
+      // Approval
+      "function approveSubmission(uint256 bountyId, uint256 submissionId)",
+      "function approveBountyCompletion(uint256 bountyId, string)",
+      // Cancellation & Expiry
+      "function cancelBounty(uint256 bountyId)",
+      "function expireBounty(uint256 bountyId)",
+      // Reward Management
+      "function increaseReward(uint256 bountyId, uint256 additionalReward)",
+      "function slashCreator(uint256 bountyId, uint256 amount, address to)",
+      // Gate Management
+      "function setGates(uint256 bountyId, uint256 minTokenBalance, uint256 requiredBadgeId)",
+      "function addToWhitelist(uint256 bountyId, address[] addresses)",
+      "function removeFromWhitelist(uint256 bountyId, address[] addresses)",
+      "function canSubmit(uint256 bountyId, address submitter) view returns (bool)",
+      // View Functions
+      "function getBounty(uint256 bountyId) view returns (tuple(address creator, uint256 id, string title, string description, string ipfsCID, uint256 reward, uint256 creatorDeposit, uint256 minContributorLevel, uint256 minTokenBalance, uint256 requiredBadgeId, uint256 deadline, uint256 votingEndTime, uint256 snapshotBlock, uint8 mode, uint8 status, uint8 libraryAction, address assignee, address winner, uint256 winningSubmissionId, string libraryKey, uint256 governanceProposalId))",
+      "function getSubmission(uint256 bountyId, uint256 submissionId) view returns (tuple(uint256 id, uint256 bountyId, address submitter, string promptIPFS, string deliverableIPFS, uint256 timestamp, uint256 voteCount, bool exists))",
+      "function getSubmissionCount(uint256 bountyId) view returns (uint256)",
+      "function getLeadingSubmission(uint256 bountyId) view returns (uint256 submissionId, uint256 votes)",
+      "function calculateStake(uint256 reward) view returns (uint256)",
+      // State Mappings
+      "function bounties(uint256) view returns (address creator, uint256 id, string title, string description, string ipfsCID, uint256 reward, uint256 creatorDeposit, uint256 minContributorLevel, uint256 minTokenBalance, uint256 requiredBadgeId, uint256 deadline, uint256 votingEndTime, uint256 snapshotBlock, uint8 mode, uint8 status, uint8 libraryAction, address assignee, address winner, uint256 winningSubmissionId, string libraryKey, uint256 governanceProposalId)",
+      "function nextBountyId() view returns (uint256)",
+      "function submissionCount(uint256) view returns (uint256)",
+      "function submitterToSubmission(uint256, address) view returns (uint256)",
+      "function hasVotedInBounty(uint256, address) view returns (bool)",
+      "function voterChosenSubmission(uint256, address) view returns (uint256)",
+      "function whitelist(uint256, address) view returns (bool)",
+      "function hasWhitelist(uint256) view returns (bool)",
+      // External Contracts
+      "function sxxxToken() view returns (address)",
+      "function contributorSystem() view returns (address)",
+      "function governanceConfig() view returns (address)",
+      "function communityTreasury() view returns (address)",
+      "function governanceContract() view returns (address)",
+      "function libraryRegistry() view returns (address)",
+      "function subdao() view returns (address)",
+      "function soulboundBadge() view returns (address)",
+      // Admin
+      "function setGovernanceContract(address _gov)",
+      "function setCommunityTreasury(address _treasury)",
+      "function setLibraryRegistry(address _registry)",
+      "function setSoulboundBadge(address _sbtAddress)",
+      "function grantRole(bytes32 role, address account)",
+      "function revokeRole(bytes32 role, address account)",
+      "function hasRole(bytes32 role, address account) view returns (bool)",
+      // Events
+      "event BountyCreated(uint256 indexed bountyId, address indexed creator, string title, uint256 reward, uint256 deposit, uint8 mode, address assignee)",
+      "event SubmissionReceived(uint256 indexed bountyId, uint256 indexed submissionId, address indexed submitter, string promptIPFS)",
+      "event BountyClaimed(uint256 indexed bountyId, address indexed claimant)",
+      "event BountyUnderReview(uint256 indexed bountyId, address indexed claimant, uint256 proposalId)",
+      "event VoteCast(uint256 indexed bountyId, uint256 indexed submissionId, address indexed voter, uint256 weight)",
+      "event VotingStarted(uint256 indexed bountyId, uint256 votingEndTime)",
+      "event BountyCompleted(uint256 indexed bountyId, address indexed winner, uint256 reward, string deliverable)",
+      "event BountyAutoApproved(uint256 indexed bountyId, address indexed winner)",
+      "event PromptAddedToLibrary(uint256 indexed bountyId, string libraryKey, string promptIPFS)",
+      "event BountyCancelled(uint256 indexed bountyId, address indexed creator)",
+      "event BountyExpired(uint256 indexed bountyId)",
+      "event BountyRewardIncreased(uint256 indexed bountyId, uint256 additionalReward, uint256 newTotal)",
+      "event CreatorSlashed(uint256 indexed bountyId, uint256 amount, address indexed to)"
+    ];
     var Events = {
       ProposalCreated: "event ProposalCreated(uint256 id, address proposer, address[] targets, uint256[] values, string[] signatures, bytes[] calldatas, uint256 startBlock, uint256 endBlock, string description)"
     };
@@ -315,6 +499,13 @@ var require_abi = __commonJS({
       // Protocol treasury (replaces SageTreasury)
       GovernanceBoostMerkle,
       GovernanceBoostDirect,
+      // Voting Multiplier System
+      VotingMultiplierNFT,
+      MultipliedVotes,
+      // Auction House
+      SageAuctionHouse,
+      // Bounty System
+      SimpleBountySystem,
       Events
     };
   }
@@ -1196,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 };
         }
@@ -1217,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 };
         }
@@ -1603,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 {