@opensea/sdk 9.0.0

package/lib/utils/chain.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNativeWrapTokenAddress = exports.getFeeRecipient = exports.getSignedZone = exports.getSeaportAddress = exports.getDefaultConduit = exports.getListingPaymentToken = exports.getOfferPaymentToken = exports.getChainId = exports.usesAlternateProtocol = void 0;
+const constants_1 = require("@opensea/seaport-js/lib/constants");
+const constants_2 = require("../constants");
+const types_1 = require("../types");
+const chainIds_generated_1 = require("./chainIds.generated");
+/**
+ * Checks if a chain uses the alternate protocol addresses.
+ * These chains use non-standard Seaport, conduit, and signed zone deployments.
+ * @param chain The chain to check
+ * @returns True if the chain uses alternate protocol addresses
+ */
+const usesAlternateProtocol = (chain) => chain === types_1.Chain.Gunzilla || chain === types_1.Chain.Somnia || chain === types_1.Chain.MegaETH;
+exports.usesAlternateProtocol = usesAlternateProtocol;
+/**
+ * Gets the chain ID for a given chain.
+ *
+ * Uses the generated CHAIN_ID_MAP from scripts/chain-data.json.
+ * To add a new chain, update chain-data.json and run `pnpm sync-chains`.
+ *
+ * @param chain The chain to get the ID for
+ * @returns The chain ID as a string
+ */
+const getChainId = (chain) => {
+    const id = chainIds_generated_1.CHAIN_ID_MAP[chain];
+    if (id === undefined)
+        throw new Error(`Unknown chainId for ${chain}`);
+    return id;
+};
+exports.getChainId = getChainId;
+/**
+ * Returns the default currency for offers on the given chain.
+ * @param chain The chain to get the offer payment token for
+ * @returns The token address for offers
+ */
+const getOfferPaymentToken = (chain) => {
+    switch (chain) {
+        case types_1.Chain.Mainnet:
+            return "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"; // WETH
+        case types_1.Chain.Polygon:
+            return "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619"; // WETH
+        case types_1.Chain.Avalanche:
+            return "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7"; // WAVAX
+        case types_1.Chain.Arbitrum:
+            return "0x82af49447d8a07e3bd95bd0d56f35241523fbab1"; // WETH
+        case types_1.Chain.Blast:
+            return "0x4300000000000000000000000000000000000004"; // WETH
+        // MegaETH and OP Chains have WETH at the same address
+        case types_1.Chain.MegaETH:
+        case types_1.Chain.Base:
+        case types_1.Chain.Optimism:
+        case types_1.Chain.Zora:
+        case types_1.Chain.B3:
+        case types_1.Chain.Shape:
+        case types_1.Chain.Unichain:
+        case types_1.Chain.Ink:
+            return "0x4200000000000000000000000000000000000006"; // WETH
+        case types_1.Chain.BeraChain:
+            return "0x6969696969696969696969696969696969696969"; // WBERA
+        case types_1.Chain.Sei:
+            return "0xe30fedd158a2e3b13e9badaeabafc5516e95e8c7"; // WSEI
+        case types_1.Chain.Flow:
+            return "0xd3bf53dac106a0290b0483ecbc89d40fcc961f3e"; // WFLOW
+        case types_1.Chain.ApeChain:
+            return "0x48b62137edfa95a428d35c09e44256a739f6b557"; // WAPE
+        case types_1.Chain.Ronin:
+            return "0xe514d9deb7966c8be0ca922de8a064264ea6bcd4"; // WRON
+        case types_1.Chain.Abstract:
+            return "0x3439153eb7af838ad19d56e1571fbd09333c2809"; // WETH
+        case types_1.Chain.Gunzilla:
+            return "0x5aad7bba61d95c2c4e525a35f4062040264611f1"; // WGUN
+        case types_1.Chain.HyperEVM:
+            return "0x5555555555555555555555555555555555555555"; // WHYPE
+        case types_1.Chain.Somnia:
+            return "0x046ede9564a72571df6f5e44d0405360c0f4dcab"; // WSOMI
+        case types_1.Chain.Monad:
+            return "0x3bd359c1119da7da1d913d1c4d2b7c461115433a"; // WMON
+        default:
+            throw new Error(`Unknown offer currency for ${chain}`);
+    }
+};
+exports.getOfferPaymentToken = getOfferPaymentToken;
+/**
+ * Returns the default currency for listings on the given chain.
+ * @param chain The chain to get the listing payment token for
+ * @returns The token address for listings
+ */
+const getListingPaymentToken = (chain) => {
+    switch (chain) {
+        case types_1.Chain.Mainnet:
+        case types_1.Chain.Somnia:
+        case types_1.Chain.HyperEVM:
+        case types_1.Chain.Arbitrum:
+        case types_1.Chain.Blast:
+        case types_1.Chain.Base:
+        case types_1.Chain.Optimism:
+        case types_1.Chain.Zora:
+        case types_1.Chain.B3:
+        case types_1.Chain.Abstract:
+        case types_1.Chain.Shape:
+        case types_1.Chain.Unichain:
+        case types_1.Chain.Monad:
+        case types_1.Chain.MegaETH:
+        case types_1.Chain.Ink:
+            return "0x0000000000000000000000000000000000000000"; // ETH
+        case types_1.Chain.Polygon:
+            return "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619"; // WETH
+        case types_1.Chain.Avalanche:
+            return "0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7"; // WETH
+        case types_1.Chain.BeraChain:
+            return "0x0000000000000000000000000000000000000000"; // BERA
+        case types_1.Chain.Sei:
+            return "0x0000000000000000000000000000000000000000"; // SEI
+        case types_1.Chain.Flow:
+            return "0xd3bf53dac106a0290b0483ecbc89d40fcc961f3e"; // WETH
+        case types_1.Chain.ApeChain:
+            return "0x0000000000000000000000000000000000000000"; // APE
+        case types_1.Chain.Ronin:
+            return "0xe514d9deb7966c8be0ca922de8a064264ea6bcd4"; // WETH
+        case types_1.Chain.Gunzilla:
+            return "0x0000000000000000000000000000000000000000"; // GUN
+        default:
+            throw new Error(`Unknown listing currency for ${chain}`);
+    }
+};
+exports.getListingPaymentToken = getListingPaymentToken;
+/**
+ * Get the default conduit key and address for a given chain.
+ * @param chain The chain to get the conduit for
+ * @returns The conduit key and address for the chain
+ */
+const getDefaultConduit = (chain) => {
+    switch (chain) {
+        case types_1.Chain.Abstract:
+        case types_1.Chain.HyperEVM:
+        case types_1.Chain.Monad:
+            return {
+                key: constants_2.OPENSEA_CONDUIT_KEY_2,
+                address: constants_2.OPENSEA_CONDUIT_ADDRESS_2,
+            };
+        default:
+            if ((0, exports.usesAlternateProtocol)(chain)) {
+                return {
+                    key: constants_2.ALTERNATE_CONDUIT_KEY,
+                    address: constants_2.ALTERNATE_CONDUIT_ADDRESS,
+                };
+            }
+            return {
+                key: constants_2.OPENSEA_CONDUIT_KEY,
+                address: constants_2.OPENSEA_CONDUIT_ADDRESS,
+            };
+    }
+};
+exports.getDefaultConduit = getDefaultConduit;
+/**
+ * Get the Seaport 1.6 contract address for a given chain.
+ * @param chain The chain to get the Seaport address for
+ * @returns The Seaport 1.6 address for the chain
+ */
+const getSeaportAddress = (chain) => {
+    return (0, exports.usesAlternateProtocol)(chain)
+        ? constants_2.ALTERNATE_SEAPORT_V1_6_ADDRESS
+        : constants_1.CROSS_CHAIN_SEAPORT_V1_6_ADDRESS;
+};
+exports.getSeaportAddress = getSeaportAddress;
+/**
+ * Get the signed zone address for a given chain.
+ * @param chain The chain to get the signed zone address for
+ * @returns The signed zone address for the chain
+ */
+const getSignedZone = (chain) => {
+    return (0, exports.usesAlternateProtocol)(chain)
+        ? constants_2.ALTERNATE_SIGNED_ZONE_V2_ADDRESS
+        : constants_2.OPENSEA_SIGNED_ZONE_V2;
+};
+exports.getSignedZone = getSignedZone;
+/**
+ * Get the fee recipient address for a given chain
+ * @param chain The blockchain chain
+ * @returns The fee recipient address for the chain
+ */
+const getFeeRecipient = (chain) => {
+    switch (chain) {
+        case types_1.Chain.Gunzilla:
+            return constants_2.GUNZILLA_FEE_RECIPIENT;
+        case types_1.Chain.Somnia:
+            return constants_2.SOMNIA_FEE_RECIPIENT;
+        case types_1.Chain.MegaETH:
+            return constants_2.ALTERNATE_FEE_RECIPIENT;
+        default:
+            return constants_2.OPENSEA_FEE_RECIPIENT;
+    }
+};
+exports.getFeeRecipient = getFeeRecipient;
+/**
+ * Get the appropriate token address for wrap/unwrap operations.
+ * For Polygon, use WPOL. For other chains, use the wrapped native asset.
+ * @param chain The chain to get the token address for
+ * @returns The token address for wrap/unwrap operations
+ */
+const getNativeWrapTokenAddress = (chain) => {
+    switch (chain) {
+        case types_1.Chain.Polygon:
+            return constants_2.WPOL_ADDRESS;
+        default:
+            return (0, exports.getOfferPaymentToken)(chain);
+    }
+};
+exports.getNativeWrapTokenAddress = getNativeWrapTokenAddress;
+//# sourceMappingURL=chain.js.map

package/lib/utils/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/utils/chain.ts"],"names":[],"mappings":";;;AAAA,iEAAoF;AACpF,4CAeqB;AACrB,oCAAgC;AAChC,6DAAmD;AAEnD;;;;;GAKG;AACI,MAAM,qBAAqB,GAAG,CAAC,KAAY,EAAW,EAAE,CAC7D,KAAK,KAAK,aAAK,CAAC,QAAQ,IAAI,KAAK,KAAK,aAAK,CAAC,MAAM,IAAI,KAAK,KAAK,aAAK,CAAC,OAAO,CAAA;AADlE,QAAA,qBAAqB,yBAC6C;AAE/E;;;;;;;;GAQG;AACI,MAAM,UAAU,GAAG,CAAC,KAAY,EAAU,EAAE;IACjD,MAAM,EAAE,GAAG,iCAAY,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,EAAE,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAA;IACrE,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AAJY,QAAA,UAAU,cAItB;AAED;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,CAAC,KAAY,EAAE,EAAE;IACnD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAK,CAAC,OAAO;YAChB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,OAAO;YAChB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,SAAS;YAClB,OAAO,4CAA4C,CAAA,CAAC,QAAQ;QAC9D,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,KAAK;YACd,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,sDAAsD;QACtD,KAAK,aAAK,CAAC,OAAO,CAAC;QACnB,KAAK,aAAK,CAAC,IAAI,CAAC;QAChB,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,IAAI,CAAC;QAChB,KAAK,aAAK,CAAC,EAAE,CAAC;QACd,KAAK,aAAK,CAAC,KAAK,CAAC;QACjB,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,GAAG;YACZ,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,SAAS;YAClB,OAAO,4CAA4C,CAAA,CAAC,QAAQ;QAC9D,KAAK,aAAK,CAAC,GAAG;YACZ,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,IAAI;YACb,OAAO,4CAA4C,CAAA,CAAC,QAAQ;QAC9D,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,KAAK;YACd,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,4CAA4C,CAAA,CAAC,QAAQ;QAC9D,KAAK,aAAK,CAAC,MAAM;YACf,OAAO,4CAA4C,CAAA,CAAC,QAAQ;QAC9D,KAAK,aAAK,CAAC,KAAK;YACd,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAA;IAC1D,CAAC;AACH,CAAC,CAAA;AA7CY,QAAA,oBAAoB,wBA6ChC;AAED;;;;GAIG;AACI,MAAM,sBAAsB,GAAG,CAAC,KAAY,EAAE,EAAE;IACrD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAK,CAAC,OAAO,CAAC;QACnB,KAAK,aAAK,CAAC,MAAM,CAAC;QAClB,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,KAAK,CAAC;QACjB,KAAK,aAAK,CAAC,IAAI,CAAC;QAChB,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,IAAI,CAAC;QAChB,KAAK,aAAK,CAAC,EAAE,CAAC;QACd,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,KAAK,CAAC;QACjB,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,KAAK,CAAC;QACjB,KAAK,aAAK,CAAC,OAAO,CAAC;QACnB,KAAK,aAAK,CAAC,GAAG;YACZ,OAAO,4CAA4C,CAAA,CAAC,MAAM;QAC5D,KAAK,aAAK,CAAC,OAAO;YAChB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,SAAS;YAClB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,SAAS;YAClB,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,GAAG;YACZ,OAAO,4CAA4C,CAAA,CAAC,MAAM;QAC5D,KAAK,aAAK,CAAC,IAAI;YACb,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,4CAA4C,CAAA,CAAC,MAAM;QAC5D,KAAK,aAAK,CAAC,KAAK;YACd,OAAO,4CAA4C,CAAA,CAAC,OAAO;QAC7D,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,4CAA4C,CAAA,CAAC,MAAM;QAC5D;YACE,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC,CAAA;AArCY,QAAA,sBAAsB,0BAqClC;AAED;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAC/B,KAAY,EACsB,EAAE;IACpC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,aAAK,CAAC,KAAK;YACd,OAAO;gBACL,GAAG,EAAE,iCAAqB;gBAC1B,OAAO,EAAE,qCAAyB;aACnC,CAAA;QACH;YACE,IAAI,IAAA,6BAAqB,EAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,OAAO;oBACL,GAAG,EAAE,iCAAqB;oBAC1B,OAAO,EAAE,qCAAyB;iBACnC,CAAA;YACH,CAAC;YACD,OAAO;gBACL,GAAG,EAAE,+BAAmB;gBACxB,OAAO,EAAE,mCAAuB;aACjC,CAAA;IACL,CAAC;AACH,CAAC,CAAA;AAvBY,QAAA,iBAAiB,qBAuB7B;AAED;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAAC,KAAY,EAAU,EAAE;IACxD,OAAO,IAAA,6BAAqB,EAAC,KAAK,CAAC;QACjC,CAAC,CAAC,0CAA8B;QAChC,CAAC,CAAC,4CAAgC,CAAA;AACtC,CAAC,CAAA;AAJY,QAAA,iBAAiB,qBAI7B;AAED;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,KAAY,EAAU,EAAE;IACpD,OAAO,IAAA,6BAAqB,EAAC,KAAK,CAAC;QACjC,CAAC,CAAC,4CAAgC;QAClC,CAAC,CAAC,kCAAsB,CAAA;AAC5B,CAAC,CAAA;AAJY,QAAA,aAAa,iBAIzB;AAED;;;;GAIG;AACI,MAAM,eAAe,GAAG,CAAC,KAAY,EAAU,EAAE;IACtD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAK,CAAC,QAAQ;YACjB,OAAO,kCAAsB,CAAA;QAC/B,KAAK,aAAK,CAAC,MAAM;YACf,OAAO,gCAAoB,CAAA;QAC7B,KAAK,aAAK,CAAC,OAAO;YAChB,OAAO,mCAAuB,CAAA;QAChC;YACE,OAAO,iCAAqB,CAAA;IAChC,CAAC;AACH,CAAC,CAAA;AAXY,QAAA,eAAe,mBAW3B;AAED;;;;;GAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,KAAY,EAAU,EAAE;IAChE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAK,CAAC,OAAO;YAChB,OAAO,wBAAY,CAAA;QACrB;YACE,OAAO,IAAA,4BAAoB,EAAC,KAAK,CAAC,CAAA;IACtC,CAAC;AACH,CAAC,CAAA;AAPY,QAAA,yBAAyB,6BAOrC"}

package/lib/utils/chainIds.generated.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AUTO-GENERATED by scripts/sync-chains.ts — DO NOT EDIT.
+ * Source of truth: OpenSea REST API + scripts/chain-data.json
+ * Run `pnpm sync-chains` to regenerate.
+ */
+/** Map chain slug (Chain enum value) to numeric chain ID. */
+export declare const CHAIN_ID_MAP: Record<string, string>;

package/lib/utils/chainIds.generated.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * AUTO-GENERATED by scripts/sync-chains.ts — DO NOT EDIT.
+ * Source of truth: OpenSea REST API + scripts/chain-data.json
+ * Run `pnpm sync-chains` to regenerate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHAIN_ID_MAP = void 0;
+/** Map chain slug (Chain enum value) to numeric chain ID. */
+exports.CHAIN_ID_MAP = {
+    ethereum: "1",
+    optimism: "10",
+    unichain: "130",
+    polygon: "137",
+    monad: "143",
+    shape: "360",
+    flow: "747",
+    hyperevm: "999",
+    sei: "1329",
+    soneium: "1868",
+    ronin: "2020",
+    abstract: "2741",
+    megaeth: "4326",
+    somnia: "5031",
+    b3: "8333",
+    base: "8453",
+    ape_chain: "33139",
+    arbitrum: "42161",
+    avalanche: "43114",
+    gunzilla: "43419",
+    ink: "57073",
+    animechain: "69000",
+    bera_chain: "80094",
+    blast: "81457",
+    zora: "7777777",
+};
+//# sourceMappingURL=chainIds.generated.js.map

package/lib/utils/chainIds.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainIds.generated.js","sourceRoot":"","sources":["../../src/utils/chainIds.generated.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6DAA6D;AAChD,QAAA,YAAY,GAA2B;IAClD,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,KAAK;IACf,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,OAAO;IAClB,QAAQ,EAAE,OAAO;IACjB,SAAS,EAAE,OAAO;IAClB,QAAQ,EAAE,OAAO;IACjB,GAAG,EAAE,OAAO;IACZ,UAAU,EAAE,OAAO;IACnB,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,SAAS;CAChB,CAAA"}

package/lib/utils/converters.d.ts

@@ -0,0 +1,37 @@
+import type { Fee, OpenSeaAccount, OpenSeaCollection, OpenSeaPaymentToken, PricingCurrencies, RarityStrategy } from "../types";
+/**
+ * Converts a collection JSON response to an OpenSeaCollection object.
+ * @param collection The raw collection JSON from the API
+ * @returns OpenSeaCollection object
+ */
+export declare const collectionFromJSON: (collection: any) => OpenSeaCollection;
+/**
+ * Converts a rarity JSON response to a RarityStrategy object.
+ * @param rarity The raw rarity JSON from the API
+ * @returns RarityStrategy object or null
+ */
+export declare const rarityFromJSON: (rarity: any) => RarityStrategy | null;
+/**
+ * Converts a payment token JSON response to an OpenSeaPaymentToken object.
+ * @param token The raw payment token JSON from the API
+ * @returns OpenSeaPaymentToken object
+ */
+export declare const paymentTokenFromJSON: (token: any) => OpenSeaPaymentToken;
+/**
+ * Converts a pricing currencies JSON response to a PricingCurrencies object.
+ * @param pricingCurrencies The raw pricing currencies JSON from the API
+ * @returns PricingCurrencies object or undefined
+ */
+export declare const pricingCurrenciesFromJSON: (pricingCurrencies: any) => PricingCurrencies | undefined;
+/**
+ * Converts an account JSON response to an OpenSeaAccount object.
+ * @param account The raw account JSON from the API
+ * @returns OpenSeaAccount object
+ */
+export declare const accountFromJSON: (account: any) => OpenSeaAccount;
+/**
+ * Converts a fee JSON response to a Fee object.
+ * @param fee The raw fee JSON from the API
+ * @returns Fee object
+ */
+export declare const feeFromJSON: (fee: any) => Fee;

package/lib/utils/converters.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.feeFromJSON = exports.accountFromJSON = exports.pricingCurrenciesFromJSON = exports.paymentTokenFromJSON = exports.rarityFromJSON = exports.collectionFromJSON = void 0;
+/**
+ * Converts a collection JSON response to an OpenSeaCollection object.
+ * @param collection The raw collection JSON from the API
+ * @returns OpenSeaCollection object
+ */
+const collectionFromJSON = (collection) => {
+    return {
+        name: collection.name,
+        collection: collection.collection,
+        description: collection.description,
+        imageUrl: collection.image_url,
+        bannerImageUrl: collection.banner_image_url,
+        owner: collection.owner,
+        safelistStatus: collection.safelist_status,
+        category: collection.category,
+        isDisabled: collection.is_disabled,
+        isNSFW: collection.is_nsfw,
+        traitOffersEnabled: collection.trait_offers_enabled,
+        collectionOffersEnabled: collection.collection_offers_enabled,
+        openseaUrl: collection.opensea_url,
+        projectUrl: collection.project_url,
+        wikiUrl: collection.wiki_url,
+        discordUrl: collection.discord_url,
+        telegramUrl: collection.telegram_url,
+        twitterUsername: collection.twitter_username,
+        instagramUsername: collection.instagram_username,
+        contracts: (collection.contracts ?? []).map((contract) => ({
+            address: contract.address,
+            chain: contract.chain,
+        })),
+        editors: collection.editors,
+        fees: (collection.fees ?? []).map(exports.feeFromJSON),
+        rarity: (0, exports.rarityFromJSON)(collection.rarity),
+        pricingCurrencies: (0, exports.pricingCurrenciesFromJSON)(collection.pricing_currencies),
+        totalSupply: collection.total_supply,
+        uniqueItemCount: collection.unique_item_count,
+        createdDate: collection.created_date,
+        requiredZone: collection.required_zone,
+    };
+};
+exports.collectionFromJSON = collectionFromJSON;
+/**
+ * Converts a rarity JSON response to a RarityStrategy object.
+ * @param rarity The raw rarity JSON from the API
+ * @returns RarityStrategy object or null
+ */
+const rarityFromJSON = (rarity) => {
+    if (!rarity) {
+        return null;
+    }
+    const fromJSON = {
+        strategyId: rarity.strategy_id,
+        strategyVersion: rarity.strategy_version,
+        calculatedAt: rarity.calculated_at,
+        maxRank: rarity.max_rank,
+        tokensScored: rarity.tokens_scored,
+    };
+    return fromJSON;
+};
+exports.rarityFromJSON = rarityFromJSON;
+/**
+ * Converts a payment token JSON response to an OpenSeaPaymentToken object.
+ * @param token The raw payment token JSON from the API
+ * @returns OpenSeaPaymentToken object
+ */
+const paymentTokenFromJSON = (token) => {
+    const fromJSON = {
+        name: token.name,
+        symbol: token.symbol,
+        decimals: token.decimals,
+        address: token.address,
+        chain: token.chain,
+        imageUrl: token.image,
+        ethPrice: token.eth_price,
+        usdPrice: token.usd_price,
+    };
+    return fromJSON;
+};
+exports.paymentTokenFromJSON = paymentTokenFromJSON;
+/**
+ * Converts a pricing currencies JSON response to a PricingCurrencies object.
+ * @param pricingCurrencies The raw pricing currencies JSON from the API
+ * @returns PricingCurrencies object or undefined
+ */
+const pricingCurrenciesFromJSON = (pricingCurrencies) => {
+    if (!pricingCurrencies) {
+        return undefined;
+    }
+    return {
+        listingCurrency: pricingCurrencies.listing_currency
+            ? (0, exports.paymentTokenFromJSON)(pricingCurrencies.listing_currency)
+            : undefined,
+        offerCurrency: pricingCurrencies.offer_currency
+            ? (0, exports.paymentTokenFromJSON)(pricingCurrencies.offer_currency)
+            : undefined,
+    };
+};
+exports.pricingCurrenciesFromJSON = pricingCurrenciesFromJSON;
+/**
+ * Converts an account JSON response to an OpenSeaAccount object.
+ * @param account The raw account JSON from the API
+ * @returns OpenSeaAccount object
+ */
+const accountFromJSON = (account) => {
+    return {
+        address: account.address,
+        username: account.username,
+        profileImageUrl: account.profile_image_url,
+        bannerImageUrl: account.banner_image_url,
+        website: account.website,
+        socialMediaAccounts: (account.social_media_accounts ?? []).map((acct) => ({
+            platform: acct.platform,
+            username: acct.username,
+        })),
+        bio: account.bio,
+        joinedDate: account.joined_date,
+    };
+};
+exports.accountFromJSON = accountFromJSON;
+/**
+ * Converts a fee JSON response to a Fee object.
+ * @param fee The raw fee JSON from the API
+ * @returns Fee object
+ */
+const feeFromJSON = (fee) => {
+    const fromJSON = {
+        fee: fee.fee,
+        recipient: fee.recipient,
+        required: fee.required,
+    };
+    return fromJSON;
+};
+exports.feeFromJSON = feeFromJSON;
+//# sourceMappingURL=converters.js.map

package/lib/utils/converters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.js","sourceRoot":"","sources":["../../src/utils/converters.ts"],"names":[],"mappings":";;;AASA;;;;GAIG;AACI,MAAM,kBAAkB,GAAG,CAAC,UAAe,EAAqB,EAAE;IACvE,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,QAAQ,EAAE,UAAU,CAAC,SAAS;QAC9B,cAAc,EAAE,UAAU,CAAC,gBAAgB;QAC3C,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,cAAc,EAAE,UAAU,CAAC,eAAe;QAC1C,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,MAAM,EAAE,UAAU,CAAC,OAAO;QAC1B,kBAAkB,EAAE,UAAU,CAAC,oBAAoB;QACnD,uBAAuB,EAAE,UAAU,CAAC,yBAAyB;QAC7D,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,OAAO,EAAE,UAAU,CAAC,QAAQ;QAC5B,UAAU,EAAE,UAAU,CAAC,WAAW;QAClC,WAAW,EAAE,UAAU,CAAC,YAAY;QACpC,eAAe,EAAE,UAAU,CAAC,gBAAgB;QAC5C,iBAAiB,EAAE,UAAU,CAAC,kBAAkB;QAChD,SAAS,EAAE,CAAC,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAa,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC,CAAC;QACH,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,mBAAW,CAAC;QAC9C,MAAM,EAAE,IAAA,sBAAc,EAAC,UAAU,CAAC,MAAM,CAAC;QACzC,iBAAiB,EAAE,IAAA,iCAAyB,EAAC,UAAU,CAAC,kBAAkB,CAAC;QAC3E,WAAW,EAAE,UAAU,CAAC,YAAY;QACpC,eAAe,EAAE,UAAU,CAAC,iBAAiB;QAC7C,WAAW,EAAE,UAAU,CAAC,YAAY;QACpC,YAAY,EAAE,UAAU,CAAC,aAAa;KACvC,CAAA;AACH,CAAC,CAAA;AAlCY,QAAA,kBAAkB,sBAkC9B;AAED;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAAC,MAAW,EAAyB,EAAE;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,QAAQ,GAAmB;QAC/B,UAAU,EAAE,MAAM,CAAC,WAAW;QAC9B,eAAe,EAAE,MAAM,CAAC,gBAAgB;QACxC,YAAY,EAAE,MAAM,CAAC,aAAa;QAClC,OAAO,EAAE,MAAM,CAAC,QAAQ;QACxB,YAAY,EAAE,MAAM,CAAC,aAAa;KACnC,CAAA;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAZY,QAAA,cAAc,kBAY1B;AAED;;;;GAIG;AACI,MAAM,oBAAoB,GAAG,CAAC,KAAU,EAAuB,EAAE;IACtE,MAAM,QAAQ,GAAwB;QACpC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,QAAQ,EAAE,KAAK,CAAC,SAAS;QACzB,QAAQ,EAAE,KAAK,CAAC,SAAS;KAC1B,CAAA;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAZY,QAAA,oBAAoB,wBAYhC;AAED;;;;GAIG;AACI,MAAM,yBAAyB,GAAG,CACvC,iBAAsB,EACS,EAAE;IACjC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO;QACL,eAAe,EAAE,iBAAiB,CAAC,gBAAgB;YACjD,CAAC,CAAC,IAAA,4BAAoB,EAAC,iBAAiB,CAAC,gBAAgB,CAAC;YAC1D,CAAC,CAAC,SAAS;QACb,aAAa,EAAE,iBAAiB,CAAC,cAAc;YAC7C,CAAC,CAAC,IAAA,4BAAoB,EAAC,iBAAiB,CAAC,cAAc,CAAC;YACxD,CAAC,CAAC,SAAS;KACd,CAAA;AACH,CAAC,CAAA;AAdY,QAAA,yBAAyB,6BAcrC;AAED;;;;GAIG;AACI,MAAM,eAAe,GAAG,CAAC,OAAY,EAAkB,EAAE;IAC9D,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,eAAe,EAAE,OAAO,CAAC,iBAAiB;QAC1C,cAAc,EAAE,OAAO,CAAC,gBAAgB;QACxC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,mBAAmB,EAAE,CAAC,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,GAAG,CAC5D,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;YACd,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CACH;QACD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,WAAW;KAChC,CAAA;AACH,CAAC,CAAA;AAhBY,QAAA,eAAe,mBAgB3B;AAED;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,GAAQ,EAAO,EAAE;IAC3C,MAAM,QAAQ,GAAQ;QACpB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAA;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAPY,QAAA,WAAW,eAOvB"}

package/lib/utils/dateHelper.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Utility functions for working with Unix timestamps (seconds since epoch).
+ * OpenSea API and Seaport protocol use Unix timestamps in seconds, not milliseconds.
+ */
+/**
+ * Get the current Unix timestamp in seconds
+ * @returns Current time as Unix timestamp (seconds since epoch)
+ */
+export declare function getCurrentUnixTimestamp(): number;
+/**
+ * Get a Unix timestamp for a future time
+ * @param seconds Number of seconds from now
+ * @returns Unix timestamp (seconds since epoch)
+ * @example
+ * // Get timestamp for 1 day from now
+ * const tomorrow = getUnixTimestampInSeconds(60 * 60 * 24);
+ */
+export declare function getUnixTimestampInSeconds(seconds: number): number;
+/**
+ * Common time durations in seconds for convenience
+ */
+export declare enum TimeInSeconds {
+    /** 1 minute = 60 seconds */
+    MINUTE = 60,
+    /** 1 hour = 3600 seconds */
+    HOUR = 3600,
+    /** 1 day = 86400 seconds */
+    DAY = 86400,
+    /** 1 week = 604800 seconds */
+    WEEK = 604800,
+    /** 30 days = 2592000 seconds */
+    MONTH = 2592000
+}
+/**
+ * Get Unix timestamp for one month from now (30 days)
+ * @returns Unix timestamp (seconds since epoch) for 30 days in the future
+ */
+export declare const oneMonthFromNowInSeconds: () => number;

package/lib/utils/dateHelper.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Utility functions for working with Unix timestamps (seconds since epoch).
+ * OpenSea API and Seaport protocol use Unix timestamps in seconds, not milliseconds.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oneMonthFromNowInSeconds = exports.TimeInSeconds = void 0;
+exports.getCurrentUnixTimestamp = getCurrentUnixTimestamp;
+exports.getUnixTimestampInSeconds = getUnixTimestampInSeconds;
+/**
+ * Get the current Unix timestamp in seconds
+ * @returns Current time as Unix timestamp (seconds since epoch)
+ */
+function getCurrentUnixTimestamp() {
+    return Math.floor(Date.now() / 1000);
+}
+/**
+ * Get a Unix timestamp for a future time
+ * @param seconds Number of seconds from now
+ * @returns Unix timestamp (seconds since epoch)
+ * @example
+ * // Get timestamp for 1 day from now
+ * const tomorrow = getUnixTimestampInSeconds(60 * 60 * 24);
+ */
+function getUnixTimestampInSeconds(seconds) {
+    return getCurrentUnixTimestamp() + seconds;
+}
+/**
+ * Common time durations in seconds for convenience
+ */
+var TimeInSeconds;
+(function (TimeInSeconds) {
+    /** 1 minute = 60 seconds */
+    TimeInSeconds[TimeInSeconds["MINUTE"] = 60] = "MINUTE";
+    /** 1 hour = 3600 seconds */
+    TimeInSeconds[TimeInSeconds["HOUR"] = 3600] = "HOUR";
+    /** 1 day = 86400 seconds */
+    TimeInSeconds[TimeInSeconds["DAY"] = 86400] = "DAY";
+    /** 1 week = 604800 seconds */
+    TimeInSeconds[TimeInSeconds["WEEK"] = 604800] = "WEEK";
+    /** 30 days = 2592000 seconds */
+    TimeInSeconds[TimeInSeconds["MONTH"] = 2592000] = "MONTH";
+})(TimeInSeconds || (exports.TimeInSeconds = TimeInSeconds = {}));
+/**
+ * Get Unix timestamp for one month from now (30 days)
+ * @returns Unix timestamp (seconds since epoch) for 30 days in the future
+ */
+const oneMonthFromNowInSeconds = () => {
+    return getUnixTimestampInSeconds(TimeInSeconds.MONTH);
+};
+exports.oneMonthFromNowInSeconds = oneMonthFromNowInSeconds;
+//# sourceMappingURL=dateHelper.js.map

package/lib/utils/dateHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateHelper.js","sourceRoot":"","sources":["../../src/utils/dateHelper.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAMH,0DAEC;AAUD,8DAEC;AAlBD;;;GAGG;AACH,SAAgB,uBAAuB;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CAAC,OAAe;IACvD,OAAO,uBAAuB,EAAE,GAAG,OAAO,CAAA;AAC5C,CAAC;AAED;;GAEG;AACH,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,4BAA4B;IAC5B,sDAAW,CAAA;IACX,4BAA4B;IAC5B,oDAAW,CAAA;IACX,4BAA4B;IAC5B,mDAAW,CAAA;IACX,8BAA8B;IAC9B,sDAAa,CAAA;IACb,gCAAgC;IAChC,yDAAe,CAAA;AACjB,CAAC,EAXW,aAAa,6BAAb,aAAa,QAWxB;AAED;;;GAGG;AACI,MAAM,wBAAwB,GAAG,GAAW,EAAE;IACnD,OAAO,yBAAyB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACvD,CAAC,CAAA;AAFY,QAAA,wBAAwB,4BAEpC"}

package/lib/utils/fees.d.ts

@@ -0,0 +1,13 @@
+import type { Fee } from "../types";
+/**
+ * Sums up the basis points for fees.
+ * @param fees The fees to sum up
+ * @returns sum of basis points
+ */
+export declare const totalBasisPointsForFees: (fees: Fee[]) => bigint;
+/**
+ * Converts a fee to its basis points representation.
+ * @param fee The fee to convert
+ * @returns the basis points
+ */
+export declare const basisPointsForFee: (fee: Fee) => bigint;

package/lib/utils/fees.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.basisPointsForFee = exports.totalBasisPointsForFees = void 0;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+/**
+ * Sums up the basis points for fees.
+ * @param fees The fees to sum up
+ * @returns sum of basis points
+ */
+const totalBasisPointsForFees = (fees) => {
+    const feeBasisPoints = fees.map(fee => (0, exports.basisPointsForFee)(fee));
+    const totalBasisPoints = feeBasisPoints.reduce((sum, basisPoints) => basisPoints + sum, 0n);
+    return totalBasisPoints;
+};
+exports.totalBasisPointsForFees = totalBasisPointsForFees;
+/**
+ * Converts a fee to its basis points representation.
+ * @param fee The fee to convert
+ * @returns the basis points
+ */
+const basisPointsForFee = (fee) => {
+    return BigInt(ethers_1.FixedNumber.fromString(fee.fee.toString())
+        .mul(constants_1.FIXED_NUMBER_100)
+        .toFormat(0) // format to 0 decimal places to convert to bigint
+        .toString());
+};
+exports.basisPointsForFee = basisPointsForFee;
+//# sourceMappingURL=fees.js.map

package/lib/utils/fees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../src/utils/fees.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AACpC,4CAA+C;AAG/C;;;;GAIG;AACI,MAAM,uBAAuB,GAAG,CAAC,IAAW,EAAU,EAAE;IAC7D,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,yBAAiB,EAAC,GAAG,CAAC,CAAC,CAAA;IAC9D,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAC5C,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,GAAG,GAAG,EACvC,EAAE,CACH,CAAA;IACD,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA;AAPY,QAAA,uBAAuB,2BAOnC;AAED;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAAC,GAAQ,EAAU,EAAE;IACpD,OAAO,MAAM,CACX,oBAAW,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;SACvC,GAAG,CAAC,4BAAgB,CAAC;SACrB,QAAQ,CAAC,CAAC,CAAC,CAAC,kDAAkD;SAC9D,QAAQ,EAAE,CACd,CAAA;AACH,CAAC,CAAA;AAPY,QAAA,iBAAiB,qBAO7B"}

package/lib/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./dateHelper";
+export * from "./utils";

package/lib/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dateHelper"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,0CAAuB"}