aiia-vault-sdk 1.1.30 → 1.2.0

package/dist/FairLaunch.d.ts

@@ -0,0 +1,95 @@
+import { ethers } from "ethers";
+import { type SendTransactionMutateAsync } from "@wagmi/core/query";
+import { Config } from "@wagmi/core/dist/types/createConfig";
+import { ParsedFairLaunchEventRaw, ParsedFairLaunchEvent } from "./types";
+export interface UserContribution {
+    amount: number;
+    tokenAllocation: number;
+    hasClaimedInitial: boolean;
+    vestedClaimed: number;
+    tradingVaultId: number;
+}
+export interface SaleInfo {
+    startTime: number;
+    endTime: number;
+    totalTokensForSale: number;
+    totalRaised: number;
+    tokenPrice: number;
+    saleEnded: boolean;
+    claimingEnabled: boolean;
+    liquidityAdded: boolean;
+}
+export declare class FairLaunchSDK {
+    name: string;
+    private contract;
+    private providers;
+    private contractAddress;
+    private isBootstrapped;
+    private _projectToken;
+    private _fundingToken;
+    private _projectTokenDecimals;
+    private _fundingTokenDecimals;
+    constructor(rpcUrls: string | string[], contractAddress?: string);
+    private getRandomProvider;
+    private getContractWithRandomProvider;
+    bootstrap(): Promise<void>;
+    signAndSendTransaction(tx: ethers.ContractTransaction, wallet: ethers.Wallet | SendTransactionMutateAsync<Config, any>, callbacks?: {
+        onSubmit?: (tx: string) => void | Promise<void>;
+        onFinally?: (status: {
+            status: boolean | null;
+            confirmations: number;
+            txHash: string;
+            isCompleted: boolean;
+            attempts: number;
+        }) => void | Promise<void>;
+        onError?: (error: Error) => void | Promise<void>;
+    }): Promise<{
+        transaction: {
+            hash: string;
+        };
+        status: {
+            status: boolean | null;
+            confirmations: number;
+            isCompleted: boolean;
+            attempts: number;
+        };
+    }>;
+    buildContributeTx(amount: number, recipient: string): Promise<ethers.ContractTransaction>;
+    buildEndSaleTx(): Promise<ethers.ContractTransaction>;
+    buildAddLiquidityTx(): Promise<ethers.ContractTransaction>;
+    buildEnableClaimingTx(): Promise<ethers.ContractTransaction>;
+    buildClaimInitialTx(): Promise<ethers.ContractTransaction>;
+    buildClaimVestedTx(): Promise<ethers.ContractTransaction>;
+    buildUpdateLiquidityTokensTx(liquidityTokens: number): Promise<ethers.ContractTransaction>;
+    buildUpdateLiquidityPercentTx(liquidityPercent: number): Promise<ethers.ContractTransaction>;
+    buildUpdateInitialClaimPercentTx(initialClaimPercent: number): Promise<ethers.ContractTransaction>;
+    buildUpdateVestingDurationTx(vestingDuration: number): Promise<ethers.ContractTransaction>;
+    buildUpdateEarlyParticipationWindowTx(earlyParticipationWindow: number): Promise<ethers.ContractTransaction>;
+    buildWithdrawLPTokensTx(lpToken: string, recipient: string): Promise<ethers.ContractTransaction>;
+    buildWithdrawERC20Tx(token: string, amount: number): Promise<ethers.ContractTransaction>;
+    buildApproveERC20Tx(tokenAddress: string, spender: string, amount: number): Promise<ethers.ContractTransaction>;
+    getSaleInfo(): Promise<SaleInfo>;
+    getUserContribution(user: string): Promise<UserContribution>;
+    getContributorsCount(): Promise<number>;
+    getContributorAt(index: number): Promise<string>;
+    getAllContributors(): Promise<string[]>;
+    getProjectToken(): Promise<string>;
+    getFundingToken(): Promise<string>;
+    getTradingVault(): Promise<string>;
+    getDexRouter(): Promise<string>;
+    getLiquidityTokens(): Promise<number>;
+    getLiquidityPercent(): Promise<number>;
+    getInitialClaimPercent(): Promise<number>;
+    getVestingDuration(): Promise<number>;
+    getVestingStartTime(): Promise<number>;
+    getEarlyParticipationWindow(): Promise<number>;
+    hasOperatorRole(address: string): Promise<boolean>;
+    hasAdminRole(address: string): Promise<boolean>;
+    buildGrantOperatorRoleTx(operator: string): Promise<ethers.ContractTransaction>;
+    buildGrantAdminRoleTx(admin: string): Promise<ethers.ContractTransaction>;
+    getAllowance(tokenAddress: string, owner: string, spender: string): Promise<number>;
+    getContractAddress(): string;
+    getAllEvents(fromBlock: number, toBlock: number, whitelistEvents?: string[]): Promise<any[]>;
+    streamEvents(fromBlock: number, onEvent: (event: any) => Promise<void>, saveLatestBlock: (blockNumber: number) => Promise<void>, batchSize?: number, sleepTime?: number): Promise<void>;
+    formatEventArgs: (event: ParsedFairLaunchEventRaw) => Promise<ParsedFairLaunchEvent>;
+}

package/dist/FairLaunch.js

@@ -0,0 +1 @@
+"use strict";var t=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.FairLaunchSDK=void 0;const e=require("ethers"),i=t(require("./abis/FairLaunch.json")),a=t(require("./contracts.json")),n=require("./utils");exports.FairLaunchSDK=class{constructor(t,r){this.name="FairLaunch",this.isBootstrapped=!1,this._projectToken=null,this._fundingToken=null,this._projectTokenDecimals=null,this._fundingTokenDecimals=null,this.formatEventArgs=async t=>{await this.bootstrap();const{eventName:e,args:i}=t;switch(e){case"Contributed":return{...t,args:{...i,user:i.user.toLowerCase(),amount:Number(i.amount)/10**this._fundingTokenDecimals}};case"SaleEnded":return{...t,args:{...i,totalRaised:Number(i.totalRaised)/10**this._fundingTokenDecimals,tokenPrice:Number(i.tokenPrice)/10**this._fundingTokenDecimals}};case"InitialClaimed":case"VestedClaimed":return{...t,args:{...i,user:i.user.toLowerCase(),amount:Number(i.amount)/10**this._projectTokenDecimals}};case"TradingVaultPositionCreated":return{...t,args:{...i,user:i.user.toLowerCase(),positionId:Number(i.positionId),amount:Number(i.amount)/10**this._fundingTokenDecimals}};case"LiquidityAdded":return{...t,args:{...i,tokenAmount:Number(i.tokenAmount)/10**this._projectTokenDecimals,fundingTokenAmount:Number(i.fundingTokenAmount)/10**this._fundingTokenDecimals}};default:return t}};const o=Array.isArray(t)?t:[t];this.providers=o.map((t=>new e.ethers.JsonRpcProvider(t)));const s=(0,n.getRandomProvider)(this.providers);this.contractAddress=(0,n.resolveContractAddress)(o[0],this.name,a.default,r),this.contract=new e.ethers.Contract(this.contractAddress,i.default.abi,s)}getRandomProvider(){return(0,n.getRandomProvider)(this.providers)}getContractWithRandomProvider(){return new e.ethers.Contract(this.contractAddress,i.default.abi,this.getRandomProvider())}async bootstrap(){if(this.isBootstrapped)return;const t=await Promise.all(this.providers.map(((t,e)=>(0,n.checkRpcHealth)(t,e))));if(this.providers=this.providers.filter(((e,i)=>t[i])),0===this.providers.length)throw new Error("No active RPC providers available");this._projectToken=await this.contract.projectToken(),this._fundingToken=await this.contract.fundingToken();const[e,i]=await Promise.all([(0,n.getTokenDecimals)(this._projectToken,this.getRandomProvider()),(0,n.getTokenDecimals)(this._fundingToken,this.getRandomProvider())]);this._projectTokenDecimals=e,this._fundingTokenDecimals=i,this.isBootstrapped=!0}async signAndSendTransaction(t,e,i={}){return(0,n.signAndSendTransaction)(t,e,(()=>this.getRandomProvider()),i,this.contract)}async buildContributeTx(t,i){await this.bootstrap();const a=e.ethers.parseUnits(t.toString(),this._fundingTokenDecimals);return await this.contract.contribute.populateTransaction(a,i)}async buildEndSaleTx(){return await this.contract.endSale.populateTransaction()}async buildAddLiquidityTx(){return await this.contract.addLiquidity.populateTransaction()}async buildEnableClaimingTx(){return await this.contract.enableClaiming.populateTransaction()}async buildClaimInitialTx(){return await this.contract.claimInitial.populateTransaction()}async buildClaimVestedTx(){return await this.contract.claimVested.populateTransaction()}async buildUpdateLiquidityTokensTx(t){await this.bootstrap();const i=e.ethers.parseUnits(t.toString(),this._projectTokenDecimals);return await this.contract.updateLiquidityTokens.populateTransaction(i)}async buildUpdateLiquidityPercentTx(t){return await this.contract.updateLiquidityPercent.populateTransaction(t)}async buildUpdateInitialClaimPercentTx(t){return await this.contract.updateInitialClaimPercent.populateTransaction(t)}async buildUpdateVestingDurationTx(t){return await this.contract.updateVestingDuration.populateTransaction(t)}async buildUpdateEarlyParticipationWindowTx(t){return await this.contract.updateEarlyParticipationWindow.populateTransaction(t)}async buildWithdrawLPTokensTx(t,e){return await this.contract.withdrawLPTokens.populateTransaction(t,e)}async buildWithdrawERC20Tx(t,i){const a=new e.ethers.Contract(t,["function decimals() view returns (uint8)"],this.getRandomProvider()),n=await a.decimals(),r=e.ethers.parseUnits(i.toString(),n);return await this.contract.withdrawERC20.populateTransaction(t,r)}async buildApproveERC20Tx(t,i,a){const r=new e.ethers.Contract(t,["function decimals() view returns (uint8)"],this.getRandomProvider()),o=await r.decimals(),s=e.ethers.parseUnits(a.toString(),o);return(0,n.buildApproveERC20Tx)(t,i,s,this.getRandomProvider())}async getSaleInfo(){await this.bootstrap();const[t,e,i,a,n,r,o,s]=await Promise.all([this.contract.startTime(),this.contract.endTime(),this.contract.totalTokensForSale(),this.contract.totalRaised(),this.contract.tokenPrice(),this.contract.saleEnded(),this.contract.claimingEnabled(),this.contract.liquidityAdded()]);return{startTime:Number(t),endTime:Number(e),totalTokensForSale:Number(i)/10**this._projectTokenDecimals,totalRaised:Number(a)/10**this._fundingTokenDecimals,tokenPrice:Number(n)/10**this._fundingTokenDecimals,saleEnded:r,claimingEnabled:o,liquidityAdded:s}}async getUserContribution(t){await this.bootstrap();const e=await this.contract.userContributions(t);return{amount:Number(e.amount)/10**this._fundingTokenDecimals,tokenAllocation:Number(e.tokenAllocation)/10**this._projectTokenDecimals,hasClaimedInitial:e.hasClaimedInitial,vestedClaimed:Number(e.vestedClaimed)/10**this._projectTokenDecimals,tradingVaultId:Number(e.tradingVaultId)}}async getContributorsCount(){return Number(await this.contract.getContributorsCount())}async getContributorAt(t){return await this.contract.getContributorAt(t)}async getAllContributors(){const t=await this.getContributorsCount(),e=[];for(let i=0;i<t;i++)e.push(await this.getContributorAt(i));return e}async getProjectToken(){return this._projectToken||(this._projectToken=await this.contract.projectToken()),this._projectToken}async getFundingToken(){return this._fundingToken||(this._fundingToken=await this.contract.fundingToken()),this._fundingToken}async getTradingVault(){return await this.contract.tradingVault()}async getDexRouter(){return await this.contract.dexRouter()}async getLiquidityTokens(){await this.bootstrap();const t=await this.contract.liquidityTokens();return Number(t)/10**this._projectTokenDecimals}async getLiquidityPercent(){return Number(await this.contract.liquidityPercent())}async getInitialClaimPercent(){return Number(await this.contract.initialClaimPercent())}async getVestingDuration(){return Number(await this.contract.vestingDuration())}async getVestingStartTime(){return Number(await this.contract.vestingStartTime())}async getEarlyParticipationWindow(){return Number(await this.contract.earlyParticipationWindow())}async hasOperatorRole(t){const e=await this.contract.OPERATOR_ROLE();return await this.contract.hasRole(e,t)}async hasAdminRole(t){const e=await this.contract.DEFAULT_ADMIN_ROLE();return await this.contract.hasRole(e,t)}async buildGrantOperatorRoleTx(t){const e=await this.contract.OPERATOR_ROLE();return await this.contract.grantRole.populateTransaction(e,t)}async buildGrantAdminRoleTx(t){const e=await this.contract.DEFAULT_ADMIN_ROLE();return await this.contract.grantRole.populateTransaction(e,t)}async getAllowance(t,e,i){const[a,r]=await Promise.all([(0,n.getTokenAllowance)(t,e,i,this.getRandomProvider()),(0,n.getTokenDecimals)(t,this.getRandomProvider())]);return Number(a)/Math.pow(10,r)}getContractAddress(){return this.contractAddress}async getAllEvents(t,e,i){return await this.bootstrap(),(0,n.getAllEvents)(this.contract,(()=>this.getRandomProvider()),(()=>this.getContractWithRandomProvider()),t,e,i)}async streamEvents(t,e,i,a=1e3,r=5e3){const o=["Contributed","SaleEnded","InitialClaimed","VestedClaimed","ClaimingEnabled","LiquidityAdded","TradingVaultPositionCreated"];return await this.bootstrap(),(0,n.streamEvents)({getProvider:()=>this.getRandomProvider(),getAllEvents:(t,e)=>this.getAllEvents(t,e,o),formatEvent:t=>this.formatEventArgs(t),onEvent:e,saveLatestBlock:i,fromBlock:t,batchSize:a,sleepTime:r})}};

package/dist/MultiLevelReferralNFT.d.ts

@@ -0,0 +1,159 @@
+import { ethers } from "ethers";
+import { type SendTransactionMutateAsync } from "@wagmi/core/query";
+import { Config } from "@wagmi/core/dist/types/createConfig";
+import { ParsedMultiLevelReferralNFTEvent, ParsedMultiLevelReferralNFTEventRaw } from "./types";
+export interface ReferralInfo {
+    referrer: string;
+    referralCode: string;
+}
+export interface NFTMintedEvent {
+    owner: string;
+    tokenId: number;
+}
+export interface ReferrerSetEvent {
+    referrer: string;
+    referee: string;
+}
+export interface ReferralPaidEvent {
+    receiver: string;
+    buyer: string;
+    amount: number;
+    level: number;
+    originalAmount: number;
+}
+/**
+ * SDK for interacting with the MultiLevelReferralNFT smart contract
+ *
+ * @remarks
+ * This SDK provides methods to interact with the MultiLevelReferralNFT contract,
+ * including minting NFTs, managing referrals, and handling rewards.
+ */
+export declare class MultiLevelReferralNFTSDK {
+    name: string;
+    private contract;
+    private providers;
+    private contractAddress;
+    private isBootstrapped;
+    /**
+     * Creates a new instance of the MultiLevelReferralNFTSDK
+     *
+     * @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 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
+     */
+    signAndSendTransaction(tx: ethers.ContractTransaction, wallet: ethers.Wallet | SendTransactionMutateAsync<Config, any>, callbacks?: {
+        onSubmit?: (tx: string) => void | Promise<void>;
+        onFinally?: (status: {
+            status: boolean | null;
+            confirmations: number;
+            txHash: string;
+            isCompleted: boolean;
+            attempts: number;
+        }) => void | Promise<void>;
+        onError?: (error: Error) => void | Promise<void>;
+    }): Promise<{
+        transaction: {
+            hash: string;
+        };
+        status: {
+            status: boolean | null;
+            confirmations: number;
+            isCompleted: boolean;
+            attempts: number;
+        };
+    }>;
+    /**
+     * Gets the current NFT price
+     * @returns The current price in ETH
+     */
+    getPrice(): Promise<number>;
+    /**
+     * Gets the share percentage for referrals
+     * @returns The share percentage (e.g., 20 for 20%)
+     */
+    getSharePercent(): Promise<number>;
+    /**
+     * Gets the maximum number of referral levels
+     * @returns The maximum number of referral levels
+     */
+    getMaxReferralLevels(): Promise<number>;
+    /**
+     * Gets the referrer address for a given user
+     * @param user - The user's address
+     * @returns The referrer's address
+     */
+    getReferrer(user: string): Promise<string>;
+    /**
+     * Gets the user address associated with a referral code
+     * @param referralCode - The referral code to look up
+     * @returns The associated user's address
+     */
+    getReferralCodeOwner(referralCode: string): Promise<string>;
+    /**
+     * Gets the referral code for a given user
+     * @param user - The user's address
+     * @returns The user's referral code
+     */
+    getUserReferralCode(user: string): Promise<string>;
+    /**
+     * Builds a transaction to set the NFT price
+     * @param price - The new price in ETH
+     * @returns Populated transaction
+     */
+    buildSetPriceTx(price: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to buy an NFT with a referral code
+     * @param referralCode - The referral code to use
+     * @returns Populated transaction
+     */
+    buildBuyNFTTx(referralCode: string): Promise<ethers.ContractTransaction>;
+    /**
+     * Builds a transaction to withdraw contract balance
+     * @param amount - Amount to withdraw in ETH
+     * @returns Populated transaction
+     */
+    buildWithdrawTx(amount: number): Promise<ethers.ContractTransaction>;
+    /**
+     * Gets the contract owner address
+     * @returns The owner's address
+     */
+    getOwner(): Promise<string>;
+    /**
+     * Gets the contract address
+     * @returns The contract address
+     */
+    getContractAddress(): string;
+    getAllEvents(fromBlock: number, toBlock: number, whitelistEvents?: string[]): Promise<ParsedMultiLevelReferralNFTEventRaw[]>;
+    streamEvents(fromBlock: number, onEvent: (event: ParsedMultiLevelReferralNFTEvent) => Promise<void>, saveLatestBlock: (blockNumber: number) => Promise<void>, batchSize?: number, sleepTime?: number): Promise<void>;
+    formatEventArgs: (event: ParsedMultiLevelReferralNFTEventRaw) => ParsedMultiLevelReferralNFTEvent;
+}

package/dist/MultiLevelReferralNFT.js

@@ -0,0 +1 @@
+"use strict";var e=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.MultiLevelReferralNFTSDK=void 0;const r=require("ethers"),t=e(require("./abis/MultiLevelReferralNFT.json")),s=e(require("./contracts.json")),a=require("./utils");exports.MultiLevelReferralNFTSDK=class{constructor(e,n){this.name="MultiLevelReferralNFT",this.isBootstrapped=!1,this.formatEventArgs=e=>{const{eventName:t,args:s}=e;switch(t){case"NFTMinted":return{...e,args:{...s,owner:s.owner.toLowerCase(),tokenId:Number(s.tokenId)}};case"ReferrerSet":return{...e,args:{...s,referrer:s.referrer.toLowerCase(),referee:s.referee.toLowerCase()}};case"ReferralPaid":return{...e,args:{...s,receiver:s.receiver.toLowerCase(),buyer:s.buyer.toLowerCase(),amount:Number(r.ethers.formatEther(s.amount)),level:Number(s.level),originalAmount:Number(r.ethers.formatEther(s.originalAmount))}};default:return e}};const o=Array.isArray(e)?e:[e];this.providers=o.map((e=>new r.ethers.JsonRpcProvider(e)));const i=(0,a.getRandomProvider)(this.providers);this.contractAddress=(0,a.resolveContractAddress)(o[0],this.name,s.default,n),this.contract=new r.ethers.Contract(this.contractAddress,t.default.abi,i)}getRandomProvider(){return(0,a.getRandomProvider)(this.providers)}getContractWithRandomProvider(){return new r.ethers.Contract(this.contractAddress,t.default.abi,this.getRandomProvider())}async bootstrap(){if(this.isBootstrapped)return;const e=await Promise.all(this.providers.map(((e,r)=>(0,a.checkRpcHealth)(e,r))));if(this.providers=this.providers.filter(((r,t)=>e[t])),0===this.providers.length)throw new Error("No active RPC providers available");this.isBootstrapped=!0}async signAndSendTransaction(e,r,t={}){return(0,a.signAndSendTransaction)(e,r,(()=>this.getRandomProvider()),t,this.contract)}async getPrice(){const e=await this.contract.price();return Number(r.ethers.formatEther(e))}async getSharePercent(){const e=await this.contract.sharePercent();return Number(e)}async getMaxReferralLevels(){const e=await this.contract.maxReferralLevels();return Number(e)}async getReferrer(e){return await this.contract.referrers(e)}async getReferralCodeOwner(e){return await this.contract.referralCodes(e)}async getUserReferralCode(e){return await this.contract.userReferralCodes(e)}async buildSetPriceTx(e){const t=r.ethers.parseEther(e.toString());return await this.contract.setPrice.populateTransaction(t)}async buildBuyNFTTx(e){const t=await this.getPrice(),s=await this.contract.buy.populateTransaction(e);return s.value=r.ethers.parseEther(t.toString()),s}async buildWithdrawTx(e){const t=r.ethers.parseEther(e.toString());return await this.contract.withdraw.populateTransaction(t)}async getOwner(){return await this.contract.owner()}getContractAddress(){return this.contractAddress}async getAllEvents(e,r,t){return await this.bootstrap(),(0,a.getAllEvents)(this.contract,(()=>this.getRandomProvider()),(()=>this.getContractWithRandomProvider()),e,r,t)}async streamEvents(e,r,t,s=1e3,n=5e3){const o=["NFTMinted","ReferrerSet","ReferralPaid"];return await this.bootstrap(),(0,a.streamEvents)({getProvider:()=>this.getRandomProvider(),getAllEvents:(e,r)=>this.getAllEvents(e,r,o),formatEvent:e=>this.formatEventArgs(e),onEvent:r,saveLatestBlock:t,fromBlock:e,batchSize:s,sleepTime:n})}};