@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/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
- var siwx_1 = require("./siwx");
6
- Object.defineProperty(exports, "chainArchToAccountType", { enumerable: true, get: function () { return siwx_1.chainArchToAccountType; } });
7
- Object.defineProperty(exports, "createSiwxMessage", { enumerable: true, get: function () { return siwx_1.createSiwxMessage; } });
8
- Object.defineProperty(exports, "linkWalletWithSiwx", { enumerable: true, get: function () { return siwx_1.linkWalletWithSiwx; } });
9
- Object.defineProperty(exports, "parseSiwxMessage", { enumerable: true, get: function () { return siwx_1.parseSiwxMessage; } });
10
- Object.defineProperty(exports, "requestSiwxNonce", { enumerable: true, get: function () { return siwx_1.requestSiwxNonce; } });
11
- const DEFAULT_AUTH_BASE_URL = "https://auth.opensea.io";
12
- /** Buffer (in ms) before expiry at which auto-refresh triggers. */
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
- * Handles the full sign-in flow: nonce request, EIP-4361 message generation,
18
- * signature exchange, token caching, and automatic refresh.
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
- authBaseUrl;
41
+ apiBaseUrl;
40
42
  cachedToken;
43
+ scopedTokenId;
44
+ sessionCookies;
41
45
  constructor(config = {}) {
42
- this.authBaseUrl = (config.authBaseUrl ?? DEFAULT_AUTH_BASE_URL).replace(/\/$/, "");
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
- const message = generateSiweMessage(address, options.scopes ?? [], nonce, this.authBaseUrl);
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 tokenResponse = await this.exchangeSignature(message, signature);
60
- const token = toAuthToken(tokenResponse);
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 tokenResponse = await this.refreshToken(this.cachedToken.refreshToken);
76
- this.cachedToken = toAuthToken(tokenResponse);
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
- const response = await fetch(`${this.authBaseUrl}/api/revoke`, {
85
- method: "POST",
86
- headers: { "Content-Type": "application/json" },
87
- body: JSON.stringify({ token: accessToken }),
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 nonce from the auth server. */
109
+ /** Request a single-use SIWE nonce. */
97
110
  async requestNonce() {
98
- const response = await fetch(`${this.authBaseUrl}/api/nonce`, {
99
- method: "GET",
111
+ const response = await fetch(`${this.apiBaseUrl}/api/v2/auth/siwe/nonce`, {
112
+ method: "POST",
100
113
  headers: { Accept: "application/json" },
101
114
  });
102
- if (!response.ok) {
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
- /** Exchange a signed SIWE message for a JWT token. */
108
- async exchangeSignature(message, signature) {
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({ message, signature }),
122
+ body: JSON.stringify({
123
+ message: (0, siwx_1.parseSiwxMessage)(message),
124
+ signature,
125
+ chainArch: "EVM",
126
+ }),
113
127
  });
114
- if (!response.ok) {
115
- throw new Error(`Auth server error (${response.status}): ${response.statusText}`);
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
- /** Refresh an access token using a refresh token. */
120
- async refreshToken(refreshTokenValue) {
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({ refresh_token: refreshTokenValue }),
148
+ body: JSON.stringify({
149
+ subjectToken: scopedToken,
150
+ subjectTokenType: "ACCESS_TOKEN",
151
+ }),
125
152
  });
126
- if (!response.ok) {
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 an EIP-4361 (SIWE) message for OpenSea authentication.
137
- *
138
- * @see https://eips.ethereum.org/EIPS/eip-4361
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, scopes, nonce, authBaseUrl, chainId = 1) {
141
- const url = new URL(authBaseUrl);
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
- "Sign in to OpenSea",
155
- "",
156
- `URI: ${uri}`,
157
- "Version: 1",
158
- `Chain ID: ${chainId}`,
159
- `Nonce: ${nonce}`,
160
- `Issued At: ${issuedAt}`,
161
- `Expiration Time: ${expirationTime}`,
162
- ...(resources ? [resources] : []),
163
- ].join("\n");
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
- /** Convert a raw auth server response to a typed AuthToken. */
166
- function toAuthToken(response) {
240
+ function toAuthToken(exchange, scopedToken) {
167
241
  return {
168
- accessToken: response.access_token,
169
- refreshToken: response.refresh_token,
170
- expiresAt: new Date(Date.now() + response.expires_in * 1000),
171
- scopes: response.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
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"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"}
@@ -4,7 +4,7 @@
4
4
  export interface AuthToken {
5
5
  /** JWT access token */
6
6
  accessToken: string;
7
- /** Refresh token for obtaining a new access token */
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
- /** Auth server base URL. Defaults to `https://auth.opensea.io`. */
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
- * Raw token response from the auth server `/api/token` and `/api/refresh` endpoints.
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
- * Nonce response from the auth server `/api/nonce` endpoint.
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.4.8",
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.1",
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).
@@ -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 |