@opensea/sdk 11.4.8 → 11.5.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 +25 -16
- package/lib/api/api.d.ts +6 -1
- package/lib/api/api.js +7 -0
- package/lib/api/api.js.map +1 -1
- package/lib/api/apiPaths.d.ts +1 -0
- package/lib/api/apiPaths.js +5 -1
- package/lib/api/apiPaths.js.map +1 -1
- package/lib/api/tokens.d.ts +6 -1
- package/lib/api/tokens.js +7 -0
- package/lib/api/tokens.js.map +1 -1
- package/lib/api/types.d.ts +94 -107
- package/lib/api/types.js.map +1 -1
- package/lib/api/walletAuth.d.ts +80 -0
- package/lib/api/walletAuth.js +38 -0
- package/lib/api/walletAuth.js.map +1 -1
- package/lib/auth/index.d.ts +21 -36
- package/lib/auth/index.js +179 -105
- package/lib/auth/index.js.map +1 -1
- package/lib/auth/types.d.ts +7 -4
- package/lib/scopes.d.ts +2 -0
- package/lib/scopes.js +2 -0
- package/lib/scopes.js.map +1 -1
- package/package.json +2 -2
- package/src/api/api.ts +13 -0
- package/src/api/apiPaths.ts +4 -0
- package/src/api/tokens.ts +17 -0
- package/src/api/types.ts +129 -109
- package/src/api/walletAuth.ts +84 -0
- package/src/auth/index.ts +218 -123
- package/src/auth/types.ts +7 -4
- package/src/scopes.ts +2 -0
package/lib/auth/index.js
CHANGED
|
@@ -2,20 +2,26 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.OpenSeaAuth = exports.requestSiwxNonce = exports.parseSiwxMessage = exports.linkWalletWithSiwx = exports.createSiwxMessage = exports.chainArchToAccountType = void 0;
|
|
4
4
|
exports.generateSiweMessage = generateSiweMessage;
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
Object.defineProperty(exports, "
|
|
8
|
-
Object.defineProperty(exports, "
|
|
9
|
-
Object.defineProperty(exports, "
|
|
10
|
-
Object.defineProperty(exports, "
|
|
11
|
-
|
|
12
|
-
|
|
5
|
+
const siwx_1 = require("./siwx");
|
|
6
|
+
var siwx_2 = require("./siwx");
|
|
7
|
+
Object.defineProperty(exports, "chainArchToAccountType", { enumerable: true, get: function () { return siwx_2.chainArchToAccountType; } });
|
|
8
|
+
Object.defineProperty(exports, "createSiwxMessage", { enumerable: true, get: function () { return siwx_2.createSiwxMessage; } });
|
|
9
|
+
Object.defineProperty(exports, "linkWalletWithSiwx", { enumerable: true, get: function () { return siwx_2.linkWalletWithSiwx; } });
|
|
10
|
+
Object.defineProperty(exports, "parseSiwxMessage", { enumerable: true, get: function () { return siwx_2.parseSiwxMessage; } });
|
|
11
|
+
Object.defineProperty(exports, "requestSiwxNonce", { enumerable: true, get: function () { return siwx_2.requestSiwxNonce; } });
|
|
12
|
+
const DEFAULT_API_BASE_URL = "https://api.opensea.io";
|
|
13
|
+
const DEFAULT_TOKEN_TTL_SECONDS = 3600;
|
|
14
|
+
const SCOPED_TOKEN_CLEANUP_ATTEMPTS = 2;
|
|
13
15
|
const REFRESH_BUFFER_MS = 60_000;
|
|
16
|
+
const SIWE_STATEMENT = "Click to sign in and accept the OpenSea Terms of Service (https://opensea.io/tos) and Privacy Policy (https://opensea.io/privacy).";
|
|
17
|
+
const SESSION_COOKIE_NAMES = ["access_token", "refresh_token"];
|
|
14
18
|
/**
|
|
15
19
|
* SIWE-based authentication helper for OpenSea.
|
|
16
20
|
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
21
|
+
* Establishes a browser-style wallet session, creates a one-day scoped token,
|
|
22
|
+
* and exchanges that token for the short-lived JWT used by REST and MCP. Token
|
|
23
|
+
* management remains bound to the wallet session, while automatic JWT refresh
|
|
24
|
+
* uses the scoped token.
|
|
19
25
|
*
|
|
20
26
|
* @example
|
|
21
27
|
* ```ts
|
|
@@ -25,150 +31,218 @@ const REFRESH_BUFFER_MS = 60_000;
|
|
|
25
31
|
* const token = await auth.authenticate(signer, {
|
|
26
32
|
* scopes: ["read:eligibility", "write:orders"],
|
|
27
33
|
* })
|
|
28
|
-
*
|
|
29
|
-
* // Auto-refresh before expiry
|
|
30
34
|
* const freshToken = await auth.getValidToken()
|
|
31
|
-
*
|
|
32
|
-
* // Revoke
|
|
33
|
-
* await auth.revoke(token.accessToken)
|
|
35
|
+
* await auth.revoke(freshToken.accessToken)
|
|
34
36
|
* ```
|
|
35
37
|
*
|
|
36
38
|
* @category Authentication
|
|
37
39
|
*/
|
|
38
40
|
class OpenSeaAuth {
|
|
39
|
-
|
|
41
|
+
apiBaseUrl;
|
|
40
42
|
cachedToken;
|
|
43
|
+
scopedTokenId;
|
|
44
|
+
sessionCookies;
|
|
41
45
|
constructor(config = {}) {
|
|
42
|
-
this.
|
|
46
|
+
this.apiBaseUrl = (config.apiBaseUrl ??
|
|
47
|
+
config.authBaseUrl ??
|
|
48
|
+
DEFAULT_API_BASE_URL).replace(/\/$/, "");
|
|
43
49
|
}
|
|
44
|
-
/**
|
|
45
|
-
* Run the full SIWE authentication flow:
|
|
46
|
-
* 1. Request a nonce from the auth server
|
|
47
|
-
* 2. Build an EIP-4361 SIWE message
|
|
48
|
-
* 3. Sign it with the provided signer
|
|
49
|
-
* 4. Exchange the signature for a scoped JWT token
|
|
50
|
-
*
|
|
51
|
-
* The returned token is cached in memory and will be auto-refreshed
|
|
52
|
-
* by {@link getValidToken}.
|
|
53
|
-
*/
|
|
50
|
+
/** Run the current SIWE, scoped-token creation, and token-exchange flow. */
|
|
54
51
|
async authenticate(signer, options = {}) {
|
|
52
|
+
const scopes = options.scopes ?? [];
|
|
55
53
|
const address = await signer.getAddress();
|
|
56
54
|
const { nonce } = await this.requestNonce();
|
|
57
|
-
|
|
55
|
+
// Webauth uses SIWE only to establish the wallet session. Including PAT
|
|
56
|
+
// scopes here does not round-trip through its signature reconstruction;
|
|
57
|
+
// scope entitlement is enforced by the session-authorized token request.
|
|
58
|
+
const message = generateSiweMessage(address, [], nonce, this.apiBaseUrl);
|
|
58
59
|
const signature = await signer.signMessage(message);
|
|
59
|
-
const
|
|
60
|
-
const
|
|
60
|
+
const cookie = await this.verifySignature(message, signature);
|
|
61
|
+
const scopedToken = await this.createScopedToken(cookie, scopes);
|
|
62
|
+
let exchange;
|
|
63
|
+
try {
|
|
64
|
+
exchange = await this.exchangeScopedToken(scopedToken.token);
|
|
65
|
+
}
|
|
66
|
+
catch (error) {
|
|
67
|
+
await this.cleanupScopedToken(cookie, scopedToken.id);
|
|
68
|
+
throw error;
|
|
69
|
+
}
|
|
70
|
+
const token = toAuthToken(exchange, scopedToken);
|
|
61
71
|
this.cachedToken = token;
|
|
72
|
+
this.scopedTokenId = scopedToken.id;
|
|
73
|
+
this.sessionCookies = cookie;
|
|
62
74
|
return token;
|
|
63
75
|
}
|
|
64
|
-
/**
|
|
65
|
-
* Return a valid access token, refreshing automatically if the cached
|
|
66
|
-
* token is expired or about to expire.
|
|
67
|
-
*
|
|
68
|
-
* @throws If no token has been obtained yet via {@link authenticate}.
|
|
69
|
-
*/
|
|
76
|
+
/** Return a valid JWT, exchanging the stored scoped token when needed. */
|
|
70
77
|
async getValidToken() {
|
|
71
78
|
if (!this.cachedToken) {
|
|
72
79
|
throw new Error("No auth token available. Call authenticate() with a signer first.");
|
|
73
80
|
}
|
|
74
81
|
if (this.cachedToken.expiresAt.getTime() - Date.now() < REFRESH_BUFFER_MS) {
|
|
75
|
-
const
|
|
76
|
-
this.cachedToken = toAuthToken(
|
|
82
|
+
const exchange = await this.exchangeScopedToken(this.cachedToken.refreshToken);
|
|
83
|
+
this.cachedToken = toAuthToken(exchange, {
|
|
84
|
+
id: this.scopedTokenId ?? "",
|
|
85
|
+
token: this.cachedToken.refreshToken,
|
|
86
|
+
scopes: this.cachedToken.scopes,
|
|
87
|
+
});
|
|
77
88
|
}
|
|
78
89
|
return this.cachedToken;
|
|
79
90
|
}
|
|
80
|
-
/**
|
|
81
|
-
* Revoke an access token.
|
|
82
|
-
*/
|
|
91
|
+
/** Revoke the scoped token backing the current JWT. */
|
|
83
92
|
async revoke(accessToken) {
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
if (!response.ok) {
|
|
90
|
-
throw new Error(`Auth server error (${response.status}): ${response.statusText}`);
|
|
91
|
-
}
|
|
92
|
-
if (this.cachedToken?.accessToken === accessToken) {
|
|
93
|
-
this.cachedToken = undefined;
|
|
93
|
+
if (!this.cachedToken ||
|
|
94
|
+
!this.scopedTokenId ||
|
|
95
|
+
!this.sessionCookies ||
|
|
96
|
+
this.cachedToken.accessToken !== accessToken) {
|
|
97
|
+
throw new Error("The access token is not managed by this OpenSeaAuth instance");
|
|
94
98
|
}
|
|
99
|
+
const refreshedCookies = await this.refreshSession(this.sessionCookies);
|
|
100
|
+
// The refresh token rotates, so retain the replacement if DELETE needs a
|
|
101
|
+
// retry after a transient failure.
|
|
102
|
+
this.sessionCookies = refreshedCookies;
|
|
103
|
+
const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/tokens/${this.scopedTokenId}`, { method: "DELETE", headers: { Cookie: refreshedCookies } });
|
|
104
|
+
await requireOk(response, "Scoped token revocation");
|
|
105
|
+
this.cachedToken = undefined;
|
|
106
|
+
this.scopedTokenId = undefined;
|
|
107
|
+
this.sessionCookies = undefined;
|
|
95
108
|
}
|
|
96
|
-
/** Request a
|
|
109
|
+
/** Request a single-use SIWE nonce. */
|
|
97
110
|
async requestNonce() {
|
|
98
|
-
const response = await fetch(`${this.
|
|
99
|
-
method: "
|
|
111
|
+
const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/siwe/nonce`, {
|
|
112
|
+
method: "POST",
|
|
100
113
|
headers: { Accept: "application/json" },
|
|
101
114
|
});
|
|
102
|
-
|
|
103
|
-
throw new Error(`Auth server error (${response.status}): ${response.statusText}`);
|
|
104
|
-
}
|
|
115
|
+
await requireOk(response, "Nonce request");
|
|
105
116
|
return response.json();
|
|
106
117
|
}
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
const response = await fetch(`${this.authBaseUrl}/api/token`, {
|
|
118
|
+
async verifySignature(message, signature) {
|
|
119
|
+
const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/siwe/verify`, {
|
|
110
120
|
method: "POST",
|
|
111
121
|
headers: { "Content-Type": "application/json" },
|
|
112
|
-
body: JSON.stringify({
|
|
122
|
+
body: JSON.stringify({
|
|
123
|
+
message: (0, siwx_1.parseSiwxMessage)(message),
|
|
124
|
+
signature,
|
|
125
|
+
chainArch: "EVM",
|
|
126
|
+
}),
|
|
113
127
|
});
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
128
|
+
await requireOk(response, "SIWE verification");
|
|
129
|
+
return extractSessionCookies(response.headers);
|
|
130
|
+
}
|
|
131
|
+
async createScopedToken(cookie, scopes) {
|
|
132
|
+
const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/tokens`, {
|
|
133
|
+
method: "POST",
|
|
134
|
+
headers: { "Content-Type": "application/json", Cookie: cookie },
|
|
135
|
+
body: JSON.stringify({
|
|
136
|
+
label: `opensea-sdk-${Date.now()}`,
|
|
137
|
+
scopes,
|
|
138
|
+
expiresInDays: 1,
|
|
139
|
+
}),
|
|
140
|
+
});
|
|
141
|
+
await requireOk(response, "Scoped token creation");
|
|
117
142
|
return response.json();
|
|
118
143
|
}
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
const response = await fetch(`${this.authBaseUrl}/api/refresh`, {
|
|
144
|
+
async exchangeScopedToken(scopedToken) {
|
|
145
|
+
const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/tokens/exchange`, {
|
|
122
146
|
method: "POST",
|
|
123
147
|
headers: { "Content-Type": "application/json" },
|
|
124
|
-
body: JSON.stringify({
|
|
148
|
+
body: JSON.stringify({
|
|
149
|
+
subjectToken: scopedToken,
|
|
150
|
+
subjectTokenType: "ACCESS_TOKEN",
|
|
151
|
+
}),
|
|
125
152
|
});
|
|
126
|
-
|
|
127
|
-
throw new Error(`Auth server error (${response.status}): ${response.statusText}`);
|
|
128
|
-
}
|
|
153
|
+
await requireOk(response, "Token exchange");
|
|
129
154
|
return response.json();
|
|
130
155
|
}
|
|
156
|
+
async cleanupScopedToken(cookie, id) {
|
|
157
|
+
for (let attempt = 0; attempt < SCOPED_TOKEN_CLEANUP_ATTEMPTS; attempt++) {
|
|
158
|
+
try {
|
|
159
|
+
const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/tokens/${id}`, { method: "DELETE", headers: { Cookie: cookie } });
|
|
160
|
+
if (response.ok || response.status === 404)
|
|
161
|
+
return;
|
|
162
|
+
}
|
|
163
|
+
catch {
|
|
164
|
+
// Retry once, then preserve the original exchange failure.
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
async refreshSession(cookie) {
|
|
169
|
+
const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/session/refresh`, { method: "POST", headers: { Cookie: cookie } });
|
|
170
|
+
await requireOk(response, "Session refresh");
|
|
171
|
+
return extractSessionCookies(response.headers);
|
|
172
|
+
}
|
|
131
173
|
}
|
|
132
174
|
exports.OpenSeaAuth = OpenSeaAuth;
|
|
133
|
-
/** Validity window (in ms) for a generated SIWE message. */
|
|
134
|
-
const SIWE_MESSAGE_VALIDITY_MS = 10 * 60_000;
|
|
135
175
|
/**
|
|
136
|
-
* Build
|
|
137
|
-
*
|
|
138
|
-
*
|
|
176
|
+
* Build the SIWE message accepted by the current OpenSea wallet-auth API.
|
|
177
|
+
* The scopes argument remains for compatibility; webauth authorizes PAT scopes
|
|
178
|
+
* on token creation and does not accept them in this session proof.
|
|
139
179
|
*/
|
|
140
|
-
function generateSiweMessage(address,
|
|
141
|
-
|
|
142
|
-
const domain = url.host;
|
|
143
|
-
const uri = `${authBaseUrl}/api/token`;
|
|
144
|
-
const now = Date.now();
|
|
145
|
-
const issuedAt = new Date(now).toISOString();
|
|
146
|
-
const expirationTime = new Date(now + SIWE_MESSAGE_VALIDITY_MS).toISOString();
|
|
147
|
-
const resources = scopes.length > 0
|
|
148
|
-
? `\nResources:${scopes.map(s => `\n- ${s}`).join("")}`
|
|
149
|
-
: "";
|
|
150
|
-
return [
|
|
151
|
-
`${domain} wants you to sign in with your Ethereum account:`,
|
|
180
|
+
function generateSiweMessage(address, _scopes, nonce, _apiBaseUrl, chainId = 1) {
|
|
181
|
+
return (0, siwx_1.createSiwxMessage)({
|
|
152
182
|
address,
|
|
153
|
-
"",
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
183
|
+
chainArch: "EVM",
|
|
184
|
+
chainId,
|
|
185
|
+
nonce,
|
|
186
|
+
statement: SIWE_STATEMENT,
|
|
187
|
+
issuedAt: new Date(),
|
|
188
|
+
});
|
|
189
|
+
}
|
|
190
|
+
async function requireOk(response, operation) {
|
|
191
|
+
if (response.ok)
|
|
192
|
+
return;
|
|
193
|
+
const body = await response.text().catch(() => "");
|
|
194
|
+
throw new Error(`${operation} failed (${response.status}): ${body}`);
|
|
195
|
+
}
|
|
196
|
+
function splitSetCookieHeader(header) {
|
|
197
|
+
const segments = header.split(", ");
|
|
198
|
+
const cookies = [];
|
|
199
|
+
let current = "";
|
|
200
|
+
for (const segment of segments) {
|
|
201
|
+
const trimmed = segment.trim();
|
|
202
|
+
const equals = trimmed.indexOf("=");
|
|
203
|
+
const name = equals > 0 ? trimmed.slice(0, equals).trim() : "";
|
|
204
|
+
if (SESSION_COOKIE_NAMES.includes(name) && current) {
|
|
205
|
+
cookies.push(current);
|
|
206
|
+
current = trimmed;
|
|
207
|
+
}
|
|
208
|
+
else if (SESSION_COOKIE_NAMES.includes(name)) {
|
|
209
|
+
current = trimmed;
|
|
210
|
+
}
|
|
211
|
+
else {
|
|
212
|
+
current = current ? `${current}, ${trimmed}` : trimmed;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
if (current)
|
|
216
|
+
cookies.push(current);
|
|
217
|
+
return cookies;
|
|
218
|
+
}
|
|
219
|
+
function extractSessionCookies(headers) {
|
|
220
|
+
const getSetCookie = headers
|
|
221
|
+
.getSetCookie;
|
|
222
|
+
const raw = getSetCookie?.call(headers) ??
|
|
223
|
+
splitSetCookieHeader(headers.get("set-cookie") ?? "");
|
|
224
|
+
const cookies = new Map();
|
|
225
|
+
for (const cookie of raw) {
|
|
226
|
+
const pair = cookie.split(";")[0];
|
|
227
|
+
const equals = pair.indexOf("=");
|
|
228
|
+
if (equals < 0)
|
|
229
|
+
continue;
|
|
230
|
+
const name = pair.slice(0, equals).trim();
|
|
231
|
+
if (SESSION_COOKIE_NAMES.includes(name)) {
|
|
232
|
+
cookies.set(name, pair.slice(equals + 1).trim());
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
if (!cookies.has("access_token") || !cookies.has("refresh_token")) {
|
|
236
|
+
throw new Error("SIWE verification did not create a session");
|
|
237
|
+
}
|
|
238
|
+
return [...cookies].map(([name, value]) => `${name}=${value}`).join("; ");
|
|
164
239
|
}
|
|
165
|
-
|
|
166
|
-
function toAuthToken(response) {
|
|
240
|
+
function toAuthToken(exchange, scopedToken) {
|
|
167
241
|
return {
|
|
168
|
-
accessToken:
|
|
169
|
-
refreshToken:
|
|
170
|
-
expiresAt: new Date(Date.now() +
|
|
171
|
-
scopes:
|
|
242
|
+
accessToken: exchange.accessToken,
|
|
243
|
+
refreshToken: scopedToken.token,
|
|
244
|
+
expiresAt: new Date(Date.now() + (exchange.expiresIn ?? DEFAULT_TOKEN_TTL_SECONDS) * 1000),
|
|
245
|
+
scopes: exchange.tokenScopes ?? scopedToken.scopes,
|
|
172
246
|
};
|
|
173
247
|
}
|
|
174
248
|
//# sourceMappingURL=index.js.map
|
package/lib/auth/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"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"}
|
package/lib/auth/types.d.ts
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
export interface AuthToken {
|
|
5
5
|
/** JWT access token */
|
|
6
6
|
accessToken: string;
|
|
7
|
-
/**
|
|
7
|
+
/** Scoped token (PAT) used to exchange for a new access token */
|
|
8
8
|
refreshToken: string;
|
|
9
9
|
/** When the access token expires */
|
|
10
10
|
expiresAt: Date;
|
|
@@ -22,7 +22,9 @@ export interface AuthenticateOptions {
|
|
|
22
22
|
* Configuration for the {@link OpenSeaAuth} class.
|
|
23
23
|
*/
|
|
24
24
|
export interface OpenSeaAuthConfig {
|
|
25
|
-
/**
|
|
25
|
+
/** OpenSea API base URL. Defaults to `https://api.opensea.io`. */
|
|
26
|
+
apiBaseUrl?: string;
|
|
27
|
+
/** @deprecated Use `apiBaseUrl`. */
|
|
26
28
|
authBaseUrl?: string;
|
|
27
29
|
}
|
|
28
30
|
/**
|
|
@@ -34,7 +36,8 @@ export interface AuthSigner {
|
|
|
34
36
|
signMessage(message: string): Promise<string>;
|
|
35
37
|
}
|
|
36
38
|
/**
|
|
37
|
-
*
|
|
39
|
+
* Legacy auth response shape retained for source compatibility.
|
|
40
|
+
* @deprecated The public wallet-auth API now returns scoped-token and exchange responses.
|
|
38
41
|
*/
|
|
39
42
|
export interface AuthTokenResponse {
|
|
40
43
|
access_token: string;
|
|
@@ -43,7 +46,7 @@ export interface AuthTokenResponse {
|
|
|
43
46
|
scopes: string[];
|
|
44
47
|
}
|
|
45
48
|
/**
|
|
46
|
-
*
|
|
49
|
+
* Response from the SIWE nonce endpoint.
|
|
47
50
|
*/
|
|
48
51
|
export interface AuthNonceResponse {
|
|
49
52
|
nonce: string;
|
package/lib/scopes.d.ts
CHANGED
|
@@ -12,8 +12,10 @@ export declare const OPENSEA_SCOPES: {
|
|
|
12
12
|
readonly READ_ELIGIBILITY: "read:eligibility";
|
|
13
13
|
readonly READ_FAVORITES: "read:favorites";
|
|
14
14
|
readonly READ_SOCIAL: "read:social";
|
|
15
|
+
readonly READ_TOOLS: "read:tools";
|
|
15
16
|
readonly WRITE_FAVORITES: "write:favorites";
|
|
16
17
|
readonly WRITE_SOCIAL: "write:social";
|
|
18
|
+
readonly WRITE_TOOLS: "write:tools";
|
|
17
19
|
readonly WRITE_ORDERS: "write:orders";
|
|
18
20
|
readonly WRITE_DROPS: "write:drops";
|
|
19
21
|
readonly WRITE_COLLECTIONS: "write:collections";
|
package/lib/scopes.js
CHANGED
|
@@ -14,8 +14,10 @@ exports.OPENSEA_SCOPES = {
|
|
|
14
14
|
READ_ELIGIBILITY: "read:eligibility",
|
|
15
15
|
READ_FAVORITES: "read:favorites",
|
|
16
16
|
READ_SOCIAL: "read:social",
|
|
17
|
+
READ_TOOLS: "read:tools",
|
|
17
18
|
WRITE_FAVORITES: "write:favorites",
|
|
18
19
|
WRITE_SOCIAL: "write:social",
|
|
20
|
+
WRITE_TOOLS: "write:tools",
|
|
19
21
|
WRITE_ORDERS: "write:orders",
|
|
20
22
|
WRITE_DROPS: "write:drops",
|
|
21
23
|
WRITE_COLLECTIONS: "write:collections",
|
package/lib/scopes.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../src/scopes.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACU,QAAA,cAAc,GAAG;IAC5B,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;CACc,CAAA;AAc9C,MAAM,2BAA2B,GAAgC,IAAI,CAAA;AAErE;;;GAGG;AACU,QAAA,UAAU,GAA4B,MAAM,CAAC,MAAM,CAAC,sBAAc,CAAC,CAAA"}
|
|
1
|
+
{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../src/scopes.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;GAQG;AACU,QAAA,cAAc,GAAG;IAC5B,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;CACc,CAAA;AAc9C,MAAM,2BAA2B,GAAgC,IAAI,CAAA;AAErE;;;GAGG;AACU,QAAA,UAAU,GAA4B,MAAM,CAAC,MAAM,CAAC,sBAAc,CAAC,CAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@opensea/sdk",
|
|
3
|
-
"version": "11.
|
|
3
|
+
"version": "11.5.0",
|
|
4
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",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
"types": "lib/index.d.ts",
|
|
46
46
|
"dependencies": {
|
|
47
47
|
"@noble/hashes": "^2.0.1",
|
|
48
|
-
"@opensea/api-types": "^0.8.
|
|
48
|
+
"@opensea/api-types": "^0.8.2",
|
|
49
49
|
"@opensea/seaport-js": "^4.1.1",
|
|
50
50
|
"ethers": "^6.16.0"
|
|
51
51
|
},
|
package/src/api/api.ts
CHANGED
|
@@ -56,6 +56,8 @@ import {
|
|
|
56
56
|
type DropMintRequest,
|
|
57
57
|
type DropMintResponse,
|
|
58
58
|
type FloorPriceHistoryResponse,
|
|
59
|
+
type GetAccountTokenActivityArgs,
|
|
60
|
+
type GetAccountTokenActivityResponse,
|
|
59
61
|
type GetAccountTokensArgs,
|
|
60
62
|
type GetAccountTokensResponse,
|
|
61
63
|
type GetBestListingResponse,
|
|
@@ -1094,6 +1096,17 @@ export class OpenSeaAPI {
|
|
|
1094
1096
|
return this.tokensAPI.getTokenActivity(chain, address, args)
|
|
1095
1097
|
}
|
|
1096
1098
|
|
|
1099
|
+
/**
|
|
1100
|
+
* Fetch paginated fungible token activity (transfers, swaps, wraps, and
|
|
1101
|
+
* unwraps) for an account across all chains.
|
|
1102
|
+
*/
|
|
1103
|
+
public async getAccountTokenActivity(
|
|
1104
|
+
address: string,
|
|
1105
|
+
args?: GetAccountTokenActivityArgs,
|
|
1106
|
+
): Promise<GetAccountTokenActivityResponse> {
|
|
1107
|
+
return this.tokensAPI.getAccountTokenActivity(address, args)
|
|
1108
|
+
}
|
|
1109
|
+
|
|
1097
1110
|
/**
|
|
1098
1111
|
* Fetch paginated holders for a token, including quantity held, USD value,
|
|
1099
1112
|
* and aggregate distribution health (STRONG | HEALTHY | CONCERNING | BAD).
|
package/src/api/apiPaths.ts
CHANGED
|
@@ -321,6 +321,10 @@ export const getTokenActivityPath = (chain: Chain, address: string) => {
|
|
|
321
321
|
return `${API_V2_PREFIX}/chain/${chain}/token/${address}/activity`
|
|
322
322
|
}
|
|
323
323
|
|
|
324
|
+
export const getAccountTokenActivityPath = (address: string) => {
|
|
325
|
+
return `${API_V2_PREFIX}/account/${address}/token-activity`
|
|
326
|
+
}
|
|
327
|
+
|
|
324
328
|
export const getTokenHoldersPath = (chain: Chain, address: string) => {
|
|
325
329
|
return `${API_V2_PREFIX}/chain/${chain}/token/${address}/holders`
|
|
326
330
|
}
|
package/src/api/tokens.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { Chain } from "../types"
|
|
2
2
|
import {
|
|
3
|
+
getAccountTokenActivityPath,
|
|
3
4
|
getBatchTokensPath,
|
|
4
5
|
getSwapExecutePath,
|
|
5
6
|
getSwapQuotePath,
|
|
@@ -17,6 +18,8 @@ import {
|
|
|
17
18
|
import type { Fetcher } from "./fetcher"
|
|
18
19
|
import type {
|
|
19
20
|
BatchTokensRequest,
|
|
21
|
+
GetAccountTokenActivityArgs,
|
|
22
|
+
GetAccountTokenActivityResponse,
|
|
20
23
|
GetSwapQuoteArgs,
|
|
21
24
|
GetSwapQuoteResponse,
|
|
22
25
|
GetTokenGroupResponse,
|
|
@@ -168,6 +171,20 @@ export class TokensAPI {
|
|
|
168
171
|
)
|
|
169
172
|
}
|
|
170
173
|
|
|
174
|
+
/**
|
|
175
|
+
* Fetch paginated fungible token activity (transfers, swaps, wraps, and
|
|
176
|
+
* unwraps) for an account across all chains.
|
|
177
|
+
*/
|
|
178
|
+
async getAccountTokenActivity(
|
|
179
|
+
address: string,
|
|
180
|
+
args?: GetAccountTokenActivityArgs,
|
|
181
|
+
): Promise<GetAccountTokenActivityResponse> {
|
|
182
|
+
return this.fetcher.get<GetAccountTokenActivityResponse>(
|
|
183
|
+
getAccountTokenActivityPath(address),
|
|
184
|
+
args,
|
|
185
|
+
)
|
|
186
|
+
}
|
|
187
|
+
|
|
171
188
|
/**
|
|
172
189
|
* Fetch paginated holders for a token, including quantity held, USD value,
|
|
173
190
|
* and an aggregate distribution health label (STRONG | HEALTHY |
|