@medialane/sdk 0.85.5 → 0.85.7

package/dist/starknet/index.cjs

@@ -47,11 +47,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,
@@ -90,13 +85,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(),
@@ -274,17 +266,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 };
@@ -324,11 +308,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);
@@ -355,7 +337,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" : ""}`
@@ -371,7 +352,6 @@ var ApiClient = class {
       `/v1/tokens/${contract}/${tokenId}/history?page=${page}&limit=${limit}`
     );
   }
-  // ─── Collections ───────────────────────────────────────────────────────────
   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));
@@ -393,7 +373,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);
@@ -409,7 +388,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));
@@ -419,7 +397,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);
@@ -427,7 +404,6 @@ var ApiClient = class {
       `/v1/search?${params.toString()}`
     );
   }
-  // ─── Intents ───────────────────────────────────────────────────────────────
   createListingIntent(params) {
     return this.post("/v1/intents/listing", params);
   }
@@ -494,11 +470,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", {
@@ -507,10 +478,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);
@@ -519,7 +486,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");
   }
@@ -538,7 +504,6 @@ var ApiClient = class {
       body: formData
     });
   }
-  // ─── Portal (tenant self-service) ──────────────────────────────────────────
   getMe() {
     return this.get("/v1/portal/me");
   }
@@ -565,11 +530,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",
@@ -577,23 +537,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`,
@@ -601,16 +556,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}`
@@ -623,8 +574,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);
@@ -640,7 +589,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())}`,
@@ -648,23 +596,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",
@@ -672,14 +614,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())}`,
@@ -687,12 +627,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);
   }
@@ -711,18 +645,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",
@@ -730,10 +658,13 @@ var ApiClient = class {
       { allow404: true }
     );
   }
-  // ─── Remix Licensing ─────────────────────────────────────────────────────────
-  /**
-   * Get public remixes of a token (open to everyone).
-   */
+  changeMyEmail(email, siwsToken) {
+    return this.request("/v1/users/me/email", {
+      method: "POST",
+      headers: this.bearer(siwsToken),
+      body: JSON.stringify({ email })
+    });
+  }
   getTokenRemixes(contract, tokenId, opts = {}) {
     const params = new URLSearchParams();
     if (opts.page !== void 0) params.set("page", String(opts.page));
@@ -743,9 +674,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",
@@ -753,9 +681,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",
@@ -763,9 +688,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",
@@ -773,11 +695,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));
@@ -787,18 +704,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",
@@ -806,9 +717,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",
@@ -816,10 +724,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",
@@ -827,7 +731,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");
   }
@@ -844,9 +747,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));
@@ -859,11 +759,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",
@@ -871,7 +766,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");
   }
@@ -881,29 +775,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(",") });
@@ -948,7 +835,6 @@ SN.creatorCoinStartBlock;
 SN.ekuboCore;
 var SUPPORTED_TOKENS = [
   {
-    // Circle-native USDC on Starknet (canonical)
     symbol: "USDC",
     address: "0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb",
     decimals: 6,
@@ -10297,24 +10183,12 @@ var ERC1155CollectionService = class {
       account
     );
   }
-  /**
-   * Deploy a new ERC-1155 IP collection.
-   * Caller becomes the collection owner and can mint items.
-   * Returns the transaction hash; the deployed collection address is emitted
-   * in the `CollectionDeployed` event of the factory.
-   */
   async deployCollection(account, params) {
     const factory = this._factory(account);
     const call = factory.populate("deploy_collection", [params.name, params.symbol, params.baseUri]);
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Mint a new edition into an existing ERC-1155 collection.
-   * Caller must be the collection owner. The token id is assigned on-chain
-   * (sequential from 1) — read it from the `IPMinted` event of the returned tx.
-   * The `tokenUri` is immutable.
-   */
   async mintEdition(account, params) {
     const collection = this._collection(params.collection, account);
     const call = collection.populate("mint_edition", [
@@ -10325,11 +10199,6 @@ var ERC1155CollectionService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Batch-mint multiple new editions into an existing ERC-1155 collection.
-   * All editions go to the same `to` address; ids are assigned sequentially
-   * on-chain. Caller must be the collection owner.
-   */
   async batchMintEdition(account, params) {
     const collection = this._collection(params.collection, account);
     const values = params.items.map((i) => BigInt(i.value));
@@ -10342,11 +10211,6 @@ var ERC1155CollectionService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Mint additional copies of an EXISTING edition into an ERC-1155 collection.
-   * Reverts on-chain if `tokenId` has never been minted. Provenance/URI unchanged.
-   * Caller must be the collection owner.
-   */
   async addSupply(account, params) {
     const collection = this._collection(params.collection, account);
     const call = collection.populate("add_supply", [
@@ -10357,11 +10221,6 @@ var ERC1155CollectionService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Set the default ERC-2981 royalty for the entire collection.
-   * `feeNumerator` is out of 10 000 (e.g. 500 = 5%).
-   * Caller must be the collection owner.
-   */
   async setDefaultRoyalty(account, params) {
     const collection = this._collection(params.collection, account);
     const call = collection.populate("set_default_royalty", [
@@ -10371,10 +10230,6 @@ var ERC1155CollectionService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Set a per-token ERC-2981 royalty override.
-   * `feeNumerator` is out of 10 000. Caller must be the collection owner.
-   */
   async setTokenRoyalty(account, params) {
     const collection = this._collection(params.collection, account);
     const call = collection.populate("set_token_royalty", [
@@ -10385,10 +10240,6 @@ var ERC1155CollectionService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Approve the Medialane1155 marketplace (or any operator) to transfer
-   * all tokens on behalf of `account`. Required before listing.
-   */
   async setApprovalForAll(account, params) {
     const collection = this._collection(params.collection, account);
     const call = collection.populate("set_approval_for_all", [
@@ -10583,27 +10434,18 @@ var CreatorCoinService = class {
   _factory(account) {
     return newContract(CreatorCoinFactoryABI, this.factoryAddress, account);
   }
-  /** Deploy a fixed-supply CreatorCoin (full supply minted to the Factory). */
   async createCreatorCoin(account, params) {
     const res = await account.execute([buildCreateCreatorCoinCall(params)]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Launch a coin on Ekubo (owner-only). Optionally pre-funds the Factory with
-   * quote (for the buyback) in the same multicall. Liquidity is permanently
-   * locked in the EkuboLauncher.
-   */
   async launchOnEkubo(account, params) {
     const res = await account.execute(buildLaunchOnEkuboCalls(params));
     return { txHash: res.transaction_hash };
   }
-  /** View: is this address a Factory-deployed Creator Coin? */
   async isCreatorCoin(address, account) {
     const r = await this._factory(account).is_creator_coin(address);
     return BigInt(r) === 1n;
   }
-  /** Read a coin's live Ekubo spot price (quote-per-coin) via the configured RPC.
-   *  Read-only; returns null if the coin isn't launched on Ekubo. */
   async getPrice(coinAddress) {
     return getCreatorCoinPrice(coinAddress, new starknet.RpcProvider({ nodeUrl: this.config.rpcUrl }));
   }
@@ -10625,11 +10467,6 @@ var TicketService = class {
     const provider = new starknet.RpcProvider({ nodeUrl: this.config.rpcUrl });
     return newContract(IPTicketCollectionABI, normalizeAddress("STARKNET", address), provider);
   }
-  /**
-   * Deploys a new IPTicketCollection via the factory. Caller becomes owner.
-   * `baseUri` is the collection-level metadata URI, embedded on-chain in the
-   * deploy transaction.
-   */
   async deployCollection(account, params) {
     const call = this._factory(account, params.factoryAddress).populate("deploy_collection", [
       params.name,
@@ -10639,7 +10476,6 @@ var TicketService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Owner-only. Creates a new ticket inside the caller's deployed collection. */
   async createTicket(account, params) {
     const startTime = params.startTime != null ? new starknet.CairoOption(starknet.CairoOptionVariant.Some, params.startTime) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
     const endTime = params.endTime != null ? new starknet.CairoOption(starknet.CairoOptionVariant.Some, params.endTime) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
@@ -10653,7 +10489,6 @@ var TicketService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Owner-only. Mints `amount` of `tokenId` to `to`. */
   async mint(account, params) {
     const call = this._collection(params.collection, account).populate("mint", [
       params.to,
@@ -10663,7 +10498,6 @@ var TicketService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Read — true if holder has balance > 0 and current time is within the ticket window. */
   async isValid(params) {
     const result = await this._collectionRead(params.collection).call("is_valid", [
       starknet.cairo.uint256(params.tokenId),
@@ -10671,12 +10505,10 @@ var TicketService = class {
     ]);
     return Boolean(result);
   }
-  /** Read — number of tickets created so far (ids are sequential from 1). */
   async getTicketCount(params) {
     const result = await this._collectionRead(params.collection).call("ticket_count", []);
     return BigInt(result);
   }
-  /** Read — returns the Ticket record for a token ID. */
   async getTicket(params) {
     const t = await this._collectionRead(params.collection).call("get_ticket", [
       starknet.cairo.uint256(params.tokenId)
@@ -10708,11 +10540,6 @@ var ClubService = class {
     const provider = new starknet.RpcProvider({ nodeUrl: this.config.rpcUrl });
     return newContract(IPClubCollectionABI, normalizeAddress("STARKNET", address), provider);
   }
-  /**
-   * Deploys a new IPClubCollection via the factory. Caller becomes owner.
-   * `baseUri` is the collection-level metadata URI, embedded on-chain in the
-   * deploy transaction.
-   */
   async deployCollection(account, params) {
     const call = this._factory(account, params.factoryAddress).populate("deploy_collection", [
       params.name,
@@ -10722,7 +10549,6 @@ var ClubService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Owner-only. Creates a new membership tier inside the caller's deployed collection. */
   async createMembership(account, params) {
     const startTime = params.startTime != null ? new starknet.CairoOption(starknet.CairoOptionVariant.Some, params.startTime) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
     const endTime = params.endTime != null ? new starknet.CairoOption(starknet.CairoOptionVariant.Some, params.endTime) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
@@ -10736,10 +10562,6 @@ var ClubService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Owner-only. Mints `amount` of `tokenId` to `to`. The validity window
-   * gates membership, never minting — future-window tiers mint fine.
-   */
   async mint(account, params) {
     const call = this._collection(params.collection, account).populate("mint", [
       params.to,
@@ -10749,14 +10571,12 @@ var ClubService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Read — true if holder holds any tier currently inside its validity window. */
   async isMember(params) {
     const result = await this._collectionRead(params.collection).call("is_member", [
       params.holder
     ]);
     return Boolean(result);
   }
-  /** Read — true if holder holds `tokenId` and the current time is inside its window. */
   async isMemberOf(params) {
     const result = await this._collectionRead(params.collection).call("is_member_of", [
       starknet.cairo.uint256(params.tokenId),
@@ -10764,7 +10584,6 @@ var ClubService = class {
     ]);
     return Boolean(result);
   }
-  /** Read — returns the Membership record for a token ID. */
   async getMembership(params) {
     const m = await this._collectionRead(params.collection).call("get_membership", [
       starknet.cairo.uint256(params.tokenId)
@@ -10799,8 +10618,6 @@ var SponsorshipService = class {
     const provider = new starknet.RpcProvider({ nodeUrl: this.config.rpcUrl });
     return newContract(IPSponsorshipABI, normalizeAddress("STARKNET", resolved), provider);
   }
-  // ── Offers (owner-initiated) ───────────────────────────────────────────────
-  /** The offer author must currently own (nftContract, tokenId) — enforced on-chain at create and accept. */
   async createOffer(account, params) {
     const specificSponsor = params.specificSponsor ? new starknet.CairoOption(starknet.CairoOptionVariant.Some, params.specificSponsor) : new starknet.CairoOption(starknet.CairoOptionVariant.None);
     const call = this._contract(account, params.sponsorshipAddress).populate("create_offer", [
@@ -10817,7 +10634,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Reversible — gates new bids/acceptance only. */
   async setOfferOpen(account, params) {
     const call = this._contract(account, params.sponsorshipAddress).populate("set_offer_open", [
       starknet.cairo.uint256(params.offerId),
@@ -10826,7 +10642,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** A bid is a signal plus an open ERC-20 allowance — no tokens move until accepted. Prepends the approve. */
   async placeBid(account, params) {
     const sponsorshipAddress = params.sponsorshipAddress ?? this.sponsorshipAddress;
     if (!sponsorshipAddress) {
@@ -10852,11 +10667,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Author-only. Re-verifies IP ownership, settles the sponsor's payment
-   * (allowance pull, no escrow), and mints the license — a real ERC-721 on
-   * this same contract — to the sponsor, all atomically in one call.
-   */
   async acceptBid(account, params) {
     const call = this._contract(account, params.sponsorshipAddress).populate("accept_bid", [
       starknet.cairo.uint256(params.offerId),
@@ -10865,12 +10675,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  // ── Proposals (sponsor-initiated) ──────────────────────────────────────────
-  // The symmetric counterpart to offers/bids: a sponsor proposes fixed terms
-  // on an asset with no open offer yet; only the asset's current owner may
-  // accept or reject. Unlike an offer, the SPONSOR chooses `paymentToken` here
-  // — an accepting owner's UI should surface only recognized tokens, since a
-  // bad-faith ERC-20 could return `true` on `transfer_from` without moving funds.
   async proposeSponsorship(account, params) {
     const call = this._contract(account, params.sponsorshipAddress).populate("propose_sponsorship", [
       params.nftContract,
@@ -10886,7 +10690,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Proposer-only. Advisory against an acceptance in flight in the same block. */
   async withdrawProposal(account, params) {
     const call = this._contract(account, params.sponsorshipAddress).populate("withdraw_proposal", [
       starknet.cairo.uint256(params.proposalId)
@@ -10894,12 +10697,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /**
-   * Asset-owner-only (re-verified on-chain — a proposal binds to the asset,
-   * not a person: whoever owns it at acceptance time is paid and issues the
-   * license). Settles payment and mints the license atomically, same as
-   * `acceptBid`.
-   */
   async acceptProposal(account, params) {
     const call = this._contract(account, params.sponsorshipAddress).populate("accept_proposal", [
       starknet.cairo.uint256(params.proposalId)
@@ -10907,7 +10704,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  /** Asset-owner-only. */
   async rejectProposal(account, params) {
     const call = this._contract(account, params.sponsorshipAddress).populate("reject_proposal", [
       starknet.cairo.uint256(params.proposalId)
@@ -10915,7 +10711,6 @@ var SponsorshipService = class {
     const res = await account.execute([call]);
     return { txHash: res.transaction_hash };
   }
-  // ── Reads ───────────────────────────────────────────────────────────────────
   async getOffer(params) {
     const o = await this._contractRead(params.sponsorshipAddress).call("get_offer", [
       starknet.cairo.uint256(params.offerId)
@@ -10971,7 +10766,6 @@ var SponsorshipService = class {
     const result = await this._contractRead(params?.sponsorshipAddress).call("get_last_license_id", []);
     return BigInt(result);
   }
-  /** EIP-2981 — royalty recipient (the license's issuing author) and amount owed on a resale at `salePrice`. */
   async royaltyInfo(params) {
     const [recipient, amount] = await this._contractRead(params.sponsorshipAddress).call("royalty_info", [
       starknet.cairo.uint256(params.licenseId),
@@ -11451,7 +11245,6 @@ var StarknetVenue = class {
     const orderRef = await this.orderRefFromReceipt(txHash);
     return { txHash, orderRef };
   }
-  // ─── reads (all on deps.provider) ─────────────────────────────────────────
   async readCounter(marketplace, address) {
     const res = await this.deps.provider.callContract({
       contractAddress: marketplace,
@@ -11460,7 +11253,6 @@ var StarknetVenue = class {
     });
     return BigInt(res[0] ?? "0");
   }
-  /** 721 listing approval: `get_approved(tokenId) == marketplace` ⇒ no approve. */
   async approval721ForListing(_owner, nftContract, tokenId) {
     const id = starknet.cairo.uint256(tokenId);
     const approve = {
@@ -11480,7 +11272,6 @@ var StarknetVenue = class {
     }
     return { approvalNeeded: !approved, approve };
   }
-  /** 1155 listing approval: `is_approved_for_all(owner, marketplace)`. */
   async approval1155ForListing(owner, nftContract) {
     const approve = {
       contractAddress: nftContract,
@@ -11499,7 +11290,6 @@ var StarknetVenue = class {
     }
     return { approvalNeeded: !approved, approve };
   }
-  /** Offers always approve the ERC-20 spend (no read). */
   approvalForErc20(token, amountWei, marketplace) {
     const u = starknet.cairo.uint256(amountWei);
     return {
@@ -11511,8 +11301,6 @@ var StarknetVenue = class {
       }
     };
   }
-  /** The canonical Starknet order id = the contract-emitted `OrderCreated`
-   *  hash (`keys[1]`), which is exactly what the indexer stores. */
   async orderRefFromReceipt(txHash) {
     const receipt = await this.deps.provider.getTransactionReceipt(txHash);
     const selector = starknet.hash.getSelectorFromName("OrderCreated");