aiia-vault-sdk 1.1.0 → 1.1.1

package/dist/SeedRoundFundraiser.d.ts

@@ -34,6 +34,13 @@ export interface UserContribution {
     contributedToken: string;
     contributedAmount: number;
 }
+/**
+ * SDK for interacting with the SeedRoundFundraiser smart contract
+ *
+ * @remarks
+ * This SDK provides methods to interact with the SeedRoundFundraiser contract,
+ * including contributing tokens, managing rounds, and handling whitelisted tokens.
+ */
 export declare class SeedRoundFundraiserSDK {
     name: string;
     private contract;
@@ -43,14 +50,138 @@ export declare class SeedRoundFundraiserSDK {
     private PRICE_PRECISION;
     private whitelistedTokensArray;
     private networkName;
+    /**
+     * Creates a new instance of the SeedRoundFundraiserSDK
+     *
+     * @param rpcUrls - Single RPC URL or array of RPC URLs for blockchain connection
+     * @param contractAddress - Optional contract address. If not provided, will be resolved from contracts.json
+     *
+     * @throws Will throw if no valid RPC providers are available
+     */
     constructor(rpcUrls: string | string[], contractAddress?: string);
+    /**
+     * Gets the network name from the RPC URL
+     *
+     * @param rpcUrl - The RPC URL to parse
+     * @returns The network name (e.g., 'sepolia', 'mainnet', 'base-sepolia')
+     * @private
+     */
     private getNetworkNameFromRpc;
+    /**
+     * Imports whitelisted tokens from configuration file
+     *
+     * @private
+     */
     private importWhitelistedTokens;
+    /**
+     * Gets detailed information about a whitelisted token
+     *
+     * @param tokenAddress - The address of the token to query
+     * @returns Token information including price, symbol, and contribution limits, or null if not whitelisted
+     *
+     * @example
+     * ```typescript
+     * const tokenInfo = await sdk.getWhitelistedTokenInfo("0x...");
+     * if (tokenInfo) {
+     *   console.log(`Max contribution: ${tokenInfo.maxContribution} ${tokenInfo.symbol}`);
+     * }
+     * ```
+     */
     getWhitelistedTokenInfo(tokenAddress: string): Promise<WhitelistedTokenInfo | null>;
+    /**
+     * Gets information about all whitelisted tokens that are accepted for seed round participation.
+     *
+     * @remarks
+     * This function iterates through all whitelisted token addresses and fetches detailed information
+     * for each token that is actually whitelisted in the smart contract. The price and maxContribution
+     * values are calculated based on the current active round settings.
+     *
+     * @returns Promise<WhitelistedTokenInfo[]> Array of whitelisted token information with the following fields:
+     * - `address` (string): The token's contract address on the blockchain. For ETH, this will be the zero address (0x000...000)
+     * - `isWhitelisted` (boolean): Whether the token is currently whitelisted and accepted for contributions
+     * - `price` (number): Token price in USD with PRICE_PRECISION decimals (e.g., 1800.5 means 1 token = $1800.50)
+     * - `symbol` (string): Token symbol (e.g., "ETH", "USDC", "USDT")
+     * - `maxContribution` (number): Maximum amount of tokens a user can contribute in human-readable format,
+     *                              calculated as (maxFundPerAccount / tokenPrice)
+     * - `maxContributionRaw` (number): Maximum contribution amount adjusted with token decimals (maxContribution * 10^decimals),
+     *                                  ready for contract interaction
+     * - `decimals` (number): Number of decimal places the token uses (e.g., 18 for ETH, 6 for USDC)
+     *
+     * @example
+     * ```typescript
+     * const sdk = new SeedRoundFundraiserSDK(rpcUrl);
+     * const whitelistedTokens = await sdk.getAllWhitelistedTokensInfo();
+     *
+     * // Example response:
+     * [
+     *   {
+     *     address: "0x0000000000000000000000000000000000000000",
+     *     isWhitelisted: true,
+     *     price: 1800.5, // 1 ETH = $1800.50
+     *     symbol: "ETH",
+     *     maxContribution: 5.55, // Can contribute up to 5.55 ETH
+     *     maxContributionRaw: 5550000000000000000n, // 5.55 * 10^18
+     *     decimals: 18
+     *   },
+     *   {
+     *     address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+     *     isWhitelisted: true,
+     *     price: 1.0, // 1 USDC = $1.00
+     *     symbol: "USDC",
+     *     maxContribution: 10000, // Can contribute up to 10000 USDC
+     *     maxContributionRaw: 10000000000, // 10000 * 10^6
+     *     decimals: 6
+     *   }
+     * ]
+     * ```
+     *
+     * @notice
+     * - Token prices are in USD with PRICE_PRECISION (1e18) decimals
+     * - maxContribution is calculated based on the current round's maxFundPerAccount
+     * - For new rounds or if no active round exists, maxContribution will be 0
+     * - ETH is represented with the zero address and always has 18 decimals
+     *
+     * @see {@link getWhitelistedTokenInfo} For getting information about a single token
+     * @see {@link WhitelistedTokenInfo} For the interface definition
+     */
     getAllWhitelistedTokensInfo(): Promise<WhitelistedTokenInfo[]>;
+    /**
+     * Gets a random provider from the available providers
+     *
+     * @returns An ethers Provider instance
+     * @private
+     */
     private getRandomProvider;
+    /**
+     * Gets a contract instance with a random provider
+     *
+     * @returns Contract instance
+     * @private
+     */
     private getContractWithRandomProvider;
+    /**
+     * Bootstraps the SDK by checking RPC health and removing inactive providers
+     *
+     * @throws Will throw if no active RPC providers are available
+     */
     bootstrap(): Promise<void>;
+    /**
+     * Signs and sends a transaction to the blockchain
+     *
+     * @param tx - The transaction to send
+     * @param wallet - The wallet or transaction sender
+     * @param callbacks - Optional callbacks for transaction lifecycle events
+     * @returns Transaction result and status
+     *
+     * @example
+     * ```typescript
+     * const tx = await sdk.buildContributeTx(0, ethers.ZeroAddress, 1.5);
+     * const result = await sdk.signAndSendTransaction(tx, wallet, {
+     *   onSubmit: (txHash) => console.log(`Submitted: ${txHash}`),
+     *   onFinally: (status) => console.log(`Completed: ${status.status}`)
+     * });
+     * ```
+     */
     signAndSendTransaction(tx: ethers.ContractTransaction, wallet: ethers.Wallet | SendTransactionMutateAsync<Config, any>, callbacks?: {
         onSubmit?: (tx: string) => void | Promise<void>;
         onFinally?: (status: {
@@ -72,20 +203,154 @@ export declare class SeedRoundFundraiserSDK {
             attempts: number;
         };
     }>;
+    /**
+     * Builds a transaction to add a token to the whitelist
+     *
+     * @param token - The token address to whitelist
+     * @param price - The price of the token in USD (with PRICE_PRECISION decimals)
+     * @returns Populated transaction
+     *
+     * @example
+     * ```typescript
+     * const tx = await sdk.buildAddWhitelistedTokenTx("0x...", 1800.5);
+     * ```
+     */
     buildAddWhitelistedTokenTx(token: string, price: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to update a whitelisted token's price
+     *
+     * @param token - The token address
+     * @param newPrice - The new price in USD (with PRICE_PRECISION decimals)
+     * @returns Populated transaction
+     */
     buildUpdateTokenPriceTx(token: string, newPrice: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to remove a token from the whitelist
+     *
+     * @param token - The token address to remove
+     * @returns Populated transaction
+     */
     buildRemoveWhitelistedTokenTx(token: string): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to create a new fundraising round
+     *
+     * @param startTime - Round start time (Unix timestamp)
+     * @param endTime - Round end time (Unix timestamp)
+     * @param targetFund - Target funding amount in USD (with PRICE_PRECISION decimals)
+     * @param totalAllocation - Total tokens to allocate
+     * @param maxFundPerAccount - Maximum funding per account in USD
+     * @returns Populated transaction
+     *
+     * @example
+     * ```typescript
+     * const now = Math.floor(Date.now() / 1000);
+     * const tx = await sdk.buildCreateRoundTx(
+     *   now,
+     *   now + 86400, // 24 hours
+     *   1000000, // $1M target
+     *   1000000, // 1M tokens
+     *   10000 // $10k max per account
+     * );
+     * ```
+     */
     buildCreateRoundTx(startTime: number, endTime: number, targetFund: number, totalAllocation: number, maxFundPerAccount: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to update an existing round's parameters
+     *
+     * @param roundId - The ID of the round to update
+     * @param startTime - New start time
+     * @param endTime - New end time
+     * @param targetFund - New target fund amount
+     * @param totalAllocation - New total token allocation
+     * @param maxFundPerAccount - New maximum funding per account
+     * @returns Populated transaction
+     */
     buildUpdateRoundTx(roundId: number, startTime: number, endTime: number, targetFund: number, totalAllocation: number, maxFundPerAccount: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to end a round
+     *
+     * @param roundId - The ID of the round to end
+     * @returns Populated transaction
+     */
     buildEndRoundTx(roundId: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to enable/disable token claiming for a round
+     *
+     * @param roundId - The round ID
+     * @param enabled - Whether to enable or disable claiming
+     * @returns Populated transaction
+     */
     buildSetClaimingEnabledTx(roundId: number, enabled: boolean): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to enable/disable refunds for a round
+     *
+     * @param roundId - The round ID
+     * @param enabled - Whether to enable or disable refunds
+     * @returns Populated transaction
+     */
     buildSetRefundEnabledTx(roundId: number, enabled: boolean): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to contribute to a round
+     *
+     * @param roundId - The ID of the round to contribute to
+     * @param token - The token address (use ethers.ZeroAddress for ETH)
+     * @param amount - Amount to contribute in human-readable format
+     * @returns Populated transaction
+     *
+     * @example
+     * ```typescript
+     * // Contribute 1.5 ETH
+     * const tx = await sdk.buildContributeTx(0, ethers.ZeroAddress, 1.5);
+     *
+     * // Contribute 1000 USDC
+     * const tx = await sdk.buildContributeTx(0, "0x...", 1000);
+     * ```
+     *
+     * @notice For ERC20 tokens, ensure you have approved the contract first
+     */
     buildContributeTx(roundId: number, token: string, amount: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to claim allocated tokens
+     *
+     * @returns Populated transaction for claiming tokens from all eligible rounds
+     */
     buildClaimTokensTx(): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to request a refund
+     *
+     * @returns Populated transaction for requesting refund from eligible rounds
+     */
     buildRefundTx(): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to withdraw accumulated funds
+     *
+     * @param token - The token address to withdraw
+     * @param amount - Amount to withdraw in human-readable format
+     * @returns Populated transaction
+     *
+     * @notice Only callable by contract owner
+     */
     buildWithdrawFundsTx(token: string, amount: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to claim tokens from a specific round
+     *
+     * @param roundId - The round ID to claim tokens from
+     * @returns Populated transaction
+     */
     buildClaimTokensByRoundIdTx(roundId: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Gets information about a whitelisted token
+     *
+     * @param token - The token address
+     * @returns Token whitelist status and price
+     */
     getWhitelistedToken(token: string): Promise<WhitelistedToken>;
+    /**
+     * Gets configuration of a specific round
+     *
+     * @param roundId - The round ID to query
+     * @returns Round configuration including times, targets, and status
+     */
     getRound(roundId: number): Promise<RoundConfig>;
     getUserContribution(roundId: number, user: string): Promise<UserContribution>;
     getRoundRaisedFunds(roundId: number): Promise<number>;
@@ -101,9 +366,63 @@ export declare class SeedRoundFundraiserSDK {
      */
     getLatestRoundId(): Promise<number>;
     /**
-     * Get comprehensive information about a specific round
-     * @param roundId The ID of the round to get information for
-     * @returns An object containing all information about the specified round
+     * Gets comprehensive information about a specific fundraising round
+     *
+     * @param roundId - The ID of the round to query (0-based index)
+     * @returns Detailed round information with the following fields:
+     * ```typescript
+     * {
+     *   roundId: number;    // The queried round ID
+     *   config: {           // Round configuration and current state
+     *     startTime: number;      // Unix timestamp when the round starts
+     *     endTime: number;        // Unix timestamp when the round ends
+     *     targetFund: number;     // Target funding amount in USD (with PRICE_PRECISION)
+     *     totalAllocation: number;// Total project tokens to be distributed in this round
+     *     maxFundPerAccount: number; // Maximum USD value one account can contribute
+     *     exists: boolean;        // Whether this round has been created
+     *     ended: boolean;         // Whether this round has been manually ended
+     *     claimingEnabled: boolean; // Whether participants can claim their tokens
+     *     refundEnabled: boolean;   // Whether refunds are enabled for this round
+     *   };
+     *   raisedFunds: number;    // Total USD value raised in this round
+     *   participants: number;    // Number of unique participants
+     *   isActive: boolean;      // Whether the round is currently active
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * const roundInfo = await sdk.getRoundInfo(0);
+     *
+     * // Check if round is active and accepting contributions
+     * if (roundInfo.isActive) {
+     *   console.log(`Round 0 is active!`);
+     *   console.log(`Progress: $${roundInfo.raisedFunds}/$${roundInfo.config.targetFund}`);
+     *   console.log(`Participants: ${roundInfo.participants}`);
+     * }
+     *
+     * // Check if tokens can be claimed
+     * if (roundInfo.config.claimingEnabled) {
+     *   console.log('Token claiming is enabled for this round');
+     * }
+     * ```
+     *
+     * @notice
+     * - All USD values (targetFund, maxFundPerAccount, raisedFunds) use PRICE_PRECISION (1e18) decimals
+     * - totalAllocation is in project token's decimals (e.g., usually 18 decimals)
+     * - A round is considered active if:
+     *   1. It exists
+     *   2. Current time is between startTime and endTime
+     *   3. It hasn't been manually ended
+     * - Rounds are 0-indexed, so first round has ID 0
+     *
+     * @throws Will throw an error if:
+     * - roundId is negative
+     * - roundId is greater than or equal to total number of rounds
+     *
+     * @see {@link getRound} For getting just the round configuration
+     * @see {@link getRoundRaisedFunds} For getting just the raised funds
+     * @see {@link getRoundParticipants} For getting just the participant count
      */
     getRoundInfo(roundId: number): Promise<{
         roundId: number;
@@ -127,4 +446,72 @@ export declare class SeedRoundFundraiserSDK {
     getAllEvents(fromBlock: number, toBlock: number): Promise<ParsedSeedRoundFundraiserEventRaw[]>;
     streamEvents(fromBlock: number, onEvent: (event: ParsedSeedRoundFundraiserEvent) => Promise<void>, saveLatestBlock: (blockNumber: number) => Promise<void>, batchSize?: number, sleepTime?: number): Promise<void>;
     formatEventArgs: (event: ParsedSeedRoundFundraiserEventRaw) => ParsedSeedRoundFundraiserEvent;
+    /**
+     * Gets detailed information about a user's contribution in a specific round
+     *
+     * @param roundId - The ID of the round to query
+     * @param user - The user's address to check contribution
+     * @returns Detailed contribution information with the following fields:
+     * ```typescript
+     * {
+     *   contribution: {
+     *     fundAmount: number;      // Total USD value of contribution (with PRICE_PRECISION)
+     *     tokenAllocation: number; // Amount of project tokens allocated
+     *     claimed: boolean;        // Whether allocated tokens have been claimed
+     *     refunded: boolean;       // Whether contribution has been refunded
+     *     contributedToken: string;// Address of token used for contribution
+     *     contributedAmount: number;// Actual amount of tokens contributed
+     *   };
+     *   roundInfo: {
+     *     exists: boolean;         // Whether the round exists
+     *     isActive: boolean;       // Whether the round is currently active
+     *     claimingEnabled: boolean;// Whether token claiming is enabled
+     *     refundEnabled: boolean;  // Whether refunds are enabled
+     *   };
+     *   tokenInfo?: {              // Only present if contribution exists
+     *     symbol: string;          // Symbol of contributed token
+     *     decimals: number;        // Decimals of contributed token
+     *   };
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * const userContrib = await sdk.getUserRoundContribution(0, "0x...");
+     *
+     * if (userContrib.contribution.fundAmount > 0) {
+     *   console.log(`Contributed: ${userContrib.contribution.contributedAmount} ${userContrib.tokenInfo?.symbol}`);
+     *   console.log(`Value: $${userContrib.contribution.fundAmount}`);
+     *   console.log(`Allocated: ${userContrib.contribution.tokenAllocation} tokens`);
+     *
+     *   if (userContrib.roundInfo.claimingEnabled && !userContrib.contribution.claimed) {
+     *     console.log('Tokens are ready to claim!');
+     *   }
+     * }
+     * ```
+     *
+     * @notice
+     * - All USD values use PRICE_PRECISION (1e18) decimals
+     * - Token amounts are in their native decimals (e.g., 18 for ETH, 6 for USDC)
+     * - For ETH contributions, contributedToken will be the zero address
+     * - tokenInfo will be undefined if user hasn't contributed to the round
+     *
+     * @throws Will throw if:
+     * - roundId is invalid
+     * - user address is invalid
+     * - Contract call fails
+     */
+    getUserRoundContribution(roundId: number, user: string): Promise<{
+        contribution: UserContribution;
+        roundInfo: {
+            exists: boolean;
+            isActive: boolean;
+            claimingEnabled: boolean;
+            refundEnabled: boolean;
+        };
+        tokenInfo?: {
+            symbol: string;
+            decimals: number;
+        };
+    }>;
 }

package/dist/SeedRoundFundraiser.js

@@ -1 +1 @@
-"use strict";var t=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.SeedRoundFundraiserSDK=void 0;const e=require("ethers"),n=t(require("./abis/SeedRoundFundraiser.json")),r=t(require("./contracts.json")),o=require("./utils"),a=t(require("./whitelist-tokens.json"));exports.SeedRoundFundraiserSDK=class{constructor(t,a){this.name="SeedRoundFundraiser",this.isBootstrapped=!1,this.PRICE_PRECISION=1e18,this.whitelistedTokensArray=[],this.formatEventArgs=t=>{const{eventName:e,args:n}=t;switch(e){case"TokenWhitelisted":return{...t,args:{...n,token:n.token.toLowerCase(),price:Number(n.price)/this.PRICE_PRECISION}};case"TokenPriceUpdated":return{...t,args:{...n,token:n.token.toLowerCase(),oldPrice:Number(n.oldPrice)/this.PRICE_PRECISION,newPrice:Number(n.newPrice)/this.PRICE_PRECISION}};case"TokenRemovedFromWhitelist":return{...t,args:{...n,token:n.token.toLowerCase()}};case"RoundCreated":case"RoundUpdated":return{...t,args:{...n,roundId:Number(n.roundId),startTime:Number(n.startTime),endTime:Number(n.endTime),targetFund:Number(n.targetFund)/this.PRICE_PRECISION,totalAllocation:Number(n.totalAllocation),maxFundPerAccount:Number(n.maxFundPerAccount)/this.PRICE_PRECISION}};case"RoundEnded":return{...t,args:{...n,roundId:Number(n.roundId),raisedFunds:Number(n.raisedFunds)/this.PRICE_PRECISION,participants:Number(n.participants)}};case"Contribution":return{...t,args:{...n,roundId:Number(n.roundId),contributor:n.contributor.toLowerCase(),token:n.token.toLowerCase(),amount:Number(n.amount),fundAmount:Number(n.fundAmount)/this.PRICE_PRECISION,tokenAllocation:Number(n.tokenAllocation)}};case"TokensClaimed":return{...t,args:{...n,roundId:Number(n.roundId),user:n.user.toLowerCase(),amount:Number(n.amount)}};case"ProjectTokenUpdated":return{...t,args:{...n,oldToken:n.oldToken.toLowerCase(),newToken:n.newToken.toLowerCase()}};case"ClaimingEnabledUpdated":case"RefundEnabledUpdated":return{...t,args:{...n,roundId:Number(n.roundId),enabled:n.enabled}};case"Refunded":return{...t,args:{...n,roundId:Number(n.roundId),user:n.user.toLowerCase(),token:n.token.toLowerCase(),amount:Number(n.amount)}};default:return t}};const s=Array.isArray(t)?t:[t];this.providers=s.map((t=>new e.ethers.JsonRpcProvider(t)));const i=(0,o.getRandomProvider)(this.providers);this.contractAddress=(0,o.resolveContractAddress)(s[0],this.name,r.default,a),this.contract=new e.ethers.Contract(this.contractAddress,n.default.abi,i),this.networkName=this.getNetworkNameFromRpc(s[0]),this.importWhitelistedTokens()}getNetworkNameFromRpc(t){const e=t.toLowerCase();return e.includes("sepolia.base")?"base-sepolia":e.includes("sepolia")?"sepolia":e.includes("mainnet")?"mainnet":e.includes("localhost")||e.includes("127.0.0.1")?"hardhat":"sepolia"}importWhitelistedTokens(){try{a.default[this.networkName]?(this.whitelistedTokensArray=a.default[this.networkName].map((t=>t.toLowerCase())),console.log(`Imported ${this.whitelistedTokensArray.length} whitelisted tokens for ${this.networkName} network`)):console.log(`No whitelisted tokens found for ${this.networkName} network`)}catch(t){console.error("Error importing whitelisted tokens:",t)}}async getWhitelistedTokenInfo(t){const n=t.toLowerCase();if(!this.whitelistedTokensArray.includes(n))return null;const r=await this.getWhitelistedToken(n);if(!r.isWhitelisted)return null;let a="ETH",s=18;n!==e.ethers.ZeroAddress&&([a,s]=await Promise.all([(0,o.getTokenSymbol)(n,this.getRandomProvider()),(0,o.getTokenDecimals)(n,this.getRandomProvider())]));const i=await this.getLatestRoundId();let d=0;if(i>=0){const t=await this.getRound(i);t.exists&&!t.ended&&(d=t.maxFundPerAccount/r.price)}return{address:n,isWhitelisted:r.isWhitelisted,price:r.price,symbol:a,maxContribution:d,maxContributionRaw:Math.floor(d*Math.pow(10,s)),decimals:s}}async getAllWhitelistedTokensInfo(){const t=[];for(const e of this.whitelistedTokensArray){const n=await this.getWhitelistedTokenInfo(e);n&&t.push(n)}return t}getRandomProvider(){return(0,o.getRandomProvider)(this.providers)}getContractWithRandomProvider(){return new e.ethers.Contract(this.contractAddress,n.default.abi,this.getRandomProvider())}async bootstrap(){if(this.isBootstrapped)return;const t=await Promise.all(this.providers.map(((t,e)=>(0,o.checkRpcHealth)(t,e))));if(this.providers=this.providers.filter(((e,n)=>t[n])),0===this.providers.length)throw new Error("No active RPC providers available");this.isBootstrapped=!0}async signAndSendTransaction(t,e,n={}){return(0,o.signAndSendTransaction)(t,e,(()=>this.getRandomProvider()),n,this.contract)}async buildAddWhitelistedTokenTx(t,e){const n=BigInt(Math.floor(e*this.PRICE_PRECISION));return await this.contract.addWhitelistedToken.populateTransaction(t,n)}async buildUpdateTokenPriceTx(t,e){const n=BigInt(Math.floor(e*this.PRICE_PRECISION));return await this.contract.updateTokenPrice.populateTransaction(t,n)}async buildRemoveWhitelistedTokenTx(t){return await this.contract.removeWhitelistedToken.populateTransaction(t)}async buildCreateRoundTx(t,e,n,r,a){const s=BigInt(Math.floor(n*this.PRICE_PRECISION)),i=BigInt(Math.floor(a*this.PRICE_PRECISION)),d=await(0,o.getTokenDecimals)(await this.getProjectToken(),this.getRandomProvider()),u=BigInt(Math.floor(r*Math.pow(10,d)));return await this.contract.createRound.populateTransaction(t,e,s,u,i)}async buildUpdateRoundTx(t,e,n,r,o,a){const s=BigInt(Math.floor(r*this.PRICE_PRECISION)),i=BigInt(Math.floor(a*this.PRICE_PRECISION));return await this.contract.updateRound.populateTransaction(t,e,n,s,o,i)}async buildEndRoundTx(t){return await this.contract.endRound.populateTransaction(t)}async buildSetClaimingEnabledTx(t,e){return await this.contract.setClaimingEnabled.populateTransaction(t,e)}async buildSetRefundEnabledTx(t,e){return await this.contract.setRefundEnabled.populateTransaction(t,e)}async buildContributeTx(t,n,r){let a=18;n!==e.ethers.ZeroAddress&&(a=await(0,o.getTokenDecimals)(n,this.getRandomProvider()));const s=e.ethers.parseUnits(r.toString(),a),i=await this.contract.contribute.populateTransaction(t,n,n===e.ethers.ZeroAddress?0:s);return n===e.ethers.ZeroAddress&&(i.value=s),i}async buildClaimTokensTx(){return await this.contract.claimTokens.populateTransaction()}async buildRefundTx(){return await this.contract.refund.populateTransaction()}async buildWithdrawFundsTx(t,e){const n=await(0,o.getTokenDecimals)(t,this.getRandomProvider()),r=BigInt(Math.floor(e*Math.pow(10,n)));return await this.contract.withdrawFunds.populateTransaction(t,r)}async buildClaimTokensByRoundIdTx(t){return await this.contract.claimTokensByRoundId.populateTransaction(t)}async getWhitelistedToken(t){const e=await this.contract.whitelistedTokens(t);return{isWhitelisted:e.isWhitelisted,price:Number(e.price)/this.PRICE_PRECISION}}async getRound(t){const e=await this.contract.rounds(t);return{startTime:Number(e.startTime),endTime:Number(e.endTime),targetFund:Number(e.targetFund)/this.PRICE_PRECISION,totalAllocation:Number(e.totalAllocation),maxFundPerAccount:Number(e.maxFundPerAccount)/this.PRICE_PRECISION,exists:e.exists,ended:e.ended,claimingEnabled:e.claimingEnabled,refundEnabled:e.refundEnabled}}async getUserContribution(t,e){const n=await this.contract.userContributions(t,e);return{fundAmount:Number(n.fundAmount)/this.PRICE_PRECISION,tokenAllocation:Number(n.tokenAllocation),claimed:n.claimed,refunded:n.refunded,contributedToken:n.contributedToken,contributedAmount:Number(n.contributedAmount)}}async getRoundRaisedFunds(t){const e=await this.contract.roundRaisedFunds(t);return Number(e)/this.PRICE_PRECISION}async getRoundParticipants(t){const e=await this.contract.roundParticipants(t);return Number(e)}async getUserParticipatedRound(t){const e=await this.contract.userParticipatedRound(t);return Number(e)}async getProjectToken(){return await this.contract.projectToken()}async getTotalRounds(){const t=await this.contract.totalRounds();return Number(t)}async getTotalRaisedFunds(){const t=await this.contract.totalRaisedFunds();return Number(t)/this.PRICE_PRECISION}async isRoundActive(t){return await this.contract.isRoundActive(t)}async getLatestRoundId(){const t=await this.getTotalRounds();return 0===t?-1:t-1}async getRoundInfo(t){const e=await this.getTotalRounds();if(t<0||t>=e)throw new Error(`Invalid round ID: ${t}`);return{roundId:t,config:await this.getRound(t),raisedFunds:await this.getRoundRaisedFunds(t),participants:await this.getRoundParticipants(t),isActive:await this.isRoundActive(t)}}async getUserTotalContribution(t){const e=await this.contract.getUserTotalContribution(t);return{totalFundAmount:Number(e.totalFundAmount)/this.PRICE_PRECISION,totalTokenAllocation:Number(e.totalTokenAllocation)}}async getTransactionStatus(t,e=10){return await(0,o.getTransactionStatus)(this.getRandomProvider(),t,e)}getContractAddress(){return this.contractAddress}async getAllEvents(t,e){return await this.bootstrap(),(0,o.getAllEvents)(this.contract,(()=>this.getRandomProvider()),(()=>this.getContractWithRandomProvider()),t,e)}async streamEvents(t,e,n,r=1e3,a=5e3){return await this.bootstrap(),(0,o.streamEvents)({getProvider:()=>this.getRandomProvider(),getAllEvents:(t,e)=>this.getAllEvents(t,e),formatEvent:t=>this.formatEventArgs(t),onEvent:e,saveLatestBlock:n,fromBlock:t,batchSize:r,sleepTime:a})}};
+"use strict";var t=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.SeedRoundFundraiserSDK=void 0;const e=require("ethers"),n=t(require("./abis/SeedRoundFundraiser.json")),r=t(require("./contracts.json")),o=require("./utils"),a=t(require("./whitelist-tokens.json"));exports.SeedRoundFundraiserSDK=class{constructor(t,a){this.name="SeedRoundFundraiser",this.isBootstrapped=!1,this.PRICE_PRECISION=1e18,this.whitelistedTokensArray=[],this.formatEventArgs=t=>{const{eventName:e,args:n}=t;switch(e){case"TokenWhitelisted":return{...t,args:{...n,token:n.token.toLowerCase(),price:Number(n.price)/this.PRICE_PRECISION}};case"TokenPriceUpdated":return{...t,args:{...n,token:n.token.toLowerCase(),oldPrice:Number(n.oldPrice)/this.PRICE_PRECISION,newPrice:Number(n.newPrice)/this.PRICE_PRECISION}};case"TokenRemovedFromWhitelist":return{...t,args:{...n,token:n.token.toLowerCase()}};case"RoundCreated":case"RoundUpdated":return{...t,args:{...n,roundId:Number(n.roundId),startTime:Number(n.startTime),endTime:Number(n.endTime),targetFund:Number(n.targetFund)/this.PRICE_PRECISION,totalAllocation:Number(n.totalAllocation),maxFundPerAccount:Number(n.maxFundPerAccount)/this.PRICE_PRECISION}};case"RoundEnded":return{...t,args:{...n,roundId:Number(n.roundId),raisedFunds:Number(n.raisedFunds)/this.PRICE_PRECISION,participants:Number(n.participants)}};case"Contribution":return{...t,args:{...n,roundId:Number(n.roundId),contributor:n.contributor.toLowerCase(),token:n.token.toLowerCase(),amount:Number(n.amount),fundAmount:Number(n.fundAmount)/this.PRICE_PRECISION,tokenAllocation:Number(n.tokenAllocation)}};case"TokensClaimed":return{...t,args:{...n,roundId:Number(n.roundId),user:n.user.toLowerCase(),amount:Number(n.amount)}};case"ProjectTokenUpdated":return{...t,args:{...n,oldToken:n.oldToken.toLowerCase(),newToken:n.newToken.toLowerCase()}};case"ClaimingEnabledUpdated":case"RefundEnabledUpdated":return{...t,args:{...n,roundId:Number(n.roundId),enabled:n.enabled}};case"Refunded":return{...t,args:{...n,roundId:Number(n.roundId),user:n.user.toLowerCase(),token:n.token.toLowerCase(),amount:Number(n.amount)}};default:return t}};const i=Array.isArray(t)?t:[t];this.providers=i.map((t=>new e.ethers.JsonRpcProvider(t)));const s=(0,o.getRandomProvider)(this.providers);this.contractAddress=(0,o.resolveContractAddress)(i[0],this.name,r.default,a),this.contract=new e.ethers.Contract(this.contractAddress,n.default.abi,s),this.networkName=this.getNetworkNameFromRpc(i[0]),this.importWhitelistedTokens()}getNetworkNameFromRpc(t){const e=t.toLowerCase();return e.includes("sepolia.base")?"base-sepolia":e.includes("sepolia")?"sepolia":e.includes("mainnet")?"mainnet":e.includes("localhost")||e.includes("127.0.0.1")?"hardhat":"sepolia"}importWhitelistedTokens(){try{a.default[this.networkName]?(this.whitelistedTokensArray=a.default[this.networkName].map((t=>t.toLowerCase())),console.log(`Imported ${this.whitelistedTokensArray.length} whitelisted tokens for ${this.networkName} network`)):console.log(`No whitelisted tokens found for ${this.networkName} network`)}catch(t){console.error("Error importing whitelisted tokens:",t)}}async getWhitelistedTokenInfo(t){const n=t.toLowerCase();if(!this.whitelistedTokensArray.includes(n))return null;const r=await this.getWhitelistedToken(n);if(!r.isWhitelisted)return null;let a="ETH",i=18;n!==e.ethers.ZeroAddress&&([a,i]=await Promise.all([(0,o.getTokenSymbol)(n,this.getRandomProvider()),(0,o.getTokenDecimals)(n,this.getRandomProvider())]));const s=await this.getLatestRoundId();let d=0;if(s>=0){const t=await this.getRound(s);t.exists&&!t.ended&&(d=t.maxFundPerAccount/r.price)}return{address:n,isWhitelisted:r.isWhitelisted,price:r.price,symbol:a,maxContribution:d,maxContributionRaw:Math.floor(d*Math.pow(10,i)),decimals:i}}async getAllWhitelistedTokensInfo(){const t=[];for(const e of this.whitelistedTokensArray){const n=await this.getWhitelistedTokenInfo(e);n&&t.push(n)}return t}getRandomProvider(){return(0,o.getRandomProvider)(this.providers)}getContractWithRandomProvider(){return new e.ethers.Contract(this.contractAddress,n.default.abi,this.getRandomProvider())}async bootstrap(){if(this.isBootstrapped)return;const t=await Promise.all(this.providers.map(((t,e)=>(0,o.checkRpcHealth)(t,e))));if(this.providers=this.providers.filter(((e,n)=>t[n])),0===this.providers.length)throw new Error("No active RPC providers available");this.isBootstrapped=!0}async signAndSendTransaction(t,e,n={}){return(0,o.signAndSendTransaction)(t,e,(()=>this.getRandomProvider()),n,this.contract)}async buildAddWhitelistedTokenTx(t,e){const n=BigInt(Math.floor(e*this.PRICE_PRECISION));return await this.contract.addWhitelistedToken.populateTransaction(t,n)}async buildUpdateTokenPriceTx(t,e){const n=BigInt(Math.floor(e*this.PRICE_PRECISION));return await this.contract.updateTokenPrice.populateTransaction(t,n)}async buildRemoveWhitelistedTokenTx(t){return await this.contract.removeWhitelistedToken.populateTransaction(t)}async buildCreateRoundTx(t,e,n,r,a){const i=BigInt(Math.floor(n*this.PRICE_PRECISION)),s=BigInt(Math.floor(a*this.PRICE_PRECISION)),d=await(0,o.getTokenDecimals)(await this.getProjectToken(),this.getRandomProvider()),u=BigInt(Math.floor(r*Math.pow(10,d)));return await this.contract.createRound.populateTransaction(t,e,i,u,s)}async buildUpdateRoundTx(t,e,n,r,o,a){const i=BigInt(Math.floor(r*this.PRICE_PRECISION)),s=BigInt(Math.floor(a*this.PRICE_PRECISION));return await this.contract.updateRound.populateTransaction(t,e,n,i,o,s)}async buildEndRoundTx(t){return await this.contract.endRound.populateTransaction(t)}async buildSetClaimingEnabledTx(t,e){return await this.contract.setClaimingEnabled.populateTransaction(t,e)}async buildSetRefundEnabledTx(t,e){return await this.contract.setRefundEnabled.populateTransaction(t,e)}async buildContributeTx(t,n,r){let a=18;n!==e.ethers.ZeroAddress&&(a=await(0,o.getTokenDecimals)(n,this.getRandomProvider()));const i=e.ethers.parseUnits(r.toString(),a),s=await this.contract.contribute.populateTransaction(t,n,n===e.ethers.ZeroAddress?0:i);return n===e.ethers.ZeroAddress&&(s.value=i),s}async buildClaimTokensTx(){return await this.contract.claimTokens.populateTransaction()}async buildRefundTx(){return await this.contract.refund.populateTransaction()}async buildWithdrawFundsTx(t,e){const n=await(0,o.getTokenDecimals)(t,this.getRandomProvider()),r=BigInt(Math.floor(e*Math.pow(10,n)));return await this.contract.withdrawFunds.populateTransaction(t,r)}async buildClaimTokensByRoundIdTx(t){return await this.contract.claimTokensByRoundId.populateTransaction(t)}async getWhitelistedToken(t){const e=await this.contract.whitelistedTokens(t);return{isWhitelisted:e.isWhitelisted,price:Number(e.price)/this.PRICE_PRECISION}}async getRound(t){const e=await this.contract.rounds(t);return{startTime:Number(e.startTime),endTime:Number(e.endTime),targetFund:Number(e.targetFund)/this.PRICE_PRECISION,totalAllocation:Number(e.totalAllocation),maxFundPerAccount:Number(e.maxFundPerAccount)/this.PRICE_PRECISION,exists:e.exists,ended:e.ended,claimingEnabled:e.claimingEnabled,refundEnabled:e.refundEnabled}}async getUserContribution(t,e){const n=await this.contract.userContributions(t,e);return{fundAmount:Number(n.fundAmount)/this.PRICE_PRECISION,tokenAllocation:Number(n.tokenAllocation),claimed:n.claimed,refunded:n.refunded,contributedToken:n.contributedToken,contributedAmount:Number(n.contributedAmount)}}async getRoundRaisedFunds(t){const e=await this.contract.roundRaisedFunds(t);return Number(e)/this.PRICE_PRECISION}async getRoundParticipants(t){const e=await this.contract.roundParticipants(t);return Number(e)}async getUserParticipatedRound(t){const e=await this.contract.userParticipatedRound(t);return Number(e)}async getProjectToken(){return await this.contract.projectToken()}async getTotalRounds(){const t=await this.contract.totalRounds();return Number(t)}async getTotalRaisedFunds(){const t=await this.contract.totalRaisedFunds();return Number(t)/this.PRICE_PRECISION}async isRoundActive(t){return await this.contract.isRoundActive(t)}async getLatestRoundId(){const t=await this.getTotalRounds();return 0===t?-1:t-1}async getRoundInfo(t){const e=await this.getTotalRounds();if(t<0||t>=e)throw new Error(`Invalid round ID: ${t}`);return{roundId:t,config:await this.getRound(t),raisedFunds:await this.getRoundRaisedFunds(t),participants:await this.getRoundParticipants(t),isActive:await this.isRoundActive(t)}}async getUserTotalContribution(t){const e=await this.contract.getUserTotalContribution(t);return{totalFundAmount:Number(e.totalFundAmount)/this.PRICE_PRECISION,totalTokenAllocation:Number(e.totalTokenAllocation)}}async getTransactionStatus(t,e=10){return await(0,o.getTransactionStatus)(this.getRandomProvider(),t,e)}getContractAddress(){return this.contractAddress}async getAllEvents(t,e){return await this.bootstrap(),(0,o.getAllEvents)(this.contract,(()=>this.getRandomProvider()),(()=>this.getContractWithRandomProvider()),t,e)}async streamEvents(t,e,n,r=1e3,a=5e3){return await this.bootstrap(),(0,o.streamEvents)({getProvider:()=>this.getRandomProvider(),getAllEvents:(t,e)=>this.getAllEvents(t,e),formatEvent:t=>this.formatEventArgs(t),onEvent:e,saveLatestBlock:n,fromBlock:t,batchSize:r,sleepTime:a})}async getUserRoundContribution(t,n){const[r,a]=await Promise.all([this.contract.getUserRoundContribution(t,n),this.contract.rounds(t)]),i={fundAmount:Number(r.fundAmount)/this.PRICE_PRECISION,tokenAllocation:Number(r.tokenAllocation),claimed:r.claimed,refunded:r.refunded,contributedToken:r.contributedToken,contributedAmount:Number(r.contributedAmount)},s=Math.floor(Date.now()/1e3),d=a.exists&&!a.ended&&s>=Number(a.startTime)&&s<=Number(a.endTime),u={contribution:i,roundInfo:{exists:a.exists,isActive:d,claimingEnabled:a.claimingEnabled,refundEnabled:a.refundEnabled}};if(i.fundAmount>0){const t=i.contributedToken;let n="ETH",r=18;return t!==e.ethers.ZeroAddress&&([n,r]=await Promise.all([(0,o.getTokenSymbol)(t,this.getRandomProvider()),(0,o.getTokenDecimals)(t,this.getRandomProvider())])),{...u,tokenInfo:{symbol:n,decimals:r}}}return u}};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiia-vault-sdk",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "SDK for AIIA Vault Contract",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",