@medialane/sdk 0.13.0 → 0.14.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { AccountInterface, constants, TypedData } from 'starknet';
+import { Call, AccountInterface, constants, TypedData } from 'starknet';
 
 /** Medialane Protocol ERC-721 marketplace — immutable, no admin key. */
 declare const MARKETPLACE_721_CONTRACT_MAINNET = "0x00f8ccaae0bc811c79605974cc1dab769b9cea8877f033f8e3c17f30457caba6";
@@ -75,6 +75,48 @@ interface RetryOptions {
     maxDelayMs?: number;
 }
 
+declare const FeeConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    fundAddress: z.ZodOptional<z.ZodString>;
+    marketplaceBps: z.ZodDefault<z.ZodNumber>;
+    launchpadBps: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    marketplaceBps: number;
+    launchpadBps: number;
+    fundAddress?: string | undefined;
+}, {
+    enabled?: boolean | undefined;
+    fundAddress?: string | undefined;
+    marketplaceBps?: number | undefined;
+    launchpadBps?: number | undefined;
+}>;
+type FeeConfig = z.input<typeof FeeConfigSchema>;
+interface ResolvedFeeConfig {
+    enabled: boolean;
+    fundAddress: string | undefined;
+    marketplaceBps: number;
+    launchpadBps: number;
+}
+declare function resolveFeeConfig(raw: FeeConfig | undefined): ResolvedFeeConfig;
+
+type FeeSurface = "marketplace" | "launchpad";
+interface BuildFeeCallParams {
+    surface: FeeSurface;
+    /** ERC-20 address the gross amount is denominated in. */
+    token: string;
+    /** Gross amount in raw token units (e.g. price in wei, or price * quantity). */
+    grossAmount: bigint;
+}
+/**
+ * The single source of truth for the platform fee. Returns one ERC-20
+ * `transfer(fundAddress, feeAmount)` Call to bundle into the settlement
+ * multicall, or `null` when no fee should be charged.
+ *
+ * Fail-safe: returns null if disabled, no fund address, or the fee floors to 0.
+ */
+declare function buildFeeCall(p: BuildFeeCallParams, cfg: ResolvedFeeConfig): Call | null;
+
 declare const MedialaneConfigSchema: z.ZodObject<{
     network: z.ZodDefault<z.ZodEnum<["mainnet"]>>;
     rpcUrl: z.ZodOptional<z.ZodString>;
@@ -99,6 +141,22 @@ declare const MedialaneConfigSchema: z.ZodObject<{
         baseDelayMs?: number | undefined;
         maxDelayMs?: number | undefined;
     }>>;
+    feeConfig: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        fundAddress: z.ZodOptional<z.ZodString>;
+        marketplaceBps: z.ZodDefault<z.ZodNumber>;
+        launchpadBps: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        marketplaceBps: number;
+        launchpadBps: number;
+        fundAddress?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        fundAddress?: string | undefined;
+        marketplaceBps?: number | undefined;
+        launchpadBps?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     network: "mainnet";
     rpcUrl?: string | undefined;
@@ -115,6 +173,12 @@ declare const MedialaneConfigSchema: z.ZodObject<{
         baseDelayMs?: number | undefined;
         maxDelayMs?: number | undefined;
     } | undefined;
+    feeConfig?: {
+        enabled: boolean;
+        marketplaceBps: number;
+        launchpadBps: number;
+        fundAddress?: string | undefined;
+    } | undefined;
 }, {
     network?: "mainnet" | undefined;
     rpcUrl?: string | undefined;
@@ -131,6 +195,12 @@ declare const MedialaneConfigSchema: z.ZodObject<{
         baseDelayMs?: number | undefined;
         maxDelayMs?: number | undefined;
     } | undefined;
+    feeConfig?: {
+        enabled?: boolean | undefined;
+        fundAddress?: string | undefined;
+        marketplaceBps?: number | undefined;
+        launchpadBps?: number | undefined;
+    } | undefined;
 }>;
 type MedialaneConfig = z.input<typeof MedialaneConfigSchema>;
 interface ResolvedConfig {
@@ -145,6 +215,7 @@ interface ResolvedConfig {
     collectionContract: string;
     collection1155Contract: string;
     retryOptions?: RetryOptions;
+    feeConfig: ResolvedFeeConfig;
 }
 declare function resolveConfig(raw: MedialaneConfig): ResolvedConfig;
 
@@ -940,6 +1011,8 @@ interface ApiCreatorListResult {
     page: number;
     limit: number;
 }
+type ApiWalletType = "ARGENT" | "BRAAVOS" | "CARTRIDGE" | "PRIVY" | "CHIPIPAY" | "INJECTED" | "UNKNOWN";
+type ApiAppSource = "MEDIALANE_DAPP" | "MEDIALANE_IO" | "MEDIALANE_PORTAL" | "MEDIALANE_SDK";
 interface ApiUserWallet {
     walletAddress: string;
 }
@@ -1111,7 +1184,10 @@ declare class ApiClient {
      * Call after onboarding when ChipiPay confirms the wallet address.
      * Requires Clerk JWT; no tenant API key needed.
      */
-    upsertMyWallet(clerkToken: string): Promise<ApiUserWallet>;
+    upsertMyWallet(clerkToken: string, options?: {
+        walletType?: ApiWalletType;
+        appSource?: ApiAppSource;
+    }): Promise<ApiUserWallet>;
     /**
      * Get the authenticated user's stored wallet address from the backend DB.
      * Returns null if the user has not completed onboarding yet.
@@ -1238,7 +1314,8 @@ declare class PopService {
 
 declare class DropService {
     private readonly factoryAddress;
-    constructor(_config: ResolvedConfig);
+    private readonly config;
+    constructor(config: ResolvedConfig);
     private _collection;
     claim(account: AccountInterface, collectionAddress: string, quantity?: bigint | string | number): Promise<TxResult>;
     adminMint(account: AccountInterface, params: {
@@ -4238,4 +4315,4 @@ declare function build1155FulfillmentTypedData(message: Record<string, unknown>,
  */
 declare function build1155CancellationTypedData(message: Record<string, unknown>, chainId: constants.StarknetChainId): TypedData;
 
-export { type ActivityType, type ApiActivitiesQuery, type ApiActivity, type ApiActivityPrice, type ApiAdminCollectionClaim, ApiClient, type ApiCollection, type ApiCollectionClaim, type ApiCollectionProfile, type ApiCollectionSlugClaim, type ApiCollectionsQuery, type ApiComment, type ApiCounterOffersQuery, type ApiCreatorListResult, type ApiCreatorProfile, type ApiIntent, type ApiIntentCreated, type ApiKeyStatus, type ApiMeta, type ApiMetadataSignedUrl, type ApiMetadataUpload, type ApiOrder, type ApiOrderConsideration, type ApiOrderOffer, type ApiOrderPrice, type ApiOrderTokenMeta, type ApiOrderTxHash, type ApiOrdersQuery, type ApiPortalKey, type ApiPortalKeyCreated, type ApiPortalMe, type ApiPublicRemix, type ApiRemixOffer, type ApiRemixOfferPrice, type ApiRemixOffersQuery, type ApiResponse, type ApiSearchCollectionResult, type ApiSearchCreatorResult, type ApiSearchResult, type ApiSearchTokenResult, type ApiToken, type ApiTokenBalance, type ApiTokenMetadata, type ApiUsageDay, type ApiUserWallet, type ApiWebhookCreated, type ApiWebhookEndpoint, type AutoRemixOfferParams, type BatchMintItemParams, COLLECTION_1155_CLASS_HASH_MAINNET, COLLECTION_1155_CONTRACT_MAINNET, COLLECTION_721_CONTRACT_MAINNET, COLLECTION_CONTRACT_MAINNET, type CancelOrder1155Params, type CancelOrderIntentParams, type CancelOrderParams, type Cancelation, type CartItem, type ClaimConditions, CollectionRegistryABI, type CollectionSort, type ConfirmRemixOfferParams, type ConfirmSelfRemixParams, type ConsiderationItem, type CreateCollectionIntentParams, type CreateCollectionParams, type CreateCounterOfferIntentParams, type CreateDropParams, type CreateListing1155Params, type CreateListingIntentParams, type CreateListingParams, type CreateMintIntentParams, type CreatePopCollectionParams, type CreateRemixOfferParams, type CreateWebhookParams, DEFAULT_RPC_URL, DROP_COLLECTION_CLASS_HASH_MAINNET, DROP_FACTORY_CONTRACT_MAINNET, type DeployCollectionParams, DropCollectionABI, DropFactoryABI, type DropMintStatus, DropService, ERC1155CollectionService, ERC1155_COLLECTION_CLASS_HASH_MAINNET, ERC1155_FACTORY_CONTRACT_MAINNET, type EnforcementDeclaration, type FulfillOrder1155Params, type FulfillOrderIntentParams, type FulfillOrderParams, type Fulfillment, INDEXER_START_BLOCK_MAINNET, IPCollection1155ABI, IPCollection1155FactoryABI, IPCollectionABI, IPMarketplaceABI, IPNftABI, type IPType, type IntentStatus, type IntentType, type IpAttribute, type IpNftMetadata, MARKETPLACE_1155_CLASS_HASH_MAINNET, MARKETPLACE_1155_CONTRACT_MAINNET, MARKETPLACE_1155_START_BLOCK_MAINNET, MARKETPLACE_721_CLASS_HASH_MAINNET, MARKETPLACE_721_CONTRACT_MAINNET, MARKETPLACE_721_START_BLOCK_MAINNET, MARKETPLACE_CLASS_HASH_MAINNET, MARKETPLACE_CONTRACT_MAINNET, MARKETPLACE_START_BLOCK_MAINNET, type MakeOffer1155Params, type MakeOfferIntentParams, type MakeOfferParams, MarketplaceModule, Medialane1155ABI, Medialane1155Module, MedialaneApiError, MedialaneClient, type MedialaneConfig, MedialaneError, type MedialaneErrorCode, type MintItemParams, type MintParams, NFTCOMMENTS_CONTRACT_MAINNET, type Network, OPEN_LICENSES, type OfferItem, type OpenLicense, type Order, type OrderDetails, type OrderParameters, type OrderStatus, POPCollectionABI, POPFactoryABI, POP_COLLECTION_CLASS_HASH_MAINNET, POP_FACTORY_CONTRACT_MAINNET, type PopBatchEligibilityItem, type PopClaimStatus, type PopEventType, PopService, type RemixOfferStatus, type ResolvedConfig, type RetryOptions, SUPPORTED_NETWORKS, SUPPORTED_TOKENS, type ServiceCapability, type ServiceDefinition, type SortOrder, type SupportedToken, type SupportedTokenSymbol, type TenantPlan, type TxResult, type WebhookEventType, type WebhookStatus, build1155CancellationTypedData, build1155FulfillmentTypedData, build1155OrderTypedData, buildCancellationTypedData, buildFulfillmentTypedData, buildOrderTypedData, encodeByteArray, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, listServices, normalizeAddress, parseAmount, resolveConfig, shortenAddress, stringifyBigInts, u256ToBigInt };
+export { type ActivityType, type ApiActivitiesQuery, type ApiActivity, type ApiActivityPrice, type ApiAdminCollectionClaim, type ApiAppSource, ApiClient, type ApiCollection, type ApiCollectionClaim, type ApiCollectionProfile, type ApiCollectionSlugClaim, type ApiCollectionsQuery, type ApiComment, type ApiCounterOffersQuery, type ApiCreatorListResult, type ApiCreatorProfile, type ApiIntent, type ApiIntentCreated, type ApiKeyStatus, type ApiMeta, type ApiMetadataSignedUrl, type ApiMetadataUpload, type ApiOrder, type ApiOrderConsideration, type ApiOrderOffer, type ApiOrderPrice, type ApiOrderTokenMeta, type ApiOrderTxHash, type ApiOrdersQuery, type ApiPortalKey, type ApiPortalKeyCreated, type ApiPortalMe, type ApiPublicRemix, type ApiRemixOffer, type ApiRemixOfferPrice, type ApiRemixOffersQuery, type ApiResponse, type ApiSearchCollectionResult, type ApiSearchCreatorResult, type ApiSearchResult, type ApiSearchTokenResult, type ApiToken, type ApiTokenBalance, type ApiTokenMetadata, type ApiUsageDay, type ApiUserWallet, type ApiWalletType, type ApiWebhookCreated, type ApiWebhookEndpoint, type AutoRemixOfferParams, type BatchMintItemParams, type BuildFeeCallParams, COLLECTION_1155_CLASS_HASH_MAINNET, COLLECTION_1155_CONTRACT_MAINNET, COLLECTION_721_CONTRACT_MAINNET, COLLECTION_CONTRACT_MAINNET, type CancelOrder1155Params, type CancelOrderIntentParams, type CancelOrderParams, type Cancelation, type CartItem, type ClaimConditions, CollectionRegistryABI, type CollectionSort, type ConfirmRemixOfferParams, type ConfirmSelfRemixParams, type ConsiderationItem, type CreateCollectionIntentParams, type CreateCollectionParams, type CreateCounterOfferIntentParams, type CreateDropParams, type CreateListing1155Params, type CreateListingIntentParams, type CreateListingParams, type CreateMintIntentParams, type CreatePopCollectionParams, type CreateRemixOfferParams, type CreateWebhookParams, DEFAULT_RPC_URL, DROP_COLLECTION_CLASS_HASH_MAINNET, DROP_FACTORY_CONTRACT_MAINNET, type DeployCollectionParams, DropCollectionABI, DropFactoryABI, type DropMintStatus, DropService, ERC1155CollectionService, ERC1155_COLLECTION_CLASS_HASH_MAINNET, ERC1155_FACTORY_CONTRACT_MAINNET, type EnforcementDeclaration, type FeeConfig, FeeConfigSchema, type FeeSurface, type FulfillOrder1155Params, type FulfillOrderIntentParams, type FulfillOrderParams, type Fulfillment, INDEXER_START_BLOCK_MAINNET, IPCollection1155ABI, IPCollection1155FactoryABI, IPCollectionABI, IPMarketplaceABI, IPNftABI, type IPType, type IntentStatus, type IntentType, type IpAttribute, type IpNftMetadata, MARKETPLACE_1155_CLASS_HASH_MAINNET, MARKETPLACE_1155_CONTRACT_MAINNET, MARKETPLACE_1155_START_BLOCK_MAINNET, MARKETPLACE_721_CLASS_HASH_MAINNET, MARKETPLACE_721_CONTRACT_MAINNET, MARKETPLACE_721_START_BLOCK_MAINNET, MARKETPLACE_CLASS_HASH_MAINNET, MARKETPLACE_CONTRACT_MAINNET, MARKETPLACE_START_BLOCK_MAINNET, type MakeOffer1155Params, type MakeOfferIntentParams, type MakeOfferParams, MarketplaceModule, Medialane1155ABI, Medialane1155Module, MedialaneApiError, MedialaneClient, type MedialaneConfig, MedialaneError, type MedialaneErrorCode, type MintItemParams, type MintParams, NFTCOMMENTS_CONTRACT_MAINNET, type Network, OPEN_LICENSES, type OfferItem, type OpenLicense, type Order, type OrderDetails, type OrderParameters, type OrderStatus, POPCollectionABI, POPFactoryABI, POP_COLLECTION_CLASS_HASH_MAINNET, POP_FACTORY_CONTRACT_MAINNET, type PopBatchEligibilityItem, type PopClaimStatus, type PopEventType, PopService, type RemixOfferStatus, type ResolvedConfig, type ResolvedFeeConfig, type RetryOptions, SUPPORTED_NETWORKS, SUPPORTED_TOKENS, type ServiceCapability, type ServiceDefinition, type SortOrder, type SupportedToken, type SupportedTokenSymbol, type TenantPlan, type TxResult, type WebhookEventType, type WebhookStatus, build1155CancellationTypedData, build1155FulfillmentTypedData, build1155OrderTypedData, buildCancellationTypedData, buildFeeCall, buildFulfillmentTypedData, buildOrderTypedData, encodeByteArray, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, listServices, normalizeAddress, parseAmount, resolveConfig, resolveFeeConfig, shortenAddress, stringifyBigInts, u256ToBigInt };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { AccountInterface, constants, TypedData } from 'starknet';
+import { Call, AccountInterface, constants, TypedData } from 'starknet';
 
 /** Medialane Protocol ERC-721 marketplace — immutable, no admin key. */
 declare const MARKETPLACE_721_CONTRACT_MAINNET = "0x00f8ccaae0bc811c79605974cc1dab769b9cea8877f033f8e3c17f30457caba6";
@@ -75,6 +75,48 @@ interface RetryOptions {
     maxDelayMs?: number;
 }
 
+declare const FeeConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    fundAddress: z.ZodOptional<z.ZodString>;
+    marketplaceBps: z.ZodDefault<z.ZodNumber>;
+    launchpadBps: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    marketplaceBps: number;
+    launchpadBps: number;
+    fundAddress?: string | undefined;
+}, {
+    enabled?: boolean | undefined;
+    fundAddress?: string | undefined;
+    marketplaceBps?: number | undefined;
+    launchpadBps?: number | undefined;
+}>;
+type FeeConfig = z.input<typeof FeeConfigSchema>;
+interface ResolvedFeeConfig {
+    enabled: boolean;
+    fundAddress: string | undefined;
+    marketplaceBps: number;
+    launchpadBps: number;
+}
+declare function resolveFeeConfig(raw: FeeConfig | undefined): ResolvedFeeConfig;
+
+type FeeSurface = "marketplace" | "launchpad";
+interface BuildFeeCallParams {
+    surface: FeeSurface;
+    /** ERC-20 address the gross amount is denominated in. */
+    token: string;
+    /** Gross amount in raw token units (e.g. price in wei, or price * quantity). */
+    grossAmount: bigint;
+}
+/**
+ * The single source of truth for the platform fee. Returns one ERC-20
+ * `transfer(fundAddress, feeAmount)` Call to bundle into the settlement
+ * multicall, or `null` when no fee should be charged.
+ *
+ * Fail-safe: returns null if disabled, no fund address, or the fee floors to 0.
+ */
+declare function buildFeeCall(p: BuildFeeCallParams, cfg: ResolvedFeeConfig): Call | null;
+
 declare const MedialaneConfigSchema: z.ZodObject<{
     network: z.ZodDefault<z.ZodEnum<["mainnet"]>>;
     rpcUrl: z.ZodOptional<z.ZodString>;
@@ -99,6 +141,22 @@ declare const MedialaneConfigSchema: z.ZodObject<{
         baseDelayMs?: number | undefined;
         maxDelayMs?: number | undefined;
     }>>;
+    feeConfig: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        fundAddress: z.ZodOptional<z.ZodString>;
+        marketplaceBps: z.ZodDefault<z.ZodNumber>;
+        launchpadBps: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        marketplaceBps: number;
+        launchpadBps: number;
+        fundAddress?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        fundAddress?: string | undefined;
+        marketplaceBps?: number | undefined;
+        launchpadBps?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     network: "mainnet";
     rpcUrl?: string | undefined;
@@ -115,6 +173,12 @@ declare const MedialaneConfigSchema: z.ZodObject<{
         baseDelayMs?: number | undefined;
         maxDelayMs?: number | undefined;
     } | undefined;
+    feeConfig?: {
+        enabled: boolean;
+        marketplaceBps: number;
+        launchpadBps: number;
+        fundAddress?: string | undefined;
+    } | undefined;
 }, {
     network?: "mainnet" | undefined;
     rpcUrl?: string | undefined;
@@ -131,6 +195,12 @@ declare const MedialaneConfigSchema: z.ZodObject<{
         baseDelayMs?: number | undefined;
         maxDelayMs?: number | undefined;
     } | undefined;
+    feeConfig?: {
+        enabled?: boolean | undefined;
+        fundAddress?: string | undefined;
+        marketplaceBps?: number | undefined;
+        launchpadBps?: number | undefined;
+    } | undefined;
 }>;
 type MedialaneConfig = z.input<typeof MedialaneConfigSchema>;
 interface ResolvedConfig {
@@ -145,6 +215,7 @@ interface ResolvedConfig {
     collectionContract: string;
     collection1155Contract: string;
     retryOptions?: RetryOptions;
+    feeConfig: ResolvedFeeConfig;
 }
 declare function resolveConfig(raw: MedialaneConfig): ResolvedConfig;
 
@@ -940,6 +1011,8 @@ interface ApiCreatorListResult {
     page: number;
     limit: number;
 }
+type ApiWalletType = "ARGENT" | "BRAAVOS" | "CARTRIDGE" | "PRIVY" | "CHIPIPAY" | "INJECTED" | "UNKNOWN";
+type ApiAppSource = "MEDIALANE_DAPP" | "MEDIALANE_IO" | "MEDIALANE_PORTAL" | "MEDIALANE_SDK";
 interface ApiUserWallet {
     walletAddress: string;
 }
@@ -1111,7 +1184,10 @@ declare class ApiClient {
      * Call after onboarding when ChipiPay confirms the wallet address.
      * Requires Clerk JWT; no tenant API key needed.
      */
-    upsertMyWallet(clerkToken: string): Promise<ApiUserWallet>;
+    upsertMyWallet(clerkToken: string, options?: {
+        walletType?: ApiWalletType;
+        appSource?: ApiAppSource;
+    }): Promise<ApiUserWallet>;
     /**
      * Get the authenticated user's stored wallet address from the backend DB.
      * Returns null if the user has not completed onboarding yet.
@@ -1238,7 +1314,8 @@ declare class PopService {
 
 declare class DropService {
     private readonly factoryAddress;
-    constructor(_config: ResolvedConfig);
+    private readonly config;
+    constructor(config: ResolvedConfig);
     private _collection;
     claim(account: AccountInterface, collectionAddress: string, quantity?: bigint | string | number): Promise<TxResult>;
     adminMint(account: AccountInterface, params: {
@@ -4238,4 +4315,4 @@ declare function build1155FulfillmentTypedData(message: Record<string, unknown>,
  */
 declare function build1155CancellationTypedData(message: Record<string, unknown>, chainId: constants.StarknetChainId): TypedData;
 
-export { type ActivityType, type ApiActivitiesQuery, type ApiActivity, type ApiActivityPrice, type ApiAdminCollectionClaim, ApiClient, type ApiCollection, type ApiCollectionClaim, type ApiCollectionProfile, type ApiCollectionSlugClaim, type ApiCollectionsQuery, type ApiComment, type ApiCounterOffersQuery, type ApiCreatorListResult, type ApiCreatorProfile, type ApiIntent, type ApiIntentCreated, type ApiKeyStatus, type ApiMeta, type ApiMetadataSignedUrl, type ApiMetadataUpload, type ApiOrder, type ApiOrderConsideration, type ApiOrderOffer, type ApiOrderPrice, type ApiOrderTokenMeta, type ApiOrderTxHash, type ApiOrdersQuery, type ApiPortalKey, type ApiPortalKeyCreated, type ApiPortalMe, type ApiPublicRemix, type ApiRemixOffer, type ApiRemixOfferPrice, type ApiRemixOffersQuery, type ApiResponse, type ApiSearchCollectionResult, type ApiSearchCreatorResult, type ApiSearchResult, type ApiSearchTokenResult, type ApiToken, type ApiTokenBalance, type ApiTokenMetadata, type ApiUsageDay, type ApiUserWallet, type ApiWebhookCreated, type ApiWebhookEndpoint, type AutoRemixOfferParams, type BatchMintItemParams, COLLECTION_1155_CLASS_HASH_MAINNET, COLLECTION_1155_CONTRACT_MAINNET, COLLECTION_721_CONTRACT_MAINNET, COLLECTION_CONTRACT_MAINNET, type CancelOrder1155Params, type CancelOrderIntentParams, type CancelOrderParams, type Cancelation, type CartItem, type ClaimConditions, CollectionRegistryABI, type CollectionSort, type ConfirmRemixOfferParams, type ConfirmSelfRemixParams, type ConsiderationItem, type CreateCollectionIntentParams, type CreateCollectionParams, type CreateCounterOfferIntentParams, type CreateDropParams, type CreateListing1155Params, type CreateListingIntentParams, type CreateListingParams, type CreateMintIntentParams, type CreatePopCollectionParams, type CreateRemixOfferParams, type CreateWebhookParams, DEFAULT_RPC_URL, DROP_COLLECTION_CLASS_HASH_MAINNET, DROP_FACTORY_CONTRACT_MAINNET, type DeployCollectionParams, DropCollectionABI, DropFactoryABI, type DropMintStatus, DropService, ERC1155CollectionService, ERC1155_COLLECTION_CLASS_HASH_MAINNET, ERC1155_FACTORY_CONTRACT_MAINNET, type EnforcementDeclaration, type FulfillOrder1155Params, type FulfillOrderIntentParams, type FulfillOrderParams, type Fulfillment, INDEXER_START_BLOCK_MAINNET, IPCollection1155ABI, IPCollection1155FactoryABI, IPCollectionABI, IPMarketplaceABI, IPNftABI, type IPType, type IntentStatus, type IntentType, type IpAttribute, type IpNftMetadata, MARKETPLACE_1155_CLASS_HASH_MAINNET, MARKETPLACE_1155_CONTRACT_MAINNET, MARKETPLACE_1155_START_BLOCK_MAINNET, MARKETPLACE_721_CLASS_HASH_MAINNET, MARKETPLACE_721_CONTRACT_MAINNET, MARKETPLACE_721_START_BLOCK_MAINNET, MARKETPLACE_CLASS_HASH_MAINNET, MARKETPLACE_CONTRACT_MAINNET, MARKETPLACE_START_BLOCK_MAINNET, type MakeOffer1155Params, type MakeOfferIntentParams, type MakeOfferParams, MarketplaceModule, Medialane1155ABI, Medialane1155Module, MedialaneApiError, MedialaneClient, type MedialaneConfig, MedialaneError, type MedialaneErrorCode, type MintItemParams, type MintParams, NFTCOMMENTS_CONTRACT_MAINNET, type Network, OPEN_LICENSES, type OfferItem, type OpenLicense, type Order, type OrderDetails, type OrderParameters, type OrderStatus, POPCollectionABI, POPFactoryABI, POP_COLLECTION_CLASS_HASH_MAINNET, POP_FACTORY_CONTRACT_MAINNET, type PopBatchEligibilityItem, type PopClaimStatus, type PopEventType, PopService, type RemixOfferStatus, type ResolvedConfig, type RetryOptions, SUPPORTED_NETWORKS, SUPPORTED_TOKENS, type ServiceCapability, type ServiceDefinition, type SortOrder, type SupportedToken, type SupportedTokenSymbol, type TenantPlan, type TxResult, type WebhookEventType, type WebhookStatus, build1155CancellationTypedData, build1155FulfillmentTypedData, build1155OrderTypedData, buildCancellationTypedData, buildFulfillmentTypedData, buildOrderTypedData, encodeByteArray, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, listServices, normalizeAddress, parseAmount, resolveConfig, shortenAddress, stringifyBigInts, u256ToBigInt };
+export { type ActivityType, type ApiActivitiesQuery, type ApiActivity, type ApiActivityPrice, type ApiAdminCollectionClaim, type ApiAppSource, ApiClient, type ApiCollection, type ApiCollectionClaim, type ApiCollectionProfile, type ApiCollectionSlugClaim, type ApiCollectionsQuery, type ApiComment, type ApiCounterOffersQuery, type ApiCreatorListResult, type ApiCreatorProfile, type ApiIntent, type ApiIntentCreated, type ApiKeyStatus, type ApiMeta, type ApiMetadataSignedUrl, type ApiMetadataUpload, type ApiOrder, type ApiOrderConsideration, type ApiOrderOffer, type ApiOrderPrice, type ApiOrderTokenMeta, type ApiOrderTxHash, type ApiOrdersQuery, type ApiPortalKey, type ApiPortalKeyCreated, type ApiPortalMe, type ApiPublicRemix, type ApiRemixOffer, type ApiRemixOfferPrice, type ApiRemixOffersQuery, type ApiResponse, type ApiSearchCollectionResult, type ApiSearchCreatorResult, type ApiSearchResult, type ApiSearchTokenResult, type ApiToken, type ApiTokenBalance, type ApiTokenMetadata, type ApiUsageDay, type ApiUserWallet, type ApiWalletType, type ApiWebhookCreated, type ApiWebhookEndpoint, type AutoRemixOfferParams, type BatchMintItemParams, type BuildFeeCallParams, COLLECTION_1155_CLASS_HASH_MAINNET, COLLECTION_1155_CONTRACT_MAINNET, COLLECTION_721_CONTRACT_MAINNET, COLLECTION_CONTRACT_MAINNET, type CancelOrder1155Params, type CancelOrderIntentParams, type CancelOrderParams, type Cancelation, type CartItem, type ClaimConditions, CollectionRegistryABI, type CollectionSort, type ConfirmRemixOfferParams, type ConfirmSelfRemixParams, type ConsiderationItem, type CreateCollectionIntentParams, type CreateCollectionParams, type CreateCounterOfferIntentParams, type CreateDropParams, type CreateListing1155Params, type CreateListingIntentParams, type CreateListingParams, type CreateMintIntentParams, type CreatePopCollectionParams, type CreateRemixOfferParams, type CreateWebhookParams, DEFAULT_RPC_URL, DROP_COLLECTION_CLASS_HASH_MAINNET, DROP_FACTORY_CONTRACT_MAINNET, type DeployCollectionParams, DropCollectionABI, DropFactoryABI, type DropMintStatus, DropService, ERC1155CollectionService, ERC1155_COLLECTION_CLASS_HASH_MAINNET, ERC1155_FACTORY_CONTRACT_MAINNET, type EnforcementDeclaration, type FeeConfig, FeeConfigSchema, type FeeSurface, type FulfillOrder1155Params, type FulfillOrderIntentParams, type FulfillOrderParams, type Fulfillment, INDEXER_START_BLOCK_MAINNET, IPCollection1155ABI, IPCollection1155FactoryABI, IPCollectionABI, IPMarketplaceABI, IPNftABI, type IPType, type IntentStatus, type IntentType, type IpAttribute, type IpNftMetadata, MARKETPLACE_1155_CLASS_HASH_MAINNET, MARKETPLACE_1155_CONTRACT_MAINNET, MARKETPLACE_1155_START_BLOCK_MAINNET, MARKETPLACE_721_CLASS_HASH_MAINNET, MARKETPLACE_721_CONTRACT_MAINNET, MARKETPLACE_721_START_BLOCK_MAINNET, MARKETPLACE_CLASS_HASH_MAINNET, MARKETPLACE_CONTRACT_MAINNET, MARKETPLACE_START_BLOCK_MAINNET, type MakeOffer1155Params, type MakeOfferIntentParams, type MakeOfferParams, MarketplaceModule, Medialane1155ABI, Medialane1155Module, MedialaneApiError, MedialaneClient, type MedialaneConfig, MedialaneError, type MedialaneErrorCode, type MintItemParams, type MintParams, NFTCOMMENTS_CONTRACT_MAINNET, type Network, OPEN_LICENSES, type OfferItem, type OpenLicense, type Order, type OrderDetails, type OrderParameters, type OrderStatus, POPCollectionABI, POPFactoryABI, POP_COLLECTION_CLASS_HASH_MAINNET, POP_FACTORY_CONTRACT_MAINNET, type PopBatchEligibilityItem, type PopClaimStatus, type PopEventType, PopService, type RemixOfferStatus, type ResolvedConfig, type ResolvedFeeConfig, type RetryOptions, SUPPORTED_NETWORKS, SUPPORTED_TOKENS, type ServiceCapability, type ServiceDefinition, type SortOrder, type SupportedToken, type SupportedTokenSymbol, type TenantPlan, type TxResult, type WebhookEventType, type WebhookStatus, build1155CancellationTypedData, build1155FulfillmentTypedData, build1155OrderTypedData, buildCancellationTypedData, buildFeeCall, buildFulfillmentTypedData, buildOrderTypedData, encodeByteArray, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, listServices, normalizeAddress, parseAmount, resolveConfig, resolveFeeConfig, shortenAddress, stringifyBigInts, u256ToBigInt };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { TypedDataRevision, num, Contract, shortString, cairo, constants, RpcProvider } from 'starknet';
+import { cairo, TypedDataRevision, num, Contract, shortString, constants, RpcProvider } from 'starknet';
 
 // src/config.ts
 
@@ -61,6 +61,34 @@ var COLLECTION_1155_CONTRACT_MAINNET = "0x006b2dc7ca7c4f466bb4575ba043d934310f05
 var ERC1155_FACTORY_CONTRACT_MAINNET = COLLECTION_1155_CONTRACT_MAINNET;
 var COLLECTION_1155_CLASS_HASH_MAINNET = "0x39a85126c6627db263617e5bce2bb72e49d2bb1f20961efc8b8954665bcfd25";
 var ERC1155_COLLECTION_CLASS_HASH_MAINNET = COLLECTION_1155_CLASS_HASH_MAINNET;
+var FeeConfigSchema = z.object({
+  enabled: z.boolean().default(true),
+  fundAddress: z.string().min(1).optional(),
+  marketplaceBps: z.number().int().min(0).max(1e4).default(100),
+  launchpadBps: z.number().int().min(0).max(1e4).default(100)
+});
+function resolveFeeConfig(raw) {
+  const p = FeeConfigSchema.parse(raw ?? {});
+  return {
+    enabled: p.enabled,
+    fundAddress: p.fundAddress,
+    marketplaceBps: p.marketplaceBps,
+    launchpadBps: p.launchpadBps
+  };
+}
+function buildFeeCall(p, cfg) {
+  if (!cfg.enabled || !cfg.fundAddress) return null;
+  const bps = p.surface === "marketplace" ? cfg.marketplaceBps : cfg.launchpadBps;
+  if (bps <= 0) return null;
+  const fee = p.grossAmount * BigInt(bps) / 10000n;
+  if (fee <= 0n) return null;
+  const u = cairo.uint256(fee.toString());
+  return {
+    contractAddress: p.token,
+    entrypoint: "transfer",
+    calldata: [cfg.fundAddress, u.low.toString(), u.high.toString()]
+  };
+}
 
 // src/config.ts
 var MedialaneConfigSchema = z.object({
@@ -78,7 +106,8 @@ var MedialaneConfigSchema = z.object({
     maxAttempts: z.number().int().min(1).max(10).optional(),
     baseDelayMs: z.number().int().min(0).optional(),
     maxDelayMs: z.number().int().min(0).optional()
-  }).optional()
+  }).optional(),
+  feeConfig: FeeConfigSchema.optional()
 });
 function resolveConfig(raw) {
   const parsed = MedialaneConfigSchema.parse(raw);
@@ -95,7 +124,8 @@ function resolveConfig(raw) {
     collection721Contract,
     collectionContract: collection721Contract,
     collection1155Contract: parsed.collection1155Contract ?? COLLECTION_1155_CONTRACT_MAINNET,
-    retryOptions: parsed.retryOptions
+    retryOptions: parsed.retryOptions,
+    feeConfig: resolveFeeConfig(parsed.feeConfig)
   };
 }
 function buildOrderTypedData(message, chainId) {
@@ -3540,8 +3570,13 @@ async function fulfillOrder(account, params, config) {
     ]
   };
   const fulfillCall = contract.populate("fulfill_order", [fulfillPayload]);
+  const feeCall = buildFeeCall(
+    { surface: "marketplace", token: paymentToken, grossAmount: BigInt(totalPrice) },
+    config.feeConfig
+  );
+  const calls = feeCall ? [approveCall, fulfillCall, feeCall] : [approveCall, fulfillCall];
   try {
-    const tx = await account.execute([approveCall, fulfillCall]);
+    const tx = await account.execute(calls);
     await provider.waitForTransaction(tx.transaction_hash);
     return { txHash: tx.transaction_hash };
   } catch (err) {
@@ -3650,8 +3685,14 @@ async function checkoutCart(account, items, config) {
     });
     fulfillCalls.push(contract.populate("fulfill_order", [fulfillPayload]));
   }
+  const feeCalls = Array.from(tokenTotals.entries()).map(
+    ([tokenAddr, totalWei]) => buildFeeCall(
+      { surface: "marketplace", token: tokenAddr, grossAmount: totalWei },
+      config.feeConfig
+    )
+  ).filter((c) => c !== null);
   try {
-    const tx = await account.execute([...approveCalls, ...fulfillCalls]);
+    const tx = await account.execute([...approveCalls, ...fulfillCalls, ...feeCalls]);
     await provider.waitForTransaction(tx.transaction_hash);
     return { txHash: tx.transaction_hash };
   } catch (err) {
@@ -4608,14 +4649,18 @@ var ApiClient = class {
    * Call after onboarding when ChipiPay confirms the wallet address.
    * Requires Clerk JWT; no tenant API key needed.
    */
-  async upsertMyWallet(clerkToken) {
+  async upsertMyWallet(clerkToken, options = {}) {
     const url = `${this.baseUrl.replace(/\/$/, "")}/v1/users/me`;
     const res = await fetch(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
         "Authorization": `Bearer ${clerkToken}`
-      }
+      },
+      body: JSON.stringify({
+        walletType: options.walletType ?? "UNKNOWN",
+        appSource: options.appSource ?? "MEDIALANE_SDK"
+      })
     });
     return this.checkResponse(res);
   }
@@ -4834,15 +4879,26 @@ function toContractConditions(c) {
   };
 }
 var DropService = class {
-  constructor(_config) {
+  constructor(config) {
     this.factoryAddress = DROP_FACTORY_CONTRACT_MAINNET;
+    this.config = config;
   }
   _collection(address, account) {
     return new Contract(DropCollectionABI, normalizeAddress(address), account);
   }
   async claim(account, collectionAddress, quantity = 1) {
-    const call = this._collection(collectionAddress, account).populate("claim", [BigInt(quantity)]);
-    const res = await account.execute([call]);
+    const collection = this._collection(collectionAddress, account);
+    const qty = BigInt(quantity);
+    const claimCall = collection.populate("claim", [qty]);
+    const conditions = await collection.get_claim_conditions();
+    const price = BigInt(conditions.price);
+    const paymentToken = typeof conditions.payment_token === "bigint" ? "0x" + conditions.payment_token.toString(16) : conditions.payment_token;
+    const feeCall = price > 0n ? buildFeeCall(
+      { surface: "launchpad", token: paymentToken, grossAmount: price * qty },
+      this.config.feeConfig
+    ) : null;
+    const calls = feeCall ? [claimCall, feeCall] : [claimCall];
+    const res = await account.execute(calls);
     return { txHash: res.transaction_hash };
   }
   async adminMint(account, params) {
@@ -5159,6 +5215,6 @@ function getServicesByCapability(cap) {
   return Object.values(SERVICES).filter((s) => s.capabilities.includes(cap));
 }
 
-export { ApiClient, COLLECTION_1155_CLASS_HASH_MAINNET, COLLECTION_1155_CONTRACT_MAINNET, COLLECTION_721_CONTRACT_MAINNET, COLLECTION_CONTRACT_MAINNET, CollectionRegistryABI, DEFAULT_RPC_URL, DROP_COLLECTION_CLASS_HASH_MAINNET, DROP_FACTORY_CONTRACT_MAINNET, DropCollectionABI, DropFactoryABI, DropService, ERC1155CollectionService, ERC1155_COLLECTION_CLASS_HASH_MAINNET, ERC1155_FACTORY_CONTRACT_MAINNET, INDEXER_START_BLOCK_MAINNET, IPCollection1155ABI, IPCollection1155FactoryABI, IPCollectionABI, IPMarketplaceABI, IPNftABI, MARKETPLACE_1155_CLASS_HASH_MAINNET, MARKETPLACE_1155_CONTRACT_MAINNET, MARKETPLACE_1155_START_BLOCK_MAINNET, MARKETPLACE_721_CLASS_HASH_MAINNET, MARKETPLACE_721_CONTRACT_MAINNET, MARKETPLACE_721_START_BLOCK_MAINNET, MARKETPLACE_CLASS_HASH_MAINNET, MARKETPLACE_CONTRACT_MAINNET, MARKETPLACE_START_BLOCK_MAINNET, MarketplaceModule, Medialane1155ABI, Medialane1155Module, MedialaneApiError, MedialaneClient, MedialaneError, NFTCOMMENTS_CONTRACT_MAINNET, OPEN_LICENSES, POPCollectionABI, POPFactoryABI, POP_COLLECTION_CLASS_HASH_MAINNET, POP_FACTORY_CONTRACT_MAINNET, PopService, SUPPORTED_NETWORKS, SUPPORTED_TOKENS, build1155CancellationTypedData, build1155FulfillmentTypedData, build1155OrderTypedData, buildCancellationTypedData, buildFulfillmentTypedData, buildOrderTypedData, encodeByteArray, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, listServices, normalizeAddress, parseAmount, resolveConfig, shortenAddress, stringifyBigInts, u256ToBigInt };
+export { ApiClient, COLLECTION_1155_CLASS_HASH_MAINNET, COLLECTION_1155_CONTRACT_MAINNET, COLLECTION_721_CONTRACT_MAINNET, COLLECTION_CONTRACT_MAINNET, CollectionRegistryABI, DEFAULT_RPC_URL, DROP_COLLECTION_CLASS_HASH_MAINNET, DROP_FACTORY_CONTRACT_MAINNET, DropCollectionABI, DropFactoryABI, DropService, ERC1155CollectionService, ERC1155_COLLECTION_CLASS_HASH_MAINNET, ERC1155_FACTORY_CONTRACT_MAINNET, FeeConfigSchema, INDEXER_START_BLOCK_MAINNET, IPCollection1155ABI, IPCollection1155FactoryABI, IPCollectionABI, IPMarketplaceABI, IPNftABI, MARKETPLACE_1155_CLASS_HASH_MAINNET, MARKETPLACE_1155_CONTRACT_MAINNET, MARKETPLACE_1155_START_BLOCK_MAINNET, MARKETPLACE_721_CLASS_HASH_MAINNET, MARKETPLACE_721_CONTRACT_MAINNET, MARKETPLACE_721_START_BLOCK_MAINNET, MARKETPLACE_CLASS_HASH_MAINNET, MARKETPLACE_CONTRACT_MAINNET, MARKETPLACE_START_BLOCK_MAINNET, MarketplaceModule, Medialane1155ABI, Medialane1155Module, MedialaneApiError, MedialaneClient, MedialaneError, NFTCOMMENTS_CONTRACT_MAINNET, OPEN_LICENSES, POPCollectionABI, POPFactoryABI, POP_COLLECTION_CLASS_HASH_MAINNET, POP_FACTORY_CONTRACT_MAINNET, PopService, SUPPORTED_NETWORKS, SUPPORTED_TOKENS, build1155CancellationTypedData, build1155FulfillmentTypedData, build1155OrderTypedData, buildCancellationTypedData, buildFeeCall, buildFulfillmentTypedData, buildOrderTypedData, encodeByteArray, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, listServices, normalizeAddress, parseAmount, resolveConfig, resolveFeeConfig, shortenAddress, stringifyBigInts, u256ToBigInt };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map