@medialane/sdk 0.85.4 → 0.85.6

package/dist/index.cjs

@@ -44,11 +44,6 @@ var COORDINATES = {
     ipClubFactoryClassHash: "0x05d9d431bd3532b1fa4d5bab572f49c5ad8034ee3cc83951aa41ae82c9cad266",
     ipClubCollectionClassHash: "0x05b8477c72e6bf0cf64967d71155021fd4d77d9a57e8805c6b40709121c002c5",
     ipClubFactoryStartBlock: 11928775,
-    // v3 redesign (deployed 2026-07-15): single contract is both the
-    // offer/bid/proposal registry and the license collection (embeds
-    // ERC721Component directly) — no separate receipt contract, no
-    // set_minter bootstrap. Supersedes the 2026-07-02 v2 address, which had
-    // zero offers/licenses ever issued (clean cutover, no reclassification).
     ipSponsorship: "0x03729ebe0fedf29ec97fca34db09174772af7f870af26a26e024a61040143e5c",
     ipSponsorshipClassHash: "0x0626daac2ed7e2bf630ef5b10104b3202db1559216c0c1a504c0e99be2fbfec3",
     ipSponsorshipStartBlock: 11896456,
@@ -87,13 +82,10 @@ function resolveFeeConfig(raw) {
 
 // src/config.ts
 var MedialaneConfigSchema = zod.z.object({
-  // Chain-scoped client (spec 2026-06-13 Decision B): one client per chain,
-  // coordinates resolved from the registry. Replaces the removed `network` axis.
   chain: zod.z.enum(CHAINS).default(DEFAULT_CHAIN),
   rpcUrl: zod.z.string().url().optional(),
   backendUrl: zod.z.string().url().optional(),
   apiKey: zod.z.string().optional(),
-  // Per-contract overrides remain for tests/forks; default from the registry.
   marketplace721Contract: zod.z.string().optional(),
   marketplaceContract: zod.z.string().optional(),
   marketplace1155Contract: zod.z.string().optional(),
@@ -283,17 +275,9 @@ var ApiClient = class {
     this.baseHeaders = apiKey ? { "x-api-key": apiKey } : {};
     this.retryOptions = retryOptions;
   }
-  /** Normalize an address for this client's chain (chain-scoped — Decision B). */
   addr(a) {
     return normalizeAddress(this.chain, a);
   }
-  /**
-   * 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.
-   */
   async request(path, init, opts) {
     const url = `${this.baseUrl.replace(/\/$/, "")}${path}`;
     const headers = { ...this.baseHeaders };
@@ -333,11 +317,9 @@ var ApiClient = class {
   del(path) {
     return this.request(path, { method: "DELETE" });
   }
-  /** Bearer header for SIWS-token-authenticated routes. */
   bearer(siwsToken) {
     return { Authorization: `Bearer ${siwsToken}` };
   }
-  // ─── Orders ────────────────────────────────────────────────────────────────
   getOrders(query = {}) {
     const params = new URLSearchParams();
     if (query.status) params.set("status", query.status);
@@ -364,7 +346,6 @@ var ApiClient = class {
       `/v1/orders/user/${this.addr(address)}?page=${page}&limit=${limit}`
     );
   }
-  // ─── Tokens ────────────────────────────────────────────────────────────────
   getToken(contract, tokenId, wait = false) {
     return this.get(
       `/v1/tokens/${contract}/${tokenId}${wait ? "?wait=true" : ""}`
@@ -380,13 +361,13 @@ var ApiClient = class {
       `/v1/tokens/${contract}/${tokenId}/history?page=${page}&limit=${limit}`
     );
   }
-  // ─── Collections ───────────────────────────────────────────────────────────
-  getCollections(page = 1, limit = 20, isKnown, sort, service, chain) {
+  getCollections(page = 1, limit = 20, isKnown, sort, service, chain, standard) {
     const params = new URLSearchParams({ page: String(page), limit: String(limit) });
     if (isKnown !== void 0) params.set("isKnown", String(isKnown));
     if (sort) params.set("sort", sort);
     if (service) params.set("service", service);
     if (chain) params.set("chain", chain);
+    if (standard) params.set("standard", standard);
     return this.get(`/v1/collections?${params}`);
   }
   getCollectionsByOwner(owner, page = 1, limit = 50) {
@@ -401,7 +382,6 @@ var ApiClient = class {
       `/v1/collections/${this.addr(contract)}/tokens?page=${page}&limit=${limit}&sort=${sort}`
     );
   }
-  // ─── Activities ────────────────────────────────────────────────────────────
   getActivities(query = {}) {
     const params = new URLSearchParams();
     if (query.type) params.set("type", query.type);
@@ -417,7 +397,6 @@ var ApiClient = class {
       `/v1/activities/${this.addr(address)}?page=${page}&limit=${limit}`
     );
   }
-  // ─── Comments ──────────────────────────────────────────────────────────────
   getTokenComments(contract, tokenId, opts = {}) {
     const params = new URLSearchParams();
     if (opts.page !== void 0) params.set("page", String(opts.page));
@@ -427,7 +406,6 @@ var ApiClient = class {
       `/v1/tokens/${this.addr(contract)}/${tokenId}/comments${qs ? `?${qs}` : ""}`
     );
   }
-  // ─── Search ────────────────────────────────────────────────────────────────
   search(q, limit = 10, chain) {
     const params = new URLSearchParams({ q, limit: String(limit) });
     if (chain) params.set("chain", chain);
@@ -435,7 +413,6 @@ var ApiClient = class {
       `/v1/search?${params.toString()}`
     );
   }
-  // ─── Intents ───────────────────────────────────────────────────────────────
   createListingIntent(params) {
     return this.post("/v1/intents/listing", params);
   }
@@ -502,11 +479,6 @@ var ApiClient = class {
   rejectSponsorshipProposalIntent(params) {
     return this.post("/v1/intents/sponsorship-proposal-reject", params);
   }
-  /**
-   * 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, siwsToken) {
     const extraHeaders = siwsToken ? { "Authorization": `Bearer ${siwsToken}` } : {};
     return this.request("/v1/intents/counter-offer", {
@@ -515,10 +487,6 @@ var ApiClient = class {
       headers: extraHeaders
     });
   }
-  /**
-   * Fetch counter-offers. Pass `originalOrderHash` (buyer view) or
-   * `sellerAddress` (seller view) — at least one is required.
-   */
   getCounterOffers(query) {
     const params = new URLSearchParams();
     if (query.originalOrderHash) params.set("originalOrderHash", query.originalOrderHash);
@@ -527,7 +495,6 @@ var ApiClient = class {
     if (query.limit !== void 0) params.set("limit", String(query.limit));
     return this.get(`/v1/orders/counter-offers?${params}`);
   }
-  // ─── Metadata ──────────────────────────────────────────────────────────────
   getMetadataSignedUrl() {
     return this.get("/v1/metadata/signed-url");
   }
@@ -546,7 +513,6 @@ var ApiClient = class {
       body: formData
     });
   }
-  // ─── Portal (tenant self-service) ──────────────────────────────────────────
   getMe() {
     return this.get("/v1/portal/me");
   }
@@ -573,11 +539,6 @@ var ApiClient = class {
       `/v1/portal/webhooks/${id}`
     );
   }
-  // ─── Collection Claims ──────────────────────────────────────────────────────
-  /**
-   * Path 1: On-chain auto claim. Sends both x-api-key (tenant auth) and
-   * Authorization: Bearer (SIWS token) simultaneously.
-   */
   async claimCollection(contractAddress, walletAddress, siwsToken) {
     return this.request("/v1/collections/claim", {
       method: "POST",
@@ -585,23 +546,18 @@ var ApiClient = class {
       headers: this.bearer(siwsToken)
     });
   }
-  /**
-   * Path 3: Manual off-chain claim request (email-based).
-   */
   requestCollectionClaim(params) {
     return this.request("/v1/collections/claim/request", {
       method: "POST",
       body: JSON.stringify(params)
     });
   }
-  // ─── Business Provisioning ──────────────────────────────────────────────────
   registerBusinessProvisioning(params) {
     return this.post("/v1/business/provisioning", params);
   }
   completeBusinessProvisioning(id) {
     return this.post(`/v1/business/provisioning/${id}/complete`, {});
   }
-  // ─── Collection Profiles ────────────────────────────────────────────────────
   getCollectionProfile(contractAddress) {
     return this.request(
       `/v1/collections/${this.addr(contractAddress)}/profile`,
@@ -609,16 +565,12 @@ var ApiClient = class {
       { allow404: true }
     );
   }
-  /**
-   * Update collection profile. Requires SIWS token for ownership check.
-   */
   updateCollectionProfile(contractAddress, data, siwsToken) {
     return this.request(
       `/v1/collections/${this.addr(contractAddress)}/profile`,
       { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(siwsToken) }
     );
   }
-  /** No signature required — wallet activity is public on-chain data, read like any other /v1 GET. */
   getWalletActivity(address, chain = "STARKNET") {
     return this.get(
       `/v1/wallet-activity?address=${this.addr(address)}&chain=${chain}`
@@ -631,8 +583,6 @@ var ApiClient = class {
       { allow404: true, allow403: true }
     );
   }
-  // ─── Creator Profiles ───────────────────────────────────────────────────────
-  /** List all creators with an approved username. */
   getCreators(opts = {}) {
     const params = new URLSearchParams();
     if (opts.search) params.set("search", opts.search);
@@ -648,7 +598,6 @@ var ApiClient = class {
       { allow404: true }
     );
   }
-  /** Resolve a username slug to a creator profile (public). */
   getCreatorByUsername(username) {
     return this.request(
       `/v1/creators/by-username/${encodeURIComponent(username.toLowerCase().trim())}`,
@@ -656,23 +605,17 @@ var ApiClient = class {
       { allow404: true }
     );
   }
-  /**
-   * Update creator profile. Requires SIWS token; wallet must match authenticated user.
-   */
   updateCreatorProfile(walletAddress, data, siwsToken) {
     return this.request(
       `/v1/creators/${this.addr(walletAddress)}/profile`,
       { method: "PATCH", body: JSON.stringify(data), headers: this.bearer(siwsToken) }
     );
   }
-  // ─── Collection Slug Claims ───────────────────────────────────────────────────
-  /** Check if a collection slug is available (public, no auth). */
   checkCollectionSlugAvailability(slug) {
     return this.get(
       `/v1/collection-slug-claims/check/${encodeURIComponent(slug.toLowerCase().trim())}`
     );
   }
-  /** Submit a slug claim for a collection. Requires SIWS token — caller must be the collection owner. */
   submitCollectionSlugClaim(contractAddress, slug, siwsToken, notifyEmail) {
     return this.request("/v1/collection-slug-claims", {
       method: "POST",
@@ -680,14 +623,12 @@ var ApiClient = class {
       headers: this.bearer(siwsToken)
     });
   }
-  /** Returns all slug claims submitted by the authenticated wallet. Requires SIWS token. */
   getMyCollectionSlugClaims(siwsToken) {
     return this.request("/v1/collection-slug-claims/me", {
       method: "GET",
       headers: this.bearer(siwsToken)
     });
   }
-  /** Resolve a collection slug to a full collection. Returns null if not found. */
   getCollectionBySlug(slug) {
     return this.request(
       `/v1/collections/by-slug/${encodeURIComponent(slug.toLowerCase().trim())}`,
@@ -695,12 +636,6 @@ var ApiClient = class {
       { allow404: true }
     );
   }
-  // ─── User Wallet ─────────────────────────────────────────────────────────────
-  /**
-   * 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.
-   */
   async registerUser(params) {
     return this.post("/v1/users/register", params);
   }
@@ -719,18 +654,12 @@ var ApiClient = class {
       headers: this.bearer(siwsToken)
     });
   }
-  /** 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. */
   async checkEmailExists(email) {
     const { exists } = await this.get(
       `/v1/auth/email/exists?email=${encodeURIComponent(email)}`
     );
     return exists;
   }
-  /**
-   * 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) {
     return this.request(
       "/v1/users/me",
@@ -738,10 +667,6 @@ var ApiClient = class {
       { allow404: true }
     );
   }
-  // ─── Remix Licensing ─────────────────────────────────────────────────────────
-  /**
-   * Get public remixes of a token (open to everyone).
-   */
   getTokenRemixes(contract, tokenId, opts = {}) {
     const params = new URLSearchParams();
     if (opts.page !== void 0) params.set("page", String(opts.page));
@@ -751,9 +676,6 @@ var ApiClient = class {
       `/v1/tokens/${this.addr(contract)}/${tokenId}/remixes${qs ? `?${qs}` : ""}`
     );
   }
-  /**
-   * Submit a custom remix offer for a token. Requires SIWS token.
-   */
   submitRemixOffer(params, siwsToken) {
     return this.request("/v1/remix-offers", {
       method: "POST",
@@ -761,9 +683,6 @@ var ApiClient = class {
       headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
-  /**
-   * Submit an auto remix offer for a token with an open license. Requires SIWS token.
-   */
   submitAutoRemixOffer(params, siwsToken) {
     return this.request("/v1/remix-offers/auto", {
       method: "POST",
@@ -771,9 +690,6 @@ var ApiClient = class {
       headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
-  /**
-   * Record a self-remix (owner remixing their own token). Requires SIWS token.
-   */
   confirmSelfRemix(params, siwsToken) {
     return this.request("/v1/remix-offers/self/confirm", {
       method: "POST",
@@ -781,11 +697,6 @@ var ApiClient = class {
       headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
-  /**
-   * List remix offers by role. Requires SIWS token.
-   * role="creator" — offers where you are the original creator.
-   * role="requester" — offers you made.
-   */
   getRemixOffers(query, siwsToken) {
     const params = new URLSearchParams({ role: query.role });
     if (query.page !== void 0) params.set("page", String(query.page));
@@ -795,18 +706,12 @@ var ApiClient = class {
       headers: this.bearer(siwsToken)
     });
   }
-  /**
-   * Get a single remix offer. SIWS token optional (price/currency hidden for non-participants).
-   */
   getRemixOffer(id, siwsToken) {
     return this.request(`/v1/remix-offers/${id}`, {
       method: "GET",
       headers: siwsToken ? this.bearer(siwsToken) : void 0
     });
   }
-  /**
-   * Creator approves a remix offer (authorises the requester to mint). Requires SIWS token.
-   */
   confirmRemixOffer(id, params, siwsToken) {
     return this.request(`/v1/remix-offers/${id}/confirm`, {
       method: "POST",
@@ -814,9 +719,6 @@ var ApiClient = class {
       headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
-  /**
-   * Creator rejects a remix offer. Requires SIWS token.
-   */
   rejectRemixOffer(id, siwsToken) {
     return this.request(`/v1/remix-offers/${id}/reject`, {
       method: "POST",
@@ -824,10 +726,6 @@ var ApiClient = class {
       headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
-  /**
-   * Requester extends the expiry of a pending remix offer by 1–30 days.
-   * Requires SIWS token.
-   */
   extendRemixOffer(id, days, siwsToken) {
     return this.request(`/v1/remix-offers/${id}/extend`, {
       method: "POST",
@@ -835,7 +733,6 @@ var ApiClient = class {
       headers: { "Authorization": `Bearer ${siwsToken}` }
     });
   }
-  // ─── POP Protocol ──────────────────────────────────────────────────────────
   getPopCollections(opts = {}) {
     return this.getCollections(opts.page ?? 1, opts.limit ?? 20, void 0, opts.sort, "POP_PROTOCOL");
   }
@@ -852,9 +749,6 @@ var ApiClient = class {
     );
     return res.data;
   }
-  // ─── Coins (fungible — ERC-20 etc.) ───────────────────────────────────────────
-  // Coins are a separate model from Collections (spec 2026-06-14). Price/liquidity
-  // is read live from Ekubo (CreatorCoinService.getPrice), never from these.
   getCoins(opts = {}) {
     const params = new URLSearchParams();
     if (opts.page) params.set("page", String(opts.page));
@@ -867,11 +761,6 @@ var ApiClient = class {
   getCoin(contract) {
     return this.get(`/v1/coins/${this.addr(contract)}`);
   }
-  /**
-   * 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, data, siwsToken) {
     return this.request(`/v1/coins/${this.addr(contract)}`, {
       method: "PATCH",
@@ -879,7 +768,6 @@ var ApiClient = class {
       headers: this.bearer(siwsToken)
     });
   }
-  // ─── Collection Drop ────────────────────────────────────────────────────────
   getDropCollections(opts = {}) {
     return this.getCollections(opts.page ?? 1, opts.limit ?? 20, void 0, opts.sort, "COLLECTION_DROP");
   }
@@ -889,29 +777,22 @@ var ApiClient = class {
     );
     return res.data;
   }
-  // ─── Rewards (v0.49.0) ─────────────────────────────────────────────────────
-  // Scores are recomputed on a schedule by the backend (~15 min) — reads only.
-  /** Score + level + progress + badges for one address (zeroed for unknown). */
   async getRewards(address) {
     const res = await this.get(`/v1/rewards/${this.addr(address)}`);
     return res.data;
   }
-  /** Paginated XP leaderboard. */
   getRewardsLeaderboard(page = 1, limit = 50) {
     return this.get(`/v1/rewards?page=${page}&limit=${limit}`);
   }
-  /** Point-event history for an address. */
   getRewardsEvents(address, page = 1, limit = 20) {
     return this.get(
       `/v1/rewards/${this.addr(address)}/events?page=${page}&limit=${limit}`
     );
   }
-  /** Reward configuration: level ladder, enabled action XP values, badge catalog. */
   async getRewardsConfig() {
     const res = await this.get(`/v1/rewards/config`);
     return res.data;
   }
-  /** Minimal level info for up to 50 addresses — one call per list page. */
   async getRewardsBatch(addresses) {
     if (addresses.length === 0) return [];
     const params = new URLSearchParams({ addresses: addresses.map((a) => this.addr(a)).join(",") });
@@ -959,7 +840,6 @@ var STARKNET_CREATOR_COIN_START_BLOCK = SN.creatorCoinStartBlock;
 var STARKNET_EKUBO_CORE = SN.ekuboCore;
 var SUPPORTED_TOKENS = [
   {
-    // Circle-native USDC on Starknet (canonical)
     symbol: "USDC",
     address: "0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb",
     decimals: 6,
@@ -1031,10 +911,6 @@ var SERVICES = {
     capabilities: ["list", "buy", "make_offer", "cancel", "transfer", "mint", "remix", "license"],
     events: [
       { name: "CollectionCreated", emittedBy: "factory" }
-      // Per-instance ERC-721 Transfer emitted by each deployed collection; not
-      // yet declared here because the indexer polls discovered instances on a
-      // slow schedule. Plan 2026-05-24-data-driven-event-registry.md covers
-      // the migration.
     ],
     metadataSchema: { licenseDefault: "CC BY-SA" }
   },
@@ -1046,8 +922,6 @@ var SERVICES = {
     provenance: "MEDIALANE",
     uiVariant: "standard",
     capabilities: ["list", "buy", "make_offer", "cancel", "transfer", "mint", "remix", "license"],
-    // No factory — single shared contract. Events declared when the genesis
-    // contract address is wired into onchain.STARKNET.factoryAddress here.
     metadataSchema: { licenseDefault: "CC BY-SA" }
   },
   "mip-erc1155": {
@@ -1164,14 +1038,6 @@ var SERVICES = {
       }
     },
     uiVariant: "standard",
-    // v3: one contract is both the offer/bid/proposal registry and the
-    // issued license collection (a real, standard ERC-721 minted internally
-    // — no separate receipt contract). `transfer` reflects that a license is
-    // freely transferable at the protocol layer; transferable/expiry intent
-    // is declarative (carried in metadata + LicenseMinted), never
-    // contract-enforced. Supersedes the 2026-07-02 v2 `ip-sponsorship`
-    // (registry-only) + `ip-sponsorship-license` (non-authoritative receipt
-    // via a dedicated ip-erc721 instance) pair — retired as of this redesign.
     capabilities: ["sponsor", "transfer"],
     events: [
       { name: "OfferCreated", emittedBy: "factory" },
@@ -1194,10 +1060,6 @@ var SERVICES = {
       }
     },
     uiVariant: "coin",
-    // `swap` is a UI affordance (05 §III): the marketplace renders an embedded
-    // Ekubo swap (via StarkZapp) for the coin. Settlement is Ekubo — Medialane
-    // operates NO trading venue and custodies nothing. No venue service exists
-    // for coins (unlike NFTs, whose Medialane marketplace contract settles them).
     capabilities: ["launch", "swap", "transfer"],
     events: [
       { name: "CreatorCoinCreated", emittedBy: "factory" },