@medialane/sdk 0.71.0 → 0.72.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { S as ServiceDefinition, a as ServiceCapability } from './services-D7n-cJYt.cjs';
-export { A as ActivityType, b as ApiActivitiesQuery, c as ApiActivity, d as ApiActivityPrice, e as ApiAdminCollectionClaim, f as ApiAppSource, g as ApiChain, h as ApiClient, i as ApiCoin, j as ApiCoinsQuery, k as ApiCollection, l as ApiCollectionClaim, m as ApiCollectionProfile, n as ApiCollectionSlugClaim, o as ApiCollectionsQuery, p as ApiComment, q as ApiCounterOffersQuery, r as ApiCreatorListResult, s as ApiCreatorProfile, t as ApiIntent, u as ApiIntentCreated, v as ApiKeyStatus, w as ApiMeta, x as ApiMetadataSignedUrl, y as ApiMetadataUpload, z as ApiOrder, B as ApiOrderConsideration, C as ApiOrderOffer, D as ApiOrderPrice, E as ApiOrderTokenMeta, F as ApiOrderTxHash, G as ApiOrdersQuery, H as ApiPointEvent, I as ApiPortalKey, J as ApiPortalKeyCreated, K as ApiPortalMe, L as ApiPublicRemix, M as ApiRemixOffer, N as ApiRemixOfferPrice, O as ApiRemixOffersQuery, P as ApiResponse, Q as ApiRewardsBadge, R as ApiRewardsBatchEntry, T as ApiRewardsConfig, U as ApiRewardsLeaderboardEntry, V as ApiRewardsLevel, W as ApiSearchCollectionResult, X as ApiSearchCreatorResult, Y as ApiSearchResult, Z as ApiSearchTokenResult, _ as ApiToken, $ as ApiTokenBalance, a0 as ApiTokenMetadata, a1 as ApiUsageDay, a2 as ApiUserRewards, a3 as ApiUserWallet, a4 as ApiWebhookCreated, a5 as ApiWebhookEndpoint, a6 as AutoRemixOfferParams, a7 as CancelOrderIntentParams, a8 as ChainFilter, a9 as ClaimConditions, aa as CollectionSort, ab as CollectionTokensSort, ac as ConfirmRemixOfferParams, ad as ConfirmSelfRemixParams, ae as ConsiderationItem, af as CreateCollectionIntentParams, ag as CreateCounterOfferIntentParams, ah as CreateDropParams, ai as CreateListingIntentParams, aj as CreateMembershipParams, ak as CreateMintIntentParams, al as CreatePopCollectionParams, am as CreateRemixOfferParams, an as CreateSponsorshipOfferParams, ao as CreateTicketParams, ap as CreateWebhookParams, aq as DropMintStatus, ar as EnforcementDeclaration, as as FeeConfig, at as FeeConfigSchema, au as FulfillOrderIntentParams, av as IPType, aw as IntentCall, ax as IntentStatus, ay as IntentType, az as IpAttribute, aA as IpNftMetadata, aB as MakeOfferIntentParams, aC as MedialaneApiError, aD as MedialaneConfig, aE as MedialaneErrorCode, aF as MintMembershipsParams, aG as MintTicketsParams, aH as OPEN_LICENSES, aI as OfferItem, aJ as OpenLicense, aK as Order, aL as OrderDetails, aM as OrderParameters, aN as OrderStatus, aO as PopBatchEligibilityItem, aP as PopClaimStatus, aQ as PopEventType, aR as ProposeSponsorshipParams, aS as RemixOfferStatus, aT as ResolvedConfig, aU as ResolvedFeeConfig, aV as RetryOptions, aW as ServiceEventDeclaration, aX as SortOrder, aY as TenantPlan, aZ as TxResult, a_ as WebhookEventType, a$ as WebhookStatus, b0 as resolveConfig, b1 as resolveFeeConfig } from './services-D7n-cJYt.cjs';
+import { S as ServiceDefinition, a as ServiceCapability } from './services-CGbMik_G.cjs';
+export { A as ActivityType, b as ApiActivitiesQuery, c as ApiActivity, d as ApiActivityPrice, e as ApiAdminCollectionClaim, f as ApiAppSource, g as ApiChain, h as ApiClient, i as ApiCoin, j as ApiCoinsQuery, k as ApiCollection, l as ApiCollectionClaim, m as ApiCollectionProfile, n as ApiCollectionSlugClaim, o as ApiCollectionsQuery, p as ApiComment, q as ApiCounterOffersQuery, r as ApiCreatorListResult, s as ApiCreatorProfile, t as ApiIntent, u as ApiIntentCreated, v as ApiKeyStatus, w as ApiMeta, x as ApiMetadataSignedUrl, y as ApiMetadataUpload, z as ApiOrder, B as ApiOrderConsideration, C as ApiOrderOffer, D as ApiOrderPrice, E as ApiOrderTokenMeta, F as ApiOrderTxHash, G as ApiOrdersQuery, H as ApiPointEvent, I as ApiPortalKey, J as ApiPortalKeyCreated, K as ApiPortalMe, L as ApiPublicRemix, M as ApiRemixOffer, N as ApiRemixOfferPrice, O as ApiRemixOffersQuery, P as ApiResponse, Q as ApiRewardsBadge, R as ApiRewardsBatchEntry, T as ApiRewardsConfig, U as ApiRewardsLeaderboardEntry, V as ApiRewardsLevel, W as ApiSearchCollectionResult, X as ApiSearchCreatorResult, Y as ApiSearchResult, Z as ApiSearchTokenResult, _ as ApiToken, $ as ApiTokenBalance, a0 as ApiTokenMetadata, a1 as ApiUsageDay, a2 as ApiUserRewards, a3 as ApiUserWallet, a4 as ApiWebhookCreated, a5 as ApiWebhookEndpoint, a6 as AutoRemixOfferParams, a7 as CancelOrderIntentParams, a8 as ChainFilter, a9 as ClaimConditions, aa as CollectionSort, ab as CollectionTokensSort, ac as ConfirmRemixOfferParams, ad as ConfirmSelfRemixParams, ae as ConsiderationItem, af as CreateCollectionIntentParams, ag as CreateCounterOfferIntentParams, ah as CreateDropParams, ai as CreateListingIntentParams, aj as CreateMembershipParams, ak as CreateMintIntentParams, al as CreatePopCollectionParams, am as CreateRemixOfferParams, an as CreateSponsorshipOfferParams, ao as CreateTicketParams, ap as CreateWebhookParams, aq as DropMintStatus, ar as EnforcementDeclaration, as as FeeConfig, at as FeeConfigSchema, au as FulfillOrderIntentParams, av as IPType, aw as IntentCall, ax as IntentStatus, ay as IntentType, az as IpAttribute, aA as IpNftMetadata, aB as MakeOfferIntentParams, aC as MedialaneApiError, aD as MedialaneConfig, aE as MedialaneErrorCode, aF as MintMembershipsParams, aG as MintTicketsParams, aH as OPEN_LICENSES, aI as OfferItem, aJ as OpenLicense, aK as Order, aL as OrderDetails, aM as OrderParameters, aN as OrderStatus, aO as PopBatchEligibilityItem, aP as PopClaimStatus, aQ as PopEventType, aR as ProposeSponsorshipParams, aS as RemixOfferStatus, aT as ResolvedConfig, aU as ResolvedFeeConfig, aV as RetryOptions, aW as ServiceEventDeclaration, aX as SortOrder, aY as TenantPlan, aZ as TxResult, a_ as WebhookEventType, a$ as WebhookStatus, b0 as resolveConfig, b1 as resolveFeeConfig } from './services-CGbMik_G.cjs';
 import { C as Chain } from './types-Cdwb6lXp.cjs';
 export { A as AdapterTxResult, a as AssetRef, b as CHAINS, c as ChainCoordinates, d as CoordinatesByChain, e as CreateCollectionInput, D as DEFAULT_CHAIN, E as EvmCoordinates, I as IssuanceAdapter, M as MintInput, O as OrderRef, R as RegisterOrderParams, S as SolanaCoordinates, f as StarknetCoordinates, g as StellarCoordinates, V as VenueAdapter, h as getCoordinates, i as getStarknetCoordinates } from './types-Cdwb6lXp.cjs';
 import 'zod';
@@ -65,6 +65,19 @@ type SupportedTokenSymbol = (typeof SUPPORTED_TOKENS)[number]["symbol"];
 /** Default currency for listings and offers — Circle-native USDC on Starknet. */
 declare const DEFAULT_CURRENCY: SupportedTokenSymbol;
 
+/** Chains that resolve in a URL today. Extend when a second chain is displayable. */
+declare const SUPPORTED_URL_CHAINS: readonly ["STARKNET"];
+/** Chain enum → lowercase URL slug. The ONLY place the slug literal is produced. */
+declare function chainSlug(chain: Chain): string;
+/** URL slug → Chain enum, or null for an unknown/unsupported slug (caller 404s). */
+declare function chainFromSlug(slug: string): Chain | null;
+/** Nullish contract/token/address values coerce to "" — an absent id was never
+ *  a valid link anyway, and this keeps callers free of artificial null guards. */
+type Idish = string | number | null | undefined;
+declare function assetHref(chain: Chain, contract: Idish, tokenId: Idish): string;
+declare function collectionHref(chain: Chain, contract: Idish): string;
+declare function coinHref(chain: Chain, address: Idish): string;
+
 /**
  * The Medialane service registry (05-service-model §II, §VI).
  * Canonical long-form IDs (01-core-model §III). SDK-resident in v1;
@@ -520,4 +533,4 @@ interface FailoverFetchOptions {
  */
 declare function createFailoverFetch(urls: string[], options?: FailoverFetchOptions): typeof fetch;
 
-export { Chain, DEFAULT_CURRENCY, type FailoverFetchOptions, PUBLIC_RPC_FALLBACKS, STARKNET_COLLECTION_1155_CLASS_HASH, STARKNET_COLLECTION_1155_CONTRACT, STARKNET_COLLECTION_1155_FACTORY_CLASS_HASH, STARKNET_COLLECTION_1155_START_BLOCK, STARKNET_COLLECTION_721_CONTRACT, STARKNET_COLLECTION_721_START_BLOCK, STARKNET_CREATOR_COIN_CLASS_HASH, STARKNET_CREATOR_COIN_EKUBO_LAUNCHER, STARKNET_CREATOR_COIN_FACTORY_CLASS_HASH, STARKNET_CREATOR_COIN_FACTORY_CONTRACT, STARKNET_CREATOR_COIN_START_BLOCK, STARKNET_DROP_COLLECTION_CLASS_HASH, STARKNET_DROP_FACTORY_CONTRACT, STARKNET_EKUBO_CORE, STARKNET_IPCOLLECTION_CLASS_HASH, STARKNET_IPNFT_CLASS_HASH, STARKNET_IP_CLUB_COLLECTION_CLASS_HASH, STARKNET_IP_CLUB_FACTORY_CONTRACT, STARKNET_IP_SPONSORSHIP_CLASS_HASH, STARKNET_IP_SPONSORSHIP_CONTRACT, STARKNET_IP_TICKETS_FACTORY_CONTRACT, STARKNET_IP_TICKET_COLLECTION_CLASS_HASH, STARKNET_MARKETPLACE_1155_CLASS_HASH, STARKNET_MARKETPLACE_1155_CONTRACT, STARKNET_MARKETPLACE_1155_START_BLOCK, STARKNET_MARKETPLACE_721_CLASS_HASH, STARKNET_MARKETPLACE_721_CONTRACT, STARKNET_MARKETPLACE_721_START_BLOCK, STARKNET_NFTCOMMENTS_CONTRACT, STARKNET_POP_COLLECTION_CLASS_HASH, STARKNET_POP_FACTORY_CONTRACT, SUPPORTED_TOKENS, ServiceCapability, ServiceDefinition, type ServiceId, type SupportedToken, type SupportedTokenSymbol, createFailoverFetch, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, shortenAddress, stringifyBigInts, u256ToBigInt };
+export { Chain, DEFAULT_CURRENCY, type FailoverFetchOptions, PUBLIC_RPC_FALLBACKS, STARKNET_COLLECTION_1155_CLASS_HASH, STARKNET_COLLECTION_1155_CONTRACT, STARKNET_COLLECTION_1155_FACTORY_CLASS_HASH, STARKNET_COLLECTION_1155_START_BLOCK, STARKNET_COLLECTION_721_CONTRACT, STARKNET_COLLECTION_721_START_BLOCK, STARKNET_CREATOR_COIN_CLASS_HASH, STARKNET_CREATOR_COIN_EKUBO_LAUNCHER, STARKNET_CREATOR_COIN_FACTORY_CLASS_HASH, STARKNET_CREATOR_COIN_FACTORY_CONTRACT, STARKNET_CREATOR_COIN_START_BLOCK, STARKNET_DROP_COLLECTION_CLASS_HASH, STARKNET_DROP_FACTORY_CONTRACT, STARKNET_EKUBO_CORE, STARKNET_IPCOLLECTION_CLASS_HASH, STARKNET_IPNFT_CLASS_HASH, STARKNET_IP_CLUB_COLLECTION_CLASS_HASH, STARKNET_IP_CLUB_FACTORY_CONTRACT, STARKNET_IP_SPONSORSHIP_CLASS_HASH, STARKNET_IP_SPONSORSHIP_CONTRACT, STARKNET_IP_TICKETS_FACTORY_CONTRACT, STARKNET_IP_TICKET_COLLECTION_CLASS_HASH, STARKNET_MARKETPLACE_1155_CLASS_HASH, STARKNET_MARKETPLACE_1155_CONTRACT, STARKNET_MARKETPLACE_1155_START_BLOCK, STARKNET_MARKETPLACE_721_CLASS_HASH, STARKNET_MARKETPLACE_721_CONTRACT, STARKNET_MARKETPLACE_721_START_BLOCK, STARKNET_NFTCOMMENTS_CONTRACT, STARKNET_POP_COLLECTION_CLASS_HASH, STARKNET_POP_FACTORY_CONTRACT, SUPPORTED_TOKENS, SUPPORTED_URL_CHAINS, ServiceCapability, ServiceDefinition, type ServiceId, type SupportedToken, type SupportedTokenSymbol, assetHref, chainFromSlug, chainSlug, coinHref, collectionHref, createFailoverFetch, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, shortenAddress, stringifyBigInts, u256ToBigInt };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ServiceDefinition, a as ServiceCapability } from './services-B4E-tTin.js';
-export { A as ActivityType, b as ApiActivitiesQuery, c as ApiActivity, d as ApiActivityPrice, e as ApiAdminCollectionClaim, f as ApiAppSource, g as ApiChain, h as ApiClient, i as ApiCoin, j as ApiCoinsQuery, k as ApiCollection, l as ApiCollectionClaim, m as ApiCollectionProfile, n as ApiCollectionSlugClaim, o as ApiCollectionsQuery, p as ApiComment, q as ApiCounterOffersQuery, r as ApiCreatorListResult, s as ApiCreatorProfile, t as ApiIntent, u as ApiIntentCreated, v as ApiKeyStatus, w as ApiMeta, x as ApiMetadataSignedUrl, y as ApiMetadataUpload, z as ApiOrder, B as ApiOrderConsideration, C as ApiOrderOffer, D as ApiOrderPrice, E as ApiOrderTokenMeta, F as ApiOrderTxHash, G as ApiOrdersQuery, H as ApiPointEvent, I as ApiPortalKey, J as ApiPortalKeyCreated, K as ApiPortalMe, L as ApiPublicRemix, M as ApiRemixOffer, N as ApiRemixOfferPrice, O as ApiRemixOffersQuery, P as ApiResponse, Q as ApiRewardsBadge, R as ApiRewardsBatchEntry, T as ApiRewardsConfig, U as ApiRewardsLeaderboardEntry, V as ApiRewardsLevel, W as ApiSearchCollectionResult, X as ApiSearchCreatorResult, Y as ApiSearchResult, Z as ApiSearchTokenResult, _ as ApiToken, $ as ApiTokenBalance, a0 as ApiTokenMetadata, a1 as ApiUsageDay, a2 as ApiUserRewards, a3 as ApiUserWallet, a4 as ApiWebhookCreated, a5 as ApiWebhookEndpoint, a6 as AutoRemixOfferParams, a7 as CancelOrderIntentParams, a8 as ChainFilter, a9 as ClaimConditions, aa as CollectionSort, ab as CollectionTokensSort, ac as ConfirmRemixOfferParams, ad as ConfirmSelfRemixParams, ae as ConsiderationItem, af as CreateCollectionIntentParams, ag as CreateCounterOfferIntentParams, ah as CreateDropParams, ai as CreateListingIntentParams, aj as CreateMembershipParams, ak as CreateMintIntentParams, al as CreatePopCollectionParams, am as CreateRemixOfferParams, an as CreateSponsorshipOfferParams, ao as CreateTicketParams, ap as CreateWebhookParams, aq as DropMintStatus, ar as EnforcementDeclaration, as as FeeConfig, at as FeeConfigSchema, au as FulfillOrderIntentParams, av as IPType, aw as IntentCall, ax as IntentStatus, ay as IntentType, az as IpAttribute, aA as IpNftMetadata, aB as MakeOfferIntentParams, aC as MedialaneApiError, aD as MedialaneConfig, aE as MedialaneErrorCode, aF as MintMembershipsParams, aG as MintTicketsParams, aH as OPEN_LICENSES, aI as OfferItem, aJ as OpenLicense, aK as Order, aL as OrderDetails, aM as OrderParameters, aN as OrderStatus, aO as PopBatchEligibilityItem, aP as PopClaimStatus, aQ as PopEventType, aR as ProposeSponsorshipParams, aS as RemixOfferStatus, aT as ResolvedConfig, aU as ResolvedFeeConfig, aV as RetryOptions, aW as ServiceEventDeclaration, aX as SortOrder, aY as TenantPlan, aZ as TxResult, a_ as WebhookEventType, a$ as WebhookStatus, b0 as resolveConfig, b1 as resolveFeeConfig } from './services-B4E-tTin.js';
+import { S as ServiceDefinition, a as ServiceCapability } from './services-Byw4_DBm.js';
+export { A as ActivityType, b as ApiActivitiesQuery, c as ApiActivity, d as ApiActivityPrice, e as ApiAdminCollectionClaim, f as ApiAppSource, g as ApiChain, h as ApiClient, i as ApiCoin, j as ApiCoinsQuery, k as ApiCollection, l as ApiCollectionClaim, m as ApiCollectionProfile, n as ApiCollectionSlugClaim, o as ApiCollectionsQuery, p as ApiComment, q as ApiCounterOffersQuery, r as ApiCreatorListResult, s as ApiCreatorProfile, t as ApiIntent, u as ApiIntentCreated, v as ApiKeyStatus, w as ApiMeta, x as ApiMetadataSignedUrl, y as ApiMetadataUpload, z as ApiOrder, B as ApiOrderConsideration, C as ApiOrderOffer, D as ApiOrderPrice, E as ApiOrderTokenMeta, F as ApiOrderTxHash, G as ApiOrdersQuery, H as ApiPointEvent, I as ApiPortalKey, J as ApiPortalKeyCreated, K as ApiPortalMe, L as ApiPublicRemix, M as ApiRemixOffer, N as ApiRemixOfferPrice, O as ApiRemixOffersQuery, P as ApiResponse, Q as ApiRewardsBadge, R as ApiRewardsBatchEntry, T as ApiRewardsConfig, U as ApiRewardsLeaderboardEntry, V as ApiRewardsLevel, W as ApiSearchCollectionResult, X as ApiSearchCreatorResult, Y as ApiSearchResult, Z as ApiSearchTokenResult, _ as ApiToken, $ as ApiTokenBalance, a0 as ApiTokenMetadata, a1 as ApiUsageDay, a2 as ApiUserRewards, a3 as ApiUserWallet, a4 as ApiWebhookCreated, a5 as ApiWebhookEndpoint, a6 as AutoRemixOfferParams, a7 as CancelOrderIntentParams, a8 as ChainFilter, a9 as ClaimConditions, aa as CollectionSort, ab as CollectionTokensSort, ac as ConfirmRemixOfferParams, ad as ConfirmSelfRemixParams, ae as ConsiderationItem, af as CreateCollectionIntentParams, ag as CreateCounterOfferIntentParams, ah as CreateDropParams, ai as CreateListingIntentParams, aj as CreateMembershipParams, ak as CreateMintIntentParams, al as CreatePopCollectionParams, am as CreateRemixOfferParams, an as CreateSponsorshipOfferParams, ao as CreateTicketParams, ap as CreateWebhookParams, aq as DropMintStatus, ar as EnforcementDeclaration, as as FeeConfig, at as FeeConfigSchema, au as FulfillOrderIntentParams, av as IPType, aw as IntentCall, ax as IntentStatus, ay as IntentType, az as IpAttribute, aA as IpNftMetadata, aB as MakeOfferIntentParams, aC as MedialaneApiError, aD as MedialaneConfig, aE as MedialaneErrorCode, aF as MintMembershipsParams, aG as MintTicketsParams, aH as OPEN_LICENSES, aI as OfferItem, aJ as OpenLicense, aK as Order, aL as OrderDetails, aM as OrderParameters, aN as OrderStatus, aO as PopBatchEligibilityItem, aP as PopClaimStatus, aQ as PopEventType, aR as ProposeSponsorshipParams, aS as RemixOfferStatus, aT as ResolvedConfig, aU as ResolvedFeeConfig, aV as RetryOptions, aW as ServiceEventDeclaration, aX as SortOrder, aY as TenantPlan, aZ as TxResult, a_ as WebhookEventType, a$ as WebhookStatus, b0 as resolveConfig, b1 as resolveFeeConfig } from './services-Byw4_DBm.js';
 import { C as Chain } from './types-Cdwb6lXp.js';
 export { A as AdapterTxResult, a as AssetRef, b as CHAINS, c as ChainCoordinates, d as CoordinatesByChain, e as CreateCollectionInput, D as DEFAULT_CHAIN, E as EvmCoordinates, I as IssuanceAdapter, M as MintInput, O as OrderRef, R as RegisterOrderParams, S as SolanaCoordinates, f as StarknetCoordinates, g as StellarCoordinates, V as VenueAdapter, h as getCoordinates, i as getStarknetCoordinates } from './types-Cdwb6lXp.js';
 import 'zod';
@@ -65,6 +65,19 @@ type SupportedTokenSymbol = (typeof SUPPORTED_TOKENS)[number]["symbol"];
 /** Default currency for listings and offers — Circle-native USDC on Starknet. */
 declare const DEFAULT_CURRENCY: SupportedTokenSymbol;
 
+/** Chains that resolve in a URL today. Extend when a second chain is displayable. */
+declare const SUPPORTED_URL_CHAINS: readonly ["STARKNET"];
+/** Chain enum → lowercase URL slug. The ONLY place the slug literal is produced. */
+declare function chainSlug(chain: Chain): string;
+/** URL slug → Chain enum, or null for an unknown/unsupported slug (caller 404s). */
+declare function chainFromSlug(slug: string): Chain | null;
+/** Nullish contract/token/address values coerce to "" — an absent id was never
+ *  a valid link anyway, and this keeps callers free of artificial null guards. */
+type Idish = string | number | null | undefined;
+declare function assetHref(chain: Chain, contract: Idish, tokenId: Idish): string;
+declare function collectionHref(chain: Chain, contract: Idish): string;
+declare function coinHref(chain: Chain, address: Idish): string;
+
 /**
  * The Medialane service registry (05-service-model §II, §VI).
  * Canonical long-form IDs (01-core-model §III). SDK-resident in v1;
@@ -520,4 +533,4 @@ interface FailoverFetchOptions {
  */
 declare function createFailoverFetch(urls: string[], options?: FailoverFetchOptions): typeof fetch;
 
-export { Chain, DEFAULT_CURRENCY, type FailoverFetchOptions, PUBLIC_RPC_FALLBACKS, STARKNET_COLLECTION_1155_CLASS_HASH, STARKNET_COLLECTION_1155_CONTRACT, STARKNET_COLLECTION_1155_FACTORY_CLASS_HASH, STARKNET_COLLECTION_1155_START_BLOCK, STARKNET_COLLECTION_721_CONTRACT, STARKNET_COLLECTION_721_START_BLOCK, STARKNET_CREATOR_COIN_CLASS_HASH, STARKNET_CREATOR_COIN_EKUBO_LAUNCHER, STARKNET_CREATOR_COIN_FACTORY_CLASS_HASH, STARKNET_CREATOR_COIN_FACTORY_CONTRACT, STARKNET_CREATOR_COIN_START_BLOCK, STARKNET_DROP_COLLECTION_CLASS_HASH, STARKNET_DROP_FACTORY_CONTRACT, STARKNET_EKUBO_CORE, STARKNET_IPCOLLECTION_CLASS_HASH, STARKNET_IPNFT_CLASS_HASH, STARKNET_IP_CLUB_COLLECTION_CLASS_HASH, STARKNET_IP_CLUB_FACTORY_CONTRACT, STARKNET_IP_SPONSORSHIP_CLASS_HASH, STARKNET_IP_SPONSORSHIP_CONTRACT, STARKNET_IP_TICKETS_FACTORY_CONTRACT, STARKNET_IP_TICKET_COLLECTION_CLASS_HASH, STARKNET_MARKETPLACE_1155_CLASS_HASH, STARKNET_MARKETPLACE_1155_CONTRACT, STARKNET_MARKETPLACE_1155_START_BLOCK, STARKNET_MARKETPLACE_721_CLASS_HASH, STARKNET_MARKETPLACE_721_CONTRACT, STARKNET_MARKETPLACE_721_START_BLOCK, STARKNET_NFTCOMMENTS_CONTRACT, STARKNET_POP_COLLECTION_CLASS_HASH, STARKNET_POP_FACTORY_CONTRACT, SUPPORTED_TOKENS, ServiceCapability, ServiceDefinition, type ServiceId, type SupportedToken, type SupportedTokenSymbol, createFailoverFetch, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, shortenAddress, stringifyBigInts, u256ToBigInt };
+export { Chain, DEFAULT_CURRENCY, type FailoverFetchOptions, PUBLIC_RPC_FALLBACKS, STARKNET_COLLECTION_1155_CLASS_HASH, STARKNET_COLLECTION_1155_CONTRACT, STARKNET_COLLECTION_1155_FACTORY_CLASS_HASH, STARKNET_COLLECTION_1155_START_BLOCK, STARKNET_COLLECTION_721_CONTRACT, STARKNET_COLLECTION_721_START_BLOCK, STARKNET_CREATOR_COIN_CLASS_HASH, STARKNET_CREATOR_COIN_EKUBO_LAUNCHER, STARKNET_CREATOR_COIN_FACTORY_CLASS_HASH, STARKNET_CREATOR_COIN_FACTORY_CONTRACT, STARKNET_CREATOR_COIN_START_BLOCK, STARKNET_DROP_COLLECTION_CLASS_HASH, STARKNET_DROP_FACTORY_CONTRACT, STARKNET_EKUBO_CORE, STARKNET_IPCOLLECTION_CLASS_HASH, STARKNET_IPNFT_CLASS_HASH, STARKNET_IP_CLUB_COLLECTION_CLASS_HASH, STARKNET_IP_CLUB_FACTORY_CONTRACT, STARKNET_IP_SPONSORSHIP_CLASS_HASH, STARKNET_IP_SPONSORSHIP_CONTRACT, STARKNET_IP_TICKETS_FACTORY_CONTRACT, STARKNET_IP_TICKET_COLLECTION_CLASS_HASH, STARKNET_MARKETPLACE_1155_CLASS_HASH, STARKNET_MARKETPLACE_1155_CONTRACT, STARKNET_MARKETPLACE_1155_START_BLOCK, STARKNET_MARKETPLACE_721_CLASS_HASH, STARKNET_MARKETPLACE_721_CONTRACT, STARKNET_MARKETPLACE_721_START_BLOCK, STARKNET_NFTCOMMENTS_CONTRACT, STARKNET_POP_COLLECTION_CLASS_HASH, STARKNET_POP_FACTORY_CONTRACT, SUPPORTED_TOKENS, SUPPORTED_URL_CHAINS, ServiceCapability, ServiceDefinition, type ServiceId, type SupportedToken, type SupportedTokenSymbol, assetHref, chainFromSlug, chainSlug, coinHref, collectionHref, createFailoverFetch, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, shortenAddress, stringifyBigInts, u256ToBigInt };

package/dist/index.js

@@ -229,15 +229,16 @@ async function withRetry(fn, opts) {
       return await fn();
     } catch (err) {
       lastError = err;
-      if (err instanceof MedialaneApiError && err.status < 500) {
+      if (err instanceof MedialaneApiError && err.status < 500 && err.status !== 429) {
         throw err;
       }
-      const isRetryable = err instanceof MedialaneApiError && err.status >= 500 || err instanceof TypeError;
+      const isRetryable = err instanceof MedialaneApiError && (err.status >= 500 || err.status === 429) || err instanceof TypeError;
       if (!isRetryable || attempt === maxAttempts - 1) {
         throw err;
       }
-      const jitter = Math.random() * baseDelayMs;
-      const delay = Math.min(baseDelayMs * Math.pow(2, attempt) + jitter, maxDelayMs);
+      const retryAfterMs = err instanceof MedialaneApiError ? err.retryAfterMs : void 0;
+      const backoff = baseDelayMs * Math.pow(2, attempt) + Math.random() * baseDelayMs;
+      const delay = Math.min(retryAfterMs ?? backoff, maxDelayMs);
       await sleep(delay);
     }
   }
@@ -254,13 +255,22 @@ function deriveErrorCode(status) {
   return "UNKNOWN";
 }
 var MedialaneApiError = class extends Error {
-  constructor(status, message) {
+  constructor(status, message, retryAfterMs) {
     super(message);
     this.status = status;
+    this.retryAfterMs = retryAfterMs;
     this.name = "MedialaneApiError";
     this.code = deriveErrorCode(status);
   }
 };
+function parseRetryAfter(value) {
+  if (!value) return void 0;
+  const seconds = Number(value);
+  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+  const date = Date.parse(value);
+  if (!Number.isNaN(date)) return Math.max(0, date - Date.now());
+  return void 0;
+}
 var ApiClient = class {
   constructor(baseUrl, apiKey, retryOptions, chain = "STARKNET") {
     this.baseUrl = baseUrl;
@@ -299,7 +309,7 @@ var ApiClient = class {
           if (body.error) message = body.error;
         } catch {
         }
-        throw new MedialaneApiError(response.status, message);
+        throw new MedialaneApiError(response.status, message, parseRetryAfter(response.headers.get("retry-after")));
       }
       return response;
     }, this.retryOptions);
@@ -906,6 +916,26 @@ var SUPPORTED_TOKENS = [
 ];
 var DEFAULT_CURRENCY = "USDC";
 
+// src/routes.ts
+var SUPPORTED_URL_CHAINS = ["STARKNET"];
+function chainSlug(chain) {
+  return chain.toLowerCase();
+}
+function chainFromSlug(slug) {
+  const upper = slug.toUpperCase();
+  return SUPPORTED_URL_CHAINS.includes(upper) ? upper : null;
+}
+var seg = (v) => v == null ? "" : String(v);
+function assetHref(chain, contract, tokenId) {
+  return `/asset/${chainSlug(chain)}/${seg(contract)}/${seg(tokenId)}`;
+}
+function collectionHref(chain, contract) {
+  return `/collections/${chainSlug(chain)}/${seg(contract)}`;
+}
+function coinHref(chain, address) {
+  return `/coins/${chainSlug(chain)}/${seg(address)}`;
+}
+
 // src/services/registry.ts
 var SN2 = getStarknetCoordinates("STARKNET");
 var SERVICES = {
@@ -1300,6 +1330,6 @@ function createFailoverFetch(urls, options = {}) {
   return failover;
 }
 
-export { ApiClient, CHAINS, DEFAULT_CHAIN, DEFAULT_CURRENCY, FeeConfigSchema, MedialaneApiError, OPEN_LICENSES, PUBLIC_RPC_FALLBACKS, STARKNET_COLLECTION_1155_CLASS_HASH, STARKNET_COLLECTION_1155_CONTRACT, STARKNET_COLLECTION_1155_FACTORY_CLASS_HASH, STARKNET_COLLECTION_1155_START_BLOCK, STARKNET_COLLECTION_721_CONTRACT, STARKNET_COLLECTION_721_START_BLOCK, STARKNET_CREATOR_COIN_CLASS_HASH, STARKNET_CREATOR_COIN_EKUBO_LAUNCHER, STARKNET_CREATOR_COIN_FACTORY_CLASS_HASH, STARKNET_CREATOR_COIN_FACTORY_CONTRACT, STARKNET_CREATOR_COIN_START_BLOCK, STARKNET_DROP_COLLECTION_CLASS_HASH, STARKNET_DROP_FACTORY_CONTRACT, STARKNET_EKUBO_CORE, STARKNET_IPCOLLECTION_CLASS_HASH, STARKNET_IPNFT_CLASS_HASH, STARKNET_IP_CLUB_COLLECTION_CLASS_HASH, STARKNET_IP_CLUB_FACTORY_CONTRACT, STARKNET_IP_SPONSORSHIP_CLASS_HASH, STARKNET_IP_SPONSORSHIP_CONTRACT, STARKNET_IP_TICKETS_FACTORY_CONTRACT, STARKNET_IP_TICKET_COLLECTION_CLASS_HASH, STARKNET_MARKETPLACE_1155_CLASS_HASH, STARKNET_MARKETPLACE_1155_CONTRACT, STARKNET_MARKETPLACE_1155_START_BLOCK, STARKNET_MARKETPLACE_721_CLASS_HASH, STARKNET_MARKETPLACE_721_CONTRACT, STARKNET_MARKETPLACE_721_START_BLOCK, STARKNET_NFTCOMMENTS_CONTRACT, STARKNET_POP_COLLECTION_CLASS_HASH, STARKNET_POP_FACTORY_CONTRACT, SUPPORTED_TOKENS, createFailoverFetch, formatAmount, getCoordinates, getListableTokens, getService, getServicesByCapability, getStarknetCoordinates, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, resolveConfig, resolveFeeConfig, shortenAddress, stringifyBigInts, u256ToBigInt };
+export { ApiClient, CHAINS, DEFAULT_CHAIN, DEFAULT_CURRENCY, FeeConfigSchema, MedialaneApiError, OPEN_LICENSES, PUBLIC_RPC_FALLBACKS, STARKNET_COLLECTION_1155_CLASS_HASH, STARKNET_COLLECTION_1155_CONTRACT, STARKNET_COLLECTION_1155_FACTORY_CLASS_HASH, STARKNET_COLLECTION_1155_START_BLOCK, STARKNET_COLLECTION_721_CONTRACT, STARKNET_COLLECTION_721_START_BLOCK, STARKNET_CREATOR_COIN_CLASS_HASH, STARKNET_CREATOR_COIN_EKUBO_LAUNCHER, STARKNET_CREATOR_COIN_FACTORY_CLASS_HASH, STARKNET_CREATOR_COIN_FACTORY_CONTRACT, STARKNET_CREATOR_COIN_START_BLOCK, STARKNET_DROP_COLLECTION_CLASS_HASH, STARKNET_DROP_FACTORY_CONTRACT, STARKNET_EKUBO_CORE, STARKNET_IPCOLLECTION_CLASS_HASH, STARKNET_IPNFT_CLASS_HASH, STARKNET_IP_CLUB_COLLECTION_CLASS_HASH, STARKNET_IP_CLUB_FACTORY_CONTRACT, STARKNET_IP_SPONSORSHIP_CLASS_HASH, STARKNET_IP_SPONSORSHIP_CONTRACT, STARKNET_IP_TICKETS_FACTORY_CONTRACT, STARKNET_IP_TICKET_COLLECTION_CLASS_HASH, STARKNET_MARKETPLACE_1155_CLASS_HASH, STARKNET_MARKETPLACE_1155_CONTRACT, STARKNET_MARKETPLACE_1155_START_BLOCK, STARKNET_MARKETPLACE_721_CLASS_HASH, STARKNET_MARKETPLACE_721_CONTRACT, STARKNET_MARKETPLACE_721_START_BLOCK, STARKNET_NFTCOMMENTS_CONTRACT, STARKNET_POP_COLLECTION_CLASS_HASH, STARKNET_POP_FACTORY_CONTRACT, SUPPORTED_TOKENS, SUPPORTED_URL_CHAINS, assetHref, chainFromSlug, chainSlug, coinHref, collectionHref, createFailoverFetch, formatAmount, getCoordinates, getListableTokens, getService, getServicesByCapability, getStarknetCoordinates, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, resolveConfig, resolveFeeConfig, shortenAddress, stringifyBigInts, u256ToBigInt };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map