@medialane/sdk 0.78.0 → 0.79.0

package/dist/index.d.cts

@@ -472,6 +472,8 @@ declare function stringifyBigInts(obj: unknown): unknown;
  * Convert a u256 represented as { low: string; high: string } to a single BigInt.
  */
 declare function u256ToBigInt(low: string, high: string): bigint;
+/** Split a bigint into low/high felt252 halves for a Cairo u256 (inverse of `u256ToBigInt`). */
+declare function encodeU256(n: bigint): [string, string];
 
 /**
  * Resilient Starknet RPC helpers — the single source of truth for "what counts
@@ -533,4 +535,47 @@ 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, 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 };
+/**
+ * Shared OpenSea-ERC721 + Berne-Convention metadata builder.
+ *
+ * Single source of truth for how a Medialane asset's metadata JSON is shaped.
+ * Pure function — no network calls, no FormData. Server-safe and chain-neutral.
+ */
+type AssetAttribute = {
+    trait_type: string;
+    value: string;
+};
+interface AssetMetadata {
+    name: string;
+    description: string;
+    image: string | null;
+    external_url: string;
+    attributes: AssetAttribute[];
+}
+interface BuildAssetMetadataInput {
+    name: string;
+    description?: string | null;
+    externalUrl?: string | null;
+    imageUri?: string | null;
+    creator?: string | null;
+    ipType?: string | null;
+    licenseType?: string | null;
+    commercialUse?: string | null;
+    derivatives?: string | null;
+    attribution?: string | null;
+    geographicScope?: string | null;
+    aiPolicy?: string | null;
+    royalty?: string | null;
+    edition?: string | null;
+    /** Already-extracted `tmpl_*` template/custom traits (reserved names are filtered here). */
+    templateTraits?: {
+        traitType: string;
+        value: string;
+    }[];
+    /** ISO date (YYYY-MM-DD) stamped as the Berne registration trait. Defaults to today. */
+    registrationDate?: string;
+}
+declare const RESERVED_TRAITS: Set<string>;
+declare function buildAssetMetadata(input: BuildAssetMetadataInput): AssetMetadata;
+
+export { type AssetAttribute, type AssetMetadata, type BuildAssetMetadataInput, Chain, DEFAULT_CURRENCY, type FailoverFetchOptions, PUBLIC_RPC_FALLBACKS, RESERVED_TRAITS, 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, buildAssetMetadata, chainFromSlug, chainSlug, coinHref, collectionHref, createFailoverFetch, encodeU256, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, shortenAddress, stringifyBigInts, u256ToBigInt };

package/dist/index.d.ts

@@ -472,6 +472,8 @@ declare function stringifyBigInts(obj: unknown): unknown;
  * Convert a u256 represented as { low: string; high: string } to a single BigInt.
  */
 declare function u256ToBigInt(low: string, high: string): bigint;
+/** Split a bigint into low/high felt252 halves for a Cairo u256 (inverse of `u256ToBigInt`). */
+declare function encodeU256(n: bigint): [string, string];
 
 /**
  * Resilient Starknet RPC helpers — the single source of truth for "what counts
@@ -533,4 +535,47 @@ 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, 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 };
+/**
+ * Shared OpenSea-ERC721 + Berne-Convention metadata builder.
+ *
+ * Single source of truth for how a Medialane asset's metadata JSON is shaped.
+ * Pure function — no network calls, no FormData. Server-safe and chain-neutral.
+ */
+type AssetAttribute = {
+    trait_type: string;
+    value: string;
+};
+interface AssetMetadata {
+    name: string;
+    description: string;
+    image: string | null;
+    external_url: string;
+    attributes: AssetAttribute[];
+}
+interface BuildAssetMetadataInput {
+    name: string;
+    description?: string | null;
+    externalUrl?: string | null;
+    imageUri?: string | null;
+    creator?: string | null;
+    ipType?: string | null;
+    licenseType?: string | null;
+    commercialUse?: string | null;
+    derivatives?: string | null;
+    attribution?: string | null;
+    geographicScope?: string | null;
+    aiPolicy?: string | null;
+    royalty?: string | null;
+    edition?: string | null;
+    /** Already-extracted `tmpl_*` template/custom traits (reserved names are filtered here). */
+    templateTraits?: {
+        traitType: string;
+        value: string;
+    }[];
+    /** ISO date (YYYY-MM-DD) stamped as the Berne registration trait. Defaults to today. */
+    registrationDate?: string;
+}
+declare const RESERVED_TRAITS: Set<string>;
+declare function buildAssetMetadata(input: BuildAssetMetadataInput): AssetMetadata;
+
+export { type AssetAttribute, type AssetMetadata, type BuildAssetMetadataInput, Chain, DEFAULT_CURRENCY, type FailoverFetchOptions, PUBLIC_RPC_FALLBACKS, RESERVED_TRAITS, 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, buildAssetMetadata, chainFromSlug, chainSlug, coinHref, collectionHref, createFailoverFetch, encodeU256, formatAmount, getListableTokens, getService, getServicesByCapability, getTokenByAddress, getTokenBySymbol, hasCapability, isServiceId, isTransientRpcError, listServices, normalizeAddress, normalizeHash, parseAmount, shortenAddress, stringifyBigInts, u256ToBigInt };

package/dist/index.js

@@ -1303,6 +1303,12 @@ function stringifyBigInts(obj) {
 function u256ToBigInt(low, high) {
   return BigInt(low) + (BigInt(high) << 128n);
 }
+function encodeU256(n) {
+  return [
+    (n & 0xffffffffffffffffffffffffffffffffn).toString(),
+    (n >> 128n).toString()
+  ];
+}
 
 // src/utils/rpc.ts
 var PUBLIC_RPC_FALLBACKS = [
@@ -1357,6 +1363,60 @@ 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, 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 };
+// src/metadata.ts
+var RESERVED_TRAITS = /* @__PURE__ */ new Set([
+  "Creator",
+  "IP Type",
+  "License",
+  "Commercial Use",
+  "Derivatives",
+  "Attribution",
+  "Territory",
+  "AI Policy",
+  "Royalty",
+  "Edition",
+  "Standard",
+  "Registration"
+]);
+var RESERVED_TRAITS_NORMALIZED = new Set([...RESERVED_TRAITS].map((t) => t.toLowerCase()));
+function buildAssetMetadata(input) {
+  const attributes = [];
+  if (input.creator) attributes.push({ trait_type: "Creator", value: input.creator });
+  if (input.ipType) attributes.push({ trait_type: "IP Type", value: input.ipType });
+  if (input.licenseType) attributes.push({ trait_type: "License", value: input.licenseType });
+  if (input.commercialUse) attributes.push({ trait_type: "Commercial Use", value: input.commercialUse });
+  if (input.derivatives) attributes.push({ trait_type: "Derivatives", value: input.derivatives });
+  if (input.attribution) attributes.push({ trait_type: "Attribution", value: input.attribution });
+  if (input.geographicScope) attributes.push({ trait_type: "Territory", value: input.geographicScope });
+  if (input.aiPolicy) attributes.push({ trait_type: "AI Policy", value: input.aiPolicy });
+  if (input.royalty) {
+    const num = parseFloat(String(input.royalty).replace("%", ""));
+    if (!isNaN(num) && num > 0) attributes.push({ trait_type: "Royalty", value: `${num}%` });
+  }
+  if (input.edition) attributes.push({ trait_type: "Edition", value: input.edition });
+  for (const t of input.templateTraits ?? []) {
+    const traitType = t.traitType?.trim() ?? "";
+    const traitValue = String(t.value ?? "").trim();
+    if (!traitType || !traitValue || RESERVED_TRAITS_NORMALIZED.has(traitType.toLowerCase())) continue;
+    if (traitType.length > 64 || traitValue.length > 512) continue;
+    attributes.push({ trait_type: traitType, value: traitValue });
+  }
+  if (input.licenseType) {
+    attributes.push({ trait_type: "Standard", value: "Berne Convention" });
+    attributes.push({
+      trait_type: "Registration",
+      value: input.registrationDate ?? (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
+    });
+  }
+  return {
+    name: input.name,
+    description: input.description ?? "",
+    image: input.imageUri ?? null,
+    external_url: input.externalUrl || "https://medialane.io",
+    attributes
+  };
+}
+
+export { ApiClient, CHAINS, DEFAULT_CHAIN, DEFAULT_CURRENCY, FeeConfigSchema, MedialaneApiError, OPEN_LICENSES, PUBLIC_RPC_FALLBACKS, RESERVED_TRAITS, 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, buildAssetMetadata, chainFromSlug, chainSlug, coinHref, collectionHref, createFailoverFetch, encodeU256, 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