@medialane/sdk 0.37.0 → 0.39.0

package/README.md

@@ -64,8 +64,8 @@ yarn add @medialane/sdk starknet
 import { MedialaneClient } from "@medialane/sdk";
 
 const client = new MedialaneClient({
-  network: "mainnet",                                                         // mainnet only
-  rpcUrl: "https://rpc.starknet.lava.build",                                  // optional; defaults to Lava
+  chain: "STARKNET",                                                          // chain-scoped (default "STARKNET"); replaces `network` (v0.37.0)
+  rpcUrl: "https://rpc.starknet.lava.build",                                  // optional; defaults to the chain's registry rpcUrl
   backendUrl: "https://medialane-backend-production.up.railway.app",          // required for .api methods
   apiKey: "ml_live_...",                                                       // from Medialane Portal
 });
@@ -412,8 +412,11 @@ const token = getTokenByAddress("0x033068...");
 
 ```typescript
 import {
-  normalizeAddress,    // Pad to 64-char 0x-prefixed lowercase hex
-  shortenAddress,      // → "0x1234...5678"
+  normalizeAddress,    // (chain, address) → canonical form per chain (Starknet pad / EVM EIP-55 / Solana base58)
+  shortenAddress,      // (chain, address) → "0x1234...5678"
+  getCoordinates,      // (chain) → that chain's service coordinates from the registry
+  CHAINS,              // readonly ["STARKNET","ETHEREUM","SOLANA","BASE","BITCOIN"]
+  type Chain,
   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)
@@ -454,8 +457,8 @@ try {
 
 | Option | Type | Default | Description |
 |---|---|---|---|
-| `network` | `"mainnet" \| "sepolia"` | `"mainnet"` | Starknet network |
-| `rpcUrl` | `string` | Lava public endpoint | JSON-RPC URL |
+| `chain` | `Chain` (`"STARKNET" \| "ETHEREUM" \| "SOLANA" \| "BASE" \| "BITCOIN"`) | `"STARKNET"` | The chain this client is scoped to. Coordinates resolve from the `coordinates[chain]` registry (`chains.ts`). Replaces `network` (v0.37.0). |
+| `rpcUrl` | `string` | the chain's registry `rpcUrl` | JSON-RPC URL override |
 | `backendUrl` | `string` | — | Medialane API base URL (required for `.api.*`) |
 | `apiKey` | `string` | — | API key from [Medialane Portal](https://medialane.xyz) |
 | `marketplace721Contract` | `string` | Mainnet default | ERC-721 marketplace protocol override |
@@ -503,6 +506,15 @@ Built with:
 
 ## Changelog
 
+> Full history in [CHANGELOG.md](./CHANGELOG.md). Highlights below.
+
+### v0.37.0 — multichain readiness (BREAKING)
+- **Chain is a first-class axis.** New `chains.ts` `coordinates[chain]` registry is the single source of per-chain service coordinates (`CHAINS`, `getCoordinates`, `DEFAULT_CHAIN`, `Chain`, `ChainCoordinates`); the flat `*_MAINNET` constants derive from it.
+- **`MedialaneConfig.chain` replaces `network`** — the client is chain-scoped; `client.network` getter → `client.chain`.
+- **`ServiceDefinition.onchain` is per-chain** — `Partial<Record<Chain, …>>`; read `service.onchain?.STARKNET?.factoryAddress`.
+- **`normalizeAddress(chain, address)`** — per-chain codec (Starknet pad / EVM EIP-55 / Solana base58; Bitcoin not yet implemented).
+- **Removed** `SUPPORTED_NETWORKS`, `DEFAULT_RPC_URL`, `Network` (mainnet-only — coordinates key by chain alone). `getChainId(config)` throws for non-Starknet.
+
 ### v0.6.7
 - **`CollectionRegistryABI`** exported from `@medialane/sdk` — minimal ABI covering `list_user_collections` and `get_collection` on the collection registry contract. Eliminates duplicated inline ABI definitions in consuming apps.
 

package/dist/index.cjs

@@ -18,10 +18,10 @@ var COORDINATES = {
     marketplace1155: "0x040cd7b3e73bb3c892166e34bdc01d1797f97ecbc356c23f1cf38033cacf0077",
     marketplace1155ClassHash: "0x02600bb720908f119afe482309d36c39d087587f0df9576454acfb6363e78cd8",
     marketplace1155StartBlock: 10350855,
-    collection721: "0x0322cb7119955e01ac778d40976eb3ba50540bb0899f812d612f9c7e63e49fd2",
-    collection721StartBlock: 10046166,
-    ipNftClassHash: "0x27ee4ded786d51bced1e94afec3034d6ffce71c032c45ee1ff283ccfa9db12e",
-    ipCollectionClassHash: "0x287ccdff8b6655a2248cfe170d82eae3a35303cd00ef3e751b25ddca26d9095",
+    collection721: "0x0558c9b6ea4d403df6d765fb77be55702c572f0a811f037c6c4209fe1e5aeef2",
+    collection721StartBlock: 11002817,
+    ipNftClassHash: "0x040551f0d009a6d665ddff980a375dfccc71a8928c8bfcc9ab56244bc4464fab",
+    ipCollectionClassHash: "0x063d4ac4ae317fd155216bf1b8a4d3a63172ff72965b9ac48dd5add0c2d32b70",
     collection1155: "0x0083543c3ee15040a419fc539fa6889f5b956e7d071bcfa97842cb0ae42ad6cc",
     collection1155FactoryClassHash: "0x331a69da8655a882ba1fbcb55188b8fa09116521db901bbbaafc9fead0689f8",
     collection1155ClassHash: "0x4e110b59af240ae6c7742999964c4eae13fb2ed935c47fe97653ec017ebea34",
@@ -2998,7 +2998,7 @@ var IPCollectionABI = [
         "type": "core::integer::u256"
       },
       {
-        "name": "total_transfers",
+        "name": "protocol_routed_transfers",
         "type": "core::integer::u256"
       },
       {
@@ -3088,6 +3088,10 @@ var IPCollectionABI = [
           {
             "name": "token_uri",
             "type": "core::byte_array::ByteArray"
+          },
+          {
+            "name": "royalty_bps",
+            "type": "core::integer::u128"
           }
         ],
         "outputs": [
@@ -3112,6 +3116,10 @@ var IPCollectionABI = [
           {
             "name": "token_uris",
             "type": "core::array::Array::<core::byte_array::ByteArray>"
+          },
+          {
+            "name": "royalty_bps",
+            "type": "core::array::Array::<core::integer::u128>"
           }
         ],
         "outputs": [
@@ -3142,8 +3150,12 @@ var IPCollectionABI = [
         "name": "archive",
         "inputs": [
           {
-            "name": "token",
-            "type": "core::byte_array::ByteArray"
+            "name": "collection_id",
+            "type": "core::integer::u256"
+          },
+          {
+            "name": "token_id",
+            "type": "core::integer::u256"
           }
         ],
         "outputs": [],
@@ -3154,8 +3166,12 @@ var IPCollectionABI = [
         "name": "batch_archive",
         "inputs": [
           {
-            "name": "tokens",
-            "type": "core::array::Array::<core::byte_array::ByteArray>"
+            "name": "collection_ids",
+            "type": "core::array::Array::<core::integer::u256>"
+          },
+          {
+            "name": "token_ids",
+            "type": "core::array::Array::<core::integer::u256>"
           }
         ],
         "outputs": [],
@@ -3166,16 +3182,16 @@ var IPCollectionABI = [
         "name": "transfer_token",
         "inputs": [
           {
-            "name": "from",
+            "name": "to",
             "type": "core::starknet::contract_address::ContractAddress"
           },
           {
-            "name": "to",
-            "type": "core::starknet::contract_address::ContractAddress"
+            "name": "collection_id",
+            "type": "core::integer::u256"
           },
           {
-            "name": "token",
-            "type": "core::byte_array::ByteArray"
+            "name": "token_id",
+            "type": "core::integer::u256"
           }
         ],
         "outputs": [],
@@ -3194,8 +3210,12 @@ var IPCollectionABI = [
             "type": "core::starknet::contract_address::ContractAddress"
           },
           {
-            "name": "tokens",
-            "type": "core::array::Array::<core::byte_array::ByteArray>"
+            "name": "collection_ids",
+            "type": "core::array::Array::<core::integer::u256>"
+          },
+          {
+            "name": "token_ids",
+            "type": "core::array::Array::<core::integer::u256>"
           }
         ],
         "outputs": [],
@@ -3264,6 +3284,17 @@ var IPCollectionABI = [
         ],
         "state_mutability": "view"
       },
+      {
+        "type": "function",
+        "name": "version",
+        "inputs": [],
+        "outputs": [
+          {
+            "type": "core::byte_array::ByteArray"
+          }
+        ],
+        "state_mutability": "view"
+      },
       {
         "type": "function",
         "name": "is_valid_collection",
@@ -3321,8 +3352,12 @@ var IPCollectionABI = [
         "name": "get_token",
         "inputs": [
           {
-            "name": "token",
-            "type": "core::byte_array::ByteArray"
+            "name": "collection_id",
+            "type": "core::integer::u256"
+          },
+          {
+            "name": "token_id",
+            "type": "core::integer::u256"
           }
         ],
         "outputs": [
@@ -3337,8 +3372,12 @@ var IPCollectionABI = [
         "name": "is_valid_token",
         "inputs": [
           {
-            "name": "token",
-            "type": "core::byte_array::ByteArray"
+            "name": "collection_id",
+            "type": "core::integer::u256"
+          },
+          {
+            "name": "token_id",
+            "type": "core::integer::u256"
           }
         ],
         "outputs": [
@@ -3353,8 +3392,12 @@ var IPCollectionABI = [
         "name": "is_transferable_token",
         "inputs": [
           {
-            "name": "token",
-            "type": "core::byte_array::ByteArray"
+            "name": "collection_id",
+            "type": "core::integer::u256"
+          },
+          {
+            "name": "token_id",
+            "type": "core::integer::u256"
           }
         ],
         "outputs": [
@@ -3459,6 +3502,11 @@ var IPCollectionABI = [
         "name": "metadata_uri",
         "type": "core::byte_array::ByteArray",
         "kind": "data"
+      },
+      {
+        "name": "royalty_bps",
+        "type": "core::integer::u128",
+        "kind": "data"
       }
     ]
   },
@@ -3482,6 +3530,11 @@ var IPCollectionABI = [
         "type": "core::array::Array::<core::starknet::contract_address::ContractAddress>",
         "kind": "data"
       },
+      {
+        "name": "metadata_uris",
+        "type": "core::array::Array::<core::byte_array::ByteArray>",
+        "kind": "data"
+      },
       {
         "name": "operator",
         "type": "core::starknet::contract_address::ContractAddress",
@@ -3527,8 +3580,13 @@ var IPCollectionABI = [
     "kind": "struct",
     "members": [
       {
-        "name": "tokens",
-        "type": "core::array::Array::<core::byte_array::ByteArray>",
+        "name": "collection_ids",
+        "type": "core::array::Span::<core::integer::u256>",
+        "kind": "data"
+      },
+      {
+        "name": "token_ids",
+        "type": "core::array::Span::<core::integer::u256>",
         "kind": "data"
       },
       {
@@ -3596,8 +3654,13 @@ var IPCollectionABI = [
         "kind": "data"
       },
       {
-        "name": "tokens",
-        "type": "core::array::Array::<core::byte_array::ByteArray>",
+        "name": "collection_ids",
+        "type": "core::array::Span::<core::integer::u256>",
+        "kind": "data"
+      },
+      {
+        "name": "token_ids",
+        "type": "core::array::Span::<core::integer::u256>",
         "kind": "data"
       },
       {
@@ -3823,6 +3886,10 @@ var IPNftABI = [
           {
             "name": "creator",
             "type": "core::starknet::contract_address::ContractAddress"
+          },
+          {
+            "name": "royalty_bps",
+            "type": "core::integer::u128"
           }
         ],
         "outputs": [],
@@ -3878,6 +3945,17 @@ var IPNftABI = [
         ],
         "state_mutability": "view"
       },
+      {
+        "type": "function",
+        "name": "version",
+        "inputs": [],
+        "outputs": [
+          {
+            "type": "core::byte_array::ByteArray"
+          }
+        ],
+        "state_mutability": "view"
+      },
       {
         "type": "function",
         "name": "base_uri",
@@ -4360,6 +4438,75 @@ var IPNftABI = [
       }
     ]
   },
+  {
+    "type": "impl",
+    "name": "ERC2981Impl",
+    "interface_name": "openzeppelin_token::common::erc2981::interface::IERC2981"
+  },
+  {
+    "type": "interface",
+    "name": "openzeppelin_token::common::erc2981::interface::IERC2981",
+    "items": [
+      {
+        "type": "function",
+        "name": "royalty_info",
+        "inputs": [
+          {
+            "name": "token_id",
+            "type": "core::integer::u256"
+          },
+          {
+            "name": "sale_price",
+            "type": "core::integer::u256"
+          }
+        ],
+        "outputs": [
+          {
+            "type": "(core::starknet::contract_address::ContractAddress, core::integer::u256)"
+          }
+        ],
+        "state_mutability": "view"
+      }
+    ]
+  },
+  {
+    "type": "impl",
+    "name": "ERC2981InfoImpl",
+    "interface_name": "openzeppelin_token::common::erc2981::interface::IERC2981Info"
+  },
+  {
+    "type": "interface",
+    "name": "openzeppelin_token::common::erc2981::interface::IERC2981Info",
+    "items": [
+      {
+        "type": "function",
+        "name": "default_royalty",
+        "inputs": [],
+        "outputs": [
+          {
+            "type": "(core::starknet::contract_address::ContractAddress, core::integer::u128, core::integer::u128)"
+          }
+        ],
+        "state_mutability": "view"
+      },
+      {
+        "type": "function",
+        "name": "token_royalty",
+        "inputs": [
+          {
+            "name": "token_id",
+            "type": "core::integer::u256"
+          }
+        ],
+        "outputs": [
+          {
+            "type": "(core::starknet::contract_address::ContractAddress, core::integer::u128, core::integer::u128)"
+          }
+        ],
+        "state_mutability": "view"
+      }
+    ]
+  },
   {
     "type": "constructor",
     "name": "constructor",
@@ -4486,6 +4633,12 @@ var IPNftABI = [
     "kind": "enum",
     "variants": []
   },
+  {
+    "type": "event",
+    "name": "openzeppelin_token::common::erc2981::erc2981::ERC2981Component::Event",
+    "kind": "enum",
+    "variants": []
+  },
   {
     "type": "event",
     "name": "ip_collection_erc_721::IPNft::IPNft::Event",
@@ -4505,6 +4658,11 @@ var IPNftABI = [
         "name": "ERC721EnumerableEvent",
         "type": "openzeppelin_token::erc721::extensions::erc721_enumerable::erc721_enumerable::ERC721EnumerableComponent::Event",
         "kind": "flat"
+      },
+      {
+        "name": "ERC2981Event",
+        "type": "openzeppelin_token::common::erc2981::erc2981::ERC2981Component::Event",
+        "kind": "flat"
       }
     ]
   }
@@ -4958,11 +5116,17 @@ async function cancelOrder(account, params, config) {
   }
 }
 async function mint(account, params, config) {
-  const { collectionId, recipient, tokenUri, collectionContract } = params;
+  const { collectionId, recipient, tokenUri, royaltyBps, collectionContract } = params;
   const provider = getProvider(config);
   const contractAddress = collectionContract ?? config.collectionContract;
   const id = starknet.cairo.uint256(collectionId);
-  const calldata = [id.low.toString(), id.high.toString(), recipient, ...encodeByteArray(tokenUri)];
+  const calldata = [
+    id.low.toString(),
+    id.high.toString(),
+    recipient,
+    ...encodeByteArray(tokenUri),
+    royaltyBps.toString()
+  ];
   try {
     const tx = await account.execute([{ contractAddress, entrypoint: "mint", calldata }]);
     await provider.waitForTransaction(tx.transaction_hash);
@@ -6083,6 +6247,20 @@ 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));
+    if (opts.limit) params.set("limit", String(opts.limit));
+    if (opts.service) params.set("service", opts.service);
+    const qs = params.toString();
+    return this.get(`/v1/coins${qs ? `?${qs}` : ""}`);
+  }
+  getCoin(contract) {
+    return this.get(`/v1/coins/${this.addr(contract)}`);
+  }
   // ─── Collection Drop ────────────────────────────────────────────────────────
   getDropCollections(opts = {}) {
     return this.getCollections(opts.page ?? 1, opts.limit ?? 20, void 0, opts.sort, "COLLECTION_DROP");