@sage-protocol/sdk 0.1.17 → 0.1.18

package/dist/index.mjs

@@ -20,7 +20,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@sage-protocol/sdk",
-      version: "0.1.17",
+      version: "0.1.18",
       description: "Backend-agnostic SDK for interacting with the Sage Protocol (governance, SubDAOs, tokens).",
       main: "dist/index.cjs",
       module: "dist/index.mjs",
@@ -299,6 +299,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)"
     };
@@ -321,6 +501,13 @@ var require_abi = __commonJS({
       // Protocol treasury (replaces SageTreasury)
       GovernanceBoostMerkle,
       GovernanceBoostDirect,
+      // Voting Multiplier System
+      VotingMultiplierNFT,
+      MultipliedVotes,
+      // Auction House
+      SageAuctionHouse,
+      // Bounty System
+      SimpleBountySystem,
       Events
     };
   }
@@ -678,6 +865,409 @@ var require_subgraph = __commonJS({
       listLibraries,
       getSubdaoLibraries,
       getSubdaoPrompts,
+      /**
+       * Bounty dashboards (SimpleBountySystem)
+       */
+      async listBounties({ url, first = 50, skip = 0, status = null, creator = null }) {
+        if (!url) throw new Error("subgraph url required");
+        const filters = [];
+        if (status != null) filters.push(`status: ${Number(status)}`);
+        if (creator) {
+          const addr = safeGetAddress(creator);
+          if (!addr) throw new Error("invalid creator address");
+          filters.push(`creator: "${addr.toLowerCase()}"`);
+        }
+        const where = filters.length ? `where:{ ${filters.join(", ")} }` : "";
+        const doc = `
+      query($first:Int!,$skip:Int!){
+        bounties(
+          ${where}
+          first:$first
+          skip:$skip
+          orderBy: createdAt
+          orderDirection: desc
+        ){
+          id
+          contract
+          bountyId
+          creator
+          title
+          reward
+          creatorDeposit
+          mode
+          status
+          libraryAction
+          assignee
+          winner
+          winningSubmissionId
+          libraryKey
+          deadline
+          votingEndTime
+          createdAt
+          updatedAt
+        }
+      }
+    `;
+        const data = await query(url, doc, {
+          first: Math.min(Math.max(1, Number(first || 50)), 200),
+          skip: Number(skip || 0)
+        });
+        return mapSafe(data?.bounties, (row) => {
+          const contract = safeGetAddress(row.contract);
+          const creatorAddr = safeGetAddress(row.creator);
+          const assignee = row.assignee ? safeGetAddress(row.assignee) : null;
+          const winner = row.winner ? safeGetAddress(row.winner) : null;
+          if (!contract || !creatorAddr) return null;
+          return {
+            id: String(row.id),
+            contract,
+            bountyId: BigInt(String(row.bountyId || "0")),
+            creator: creatorAddr,
+            title: String(row.title || ""),
+            reward: BigInt(String(row.reward || "0")),
+            creatorDeposit: BigInt(String(row.creatorDeposit || "0")),
+            mode: Number(row.mode || 0),
+            status: Number(row.status || 0),
+            libraryAction: row.libraryAction != null ? Number(row.libraryAction) : null,
+            assignee,
+            winner,
+            winningSubmissionId: row.winningSubmissionId != null ? BigInt(String(row.winningSubmissionId)) : null,
+            libraryKey: row.libraryKey || null,
+            deadline: row.deadline != null ? Number(row.deadline) : null,
+            votingEndTime: row.votingEndTime != null ? Number(row.votingEndTime) : null,
+            createdAt: Number(row.createdAt || 0),
+            updatedAt: Number(row.updatedAt || 0)
+          };
+        });
+      },
+      async getBounty({ url, id: id2 }) {
+        if (!url) throw new Error("subgraph url required");
+        const doc = `
+      query($id:ID!){
+        bounty(id:$id){
+          id
+          contract
+          bountyId
+          creator
+          title
+          reward
+          creatorDeposit
+          mode
+          status
+          libraryAction
+          assignee
+          winner
+          winningSubmissionId
+          libraryKey
+          deadline
+          votingEndTime
+          snapshotBlock
+          governanceProposalId
+          createdAt
+          updatedAt
+        }
+      }
+    `;
+        const data = await query(url, doc, { id: String(id2) });
+        const row = data?.bounty;
+        if (!row) return null;
+        const contract = safeGetAddress(row.contract);
+        const creatorAddr = safeGetAddress(row.creator);
+        if (!contract || !creatorAddr) return null;
+        return {
+          id: String(row.id),
+          contract,
+          bountyId: BigInt(String(row.bountyId || "0")),
+          creator: creatorAddr,
+          title: String(row.title || ""),
+          reward: BigInt(String(row.reward || "0")),
+          creatorDeposit: BigInt(String(row.creatorDeposit || "0")),
+          mode: Number(row.mode || 0),
+          status: Number(row.status || 0),
+          libraryAction: row.libraryAction != null ? Number(row.libraryAction) : null,
+          assignee: row.assignee ? safeGetAddress(row.assignee) : null,
+          winner: row.winner ? safeGetAddress(row.winner) : null,
+          winningSubmissionId: row.winningSubmissionId != null ? BigInt(String(row.winningSubmissionId)) : null,
+          libraryKey: row.libraryKey || null,
+          deadline: row.deadline != null ? Number(row.deadline) : null,
+          votingEndTime: row.votingEndTime != null ? Number(row.votingEndTime) : null,
+          snapshotBlock: row.snapshotBlock != null ? Number(row.snapshotBlock) : null,
+          governanceProposalId: row.governanceProposalId != null ? BigInt(String(row.governanceProposalId)) : null,
+          createdAt: Number(row.createdAt || 0),
+          updatedAt: Number(row.updatedAt || 0)
+        };
+      },
+      async listBountySubmissions({ url, bountyId, first = 50, skip = 0 }) {
+        if (!url) throw new Error("subgraph url required");
+        const doc = `
+      query($bountyId:BigInt!,$first:Int!,$skip:Int!){
+        bountySubmissions(
+          where:{ bountyId:$bountyId }
+          first:$first
+          skip:$skip
+          orderBy: timestamp
+          orderDirection: asc
+        ){
+          id
+          bountyId
+          submissionId
+          submitter
+          promptIPFS
+          deliverableIPFS
+          timestamp
+          voteCount
+        }
+      }
+    `;
+        const data = await query(url, doc, {
+          bountyId: String(bountyId),
+          first: Math.min(Math.max(1, Number(first || 50)), 200),
+          skip: Number(skip || 0)
+        });
+        return mapSafe(data?.bountySubmissions, (row) => {
+          const submitter = safeGetAddress(row.submitter);
+          if (!submitter) return null;
+          return {
+            id: String(row.id),
+            bountyId: BigInt(String(row.bountyId || "0")),
+            submissionId: BigInt(String(row.submissionId || "0")),
+            submitter,
+            promptIPFS: String(row.promptIPFS || ""),
+            deliverableIPFS: String(row.deliverableIPFS || ""),
+            timestamp: Number(row.timestamp || 0),
+            voteCount: BigInt(String(row.voteCount || "0"))
+          };
+        });
+      },
+      async listBountyVotes({ url, bountyId, first = 100, skip = 0 }) {
+        if (!url) throw new Error("subgraph url required");
+        const doc = `
+      query($bountyId:BigInt!,$first:Int!,$skip:Int!){
+        bountyVotes(
+          where:{ bountyId:$bountyId }
+          first:$first
+          skip:$skip
+          orderBy: blockTimestamp
+          orderDirection: desc
+        ){
+          id
+          bountyId
+          submissionId
+          voter
+          weight
+          blockNumber
+          blockTimestamp
+          transactionHash
+        }
+      }
+    `;
+        const data = await query(url, doc, {
+          bountyId: String(bountyId),
+          first: Math.min(Math.max(1, Number(first || 100)), 500),
+          skip: Number(skip || 0)
+        });
+        return mapSafe(data?.bountyVotes, (row) => {
+          const voter = safeGetAddress(row.voter);
+          if (!voter) return null;
+          return {
+            id: String(row.id),
+            bountyId: BigInt(String(row.bountyId || "0")),
+            submissionId: BigInt(String(row.submissionId || "0")),
+            voter,
+            weight: BigInt(String(row.weight || "0")),
+            blockNumber: Number(row.blockNumber || 0),
+            blockTimestamp: Number(row.blockTimestamp || 0),
+            transactionHash: row.transactionHash || null
+          };
+        });
+      },
+      /**
+       * Multiplier dashboards (VotingMultiplierNFT + SageAuctionHouse)
+       */
+      async listMultiplierAccounts({ url, dao, first = 100, skip = 0 }) {
+        if (!url) throw new Error("subgraph url required");
+        const daoAddr = safeGetAddress(dao);
+        if (!daoAddr) throw new Error("invalid dao address");
+        const doc = `
+      query($dao:Bytes!,$first:Int!,$skip:Int!){
+        multiplierAccounts(
+          where:{ dao: $dao }
+          first:$first
+          skip:$skip
+          orderBy: currentMultiplierBps
+          orderDirection: desc
+        ){
+          id
+          dao
+          account
+          currentMultiplierBps
+          tokenCount
+          updatedAt
+        }
+      }
+    `;
+        const data = await query(url, doc, {
+          dao: daoAddr.toLowerCase(),
+          first: Math.min(Math.max(1, Number(first || 100)), 500),
+          skip: Number(skip || 0)
+        });
+        return mapSafe(data?.multiplierAccounts, (row) => {
+          const daoNorm = safeGetAddress(row.dao);
+          const account = safeGetAddress(row.account);
+          if (!daoNorm || !account) return null;
+          return {
+            id: String(row.id),
+            dao: daoNorm,
+            account,
+            multiplierBps: BigInt(String(row.currentMultiplierBps || "0")),
+            tokenCount: Number(row.tokenCount || 0),
+            updatedAt: Number(row.updatedAt || 0)
+          };
+        });
+      },
+      async listMultiplierNFTs({ url, dao, owner = null, first = 100, skip = 0 }) {
+        if (!url) throw new Error("subgraph url required");
+        const daoAddr = safeGetAddress(dao);
+        if (!daoAddr) throw new Error("invalid dao address");
+        const ownerAddr = owner ? safeGetAddress(owner) : null;
+        const filters = [`dao: $dao`];
+        if (ownerAddr) filters.push(`owner: $owner`);
+        const where = `where:{ ${filters.join(", ")} }`;
+        const doc = `
+      query($dao:Bytes!,$owner:Bytes,$first:Int!,$skip:Int!){
+        multiplierNFTs(
+          ${where}
+          first:$first
+          skip:$skip
+          orderBy: mintedAt
+          orderDirection: desc
+        ){
+          id
+          owner
+          dao
+          tier { id name multiplier maxSupply minted price }
+          multiplier
+          tokenURI
+          mintedAt
+          transactionHash
+        }
+      }
+    `;
+        const variables = {
+          dao: daoAddr.toLowerCase(),
+          owner: ownerAddr ? ownerAddr.toLowerCase() : null,
+          first: Math.min(Math.max(1, Number(first || 100)), 500),
+          skip: Number(skip || 0)
+        };
+        const data = await query(url, doc, variables);
+        return mapSafe(data?.multiplierNFTs, (row) => {
+          const ownerNorm = safeGetAddress(row.owner);
+          const daoNorm = safeGetAddress(row.dao);
+          if (!ownerNorm || !daoNorm) return null;
+          return {
+            id: String(row.id),
+            owner: ownerNorm,
+            dao: daoNorm,
+            tier: row.tier ? {
+              id: String(row.tier.id),
+              name: String(row.tier.name || ""),
+              multiplier: Number(row.tier.multiplier || 0),
+              maxSupply: BigInt(String(row.tier.maxSupply || "0")),
+              minted: BigInt(String(row.tier.minted || "0")),
+              price: BigInt(String(row.tier.price || "0"))
+            } : null,
+            multiplier: Number(row.multiplier || 0),
+            tokenURI: row.tokenURI || null,
+            mintedAt: Number(row.mintedAt || 0),
+            transactionHash: row.transactionHash || null
+          };
+        });
+      },
+      async getCurrentAuction({ url, auctionHouse }) {
+        if (!url) throw new Error("subgraph url required");
+        const addr = safeGetAddress(auctionHouse);
+        if (!addr) throw new Error("invalid auctionHouse address");
+        const doc = `
+      query($id:ID!){
+        multiplierAuction(id:$id){
+          id
+          auctionHouse
+          nft
+          treasury
+          currentNftId
+          currentAmount
+          currentBidder
+          startTime
+          endTime
+          settled
+          updatedAt
+        }
+      }
+    `;
+        const data = await query(url, doc, { id: addr.toLowerCase() });
+        const row = data?.multiplierAuction;
+        if (!row) return null;
+        return {
+          id: String(row.id),
+          auctionHouse: safeGetAddress(row.auctionHouse) || addr,
+          nft: safeGetAddress(row.nft),
+          treasury: safeGetAddress(row.treasury),
+          currentNftId: BigInt(String(row.currentNftId || "0")),
+          currentAmount: BigInt(String(row.currentAmount || "0")),
+          currentBidder: safeGetAddress(row.currentBidder || "0x0000000000000000000000000000000000000000"),
+          startTime: Number(row.startTime || 0),
+          endTime: Number(row.endTime || 0),
+          settled: !!row.settled,
+          updatedAt: Number(row.updatedAt || 0)
+        };
+      },
+      async listAuctionBids({ url, auctionHouse, first = 100, skip = 0 }) {
+        if (!url) throw new Error("subgraph url required");
+        const addr = safeGetAddress(auctionHouse);
+        if (!addr) throw new Error("invalid auctionHouse address");
+        const doc = `
+      query($auctionHouse:Bytes!,$first:Int!,$skip:Int!){
+        multiplierAuctionBids(
+          where:{ auctionHouse:$auctionHouse }
+          first:$first
+          skip:$skip
+          orderBy: blockTimestamp
+          orderDirection: desc
+        ){
+          id
+          auctionHouse
+          nftId
+          bidder
+          amount
+          extended
+          blockNumber
+          blockTimestamp
+          transactionHash
+        }
+      }
+    `;
+        const data = await query(url, doc, {
+          auctionHouse: addr.toLowerCase(),
+          first: Math.min(Math.max(1, Number(first || 100)), 500),
+          skip: Number(skip || 0)
+        });
+        return mapSafe(data?.multiplierAuctionBids, (row) => {
+          const bidder = safeGetAddress(row.bidder);
+          const ah = safeGetAddress(row.auctionHouse);
+          if (!ah || !bidder) return null;
+          return {
+            id: String(row.id),
+            auctionHouse: ah,
+            nftId: BigInt(String(row.nftId || "0")),
+            bidder,
+            amount: BigInt(String(row.amount || "0")),
+            extended: !!row.extended,
+            blockNumber: Number(row.blockNumber || 0),
+            blockTimestamp: Number(row.blockTimestamp || 0),
+            transactionHash: row.transactionHash || null
+          };
+        });
+      },
       /**
        * 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).
@@ -8516,6 +9106,60 @@ var require_doppler = __commonJS({
   }
 });
 
+// src/points.js
+var require_points = __commonJS({
+  "src/points.js"(exports2, module2) {
+    var axios = __require("axios");
+    function resolveBaseUrl(baseUrl) {
+      const fromEnv = process.env.SAGE_POINTS_BASE_URL;
+      const base = baseUrl || fromEnv;
+      if (!base) {
+        throw new Error(
+          "SAGE_POINTS_BASE_URL not set and no baseUrl provided. Provide the Sage web app base URL, e.g. https://app.sage.xyz"
+        );
+      }
+      return base.replace(/\/+$/, "");
+    }
+    async function fetchSeasonSnapshot({ baseUrl, season = "season-1" } = {}) {
+      const base = resolveBaseUrl(baseUrl);
+      const url = `${base}/airdrop/${season}/points.json`;
+      const resp = await axios.get(url, { timeout: 15e3 });
+      if (!resp || !resp.data) {
+        throw new Error(`No data returned from ${url}`);
+      }
+      return resp.data;
+    }
+    async function getSeasonPoints({ address, season = "season-1", baseUrl } = {}) {
+      if (!address) throw new Error("address is required");
+      const snapshot = await fetchSeasonSnapshot({ baseUrl, season });
+      const totals = snapshot.totals || {};
+      const key = address.toLowerCase();
+      const entry = totals[key] || null;
+      return {
+        season: snapshot.season || season,
+        chainId: snapshot.chainId,
+        address: key,
+        totalPoints: entry ? entry.points || 0 : 0,
+        breakdown: entry ? entry.breakdown || {} : {}
+      };
+    }
+    async function getSeasonLeaderboard({ limit = 100, season = "season-1", baseUrl } = {}) {
+      const snapshot = await fetchSeasonSnapshot({ baseUrl, season });
+      const totals = snapshot.totals || {};
+      const entries = Object.entries(totals).map(([addr, v]) => ({
+        address: addr,
+        points: v.points || 0
+      })).sort((a, b) => b.points - a.points);
+      return entries.slice(0, limit);
+    }
+    module2.exports = {
+      fetchSeasonSnapshot,
+      getSeasonPoints,
+      getSeasonLeaderboard
+    };
+  }
+});
+
 // src/services/utils/cache.js
 var require_cache = __commonJS({
   "src/services/utils/cache.js"(exports2, module2) {
@@ -9503,6 +10147,7 @@ var require_src = __commonJS({
         openzeppelin: require_openzeppelin()
       }
     };
+    var points = require_points();
     var { SubgraphService } = require_client();
     var { IPFSService } = require_client2();
     var serviceErrors = require_errors2();
@@ -9543,6 +10188,8 @@ var require_src = __commonJS({
       errors,
       doppler,
       adapters,
+      // Season points helpers (airdrops/testnet)
+      points,
       // New service layer exports
       services: {
         SubgraphService,