@opensea/sdk 10.0.0 → 10.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -3
- package/lib/api/api.d.ts +49 -1
- package/lib/api/api.js +70 -0
- package/lib/api/api.js.map +1 -1
- package/lib/api/apiPaths.d.ts +5 -0
- package/lib/api/apiPaths.js +21 -1
- package/lib/api/apiPaths.js.map +1 -1
- package/lib/api/nfts.d.ts +13 -2
- package/lib/api/nfts.js +18 -0
- package/lib/api/nfts.js.map +1 -1
- package/lib/api/tokens.d.ts +9 -1
- package/lib/api/tokens.js +12 -0
- package/lib/api/tokens.js.map +1 -1
- package/lib/api/types.d.ts +32 -0
- package/lib/api/types.js.map +1 -1
- package/lib/index.d.ts +2 -1
- package/lib/index.js +3 -1
- package/lib/index.js.map +1 -1
- package/lib/sdk/base.d.ts +32 -2
- package/lib/sdk/base.js +30 -0
- package/lib/sdk/base.js.map +1 -1
- package/lib/sdk/fulfillment.d.ts +7 -1
- package/lib/sdk/fulfillment.js +2 -0
- package/lib/sdk/fulfillment.js.map +1 -1
- package/lib/viem.d.ts +1 -0
- package/lib/viem.js +3 -1
- package/lib/viem.js.map +1 -1
- package/package.json +11 -10
- package/src/api/api.ts +94 -0
- package/src/api/apiPaths.ts +28 -0
- package/src/api/nfts.ts +37 -1
- package/src/api/tokens.ts +21 -0
- package/src/api/types.ts +42 -0
- package/src/index.ts +4 -0
- package/src/sdk/base.ts +46 -2
- package/src/sdk/fulfillment.ts +3 -1
- package/src/viem.ts +1 -0
package/lib/sdk/base.js
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.BaseOpenSeaSDK = void 0;
|
|
4
4
|
const EventEmitter = require("node:events");
|
|
5
|
+
const api_1 = require("../api/api");
|
|
5
6
|
const constants_1 = require("../constants");
|
|
6
7
|
const types_1 = require("../types");
|
|
7
8
|
const address_1 = require("../utils/address");
|
|
@@ -63,6 +64,22 @@ class BaseOpenSeaSDK {
|
|
|
63
64
|
this._ordersManager = new orders_1.OrdersManager(context, this._getPriceParameters.bind(this));
|
|
64
65
|
this._fulfillmentManager = new fulfillment_1.FulfillmentManager(context, this._ordersManager);
|
|
65
66
|
}
|
|
67
|
+
/**
|
|
68
|
+
* Request a free-tier OpenSea API key without authentication. The returned
|
|
69
|
+
* key can be passed as `apiKey` into the SDK constructor to bootstrap usage.
|
|
70
|
+
* Rate limited to 3 keys per hour per IP; keys expire after 30 days.
|
|
71
|
+
*
|
|
72
|
+
* @example
|
|
73
|
+
* ```ts
|
|
74
|
+
* const { api_key } = await OpenSeaSDK.requestInstantApiKey()
|
|
75
|
+
* const sdk = new OpenSeaSDK(provider, { apiKey: api_key })
|
|
76
|
+
* ```
|
|
77
|
+
*
|
|
78
|
+
* @param apiBaseUrl Optional base URL override (defaults to mainnet).
|
|
79
|
+
*/
|
|
80
|
+
static async requestInstantApiKey(apiBaseUrl) {
|
|
81
|
+
return api_1.OpenSeaAPI.requestInstantApiKey(apiBaseUrl);
|
|
82
|
+
}
|
|
66
83
|
// ─── Event Listeners ───────────────────────────────────────────────
|
|
67
84
|
/**
|
|
68
85
|
* Add a listener for events emitted by the SDK.
|
|
@@ -180,6 +197,19 @@ class BaseOpenSeaSDK {
|
|
|
180
197
|
async fulfillOrder(options) {
|
|
181
198
|
return this._fulfillmentManager.fulfillOrder(options);
|
|
182
199
|
}
|
|
200
|
+
/**
|
|
201
|
+
* Fulfill a private listing directly using Seaport's matchOrders.
|
|
202
|
+
* The order must have a taker address set (i.e., it is a private listing).
|
|
203
|
+
* @param options
|
|
204
|
+
* @param options.order The private listing order to fulfill. Must have a taker address.
|
|
205
|
+
* @param options.accountAddress Address of the wallet fulfilling the order.
|
|
206
|
+
* @param options.domain Optional domain for onchain attribution.
|
|
207
|
+
* @param options.overrides Transaction overrides (gasLimit, maxFeePerGas, etc.).
|
|
208
|
+
* @returns Transaction hash of the fulfillment.
|
|
209
|
+
*/
|
|
210
|
+
async fulfillPrivateOrder(options) {
|
|
211
|
+
return this._fulfillmentManager.fulfillPrivateOrder(options);
|
|
212
|
+
}
|
|
183
213
|
/** Returns whether an order is fulfillable. */
|
|
184
214
|
async isOrderFulfillable(options) {
|
|
185
215
|
return this._fulfillmentManager.isOrderFulfillable(options);
|
package/lib/sdk/base.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/sdk/base.ts"],"names":[],"mappings":";;;AAAA,4CAA4C;
|
|
1
|
+
{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/sdk/base.ts"],"names":[],"mappings":"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"}
|
package/lib/sdk/fulfillment.d.ts
CHANGED
|
@@ -14,8 +14,14 @@ export declare class FulfillmentManager {
|
|
|
14
14
|
constructor(context: SDKContext, ordersManager: OrdersManager);
|
|
15
15
|
/**
|
|
16
16
|
* Fulfill a private order for a designated address.
|
|
17
|
+
* The order must have a taker address set (i.e., it is a private listing).
|
|
17
18
|
*/
|
|
18
|
-
|
|
19
|
+
fulfillPrivateOrder({ order, accountAddress, domain, overrides, }: {
|
|
20
|
+
order: OrderV2;
|
|
21
|
+
accountAddress: string;
|
|
22
|
+
domain?: string;
|
|
23
|
+
overrides?: Record<string, unknown>;
|
|
24
|
+
}): Promise<string>;
|
|
19
25
|
/**
|
|
20
26
|
* Fulfill an order for an asset. The order can be either a listing or an offer.
|
|
21
27
|
* Uses the OpenSea API to generate fulfillment transaction data and executes it directly.
|
package/lib/sdk/fulfillment.js
CHANGED
|
@@ -21,8 +21,10 @@ class FulfillmentManager {
|
|
|
21
21
|
}
|
|
22
22
|
/**
|
|
23
23
|
* Fulfill a private order for a designated address.
|
|
24
|
+
* The order must have a taker address set (i.e., it is a private listing).
|
|
24
25
|
*/
|
|
25
26
|
async fulfillPrivateOrder({ order, accountAddress, domain, overrides, }) {
|
|
27
|
+
await this.context.requireAccountIsAvailable(accountAddress);
|
|
26
28
|
if (!order.taker?.address) {
|
|
27
29
|
throw new Error("Order is not a private listing - must have a taker address");
|
|
28
30
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fulfillment.js","sourceRoot":"","sources":["../../src/sdk/fulfillment.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAGhE,+DAIkC;AAClC,2CAAyD;AACzD,2CAAkE;AAClE,oCAKiB;AACjB,0CAIuB;AAIvB,MAAM,yBAAyB,GAAG,oCAAoC,CAAA;AAEtE;;;GAGG;AACH,MAAa,kBAAkB;IAEnB;IACA;IAFV,YACU,OAAmB,EACnB,aAA4B;QAD5B,YAAO,GAAP,OAAO,CAAY;QACnB,kBAAa,GAAb,aAAa,CAAe;IACnC,CAAC;IAEJ
|
|
1
|
+
{"version":3,"file":"fulfillment.js","sourceRoot":"","sources":["../../src/sdk/fulfillment.ts"],"names":[],"mappings":"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"}
|
package/lib/viem.d.ts
CHANGED
|
@@ -19,6 +19,7 @@
|
|
|
19
19
|
import { type ViemAdapterParams } from "./provider/viem-adapter";
|
|
20
20
|
import { BaseOpenSeaSDK } from "./sdk/base";
|
|
21
21
|
import { type OpenSeaAPIConfig } from "./types";
|
|
22
|
+
export { OpenSeaAPI } from "./api/api";
|
|
22
23
|
export * from "./api/types";
|
|
23
24
|
export * from "./constants";
|
|
24
25
|
export * from "./orders/types";
|
package/lib/viem.js
CHANGED
|
@@ -32,7 +32,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
32
32
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
33
33
|
};
|
|
34
34
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
35
|
-
exports.OpenSeaSDK = void 0;
|
|
35
|
+
exports.OpenSeaSDK = exports.OpenSeaAPI = void 0;
|
|
36
36
|
// seaport-js has a hard dependency on ethers, so importing it pulls ethers
|
|
37
37
|
// into the bundle. This is a known tradeoff — see FAQ for details.
|
|
38
38
|
const seaport_js_1 = require("@opensea/seaport-js");
|
|
@@ -44,6 +44,8 @@ const types_1 = require("./types");
|
|
|
44
44
|
const address_1 = require("./utils/address");
|
|
45
45
|
const utils_1 = require("./utils/utils");
|
|
46
46
|
// Re-export everything from the main entry point
|
|
47
|
+
var api_2 = require("./api/api");
|
|
48
|
+
Object.defineProperty(exports, "OpenSeaAPI", { enumerable: true, get: function () { return api_2.OpenSeaAPI; } });
|
|
47
49
|
__exportStar(require("./api/types"), exports);
|
|
48
50
|
__exportStar(require("./constants"), exports);
|
|
49
51
|
__exportStar(require("./orders/types"), exports);
|
package/lib/viem.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"viem.js","sourceRoot":"","sources":["../src/viem.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;AAEH,2EAA2E;AAC3E,mEAAmE;AACnE,oDAA6C;AAC7C,mCAAsC;AACtC,8DAA+D;AAC/D,0DAIgC;AAChC,qCAA2C;AAC3C,mCAAsD;AACtD,6CAAiD;AACjD,yCAKsB;AAEtB,iDAAiD;AACjD,8CAA2B;AAC3B,8CAA2B;AAC3B,iDAA8B;AAQ9B,0CAAuB;AACvB,0CAAuB;AAEvB;;;;;;;GAOG;AACH,MAAa,UAAW,SAAQ,qBAAc;IAC5C;;;;;OAKG;IACH,YACE,WAA8B,EAC9B,YAA8B,EAAE,EAChC,MAA8B;QAE9B,SAAS,CAAC,KAAK,KAAK,aAAK,CAAC,OAAO,CAAA;QACjC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;QAC7B,MAAM,GAAG,GAAG,IAAI,gBAAU,CAAC,SAAS,CAAC,CAAA;QACrC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;QAEvD,MAAM,MAAM,GAAG,IAAA,+BAAgB,EAAC,WAAW,CAAC,CAAA;QAC5C,MAAM,cAAc,GAAG,IAAA,uCAAwB,EAAC,WAAW,CAAC,CAAA;QAE5D,0DAA0D;QAC1D,MAAM,uBAAuB,GAAG,IAAA,oCAAmB,EACjD,WAAW,EACX,cAAc,CACf,CAAA;QAED,MAAM,cAAc,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,cAAc,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,OAAO,GAAG,IAAI,oBAAO,CAAC,uBAAuB,EAAE;YACnD,mBAAmB,EAAE;gBACnB,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,OAAO;aAC7C;YACD,SAAS,EAAE;gBACT,iBAAiB,EAAE,cAAc,CAAC,GAAG;gBACrC,eAAe,EAAE,cAAc;aAChC;SACF,CAAC,CAAA;QAEF,MAAM,0BAA0B,GAAkC,EAAE,CAAA;QACpE,0BAA0B,CAAC,IAAA,4BAAoB,EAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAA;QAC1E,0BAA0B,CAAC,IAAA,8BAAsB,EAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAA;QAE5E,KAAK,CAAC;YACJ,MAAM;YACN,cAAc;YACd,OAAO;YACP,GAAG;YACH,KAAK;YACL,MAAM,EAAE,cAAc;YACtB,oBAAoB,EAAE,KAAK,IAAI,EAAE;gBAC/B,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACvB,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;wBAChD,OAAO,CAAC,IAAA,yBAAe,EAAC,OAAO,CAAC,CAAC,CAAA;oBACnC,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,EAAE,CAAA;oBACX,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,CAAA;YACX,CAAC;YACD,0BAA0B;SAC3B,CAAC,CAAA;IACJ,CAAC;CACF;AA/DD,gCA+DC"}
|
|
1
|
+
{"version":3,"file":"viem.js","sourceRoot":"","sources":["../src/viem.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;;;;;;;;;;;;;;;AAEH,2EAA2E;AAC3E,mEAAmE;AACnE,oDAA6C;AAC7C,mCAAsC;AACtC,8DAA+D;AAC/D,0DAIgC;AAChC,qCAA2C;AAC3C,mCAAsD;AACtD,6CAAiD;AACjD,yCAKsB;AAEtB,iDAAiD;AACjD,iCAAsC;AAA7B,iGAAA,UAAU,OAAA;AACnB,8CAA2B;AAC3B,8CAA2B;AAC3B,iDAA8B;AAQ9B,0CAAuB;AACvB,0CAAuB;AAEvB;;;;;;;GAOG;AACH,MAAa,UAAW,SAAQ,qBAAc;IAC5C;;;;;OAKG;IACH,YACE,WAA8B,EAC9B,YAA8B,EAAE,EAChC,MAA8B;QAE9B,SAAS,CAAC,KAAK,KAAK,aAAK,CAAC,OAAO,CAAA;QACjC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;QAC7B,MAAM,GAAG,GAAG,IAAI,gBAAU,CAAC,SAAS,CAAC,CAAA;QACrC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;QAEvD,MAAM,MAAM,GAAG,IAAA,+BAAgB,EAAC,WAAW,CAAC,CAAA;QAC5C,MAAM,cAAc,GAAG,IAAA,uCAAwB,EAAC,WAAW,CAAC,CAAA;QAE5D,0DAA0D;QAC1D,MAAM,uBAAuB,GAAG,IAAA,oCAAmB,EACjD,WAAW,EACX,cAAc,CACf,CAAA;QAED,MAAM,cAAc,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,cAAc,GAAG,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,OAAO,GAAG,IAAI,oBAAO,CAAC,uBAAuB,EAAE;YACnD,mBAAmB,EAAE;gBACnB,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,OAAO;aAC7C;YACD,SAAS,EAAE;gBACT,iBAAiB,EAAE,cAAc,CAAC,GAAG;gBACrC,eAAe,EAAE,cAAc;aAChC;SACF,CAAC,CAAA;QAEF,MAAM,0BAA0B,GAAkC,EAAE,CAAA;QACpE,0BAA0B,CAAC,IAAA,4BAAoB,EAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAA;QAC1E,0BAA0B,CAAC,IAAA,8BAAsB,EAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,CAAA;QAE5E,KAAK,CAAC;YACJ,MAAM;YACN,cAAc;YACd,OAAO;YACP,GAAG;YACH,KAAK;YACL,MAAM,EAAE,cAAc;YACtB,oBAAoB,EAAE,KAAK,IAAI,EAAE;gBAC/B,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;oBACvB,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAA;wBAChD,OAAO,CAAC,IAAA,yBAAe,EAAC,OAAO,CAAC,CAAC,CAAA;oBACnC,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,EAAE,CAAA;oBACX,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,CAAA;YACX,CAAC;YACD,0BAA0B;SAC3B,CAAC,CAAA;IACJ,CAAC;CACF;AA/DD,gCA+DC"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@opensea/sdk",
|
|
3
|
-
"version": "10.
|
|
4
|
-
"description": "TypeScript SDK for the OpenSea marketplace helps developers build new experiences using NFTs and our marketplace data",
|
|
3
|
+
"version": "10.2.0",
|
|
4
|
+
"description": "TypeScript SDK for the OpenSea marketplace helps developers build new experiences using NFTs, tokens, and our marketplace data",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "OpenSea Developers",
|
|
7
7
|
"homepage": "https://docs.opensea.io/reference/api-overview",
|
|
@@ -33,10 +33,10 @@
|
|
|
33
33
|
"check-types": "tsc -p tsconfig.check.json",
|
|
34
34
|
"docs-build": "typedoc",
|
|
35
35
|
"docs-build-md": "typedoc --plugin typedoc-plugin-markdown",
|
|
36
|
-
"format": "biome format --config-path
|
|
37
|
-
"format:check": "biome format --config-path
|
|
38
|
-
"lint": "biome check --config-path
|
|
39
|
-
"lint:fix": "biome check --config-path
|
|
36
|
+
"format": "biome format --config-path . --write .",
|
|
37
|
+
"format:check": "biome format --config-path . .",
|
|
38
|
+
"lint": "biome check --config-path . .",
|
|
39
|
+
"lint:fix": "biome check --config-path . --write .",
|
|
40
40
|
"test": "vitest run",
|
|
41
41
|
"test:all": "concurrently \"npm run test\" \"npm run test:integration\"",
|
|
42
42
|
"test:coverage": "vitest run --coverage",
|
|
@@ -45,8 +45,8 @@
|
|
|
45
45
|
"types": "lib/index.d.ts",
|
|
46
46
|
"dependencies": {
|
|
47
47
|
"@noble/hashes": "^2.0.1",
|
|
48
|
-
"@opensea/api-types": "^0.2.
|
|
49
|
-
"@opensea/seaport-js": "^4.
|
|
48
|
+
"@opensea/api-types": "^0.2.1",
|
|
49
|
+
"@opensea/seaport-js": "^4.1.1",
|
|
50
50
|
"ethers": "^6.16.0"
|
|
51
51
|
},
|
|
52
52
|
"peerDependencies": {
|
|
@@ -59,7 +59,6 @@
|
|
|
59
59
|
},
|
|
60
60
|
"devDependencies": {
|
|
61
61
|
"@types/node": "^25.4.0",
|
|
62
|
-
"viem": "2.23.2",
|
|
63
62
|
"@vitest/coverage-v8": "^3.2.4",
|
|
64
63
|
"concurrently": "^9.2.1",
|
|
65
64
|
"dotenv": "^17.3.1",
|
|
@@ -67,7 +66,9 @@
|
|
|
67
66
|
"typedoc-plugin-markdown": "^4.10.0",
|
|
68
67
|
"typescript": "^6.0.2",
|
|
69
68
|
"typescript-eslint": "^8.57.0",
|
|
70
|
-
"
|
|
69
|
+
"viem": "2.23.2",
|
|
70
|
+
"vitest": "^3.2.4",
|
|
71
|
+
"@biomejs/biome": "^2.4.10"
|
|
71
72
|
},
|
|
72
73
|
"keywords": [
|
|
73
74
|
"collectibles",
|
package/src/api/api.ts
CHANGED
|
@@ -19,6 +19,7 @@ import {
|
|
|
19
19
|
} from "../types"
|
|
20
20
|
import { executeWithRateLimit } from "../utils/rateLimit"
|
|
21
21
|
import { AccountsAPI } from "./accounts"
|
|
22
|
+
import { getInstantApiKeyPath } from "./apiPaths"
|
|
22
23
|
import { ChainsAPI } from "./chains"
|
|
23
24
|
import { CollectionsAPI } from "./collections"
|
|
24
25
|
import { DropsAPI } from "./drops"
|
|
@@ -50,12 +51,16 @@ import {
|
|
|
50
51
|
type GetEventsArgs,
|
|
51
52
|
type GetEventsResponse,
|
|
52
53
|
type GetListingsResponse,
|
|
54
|
+
type GetNFTMetadataResponse,
|
|
53
55
|
type GetNFTResponse,
|
|
54
56
|
type GetOffersResponse,
|
|
55
57
|
type GetOrderByHashResponse,
|
|
56
58
|
type GetOrdersResponse,
|
|
57
59
|
type GetSwapQuoteArgs,
|
|
58
60
|
type GetSwapQuoteResponse,
|
|
61
|
+
type GetTokenGroupResponse,
|
|
62
|
+
type GetTokenGroupsArgs,
|
|
63
|
+
type GetTokenGroupsResponse,
|
|
59
64
|
type GetTokenResponse,
|
|
60
65
|
type GetTokensArgs,
|
|
61
66
|
type GetTopCollectionsArgs,
|
|
@@ -66,6 +71,7 @@ import {
|
|
|
66
71
|
type Listing,
|
|
67
72
|
type ListNFTsResponse,
|
|
68
73
|
type Offer,
|
|
74
|
+
type RequestInstantApiKeyResponse,
|
|
69
75
|
type ResolveAccountResponse,
|
|
70
76
|
type SearchArgs,
|
|
71
77
|
type SearchResponse,
|
|
@@ -759,6 +765,27 @@ export class OpenSeaAPI {
|
|
|
759
765
|
return this.tokensAPI.getToken(chain, address)
|
|
760
766
|
}
|
|
761
767
|
|
|
768
|
+
/**
|
|
769
|
+
* Gets a paginated list of token groups — equivalent currencies across
|
|
770
|
+
* chains (e.g. ETH on Ethereum, Base, and Arbitrum share the "eth" group).
|
|
771
|
+
* @param args Optional query parameters (`limit`, `cursor`).
|
|
772
|
+
* @returns The {@link GetTokenGroupsResponse} returned by the API.
|
|
773
|
+
*/
|
|
774
|
+
public async getTokenGroups(
|
|
775
|
+
args?: GetTokenGroupsArgs,
|
|
776
|
+
): Promise<GetTokenGroupsResponse> {
|
|
777
|
+
return this.tokensAPI.getTokenGroups(args)
|
|
778
|
+
}
|
|
779
|
+
|
|
780
|
+
/**
|
|
781
|
+
* Gets a single token group by its slug (e.g. "eth").
|
|
782
|
+
* @param slug The token group slug.
|
|
783
|
+
* @returns The {@link GetTokenGroupResponse} returned by the API.
|
|
784
|
+
*/
|
|
785
|
+
public async getTokenGroup(slug: string): Promise<GetTokenGroupResponse> {
|
|
786
|
+
return this.tokensAPI.getTokenGroup(slug)
|
|
787
|
+
}
|
|
788
|
+
|
|
762
789
|
/**
|
|
763
790
|
* Search across collections, tokens, NFTs, and accounts.
|
|
764
791
|
* Results are ranked by relevance.
|
|
@@ -929,6 +956,39 @@ export class OpenSeaAPI {
|
|
|
929
956
|
return this.accountsAPI.resolveAccount(identifier)
|
|
930
957
|
}
|
|
931
958
|
|
|
959
|
+
/**
|
|
960
|
+
* Get the collection that an NFT belongs to.
|
|
961
|
+
* Useful for multi-contract collections where the token ID disambiguates
|
|
962
|
+
* which collection the NFT belongs to.
|
|
963
|
+
* @param address The NFT contract address.
|
|
964
|
+
* @param identifier The token identifier.
|
|
965
|
+
* @param chain The chain where the NFT is located. Defaults to the chain set in the constructor.
|
|
966
|
+
* @returns The {@link OpenSeaCollection} returned by the API.
|
|
967
|
+
*/
|
|
968
|
+
public async getNFTCollection(
|
|
969
|
+
address: string,
|
|
970
|
+
identifier: string,
|
|
971
|
+
chain: Chain = this.chain,
|
|
972
|
+
): Promise<OpenSeaCollection> {
|
|
973
|
+
return this.nftsAPI.getNFTCollection(address, identifier, chain)
|
|
974
|
+
}
|
|
975
|
+
|
|
976
|
+
/**
|
|
977
|
+
* Get detailed metadata for an NFT including name, description, image, traits,
|
|
978
|
+
* and external links.
|
|
979
|
+
* @param address The NFT contract address.
|
|
980
|
+
* @param tokenId The token identifier.
|
|
981
|
+
* @param chain The chain where the NFT is located. Defaults to the chain set in the constructor.
|
|
982
|
+
* @returns The {@link GetNFTMetadataResponse} returned by the API.
|
|
983
|
+
*/
|
|
984
|
+
public async getNFTMetadata(
|
|
985
|
+
address: string,
|
|
986
|
+
tokenId: string,
|
|
987
|
+
chain: Chain = this.chain,
|
|
988
|
+
): Promise<GetNFTMetadataResponse> {
|
|
989
|
+
return this.nftsAPI.getNFTMetadata(address, tokenId, chain)
|
|
990
|
+
}
|
|
991
|
+
|
|
932
992
|
/**
|
|
933
993
|
* Generic fetch method for any API endpoint with automatic rate limit retry
|
|
934
994
|
* @param apiPath Path to URL endpoint under API
|
|
@@ -1091,6 +1151,40 @@ export class OpenSeaAPI {
|
|
|
1091
1151
|
}
|
|
1092
1152
|
}
|
|
1093
1153
|
|
|
1154
|
+
/**
|
|
1155
|
+
* Request a free-tier OpenSea API key without authentication. The returned
|
|
1156
|
+
* key is valid for 30 days and can be passed into the {@link OpenSeaAPI} or
|
|
1157
|
+
* {@link BaseOpenSeaSDK} constructors as `apiKey`. Rate limited to 3 keys
|
|
1158
|
+
* per hour per IP.
|
|
1159
|
+
*
|
|
1160
|
+
* @example
|
|
1161
|
+
* ```ts
|
|
1162
|
+
* const { api_key } = await OpenSeaAPI.requestInstantApiKey()
|
|
1163
|
+
* const api = new OpenSeaAPI({ apiKey: api_key })
|
|
1164
|
+
* ```
|
|
1165
|
+
*
|
|
1166
|
+
* @param apiBaseUrl Optional base URL override (defaults to mainnet).
|
|
1167
|
+
* @returns The {@link RequestInstantApiKeyResponse} containing the new key.
|
|
1168
|
+
*/
|
|
1169
|
+
public static async requestInstantApiKey(
|
|
1170
|
+
apiBaseUrl: string = API_BASE_MAINNET,
|
|
1171
|
+
): Promise<RequestInstantApiKeyResponse> {
|
|
1172
|
+
const response = await fetch(`${apiBaseUrl}${getInstantApiKeyPath()}`, {
|
|
1173
|
+
method: "POST",
|
|
1174
|
+
headers: {
|
|
1175
|
+
"Content-Type": "application/json",
|
|
1176
|
+
"x-app-id": "opensea-js",
|
|
1177
|
+
},
|
|
1178
|
+
body: "{}",
|
|
1179
|
+
})
|
|
1180
|
+
if (!response.ok) {
|
|
1181
|
+
throw new Error(
|
|
1182
|
+
`Server Error (${response.status}): ${response.statusText}`,
|
|
1183
|
+
)
|
|
1184
|
+
}
|
|
1185
|
+
return response.json()
|
|
1186
|
+
}
|
|
1187
|
+
|
|
1094
1188
|
/**
|
|
1095
1189
|
* Maximum retry-after value in seconds (5 minutes).
|
|
1096
1190
|
* Prevents excessively long waits from buggy or malicious servers.
|
package/src/api/apiPaths.ts
CHANGED
|
@@ -206,3 +206,31 @@ export const getTopCollectionsPath = () => {
|
|
|
206
206
|
export const getResolveAccountPath = (identifier: string) => {
|
|
207
207
|
return `${API_V2_PREFIX}/accounts/resolve/${identifier}`
|
|
208
208
|
}
|
|
209
|
+
|
|
210
|
+
export const getNFTCollectionPath = (
|
|
211
|
+
chain: Chain,
|
|
212
|
+
address: string,
|
|
213
|
+
identifier: string,
|
|
214
|
+
) => {
|
|
215
|
+
return `${API_V2_PREFIX}/chain/${chain}/contract/${address}/nfts/${identifier}/collection`
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
export const getNFTMetadataPath = (
|
|
219
|
+
chain: Chain,
|
|
220
|
+
contractAddress: string,
|
|
221
|
+
tokenId: string,
|
|
222
|
+
) => {
|
|
223
|
+
return `${API_V2_PREFIX}/metadata/${chain}/${contractAddress}/${tokenId}`
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
export const getTokenGroupsPath = () => {
|
|
227
|
+
return `${API_V2_PREFIX}/token-groups`
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
export const getTokenGroupPath = (slug: string) => {
|
|
231
|
+
return `${API_V2_PREFIX}/token-groups/${slug}`
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
export const getInstantApiKeyPath = () => {
|
|
235
|
+
return `${API_V2_PREFIX}/auth/keys`
|
|
236
|
+
}
|
package/src/api/nfts.ts
CHANGED
|
@@ -1,16 +1,21 @@
|
|
|
1
|
-
import type { Chain } from "../types"
|
|
1
|
+
import type { Chain, OpenSeaCollection } from "../types"
|
|
2
|
+
import { collectionFromJSON } from "../utils/converters"
|
|
2
3
|
import {
|
|
3
4
|
getContractPath,
|
|
4
5
|
getListNFTsByAccountPath,
|
|
5
6
|
getListNFTsByCollectionPath,
|
|
6
7
|
getListNFTsByContractPath,
|
|
8
|
+
getNFTCollectionPath,
|
|
9
|
+
getNFTMetadataPath,
|
|
7
10
|
getNFTPath,
|
|
8
11
|
getRefreshMetadataPath,
|
|
9
12
|
getValidateMetadataPath,
|
|
10
13
|
} from "./apiPaths"
|
|
11
14
|
import type { Fetcher } from "./fetcher"
|
|
12
15
|
import type {
|
|
16
|
+
GetCollectionResponse,
|
|
13
17
|
GetContractResponse,
|
|
18
|
+
GetNFTMetadataResponse,
|
|
14
19
|
GetNFTResponse,
|
|
15
20
|
ListNFTsResponse,
|
|
16
21
|
ValidateMetadataResponse,
|
|
@@ -141,4 +146,35 @@ export class NFTsAPI {
|
|
|
141
146
|
const response = await this.fetcher.post<ValidateMetadataResponse>(path)
|
|
142
147
|
return response
|
|
143
148
|
}
|
|
149
|
+
|
|
150
|
+
/**
|
|
151
|
+
* Get the collection that an NFT belongs to.
|
|
152
|
+
* Useful for multi-contract collections where the token ID disambiguates
|
|
153
|
+
* which collection the NFT belongs to.
|
|
154
|
+
*/
|
|
155
|
+
async getNFTCollection(
|
|
156
|
+
address: string,
|
|
157
|
+
identifier: string,
|
|
158
|
+
chain: Chain = this.chain,
|
|
159
|
+
): Promise<OpenSeaCollection> {
|
|
160
|
+
const response = await this.fetcher.get<GetCollectionResponse>(
|
|
161
|
+
getNFTCollectionPath(chain, address, identifier),
|
|
162
|
+
)
|
|
163
|
+
return collectionFromJSON(response)
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* Get detailed metadata for an NFT including name, description, image, traits,
|
|
168
|
+
* and external links.
|
|
169
|
+
*/
|
|
170
|
+
async getNFTMetadata(
|
|
171
|
+
address: string,
|
|
172
|
+
tokenId: string,
|
|
173
|
+
chain: Chain = this.chain,
|
|
174
|
+
): Promise<GetNFTMetadataResponse> {
|
|
175
|
+
const response = await this.fetcher.get<GetNFTMetadataResponse>(
|
|
176
|
+
getNFTMetadataPath(chain, address, tokenId),
|
|
177
|
+
)
|
|
178
|
+
return response
|
|
179
|
+
}
|
|
144
180
|
}
|
package/src/api/tokens.ts
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import {
|
|
2
2
|
getSwapQuotePath,
|
|
3
|
+
getTokenGroupPath,
|
|
4
|
+
getTokenGroupsPath,
|
|
3
5
|
getTokenPath,
|
|
4
6
|
getTopTokensPath,
|
|
5
7
|
getTrendingTokensPath,
|
|
@@ -8,6 +10,9 @@ import type { Fetcher } from "./fetcher"
|
|
|
8
10
|
import type {
|
|
9
11
|
GetSwapQuoteArgs,
|
|
10
12
|
GetSwapQuoteResponse,
|
|
13
|
+
GetTokenGroupResponse,
|
|
14
|
+
GetTokenGroupsArgs,
|
|
15
|
+
GetTokenGroupsResponse,
|
|
11
16
|
GetTokenResponse,
|
|
12
17
|
GetTokensArgs,
|
|
13
18
|
GetTopTokensResponse,
|
|
@@ -64,4 +69,20 @@ export class TokensAPI {
|
|
|
64
69
|
)
|
|
65
70
|
return response
|
|
66
71
|
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Gets a paginated list of token groups (equivalent currencies across chains).
|
|
75
|
+
*/
|
|
76
|
+
async getTokenGroups(
|
|
77
|
+
args?: GetTokenGroupsArgs,
|
|
78
|
+
): Promise<GetTokenGroupsResponse> {
|
|
79
|
+
return this.fetcher.get<GetTokenGroupsResponse>(getTokenGroupsPath(), args)
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Gets a single token group by its slug.
|
|
84
|
+
*/
|
|
85
|
+
async getTokenGroup(slug: string): Promise<GetTokenGroupResponse> {
|
|
86
|
+
return this.fetcher.get<GetTokenGroupResponse>(getTokenGroupPath(slug))
|
|
87
|
+
}
|
|
67
88
|
}
|
package/src/api/types.ts
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
AssetMetadataResponse,
|
|
3
|
+
InstantApiKeyResponse,
|
|
4
|
+
TokenGroupPaginatedResponse,
|
|
5
|
+
TokenGroupResponse,
|
|
6
|
+
} from "@opensea/api-types"
|
|
1
7
|
import type { ConsiderationItem } from "@opensea/seaport-js/lib/types"
|
|
2
8
|
import type {
|
|
3
9
|
OrderType,
|
|
@@ -801,6 +807,35 @@ export type GetSwapQuoteResponse = {
|
|
|
801
807
|
*/
|
|
802
808
|
export type GetTokenResponse = Token
|
|
803
809
|
|
|
810
|
+
/**
|
|
811
|
+
* Response from OpenSea API for fetching a token group by slug.
|
|
812
|
+
* @category API Response Types
|
|
813
|
+
*/
|
|
814
|
+
export type GetTokenGroupResponse = TokenGroupResponse
|
|
815
|
+
|
|
816
|
+
/**
|
|
817
|
+
* Response from OpenSea API for fetching a paginated list of token groups.
|
|
818
|
+
* @category API Response Types
|
|
819
|
+
*/
|
|
820
|
+
export type GetTokenGroupsResponse = TokenGroupPaginatedResponse
|
|
821
|
+
|
|
822
|
+
/**
|
|
823
|
+
* Query args for the Get Token Groups endpoint.
|
|
824
|
+
* @category API Query Args
|
|
825
|
+
*/
|
|
826
|
+
export interface GetTokenGroupsArgs {
|
|
827
|
+
/** Number of results to return (default: 50, max: 100) */
|
|
828
|
+
limit?: number
|
|
829
|
+
/** Cursor for pagination */
|
|
830
|
+
cursor?: string
|
|
831
|
+
}
|
|
832
|
+
|
|
833
|
+
/**
|
|
834
|
+
* Response from OpenSea API for requesting an instant API key.
|
|
835
|
+
* @category API Response Types
|
|
836
|
+
*/
|
|
837
|
+
export type RequestInstantApiKeyResponse = InstantApiKeyResponse
|
|
838
|
+
|
|
804
839
|
/**
|
|
805
840
|
* Query args for the Search endpoint.
|
|
806
841
|
* @category API Query Args
|
|
@@ -1208,3 +1243,10 @@ export type ValidateMetadataResponse = {
|
|
|
1208
1243
|
statusCode?: number
|
|
1209
1244
|
}
|
|
1210
1245
|
}
|
|
1246
|
+
|
|
1247
|
+
/**
|
|
1248
|
+
* Response from OpenSea API for fetching raw NFT metadata.
|
|
1249
|
+
* Derived from the generated OpenAPI spec type to stay in sync automatically.
|
|
1250
|
+
* @category API Response Types
|
|
1251
|
+
*/
|
|
1252
|
+
export type GetNFTMetadataResponse = AssetMetadataResponse
|
package/src/index.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { OpenSeaAPI } from "./api/api"
|
|
1
2
|
import { OpenSeaSDK } from "./sdk"
|
|
2
3
|
|
|
3
4
|
export * from "./api/types"
|
|
@@ -25,6 +26,9 @@ export * from "./utils"
|
|
|
25
26
|
* ```
|
|
26
27
|
*/
|
|
27
28
|
export {
|
|
29
|
+
// API client (for direct use or accessing static helpers like
|
|
30
|
+
// `OpenSeaAPI.requestInstantApiKey()`)
|
|
31
|
+
OpenSeaAPI,
|
|
28
32
|
// Main SDK export
|
|
29
33
|
OpenSeaSDK,
|
|
30
34
|
}
|
package/src/sdk/base.ts
CHANGED
|
@@ -2,8 +2,14 @@ import EventEmitter = require("node:events")
|
|
|
2
2
|
|
|
3
3
|
import type { Seaport } from "@opensea/seaport-js"
|
|
4
4
|
import type { OrderComponents } from "@opensea/seaport-js/lib/types"
|
|
5
|
-
import
|
|
6
|
-
import type {
|
|
5
|
+
import { OpenSeaAPI } from "../api/api"
|
|
6
|
+
import type {
|
|
7
|
+
CollectionOffer,
|
|
8
|
+
Listing,
|
|
9
|
+
Offer,
|
|
10
|
+
Order,
|
|
11
|
+
RequestInstantApiKeyResponse,
|
|
12
|
+
} from "../api/types"
|
|
7
13
|
import { ZERO_ADDRESS } from "../constants"
|
|
8
14
|
import type { OrderV2 } from "../orders/types"
|
|
9
15
|
import type { ContractCaller, OpenSeaWallet } from "../provider/types"
|
|
@@ -103,6 +109,25 @@ export class BaseOpenSeaSDK {
|
|
|
103
109
|
)
|
|
104
110
|
}
|
|
105
111
|
|
|
112
|
+
/**
|
|
113
|
+
* Request a free-tier OpenSea API key without authentication. The returned
|
|
114
|
+
* key can be passed as `apiKey` into the SDK constructor to bootstrap usage.
|
|
115
|
+
* Rate limited to 3 keys per hour per IP; keys expire after 30 days.
|
|
116
|
+
*
|
|
117
|
+
* @example
|
|
118
|
+
* ```ts
|
|
119
|
+
* const { api_key } = await OpenSeaSDK.requestInstantApiKey()
|
|
120
|
+
* const sdk = new OpenSeaSDK(provider, { apiKey: api_key })
|
|
121
|
+
* ```
|
|
122
|
+
*
|
|
123
|
+
* @param apiBaseUrl Optional base URL override (defaults to mainnet).
|
|
124
|
+
*/
|
|
125
|
+
public static async requestInstantApiKey(
|
|
126
|
+
apiBaseUrl?: string,
|
|
127
|
+
): Promise<RequestInstantApiKeyResponse> {
|
|
128
|
+
return OpenSeaAPI.requestInstantApiKey(apiBaseUrl)
|
|
129
|
+
}
|
|
130
|
+
|
|
106
131
|
// ─── Event Listeners ───────────────────────────────────────────────
|
|
107
132
|
|
|
108
133
|
/**
|
|
@@ -316,6 +341,25 @@ export class BaseOpenSeaSDK {
|
|
|
316
341
|
return this._fulfillmentManager.fulfillOrder(options)
|
|
317
342
|
}
|
|
318
343
|
|
|
344
|
+
/**
|
|
345
|
+
* Fulfill a private listing directly using Seaport's matchOrders.
|
|
346
|
+
* The order must have a taker address set (i.e., it is a private listing).
|
|
347
|
+
* @param options
|
|
348
|
+
* @param options.order The private listing order to fulfill. Must have a taker address.
|
|
349
|
+
* @param options.accountAddress Address of the wallet fulfilling the order.
|
|
350
|
+
* @param options.domain Optional domain for onchain attribution.
|
|
351
|
+
* @param options.overrides Transaction overrides (gasLimit, maxFeePerGas, etc.).
|
|
352
|
+
* @returns Transaction hash of the fulfillment.
|
|
353
|
+
*/
|
|
354
|
+
public async fulfillPrivateOrder(options: {
|
|
355
|
+
order: OrderV2
|
|
356
|
+
accountAddress: string
|
|
357
|
+
domain?: string
|
|
358
|
+
overrides?: Record<string, unknown>
|
|
359
|
+
}): Promise<string> {
|
|
360
|
+
return this._fulfillmentManager.fulfillPrivateOrder(options)
|
|
361
|
+
}
|
|
362
|
+
|
|
319
363
|
/** Returns whether an order is fulfillable. */
|
|
320
364
|
public async isOrderFulfillable(options: {
|
|
321
365
|
order: OrderV2
|