@nexusmutual/sdk 0.6.6 → 0.7.0-rc2

package/README.md

@@ -12,7 +12,7 @@ This package only exports CommonJS modules. You can import it like this:
 
 ```js
 // Usage with ES6 modules
-import { products, productTypes } from '@nexusmutual/sdk'
+import { products, productTypes } from '@nexusmutual/sdk';
 ```
 
 ## Nexus Mutual contract addresses and abis
@@ -25,6 +25,7 @@ The `products` folder contains all protocols listed on Nexus Mutual.
 
 If you're a protocol owner and want to update any details (i.e. logo, website, etc), please submit a PR.
 Logos should meet the following criteria:
+
 - svg format, with 1:1 ratio
 - no fixed width or height
 - the image should reach the edge of the viewbox
@@ -41,9 +42,95 @@ npm ci
 
 Copy the `.env.example` file into `.env` and populate with the required values.
 
-
 ### Build locally
 
 ```
 npm build
-```
+```
+
+## IPFS Upload Utils
+
+Use the `uploadIPFSContent` function from `src/ipfs/uploadIPFSContent.ts` to upload the content to IPFS. The function takes the following parameters:
+
+- `type`: The type of the content. Based on ContentType enum.
+- `content`: The content to be uploaded to IPFS as IPFSContentTypes.
+
+The function returns the IPFS hash of the uploaded content.
+
+### Example
+
+```typescript
+import { uploadIPFSContent, ContentType, IPFSContentTypes } from '@nexusmutual/sdk';
+
+const content: IPFSContentTypes = {
+  version: '2.0.',
+  walletAddresses: ['0x1234567890'],
+};
+
+const ipfsHash = await uploadIPFSContent(ContentType.coverWalletAddresses, content);
+
+console.log(ipfsHash);
+```
+
+## getQuoteAndBuyCoverInputs
+
+Use the `getQuoteAndBuyCoverInputs` function from `src/cover/getQuoteAndBuyCoverInputs.ts` to get the inputs required to get a quote and buy cover. The function has 2 overloads. One allows you to pass an IPFS Cid for the cover metadata, and the other allows you to pass the cover metadata directly. The function returns the inputs required to get a quote and buy cover.
+
+### Example
+
+1st overload:
+
+```typescript
+import { getQuoteAndBuyCoverInputs } from '@nexusmutual/sdk';
+
+const productId = 1;
+const coverAmount = '100';
+const coverPeriod = 30;
+const coverAsset = CoverAsset.ETH;
+const buyerAddress = '0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5';
+const ipfsCid = 'QmYfSDbuQLqJ2MAG3ATRjUPVFQubAhAM5oiYuuu9Kfs8RY';
+
+const quoteAndBuyCoverInputs = await getQuoteAndBuyCoverInputs(
+  productId,
+  coverAmount,
+  coverPeriod,
+  coverAsset,
+  buyerAddress,
+  undefined,
+  ipfsCid,
+);
+
+console.log(quoteAndBuyCoverInputs);
+```
+
+2nd overload:
+
+```typescript
+import { getQuoteAndBuyCoverInputs, IPFSContentTypes } from '@nexusmutual/sdk';
+
+const productId = 247;
+const coverAmount = '100';
+const coverPeriod = 30;
+const coverAsset = CoverAsset.ETH;
+const buyerAddress = '0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5';
+const ipfsContent: IPFSContentTypes = {
+  version: '2.0.',
+  walletAddresses: ['0x1234567890'],
+};
+
+const quoteAndBuyCoverInputs = await getQuoteAndBuyCoverInputs(
+  productId,
+  coverAmount,
+  coverPeriod,
+  coverAsset,
+  buyerAddress,
+  ipfsContent,
+);
+
+console.log(quoteAndBuyCoverInputs);
+```
+
+If you pass The `ipfsContent` param, the function will upload the content to IPFS and use the IPFS hash returned for the buy cover inputs `ipfsData` param. If you pass the `ipfsCid` param, the function will use the IPFS hash directly.
+
+The `ipfsCid` param must be a valid IPFS Cid.
+The `ipfsContent` param must be a valid `IPFSContentTypes` - the allowed types can be found in `src/types/ipfs.ts`.

package/dist/data/products.json

@@ -2797,7 +2797,7 @@
       "ETH"
     ],
     "isPrivate": false,
-    "timestamp": 1723127459,
+    "timestamp": 1731583079,
     "minPrice": 100
   },
   {
@@ -3065,7 +3065,7 @@
       "USDC"
     ],
     "isPrivate": false,
-    "timestamp": 1734557999,
+    "timestamp": 1731583079,
     "minPrice": 100
   },
   {
@@ -4049,7 +4049,7 @@
       "USDC"
     ],
     "isPrivate": false,
-    "timestamp": 1722950807,
+    "timestamp": 1723127459,
     "minPrice": 100
   },
   {
@@ -4084,7 +4084,7 @@
       "cbBTC"
     ],
     "isPrivate": false,
-    "timestamp": 1731583079,
+    "timestamp": 1734557999,
     "minPrice": 100
   },
   {
@@ -4143,7 +4143,7 @@
       "cbBTC"
     ],
     "isPrivate": false,
-    "timestamp": 1734557999,
+    "timestamp": 1726227311,
     "minPrice": 100
   },
   {
@@ -4181,7 +4181,7 @@
       "cbBTC"
     ],
     "isPrivate": false,
-    "timestamp": 1734557999,
+    "timestamp": 1725264851,
     "minPrice": 100
   },
   {
@@ -4201,7 +4201,7 @@
       "cbBTC"
     ],
     "isPrivate": true,
-    "timestamp": 1726227311,
+    "timestamp": 1725264851,
     "minPrice": 100
   },
   {
@@ -4239,7 +4239,7 @@
       "cbBTC"
     ],
     "isPrivate": false,
-    "timestamp": 1734557999,
+    "timestamp": 1731583079,
     "minPrice": 100
   },
   {
@@ -4368,7 +4368,7 @@
       "USDC"
     ],
     "isPrivate": false,
-    "timestamp": 1734557999,
+    "timestamp": 1726758407,
     "minPrice": 100
   },
   {
@@ -4552,7 +4552,7 @@
       "USDC"
     ],
     "isPrivate": true,
-    "timestamp": 1733326763,
+    "timestamp": 1733753135,
     "minPrice": 100
   },
   {
@@ -4571,7 +4571,7 @@
       "cbBTC"
     ],
     "isPrivate": false,
-    "timestamp": 1734557999,
+    "timestamp": 1733326763,
     "minPrice": 100
   },
   {

package/dist/index.d.mts

@@ -124,21 +124,127 @@ type GetQuoteResponse = {
 };
 type GetQuoteApiResponse = ApiResponse<GetQuoteResponse, undefined>;
 
-/**
- * Retrieves a quote for buying cover and prepares the necessary inputs for CoverBroker.buyCover method
- * The cover must be purchased using the same asset as the cover
- *
- * @param {Integer} productId - The ID of the product for which cover is being purchased.
- * @param {IntString} coverAmount - The amount of cover in smallest unit of currency (i.e. wei)
- * @param {Integer} coverPeriod - The duration of the cover in days (28-365).
- * @param {CoverAsset} coverAsset - The asset for which cover is being purchased; the purchase must use the same asset.
- * @param {Address} coverBuyerAddress - The Ethereum address of the buyer.
- * @param {number} slippage - The acceptable slippage percentage. Must be between 0-1 (Defaults to 0.001 ~ 0.1%)
- * @param {string} ipfsCid - The IPFS CID for additional data (optional).
- * @param {string} coverRouterUrl - Used to override the default CoverRouter URL which is bundled this library.
- * @return {Promise<GetQuoteApiResponse | ErrorApiResponse>} Returns a successful quote response or an error response.
- */
+declare enum ContentType {
+    coverValidators = "coverValidators",
+    coverQuotaShare = "coverQuotaShare",
+    coverAumCoverAmountPercentage = "coverAumCoverAmountPercentage",
+    coverWalletAddress = "coverWalletAddress",
+    coverWalletAddresses = "coverWalletAddresses",
+    coverFreeText = "coverFreeText",
+    stakingPoolDetails = "stakingPoolDetails",
+    claimProof = "claimProof",
+    assessmentCriteriaAnswers = "assessmentCriteriaAnswers",
+    governanceProposal = "governanceProposal",
+    governanceCategory = "governanceCategory"
+}
+type CoverValidators = {
+    version: '1.0';
+    validators: string[];
+};
+type CoverQuotaShare = {
+    version: '1.0';
+    quotaShare: number;
+};
+type CoverAumCoverAmountPercentage = {
+    version: '1.0';
+    aumCoverAmountPercentage: number;
+};
+type CoverWalletAddress = {
+    version: '1.0';
+    walletAddress: string;
+};
+type CoverWalletAddresses = {
+    version: '1.0';
+    walletAddresses: string;
+} | {
+    version: '2.0';
+    walletAddresses: string[];
+};
+type CoverFreeText = {
+    version: '1.0';
+    freeText: string;
+};
+type StakingPoolDetails = {
+    version: '1.0';
+    poolName: string;
+    poolDescription: string;
+};
+type ClaimProof = {
+    version: '1.0';
+    coverId: number;
+    affectedAddresses: string[];
+    affectedChain: string;
+    incidentDescription: string;
+    incidentTransactionHashes: string[];
+    incidentEvidenceLinks: string[];
+    attachedFilesHashes: string[];
+};
+type AssessmentCriteriaAnswers = {
+    version: '1.0';
+    answers: Record<string, string>;
+};
+type GovernanceProposal = {
+    version: '1.0';
+    proposal: string;
+};
+type GovernanceCategory = {
+    version: '1.0';
+    category: string;
+};
+type IPFSContentTypes = CoverValidators | CoverQuotaShare | CoverAumCoverAmountPercentage | CoverWalletAddress | CoverWalletAddresses | CoverFreeText | StakingPoolDetails | ClaimProof | AssessmentCriteriaAnswers | GovernanceProposal | GovernanceCategory;
+type IPFSContentAndType = [type: ContentType.coverValidators, content: CoverValidators] | [type: ContentType.coverQuotaShare, content: CoverQuotaShare] | [type: ContentType.coverAumCoverAmountPercentage, content: CoverAumCoverAmountPercentage] | [type: ContentType.coverWalletAddress, content: CoverWalletAddress] | [type: ContentType.coverWalletAddresses, content: CoverWalletAddresses] | [type: ContentType.coverFreeText, content: CoverFreeText] | [type: ContentType.stakingPoolDetails, content: StakingPoolDetails] | [type: ContentType.claimProof, content: ClaimProof] | [type: ContentType.assessmentCriteriaAnswers, content: AssessmentCriteriaAnswers] | [type: ContentType.governanceProposal, content: GovernanceProposal] | [type: ContentType.governanceCategory, content: GovernanceCategory];
+declare const IPFS_CONTENT_TYPE_BY_PRODUCT_TYPE: {
+    6: ContentType;
+    5: ContentType;
+    4: ContentType;
+    7: ContentType;
+    10: ContentType;
+    16: ContentType;
+    19: ContentType;
+    17: ContentType;
+    14: ContentType;
+    20: ContentType;
+    0: undefined;
+    1: undefined;
+    2: undefined;
+    3: undefined;
+    8: undefined;
+    9: undefined;
+    11: undefined;
+    12: undefined;
+    13: undefined;
+    15: undefined;
+    18: undefined;
+};
+interface IPFSContentForProductType {
+    [ProductTypes.ethSlashing]: CoverValidators;
+    [ProductTypes.liquidCollectiveEthStaking]: CoverValidators;
+    [ProductTypes.stakewiseEthStaking]: CoverValidators;
+    [ProductTypes.sherlockQuotaShare]: CoverQuotaShare;
+    [ProductTypes.unoReQuotaShare]: CoverQuotaShare;
+    [ProductTypes.deFiPass]: CoverWalletAddress;
+    [ProductTypes.nexusMutual]: CoverWalletAddresses;
+    [ProductTypes.followOn]: CoverFreeText;
+    [ProductTypes.fundPortfolio]: CoverAumCoverAmountPercentage;
+    [ProductTypes.generalisedFundPortfolio]: CoverAumCoverAmountPercentage;
+    [ProductTypes.protocol]: undefined;
+    [ProductTypes.custody]: undefined;
+    [ProductTypes.yieldToken]: undefined;
+    [ProductTypes.sherlockExcess]: undefined;
+    [ProductTypes.nativeProtocol]: undefined;
+    [ProductTypes.theRetailMutual]: undefined;
+    [ProductTypes.bundledProtocol]: undefined;
+    [ProductTypes.ethSlashingUmbrella]: undefined;
+    [ProductTypes.openCoverTransaction]: undefined;
+    [ProductTypes.sherlockBugBounty]: undefined;
+    [ProductTypes.immunefiBugBounty]: undefined;
+}
+type IPFSUploadServiceResponse = {
+    ipfsHash: string;
+};
+
 declare function getQuoteAndBuyCoverInputs(productId: Integer, coverAmount: IntString, coverPeriod: Integer, coverAsset: CoverAsset, coverBuyerAddress: Address, slippage?: number, ipfsCid?: string, coverRouterUrl?: string): Promise<GetQuoteApiResponse | ErrorApiResponse>;
+declare function getQuoteAndBuyCoverInputs<ProductTypes extends keyof IPFSContentForProductType>(productId: Integer, coverAmount: IntString, coverPeriod: Integer, coverAsset: CoverAsset, coverBuyerAddress: Address, slippage?: number, ipfsContent?: IPFSContentForProductType[ProductTypes], coverRouterUrl?: string): Promise<GetQuoteApiResponse | ErrorApiResponse>;
 
 type Reserves = {
     ethReserve: bigint;
@@ -3117,7 +3223,7 @@ var products = [
 			"ETH"
 		],
 		isPrivate: false,
-		timestamp: 1723127459,
+		timestamp: 1731583079,
 		minPrice: 100
 	},
 	{
@@ -3386,7 +3492,7 @@ var products = [
 			"USDC"
 		],
 		isPrivate: false,
-		timestamp: 1734557999,
+		timestamp: 1731583079,
 		minPrice: 100
 	},
 	{
@@ -4385,7 +4491,7 @@ var products = [
 			"USDC"
 		],
 		isPrivate: false,
-		timestamp: 1722950807,
+		timestamp: 1723127459,
 		minPrice: 100
 	},
 	{
@@ -4420,7 +4526,7 @@ var products = [
 			"cbBTC"
 		],
 		isPrivate: false,
-		timestamp: 1731583079,
+		timestamp: 1734557999,
 		minPrice: 100
 	},
 	{
@@ -4479,7 +4585,7 @@ var products = [
 			"cbBTC"
 		],
 		isPrivate: false,
-		timestamp: 1734557999,
+		timestamp: 1726227311,
 		minPrice: 100
 	},
 	{
@@ -4518,7 +4624,7 @@ var products = [
 			"cbBTC"
 		],
 		isPrivate: false,
-		timestamp: 1734557999,
+		timestamp: 1725264851,
 		minPrice: 100
 	},
 	{
@@ -4538,7 +4644,7 @@ var products = [
 			"cbBTC"
 		],
 		isPrivate: true,
-		timestamp: 1726227311,
+		timestamp: 1725264851,
 		minPrice: 100
 	},
 	{
@@ -4576,7 +4682,7 @@ var products = [
 			"cbBTC"
 		],
 		isPrivate: false,
-		timestamp: 1734557999,
+		timestamp: 1731583079,
 		minPrice: 100
 	},
 	{
@@ -4709,7 +4815,7 @@ var products = [
 			"USDC"
 		],
 		isPrivate: false,
-		timestamp: 1734557999,
+		timestamp: 1726758407,
 		minPrice: 100
 	},
 	{
@@ -4897,7 +5003,7 @@ var products = [
 			"USDC"
 		],
 		isPrivate: true,
-		timestamp: 1733326763,
+		timestamp: 1733753135,
 		minPrice: 100
 	},
 	{
@@ -4916,7 +5022,7 @@ var products = [
 			"cbBTC"
 		],
 		isPrivate: false,
-		timestamp: 1734557999,
+		timestamp: 1733326763,
 		minPrice: 100
 	},
 	{
@@ -5165,7 +5271,33 @@ declare const nexusSdk: {
     productCategoryMap: {
         [productId: number]: ProductCategoryEnum;
     };
+    uploadIPFSContent: (...[type, content]: IPFSContentAndType) => Promise<string>;
+    validateIPFSCid: (ipfsCid: string) => void;
     getQuoteAndBuyCoverInputs: typeof getQuoteAndBuyCoverInputs;
+    ContentType: typeof ContentType;
+    IPFS_CONTENT_TYPE_BY_PRODUCT_TYPE: {
+        6: ContentType;
+        5: ContentType;
+        4: ContentType;
+        7: ContentType;
+        10: ContentType;
+        16: ContentType;
+        19: ContentType;
+        17: ContentType;
+        14: ContentType;
+        20: ContentType;
+        0: undefined;
+        1: undefined;
+        2: undefined;
+        3: undefined;
+        8: undefined;
+        9: undefined;
+        11: undefined;
+        12: undefined;
+        13: undefined;
+        15: undefined;
+        18: undefined;
+    };
     calculatePremiumWithCommissionAndSlippage: (premium: bigint, commission?: number, slippage?: number) => bigint;
     calculateExactNxmForEth: (ethIn: bigint, reserves: Reserves) => bigint;
     calculateExactEthForNxm: (nxmIn: bigint, reserves: Reserves) => bigint;
@@ -42099,4 +42231,4 @@ declare const productsMap: Record<number, {
     minPrice: number;
 }>;
 
-export { Address, ApiResponse, BuyCoverInput, BuyCoverParams, COMMISSION_DENOMINATOR, Capacity, CoverAsset, CoverId, CoverRouterProductCapacityResponse, CoverRouterQuoteResponse, DEFAULT_COMMISSION_RATIO, DEFAULT_SLIPPAGE, ErrorApiResponse, ErrorResponse, FloatString, GetQuoteApiResponse, GetQuoteResponse, IntString, Integer, LogoFileName, LogoName, MAXIMUM_COVER_PERIOD, MINIMUM_COVER_PERIOD, NEXUS_MUTUAL_DAO_TREASURY_ADDRESS, PoolAllocationRequest, PoolCapacity, ProductCategoryEnum, ProductTypes, Quote, QuoteDisplayInfo, Reserves, SLIPPAGE_DENOMINATOR, TARGET_PRICE_DENOMINATOR, allLogoFileNames, allLogoNames, allPrivateProductsIds, calculateEthForExactNxm, calculateExactEthForNxm, calculateExactNxmForEth, calculateNxmForExactEth, calculatePremiumWithCommissionAndSlippage, calculatePriceImpactA, calculatePriceImpactB, calculateSpotPrice, categoryLabelByEnum, nexusSdk as default, getQuoteAndBuyCoverInputs, productCategoryMap, productTypes, products, productsMap };
+export { Address, ApiResponse, BuyCoverInput, BuyCoverParams, COMMISSION_DENOMINATOR, Capacity, ContentType, CoverAsset, CoverId, CoverRouterProductCapacityResponse, CoverRouterQuoteResponse, DEFAULT_COMMISSION_RATIO, DEFAULT_SLIPPAGE, ErrorApiResponse, ErrorResponse, FloatString, GetQuoteApiResponse, GetQuoteResponse, IPFSContentAndType, IPFSContentForProductType, IPFSContentTypes, IPFSUploadServiceResponse, IPFS_CONTENT_TYPE_BY_PRODUCT_TYPE, IntString, Integer, LogoFileName, LogoName, MAXIMUM_COVER_PERIOD, MINIMUM_COVER_PERIOD, NEXUS_MUTUAL_DAO_TREASURY_ADDRESS, PoolAllocationRequest, PoolCapacity, ProductCategoryEnum, ProductTypes, Quote, QuoteDisplayInfo, Reserves, SLIPPAGE_DENOMINATOR, TARGET_PRICE_DENOMINATOR, allLogoFileNames, allLogoNames, allPrivateProductsIds, calculateEthForExactNxm, calculateExactEthForNxm, calculateExactNxmForEth, calculateNxmForExactEth, calculatePremiumWithCommissionAndSlippage, calculatePriceImpactA, calculatePriceImpactB, calculateSpotPrice, categoryLabelByEnum, nexusSdk as default, getQuoteAndBuyCoverInputs, productCategoryMap, productTypes, products, productsMap };