@campnetwork/origin 1.2.6 → 1.2.7

package/dist/core.d.ts

@@ -138,10 +138,12 @@ interface Environment {
     ORIGIN_DASHBOARD: string;
     DATANFT_CONTRACT_ADDRESS: string;
     MARKETPLACE_CONTRACT_ADDRESS: string;
+    BATCH_PURCHASE_CONTRACT_ADDRESS: string;
     CHAIN: any;
     IPNFT_ABI?: any;
     MARKETPLACE_ABI?: any;
     TBA_ABI?: any;
+    BATCH_PURCHASE_ABI?: any;
 }
 
 /**
@@ -353,6 +355,135 @@ declare function settlePaymentIntent(this: Origin, paymentIntentResponse: X402Re
  */
 declare function getDataWithIntent(this: Origin, tokenId: bigint, signer?: any, decide?: (terms: any) => Promise<boolean>): Promise<any>;
 
+/**
+ * Parameters for a single purchase in a bulk buy operation.
+ */
+interface BuyParams {
+    tokenId: bigint;
+    expectedPrice: bigint;
+    expectedDuration: number;
+    expectedPaymentToken: Address;
+}
+/**
+ * Result of a tolerant bulk purchase operation.
+ */
+interface TolerantResult {
+    successCount: bigint;
+    failureCount: bigint;
+    totalSpent: bigint;
+    refundAmount: bigint;
+    failedTokenIds: bigint[];
+}
+/**
+ * Preview of bulk purchase costs.
+ */
+interface BulkCostPreview {
+    totalNativeCost: bigint;
+    totalERC20Cost: bigint;
+    validCount: bigint;
+    invalidTokenIds: bigint[];
+}
+/**
+ * Executes an atomic bulk purchase of multiple IP-NFT licenses.
+ * All purchases succeed or all fail together.
+ *
+ * @param buyer The address that will receive the licenses.
+ * @param purchases Array of purchase parameters for each token.
+ * @param value Total native token value to send (sum of all native token purchases).
+ * @returns A promise that resolves with the transaction result.
+ *
+ * @example
+ * ```typescript
+ * const purchases = [
+ *   { tokenId: 1n, expectedPrice: 1000000000000000n, expectedDuration: 86400, expectedPaymentToken: zeroAddress },
+ *   { tokenId: 2n, expectedPrice: 2000000000000000n, expectedDuration: 86400, expectedPaymentToken: zeroAddress },
+ * ];
+ * const totalValue = 3000000000000000n;
+ * await origin.bulkBuyAccess(buyerAddress, purchases, totalValue);
+ * ```
+ */
+declare function bulkBuyAccess(this: Origin, buyer: Address, purchases: BuyParams[], value?: bigint): Promise<any>;
+/**
+ * Executes a fault-tolerant bulk purchase of multiple IP-NFT licenses.
+ * Individual purchases can fail without reverting the entire transaction.
+ * Unused funds are automatically refunded.
+ *
+ * @param buyer The address that will receive the licenses.
+ * @param purchases Array of purchase parameters for each token.
+ * @param value Total native token value to send (can be more than needed; excess is refunded).
+ * @returns A promise that resolves with the tolerant result including success/failure counts.
+ *
+ * @example
+ * ```typescript
+ * const result = await origin.bulkBuyAccessTolerant(buyerAddress, purchases, totalValue);
+ * console.log(`Purchased ${result.successCount} of ${purchases.length} IPs`);
+ * console.log(`Failed tokens: ${result.failedTokenIds}`);
+ * ```
+ */
+declare function bulkBuyAccessTolerant(this: Origin, buyer: Address, purchases: BuyParams[], value?: bigint): Promise<any>;
+/**
+ * Previews the total cost of purchasing multiple IP-NFT licenses.
+ * This is a view function that doesn't require a transaction.
+ *
+ * @param tokenIds Array of token IDs to preview costs for.
+ * @returns A promise that resolves with the cost preview including total costs and invalid tokens.
+ *
+ * @example
+ * ```typescript
+ * const preview = await origin.previewBulkCost([1n, 2n, 3n]);
+ * console.log(`Total cost: ${preview.totalNativeCost} wei`);
+ * console.log(`Valid tokens: ${preview.validCount}`);
+ * ```
+ */
+declare function previewBulkCost(this: Origin, tokenIds: bigint[]): Promise<BulkCostPreview>;
+/**
+ * Builds purchase parameters for multiple tokens by fetching their current license terms.
+ * This is a view function that doesn't require a transaction.
+ *
+ * @param tokenIds Array of token IDs to build parameters for.
+ * @returns A promise that resolves with an array of BuyParams ready for bulk purchase.
+ *
+ * @example
+ * ```typescript
+ * const params = await origin.buildPurchaseParams([1n, 2n, 3n]);
+ * await origin.bulkBuyAccess(buyer, params, totalValue);
+ * ```
+ */
+declare function buildPurchaseParams(this: Origin, tokenIds: bigint[]): Promise<BuyParams[]>;
+/**
+ * Checks the active status of multiple tokens.
+ *
+ * @param tokenIds Array of token IDs to check.
+ * @returns A promise that resolves with an array of boolean flags indicating active status.
+ *
+ * @example
+ * ```typescript
+ * const activeFlags = await origin.checkActiveStatus([1n, 2n, 3n]);
+ * const activeTokens = tokenIds.filter((_, i) => activeFlags[i]);
+ * ```
+ */
+declare function checkActiveStatus(this: Origin, tokenIds: bigint[]): Promise<boolean[]>;
+/**
+ * Smart bulk purchase that automatically fetches terms and handles the entire purchase flow.
+ * This is the recommended method for most use cases.
+ *
+ * @param tokenIds Array of token IDs to purchase.
+ * @param options Optional configuration for the purchase.
+ * @returns A promise that resolves with the transaction result.
+ *
+ * @example
+ * ```typescript
+ * // Atomic purchase - all succeed or all fail
+ * const result = await origin.bulkBuyAccessSmart([1n, 2n, 3n]);
+ *
+ * // Tolerant purchase - continue even if some fail
+ * const result = await origin.bulkBuyAccessSmart([1n, 2n, 3n], { tolerant: true });
+ * ```
+ */
+declare function bulkBuyAccessSmart(this: Origin, tokenIds: bigint[], options?: {
+    tolerant?: boolean;
+}): Promise<any>;
+
 interface RoyaltyInfo {
     tokenBoundAccount: Address;
     balance: bigint;
@@ -390,6 +521,12 @@ declare class Origin {
     subscriptionExpiry: typeof subscriptionExpiry;
     settlePaymentIntent: typeof settlePaymentIntent;
     getDataWithIntent: typeof getDataWithIntent;
+    bulkBuyAccess: typeof bulkBuyAccess;
+    bulkBuyAccessTolerant: typeof bulkBuyAccessTolerant;
+    bulkBuyAccessSmart: typeof bulkBuyAccessSmart;
+    previewBulkCost: typeof previewBulkCost;
+    buildPurchaseParams: typeof buildPurchaseParams;
+    checkActiveStatus: typeof checkActiveStatus;
     private jwt?;
     environment: Environment;
     private viemClient?;
@@ -704,4 +841,4 @@ declare class Auth {
     unlinkTelegram(): Promise<any>;
 }
 
-export { Auth, type BaseSigner, BrowserStorage, CustomSignerAdapter, DataStatus, EthersSignerAdapter, type LicenseTerms, MemoryStorage, Origin, type SignerAdapter, type SignerType, type StorageAdapter, ViemSignerAdapter, mainnet as campMainnet, testnet as campTestnet, createLicenseTerms, createNodeWalletClient, createSignerAdapter };
+export { Auth, type BaseSigner, BrowserStorage, type BulkCostPreview, type BuyParams, CustomSignerAdapter, DataStatus, EthersSignerAdapter, type LicenseTerms, MemoryStorage, Origin, type SignerAdapter, type SignerType, type StorageAdapter, type TolerantResult, ViemSignerAdapter, mainnet as campMainnet, testnet as campTestnet, createLicenseTerms, createNodeWalletClient, createSignerAdapter };

package/dist/core.esm.d.ts

@@ -138,10 +138,12 @@ interface Environment {
     ORIGIN_DASHBOARD: string;
     DATANFT_CONTRACT_ADDRESS: string;
     MARKETPLACE_CONTRACT_ADDRESS: string;
+    BATCH_PURCHASE_CONTRACT_ADDRESS: string;
     CHAIN: any;
     IPNFT_ABI?: any;
     MARKETPLACE_ABI?: any;
     TBA_ABI?: any;
+    BATCH_PURCHASE_ABI?: any;
 }
 
 /**
@@ -353,6 +355,135 @@ declare function settlePaymentIntent(this: Origin, paymentIntentResponse: X402Re
  */
 declare function getDataWithIntent(this: Origin, tokenId: bigint, signer?: any, decide?: (terms: any) => Promise<boolean>): Promise<any>;
 
+/**
+ * Parameters for a single purchase in a bulk buy operation.
+ */
+interface BuyParams {
+    tokenId: bigint;
+    expectedPrice: bigint;
+    expectedDuration: number;
+    expectedPaymentToken: Address;
+}
+/**
+ * Result of a tolerant bulk purchase operation.
+ */
+interface TolerantResult {
+    successCount: bigint;
+    failureCount: bigint;
+    totalSpent: bigint;
+    refundAmount: bigint;
+    failedTokenIds: bigint[];
+}
+/**
+ * Preview of bulk purchase costs.
+ */
+interface BulkCostPreview {
+    totalNativeCost: bigint;
+    totalERC20Cost: bigint;
+    validCount: bigint;
+    invalidTokenIds: bigint[];
+}
+/**
+ * Executes an atomic bulk purchase of multiple IP-NFT licenses.
+ * All purchases succeed or all fail together.
+ *
+ * @param buyer The address that will receive the licenses.
+ * @param purchases Array of purchase parameters for each token.
+ * @param value Total native token value to send (sum of all native token purchases).
+ * @returns A promise that resolves with the transaction result.
+ *
+ * @example
+ * ```typescript
+ * const purchases = [
+ *   { tokenId: 1n, expectedPrice: 1000000000000000n, expectedDuration: 86400, expectedPaymentToken: zeroAddress },
+ *   { tokenId: 2n, expectedPrice: 2000000000000000n, expectedDuration: 86400, expectedPaymentToken: zeroAddress },
+ * ];
+ * const totalValue = 3000000000000000n;
+ * await origin.bulkBuyAccess(buyerAddress, purchases, totalValue);
+ * ```
+ */
+declare function bulkBuyAccess(this: Origin, buyer: Address, purchases: BuyParams[], value?: bigint): Promise<any>;
+/**
+ * Executes a fault-tolerant bulk purchase of multiple IP-NFT licenses.
+ * Individual purchases can fail without reverting the entire transaction.
+ * Unused funds are automatically refunded.
+ *
+ * @param buyer The address that will receive the licenses.
+ * @param purchases Array of purchase parameters for each token.
+ * @param value Total native token value to send (can be more than needed; excess is refunded).
+ * @returns A promise that resolves with the tolerant result including success/failure counts.
+ *
+ * @example
+ * ```typescript
+ * const result = await origin.bulkBuyAccessTolerant(buyerAddress, purchases, totalValue);
+ * console.log(`Purchased ${result.successCount} of ${purchases.length} IPs`);
+ * console.log(`Failed tokens: ${result.failedTokenIds}`);
+ * ```
+ */
+declare function bulkBuyAccessTolerant(this: Origin, buyer: Address, purchases: BuyParams[], value?: bigint): Promise<any>;
+/**
+ * Previews the total cost of purchasing multiple IP-NFT licenses.
+ * This is a view function that doesn't require a transaction.
+ *
+ * @param tokenIds Array of token IDs to preview costs for.
+ * @returns A promise that resolves with the cost preview including total costs and invalid tokens.
+ *
+ * @example
+ * ```typescript
+ * const preview = await origin.previewBulkCost([1n, 2n, 3n]);
+ * console.log(`Total cost: ${preview.totalNativeCost} wei`);
+ * console.log(`Valid tokens: ${preview.validCount}`);
+ * ```
+ */
+declare function previewBulkCost(this: Origin, tokenIds: bigint[]): Promise<BulkCostPreview>;
+/**
+ * Builds purchase parameters for multiple tokens by fetching their current license terms.
+ * This is a view function that doesn't require a transaction.
+ *
+ * @param tokenIds Array of token IDs to build parameters for.
+ * @returns A promise that resolves with an array of BuyParams ready for bulk purchase.
+ *
+ * @example
+ * ```typescript
+ * const params = await origin.buildPurchaseParams([1n, 2n, 3n]);
+ * await origin.bulkBuyAccess(buyer, params, totalValue);
+ * ```
+ */
+declare function buildPurchaseParams(this: Origin, tokenIds: bigint[]): Promise<BuyParams[]>;
+/**
+ * Checks the active status of multiple tokens.
+ *
+ * @param tokenIds Array of token IDs to check.
+ * @returns A promise that resolves with an array of boolean flags indicating active status.
+ *
+ * @example
+ * ```typescript
+ * const activeFlags = await origin.checkActiveStatus([1n, 2n, 3n]);
+ * const activeTokens = tokenIds.filter((_, i) => activeFlags[i]);
+ * ```
+ */
+declare function checkActiveStatus(this: Origin, tokenIds: bigint[]): Promise<boolean[]>;
+/**
+ * Smart bulk purchase that automatically fetches terms and handles the entire purchase flow.
+ * This is the recommended method for most use cases.
+ *
+ * @param tokenIds Array of token IDs to purchase.
+ * @param options Optional configuration for the purchase.
+ * @returns A promise that resolves with the transaction result.
+ *
+ * @example
+ * ```typescript
+ * // Atomic purchase - all succeed or all fail
+ * const result = await origin.bulkBuyAccessSmart([1n, 2n, 3n]);
+ *
+ * // Tolerant purchase - continue even if some fail
+ * const result = await origin.bulkBuyAccessSmart([1n, 2n, 3n], { tolerant: true });
+ * ```
+ */
+declare function bulkBuyAccessSmart(this: Origin, tokenIds: bigint[], options?: {
+    tolerant?: boolean;
+}): Promise<any>;
+
 interface RoyaltyInfo {
     tokenBoundAccount: Address;
     balance: bigint;
@@ -390,6 +521,12 @@ declare class Origin {
     subscriptionExpiry: typeof subscriptionExpiry;
     settlePaymentIntent: typeof settlePaymentIntent;
     getDataWithIntent: typeof getDataWithIntent;
+    bulkBuyAccess: typeof bulkBuyAccess;
+    bulkBuyAccessTolerant: typeof bulkBuyAccessTolerant;
+    bulkBuyAccessSmart: typeof bulkBuyAccessSmart;
+    previewBulkCost: typeof previewBulkCost;
+    buildPurchaseParams: typeof buildPurchaseParams;
+    checkActiveStatus: typeof checkActiveStatus;
     private jwt?;
     environment: Environment;
     private viemClient?;
@@ -704,4 +841,4 @@ declare class Auth {
     unlinkTelegram(): Promise<any>;
 }
 
-export { Auth, type BaseSigner, BrowserStorage, CustomSignerAdapter, DataStatus, EthersSignerAdapter, type LicenseTerms, MemoryStorage, Origin, type SignerAdapter, type SignerType, type StorageAdapter, ViemSignerAdapter, mainnet as campMainnet, testnet as campTestnet, createLicenseTerms, createNodeWalletClient, createSignerAdapter };
+export { Auth, type BaseSigner, BrowserStorage, type BulkCostPreview, type BuyParams, CustomSignerAdapter, DataStatus, EthersSignerAdapter, type LicenseTerms, MemoryStorage, Origin, type SignerAdapter, type SignerType, type StorageAdapter, type TolerantResult, ViemSignerAdapter, mainnet as campMainnet, testnet as campTestnet, createLicenseTerms, createNodeWalletClient, createSignerAdapter };