@medialane/sdk 0.70.0 → 0.71.0

package/dist/services-D7n-cJYt.d.cts

@@ -0,0 +1,1355 @@
+import { z } from 'zod';
+import { C as Chain } from './types-Cdwb6lXp.cjs';
+
+interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    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;
+
+declare const MedialaneConfigSchema: z.ZodObject<{
+    chain: z.ZodDefault<z.ZodEnum<["STARKNET", "ETHEREUM", "SOLANA", "BASE", "STELLAR", "BITCOIN"]>>;
+    rpcUrl: z.ZodOptional<z.ZodString>;
+    backendUrl: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    marketplace721Contract: z.ZodOptional<z.ZodString>;
+    marketplaceContract: z.ZodOptional<z.ZodString>;
+    marketplace1155Contract: z.ZodOptional<z.ZodString>;
+    collection721Contract: z.ZodOptional<z.ZodString>;
+    collectionContract: z.ZodOptional<z.ZodString>;
+    collection1155Contract: z.ZodOptional<z.ZodString>;
+    retryOptions: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        baseDelayMs: z.ZodOptional<z.ZodNumber>;
+        maxDelayMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxAttempts?: number | undefined;
+        baseDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+    }, {
+        maxAttempts?: number | undefined;
+        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, {
+    chain: "STARKNET" | "ETHEREUM" | "SOLANA" | "BASE" | "STELLAR" | "BITCOIN";
+    rpcUrl?: string | undefined;
+    backendUrl?: string | undefined;
+    apiKey?: string | undefined;
+    marketplace721Contract?: string | undefined;
+    marketplaceContract?: string | undefined;
+    marketplace1155Contract?: string | undefined;
+    collection721Contract?: string | undefined;
+    collectionContract?: string | undefined;
+    collection1155Contract?: string | undefined;
+    retryOptions?: {
+        maxAttempts?: number | undefined;
+        baseDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+    } | undefined;
+    feeConfig?: {
+        enabled: boolean;
+        marketplaceBps: number;
+        launchpadBps: number;
+        fundAddress?: string | undefined;
+    } | undefined;
+}, {
+    rpcUrl?: string | undefined;
+    chain?: "STARKNET" | "ETHEREUM" | "SOLANA" | "BASE" | "STELLAR" | "BITCOIN" | undefined;
+    backendUrl?: string | undefined;
+    apiKey?: string | undefined;
+    marketplace721Contract?: string | undefined;
+    marketplaceContract?: string | undefined;
+    marketplace1155Contract?: string | undefined;
+    collection721Contract?: string | undefined;
+    collectionContract?: string | undefined;
+    collection1155Contract?: string | undefined;
+    retryOptions?: {
+        maxAttempts?: number | undefined;
+        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 {
+    chain: Chain;
+    rpcUrl: string;
+    backendUrl: string | undefined;
+    apiKey: string | undefined;
+    marketplace721Contract: string;
+    marketplaceContract: string;
+    marketplace1155Contract: string;
+    collection721Contract: string;
+    collectionContract: string;
+    collection1155Contract: string;
+    retryOptions?: RetryOptions;
+    feeConfig: ResolvedFeeConfig;
+}
+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;
+    standard: "ERC721" | "ERC1155" | "ERC20" | "UNKNOWN";
+    provenance: "MEDIALANE" | "EXTERNAL";
+    onchain?: Partial<Record<Chain, {
+        factoryAddress?: string;
+        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;
+    };
+}
+interface ApiCollectionsQuery {
+    page?: number;
+    limit?: number;
+    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";
+type IntentType = "CREATE_LISTING" | "MAKE_OFFER" | "FULFILL_ORDER" | "CANCEL_ORDER" | "MINT" | "CREATE_COLLECTION" | "COUNTER_OFFER";
+type IntentStatus = "PENDING" | "SIGNED" | "SUBMITTED" | "CONFIRMED" | "FAILED" | "EXPIRED";
+type WebhookEventType = "ORDER_CREATED" | "ORDER_FULFILLED" | "ORDER_CANCELLED" | "TRANSFER";
+type WebhookStatus = "ACTIVE" | "DISABLED";
+type ApiKeyStatus = "ACTIVE" | "REVOKED";
+type TenantPlan = "FREE" | "PREMIUM";
+interface ApiMeta {
+    page: number;
+    limit: number;
+    total?: number;
+}
+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;
+    status?: OrderStatus;
+    collection?: string;
+    currency?: string;
+    sort?: SortOrder;
+    page?: number;
+    limit?: number;
+    offerer?: string;
+    minPrice?: string;
+    maxPrice?: string;
+}
+interface ApiOrderOffer {
+    itemType: string;
+    token: string;
+    identifier: string;
+    startAmount: string;
+    endAmount: string;
+}
+interface ApiOrderConsideration extends ApiOrderOffer {
+    recipient: string;
+}
+interface ApiOrderPrice {
+    raw: string | null;
+    formatted: string | null;
+    currency: string | null;
+    decimals: number;
+}
+interface ApiOrderTxHash {
+    created: string | null;
+    fulfilled: string | null;
+    cancelled: string | null;
+}
+interface ApiOrderTokenMeta {
+    name: string | null;
+    image: string | null;
+    description: string | null;
+}
+interface ApiOrder {
+    id: string;
+    chain: string;
+    orderHash: string;
+    offerer: string;
+    offer: ApiOrderOffer;
+    consideration: ApiOrderConsideration;
+    startTime: string;
+    endTime: string;
+    status: OrderStatus;
+    fulfiller: string | null;
+    nftContract: string | null;
+    nftTokenId: string | null;
+    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;
+    derivatives?: string | null;
+    attribution?: string | null;
+    territory?: string | null;
+    aiPolicy?: string | null;
+    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;
+    /** 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;
+    derivatives: string | null;
+    attribution: string | null;
+    territory: string | null;
+    aiPolicy: string | null;
+    royalty: string | null;
+    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 {
+    id: string;
+    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;
+    updatedAt: string;
+}
+interface ApiCollection {
+    id: string;
+    chain: string;
+    contractAddress: string;
+    collectionId: string | null;
+    name: string | null;
+    symbol: string | null;
+    description: string | null;
+    image: string | null;
+    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;
+    floorPrice: string | null;
+    totalVolume: string | null;
+    holderCount: number | null;
+    totalSupply: number | null;
+    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;
+    creator: string | null;
+    startBlock: string;
+    isHidden: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ApiCoinsQuery {
+    chain?: ChainFilter;
+    page?: number;
+    limit?: number;
+    /** Filter by coin service id ("creator-coin" | "external-erc20"). */
+    service?: string;
+}
+interface ApiActivityPrice {
+    raw: string | null;
+    formatted: string | null;
+    currency: string | null;
+}
+interface ApiActivity {
+    type: ActivityType;
+    contractAddress?: string;
+    tokenId?: string;
+    from?: string;
+    to?: string;
+    blockNumber?: string;
+    /** ERC-1155 quantity (transfer/mint rows). "1" for ERC-721. */
+    amount?: string;
+    orderHash?: string;
+    nftContract?: string;
+    nftTokenId?: string;
+    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;
+    } | null;
+}
+interface ApiActivitiesQuery {
+    chain?: ChainFilter;
+    type?: ActivityType;
+    page?: number;
+    limit?: number;
+}
+interface ApiComment {
+    id: string;
+    chain: string;
+    contractAddress: string;
+    tokenId: string;
+    author: string;
+    content: string;
+    txHash: string | null;
+    blockNumber: string;
+    postedAt: string;
+}
+interface ApiSearchTokenResult {
+    contractAddress: string;
+    tokenId: string;
+    name: string | null;
+    image: string | null;
+    owner: string;
+    metadataStatus: string;
+}
+interface ApiSearchCollectionResult {
+    contractAddress: string;
+    name: string | null;
+    image: string | null;
+    totalSupply: number | null;
+    floorPrice: string | null;
+    holderCount: number | null;
+}
+interface ApiSearchCreatorResult {
+    walletAddress: string;
+    username: string | null;
+    displayName: string | null;
+    bio: string | null;
+    avatarImage: string | null;
+}
+interface ApiSearchResult {
+    tokens: ApiSearchTokenResult[];
+    collections: ApiSearchCollectionResult[];
+    creators: ApiSearchCreatorResult[];
+}
+interface ApiIntent {
+    id: string;
+    chain: string;
+    type: IntentType;
+    status: IntentStatus;
+    requester: string;
+    typedData: unknown;
+    calls: unknown;
+    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;
+    requiresSignature: true;
+    typedData: unknown;
+} | {
+    id: string;
+    expiresAt: string;
+    requiresSignature: false;
+    calls: IntentCall[];
+};
+interface CreateListingIntentParams {
+    offerer: string;
+    nftContract: string;
+    tokenId: string;
+    currency: string;
+    price: string;
+    endTime: number;
+    salt?: string;
+    /** Number of units to list — required for ERC-1155, omit for ERC-721. */
+    amount?: string;
+}
+interface MakeOfferIntentParams {
+    offerer: string;
+    nftContract: string;
+    tokenId: string;
+    currency: string;
+    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;
+}
+interface CreateMintIntentParams {
+    /** Collection owner wallet address — must be the collection owner on-chain */
+    owner: string;
+    collectionId: string;
+    recipient: string;
+    tokenUri: string;
+    /**
+     * EIP-2981 secondary-sale royalty in basis points (0–10_000). Set once at mint;
+     * receiver is the immutable creator. Required since MIP v0.4.0 — pass 0 for none.
+     */
+    royaltyBps: number;
+    /** Optional: override the default collection contract address */
+    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 */
+    collectionContract?: 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;
+}
+declare const OPEN_LICENSES: readonly ["CC0", "CC BY", "CC BY-SA", "CC BY-NC"];
+type OpenLicense = (typeof OPEN_LICENSES)[number];
+type RemixOfferStatus = "PENDING" | "AUTO_PENDING" | "APPROVED" | "COMPLETED" | "REJECTED" | "EXPIRED" | "SELF_MINTED";
+interface ApiRemixOfferPrice {
+    raw: string;
+    formatted: string;
+    currency: string;
+    decimals: number;
+}
+interface ApiRemixOffer {
+    id: string;
+    status: RemixOfferStatus;
+    originalContract: string;
+    originalTokenId: string;
+    creatorAddress: string;
+    requesterAddress: string | null;
+    message?: string | null;
+    /** Visible only to creator and requester — includes formatted price */
+    price?: ApiRemixOfferPrice;
+    licenseType: string;
+    commercial: boolean;
+    derivatives: boolean;
+    royaltyPct: number | null;
+    approvedCollection: string | null;
+    remixContract: string | null;
+    remixTokenId: string | null;
+    orderHash: string | null;
+    createdAt: string;
+    expiresAt: string;
+    updatedAt: string;
+}
+/** Public remix record — price/currency omitted for non-participants */
+interface ApiPublicRemix {
+    id: string;
+    remixContract: string | null;
+    remixTokenId: string | null;
+    licenseType: string;
+    commercial: boolean;
+    derivatives: boolean;
+    createdAt: string;
+}
+interface CreateRemixOfferParams {
+    originalContract: string;
+    originalTokenId: string;
+    licenseType: string;
+    commercial: boolean;
+    derivatives: boolean;
+    royaltyPct?: number;
+    proposedPrice?: string;
+    proposedCurrency?: string;
+    message?: string;
+    /** Offer validity in days (server default applies if omitted) */
+    expiresInDays?: number;
+}
+interface AutoRemixOfferParams {
+    originalContract: string;
+    originalTokenId: string;
+    licenseType: string;
+}
+interface ConfirmSelfRemixParams {
+    originalContract: string;
+    originalTokenId: string;
+    remixContract: string;
+    remixTokenId: string;
+    /** On-chain transaction hash of the mint tx */
+    txHash?: string;
+    licenseType: string;
+    commercial: boolean;
+    derivatives: boolean;
+    royaltyPct?: number;
+}
+interface ConfirmRemixOfferParams {
+    approvedCollection: string;
+    remixContract: string;
+    remixTokenId: string;
+    orderHash?: string;
+}
+interface ApiRemixOffersQuery {
+    /** "creator" = offers where you are the original creator; "requester" = offers you made */
+    role: "creator" | "requester";
+    page?: number;
+    limit?: number;
+}
+interface ApiMetadataSignedUrl {
+    url: string;
+}
+interface ApiMetadataUpload {
+    cid: string;
+    url: string;
+}
+interface ApiPortalMe {
+    id: string;
+    name: string;
+    email: string;
+    plan: TenantPlan;
+    status: string;
+}
+interface ApiPortalKey {
+    id: string;
+    prefix: string;
+    label: string;
+    status: ApiKeyStatus;
+    lastUsedAt: string | null;
+    createdAt: string;
+}
+interface ApiPortalKeyCreated {
+    id: string;
+    prefix: string;
+    label: string | null;
+    /** Plaintext key — shown ONCE at creation */
+    plaintext: string;
+}
+interface ApiUsageDay {
+    day: string;
+    requests: number;
+}
+interface ApiWebhookEndpoint {
+    id: string;
+    url: string;
+    events: WebhookEventType[];
+    status: WebhookStatus;
+    createdAt: string;
+}
+interface ApiWebhookCreated extends ApiWebhookEndpoint {
+    /** Signing secret — shown ONCE at creation, not stored in plaintext */
+    secret: string;
+}
+interface CreateWebhookParams {
+    url: string;
+    events: WebhookEventType[];
+    label?: string;
+}
+interface ApiCollectionProfile {
+    contractAddress: string;
+    chain: string;
+    displayName: string | null;
+    description: string | null;
+    image: string | null;
+    bannerImage: string | null;
+    websiteUrl: string | null;
+    twitterUrl: string | null;
+    discordUrl: string | null;
+    telegramUrl: string | null;
+    hasGatedContent: boolean;
+    gatedContentTitle: string | null;
+    slug: string | null;
+    updatedBy: string | null;
+    updatedAt: string;
+}
+interface ApiCollectionSlugClaim {
+    id: string;
+    slug: string;
+    contractAddress: string;
+    chain: string;
+    walletAddress: string;
+    status: "PENDING" | "APPROVED" | "REJECTED";
+    adminNotes: string | null;
+    notifyEmail: string | null;
+    reviewedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ApiCreatorProfile {
+    walletAddress: string;
+    chain: string;
+    username: string | null;
+    displayName: string | null;
+    bio: string | null;
+    avatarImage: string | null;
+    bannerImage: string | null;
+    /** Computed fallback used by the creator-list / creator-page endpoints
+     *  ONLY when both `avatarImage` and `bannerImage` are 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;
+    discordUrl: string | null;
+    telegramUrl: string | null;
+    updatedAt: string;
+}
+interface ApiCreatorListResult {
+    creators: ApiCreatorProfile[];
+    total: number;
+    page: number;
+    limit: number;
+}
+type ApiAppSource = "MEDIALANE_STARKNET" | "MEDIALANE_IO" | "MEDIALANE_PORTAL" | "MEDIALANE_SDK" | "MEDIALANE_DAPP";
+type ApiChain = "STARKNET" | "ETHEREUM" | "SOLANA" | "BASE" | "BITCOIN";
+interface ApiUserWallet {
+    walletAddress: string;
+}
+interface ApiCollectionClaim {
+    id: string;
+    contractAddress: string;
+    chain: string;
+    claimantAddress: string | null;
+    status: "PENDING" | "AUTO_APPROVED" | "APPROVED" | "REJECTED";
+    verificationMethod: "ONCHAIN" | "SIGNATURE" | "MANUAL";
+    createdAt: string;
+}
+interface ApiAdminCollectionClaim extends ApiCollectionClaim {
+    claimantEmail: string | null;
+    notes: string | null;
+    adminNotes: string | null;
+    reviewedBy: string | null;
+    reviewedAt: string | null;
+    updatedAt: string;
+}
+interface PopClaimStatus {
+    isEligible: boolean;
+    hasClaimed: boolean;
+    tokenId: string | null;
+}
+interface PopBatchEligibilityItem extends PopClaimStatus {
+    wallet: string;
+}
+type PopEventType = "Conference" | "Bootcamp" | "Workshop" | "Hackathon" | "Meetup" | "Course" | "Other";
+interface DropMintStatus {
+    mintedByWallet: number;
+    totalMinted: number;
+}
+interface ApiRewardsBadge {
+    key: string;
+    name: string;
+    description: string;
+    icon: string;
+    color: string;
+    category: string;
+}
+interface ApiRewardsLevel {
+    level: number;
+    name: string;
+    xpRequired: number;
+    badgeColor: string;
+    description: string | null;
+}
+interface ApiUserRewards {
+    address: string;
+    accountId: string | null;
+    publicId: string | null;
+    totalXp: number;
+    currentLevel: number;
+    currentLevelName: string;
+    badgeColor: string;
+    nextLevel: {
+        level: number;
+        name: string;
+        xpRequired: number;
+    } | null;
+    progressPct: number;
+    breakdown: Record<string, number>;
+    badges: ApiRewardsBadge[];
+    computedAt: string | null;
+}
+interface ApiRewardsLeaderboardEntry {
+    rank: number;
+    address: string;
+    accountId: string | null;
+    publicId: string | null;
+    totalXp: number;
+    currentLevel: number;
+    currentLevelName: string;
+    badgeColor: string;
+}
+interface ApiRewardsConfig {
+    levels: ApiRewardsLevel[];
+    actions: {
+        type: string;
+        label: string;
+        xp: number;
+        dailyCap: number | null;
+    }[];
+    badges: ApiRewardsBadge[];
+}
+interface ApiRewardsBatchEntry {
+    address: string;
+    totalXp: number;
+    currentLevel: number;
+    currentLevelName: string;
+    badgeColor: string;
+}
+interface ApiPointEvent {
+    id: string;
+    actionType: string;
+    xp: number;
+    multiplier: number;
+    finalXp: number;
+    txHash: string | null;
+    createdAt: string;
+}
+
+type MedialaneErrorCode = "TOKEN_NOT_FOUND" | "COLLECTION_NOT_FOUND" | "ORDER_NOT_FOUND" | "INTENT_NOT_FOUND" | "INTENT_EXPIRED" | "RATE_LIMITED" | "NETWORK_NOT_SUPPORTED" | "APPROVAL_FAILED" | "TRANSACTION_FAILED" | "INVALID_PARAMS" | "UNAUTHORIZED" | "UNKNOWN";
+
+declare class MedialaneApiError extends Error {
+    readonly status: number;
+    readonly code: MedialaneErrorCode;
+    constructor(status: number, message: string);
+}
+declare class ApiClient {
+    private readonly baseUrl;
+    private readonly chain;
+    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 Clerk-JWT-authenticated routes. */
+    private bearer;
+    getOrders(query?: ApiOrdersQuery): Promise<ApiResponse<ApiOrder[]>>;
+    getOrder(orderHash: string): Promise<ApiResponse<ApiOrder>>;
+    getActiveOrdersForToken(contract: string, tokenId: string): Promise<ApiResponse<ApiOrder[]>>;
+    getOrdersByUser(address: string, page?: number, limit?: number): Promise<ApiResponse<ApiOrder[]>>;
+    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[]>>;
+    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[]>>;
+    getActivities(query?: ApiActivitiesQuery): Promise<ApiResponse<ApiActivity[]>>;
+    getActivitiesByAddress(address: string, page?: number, limit?: number): Promise<ApiResponse<ApiActivity[]>>;
+    getTokenComments(contract: string, tokenId: string, opts?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<ApiComment[]>>;
+    search(q: string, limit?: number, chain?: ChainFilter): Promise<ApiResponse<ApiSearchResult> & {
+        query: string;
+    }>;
+    createListingIntent(params: CreateListingIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
+    createOfferIntent(params: MakeOfferIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
+    createFulfillIntent(params: FulfillOrderIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
+    createCancelIntent(params: CancelOrderIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
+    getIntent(id: string): Promise<ApiResponse<ApiIntent>>;
+    submitIntentSignature(id: string, signature: string[]): Promise<ApiResponse<ApiIntent>>;
+    confirmIntent(id: string, txHash: string): Promise<ApiResponse<ApiIntent>>;
+    createMintIntent(params: CreateMintIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
+    createCollectionIntent(params: CreateCollectionIntentParams): Promise<ApiResponse<ApiIntentCreated>>;
+    /**
+     * Create a counter-offer intent. The seller proposes a new price in response
+     * to a buyer's active bid. clerkToken is optional — the endpoint authenticates
+     * via the tenant API key; pass a Clerk JWT only if your backend requires it.
+     */
+    createCounterOfferIntent(params: CreateCounterOfferIntentParams, clerkToken?: 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>>;
+    resolveMetadata(uri: string): Promise<ApiResponse<unknown>>;
+    uploadFile(file: File): Promise<ApiResponse<ApiMetadataUpload>>;
+    getMe(): Promise<ApiResponse<ApiPortalMe>>;
+    getApiKeys(): Promise<ApiResponse<ApiPortalKey[]>>;
+    createApiKey(label?: string): Promise<ApiResponse<ApiPortalKeyCreated>>;
+    deleteApiKey(id: string): Promise<ApiResponse<{
+        id: string;
+        status: string;
+    }>>;
+    getUsage(): Promise<ApiResponse<ApiUsageDay[]>>;
+    getWebhooks(): Promise<ApiResponse<ApiWebhookEndpoint[]>>;
+    createWebhook(params: CreateWebhookParams): Promise<ApiResponse<ApiWebhookCreated>>;
+    deleteWebhook(id: string): Promise<ApiResponse<{
+        id: string;
+        status: string;
+    }>>;
+    /**
+     * Path 1: On-chain auto claim. Sends both x-api-key (tenant auth) and
+     * Authorization: Bearer (Clerk JWT) simultaneously.
+     */
+    claimCollection(contractAddress: string, walletAddress: string, clerkToken: string): Promise<{
+        verified: boolean;
+        collection?: ApiCollection;
+        reason?: string;
+    }>;
+    /**
+     * Path 3: Manual off-chain claim request (email-based).
+     */
+    requestCollectionClaim(params: {
+        contractAddress: string;
+        walletAddress?: string;
+        email: string;
+        notes?: string;
+    }): Promise<{
+        claim: ApiCollectionClaim;
+    }>;
+    getCollectionProfile(contractAddress: string): Promise<ApiCollectionProfile | null>;
+    /**
+     * Update collection profile. Requires Clerk JWT for ownership check.
+     */
+    updateCollectionProfile(contractAddress: string, data: Partial<Omit<ApiCollectionProfile, "contractAddress" | "chain" | "updatedBy" | "updatedAt">>, clerkToken: string): Promise<ApiCollectionProfile>;
+    getGatedContent(contractAddress: string, clerkToken: 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 Clerk JWT; wallet must match authenticated user.
+     */
+    updateCreatorProfile(walletAddress: string, data: Partial<Omit<ApiCreatorProfile, "walletAddress" | "chain" | "updatedAt">>, clerkToken: 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 Clerk JWT — caller must be the collection owner. */
+    submitCollectionSlugClaim(contractAddress: string, slug: string, clerkToken: string, notifyEmail?: string): Promise<{
+        claim: ApiCollectionSlugClaim;
+    }>;
+    /** Returns all slug claims submitted by the authenticated wallet. Requires Clerk JWT. */
+    getMyCollectionSlugClaims(clerkToken: string): Promise<{
+        claims: ApiCollectionSlugClaim[];
+    }>;
+    /** Resolve a collection slug to a full collection. Returns null if not found. */
+    getCollectionBySlug(slug: string): Promise<ApiCollection | null>;
+    /**
+     * Upsert the authenticated user's wallet address in the backend DB.
+     * Call after onboarding when ChipiPay confirms the wallet address.
+     * Requires Clerk JWT; no tenant API key needed.
+     */
+    /**
+     * Frictionless wallet registration. Tenant API key only (no Clerk JWT 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;
+        appSource?: ApiAppSource;
+        chain?: ApiChain;
+    }): Promise<{
+        accountId: string;
+        publicId: string;
+        walletAddress: string;
+        chain: string;
+        provider: string;
+        appSource: ApiAppSource;
+        createdAt: string;
+    }>;
+    upsertMyWallet(clerkToken: string, options?: {
+        walletType?: string;
+        appSource?: ApiAppSource;
+        chain?: ApiChain;
+    }): Promise<ApiUserWallet>;
+    /**
+     * Get the authenticated user's stored wallet address from the backend DB.
+     * Returns null if the user has not completed onboarding yet.
+     * Requires Clerk JWT; no tenant API key needed.
+     */
+    getMyWallet(clerkToken: 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 Clerk JWT.
+     */
+    submitRemixOffer(params: CreateRemixOfferParams, clerkToken: string): Promise<ApiResponse<ApiRemixOffer>>;
+    /**
+     * Submit an auto remix offer for a token with an open license. Requires Clerk JWT.
+     */
+    submitAutoRemixOffer(params: AutoRemixOfferParams, clerkToken: string): Promise<ApiResponse<ApiRemixOffer>>;
+    /**
+     * Record a self-remix (owner remixing their own token). Requires Clerk JWT.
+     */
+    confirmSelfRemix(params: ConfirmSelfRemixParams, clerkToken: string): Promise<ApiResponse<ApiRemixOffer>>;
+    /**
+     * List remix offers by role. Requires Clerk JWT.
+     * role="creator" — offers where you are the original creator.
+     * role="requester" — offers you made.
+     */
+    getRemixOffers(query: ApiRemixOffersQuery, clerkToken: string): Promise<ApiResponse<ApiRemixOffer[]>>;
+    /**
+     * Get a single remix offer. Clerk JWT optional (price/currency hidden for non-participants).
+     */
+    getRemixOffer(id: string, clerkToken?: string): Promise<ApiResponse<ApiRemixOffer>>;
+    /**
+     * Creator approves a remix offer (authorises the requester to mint). Requires Clerk JWT.
+     */
+    confirmRemixOffer(id: string, params: ConfirmRemixOfferParams, clerkToken: string): Promise<ApiResponse<ApiRemixOffer>>;
+    /**
+     * Creator rejects a remix offer. Requires Clerk JWT.
+     */
+    rejectRemixOffer(id: string, clerkToken: string): Promise<ApiResponse<ApiRemixOffer>>;
+    /**
+     * Requester extends the expiry of a pending remix offer by 1–30 days.
+     * Requires Clerk JWT.
+     */
+    extendRemixOffer(id: string, days: number, clerkToken: string): Promise<ApiResponse<ApiRemixOffer>>;
+    getPopCollections(opts?: {
+        page?: number;
+        limit?: number;
+        sort?: CollectionSort;
+    }): Promise<ApiResponse<ApiCollection[]>>;
+    getPopEligibility(collection: string, wallet: string): Promise<PopClaimStatus>;
+    getPopEligibilityBatch(collection: string, wallets: string[]): Promise<PopBatchEligibilityItem[]>;
+    getCoins(opts?: ApiCoinsQuery): Promise<ApiResponse<ApiCoin[]>>;
+    getCoin(contract: string): Promise<{
+        data: ApiCoin;
+    }>;
+    getDropCollections(opts?: {
+        page?: number;
+        limit?: number;
+        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[]>;
+}
+
+interface OfferItem {
+    item_type: string;
+    token: string;
+    identifier_or_criteria: string;
+    amount: string;
+}
+interface ConsiderationItem extends OfferItem {
+    recipient: string;
+}
+interface OrderParameters {
+    offerer: string;
+    marketplace: string;
+    offer: OfferItem;
+    consideration: ConsiderationItem;
+    royalty_max_bps: string;
+    start_time: string;
+    end_time: string;
+    salt: string;
+    counter: string;
+}
+interface Order {
+    parameters: OrderParameters;
+    signature: string[];
+}
+interface TxResult {
+    txHash: string;
+}
+interface OrderDetails {
+    offerer: string;
+    offer: OfferItem;
+    consideration: ConsiderationItem;
+    royalty_max_bps: string;
+    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;
+}
+
+interface CreatePopCollectionParams {
+    name: string;
+    symbol: string;
+    baseUri: string;
+    claimEndTime: number;
+    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 {
+    name: string;
+    symbol: string;
+    baseUri: string;
+    maxSupply: bigint | string;
+    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 {
+    collection: string;
+    tokenId: bigint | string;
+    to: string;
+    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 {
+    collection: string;
+    tokenId: bigint | string;
+    to: string;
+    amount: bigint | string;
+}
+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;
+}
+
+export { type ApiTokenBalance as $, type ActivityType as A, type ApiOrderConsideration as B, type ApiOrderOffer as C, type ApiOrderPrice as D, type ApiOrderTokenMeta as E, type ApiOrderTxHash as F, type ApiOrdersQuery as G, type ApiPointEvent as H, type ApiPortalKey as I, type ApiPortalKeyCreated as J, type ApiPortalMe as K, type ApiPublicRemix as L, type ApiRemixOffer as M, type ApiRemixOfferPrice as N, type ApiRemixOffersQuery as O, type ApiResponse as P, type ApiRewardsBadge as Q, type ApiRewardsBatchEntry as R, type ServiceDefinition as S, type ApiRewardsConfig as T, type ApiRewardsLeaderboardEntry as U, type ApiRewardsLevel as V, type ApiSearchCollectionResult as W, type ApiSearchCreatorResult as X, type ApiSearchResult as Y, type ApiSearchTokenResult as Z, type ApiToken as _, type ServiceCapability as a, type WebhookStatus as a$, type ApiTokenMetadata as a0, type ApiUsageDay as a1, type ApiUserRewards as a2, type ApiUserWallet as a3, type ApiWebhookCreated as a4, type ApiWebhookEndpoint as a5, type AutoRemixOfferParams as a6, type CancelOrderIntentParams as a7, type ChainFilter as a8, type ClaimConditions as a9, type IpNftMetadata as aA, type MakeOfferIntentParams as aB, MedialaneApiError as aC, type MedialaneConfig as aD, type MedialaneErrorCode as aE, type MintMembershipsParams as aF, type MintTicketsParams as aG, OPEN_LICENSES as aH, type OfferItem as aI, type OpenLicense as aJ, type Order as aK, type OrderDetails as aL, type OrderParameters as aM, type OrderStatus as aN, type PopBatchEligibilityItem as aO, type PopClaimStatus as aP, type PopEventType as aQ, type ProposeSponsorshipParams as aR, type RemixOfferStatus as aS, type ResolvedConfig as aT, type ResolvedFeeConfig as aU, type RetryOptions as aV, type ServiceEventDeclaration as aW, type SortOrder as aX, type TenantPlan as aY, type TxResult as aZ, type WebhookEventType as a_, type CollectionSort as aa, type CollectionTokensSort as ab, type ConfirmRemixOfferParams as ac, type ConfirmSelfRemixParams as ad, type ConsiderationItem as ae, type CreateCollectionIntentParams as af, type CreateCounterOfferIntentParams as ag, type CreateDropParams as ah, type CreateListingIntentParams as ai, type CreateMembershipParams as aj, type CreateMintIntentParams as ak, type CreatePopCollectionParams as al, type CreateRemixOfferParams as am, type CreateSponsorshipOfferParams as an, type CreateTicketParams as ao, type CreateWebhookParams as ap, type DropMintStatus as aq, type EnforcementDeclaration as ar, type FeeConfig as as, FeeConfigSchema as at, type FulfillOrderIntentParams as au, type IPType as av, type IntentCall as aw, type IntentStatus as ax, type IntentType as ay, type IpAttribute as az, type ApiActivitiesQuery as b, resolveConfig as b0, resolveFeeConfig as b1, type ApiActivity as c, type ApiActivityPrice as d, type ApiAdminCollectionClaim as e, type ApiAppSource as f, type ApiChain as g, ApiClient as h, type ApiCoin as i, type ApiCoinsQuery as j, type ApiCollection as k, type ApiCollectionClaim as l, type ApiCollectionProfile as m, type ApiCollectionSlugClaim as n, type ApiCollectionsQuery as o, type ApiComment as p, type ApiCounterOffersQuery as q, type ApiCreatorListResult as r, type ApiCreatorProfile as s, type ApiIntent as t, type ApiIntentCreated as u, type ApiKeyStatus as v, type ApiMeta as w, type ApiMetadataSignedUrl as x, type ApiMetadataUpload as y, type ApiOrder as z };