@bosonprotocol/core-sdk 1.25.0-alpha.3 → 1.25.0-alpha.30

package/src/meta-tx/mixin.ts

@@ -142,14 +142,20 @@ export class MetaTxMixin extends BaseCoreSDK {
   public async signMetaTxReserveRange(
     args: Omit<
       Parameters<typeof handler.signMetaTxReserveRange>[0],
-      "web3Lib" | "metaTxHandlerAddress" | "chainId"
-    >
+      "web3Lib" | "metaTxHandlerAddress" | "chainId" | "to"
+    > & { to: "seller" | "contract" }
   ) {
+    const offer = await getOfferById(this._subgraphUrl, args.offerId);
+
     return handler.signMetaTxReserveRange({
       web3Lib: this._web3Lib,
       metaTxHandlerAddress: this._protocolDiamond,
       chainId: this._chainId,
-      ...args
+      ...args,
+      to:
+        args.to === "contract"
+          ? offer.seller.voucherCloneAddress
+          : offer.seller.assistant
     });
   }
 
@@ -159,25 +165,17 @@ export class MetaTxMixin extends BaseCoreSDK {
       | "web3Lib"
       | "bosonVoucherAddress"
       | "chainId"
-      | "nonce"
       | "forwarderAddress"
       | "batchId"
       | "forwarderAbi"
+      | "relayerUrl"
     >,
     overrides: Partial<{
       batchId: BigNumberish;
     }> = {}
   ) {
-    const signerAddress = await this._web3Lib.getSignerAddress();
     const forwarderAddress = this._contracts.forwarder;
     const batchId = overrides.batchId || 0;
-    const nonce = await getNonce({
-      contractAddress: forwarderAddress,
-      user: signerAddress,
-      web3Lib: this._web3Lib,
-      batchId,
-      forwarderAbi: this._metaTxConfig.forwarderAbi
-    });
     const offerFromSubgraph = await getOfferById(
       this._subgraphUrl,
       args.offerId
@@ -186,10 +184,10 @@ export class MetaTxMixin extends BaseCoreSDK {
       web3Lib: this._web3Lib,
       bosonVoucherAddress: offerFromSubgraph.seller.voucherCloneAddress,
       chainId: this._chainId,
-      nonce,
       forwarderAddress,
       batchId,
       forwarderAbi: this._metaTxConfig.forwarderAbi,
+      relayerUrl: this._metaTxConfig.relayerUrl,
       ...args
     });
   }
@@ -204,6 +202,7 @@ export class MetaTxMixin extends BaseCoreSDK {
       | "forwarderAddress"
       | "batchId"
       | "forwarderAbi"
+      | "relayerUrl"
     >,
     overrides: Partial<{
       batchId: BigNumberish;
@@ -216,26 +215,103 @@ export class MetaTxMixin extends BaseCoreSDK {
     );
     const forwarderAddress = this._contracts.forwarder;
     const batchId = overrides.batchId || 0;
-    const nonce = await getNonce({
-      contractAddress: forwarderAddress,
-      user: sellerAddress,
-      web3Lib: this._web3Lib,
-      batchId,
-      forwarderAbi: this._metaTxConfig.forwarderAbi
-    });
 
     return handler.signMetaTxSetApprovalForAll({
       web3Lib: this._web3Lib,
       bosonVoucherAddress: seller.voucherCloneAddress,
       chainId: this._chainId,
-      nonce,
       forwarderAddress,
       batchId,
       forwarderAbi: this._metaTxConfig.forwarderAbi,
+      relayerUrl: this._metaTxConfig.relayerUrl,
       ...args
     });
   }
 
+  public async signMetaTxSetApprovalForAllToContract(
+    args: Omit<
+      Parameters<typeof handler.signMetaTxSetApprovalForAllToContract>[0],
+      | "web3Lib"
+      | "bosonVoucherAddress"
+      | "chainId"
+      | "nonce"
+      | "forwarderAddress"
+      | "batchId"
+      | "forwarderAbi"
+      | "relayerUrl"
+    >,
+    overrides: Partial<{
+      batchId?: BigNumberish;
+      txGas?: number;
+    }> = {}
+  ) {
+    const sellerAddress = await this._web3Lib.getSignerAddress();
+    const seller = await accounts.subgraph.getSellerByAddress(
+      this._subgraphUrl,
+      sellerAddress
+    );
+    const forwarderAddress = this._contracts.forwarder;
+    const batchId = overrides.batchId || 0;
+
+    return handler.signMetaTxSetApprovalForAllToContract(
+      {
+        web3Lib: this._web3Lib,
+        bosonVoucherAddress: seller.voucherCloneAddress,
+        chainId: this._chainId,
+        forwarderAddress,
+        batchId,
+        forwarderAbi: this._metaTxConfig.forwarderAbi,
+        relayerUrl: this._metaTxConfig.relayerUrl,
+        ...args
+      },
+      {
+        txGas: overrides.txGas
+      }
+    );
+  }
+
+  public async signMetaTxCallExternalContract(
+    args: Omit<
+      Parameters<typeof handler.signMetaTxCallExternalContract>[0],
+      | "web3Lib"
+      | "bosonVoucherAddress"
+      | "chainId"
+      | "nonce"
+      | "forwarderAddress"
+      | "batchId"
+      | "forwarderAbi"
+      | "relayerUrl"
+    >,
+    overrides: Partial<{
+      batchId?: BigNumberish;
+      txGas?: number;
+    }> = {}
+  ) {
+    const sellerAddress = await this._web3Lib.getSignerAddress();
+    const seller = await accounts.subgraph.getSellerByAddress(
+      this._subgraphUrl,
+      sellerAddress
+    );
+    const forwarderAddress = this._contracts.forwarder;
+    const batchId = overrides.batchId || 0;
+
+    return handler.signMetaTxCallExternalContract(
+      {
+        web3Lib: this._web3Lib,
+        bosonVoucherAddress: seller.voucherCloneAddress,
+        chainId: this._chainId,
+        forwarderAddress,
+        batchId,
+        forwarderAbi: this._metaTxConfig.forwarderAbi,
+        relayerUrl: this._metaTxConfig.relayerUrl,
+        ...args
+      },
+      {
+        txGas: overrides.txGas
+      }
+    );
+  }
+
   public async relayBiconomyMetaTransaction(
     contractAddress: string,
     metaTxParams: {
@@ -340,6 +416,44 @@ export class MetaTxMixin extends BaseCoreSDK {
     });
   }
 
+  /**
+   * Encodes and signs a meta transaction for `extendOffer` that can be relayed.
+   * @param args - Meta transaction args.
+   * @returns Signature.
+   */
+  public async signMetaTxExtendOffer(
+    args: Omit<
+      Parameters<typeof handler.signMetaTxExtendOffer>[0],
+      "web3Lib" | "metaTxHandlerAddress" | "chainId"
+    >
+  ) {
+    return handler.signMetaTxExtendOffer({
+      web3Lib: this._web3Lib,
+      metaTxHandlerAddress: this._protocolDiamond,
+      chainId: this._chainId,
+      ...args
+    });
+  }
+
+  /**
+   * Encodes and signs a meta transaction for `extendOfferBatch` that can be relayed.
+   * @param args - Meta transaction args.
+   * @returns Signature.
+   */
+  public async signMetaTxExtendOfferBatch(
+    args: Omit<
+      Parameters<typeof handler.signMetaTxExtendOfferBatch>[0],
+      "web3Lib" | "metaTxHandlerAddress" | "chainId"
+    >
+  ) {
+    return handler.signMetaTxExtendOfferBatch({
+      web3Lib: this._web3Lib,
+      metaTxHandlerAddress: this._protocolDiamond,
+      chainId: this._chainId,
+      ...args
+    });
+  }
+
   /**
    * Encodes and signs a meta transaction for `completeExchangeBatch` that can be relayed.
    * @param args - Meta transaction args.

package/src/metadata/base.graphql

@@ -39,6 +39,9 @@ fragment BaseBaseMetadataEntityFields on BaseMetadataEntity {
   description
   externalUrl
   animationUrl
+  animationMetadata {
+    ...BaseAnimationMetadataFields
+  }
   licenseUrl
   condition
   schemaUrl

package/src/metadata/mixin.ts

@@ -1,6 +1,6 @@
 import { BaseCoreSDK } from "./../mixins/base-core-sdk";
 import * as subgraph from "../subgraph";
-import { AnyMetadata } from "..";
+import { OfferOrSellerMetadata } from "..";
 import {
   getBaseMetadataEntities,
   getProductV1MetadataEntities,
@@ -21,7 +21,7 @@ export class MetadataMixin extends BaseCoreSDK {
    * @param metadata - Offer metadata of type `BASE` or `PRODUCT_V1`.
    * @returns Metadata hash / identifier.
    */
-  public async storeMetadata(metadata: AnyMetadata): Promise<string> {
+  public async storeMetadata(metadata: OfferOrSellerMetadata): Promise<string> {
     if (!this._metadataStorage) {
       throw new Error("No metadata storage set");
     }
@@ -35,7 +35,9 @@ export class MetadataMixin extends BaseCoreSDK {
    * storage instance.
    * @returns Offer metadata.
    */
-  public async getMetadata(metadataHashOrUri: string): Promise<AnyMetadata> {
+  public async getMetadata(
+    metadataHashOrUri: string
+  ): Promise<OfferOrSellerMetadata> {
     if (!this._metadataStorage) {
       throw new Error("No metadata storage set");
     }

package/src/metadata/product-v1.graphql

@@ -129,6 +129,9 @@ fragment BaseProductV1MetadataEntityFields on ProductV1MetadataEntity {
   description
   externalUrl
   animationUrl
+  animationMetadata {
+    ...BaseAnimationMetadataFields
+  }
   licenseUrl
   condition
   schemaUrl
@@ -173,6 +176,13 @@ fragment BaseProductV1MetadataEntityFields on ProductV1MetadataEntity {
   }
 }
 
+fragment BaseAnimationMetadataFields on AnimationMetadata {
+  id
+  width
+  height
+  type
+}
+
 fragment BaseProductV1ProductFields on ProductV1Product {
   id
   uuid
@@ -299,6 +309,8 @@ fragment BaseProductV1MediaFields on ProductV1Media {
   url
   tag
   type
+  width
+  height
 }
 
 fragment BaseProductV1PersonalisationFields on ProductV1Personalisation {
@@ -326,6 +338,7 @@ fragment BaseProductV1SellerFields on ProductV1Seller {
   contactLinks {
     ...BaseProductV1SellerContactLinkFields
   }
+  contactPreference
   seller {
     ...BaseSellerFields
   }

package/src/offers/handler.ts

@@ -73,6 +73,7 @@ export async function reserveRange(args: {
   subgraphUrl: string;
   offerId: BigNumberish;
   length: BigNumberish;
+  to: string;
   web3Lib: Web3LibAdapter;
 }): Promise<TransactionResponse> {
   const offerFromSubgraph = await getOfferById(args.subgraphUrl, args.offerId);
@@ -87,7 +88,7 @@ export async function reserveRange(args: {
 
   return args.web3Lib.sendTransaction({
     to: args.contractAddress,
-    data: encodeReserveRange(args.offerId, args.length)
+    data: encodeReserveRange(args.offerId, args.length, args.to)
   });
 }
 
@@ -145,6 +146,38 @@ export async function voidOfferBatch(args: {
   });
 }
 
+export async function extendOffer(args: {
+  contractAddress: string;
+  subgraphUrl: string;
+  offerId: BigNumberish;
+  validUntil: BigNumberish;
+  web3Lib: Web3LibAdapter;
+}): Promise<TransactionResponse> {
+  return args.web3Lib.sendTransaction({
+    to: args.contractAddress,
+    data: bosonOfferHandlerIface.encodeFunctionData("extendOffer", [
+      args.offerId,
+      args.validUntil
+    ])
+  });
+}
+
+export async function extendOfferBatch(args: {
+  contractAddress: string;
+  subgraphUrl: string;
+  offerIds: BigNumberish[];
+  validUntil: BigNumberish;
+  web3Lib: Web3LibAdapter;
+}): Promise<TransactionResponse> {
+  return args.web3Lib.sendTransaction({
+    to: args.contractAddress,
+    data: bosonOfferHandlerIface.encodeFunctionData("extendOfferBatch", [
+      args.offerIds,
+      args.validUntil
+    ])
+  });
+}
+
 function checkIfOfferVoidable(
   offerId: BigNumberish,
   signerAddress: string,
@@ -159,11 +192,11 @@ function checkIfOfferVoidable(
   }
 
   if (
-    offerFromSubgraph.seller.operator.toLowerCase() !==
+    offerFromSubgraph.seller.assistant.toLowerCase() !==
     signerAddress.toLowerCase()
   ) {
     throw new Error(
-      `Signer with address "${signerAddress}" is not the operator "${offerFromSubgraph.seller.operator}" of offer with id "${offerId}"`
+      `Signer with address "${signerAddress}" is not the assistant "${offerFromSubgraph.seller.assistant}" of offer with id "${offerId}"`
     );
   }
 }

package/src/offers/interface.ts

@@ -132,10 +132,12 @@ export function argsToOfferDurationsStruct(
 
 export function encodeReserveRange(
   offerId: BigNumberish,
-  length: BigNumberish
+  length: BigNumberish,
+  to: string
 ) {
   return bosonOfferHandlerIface.encodeFunctionData("reserveRange", [
     offerId,
-    length
+    length,
+    to
   ]);
 }

package/src/offers/mixin.ts

@@ -146,7 +146,7 @@ export class OfferMixin extends BaseCoreSDK {
 
   /**
    * Voids an existing offer by calling the `OfferHandlerFacet` contract.
-   * This transaction only succeeds if the connected signer is the `operator`.
+   * This transaction only succeeds if the connected signer is the `assistant`.
    * @param offerId - ID of offer to void.
    * @param overrides - Optional overrides.
    * @returns Transaction response.
@@ -167,7 +167,7 @@ export class OfferMixin extends BaseCoreSDK {
 
   /**
    * Voids a batch of existing offers by calling the `OfferHandlerFacet` contract.
-   * This transaction only succeeds if the connected signer is the `operator` of all
+   * This transaction only succeeds if the connected signer is the `assistant` of all
    * provided offers.
    * @param offerIds - IDs of offers to void.
    * @param overrides - Optional overrides.
@@ -187,6 +187,55 @@ export class OfferMixin extends BaseCoreSDK {
     });
   }
 
+  /**
+   * Extends an existing offer by calling the `OfferHandlerFacet` contract.
+   * This transaction only succeeds if the connected signer is the `assistant`.
+   * @param offerId - ID of offer to void.
+   * @param validUntil - new validity date.
+   * @param overrides - Optional overrides.
+   * @returns Transaction response.
+   */
+  public async extendOffer(
+    offerId: BigNumberish,
+    validUntil: BigNumberish,
+    overrides: Partial<{
+      contractAddress: string;
+    }> = {}
+  ): Promise<TransactionResponse> {
+    return offers.handler.extendOffer({
+      offerId,
+      validUntil,
+      web3Lib: this._web3Lib,
+      subgraphUrl: this._subgraphUrl,
+      contractAddress: overrides.contractAddress || this._protocolDiamond
+    });
+  }
+
+  /**
+   * Extends a batch of existing offers by calling the `OfferHandlerFacet` contract.
+   * This transaction only succeeds if the connected signer is the `assistant` of all
+   * provided offers.
+   * @param offerIds - IDs of offers to void.
+   * @param validUntil - new validity date.
+   * @param overrides - Optional overrides.
+   * @returns Transaction response.
+   */
+  public async extendOfferBatch(
+    offerIds: BigNumberish[],
+    validUntil: BigNumberish,
+    overrides: Partial<{
+      contractAddress: string;
+    }> = {}
+  ): Promise<TransactionResponse> {
+    return offers.handler.extendOfferBatch({
+      offerIds,
+      validUntil,
+      web3Lib: this._web3Lib,
+      subgraphUrl: this._subgraphUrl,
+      contractAddress: overrides.contractAddress || this._protocolDiamond
+    });
+  }
+
   /**
    * Returns offer from subgraph.
    * @param offerId - ID of offer.
@@ -255,13 +304,19 @@ export class OfferMixin extends BaseCoreSDK {
   public async reserveRange(
     offerId: BigNumberish,
     length: BigNumberish,
+    to: "seller" | "contract",
     overrides: Partial<{
       contractAddress: string;
     }> = {}
   ): Promise<TransactionResponse> {
+    const offer = await this.getOfferById(offerId);
     return offers.handler.reserveRange({
       offerId,
       length,
+      to:
+        to === "contract"
+          ? offer.seller.voucherCloneAddress
+          : offer.seller.assistant,
       subgraphUrl: this._subgraphUrl,
       contractAddress: overrides.contractAddress || this._protocolDiamond,
       web3Lib: this._web3Lib

package/src/offers/queries.graphql

@@ -94,6 +94,9 @@ fragment BaseOfferFields on Offer {
     description
     externalUrl
     animationUrl
+    animationMetadata {
+      ...BaseAnimationMetadataFields
+    }
     licenseUrl
     condition
     schemaUrl
@@ -128,4 +131,14 @@ fragment BaseOfferFields on Offer {
       }
     }
   }
+  range {
+    ...BaseRangeFields
+  }
+}
+
+fragment BaseRangeFields on RangeEntity {
+  id
+  start
+  end
+  owner
 }

package/src/offers/renderContractualAgreement.ts

@@ -292,21 +292,18 @@ export async function renderContractualAgreementForOffer(
       `Invalid Offer Metadata: Type is not supported: '${existingOfferData.metadata.type}'`
     );
   }
-  if (
-    !(existingOfferData.metadata as productV1.ProductV1Metadata).exchangePolicy
-  ) {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  if (!(existingOfferData.metadata as any).exchangePolicy) {
     throw new Error(`Invalid Offer Metadata: exchangePolicy is not defined`);
   }
-  if (
-    !(existingOfferData.metadata as productV1.ProductV1Metadata).exchangePolicy
-      .template
-  ) {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  if (!(existingOfferData.metadata as any).exchangePolicy.template) {
     throw new Error(
       `Invalid Offer Metadata: exchangePolicy.template is not defined`
     );
   }
-  const template = (existingOfferData.metadata as productV1.ProductV1Metadata)
-    .exchangePolicy.template;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const template = (existingOfferData.metadata as any).exchangePolicy.template;
   const convertedOfferArgs = convertExistingOfferData(existingOfferData);
   return renderContractualAgreement(
     template,

package/src/seaport/abi.ts

@@ -0,0 +1,149 @@
+export const seaportAbi = [
+  {
+    inputs: [
+      {
+        components: [
+          {
+            components: [
+              {
+                internalType: "address",
+                name: "offerer",
+                type: "address"
+              },
+              {
+                internalType: "address",
+                name: "zone",
+                type: "address"
+              },
+              {
+                components: [
+                  {
+                    internalType: "enum ItemType",
+                    name: "itemType",
+                    type: "uint8"
+                  },
+                  {
+                    internalType: "address",
+                    name: "token",
+                    type: "address"
+                  },
+                  {
+                    internalType: "uint256",
+                    name: "identifierOrCriteria",
+                    type: "uint256"
+                  },
+                  {
+                    internalType: "uint256",
+                    name: "startAmount",
+                    type: "uint256"
+                  },
+                  {
+                    internalType: "uint256",
+                    name: "endAmount",
+                    type: "uint256"
+                  }
+                ],
+                internalType: "struct OfferItem[]",
+                name: "offer",
+                type: "tuple[]"
+              },
+              {
+                components: [
+                  {
+                    internalType: "enum ItemType",
+                    name: "itemType",
+                    type: "uint8"
+                  },
+                  {
+                    internalType: "address",
+                    name: "token",
+                    type: "address"
+                  },
+                  {
+                    internalType: "uint256",
+                    name: "identifierOrCriteria",
+                    type: "uint256"
+                  },
+                  {
+                    internalType: "uint256",
+                    name: "startAmount",
+                    type: "uint256"
+                  },
+                  {
+                    internalType: "uint256",
+                    name: "endAmount",
+                    type: "uint256"
+                  },
+                  {
+                    internalType: "address payable",
+                    name: "recipient",
+                    type: "address"
+                  }
+                ],
+                internalType: "struct ConsiderationItem[]",
+                name: "consideration",
+                type: "tuple[]"
+              },
+              {
+                internalType: "enum OrderType",
+                name: "orderType",
+                type: "uint8"
+              },
+              {
+                internalType: "uint256",
+                name: "startTime",
+                type: "uint256"
+              },
+              {
+                internalType: "uint256",
+                name: "endTime",
+                type: "uint256"
+              },
+              {
+                internalType: "bytes32",
+                name: "zoneHash",
+                type: "bytes32"
+              },
+              {
+                internalType: "uint256",
+                name: "salt",
+                type: "uint256"
+              },
+              {
+                internalType: "bytes32",
+                name: "conduitKey",
+                type: "bytes32"
+              },
+              {
+                internalType: "uint256",
+                name: "totalOriginalConsiderationItems",
+                type: "uint256"
+              }
+            ],
+            internalType: "struct OrderParameters",
+            name: "parameters",
+            type: "tuple"
+          },
+          {
+            internalType: "bytes",
+            name: "signature",
+            type: "bytes"
+          }
+        ],
+        internalType: "struct Order[]",
+        name: "",
+        type: "tuple[]"
+      }
+    ],
+    name: "validate",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool"
+      }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  }
+];