@medialane/sdk 0.4.0 → 0.4.2

package/README.md

@@ -306,16 +306,16 @@ token.data.metadata.attributes;    // IpAttribute[] | null
 
 ## Supported Tokens
 
-| Symbol | Type | Address | Decimals |
-|---|---|---|---|
-| USDC | Circle-native (canonical) | `0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb` | 6 |
-| USDC.e | Bridged (Starkgate) | `0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8` | 6 |
-| USDT | Tether | `0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8` | 6 |
-| ETH | Ether | `0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7` | 18 |
-| STRK | Starknet native | `0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d` | 18 |
+| Symbol | Address | Decimals | Listable |
+|--------|---------|----------|----------|
+| USDC | `0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb` | 6 | ✓ |
+| USDT | `0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8` | 6 | ✓ |
+| ETH | `0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7` | 18 | ✓ |
+| STRK | `0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d` | 18 | ✓ |
+| WBTC | `0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac` | 8 | ✓ |
 
 ```typescript
-import { getTokenBySymbol, getTokenByAddress, SUPPORTED_TOKENS } from "@medialane/sdk";
+import { getTokenBySymbol, getTokenByAddress, getListableTokens, SUPPORTED_TOKENS } from "@medialane/sdk";
 
 const usdc = getTokenBySymbol("USDC");
 const token = getTokenByAddress("0x033068...");
@@ -327,12 +327,13 @@ const token = getTokenByAddress("0x033068...");
 
 ```typescript
 import {
-  normalizeAddress,   // Pad to 64-char 0x-prefixed lowercase hex
-  shortenAddress,     // → "0x1234...5678"
-  parseAmount,        // Human-readable → smallest unit BigInt ("1.5", 6) → 1500000n
-  formatAmount,       // Smallest unit → human-readable ("1500000", 6) → "1.5"
-  stringifyBigInts,   // Recursively convert BigInt → string (for JSON)
-  u256ToBigInt,       // u256 { low, high } → BigInt
+  normalizeAddress,    // Pad to 64-char 0x-prefixed lowercase hex
+  shortenAddress,      // → "0x1234...5678"
+  parseAmount,         // Human-readable → smallest unit BigInt ("1.5", 6) → 1500000n
+  formatAmount,        // Smallest unit → human-readable ("1500000", 6) → "1.5"
+  stringifyBigInts,    // Recursively convert BigInt → string (for JSON)
+  u256ToBigInt,        // u256 { low, high } → BigInt
+  getListableTokens,   // ReadonlyArray<SupportedToken> filtered to listable: true (for dialogs)
 } from "@medialane/sdk";
 ```
 
@@ -413,6 +414,28 @@ Built with:
 
 ## Changelog
 
+### v0.4.2
+- **WBTC** added to `SUPPORTED_TOKENS` (`0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac`, 8 decimals)
+- **`listable` field** on every `SUPPORTED_TOKENS` entry — controls whether a token appears in listing/offer dialogs vs filter-only
+- **`getListableTokens()`** — returns tokens filtered to `listable: true`; exported from package root
+- **ETH** promoted to `listable: true` — now available in listing and offer dialogs
+- **USDC.e removed** — bridged USDC (`0x053c91...`) removed entirely; only Circle-native USDC remains, to avoid user confusion
+
+### v0.4.1
+- **Collection claims** — `claimCollection(contractAddress, walletAddress, clerkToken)` for on-chain ownership verification; `requestCollectionClaim({ contractAddress, walletAddress?, email, notes? })` for manual review
+- **Collection profiles** — `getCollectionProfile(contractAddress)` and `updateCollectionProfile(contractAddress, data, clerkToken)` for enriched display metadata (displayName, description, image, bannerImage, social links)
+- **Creator profiles** — `getCreatorProfile(walletAddress)` and `updateCreatorProfile(walletAddress, data, clerkToken)` for creator display metadata
+- **New types** — `ApiCollectionClaim`, `ApiAdminCollectionClaim`, `ApiCollectionProfile`, `ApiCreatorProfile`
+- **`ApiCollection`** extended with `source` (`"MEDIALANE_REGISTRY" | "EXTERNAL" | "PARTNERSHIP" | "IP_TICKET" | "IP_CLUB" | "GAME"`) and `claimedBy: string | null`
+- `profile?: ApiCollectionProfile | null` optionally embedded on `ApiCollection` when `?include=profile`
+
+### v0.4.0
+- **Typed error codes** — `MedialaneError` and `MedialaneApiError` now expose a `.code: MedialaneErrorCode` property (`"TOKEN_NOT_FOUND"` | `"RATE_LIMITED"` | `"INTENT_EXPIRED"` | `"UNAUTHORIZED"` | `"INVALID_PARAMS"` | `"NETWORK_NOT_SUPPORTED"` | `"UNKNOWN"`)
+- **Automatic retry** — all API requests retry up to 3 times with exponential backoff (300ms base, 5s cap); 4xx errors are not retried. Configure via `retryOptions` in `MedialaneConfig`
+- **`RetryOptions`** type exported from index
+- **`CollectionSort`** named union type exported (`"recent" | "supply" | "floor" | "volume" | "name"`)
+- **Sepolia guard** — constructing a client with `network: "sepolia"` and no explicit contract addresses now throws `NETWORK_NOT_SUPPORTED` immediately
+
 ### v0.3.3
 - `getCollections(page?, limit?, isKnown?, sort?)` — added `sort` parameter: `"recent"` (default) | `"supply"` | `"floor"` | `"volume"` | `"name"`
 - Default sort changed from `totalSupply DESC` to `createdAt DESC` (newest first) — matches backend default
@@ -421,15 +444,12 @@ Built with:
 - `ApiCollection.collectionId: string | null` — on-chain registry numeric ID (decimal string). Required for `createMintIntent`. Populated for collections indexed after 2026-03-09.
 
 ### v0.3.0
-- `normalizeAddress()` now applied internally before all API calls — callers no longer need to normalize Starknet addresses before passing them to SDK methods
-- `getCollectionsByOwner(owner)` — fetch collections by wallet address via API
-
-### v0.2.8
-- `ApiCollection.owner: string | null`
-- `ApiClient.getCollectionsByOwner(owner)`
+- `normalizeAddress()` applied internally before all API calls — callers no longer need to normalize Starknet addresses
+- `ApiCollection.owner: string | null` — populated from intent typedData or on-chain `owner()` call
+- `getCollectionsByOwner(owner)` — fetch collections by wallet address via `GET /v1/collections?owner=`
 
 ### v0.2.6
-- `ApiOrder.token: ApiOrderTokenMeta | null` — token name/image/description on orders (batchTokenMeta)
+- `ApiOrder.token: ApiOrderTokenMeta | null` — token name/image/description embedded on orders (batchTokenMeta); no per-row `getToken` calls needed
 
 ### v0.2.0
 - `IpAttribute` and `IpNftMetadata` interfaces for IP metadata

package/dist/index.cjs

@@ -12,31 +12,35 @@ var MARKETPLACE_CONTRACT_SEPOLIA = "";
 var COLLECTION_CONTRACT_SEPOLIA = "";
 var SUPPORTED_TOKENS = [
   {
-    // Circle-native USDC on Starknet (canonical — preferred)
+    // Circle-native USDC on Starknet (canonical)
     symbol: "USDC",
     address: "0x033068f6539f8e6e6b131e6b2b814e6c34a5224bc66947c47dab9dfee93b35fb",
-    decimals: 6
-  },
-  {
-    // Bridged USDC.e (Ethereum USDC bridged via Starkgate)
-    symbol: "USDC.e",
-    address: "0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8",
-    decimals: 6
+    decimals: 6,
+    listable: true
   },
   {
     symbol: "USDT",
     address: "0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8",
-    decimals: 6
+    decimals: 6,
+    listable: true
   },
   {
     symbol: "ETH",
     address: "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
-    decimals: 18
+    decimals: 18,
+    listable: true
   },
   {
     symbol: "STRK",
     address: "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d",
-    decimals: 18
+    decimals: 18,
+    listable: true
+  },
+  {
+    symbol: "WBTC",
+    address: "0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac",
+    decimals: 8,
+    listable: true
   }
 ];
 var DEFAULT_CURRENCY = "USDC";
@@ -398,6 +402,9 @@ function getTokenBySymbol(symbol) {
   const upper = symbol.toUpperCase();
   return SUPPORTED_TOKENS.find((t) => t.symbol === upper);
 }
+function getListableTokens() {
+  return SUPPORTED_TOKENS.filter((t) => t.listable);
+}
 function buildOrderTypedData(message, chainId) {
   return {
     domain: {
@@ -1176,6 +1183,79 @@ 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 (Clerk JWT) simultaneously.
+   */
+  async claimCollection(contractAddress, walletAddress, clerkToken) {
+    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/claim`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "x-api-key": this.baseHeaders["x-api-key"] ?? "",
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${clerkToken}`
+      },
+      body: JSON.stringify({ contractAddress, walletAddress })
+    });
+    return res.json();
+  }
+  /**
+   * Path 3: Manual off-chain claim request (email-based).
+   */
+  requestCollectionClaim(params) {
+    return this.request("/v1/collections/claim/request", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  // ─── Collection Profiles ────────────────────────────────────────────────────
+  async getCollectionProfile(contractAddress) {
+    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/${normalizeAddress(contractAddress)}/profile`;
+    const res = await fetch(url, { headers: this.baseHeaders });
+    if (res.status === 404) return null;
+    return res.json();
+  }
+  /**
+   * Update collection profile. Requires Clerk JWT for ownership check.
+   */
+  async updateCollectionProfile(contractAddress, data, clerkToken) {
+    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/collections/${normalizeAddress(contractAddress)}/profile`;
+    const res = await fetch(url, {
+      method: "PATCH",
+      headers: {
+        "x-api-key": this.baseHeaders["x-api-key"] ?? "",
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${clerkToken}`
+      },
+      body: JSON.stringify(data)
+    });
+    return res.json();
+  }
+  // ─── Creator Profiles ───────────────────────────────────────────────────────
+  async getCreatorProfile(walletAddress) {
+    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/creators/${normalizeAddress(walletAddress)}/profile`;
+    const res = await fetch(url, { headers: this.baseHeaders });
+    if (res.status === 404) return null;
+    return res.json();
+  }
+  /**
+   * Update creator profile. Requires Clerk JWT; wallet must match authenticated user.
+   */
+  async updateCreatorProfile(walletAddress, data, clerkToken) {
+    const url = `${this.baseUrl.replace(/\/$/, "")}/v1/creators/${normalizeAddress(walletAddress)}/profile`;
+    const res = await fetch(url, {
+      method: "PATCH",
+      headers: {
+        "x-api-key": this.baseHeaders["x-api-key"] ?? "",
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${clerkToken}`
+      },
+      body: JSON.stringify(data)
+    });
+    return res.json();
+  }
 };
 
 // src/client.ts
@@ -1223,6 +1303,7 @@ exports.buildCancellationTypedData = buildCancellationTypedData;
 exports.buildFulfillmentTypedData = buildFulfillmentTypedData;
 exports.buildOrderTypedData = buildOrderTypedData;
 exports.formatAmount = formatAmount;
+exports.getListableTokens = getListableTokens;
 exports.getTokenByAddress = getTokenByAddress;
 exports.getTokenBySymbol = getTokenBySymbol;
 exports.normalizeAddress = normalizeAddress;