@medialane/sdk 0.85.4 → 0.85.6

package/dist/{services-CovenF1m.d.ts → services-CQKFABiG.d.cts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { C as Chain } from './types-sIc3OCpo.js';
+import { C as Chain } from './types-nPIXtCF5.cjs';
 
 interface RetryOptions {
     maxAttempts?: number;
@@ -146,53 +146,19 @@ declare function resolveConfig(raw: MedialaneConfig): ResolvedConfig;
 type IPType = "Audio" | "Art" | "Documents" | "NFT" | "Video" | "Photography" | "Patents" | "Posts" | "Publications" | "RWA" | "Software" | "Custom";
 type CollectionSort = "recent" | "supply" | "floor" | "volume" | "name";
 type CollectionTokensSort = "recent" | "oldest" | "name" | "price";
-/** Bounded capability set (05-service-model §III). Expand the union when a
- *  service needs behavior outside it — never make it free-form. */
 type ServiceCapability = "list" | "buy" | "make_offer" | "cancel" | "transfer" | "burn" | "mint" | "claim" | "airdrop" | "remix" | "license" | "subscribe" | "redeem" | "launch" | "swap" | "sponsor";
-/** A service that bakes enforcement into its own contract declares it here
- *  (04-licensing-model §V, 05-service-model §IV). Absence/all-falsey =
- *  soft enforcement (the 00-principles §9 default). */
 interface EnforcementDeclaration {
     royalty?: "erc2981" | "service-split" | "none";
     escrow?: boolean;
     timeLock?: boolean;
     revocable?: boolean;
 }
-/** An on-chain event the service emits. The indexer consumes this list to
- *  decide what to poll and how to parse — the year-2 "data-driven event
- *  parser registry" foundation (02-protocol-app-split §V).
- *
- *  The Cairo selector is derivable from `name` via
- *  `starknet.hash.getSelectorFromName(name)` — not stored to avoid
- *  duplication and keep the SDK runtime-free of pre-computed hashes.
- */
 interface ServiceEventDeclaration {
-    /** Cairo event struct name (e.g. "OrderCreated", "CollectionCreated"). */
     name: string;
-    /**
-     * Where this event is emitted:
-     *  - "factory":  at the service's `onchain.factoryAddress` (fixed address).
-     *                Examples: marketplace OrderCreated, factory CollectionCreated.
-     *  - "instance": at the address of each deployed collection contract
-     *                (variable; the indexer iterates discovered instances).
-     *                Examples: ERC-721 Transfer, POP AllowlistUpdated.
-     */
     emittedBy: "factory" | "instance";
-    /**
-     * Polling cadence the indexer should use:
-     *  - "fast" (default): every indexer tick (~6s). Right for low-volume
-     *                      protocol events like order/factory events.
-     *  - "slow":           a separate slower loop (~2min). Right for
-     *                      high-volume per-instance events like Transfer
-     *                      and AllowlistUpdated — polling them every tick
-     *                      against every known instance is RPC-expensive.
-     */
     poll?: "fast" | "slow";
 }
-/** Declarative description of a service (05-service-model §II).
- *  SDK-resident in v1; on-chain registry in year 2. */
 interface ServiceDefinition {
-    /** Stable kebab-case id. NO version number (05 §II). */
     id: string;
     displayName: string;
     description: string;
@@ -203,18 +169,11 @@ interface ServiceDefinition {
         classHash?: string;
         startBlock?: number;
     }>>;
-    /** Drives the dapp asset/collection page variant. */
     uiVariant: string;
     capabilities: ServiceCapability[];
-    /** Events the indexer should poll + parse for this service.
-     *  Optional during the year-1 transition — backend hand-coded pollers
-     *  (medialane-backend/src/mirror/poller.ts) take precedence today.
-     *  Populated here so consumers and the future data-driven indexer can
-     *  read what events a service emits without code-spelunking. */
     events?: ServiceEventDeclaration[];
     metadataSchema?: {
         requiredTraits?: string[];
-        /** Canonical platform default is "CC BY-SA" (04-licensing-model §III). */
         licenseDefault?: string;
         enforcement?: EnforcementDeclaration;
     };
@@ -225,17 +184,8 @@ interface ApiCollectionsQuery {
     isKnown?: boolean;
     sort?: CollectionSort;
     owner?: string;
-    /** Filter by service id. */
     service?: string;
 }
-/**
- * Order lifecycle states. **Four canonical values** per `01-core-model §V`.
- *
- * The legacy `"COUNTER_OFFERED"` value was removed in 0.23.0 (audit P0-1
- * Phase D). Counter-offers are linked orders via `parentOrderHash`, not a
- * third lifecycle state on the parent bid. Use `ApiOrder.hasActiveCounterOffer`
- * (added in 0.22.0) for the "this bid has been countered" affordance.
- */
 type OrderStatus = "ACTIVE" | "FULFILLED" | "CANCELLED" | "EXPIRED";
 type SortOrder = "price_asc" | "price_desc" | "recent";
 type ActivityType = "mint" | "transfer" | "sale" | "listing" | "offer" | "cancelled";
@@ -254,8 +204,6 @@ interface ApiResponse<T> {
     data: T;
     meta?: ApiMeta;
 }
-/** Cross-chain read filter — a concrete chain, or "all" for aggregation
- *  (platform-federation spec §2.3). Omitted = the backend default (STARKNET). */
 type ChainFilter = Chain | "all";
 interface ApiOrdersQuery {
     chain?: ChainFilter;
@@ -312,52 +260,24 @@ interface ApiOrder {
     price: ApiOrderPrice;
     txHash: ApiOrderTxHash;
     createdBlockNumber: string;
-    /** ERC-1155 only: units still available after the last partial fill. Null for ERC-721 or unfilled orders. */
     remainingAmount: string | null;
     createdAt: string;
     updatedAt: string;
-    /** Embedded token metadata (name/image/description). Null when not yet indexed. */
     token: ApiOrderTokenMeta | null;
-    /** Set when this is a counter-offer listing — points to the original buyer bid.
-     *  Now always emitted by the backend (was conditional); kept optional in the
-     *  type for back-compat with older response shapes. */
     parentOrderHash?: string | null;
-    /** Optional seller message accompanying a counter-offer. */
     counterOfferMessage?: string | null;
-    /** True when this order is a bid (ERC-20 offer) AND at least one ACTIVE counter
-     *  exists with `parentOrderHash = this.orderHash`. Set by endpoints that compute
-     *  it (currently `GET /v1/orders/user/:address` and `GET /v1/orders/:orderHash`);
-     *  undefined on endpoints that don't.
-     *
-     *  Use this instead of `status === "COUNTER_OFFERED"` for "this bid has been
-     *  countered" affordances. The status pattern is being phased out per
-     *  01-core-model §V — counter-offers are linked orders, not a lifecycle state. */
     hasActiveCounterOffer?: boolean;
 }
-/**
- * A single OpenSea-compatible ERC-721 attribute.
- * Medialane embeds licensing, provenance, and IP metadata as attributes.
- */
 interface IpAttribute {
     trait_type: string;
     value: string;
 }
-/**
- * Full on-chain + IPFS metadata for a Medialane IP NFT.
- * Conforms to the OpenSea ERC-721 metadata standard and embeds
- * Berne Convention-compatible licensing data in `attributes`.
- *
- * Common licensing attributes (all optional — absent on pre-v2 tokens):
- *   License · Commercial Use · Derivatives · Attribution · Territory
- *   AI Policy · Royalty · Standard ("Berne Convention") · Registration
- */
 interface IpNftMetadata {
     name: string;
     description?: string;
     image?: string | null;
     external_url?: string;
     attributes?: IpAttribute[];
-    /** Populated by the indexer for fast access — not stored in IPFS */
     ipType?: string | null;
     licenseType?: string | null;
     commercialUse?: string | null;
@@ -368,16 +288,12 @@ interface IpNftMetadata {
     royalty?: string | null;
     registration?: string | null;
 }
-/** Indexed token metadata as returned by the Medialane API. */
 interface ApiTokenMetadata {
     name: string | null;
     description: string | null;
     image: string | null;
-    /** data: or ipfs:// URI to a fully self-contained animated/interactive renderer (OpenSea-baseline `animation_url`). Null until indexed. */
     animationUrl: string | null;
-    /** Parsed OpenSea-standard attributes array. Null when metadata hasn't been fetched. */
     attributes: IpAttribute[] | null;
-    /** Short-circuit fields extracted from attributes by the indexer */
     ipType: string | null;
     licenseType: string | null;
     commercialUse: string | null;
@@ -389,10 +305,8 @@ interface ApiTokenMetadata {
     registration: string | null;
     author: string | null;
 }
-/** Per-holder balance entry. Present for ERC-1155 (multi-holder); single entry for ERC-721. */
 interface ApiTokenBalance {
     owner: string;
-    /** Quantity held. Always "1" for ERC-721. */
     amount: string;
 }
 interface ApiToken {
@@ -400,14 +314,11 @@ interface ApiToken {
     chain: string;
     contractAddress: string;
     tokenId: string;
-    /** @deprecated Use `balances` for ownership checks — always null after ERC-1155 migration. */
     owner: string | null;
     tokenUri: string | null;
     metadataStatus: "PENDING" | "FETCHING" | "FETCHED" | "FAILED";
-    /** Token standard derived from the parent collection. Use this to determine ERC-721 vs ERC-1155 behavior. */
     standard: "ERC721" | "ERC1155" | "UNKNOWN";
     metadata: ApiTokenMetadata;
-    /** Current holders with amounts. Only present on single-token fetches; null on list responses. */
     balances: ApiTokenBalance[] | null;
     activeOrders: ApiOrder[];
     createdAt: string;
@@ -425,18 +336,10 @@ interface ApiCollection {
     owner: string | null;
     startBlock: string;
     metadataStatus: "PENDING" | "FETCHING" | "FETCHED" | "FAILED";
-    /** Token standard detected via ERC-165. Collection is NFT-only since the
-     *  2026-06-14 coin split — fungible coins are `ApiCoin`, served by getCoins(). */
     standard: "ERC721" | "ERC1155";
     isKnown: boolean;
-    /** Hidden by ops/admin (content moderation). When true, list endpoints
-     *  already filter the row out; single-collection fetches still return
-     *  it so the UI can render a "hidden" banner instead of a 404. */
     isHidden: boolean;
-    /** Promoted on homepage / browse surfaces. */
     isFeatured: boolean;
-    /** Stable Medialane service ID, or null for external collections.
-     *  Resolve via getService() (05-service-model). Primary field. */
     service: string | null;
     claimedBy: string | null;
     profile?: ApiCollectionProfile | null;
@@ -447,20 +350,15 @@ interface ApiCollection {
     createdAt: string;
     updatedAt: string;
 }
-/** A fungible coin (ERC-20 today; SPL/etc. later). Distinct from ApiCollection:
- *  a coin has a supply + decimals + a market price (read live from Ekubo), no
- *  tokens, no orders. Served by getCoins()/getCoin() (spec 2026-06-14). */
 interface ApiCoin {
     id: string;
     chain: string;
     contractAddress: string;
     standard: "ERC20";
-    /** "creator-coin" | "external-erc20" */
     service: string;
     name: string | null;
     symbol: string | null;
     decimals: number;
-    /** Fungible supply as a decimal string — NOT an item count. */
     totalSupply: string | null;
     description: string | null;
     image: string | null;
@@ -474,7 +372,6 @@ interface ApiCoinsQuery {
     chain?: ChainFilter;
     page?: number;
     limit?: number;
-    /** Filter by coin service id ("creator-coin" | "external-erc20"). */
     service?: string;
 }
 interface ApiActivityPrice {
@@ -490,7 +387,6 @@ interface ApiActivity {
     from?: string;
     to?: string;
     blockNumber?: string;
-    /** ERC-1155 quantity (transfer/mint rows). "1" for ERC-721. */
     amount?: string;
     orderHash?: string;
     nftContract?: string;
@@ -498,11 +394,9 @@ interface ApiActivity {
     offerer?: string;
     fulfiller?: string | null;
     price?: ApiActivityPrice;
-    /** Token standard — present on order rows. */
     tokenStandard?: "ERC721" | "ERC1155";
     txHash: string | null;
     timestamp: string;
-    /** Batch-enriched token metadata — avoids per-row fetches. */
     token?: {
         name: string | null;
         image: string | null;
@@ -512,7 +406,6 @@ interface ApiActivity {
 interface ApiActivitiesQuery {
     chain?: ChainFilter;
     type?: ActivityType;
-    /** Scope the feed to one collection's contract address instead of the global/per-address feed. */
     contract?: string;
     page?: number;
     limit?: number;
@@ -567,32 +460,17 @@ interface ApiIntent {
     signature: string[];
     txHash: string | null;
     orderHash: string | null;
-    /** Set on COUNTER_OFFER intents — the original bid order hash being countered. */
     parentOrderHash?: string | null;
-    /** Optional seller message on counter-offer intents. */
     counterOfferMessage?: string | null;
     expiresAt: string;
     createdAt: string;
     updatedAt: string;
 }
-/** A single Starknet call as returned in intent calldata. */
 interface IntentCall {
     contractAddress: string;
     entrypoint: string;
     calldata: string[];
 }
-/**
- * Response from any `createXIntent` call. Discriminated on `requiresSignature`:
- *   • true  — SNIP-12 intent (listing / offer / cancel / counter-offer). Sign
- *             `typedData`, then call `submitIntentSignature(id, sig)` to obtain
- *             the executable calls.
- *   • false — prebuilt intent (fulfill / mint / create-collection). `calls` are
- *             ready to execute directly; there is no signature step.
- *
- * The discriminant makes the wrong access a compile error: `typedData` does not
- * exist on the `false` variant, nor `calls` on the `true` variant. Consumers
- * MUST narrow on `requiresSignature` before reading either.
- */
 type ApiIntentCreated = {
     id: string;
     expiresAt: string;
@@ -612,7 +490,6 @@ interface CreateListingIntentParams {
     price: string;
     endTime: number;
     salt?: string;
-    /** Number of units to list — required for ERC-1155, omit for ERC-721. */
     amount?: string;
 }
 interface MakeOfferIntentParams {
@@ -623,79 +500,46 @@ interface MakeOfferIntentParams {
     price: string;
     endTime: number;
     salt?: string;
-    /** Caller hint — "ERC1155" creates the bid on the ERC-1155 marketplace. */
     tokenStandard?: string;
-    /** ERC-1155 only: number of editions requested. Defaults to 1. */
     quantity?: string;
 }
 interface FulfillOrderIntentParams {
     fulfiller: string;
     orderHash: string;
-    /** Caller hint — "ERC1155" forces 1155 routing even if the order isn't in the DB yet */
     tokenStandard?: string;
-    /** ERC-1155 only: units to purchase (1 ≤ quantity ≤ remaining_amount). Defaults to 1. */
     quantity?: string;
 }
 interface CancelOrderIntentParams {
     offerer: string;
     orderHash: string;
-    /** Caller hint — "ERC1155" forces 1155 routing even if the order isn't in the DB yet */
     tokenStandard?: string;
 }
-/** Per-creator-factory services the intents API can create-collection/mint through. */
 type FactoryFamilyServiceId = "mip-erc1155" | "ip-tickets" | "ip-club";
-/** The subset of FactoryFamilyServiceId that supports CREATE_TIER (ip-tickets, ip-club). */
 type TierServiceId = "ip-tickets" | "ip-club";
-/** Services CREATE_COLLECTION can deploy — the factory-family ones plus pop-protocol/drop-collection,
- *  which take extra service-specific fields (see CreateCollectionIntentParams) since their factories
- *  don't share the uniform `deploy_collection(name, symbol, baseUri)` entrypoint. */
 type CollectionServiceId = FactoryFamilyServiceId | "pop-protocol" | "drop-collection";
 interface CreateMintIntentParams {
-    /** Collection owner wallet address — must be the collection owner on-chain */
     owner: string;
     recipient: string;
-    /** Registry mint (mip-erc721/ip-erc721, the default): required together with tokenUri. */
     collectionId?: string;
-    /** Registry mint: token metadata URI. mip-erc1155: required together with `value`. */
     tokenUri?: string;
-    /**
-     * EIP-2981 secondary-sale royalty in basis points (0–10_000). Registry mint only —
-     * has no effect (and the backend rejects it) on mip-erc1155/ip-tickets/ip-club mints.
-     */
     royaltyBps?: number;
-    /** ip-tickets/ip-club mint: the existing tier's token id (create it first via createTierIntent). */
     tokenId?: string;
-    /** ip-tickets/ip-club mint: copies to mint into `tokenId`. */
     amount?: string;
-    /** mip-erc1155 mint: edition count for the newly-minted token. */
     value?: string;
-    /** Required for every factory-family mint (mip-erc1155/ip-tickets/ip-club); omit for registry mint. */
     collectionContract?: string;
 }
 interface CreateCollectionIntentParams {
     owner: string;
     name: string;
     symbol: string;
-    /** Optional description stored server-side and surfaced on the collection page. */
     description?: string;
-    /** Optional IPFS image URI (ipfs://...) for the collection cover image. */
     image?: string;
-    /** Base URI for token metadata. Defaults to empty string if not provided. */
     baseUri?: string;
-    /** Optional: override the default collection contract address (registry path only). */
     collectionContract?: string;
-    /**
-     * Omit for the registry path (mip-erc721/ip-erc721). Pass a collection-service id to
-     * deploy a new per-creator contract via that service's factory instead.
-     */
     service?: CollectionServiceId;
-    /** pop-protocol only: unix seconds after which `claim()` stops working. */
     claimEndTimestamp?: number;
-    /** pop-protocol only: the POPFactory's EventType variant name (e.g. "Conference"). */
     eventType?: PopEventType;
-    /** drop-collection only: total mintable supply across the whole drop. */
     maxSupply?: string;
-    /** drop-collection only: the initial claim window/price/per-wallet cap. */
     conditions?: {
         startTime: number;
         endTime: number;
@@ -706,11 +550,6 @@ interface CreateCollectionIntentParams {
 }
 interface CreateCheckoutIntentParams {
     fulfiller: string;
-    /**
-     * Order hashes to check out (1–20). The backend builds one FULFILL_ORDER
-     * intent per hash, not one atomic multi-item order — the client concatenates
-     * each result's `calls` into a single multicall.
-     */
     orderHashes: string[];
 }
 interface ApiCheckoutIntentResult {
@@ -719,12 +558,10 @@ interface ApiCheckoutIntentResult {
     requiresSignature?: false;
     calls?: unknown;
     expiresAt?: string;
-    /** Set instead of the above when this specific order couldn't be built (e.g. not yet indexed). */
     error?: string;
 }
 interface CreateTierIntentParams {
     owner: string;
-    /** The ip-tickets/ip-club collection contract to define the tier on. */
     collection: string;
     service: TierServiceId;
     maxSupply: string;
@@ -734,57 +571,40 @@ interface CreateTierIntentParams {
     metadataUri: string;
 }
 interface CreateCoinIntentParams {
-    /** Owner of the new coin — the only address allowed to launch it. */
     owner: string;
     name: string;
     symbol: string;
-    /** Full fixed supply (raw, 18 decimals). Minted to the Factory until launch. */
     initialSupply: string;
-    /** Deterministic deploy salt. Omitted = timestamp-derived. */
     salt?: string;
 }
 interface LaunchCoinIntentParams {
-    /** Wallet that must own the coin — the contract itself is the authority; an
-     *  unauthorized caller simply reverts. */
     owner: string;
-    /** The deployed CreatorCoin contract (from a prior createCoinIntent deploy). */
     creatorCoin: string;
-    /** Quote token (e.g. STRK). Must NOT itself be a Creator Coin. */
     quoteToken: string;
-    /** Team-allocation recipients (≤10% of supply, summed). */
     initialHolders: string[];
     initialHoldersAmounts: string[];
-    /** Anti-snipe window in seconds. Omitted = none. */
     transferRestrictionDelay?: number;
-    /** Max % of supply buyable per tx during the window, in bps. Omitted = the SDK default. */
     maxPercentageBuyLaunch?: number;
-    /** Quote (raw units) to transfer to the Factory in the same multicall, to fund the team-allocation buyback. */
     quoteFundAmount?: string;
 }
 interface CreateSponsorshipOfferIntentParams {
-    /** The offer author — must currently own (nftContract, tokenId) on-chain. */
     author: string;
     nftContract: string;
     tokenId: string;
     minAmount: string;
-    /** Seconds, applied from acceptance (not from offer creation). */
     duration: number;
     paymentToken: string;
     licenseTermsUri: string;
     transferable: boolean;
-    /** Basis points, 0–10000. EIP-2981 royalty to the author on license resale. */
     royaltyBps: number;
-    /** Restricts acceptance to one sponsor address; omit for open bidding. */
     specificSponsor?: string;
 }
 interface SetSponsorshipOfferOpenIntentParams {
-    /** Must be the offer's author. */
     author: string;
     offerId: string;
     open: boolean;
 }
 interface PlaceSponsorshipBidIntentParams {
-    /** The sponsor placing the bid — becomes the ERC-20 approve + place_bid caller. */
     sponsor: string;
     offerId: string;
     amount: string;
@@ -795,21 +615,16 @@ interface RetractSponsorshipBidIntentParams {
     offerId: string;
 }
 interface AcceptSponsorshipBidIntentParams {
-    /** Must be the offer's author — re-verified on-chain. */
     author: string;
     offerId: string;
-    /** The bidder whose bid is being accepted. */
     sponsor: string;
 }
 interface CreateSponsorshipProposalIntentParams {
-    /** The sponsor proposing terms — pays if accepted. */
     proposer: string;
     nftContract: string;
     tokenId: string;
-    /** Fixed take-it-or-leave-it amount (not a bid floor). */
     amount: string;
     duration: number;
-    /** Unix seconds; the deadline for the asset owner to accept. Omit/0 = no deadline. */
     validUntil?: number;
     paymentToken: string;
     licenseTermsUri: string;
@@ -821,7 +636,6 @@ interface WithdrawSponsorshipProposalIntentParams {
     proposalId: string;
 }
 interface AcceptSponsorshipProposalIntentParams {
-    /** Must currently own the asset — re-verified on-chain (binds to the asset, not a person). */
     owner: string;
     proposalId: string;
 }
@@ -830,21 +644,14 @@ interface RejectSponsorshipProposalIntentParams {
     proposalId: string;
 }
 interface CreateCounterOfferIntentParams {
-    /** Wallet address of the NFT owner making the counter-offer. */
     sellerAddress: string;
-    /** Order hash of the original buyer bid being countered. */
     originalOrderHash: string;
-    /** Counter price as a raw wei integer string (not human-readable). */
     priceRaw: string;
-    /** Duration in seconds the counter-offer will be valid (3600–2592000). */
     durationSeconds: number;
-    /** Optional message from the seller to the buyer. Max 500 chars. */
     message?: string;
 }
 interface ApiCounterOffersQuery {
-    /** Original bid order hash — returns the counter-offer for this specific bid. */
     originalOrderHash?: string;
-    /** Seller address — returns all counter-offers sent by this seller. */
     sellerAddress?: string;
     page?: number;
     limit?: number;
@@ -866,7 +673,6 @@ interface ApiRemixOffer {
     creatorAddress: string;
     requesterAddress: string | null;
     message?: string | null;
-    /** Visible only to creator and requester — includes formatted price */
     price?: ApiRemixOfferPrice;
     licenseType: string;
     commercial: boolean;
@@ -880,7 +686,6 @@ interface ApiRemixOffer {
     expiresAt: string;
     updatedAt: string;
 }
-/** Public remix record — price/currency omitted for non-participants */
 interface ApiPublicRemix {
     id: string;
     remixContract: string | null;
@@ -900,7 +705,6 @@ interface CreateRemixOfferParams {
     proposedPrice?: string;
     proposedCurrency?: string;
     message?: string;
-    /** Offer validity in days (server default applies if omitted) */
     expiresInDays?: number;
 }
 interface AutoRemixOfferParams {
@@ -913,7 +717,6 @@ interface ConfirmSelfRemixParams {
     originalTokenId: string;
     remixContract: string;
     remixTokenId: string;
-    /** On-chain transaction hash of the mint tx */
     txHash?: string;
     licenseType: string;
     commercial: boolean;
@@ -927,7 +730,6 @@ interface ConfirmRemixOfferParams {
     orderHash?: string;
 }
 interface ApiRemixOffersQuery {
-    /** "creator" = offers where you are the original creator; "requester" = offers you made */
     role: "creator" | "requester";
     page?: number;
     limit?: number;
@@ -958,7 +760,6 @@ interface ApiPortalKeyCreated {
     id: string;
     prefix: string;
     label: string | null;
-    /** Plaintext key — shown ONCE at creation */
     plaintext: string;
 }
 interface ApiUsageDay {
@@ -973,7 +774,6 @@ interface ApiWebhookEndpoint {
     createdAt: string;
 }
 interface ApiWebhookCreated extends ApiWebhookEndpoint {
-    /** Signing secret — shown ONCE at creation, not stored in plaintext */
     secret: string;
 }
 interface CreateWebhookParams {
@@ -1018,11 +818,6 @@ interface ApiCreatorProfile {
     displayName: string | null;
     bio: string | null;
     avatarImage: string | null;
-    /** Computed fallback used by the creator-list / creator-page endpoints
-     *  ONLY when `avatarImage` is null: image of any collection owned by
-     *  this creator. Undefined on profile-detail endpoints where this
-     *  lookup isn't performed. UI may use this to populate hero banners
-     *  without an extra fetch. */
     collectionImage?: string | null;
     websiteUrl: string | null;
     twitterUrl: string | null;
@@ -1042,6 +837,7 @@ interface ApiUserWallet {
     walletAddress: string;
     email?: string | null;
     emailVerified?: boolean;
+    requiresEmailVerification?: boolean;
 }
 interface ApiCollectionClaim {
     id: string;
@@ -1065,9 +861,6 @@ interface ApiBusinessProvisioning {
     accountId: string;
     chain: string;
     walletAddress: string;
-    /** Free-form (mirrors Identity.scheme) — "email" is the only scheme the backend
-     *  delivers a claim link for on its own; any other scheme still registers, the
-     *  business gets `claimUrl` back on the register response and delivers it itself. */
     recipientScheme: string;
     recipientValue: string;
     interimOwnerPubkey: string;
@@ -1177,12 +970,9 @@ type MedialaneErrorCode = "TOKEN_NOT_FOUND" | "COLLECTION_NOT_FOUND" | "ORDER_NO
 
 declare class MedialaneApiError extends Error {
     readonly status: number;
-    /** Parsed `Retry-After` (ms) when the server sent one — used by withRetry on 429. */
     readonly retryAfterMs?: number | undefined;
     readonly code: MedialaneErrorCode;
-    constructor(status: number, message: string, 
-    /** Parsed `Retry-After` (ms) when the server sent one — used by withRetry on 429. */
-    retryAfterMs?: number | undefined);
+    constructor(status: number, message: string, retryAfterMs?: number | undefined);
 }
 declare class ApiClient {
     private readonly baseUrl;
@@ -1190,21 +980,12 @@ declare class ApiClient {
     private readonly baseHeaders;
     private readonly retryOptions;
     constructor(baseUrl: string, apiKey?: string, retryOptions?: RetryOptions, chain?: Chain);
-    /** Normalize an address for this client's chain (chain-scoped — Decision B). */
     private addr;
-    /**
-     * The one HTTP path for the whole client: base headers (incl. x-api-key),
-     * JSON error unwrapping, and `withRetry` (5xx/network only — 4xx never
-     * retried). `allow404`/`allow403` turn those statuses into a `null` result
-     * instead of a throw, for "profile may not exist" / "not a holder" reads —
-     * so no method needs to hand-roll `fetch` to get that behavior.
-     */
     private request;
     private get;
     private post;
     private patch;
     private del;
-    /** Bearer header for SIWS-token-authenticated routes. */
     private bearer;
     getOrders(query?: ApiOrdersQuery): Promise<ApiResponse<ApiOrder[]>>;
     getOrder(orderHash: string): Promise<ApiResponse<ApiOrder>>;
@@ -1213,7 +994,7 @@ declare class ApiClient {
     getToken(contract: string, tokenId: string, wait?: boolean): Promise<ApiResponse<ApiToken>>;
     getTokensByOwner(address: string, page?: number, limit?: number): Promise<ApiResponse<ApiToken[]>>;
     getTokenHistory(contract: string, tokenId: string, page?: number, limit?: number): Promise<ApiResponse<ApiActivity[]>>;
-    getCollections(page?: number, limit?: number, isKnown?: boolean, sort?: CollectionSort, service?: string, chain?: ChainFilter): Promise<ApiResponse<ApiCollection[]>>;
+    getCollections(page?: number, limit?: number, isKnown?: boolean, sort?: CollectionSort, service?: string, chain?: ChainFilter, standard?: string): Promise<ApiResponse<ApiCollection[]>>;
     getCollectionsByOwner(owner: string, page?: number, limit?: number): Promise<ApiResponse<ApiCollection[]>>;
     getCollection(contract: string): Promise<ApiResponse<ApiCollection>>;
     getCollectionTokens(contract: string, page?: number, limit?: number, sort?: CollectionTokensSort): Promise<ApiResponse<ApiToken[]>>;
@@ -1250,16 +1031,7 @@ declare class ApiClient {
     withdrawSponsorshipProposalIntent(params: WithdrawSponsorshipProposalIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
     acceptSponsorshipProposalIntent(params: AcceptSponsorshipProposalIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
     rejectSponsorshipProposalIntent(params: RejectSponsorshipProposalIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
-    /**
-     * Create a counter-offer intent. The seller proposes a new price in response
-     * to a buyer's active bid. siwsToken is optional — the endpoint authenticates
-     * via the tenant API key; pass a SIWS token only if your backend requires it.
-     */
     createCounterOfferIntent(params: CreateCounterOfferIntentParams, siwsToken?: string): Promise<ApiResponse<ApiIntentCreated>>;
-    /**
-     * Fetch counter-offers. Pass `originalOrderHash` (buyer view) or
-     * `sellerAddress` (seller view) — at least one is required.
-     */
     getCounterOffers(query: ApiCounterOffersQuery): Promise<ApiResponse<ApiOrder[]>>;
     getMetadataSignedUrl(): Promise<ApiResponse<ApiMetadataSignedUrl>>;
     uploadMetadata(metadata: Record<string, unknown>): Promise<ApiResponse<ApiMetadataUpload>>;
@@ -1279,18 +1051,11 @@ declare class ApiClient {
         id: string;
         status: string;
     }>>;
-    /**
-     * Path 1: On-chain auto claim. Sends both x-api-key (tenant auth) and
-     * Authorization: Bearer (SIWS token) simultaneously.
-     */
     claimCollection(contractAddress: string, walletAddress: string, siwsToken: string): Promise<{
         verified: boolean;
         collection?: ApiCollection;
         reason?: string;
     }>;
-    /**
-     * Path 3: Manual off-chain claim request (email-based).
-     */
     requestCollectionClaim(params: {
         contractAddress: string;
         walletAddress?: string;
@@ -1310,50 +1075,32 @@ declare class ApiClient {
     }>>;
     completeBusinessProvisioning(id: string): Promise<ApiResponse<ApiBusinessProvisioning>>;
     getCollectionProfile(contractAddress: string): Promise<ApiCollectionProfile | null>;
-    /**
-     * Update collection profile. Requires SIWS token for ownership check.
-     */
     updateCollectionProfile(contractAddress: string, data: Partial<Omit<ApiCollectionProfile, "contractAddress" | "chain" | "updatedBy" | "updatedAt">>, siwsToken: string): Promise<ApiCollectionProfile>;
-    /** No signature required — wallet activity is public on-chain data, read like any other /v1 GET. */
     getWalletActivity(address: string, chain?: "STARKNET"): Promise<ApiResponse<ApiWalletActivity[]>>;
     getGatedContent(contractAddress: string, siwsToken: string): Promise<{
         title: string;
         url: string;
         type: string;
     } | null>;
-    /** List all creators with an approved username. */
     getCreators(opts?: {
         search?: string;
         page?: number;
         limit?: number;
     }): Promise<ApiCreatorListResult>;
     getCreatorProfile(walletAddress: string): Promise<ApiCreatorProfile | null>;
-    /** Resolve a username slug to a creator profile (public). */
     getCreatorByUsername(username: string): Promise<ApiCreatorProfile | null>;
-    /**
-     * Update creator profile. Requires SIWS token; wallet must match authenticated user.
-     */
     updateCreatorProfile(walletAddress: string, data: Partial<Omit<ApiCreatorProfile, "walletAddress" | "chain" | "updatedAt">>, siwsToken: string): Promise<ApiCreatorProfile>;
-    /** Check if a collection slug is available (public, no auth). */
     checkCollectionSlugAvailability(slug: string): Promise<{
         available: boolean;
         reason?: string;
     }>;
-    /** Submit a slug claim for a collection. Requires SIWS token — caller must be the collection owner. */
     submitCollectionSlugClaim(contractAddress: string, slug: string, siwsToken: string, notifyEmail?: string): Promise<{
         claim: ApiCollectionSlugClaim;
     }>;
-    /** Returns all slug claims submitted by the authenticated wallet. Requires SIWS token. */
     getMyCollectionSlugClaims(siwsToken: string): Promise<{
         claims: ApiCollectionSlugClaim[];
     }>;
-    /** Resolve a collection slug to a full collection. Returns null if not found. */
     getCollectionBySlug(slug: string): Promise<ApiCollection | null>;
-    /**
-     * Frictionless wallet registration. Tenant API key only (no SIWS token required).
-     * Idempotent — backend's ensureAccountForWallet upserts and upgrades existing
-     * UNKNOWN walletType rows when a more specific value is supplied.
-     */
     registerUser(params: {
         walletAddress: string;
         walletType?: string;
@@ -1376,55 +1123,19 @@ declare class ApiClient {
         email?: string;
         accountToken?: string;
     }): Promise<ApiUserWallet>;
-    /** Whether an email already has an account attached — used by io's onboarding to branch into an "already exists" message instead of creating a duplicate account. */
     checkEmailExists(email: string): Promise<boolean>;
-    /**
-     * Get the authenticated user's stored wallet address from the backend DB.
-     * Returns null if the user has not completed onboarding yet.
-     * Requires SIWS token; no tenant API key needed.
-     */
     getMyWallet(siwsToken: string): Promise<ApiUserWallet | null>;
-    /**
-     * Get public remixes of a token (open to everyone).
-     */
     getTokenRemixes(contract: string, tokenId: string, opts?: {
         page?: number;
         limit?: number;
     }): Promise<ApiResponse<ApiPublicRemix[]>>;
-    /**
-     * Submit a custom remix offer for a token. Requires SIWS token.
-     */
     submitRemixOffer(params: CreateRemixOfferParams, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
-    /**
-     * Submit an auto remix offer for a token with an open license. Requires SIWS token.
-     */
     submitAutoRemixOffer(params: AutoRemixOfferParams, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
-    /**
-     * Record a self-remix (owner remixing their own token). Requires SIWS token.
-     */
     confirmSelfRemix(params: ConfirmSelfRemixParams, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
-    /**
-     * List remix offers by role. Requires SIWS token.
-     * role="creator" — offers where you are the original creator.
-     * role="requester" — offers you made.
-     */
     getRemixOffers(query: ApiRemixOffersQuery, siwsToken: string): Promise<ApiResponse<ApiRemixOffer[]>>;
-    /**
-     * Get a single remix offer. SIWS token optional (price/currency hidden for non-participants).
-     */
     getRemixOffer(id: string, siwsToken?: string): Promise<ApiResponse<ApiRemixOffer>>;
-    /**
-     * Creator approves a remix offer (authorises the requester to mint). Requires SIWS token.
-     */
     confirmRemixOffer(id: string, params: ConfirmRemixOfferParams, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
-    /**
-     * Creator rejects a remix offer. Requires SIWS token.
-     */
     rejectRemixOffer(id: string, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
-    /**
-     * Requester extends the expiry of a pending remix offer by 1–30 days.
-     * Requires SIWS token.
-     */
     extendRemixOffer(id: string, days: number, siwsToken: string): Promise<ApiResponse<ApiRemixOffer>>;
     getPopCollections(opts?: {
         page?: number;
@@ -1437,11 +1148,6 @@ declare class ApiClient {
     getCoin(contract: string): Promise<{
         data: ApiCoin;
     }>;
-    /**
-     * Creator-authed coin profile edit (image/description). Backend authorizes
-     * via `coin.creator` (trustless — from the factory event), not a body param;
-     * `siwsToken` is the caller's SIWS bearer token for `identityAuth`.
-     */
     updateCoinProfile(contract: string, data: {
         image?: string;
         description?: string;
@@ -1452,15 +1158,10 @@ declare class ApiClient {
         sort?: CollectionSort;
     }): Promise<ApiResponse<ApiCollection[]>>;
     getDropMintStatus(collection: string, wallet: string): Promise<DropMintStatus>;
-    /** Score + level + progress + badges for one address (zeroed for unknown). */
     getRewards(address: string): Promise<ApiUserRewards>;
-    /** Paginated XP leaderboard. */
     getRewardsLeaderboard(page?: number, limit?: number): Promise<ApiResponse<ApiRewardsLeaderboardEntry[]>>;
-    /** Point-event history for an address. */
     getRewardsEvents(address: string, page?: number, limit?: number): Promise<ApiResponse<ApiPointEvent[]>>;
-    /** Reward configuration: level ladder, enabled action XP values, badge catalog. */
     getRewardsConfig(): Promise<ApiRewardsConfig>;
-    /** Minimal level info for up to 50 addresses — one call per list page. */
     getRewardsBatch(addresses: string[]): Promise<ApiRewardsBatchEntry[]>;
 }
 
@@ -1499,9 +1200,7 @@ interface OrderDetails {
     start_time: bigint;
     end_time: bigint;
     order_status: string;
-    /** The offerer's bulk-cancel epoch at registration; re-checked at fulfilment. */
     counter: string;
-    /** ERC-1155 only — units still available. */
     remaining_amount?: string;
 }
 
@@ -1513,15 +1212,10 @@ interface CreatePopCollectionParams {
     eventType: PopEventType;
 }
 interface ClaimConditions {
-    /** Unix timestamp when minting opens. 0 = open immediately. */
     startTime: number;
-    /** Unix timestamp when minting closes. 0 = never closes. */
     endTime: number;
-    /** Price per token in payment_token units. 0 = free mint. */
     price: bigint | string;
-    /** ERC-20 token address for payment. Must be non-zero if price > 0. */
     paymentToken: string;
-    /** Max tokens a single wallet may mint across all phases. 0 = unlimited. */
     maxQuantityPerWallet: bigint | string;
 }
 interface CreateDropParams {
@@ -1532,16 +1226,11 @@ interface CreateDropParams {
     initialConditions: ClaimConditions;
 }
 interface CreateTicketParams {
-    /** Address of the deployed IPTicketCollection contract. */
     collection: string;
     maxSupply: bigint | string;
-    /** Unix timestamp (seconds). Omit for "open immediately". */
     startTime?: number;
-    /** Unix timestamp (seconds). Omit for "never expires". */
     endTime?: number;
-    /** Basis points, 0–10000. */
     royaltyBps: number;
-    /** ipfs:// or ar:// — enforced on-chain. */
     metadataUri: string;
 }
 interface MintTicketsParams {
@@ -1551,16 +1240,11 @@ interface MintTicketsParams {
     amount: bigint | string;
 }
 interface CreateMembershipParams {
-    /** Address of the deployed IPClubCollection contract. */
     collection: string;
     maxSupply: bigint | string;
-    /** Unix timestamp (seconds). Omit for "valid immediately". Gates membership, never minting. */
     startTime?: number;
-    /** Unix timestamp (seconds). Omit for "lifetime membership". */
     endTime?: number;
-    /** Basis points, 0–10000. */
     royaltyBps: number;
-    /** ipfs:// or ar:// — enforced on-chain. */
     metadataUri: string;
 }
 interface MintMembershipsParams {
@@ -1573,29 +1257,22 @@ interface CreateSponsorshipOfferParams {
     nftContract: string;
     tokenId: bigint | string;
     minAmount: bigint | string;
-    /** Seconds, applied from acceptance (not from offer creation). */
     duration: number;
     paymentToken: string;
     licenseTermsUri: string;
     transferable: boolean;
-    /** Basis points, 0–10000. EIP-2981 royalty to the author on license resale. */
     royaltyBps: bigint | string;
-    /** Restricts acceptance to one sponsor address; omit for open bidding. */
     specificSponsor?: string;
 }
-/** Sponsor-initiated — the symmetric counterpart to CreateSponsorshipOfferParams. */
 interface ProposeSponsorshipParams {
     nftContract: string;
     tokenId: bigint | string;
-    /** Fixed take-it-or-leave-it amount (not a bid floor). */
     amount: bigint | string;
     duration: number;
-    /** Unix seconds; the deadline for the asset owner to accept. 0 = no deadline. */
     validUntil?: number;
     paymentToken: string;
     licenseTermsUri: string;
     transferable: boolean;
-    /** Basis points, 0–10000. */
     royaltyBps: bigint | string;
 }