@opensea/sdk 11.9.0 → 12.0.1

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.
Files changed (50) hide show
  1. package/README.md +5 -2
  2. package/lib/api/types.d.ts +20 -64
  3. package/lib/api/types.js.map +1 -1
  4. package/lib/api/walletAuth.d.ts +95 -8
  5. package/lib/api/walletAuth.js +75 -6
  6. package/lib/api/walletAuth.js.map +1 -1
  7. package/lib/orders/attribution.d.ts +18 -0
  8. package/lib/orders/attribution.js +29 -0
  9. package/lib/orders/attribution.js.map +1 -0
  10. package/lib/orders/erc20Fulfillment.js +67 -4
  11. package/lib/orders/erc20Fulfillment.js.map +1 -1
  12. package/lib/orders/types.d.ts +16 -28
  13. package/lib/orders/types.js.map +1 -1
  14. package/lib/provider/seaport-bridge.js +2 -2
  15. package/lib/provider/seaport-bridge.js.map +1 -1
  16. package/lib/provider/viem-adapter.js +3 -3
  17. package/lib/provider/viem-adapter.js.map +1 -1
  18. package/lib/scopes.d.ts +1 -0
  19. package/lib/scopes.js +1 -0
  20. package/lib/scopes.js.map +1 -1
  21. package/lib/sdk/assets.js +8 -0
  22. package/lib/sdk/assets.js.map +1 -1
  23. package/lib/sdk/cancellation.js +6 -1
  24. package/lib/sdk/cancellation.js.map +1 -1
  25. package/lib/sdk/fulfillment.js +7 -3
  26. package/lib/sdk/fulfillment.js.map +1 -1
  27. package/lib/stream/client.d.ts +14 -1
  28. package/lib/stream/client.js +39 -22
  29. package/lib/stream/client.js.map +1 -1
  30. package/lib/stream/types.d.ts +32 -63
  31. package/lib/stream/types.js +7 -0
  32. package/lib/stream/types.js.map +1 -1
  33. package/lib/utils/eip712.d.ts +21 -0
  34. package/lib/utils/eip712.js +54 -0
  35. package/lib/utils/eip712.js.map +1 -0
  36. package/package.json +2 -2
  37. package/src/api/types.ts +27 -64
  38. package/src/api/walletAuth.ts +100 -13
  39. package/src/orders/attribution.ts +29 -0
  40. package/src/orders/erc20Fulfillment.ts +74 -4
  41. package/src/orders/types.ts +21 -44
  42. package/src/provider/seaport-bridge.ts +2 -3
  43. package/src/provider/viem-adapter.ts +3 -4
  44. package/src/scopes.ts +1 -0
  45. package/src/sdk/assets.ts +9 -0
  46. package/src/sdk/cancellation.ts +6 -1
  47. package/src/sdk/fulfillment.ts +8 -3
  48. package/src/stream/client.ts +45 -23
  49. package/src/stream/types.ts +39 -64
  50. package/src/utils/eip712.ts +57 -0
package/README.md CHANGED
@@ -11,6 +11,10 @@
11
11
 
12
12
  # @opensea/sdk <!-- omit in toc -->
13
13
 
14
+ > **Read-only mirror.** This package is developed in a private monorepo and mirrored to [ProjectOpenSea/opensea-sdk](https://github.com/ProjectOpenSea/opensea-sdk) when a version is released, so the public code can trail the internal main branch by weeks.
15
+ >
16
+ > Pull requests opened on the mirror cannot be merged there. They are read, and a fix worth taking is recreated in the monorepo. Because a fix that has landed internally is not public until the next release, filing an issue before writing a patch is the quickest way to find out whether a bug is already fixed.
17
+
14
18
  This is the TypeScript SDK for [OpenSea](https://opensea.io), the largest marketplace for NFTs and tokens.
15
19
 
16
20
  It allows developers to access the official orderbook, filter it, create listings and offers, complete trades programmatically, and swap tokens across chains.
@@ -82,8 +86,7 @@ try {
82
86
  authToken: token.accessToken,
83
87
  })
84
88
  await api.walletAuth.getFavorites(await signer.getAddress(), { limit: 10 })
85
- await api.walletAuth.markWalletAsAgent(await signer.getAddress())
86
- await api.walletAuth.removeWalletAgentDesignation(await signer.getAddress())
89
+ await api.walletAuth.declareAgentAccount()
87
90
  } finally {
88
91
  await auth.revoke(token.accessToken)
89
92
  }
@@ -1,4 +1,4 @@
1
- import type { AccountSearchResponse as ApiAccountSearchResponse, AgentProfileRelationshipsResponse as ApiAgentProfileRelationshipsResponse, BuildOfferResponse as ApiBuildOfferResponse, CancelResponse as ApiCancelResponse, CollectionSearchResponse as ApiCollectionSearchResponse, Listing as ApiListing, Nft as ApiNft, NftSearchResponse as ApiNftSearchResponse, Offer as ApiOffer, Order as ApiOrder, OrderAsset as ApiOrderAsset, Payment as ApiPayment, Price as ApiPrice, SearchResponse as ApiSearchResponse, SearchResultResponse as ApiSearchResultResponse, SvmInstructionAccountResponse as ApiSvmInstructionAccountResponse, SvmInstructionResponse as ApiSvmInstructionResponse, SvmTransactionDetailsResponse as ApiSvmTransactionDetailsResponse, SwapExecuteRequest as ApiSwapExecuteRequest, SwapExecuteResponse as ApiSwapExecuteResponse, SwapQuoteResponse as ApiSwapQuoteResponse, SweepCollectionRequest as ApiSweepCollectionRequest, SweepCollectionResponse as ApiSweepCollectionResponse, TokenDetailedResponse as ApiTokenDetailedResponse, TokenResponse as ApiTokenResponse, TokenSearchResponse as ApiTokenSearchResponse, Trait as ApiTrait, TransactionReceiptRequest as ApiTransactionReceiptRequest, TransactionReceiptResponse as ApiTransactionReceiptResponse, WalletVisibilityResponse as ApiWalletVisibilityResponse, AssetMetadataResponse, ChainResponse, ContractResponse, DropDetailedResponse, DropResponse, DropStageResponse, InstantApiKeyResponse, ListingsResponse, NftDetailed, NftListResponse, NftResponse, OffersResponse, TokenAccountActivityPaginatedResponse, TokenBalancePaginatedResponse, TokenBalanceResponse, TokenGroupPaginatedResponse, TokenGroupResponse, TokenPaginatedResponse } from "@opensea/api-types";
1
+ import type { AccountResolveResponse, AccountSearchResponse as ApiAccountSearchResponse, AgentProfileRelationshipsResponse as ApiAgentProfileRelationshipsResponse, BuildOfferResponse as ApiBuildOfferResponse, CancelResponse as ApiCancelResponse, CollectionSearchResponse as ApiCollectionSearchResponse, DropMintRequest as ApiDropMintRequest, DropMintResponse as ApiDropMintResponse, Listing as ApiListing, Nft as ApiNft, NftSearchResponse as ApiNftSearchResponse, Offer as ApiOffer, Order as ApiOrder, OrderAsset as ApiOrderAsset, Payment as ApiPayment, Price as ApiPrice, SearchResponse as ApiSearchResponse, SearchResultResponse as ApiSearchResultResponse, SvmInstructionAccountResponse as ApiSvmInstructionAccountResponse, SvmInstructionResponse as ApiSvmInstructionResponse, SvmTransactionDetailsResponse as ApiSvmTransactionDetailsResponse, SwapExecuteRequest as ApiSwapExecuteRequest, SwapExecuteResponse as ApiSwapExecuteResponse, SwapQuoteResponse as ApiSwapQuoteResponse, SweepCollectionRequest as ApiSweepCollectionRequest, SweepCollectionResponse as ApiSweepCollectionResponse, TokenDetailedResponse as ApiTokenDetailedResponse, TokenResponse as ApiTokenResponse, TokenSearchResponse as ApiTokenSearchResponse, Trait as ApiTrait, TransactionReceiptRequest as ApiTransactionReceiptRequest, TransactionReceiptResponse as ApiTransactionReceiptResponse, ValidateMetadataResponse as ApiValidateMetadataResponse, WalletVisibilityResponse as ApiWalletVisibilityResponse, AssetMetadataResponse, ChainListResponse, ChainResponse, ContractResponse, DropDetailedResponse, DropResponse, DropStageResponse, InstantApiKeyResponse, ListingsResponse, NftDetailed, NftListResponse, NftResponse, OffersResponse, TokenAccountActivityPaginatedResponse, TokenBalancePaginatedResponse, TokenBalanceResponse, TokenGroupPaginatedResponse, TokenGroupResponse, TokenPaginatedResponse } from "@opensea/api-types";
2
2
  import type { OrderType, ProtocolData } from "../orders/types";
3
3
  import type { OpenSeaCollection } from "../types";
4
4
  import type { Camelize } from "../utils/case";
@@ -257,10 +257,22 @@ export type SvmTransactionDetailsResponse = Camelize<ApiSvmTransactionDetailsRes
257
257
  */
258
258
  export type WalletVisibilityResponse = Camelize<ApiWalletVisibilityResponse>;
259
259
  /**
260
- * Public agent profile relationships for an account.
260
+ * Public agent profile relationships for an account. Only relationships both
261
+ * accounts confirmed appear here; a pending proposal is visible to the two
262
+ * parties alone, through `listOwnAgentRelationships`.
263
+ *
264
+ * `agentOwner` is the account confirmed to own this one, and is null when
265
+ * there is none. That is ordinary rather than exceptional: an agent nobody
266
+ * declared is a valid agent account. `agents` holds the accounts this one is
267
+ * the confirmed owner of, newest first.
268
+ *
269
+ * The wire response also carries `agent_owner_profile` and
270
+ * `public_agent_wallets`. Both read the retired wallet-level designation, are
271
+ * permanently null and empty, and are removed by AGE-51, so they are omitted
272
+ * here rather than offered as fields a caller might reasonably read.
261
273
  * @category API Response Types
262
274
  */
263
- export type AgentProfileRelationshipsResponse = Camelize<ApiAgentProfileRelationshipsResponse>;
275
+ export type AgentProfileRelationshipsResponse = Omit<Camelize<ApiAgentProfileRelationshipsResponse>, "agentOwnerProfile" | "publicAgentWallets">;
264
276
  /**
265
277
  * Request body for fetching a transaction receipt.
266
278
  * @category API Query Args
@@ -802,10 +814,7 @@ export type ChainInfo = Camelize<ChainResponse>;
802
814
  * Response from OpenSea API for listing supported chains.
803
815
  * @category API Response Types
804
816
  */
805
- export type GetChainsResponse = {
806
- /** List of supported chains */
807
- chains: ChainInfo[];
808
- };
817
+ export type GetChainsResponse = Camelize<ChainListResponse>;
809
818
  /**
810
819
  * Token balance for a wallet address. Sourced from `@opensea/api-types`
811
820
  * (`TokenBalanceResponse`). Gains optional `status`, `baseTokenLiquidityUsd`,
@@ -894,26 +903,12 @@ export interface GetDropsArgs {
894
903
  * Request body for building a drop mint transaction.
895
904
  * @category API Request Types
896
905
  */
897
- export type DropMintRequest = {
898
- /** Wallet address that will receive the minted tokens */
899
- minter: string;
900
- /** Number of tokens to mint (1-100) */
901
- quantity: number;
902
- };
906
+ export type DropMintRequest = Camelize<ApiDropMintRequest>;
903
907
  /**
904
908
  * Response from OpenSea API for building a drop mint transaction.
905
909
  * @category API Response Types
906
910
  */
907
- export type DropMintResponse = {
908
- /** Transaction target contract address */
909
- to: string;
910
- /** Encoded transaction data (hex) */
911
- data: string;
912
- /** Transaction value in wei (hex) */
913
- value: string;
914
- /** Chain identifier */
915
- chain: string;
916
- };
911
+ export type DropMintResponse = Camelize<ApiDropMintResponse>;
917
912
  /**
918
913
  * Query args for Get Trending Collections endpoint.
919
914
  * @category API Query Args
@@ -957,51 +952,12 @@ export type GetCollectionsPaginatedResponse = QueryCursorsV2 & {
957
952
  * Response from OpenSea API for resolving an account identifier.
958
953
  * @category API Response Types
959
954
  */
960
- export type ResolveAccountResponse = {
961
- /** The resolved wallet address */
962
- address: string;
963
- /** OpenSea username, if available */
964
- username?: string;
965
- /** Primary ENS name, if available */
966
- ensName?: string;
967
- };
955
+ export type ResolveAccountResponse = Camelize<AccountResolveResponse>;
968
956
  /**
969
957
  * Response from OpenSea API for validating NFT metadata.
970
958
  * @category API Response Types
971
959
  */
972
- export type ValidateMetadataResponse = {
973
- /** The asset being validated */
974
- assetIdentifier: {
975
- chain: string;
976
- contractAddress: string;
977
- tokenId: string;
978
- };
979
- /** The token URI */
980
- tokenUri?: string;
981
- /** Parsed metadata details */
982
- metadata?: {
983
- name?: string;
984
- description?: string;
985
- originalImageUrl?: string;
986
- processedImageUrl?: string;
987
- originalAnimationUrl?: string;
988
- processedAnimationUrl?: string;
989
- externalUrl?: string;
990
- backgroundColor?: string;
991
- attributes: {
992
- traitType: string;
993
- value: string;
994
- displayType?: string;
995
- }[];
996
- };
997
- /** Error encountered during metadata ingestion */
998
- error?: {
999
- errorType: string;
1000
- message: string;
1001
- url?: string;
1002
- statusCode?: number;
1003
- };
1004
- };
960
+ export type ValidateMetadataResponse = Camelize<ApiValidateMetadataResponse>;
1005
961
  /**
1006
962
  * Response from OpenSea API for fetching raw NFT metadata.
1007
963
  * Derived from the generated OpenAPI spec type to stay in sync automatically.
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":";;;AAqFA,8CAIC;AAVD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,MAAiC;IAEjC,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACzE,CAAC;AA0ED,IAAY,uBAOX;AAPD,WAAY,uBAAuB;IACjC,wDAA6B,CAAA;IAC7B,4DAAiC,CAAA;IACjC,gEAAqC,CAAA;IACrC,gEAAqC,CAAA;IACrC,oDAAyB,CAAA;IACzB,oDAAyB,CAAA;AAC3B,CAAC,EAPW,uBAAuB,uCAAvB,uBAAuB,QAOlC;AAED;;;GAGG;AACH,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,sCAAuB,CAAA;IACvB,kCAAmB,CAAA;IACnB,sCAAuB,CAAA;AACzB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AA6MD;;;;GAIG;AACH,IAAY,gBAQX;AARD,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,yDAAqC,CAAA;IACrC,iDAA6B,CAAA;IAC7B,qCAAiB,CAAA;IACjB,iCAAa,CAAA;IACb,uCAAuC;IACvC,iCAAa,CAAA;AACf,CAAC,EARW,gBAAgB,gCAAhB,gBAAgB,QAQ3B;AAED;;;GAGG;AACH,IAAY,cASX;AATD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,uCAAqB,CAAA;IACrB,+BAAa,CAAA;IACb,qCAAmB,CAAA;IACnB,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,6CAA2B,CAAA;IAC3B,uDAAqC,CAAA;AACvC,CAAC,EATW,cAAc,8BAAd,cAAc,QASzB;AAED;;;GAGG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;IACzB,uDAAqC,CAAA;IACrC,6CAA2B,CAAA;AAC7B,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":";;;AA0FA,8CAIC;AAVD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,MAAiC;IAEjC,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACzE,CAAC;AA0ED,IAAY,uBAOX;AAPD,WAAY,uBAAuB;IACjC,wDAA6B,CAAA;IAC7B,4DAAiC,CAAA;IACjC,gEAAqC,CAAA;IACrC,gEAAqC,CAAA;IACrC,oDAAyB,CAAA;IACzB,oDAAyB,CAAA;AAC3B,CAAC,EAPW,uBAAuB,uCAAvB,uBAAuB,QAOlC;AAED;;;GAGG;AACH,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,sCAAuB,CAAA;IACvB,kCAAmB,CAAA;IACnB,sCAAuB,CAAA;AACzB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AA2ND;;;;GAIG;AACH,IAAY,gBAQX;AARD,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,yDAAqC,CAAA;IACrC,iDAA6B,CAAA;IAC7B,qCAAiB,CAAA;IACjB,iCAAa,CAAA;IACb,uCAAuC;IACvC,iCAAa,CAAA;AACf,CAAC,EARW,gBAAgB,gCAAhB,gBAAgB,QAQ3B;AAED;;;GAGG;AACH,IAAY,cASX;AATD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,uCAAqB,CAAA;IACrB,+BAAa,CAAA;IACb,qCAAmB,CAAA;IACnB,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,6CAA2B,CAAA;IAC3B,uDAAqC,CAAA;AACvC,CAAC,EATW,cAAc,8BAAd,cAAc,QASzB;AAED;;;GAGG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;IACzB,uDAAqC,CAAA;IACrC,6CAA2B,CAAA;AAC7B,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}
@@ -364,14 +364,6 @@ export declare class WalletAuthAPI {
364
364
  unlinkWallet(wallet: string): Promise<{
365
365
  success: boolean;
366
366
  }>;
367
- markWalletAsAgent(wallet: string): Promise<{
368
- address: string;
369
- isAgent: boolean;
370
- }>;
371
- removeWalletAgentDesignation(wallet: string): Promise<{
372
- address: string;
373
- isAgent: boolean;
374
- }>;
375
367
  makeWalletPrivate(wallet: string): Promise<{
376
368
  address: string;
377
369
  isPrivate: boolean;
@@ -380,5 +372,100 @@ export declare class WalletAuthAPI {
380
372
  address: string;
381
373
  isPrivate: boolean;
382
374
  }>;
375
+ /**
376
+ * Declare the authenticated account an agent. Requires `write:wallets`.
377
+ *
378
+ * Independent of ownership: an agent nobody owns is valid. `changed` is
379
+ * false when the account was already an agent, so a retry is
380
+ * distinguishable from a real change.
381
+ */
382
+ declareAgentAccount(): Promise<{
383
+ isAgent: boolean;
384
+ changed: boolean;
385
+ }>;
386
+ /**
387
+ * Withdraw the authenticated account's agent declaration. Requires
388
+ * `write:wallets`.
389
+ */
390
+ withdrawAgentAccountDeclaration(): Promise<{
391
+ isAgent: boolean;
392
+ changed: boolean;
393
+ }>;
394
+ /**
395
+ * Propose an agent ownership relationship. Requires `write:wallets`.
396
+ *
397
+ * `callerRole` says which side the caller is on: `AGENT` means "I am an
398
+ * agent and the counterparty owns me". The caller's own account is never in
399
+ * the body; it comes from the bearer token.
400
+ *
401
+ * Proposing a relationship that is already awaiting you confirms it, so a
402
+ * client that cannot tell who moved first can just propose.
403
+ */
404
+ proposeAgentRelationship(body: WalletAuthRequest<"propose_agent_relationship">): Promise<{
405
+ relation: {
406
+ initiatorAddress?: string | undefined;
407
+ counterpartyAddress?: string | undefined;
408
+ agentAccountId: string;
409
+ ownerAccountId: string;
410
+ status: string;
411
+ initiatedBy: string;
412
+ awaitingConfirmationFrom?: string | undefined;
413
+ createdAt: number;
414
+ confirmedAt?: number | undefined;
415
+ };
416
+ created: boolean;
417
+ }>;
418
+ /**
419
+ * Confirm a relationship proposed to the authenticated account. Requires
420
+ * `write:wallets`. An agent ends up with at most one confirmed owner.
421
+ */
422
+ confirmAgentRelationship(body: WalletAuthRequest<"confirm_agent_relationship">): Promise<{
423
+ relation: {
424
+ initiatorAddress?: string | undefined;
425
+ counterpartyAddress?: string | undefined;
426
+ agentAccountId: string;
427
+ ownerAccountId: string;
428
+ status: string;
429
+ initiatedBy: string;
430
+ awaitingConfirmationFrom?: string | undefined;
431
+ createdAt: number;
432
+ confirmedAt?: number | undefined;
433
+ };
434
+ created: boolean;
435
+ }>;
436
+ /**
437
+ * Withdraw a proposal or revoke a confirmed relationship. Requires
438
+ * `write:wallets`. Either side may do this at any point, and it deletes the
439
+ * relationship rather than marking it inactive.
440
+ *
441
+ * `removed` is false when no such relationship existed, which covers both a
442
+ * counterparty you never proposed to and someone else's relationship.
443
+ *
444
+ * Sent as query parameters rather than a body on purpose: fetch, OkHttp and
445
+ * urllib all drop DELETE bodies by default, and proxies may strip them.
446
+ */
447
+ revokeAgentRelationship(query: WalletAuthQuery<"revoke_agent_relationship">): Promise<{
448
+ removed: boolean;
449
+ }>;
450
+ /**
451
+ * List the authenticated account's own relationships. Requires
452
+ * `read:wallets`, not `write:wallets`.
453
+ *
454
+ * Includes proposals still awaiting either side. Pending relationships show
455
+ * up here only; a public profile shows confirmed ones alone.
456
+ */
457
+ listOwnAgentRelationships(): Promise<{
458
+ relationships: {
459
+ initiatorAddress?: string | undefined;
460
+ counterpartyAddress?: string | undefined;
461
+ agentAccountId: string;
462
+ ownerAccountId: string;
463
+ status: string;
464
+ initiatedBy: string;
465
+ awaitingConfirmationFrom?: string | undefined;
466
+ createdAt: number;
467
+ confirmedAt?: number | undefined;
468
+ }[];
469
+ }>;
383
470
  }
384
471
  export {};
@@ -169,18 +169,87 @@ class WalletAuthAPI {
169
169
  unlinkWallet(wallet) {
170
170
  return this.fetcher.request("DELETE", `/api/v2/accounts/wallets/${segment(wallet)}`);
171
171
  }
172
- markWalletAsAgent(wallet) {
173
- return this.fetcher.request("PUT", `/api/v2/accounts/wallets/${segment(wallet)}/agent`);
174
- }
175
- removeWalletAgentDesignation(wallet) {
176
- return this.fetcher.request("DELETE", `/api/v2/accounts/wallets/${segment(wallet)}/agent`);
177
- }
178
172
  makeWalletPrivate(wallet) {
179
173
  return this.fetcher.request("PUT", `/api/v2/accounts/wallets/${segment(wallet)}/private`);
180
174
  }
181
175
  makeWalletPublic(wallet) {
182
176
  return this.fetcher.request("DELETE", `/api/v2/accounts/wallets/${segment(wallet)}/private`);
183
177
  }
178
+ // ── Agent accounts ────────────────────────────────────────────────
179
+ //
180
+ // An agent is an account, not a flag on a wallet, and ownership is a
181
+ // relationship between two accounts that both sides confirm. It is a
182
+ // declaration, not an authorization: naming an account as your agent
183
+ // grants it nothing. It is self-reported and OpenSea does not verify it.
184
+ //
185
+ // The five writes below need `write:wallets`. `listOwnAgentRelationships`
186
+ // needs `read:wallets`. A client driving the whole handshake needs both, or
187
+ // the list call fails with "Insufficient permissions".
188
+ /**
189
+ * Declare the authenticated account an agent. Requires `write:wallets`.
190
+ *
191
+ * Independent of ownership: an agent nobody owns is valid. `changed` is
192
+ * false when the account was already an agent, so a retry is
193
+ * distinguishable from a real change.
194
+ */
195
+ declareAgentAccount() {
196
+ return this.fetcher.request("PUT", "/api/v2/accounts/agent");
197
+ }
198
+ /**
199
+ * Withdraw the authenticated account's agent declaration. Requires
200
+ * `write:wallets`.
201
+ */
202
+ withdrawAgentAccountDeclaration() {
203
+ return this.fetcher.request("DELETE", "/api/v2/accounts/agent");
204
+ }
205
+ /**
206
+ * Propose an agent ownership relationship. Requires `write:wallets`.
207
+ *
208
+ * `callerRole` says which side the caller is on: `AGENT` means "I am an
209
+ * agent and the counterparty owns me". The caller's own account is never in
210
+ * the body; it comes from the bearer token.
211
+ *
212
+ * Proposing a relationship that is already awaiting you confirms it, so a
213
+ * client that cannot tell who moved first can just propose.
214
+ */
215
+ proposeAgentRelationship(body) {
216
+ return this.fetcher.request("POST", "/api/v2/accounts/agent-relationships", body);
217
+ }
218
+ /**
219
+ * Confirm a relationship proposed to the authenticated account. Requires
220
+ * `write:wallets`. An agent ends up with at most one confirmed owner.
221
+ */
222
+ confirmAgentRelationship(body) {
223
+ return this.fetcher.request("POST", "/api/v2/accounts/agent-relationships/confirm", body);
224
+ }
225
+ /**
226
+ * Withdraw a proposal or revoke a confirmed relationship. Requires
227
+ * `write:wallets`. Either side may do this at any point, and it deletes the
228
+ * relationship rather than marking it inactive.
229
+ *
230
+ * `removed` is false when no such relationship existed, which covers both a
231
+ * counterparty you never proposed to and someone else's relationship.
232
+ *
233
+ * Sent as query parameters rather than a body on purpose: fetch, OkHttp and
234
+ * urllib all drop DELETE bodies by default, and proxies may strip them.
235
+ */
236
+ revokeAgentRelationship(query) {
237
+ const params = new URLSearchParams({
238
+ counterparty_address: query.counterpartyAddress,
239
+ caller_role: query.callerRole,
240
+ });
241
+ return this.fetcher.request("DELETE", `/api/v2/accounts/agent-relationships?${params}`);
242
+ }
243
+ /**
244
+ * List the authenticated account's own relationships. Requires
245
+ * `read:wallets`, not `write:wallets`.
246
+ *
247
+ * Includes proposals still awaiting either side. Pending relationships show
248
+ * up here only; a public profile shows confirmed ones alone.
249
+ */
250
+ listOwnAgentRelationships() {
251
+ return this.fetcher.get("/api/v2/accounts/agent-relationships");
252
+ }
184
253
  }
185
254
  exports.WalletAuthAPI = WalletAuthAPI;
186
255
  //# sourceMappingURL=walletAuth.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"walletAuth.js","sourceRoot":"","sources":["../../src/api/walletAuth.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"walletAuth.js","sourceRoot":"","sources":["../../src/api/walletAuth.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Append the OpenSea attribution suffix to ABI-encoded calldata.
3
+ *
4
+ * The fulfillment endpoints return `calldata_suffix` alongside the transaction
5
+ * they describe: the first four bytes of `keccak256("api.opensea.io")`, which
6
+ * OpenSea's own fills carry as trailing calldata. Seaport reads its arguments
7
+ * from offsets and ignores trailing bytes, so the suffix attributes the fill
8
+ * without affecting execution.
9
+ *
10
+ * This matters because the SDK does not submit the API's calldata. It re-encodes
11
+ * the call from `input_data` and signs that, which drops anything the API had
12
+ * appended, so the suffix has to be re-attached here or the fill lands
13
+ * unattributed.
14
+ *
15
+ * A missing or malformed suffix is ignored rather than raised. Attribution is
16
+ * optional by design and must never be the reason a fill fails.
17
+ */
18
+ export declare function appendCalldataSuffix(calldata: string, suffix: string | undefined): string;
@@ -0,0 +1,29 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.appendCalldataSuffix = appendCalldataSuffix;
4
+ /** A 4-byte hex string, the only shape the attribution suffix takes. */
5
+ const CALLDATA_SUFFIX_PATTERN = /^0x[0-9a-f]{8}$/i;
6
+ /**
7
+ * Append the OpenSea attribution suffix to ABI-encoded calldata.
8
+ *
9
+ * The fulfillment endpoints return `calldata_suffix` alongside the transaction
10
+ * they describe: the first four bytes of `keccak256("api.opensea.io")`, which
11
+ * OpenSea's own fills carry as trailing calldata. Seaport reads its arguments
12
+ * from offsets and ignores trailing bytes, so the suffix attributes the fill
13
+ * without affecting execution.
14
+ *
15
+ * This matters because the SDK does not submit the API's calldata. It re-encodes
16
+ * the call from `input_data` and signs that, which drops anything the API had
17
+ * appended, so the suffix has to be re-attached here or the fill lands
18
+ * unattributed.
19
+ *
20
+ * A missing or malformed suffix is ignored rather than raised. Attribution is
21
+ * optional by design and must never be the reason a fill fails.
22
+ */
23
+ function appendCalldataSuffix(calldata, suffix) {
24
+ if (!suffix || !CALLDATA_SUFFIX_PATTERN.test(suffix)) {
25
+ return calldata;
26
+ }
27
+ return calldata + suffix.slice(2);
28
+ }
29
+ //# sourceMappingURL=attribution.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attribution.js","sourceRoot":"","sources":["../../src/orders/attribution.ts"],"names":[],"mappings":";;AAoBA,oDAQC;AA5BD,wEAAwE;AACxE,MAAM,uBAAuB,GAAG,kBAAkB,CAAA;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,oBAAoB,CAClC,QAAgB,EAChB,MAA0B;IAE1B,IAAI,CAAC,MAAM,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACnC,CAAC"}
@@ -87,6 +87,13 @@ function sumErc20Consideration(consideration) {
87
87
  if (amount === null) {
88
88
  return null;
89
89
  }
90
+ // A time-interpolated item (declining or ascending price) is charged at a
91
+ // value between startAmount and endAmount, so startAmount is only an upper
92
+ // bound and there is no confident figure to check a balance against.
93
+ const endAmount = toBigInt(rawItem.endAmount);
94
+ if (endAmount === null || endAmount !== amount) {
95
+ return null;
96
+ }
90
97
  total += amount;
91
98
  }
92
99
  return token === null ? null : { token, amount: total };
@@ -133,6 +140,49 @@ function basicOrderErc20Payment(basicOrderParameters) {
133
140
  }
134
141
  return { token, amount: total };
135
142
  }
143
+ /**
144
+ * Top-level `input_data` keys that can carry the flattened basic-order struct,
145
+ * in precedence order.
146
+ *
147
+ * `parameters` is the name the API sends, per the `FulfillBasicOrder` schema in
148
+ * the OpenAPI spec. `basicOrderParameters` is a tolerated alias and appears in
149
+ * no real response; reading only that name is what made this preflight inert in
150
+ * production (opensea-sdk#1997).
151
+ */
152
+ const BASIC_ORDER_STRUCT_KEYS = ["parameters", "basicOrderParameters"];
153
+ /**
154
+ * Find the flattened basic-order struct in a fulfillment response.
155
+ *
156
+ * `basicOrderType` is the discriminator, because only the flattened
157
+ * basic-order struct carries it. An `OrderComponents`-shaped `parameters` from
158
+ * a standard `fulfillOrder` response has `offer` and `consideration` arrays
159
+ * instead, so it cannot be mistaken for a basic order.
160
+ */
161
+ function findBasicOrderStruct(inputData) {
162
+ for (const key of BASIC_ORDER_STRUCT_KEYS) {
163
+ const candidate = inputData[key];
164
+ if (isRecord(candidate) && candidate.basicOrderType !== undefined) {
165
+ return candidate;
166
+ }
167
+ }
168
+ return null;
169
+ }
170
+ /**
171
+ * Whether an advanced order's numerator/denominator fraction is a full fill.
172
+ * A full fill is the only case where summing the consideration items'
173
+ * `startAmount`s is the exact payment: for a partial fill Seaport scales each
174
+ * item by the fraction and requires exact divisibility, which is not modelled
175
+ * here. Returns false for a missing, unparsable, non-positive, or unequal
176
+ * fraction, so the caller fails open and skips the preflight.
177
+ */
178
+ function isFullFillFraction(order) {
179
+ const numerator = toBigInt(order.numerator);
180
+ const denominator = toBigInt(order.denominator);
181
+ if (numerator === null || denominator === null) {
182
+ return false;
183
+ }
184
+ return numerator > 0n && numerator === denominator;
185
+ }
136
186
  /**
137
187
  * Read the ERC20 payment a fulfiller owes from the `inputData` of an OpenSea
138
188
  * fulfillment response.
@@ -146,8 +196,9 @@ function getErc20Payment(inputData) {
146
196
  if (!isRecord(inputData)) {
147
197
  return null;
148
198
  }
149
- if ("basicOrderParameters" in inputData) {
150
- return basicOrderErc20Payment(inputData.basicOrderParameters);
199
+ const basicOrder = findBasicOrderStruct(inputData);
200
+ if (basicOrder) {
201
+ return basicOrderErc20Payment(basicOrder);
151
202
  }
152
203
  const order = isRecord(inputData.advancedOrder)
153
204
  ? inputData.advancedOrder
@@ -157,6 +208,13 @@ function getErc20Payment(inputData) {
157
208
  if (!order || !isRecord(order.parameters)) {
158
209
  return null;
159
210
  }
211
+ // An AdvancedOrder may carry a numerator/denominator fraction for a partial
212
+ // fill. Seaport applies that fraction to each consideration item, so the
213
+ // summed full-order consideration is only the real payment for a full fill.
214
+ // For anything else, fail open rather than falsely blocking a purchase.
215
+ if (isRecord(inputData.advancedOrder) && !isFullFillFraction(order)) {
216
+ return null;
217
+ }
160
218
  return sumErc20Consideration(order.parameters.consideration);
161
219
  }
162
220
  /**
@@ -172,8 +230,13 @@ function getFulfillerConduitKey(inputData) {
172
230
  if (typeof direct === "string") {
173
231
  return direct;
174
232
  }
175
- if (isRecord(inputData.basicOrderParameters)) {
176
- const fromBasicOrder = inputData.basicOrderParameters.fulfillerConduitKey;
233
+ // A basic order carries its conduit key inside the struct, not at the top
234
+ // level. Reading the amount without this would resolve the spender to Seaport
235
+ // for an order the buyer approved the conduit for, and the preflight would
236
+ // then report a working purchase as unapproved.
237
+ const basicOrder = findBasicOrderStruct(inputData);
238
+ if (basicOrder) {
239
+ const fromBasicOrder = basicOrder.fulfillerConduitKey;
177
240
  if (typeof fromBasicOrder === "string") {
178
241
  return fromBasicOrder;
179
242
  }
@@ -1 +1 @@
1
- {"version":3,"file":"erc20Fulfillment.js","sourceRoot":"","sources":["../../src/orders/erc20Fulfillment.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"erc20Fulfillment.js","sourceRoot":"","sources":["../../src/orders/erc20Fulfillment.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
- import type { BasicOrderParametersStruct } from "@opensea/seaport-js/lib/typechain-types/seaport/contracts/Seaport";
2
- import type { AdvancedOrder, OrderWithCounter } from "@opensea/seaport-js/lib/types";
1
+ import type { FulfillListingResponse as ApiFulfillListingResponse, FulfillmentData as ApiFulfillmentData } from "@opensea/api-types";
2
+ import type { OrderWithCounter } from "@opensea/seaport-js/lib/types";
3
3
  import type { OpenSeaAccount, OrderSide } from "../types";
4
+ import type { Camelize } from "../utils/case";
4
5
  type OrderProtocolToProtocolData = {
5
6
  seaport: OrderWithCounter;
6
7
  };
@@ -58,32 +59,19 @@ export type OrderV2 = {
58
59
  /** Amount of items left in the order which can be taken. */
59
60
  remainingQuantity: number;
60
61
  };
61
- export type FulfillmentDataResponse = {
62
- protocol: string;
63
- fulfillmentData: FulfillmentData;
64
- };
65
- type FulfillmentData = {
66
- transaction: Transaction;
67
- orders: ProtocolData[];
68
- };
69
- type Transaction = {
70
- function: string;
71
- chain: number;
72
- to: string;
73
- value: string;
74
- inputData: {
75
- advancedOrder: AdvancedOrder;
76
- criteriaResolvers?: unknown[];
77
- fulfillerConduitKey?: string;
78
- recipient: string;
79
- } | {
80
- basicOrderParameters: BasicOrderParametersStruct;
81
- } | {
82
- order: OrderWithCounter;
83
- fulfillerConduitKey?: string;
84
- recipient: string;
85
- } | {
86
- orders: OrderWithCounter[] | AdvancedOrder[] | BasicOrderParametersStruct[];
62
+ /**
63
+ * Response from the fulfillment data endpoints. Camelized from
64
+ * `@opensea/api-types`, with `orders` narrowed to the seaport-js
65
+ * `ProtocolData` shape the SDK hands back to callers.
66
+ *
67
+ * The generated `transaction` carries `calldataSuffix`, the 4-byte attribution
68
+ * suffix {@link FulfillmentManager.fulfillOrder} appends to the calldata, and
69
+ * `inputData` covers all seven Seaport calls the API can return rather than the
70
+ * four the SDK used to declare.
71
+ */
72
+ export type FulfillmentDataResponse = Camelize<Omit<ApiFulfillListingResponse, "fulfillment_data">> & {
73
+ fulfillmentData: Camelize<Omit<ApiFulfillmentData, "orders">> & {
74
+ orders: ProtocolData[];
87
75
  };
88
76
  };
89
77
  export type QueryCursors = {
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/orders/types.ts"],"names":[],"mappings":";;;AAeA,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;AACvB,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/orders/types.ts"],"names":[],"mappings":";;;AAgBA,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;AACvB,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB"}