@opensea/sdk 9.0.0

package/lib/src/api/nfts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfts.js","sourceRoot":"","sources":["../../../src/api/nfts.ts"],"names":[],"mappings":";;;AACA,yCAOmB;AAQnB;;GAEG;AACH,MAAa,OAAO;IAClB,YACU,OAAgB,EAChB,KAAY;QADZ,YAAO,GAAP,OAAO,CAAS;QAChB,UAAK,GAAL,KAAK,CAAO;IACnB,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,IAAY,EACZ,QAA4B,SAAS,EACrC,OAA2B,SAAS;QAEpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,sCAA2B,EAAC,IAAI,CAAC,EACjC;YACE,KAAK;YACL,IAAI;SACL,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAAe,EACf,QAA4B,SAAS,EACrC,OAA2B,SAAS,EACpC,QAAe,IAAI,CAAC,KAAK;QAEzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,oCAAyB,EAAC,KAAK,EAAE,OAAO,CAAC,EACzC;YACE,KAAK;YACL,IAAI;SACL,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,QAA4B,SAAS,EACrC,OAA2B,SAAS,EACpC,KAAK,GAAG,IAAI,CAAC,KAAK;QAElB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,mCAAwB,EAAC,KAAK,EAAE,OAAO,CAAC,EACxC;YACE,KAAK;YACL,IAAI;SACL,CACF,CAAA;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,UAAkB,EAClB,KAAK,GAAG,IAAI,CAAC,KAAK;QAElB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,qBAAU,EAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CACvC,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAe,EACf,UAAkB,EAClB,QAAe,IAAI,CAAC,KAAK;QAEzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CACtC,IAAA,iCAAsB,EAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAClD,EAAE,CACH,CAAA;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,OAAe,EACf,QAAe,IAAI,CAAC,KAAK;QAEzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,0BAAe,EAAC,KAAK,EAAE,OAAO,CAAC,CAChC,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AAzGD,0BAyGC"}

package/lib/src/api/offers.d.ts

@@ -0,0 +1,54 @@
+import type { ProtocolData } from "../orders/types";
+import { type Chain } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { BuildOfferResponse, CollectionOffer, GetBestOfferResponse, GetOffersResponse } from "./types";
+/**
+ * Offer-related API operations
+ */
+export declare class OffersAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Gets all offers for a given collection.
+     */
+    getAllOffers(collectionSlug: string, limit?: number, next?: string): Promise<GetOffersResponse>;
+    /**
+     * Gets trait offers for a given collection.
+     */
+    getTraitOffers(collectionSlug: string, type: string, value: string, limit?: number, next?: string, floatValue?: number, intValue?: number): Promise<GetOffersResponse>;
+    /**
+     * Gets the best offer for a given token.
+     */
+    getBestOffer(collectionSlug: string, tokenId: string | number): Promise<GetBestOfferResponse>;
+    /**
+     * Build a OpenSea collection offer.
+     */
+    buildOffer(offererAddress: string, quantity: number, collectionSlug: string, offerProtectionEnabled?: boolean, traitType?: string, traitValue?: string, traits?: Array<{
+        type: string;
+        value: string;
+    }>, numericTraits?: Array<{
+        type: string;
+        min?: number;
+        max?: number;
+    }>): Promise<BuildOfferResponse>;
+    /**
+     * Get a list of collection offers for a given slug.
+     */
+    getCollectionOffers(slug: string, limit?: number, next?: string): Promise<GetOffersResponse>;
+    /**
+     * Post a collection offer to OpenSea.
+     */
+    postCollectionOffer(order: ProtocolData, slug: string, traitType?: string, traitValue?: string, traits?: Array<{
+        type: string;
+        value: string;
+    }>, numericTraits?: Array<{
+        type: string;
+        min?: number;
+        max?: number;
+    }>): Promise<CollectionOffer | null>;
+    /**
+     * Gets all active offers for a specific NFT.
+     */
+    getNFTOffers(assetContractAddress: string, tokenId: string, limit?: number, next?: string, chain?: Chain): Promise<GetOffersResponse>;
+}

package/lib/src/api/offers.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OffersAPI = void 0;
+const utils_1 = require("../orders/utils");
+const types_1 = require("../types");
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Validates trait parameters for collection offers.
+ * Used by both buildOffer and postCollectionOffer.
+ */
+function validateTraitParams(traitType, traitValue, traits, numericTraits) {
+    if (traits && traits.length > 0 && (traitType || traitValue)) {
+        throw new Error("Cannot use both 'traits' array and individual 'traitType'/'traitValue' parameters. Please use only one approach.");
+    }
+    if (traitType || traitValue) {
+        if (!traitType || !traitValue) {
+            throw new Error("Both traitType and traitValue must be defined if one is defined.");
+        }
+    }
+    if (traits && traits.length > 0) {
+        for (const trait of traits) {
+            if (!trait.type || !trait.value) {
+                throw new Error("Each trait must have both 'type' and 'value' properties.");
+            }
+        }
+    }
+    if (numericTraits && numericTraits.length > 0) {
+        for (const trait of numericTraits) {
+            if (!trait.type) {
+                throw new Error("Each numeric trait must have a 'type' property.");
+            }
+            if (trait.min === undefined && trait.max === undefined) {
+                throw new Error(`Numeric trait '${trait.type}' must have at least one of 'min' or 'max'.`);
+            }
+            if (trait.min !== undefined &&
+                trait.max !== undefined &&
+                trait.min > trait.max) {
+                throw new Error(`Numeric trait '${trait.type}': 'min' (${trait.min}) must be <= 'max' (${trait.max}).`);
+            }
+        }
+    }
+}
+/**
+ * Offer-related API operations
+ */
+class OffersAPI {
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Gets all offers for a given collection.
+     */
+    async getAllOffers(collectionSlug, limit, next) {
+        const response = await this.fetcher.get((0, apiPaths_1.getAllOffersAPIPath)(collectionSlug), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Gets trait offers for a given collection.
+     */
+    async getTraitOffers(collectionSlug, type, value, limit, next, floatValue, intValue) {
+        const response = await this.fetcher.get((0, apiPaths_1.getTraitOffersPath)(collectionSlug), {
+            type,
+            value,
+            limit,
+            next,
+            float_value: floatValue,
+            int_value: intValue,
+        });
+        return response;
+    }
+    /**
+     * Gets the best offer for a given token.
+     */
+    async getBestOffer(collectionSlug, tokenId) {
+        const response = await this.fetcher.get((0, apiPaths_1.getBestOfferAPIPath)(collectionSlug, tokenId));
+        return response;
+    }
+    /**
+     * Build a OpenSea collection offer.
+     */
+    async buildOffer(offererAddress, quantity, collectionSlug, offerProtectionEnabled = true, traitType, traitValue, traits, numericTraits) {
+        validateTraitParams(traitType, traitValue, traits, numericTraits);
+        const payload = (0, utils_1.getBuildCollectionOfferPayload)(offererAddress, quantity, collectionSlug, offerProtectionEnabled, this.chain, traitType, traitValue, traits, numericTraits);
+        const response = await this.fetcher.post((0, apiPaths_1.getBuildOfferPath)(), payload);
+        return response;
+    }
+    /**
+     * Get a list of collection offers for a given slug.
+     */
+    async getCollectionOffers(slug, limit, next) {
+        return await this.fetcher.get((0, apiPaths_1.getCollectionOffersPath)(slug), {
+            limit,
+            next,
+        });
+    }
+    /**
+     * Post a collection offer to OpenSea.
+     */
+    async postCollectionOffer(order, slug, traitType, traitValue, traits, numericTraits) {
+        validateTraitParams(traitType, traitValue, traits, numericTraits);
+        const payload = (0, utils_1.getPostCollectionOfferPayload)(slug, order, this.chain, traitType, traitValue, traits, numericTraits);
+        return await this.fetcher.post((0, apiPaths_1.getPostCollectionOfferPath)(), payload);
+    }
+    /**
+     * Gets all active offers for a specific NFT.
+     */
+    async getNFTOffers(assetContractAddress, tokenId, limit, next, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(chain, "seaport", types_1.OrderSide.OFFER), (0, utils_1.serializeOrdersQueryOptions)({
+            assetContractAddress,
+            tokenIds: [tokenId],
+            limit,
+            next,
+        }));
+        return response;
+    }
+}
+exports.OffersAPI = OffersAPI;
+//# sourceMappingURL=offers.js.map

package/lib/src/api/offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.js","sourceRoot":"","sources":["../../../src/api/offers.ts"],"names":[],"mappings":"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"}

package/lib/src/api/orders.d.ts

@@ -0,0 +1,50 @@
+import type { FulfillmentDataResponse, OrderAPIOptions, OrdersQueryOptions, OrderV2, ProtocolData } from "../orders/types";
+import { type Chain, OrderSide } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { CancelOrderResponse, GetOrderByHashResponse, GetOrdersResponse, Listing, Offer } from "./types";
+/**
+ * Order-related API operations
+ */
+export declare class OrdersAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Gets an order from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    getOrder({ side, protocol, orderDirection, orderBy, ...restOptions }: Omit<OrdersQueryOptions, "limit">): Promise<OrderV2>;
+    /**
+     * Gets a single order by its order hash.
+     * Returns the raw API response which can be either an Offer or Listing.
+     */
+    getOrderByHash(orderHash: string, protocolAddress: string, chain?: Chain): Promise<GetOrderByHashResponse>;
+    /**
+     * Gets a list of orders from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    getOrders({ side, protocol, orderDirection, orderBy, pageSize, ...restOptions }: Omit<OrdersQueryOptions, "limit"> & {
+        pageSize?: number;
+    }): Promise<GetOrdersResponse>;
+    /**
+     * Generate the data needed to fulfill a listing or an offer onchain.
+     */
+    generateFulfillmentData(fulfillerAddress: string, orderHash: string, protocolAddress: string, side: OrderSide, assetContractAddress?: string, tokenId?: string, unitsToFill?: string, recipientAddress?: string, includeOptionalCreatorFees?: boolean): Promise<FulfillmentDataResponse>;
+    /**
+     * Post an order to OpenSea.
+     * @deprecated Use postListing or postOffer instead.
+     */
+    postOrder(order: ProtocolData, apiOptions: OrderAPIOptions): Promise<OrderV2>;
+    /**
+     * Post a listing to OpenSea. Returns the new Listing response format.
+     */
+    postListing(order: ProtocolData, protocolAddress: string): Promise<Listing>;
+    /**
+     * Post an offer to OpenSea. Returns the new Offer response format.
+     */
+    postOffer(order: ProtocolData, protocolAddress: string): Promise<Offer>;
+    /**
+     * Offchain cancel an order, offer or listing, by its order hash when protected by the SignedZone.
+     */
+    offchainCancelOrder(protocolAddress: string, orderHash: string, chain?: Chain, offererSignature?: string): Promise<CancelOrderResponse>;
+}

package/lib/src/api/orders.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrdersAPI = void 0;
+const utils_1 = require("../orders/utils");
+const types_1 = require("../types");
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Order-related API operations
+ */
+class OrdersAPI {
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Gets an order from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    async getOrder({ side, protocol = "seaport", orderDirection = "desc", orderBy = "created_date", ...restOptions }) {
+        // Validate eth_price orderBy requires additional parameters
+        if (orderBy === "eth_price") {
+            const hasTokenId = (restOptions.tokenIds?.length ?? 0) > 0 ||
+                restOptions.tokenId !== undefined;
+            if (!restOptions.assetContractAddress || !hasTokenId) {
+                throw new Error('When using orderBy: "eth_price", you must provide both assetContractAddress and tokenIds (or tokenId) parameters');
+            }
+        }
+        const { orders } = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(this.chain, protocol, side), (0, utils_1.serializeOrdersQueryOptions)({
+            limit: 1,
+            orderBy,
+            orderDirection,
+            ...restOptions,
+        }));
+        if (orders.length === 0) {
+            throw new Error("Not found: no matching order found");
+        }
+        return (0, utils_1.deserializeOrder)(orders[0]);
+    }
+    /**
+     * Gets a single order by its order hash.
+     * Returns the raw API response which can be either an Offer or Listing.
+     */
+    async getOrderByHash(orderHash, protocolAddress, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getOrderByHashPath)(chain, protocolAddress, orderHash));
+        return response.order;
+    }
+    /**
+     * Gets a list of orders from API based on query options.
+     * @deprecated Use collection-based endpoints instead: getAllOffers, getAllListings, getBestOffer, getBestListing.
+     */
+    async getOrders({ side, protocol = "seaport", orderDirection = "desc", orderBy = "created_date", pageSize = 20, ...restOptions }) {
+        // Validate eth_price orderBy requires additional parameters
+        if (orderBy === "eth_price") {
+            const hasTokenId = (restOptions.tokenIds?.length ?? 0) > 0 ||
+                restOptions.tokenId !== undefined;
+            if (!restOptions.assetContractAddress || !hasTokenId) {
+                throw new Error('When using orderBy: "eth_price", you must provide both assetContractAddress and tokenIds (or tokenId) parameters');
+            }
+        }
+        const response = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(this.chain, protocol, side), (0, utils_1.serializeOrdersQueryOptions)({
+            limit: pageSize,
+            orderBy,
+            orderDirection,
+            ...restOptions,
+        }));
+        return {
+            ...response,
+            orders: response.orders.map(utils_1.deserializeOrder),
+        };
+    }
+    /**
+     * Generate the data needed to fulfill a listing or an offer onchain.
+     */
+    async generateFulfillmentData(fulfillerAddress, orderHash, protocolAddress, side, assetContractAddress, tokenId, unitsToFill, recipientAddress, includeOptionalCreatorFees = false) {
+        let payload = null;
+        if (side === types_1.OrderSide.LISTING) {
+            payload = (0, utils_1.getFulfillListingPayload)(fulfillerAddress, orderHash, protocolAddress, this.chain, assetContractAddress, tokenId, unitsToFill, recipientAddress, includeOptionalCreatorFees);
+        }
+        else {
+            payload = (0, utils_1.getFulfillOfferPayload)(fulfillerAddress, orderHash, protocolAddress, this.chain, assetContractAddress, tokenId, unitsToFill, includeOptionalCreatorFees);
+        }
+        const response = await this.fetcher.post((0, utils_1.getFulfillmentDataPath)(side), payload);
+        return response;
+    }
+    /**
+     * Post an order to OpenSea.
+     * @deprecated Use postListing or postOffer instead.
+     */
+    async postOrder(order, apiOptions) {
+        const { protocol = "seaport", side, protocolAddress } = apiOptions;
+        // Validate required fields
+        if (!side) {
+            throw new Error("apiOptions.side is required");
+        }
+        if (!protocolAddress) {
+            throw new Error("apiOptions.protocolAddress is required");
+        }
+        if (!order) {
+            throw new Error("order data is required");
+        }
+        // Validate protocol value
+        if (protocol !== "seaport") {
+            throw new Error("Currently only 'seaport' protocol is supported");
+        }
+        // Validate side value
+        if (side !== "ask" && side !== "bid") {
+            throw new Error("side must be either 'ask' or 'bid'");
+        }
+        // Validate protocolAddress format
+        if (!/^0x[a-fA-F0-9]{40}$/.test(protocolAddress)) {
+            throw new Error("Invalid protocol address format");
+        }
+        const response = await this.fetcher.post((0, apiPaths_1.getOrdersAPIPath)(this.chain, protocol, side), { ...order, protocol_address: protocolAddress });
+        return (0, utils_1.deserializeOrder)(response.order);
+    }
+    /**
+     * Post a listing to OpenSea. Returns the new Listing response format.
+     */
+    async postListing(order, protocolAddress) {
+        if (!order) {
+            throw new Error("order data is required");
+        }
+        if (!protocolAddress || !/^0x[a-fA-F0-9]{40}$/.test(protocolAddress)) {
+            throw new Error("Invalid protocol address format");
+        }
+        const response = await this.fetcher.post((0, apiPaths_1.getOrdersAPIPath)(this.chain, "seaport", types_1.OrderSide.LISTING), { ...order, protocol_address: protocolAddress });
+        return response.listing;
+    }
+    /**
+     * Post an offer to OpenSea. Returns the new Offer response format.
+     */
+    async postOffer(order, protocolAddress) {
+        if (!order) {
+            throw new Error("order data is required");
+        }
+        if (!protocolAddress || !/^0x[a-fA-F0-9]{40}$/.test(protocolAddress)) {
+            throw new Error("Invalid protocol address format");
+        }
+        const response = await this.fetcher.post((0, apiPaths_1.getOrdersAPIPath)(this.chain, "seaport", types_1.OrderSide.OFFER), { ...order, protocol_address: protocolAddress });
+        return response.offer;
+    }
+    /**
+     * Offchain cancel an order, offer or listing, by its order hash when protected by the SignedZone.
+     */
+    async offchainCancelOrder(protocolAddress, orderHash, chain = this.chain, offererSignature) {
+        const response = await this.fetcher.post((0, apiPaths_1.getCancelOrderPath)(chain, protocolAddress, orderHash), { offererSignature });
+        return response;
+    }
+}
+exports.OrdersAPI = OrdersAPI;
+//# sourceMappingURL=orders.js.map

package/lib/src/api/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../../src/api/orders.ts"],"names":[],"mappings":"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"}

package/lib/src/api/search.d.ts

@@ -0,0 +1,13 @@
+import type { Fetcher } from "./fetcher";
+import type { SearchArgs, SearchResponse } from "./types";
+/**
+ * Search-related API operations
+ */
+export declare class SearchAPI {
+    private fetcher;
+    constructor(fetcher: Fetcher);
+    /**
+     * Search across collections, tokens, NFTs, and accounts.
+     */
+    search(args: SearchArgs): Promise<SearchResponse>;
+}

package/lib/src/api/search.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchAPI = void 0;
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Search-related API operations
+ */
+class SearchAPI {
+    constructor(fetcher) {
+        this.fetcher = fetcher;
+    }
+    /**
+     * Search across collections, tokens, NFTs, and accounts.
+     */
+    async search(args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getSearchPath)(), args);
+        return response;
+    }
+}
+exports.SearchAPI = SearchAPI;
+//# sourceMappingURL=search.js.map

package/lib/src/api/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/api/search.ts"],"names":[],"mappings":";;;AAAA,yCAA0C;AAI1C;;GAEG;AACH,MAAa,SAAS;IACpB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAgB;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,wBAAa,GAAE,EACf,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AAbD,8BAaC"}

package/lib/src/api/tokens.d.ts

@@ -0,0 +1,25 @@
+import type { Fetcher } from "./fetcher";
+import type { GetSwapQuoteArgs, GetSwapQuoteResponse, GetTokenResponse, GetTokensArgs, GetTopTokensResponse, GetTrendingTokensResponse } from "./types";
+/**
+ * Token-related API operations
+ */
+export declare class TokensAPI {
+    private fetcher;
+    constructor(fetcher: Fetcher);
+    /**
+     * Gets a list of trending tokens.
+     */
+    getTrendingTokens(args?: GetTokensArgs): Promise<GetTrendingTokensResponse>;
+    /**
+     * Gets a list of top tokens.
+     */
+    getTopTokens(args?: GetTokensArgs): Promise<GetTopTokensResponse>;
+    /**
+     * Gets a swap quote.
+     */
+    getSwapQuote(args: GetSwapQuoteArgs): Promise<GetSwapQuoteResponse>;
+    /**
+     * Gets details for a specific token.
+     */
+    getToken(chain: string, address: string): Promise<GetTokenResponse>;
+}

package/lib/src/api/tokens.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokensAPI = void 0;
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Token-related API operations
+ */
+class TokensAPI {
+    constructor(fetcher) {
+        this.fetcher = fetcher;
+    }
+    /**
+     * Gets a list of trending tokens.
+     */
+    async getTrendingTokens(args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getTrendingTokensPath)(), args);
+        return response;
+    }
+    /**
+     * Gets a list of top tokens.
+     */
+    async getTopTokens(args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getTopTokensPath)(), args);
+        return response;
+    }
+    /**
+     * Gets a swap quote.
+     */
+    async getSwapQuote(args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getSwapQuotePath)(), args);
+        return response;
+    }
+    /**
+     * Gets details for a specific token.
+     */
+    async getToken(chain, address) {
+        const response = await this.fetcher.get((0, apiPaths_1.getTokenPath)(chain, address));
+        return response;
+    }
+}
+exports.TokensAPI = TokensAPI;
+//# sourceMappingURL=tokens.js.map

package/lib/src/api/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/api/tokens.ts"],"names":[],"mappings":";;;AAAA,yCAKmB;AAWnB;;GAEG;AACH,MAAa,SAAS;IACpB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,IAAoB;QAEpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,gCAAqB,GAAE,EACvB,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,IAAoB;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,2BAAgB,GAAE,EAClB,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,IAAsB;QACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,2BAAgB,GAAE,EAClB,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,OAAe;QAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,uBAAY,EAAC,KAAK,EAAE,OAAO,CAAC,CAC7B,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AA/CD,8BA+CC"}