@highlightxyz/sdk 0.1.1 → 0.3.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.
@@ -1,5 +1,5 @@
1
1
  import { type Client, type Options as Options2, type TDataShape } from "./client";
2
- import { type ApiKeyCreateErrors, type ApiKeyCreateResponses, type ApiKeyListErrors, type ApiKeyListResponses, type ApiKeyRevokeErrors, type ApiKeyRevokeResponses, CaptureSettingsTrigger, type CollectionAddSaleErrors, type CollectionAddSaleResponses, type CollectionBidSaleErrors, type CollectionBidSaleResponses, type CollectionClaimSaleErrors, type CollectionClaimSaleResponses, type CollectionConfirmBidErrors, type CollectionConfirmBidResponses, type CollectionConfirmSaleErrors, type CollectionConfirmSaleResponses, type CollectionCreateErrors, type CollectionCreateResponses, type CollectionDeleteSaleErrors, type CollectionDeleteSaleResponses, type CollectionDeployCancelErrors, type CollectionDeployCancelResponses, type CollectionDeployConfirmErrors, type CollectionDeployConfirmResponses, type CollectionDeployErrors, type CollectionDeployResponses, type CollectionDeployStatusErrors, type CollectionDeployStatusResponses, type CollectionFinalizeBaseUriErrors, type CollectionFinalizeBaseUriResponses, type CollectionGetErrors, type CollectionGetResponses, type CollectionGetSalesErrors, type CollectionGetSalesResponses, type CollectionListErrors, type CollectionListResponses, CollectionType, type CollectionUpdateEditionDetailsErrors, type CollectionUpdateEditionDetailsResponses, type CollectionUpdateGenerativeDetailsErrors, type CollectionUpdateGenerativeDetailsResponses, type CollectionUpdateSaleErrors, type CollectionUpdateSaleResponses, type CollectionUpdateSeriesDetailsErrors, type CollectionUpdateSeriesDetailsResponses, type ConfigChainsResponses, type ConfigSystemContractErrors, type ConfigSystemContractResponses, type ContractGetErrors, type ContractGetResponses, type ContractListErrors, type ContractListResponses, ContractStandard, type GateCreateErrors, type GateCreateResponses, type GateGetErrors, type GateGetResponses, type GateListErrors, type GateListResponses, GateMatchMode, type GateRemoveErrors, type GateRemoveResponses, type GateUpdateErrors, type GateUpdateResponses, GenerativeEditionType, type HealthGetResponses, type MechanicAddDeploymentErrors, type MechanicAddDeploymentResponses, type MechanicCreateErrors, type MechanicCreateResponses, type MechanicGetErrors, type MechanicGetResponses, type MechanicListResponses, type MechanicRemoveDeploymentErrors, type MechanicRemoveDeploymentResponses, type MechanicUpdateErrors, type MechanicUpdateResponses, type MediaCreateUploadSessionErrors, type MediaCreateUploadSessionResponses, type MediaDeleteErrors, type MediaDeleteResponses, type MediaGetChildErrors, type MediaGetChildResponses, type MediaGetErrors, type MediaGetResponses, MediaKind, type MediaListChildrenErrors, type MediaListChildrenResponses, type MediaProcessErrors, type MediaProcessResponses, type MediaPublishErrors, type MediaPublishResponses, MediaScope, type MediaUploadErrors, type MediaUploadResponses, type PostIndexerChainsByChainIdActivateResponses, type PostIndexerChainsByChainIdPollResponses, type PostIndexerChainsByChainIdResetResponses, SaleAccessMode, SaleType, SelectorType, type TokenGetErrors, type TokenGetResponses, type TokenListErrors, type TokenListResponses, type UserSigninErrors, type UserSigninResponses, type UserSiweNonceErrors, type UserSiweNonceResponses } from "./types.gen";
2
+ import { type ApiKeyCreateErrors, type ApiKeyCreateResponses, type ApiKeyListErrors, type ApiKeyListResponses, type ApiKeyRevokeErrors, type ApiKeyRevokeResponses, CaptureSettingsTrigger, type CollectionAddSaleErrors, type CollectionAddSaleResponses, type CollectionBidSaleErrors, type CollectionBidSaleResponses, type CollectionCancelEnglishAuctionErrors, type CollectionCancelEnglishAuctionResponses, type CollectionClaimAuctionEarningsErrors, type CollectionClaimAuctionEarningsResponses, type CollectionClaimSaleErrors, type CollectionClaimSaleResponses, type CollectionCreateErrors, type CollectionCreateResponses, type CollectionDeleteSaleErrors, type CollectionDeleteSaleResponses, type CollectionDeployCancelErrors, type CollectionDeployCancelResponses, type CollectionDeployErrors, type CollectionDeployResponses, type CollectionDeployStatusErrors, type CollectionDeployStatusResponses, type CollectionEnglishAuctionBidsErrors, type CollectionEnglishAuctionBidsResponses, type CollectionEnglishAuctionStandingErrors, type CollectionEnglishAuctionStandingResponses, type CollectionFeaturedErrors, type CollectionFeaturedResponses, type CollectionFinalizeBaseUriErrors, type CollectionFinalizeBaseUriResponses, type CollectionFulfillEnglishAuctionErrors, type CollectionFulfillEnglishAuctionResponses, type CollectionGetErrors, type CollectionGetResponses, type CollectionGetSalesErrors, type CollectionGetSalesResponses, type CollectionListErrors, type CollectionListPreviewsErrors, type CollectionListPreviewsResponses, type CollectionListResponses, type CollectionRankedAuctionStandingsErrors, type CollectionRankedAuctionStandingsResponses, type CollectionReclaimBidErrors, type CollectionReclaimBidResponses, type CollectionTrendingErrors, type CollectionTrendingResponses, CollectionType, type CollectionUpdateEditionDetailsErrors, type CollectionUpdateEditionDetailsResponses, type CollectionUpdateGenerativeDetailsErrors, type CollectionUpdateGenerativeDetailsResponses, type CollectionUpdateSaleErrors, type CollectionUpdateSaleResponses, type CollectionUpdateSeriesDetailsErrors, type CollectionUpdateSeriesDetailsResponses, type ConfigChainsResponses, type ConfigSystemContractErrors, type ConfigSystemContractResponses, type ContractGetErrors, type ContractGetResponses, type ContractListErrors, type ContractListResponses, ContractStandard, type GateCreateErrors, type GateCreateResponses, type GateGetErrors, type GateGetResponses, type GateListErrors, type GateListResponses, GateMatchMode, type GatePreviewAttributesErrors, type GatePreviewAttributesResponses, type GatePreviewCollectionErrors, type GatePreviewCollectionResponses, type GatePreviewCurrencyErrors, type GatePreviewCurrencyResponses, type GatePreviewFarcasterErrors, type GatePreviewFarcasterResponses, type GatePreviewTokenErrors, type GatePreviewTokenResponses, type GatePreviewTokensErrors, type GatePreviewTokensResponses, type GateRemoveErrors, type GateRemoveResponses, type GateUpdateErrors, type GateUpdateResponses, GenerativeEditionType, type HealthGetResponses, type MechanicAddDeploymentErrors, type MechanicAddDeploymentResponses, type MechanicCreateErrors, type MechanicCreateResponses, type MechanicGetErrors, type MechanicGetResponses, type MechanicListResponses, type MechanicRemoveDeploymentErrors, type MechanicRemoveDeploymentResponses, type MechanicUpdateErrors, type MechanicUpdateResponses, type MediaCreateUploadSessionErrors, type MediaCreateUploadSessionResponses, type MediaDeleteErrors, type MediaDeleteResponses, type MediaGetChildErrors, type MediaGetChildResponses, type MediaGetErrors, type MediaGetResponses, MediaKind, type MediaListChildrenErrors, type MediaListChildrenResponses, type MediaProcessErrors, type MediaProcessResponses, type MediaPublishErrors, type MediaPublishResponses, MediaScope, type MediaUploadErrors, type MediaUploadResponses, type PostIndexerChainsByChainIdActivateErrors, type PostIndexerChainsByChainIdActivateResponses, type PostIndexerChainsByChainIdPollErrors, type PostIndexerChainsByChainIdPollResponses, type PostIndexerChainsByChainIdResetErrors, type PostIndexerChainsByChainIdResetResponses, type ProfileGetErrors, type ProfileGetResponses, type ProfilePublicErrors, type ProfilePublicResponses, type ProfileTokensErrors, type ProfileTokensResponses, type ProfileUpdateErrors, type ProfileUpdateResponses, SaleAccessMode, SaleType, SelectorType, type TokenAttributeFacetsErrors, type TokenAttributeFacetsResponses, type TokenGetErrors, type TokenGetResponses, type TokenListErrors, type TokenListOwnersErrors, type TokenListOwnersResponses, type TokenListResponses, type TokenRedriveRevealsErrors, type TokenRedriveRevealsResponses, type TxStatusErrors, type TxStatusResponses, type TxSubmitErrors, type TxSubmitResponses, type UserSigninErrors, type UserSigninResponses, type UserSiweNonceErrors, type UserSiweNonceResponses } from "./types.gen";
3
3
  export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
4
4
  /**
5
5
  * You can provide a client instance returned by `createClient()` instead of
@@ -31,15 +31,15 @@ export declare class Collection extends HeyApiClient {
31
31
  *
32
32
  * Get a paginated list of collections.
33
33
  */
34
- list<ThrowOnError extends boolean = false>(parameters: {
34
+ list<ThrowOnError extends boolean = false>(parameters?: {
35
35
  page?: number;
36
36
  limit?: number;
37
37
  sortBy?: "CREATED_DATE" | "NAME";
38
38
  sortDirection?: "ASC" | "DESC";
39
39
  status?: "Draft" | "InProgress" | "Live" | "Migrated" | "Disabled";
40
- blockchains: Array<number>;
41
- testnet: boolean;
42
- types: Array<"OpenEdition" | "LimitedEdition" | "OneOfOne" | "Series" | "GenerativeSeries">;
40
+ blockchains?: Array<number>;
41
+ testnet?: boolean;
42
+ types?: Array<"OpenEdition" | "LimitedEdition" | "OneOfOne" | "Series" | "GenerativeSeries">;
43
43
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionListResponses, CollectionListErrors, ThrowOnError, "fields">;
44
44
  /**
45
45
  * Create collection
@@ -65,18 +65,46 @@ export declare class Collection extends HeyApiClient {
65
65
  };
66
66
  tokenManager?: string;
67
67
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionCreateResponses, CollectionCreateErrors, ThrowOnError, "fields">;
68
+ /**
69
+ * Trending collections
70
+ *
71
+ * List live collections ranked by units minted in a 24-hour, 7-day, or 28-day rolling window.
72
+ */
73
+ trending<ThrowOnError extends boolean = false>(parameters?: {
74
+ window?: "24h" | "7d" | "28d";
75
+ chainId?: number;
76
+ limit?: number;
77
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionTrendingResponses, CollectionTrendingErrors, ThrowOnError, "fields">;
78
+ /**
79
+ * Featured collections
80
+ *
81
+ * List curated home-page collections in editorial order with cursor pagination.
82
+ */
83
+ featured<ThrowOnError extends boolean = false>(parameters?: {
84
+ limit?: number;
85
+ cursor?: string;
86
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionFeaturedResponses, CollectionFeaturedErrors, ThrowOnError, "fields">;
68
87
  /**
69
88
  * Get collection
70
89
  *
71
- * Get a collection by its highlight ID.
90
+ * Get a collection by `highlightId` or by `<chain>:<contractAddress>[:<editionId>]`. The chain can be a slug or numeric ID. `editionId` defaults to 0.
72
91
  */
73
92
  get<ThrowOnError extends boolean = false>(parameters: {
74
- highlightId: string;
93
+ highlightId: string | string;
75
94
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionGetResponses, CollectionGetErrors, ThrowOnError, "fields">;
76
95
  /**
77
- * Finalize collection base URI to Arweave
96
+ * List series previews
97
+ *
98
+ * List sample artwork from a series collection's uploaded assets. Returns an empty list for other collection types or when the assets are not ready. Public collections do not require authentication.
99
+ */
100
+ listPreviews<ThrowOnError extends boolean = false>(parameters: {
101
+ highlightId: string;
102
+ limit?: number;
103
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionListPreviewsResponses, CollectionListPreviewsErrors, ThrowOnError, "fields">;
104
+ /**
105
+ * Archive collection metadata to Arweave
78
106
  *
79
- * Publish the collection's token-metadata base URI Directory to Arweave. Call once the collection is complete (sellout or manual trigger) to freeze metadata permanently. Idempotent — safe to call if already archived.
107
+ * Archive the collection's token-metadata directory to Arweave. The operation is idempotent and does not change the contract's base URI.
80
108
  */
81
109
  finalizeBaseUri<ThrowOnError extends boolean = false>(parameters: {
82
110
  highlightId: string;
@@ -120,9 +148,9 @@ export declare class Collection extends HeyApiClient {
120
148
  };
121
149
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionUpdateSeriesDetailsResponses, CollectionUpdateSeriesDetailsErrors, ThrowOnError, "fields">;
122
150
  /**
123
- * Update edition draft details
151
+ * Update edition details
124
152
  *
125
- * Update edition-specific details for an existing draft.
153
+ * Update an edition's name, description, image, animation, or attributes. Draft changes are saved directly. Live changes return a `setEditionURI` transaction to sign. After confirmation, the backend re-derives the edition and refreshes every token.
126
154
  */
127
155
  updateEditionDetails<ThrowOnError extends boolean = false>(parameters: {
128
156
  highlightId: string;
@@ -141,7 +169,7 @@ export declare class Collection extends HeyApiClient {
141
169
  /**
142
170
  * Get collection sales
143
171
  *
144
- * Get all sales for a collection.
172
+ * List the draft and live sales attached to a collection.
145
173
  */
146
174
  getSales<ThrowOnError extends boolean = false>(parameters: {
147
175
  highlightId: string;
@@ -149,7 +177,7 @@ export declare class Collection extends HeyApiClient {
149
177
  /**
150
178
  * Add a sale to a collection
151
179
  *
152
- * Add a new sale to a collection. Draft collections can have one sale at a time. For live collections, gated sales go live immediately; public sales return a contract execution for on-chain registration.
180
+ * Add a sale. A draft collection can have one sale at a time. On a live collection, a gated sale activates immediately and a public sale returns a vector-registration transaction.
153
181
  */
154
182
  addSale<ThrowOnError extends boolean = false>(parameters: {
155
183
  highlightId: string;
@@ -174,7 +202,7 @@ export declare class Collection extends HeyApiClient {
174
202
  /**
175
203
  * Delete a sale
176
204
  *
177
- * Delete a draft sale from a collection. Live sales cannot be deleted — use update to pause or set an end date instead.
205
+ * Delete a draft sale. A live sale cannot be deleted; pause it or set an end date.
178
206
  */
179
207
  deleteSale<ThrowOnError extends boolean = false>(parameters: {
180
208
  highlightId: string;
@@ -183,7 +211,7 @@ export declare class Collection extends HeyApiClient {
183
211
  /**
184
212
  * Update a sale
185
213
  *
186
- * Update an existing sale. Draft sales can be updated freely. Live public sales return a contract execution for on-chain updates when on-chain fields change.
214
+ * Update a sale. Draft and gated sales update off-chain. Supported changes to a live public sale return an on-chain vector-update transaction.
187
215
  */
188
216
  updateSale<ThrowOnError extends boolean = false>(parameters: {
189
217
  highlightId: string;
@@ -204,7 +232,7 @@ export declare class Collection extends HeyApiClient {
204
232
  /**
205
233
  * Claim collection sale
206
234
  *
207
- * Build a claim transaction configuration for a collector sale action.
235
+ * Build a collector's mint transaction for a fixed-price, Dutch, or ranked sale.
208
236
  */
209
237
  claimSale<ThrowOnError extends boolean = false>(parameters: {
210
238
  highlightId: string;
@@ -213,36 +241,81 @@ export declare class Collection extends HeyApiClient {
213
241
  tokenIds?: Array<number>;
214
242
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionClaimSaleResponses, CollectionClaimSaleErrors, ThrowOnError, "fields">;
215
243
  /**
216
- * Bid on ranked auction sale
244
+ * Bid on an auction sale
217
245
  *
218
- * Build a bid transaction configuration for a ranked auction sale. Returns contract execution data for placing or updating a bid.
246
+ * Build a ranked- or English-auction bid transaction. For an English auction, `preferredNftRecipient` sets the wallet that receives the NFT if the bid wins.
219
247
  */
220
248
  bidSale<ThrowOnError extends boolean = false>(parameters: {
221
249
  highlightId: string;
222
250
  saleId: string;
223
251
  bidAmount: string;
224
252
  bidId?: number;
253
+ preferredNftRecipient?: string;
225
254
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionBidSaleResponses, CollectionBidSaleErrors, ThrowOnError, "fields">;
226
255
  /**
227
- * Confirm ranked auction bid
256
+ * Reclaim a non-winning ranked-auction bid
228
257
  *
229
- * Record a confirmed on-chain bid for a ranked auction sale. Called after the bid transaction is confirmed on-chain.
258
+ * Build a transaction that reclaims a non-winning ranked-auction bid after the auction ends.
230
259
  */
231
- confirmBid<ThrowOnError extends boolean = false>(parameters: {
260
+ reclaimBid<ThrowOnError extends boolean = false>(parameters: {
232
261
  highlightId: string;
233
262
  saleId: string;
234
- txHash: string;
235
- }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionConfirmBidResponses, CollectionConfirmBidErrors, ThrowOnError, "fields">;
263
+ bidId: number;
264
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionReclaimBidResponses, CollectionReclaimBidErrors, ThrowOnError, "fields">;
236
265
  /**
237
- * Confirm sale deployment
266
+ * Withdraw ranked-auction earnings
238
267
  *
239
- * Confirm on-chain deployment of a public sale added to a live collection. Extracts the vector ID from the transaction receipt and sets the sale status to Live.
268
+ * Build a transaction that sends a completed ranked auction's native-currency earnings to its payment recipient.
240
269
  */
241
- confirmSale<ThrowOnError extends boolean = false>(parameters: {
270
+ claimAuctionEarnings<ThrowOnError extends boolean = false>(parameters: {
242
271
  highlightId: string;
243
272
  saleId: string;
244
- txHash: string;
245
- }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionConfirmSaleResponses, CollectionConfirmSaleErrors, ThrowOnError, "fields">;
273
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionClaimAuctionEarningsResponses, CollectionClaimAuctionEarningsErrors, ThrowOnError, "fields">;
274
+ /**
275
+ * Get ranked-auction live standings
276
+ *
277
+ * Get a ranked auction's clearing price and bid standings. Results are provisional before settlement. An authenticated response also includes the caller's winning bids and unclaimed tokens.
278
+ */
279
+ rankedAuctionStandings<ThrowOnError extends boolean = false>(parameters: {
280
+ highlightId: string;
281
+ saleId: string;
282
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionRankedAuctionStandingsResponses, CollectionRankedAuctionStandingsErrors, ThrowOnError, "fields">;
283
+ /**
284
+ * Fulfill (settle) an English auction
285
+ *
286
+ * Build an `AuctionManager.fulfillAuction` transaction after the auction ends. Any authenticated caller can settle; the contract sends the NFT to the winner's preferred recipient and splits the proceeds.
287
+ */
288
+ fulfillEnglishAuction<ThrowOnError extends boolean = false>(parameters: {
289
+ highlightId: string;
290
+ saleId: string;
291
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionFulfillEnglishAuctionResponses, CollectionFulfillEnglishAuctionErrors, ThrowOnError, "fields">;
292
+ /**
293
+ * Cancel an English auction
294
+ *
295
+ * Build the creator-only `AuctionManager.cancelAuctionOnChain` transaction. Cancellation fails after a bid meets the reserve. The contract returns any escrowed NFT to the owner.
296
+ */
297
+ cancelEnglishAuction<ThrowOnError extends boolean = false>(parameters: {
298
+ highlightId: string;
299
+ saleId: string;
300
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionCancelEnglishAuctionResponses, CollectionCancelEnglishAuctionErrors, ThrowOnError, "fields">;
301
+ /**
302
+ * Get English auction standings
303
+ *
304
+ * Get an English auction's status, reserve, highest bid and bidder, end time, escrowed token, and creator earnings. An authenticated response indicates whether the caller is the highest bidder.
305
+ */
306
+ englishAuctionStanding<ThrowOnError extends boolean = false>(parameters: {
307
+ highlightId: string;
308
+ saleId: string;
309
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionEnglishAuctionStandingResponses, CollectionEnglishAuctionStandingErrors, ThrowOnError, "fields">;
310
+ /**
311
+ * Get English auction bid history
312
+ *
313
+ * List an English auction's indexed bids from newest to oldest. Amounts use the currency's raw on-chain base unit.
314
+ */
315
+ englishAuctionBids<ThrowOnError extends boolean = false>(parameters: {
316
+ highlightId: string;
317
+ saleId: string;
318
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionEnglishAuctionBidsResponses, CollectionEnglishAuctionBidsErrors, ThrowOnError, "fields">;
246
319
  /**
247
320
  * Initiate collection deployment
248
321
  *
@@ -262,26 +335,17 @@ export declare class Collection extends HeyApiClient {
262
335
  /**
263
336
  * Cancel a deployment
264
337
  *
265
- * Cancel a deployment that has not yet completed. Terminates the running workflow, deletes the deployment row, and rolls the collection back to Draft. On contracts shared with other collections the contract is left unchanged; otherwise it is reset to Draft. After cancelling, the collection can be re-deployed from scratch.
338
+ * Cancel an incomplete deployment and return the collection to Draft. A shared contract keeps its current status; a non-shared contract returns to Draft. The collection can then be deployed again.
266
339
  */
267
340
  deployCancel<ThrowOnError extends boolean = false>(parameters: {
268
341
  highlightId: string;
269
342
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionDeployCancelResponses, CollectionDeployCancelErrors, ThrowOnError, "fields">;
270
- /**
271
- * Confirm deployment transaction
272
- *
273
- * Submit the transaction hash for a deployment awaiting confirmation.
274
- */
275
- deployConfirm<ThrowOnError extends boolean = false>(parameters: {
276
- highlightId: string;
277
- txHash: string;
278
- }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<CollectionDeployConfirmResponses, CollectionDeployConfirmErrors, ThrowOnError, "fields">;
279
343
  }
280
344
  export declare class Token extends HeyApiClient {
281
345
  /**
282
346
  * List tokens
283
347
  *
284
- * Get a paginated list of minted tokens for a collection. Returns tokens for public collections without authentication. Supports filtering by owner address.
348
+ * Get a paginated list of minted tokens for a collection. Returns tokens for public collections without authentication. Supports filtering by owner address and by trait attributes.
285
349
  */
286
350
  list<ThrowOnError extends boolean = false>(parameters: {
287
351
  highlightId: string;
@@ -291,7 +355,16 @@ export declare class Token extends HeyApiClient {
291
355
  order?: "asc" | "desc";
292
356
  ownerAddress?: string;
293
357
  search?: string;
358
+ attributes?: string;
294
359
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TokenListResponses, TokenListErrors, ThrowOnError, "fields">;
360
+ /**
361
+ * List token attribute facets
362
+ *
363
+ * List trait values and token counts for collection filters. Public collections do not require authentication.
364
+ */
365
+ attributeFacets<ThrowOnError extends boolean = false>(parameters: {
366
+ highlightId: string;
367
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TokenAttributeFacetsResponses, TokenAttributeFacetsErrors, ThrowOnError, "fields">;
295
368
  /**
296
369
  * Get token
297
370
  *
@@ -301,6 +374,23 @@ export declare class Token extends HeyApiClient {
301
374
  highlightId: string;
302
375
  tokenId: string;
303
376
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TokenGetResponses, TokenGetErrors, ThrowOnError, "fields">;
377
+ /**
378
+ * List token owners
379
+ *
380
+ * Get the current owners of a minted token with their balances. A single entry for ERC721 tokens; ERC1155 tokens can have many. Available for public collections without authentication.
381
+ */
382
+ listOwners<ThrowOnError extends boolean = false>(parameters: {
383
+ highlightId: string;
384
+ tokenId: string;
385
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TokenListOwnersResponses, TokenListOwnersErrors, ThrowOnError, "fields">;
386
+ /**
387
+ * Re-drive stuck token reveals
388
+ *
389
+ * Reschedule failed and stale pending token reveals. Minted tokens restart from their original mint transaction. Imported tokens without transfer history rerun metadata indexing only.
390
+ */
391
+ redriveReveals<ThrowOnError extends boolean = false>(parameters: {
392
+ highlightId: string;
393
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TokenRedriveRevealsResponses, TokenRedriveRevealsErrors, ThrowOnError, "fields">;
304
394
  }
305
395
  export declare class Config extends HeyApiClient {
306
396
  /**
@@ -342,7 +432,7 @@ export declare class Gate extends HeyApiClient {
342
432
  /**
343
433
  * List gates
344
434
  *
345
- * List all gates for the authenticated user.
435
+ * List gates owned by the authenticated account.
346
436
  */
347
437
  list<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateListResponses, GateListErrors, ThrowOnError, "fields">;
348
438
  /**
@@ -391,6 +481,9 @@ export declare class Gate extends HeyApiClient {
391
481
  type: "FARCASTER_FOLLOW";
392
482
  config: {
393
483
  fid: number;
484
+ username?: string;
485
+ displayName?: string;
486
+ pfpUrl?: string;
394
487
  };
395
488
  }>;
396
489
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateCreateResponses, GateCreateErrors, ThrowOnError, "fields">;
@@ -457,9 +550,68 @@ export declare class Gate extends HeyApiClient {
457
550
  type: "FARCASTER_FOLLOW";
458
551
  config: {
459
552
  fid: number;
553
+ username?: string;
554
+ displayName?: string;
555
+ pfpUrl?: string;
460
556
  };
461
557
  }>;
462
558
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GateUpdateResponses, GateUpdateErrors, ThrowOnError, "fields">;
559
+ /**
560
+ * Preview a collection
561
+ *
562
+ * Resolve an NFT contract for a gate builder. Returns a Highlight collection when available, otherwise external NFT data.
563
+ */
564
+ previewCollection<ThrowOnError extends boolean = false>(parameters: {
565
+ chainId: number;
566
+ address: string;
567
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GatePreviewCollectionResponses, GatePreviewCollectionErrors, ThrowOnError, "fields">;
568
+ /**
569
+ * Preview collection attributes
570
+ *
571
+ * List a collection's trait types and values for the TOKEN_ATTRIBUTE builder.
572
+ */
573
+ previewAttributes<ThrowOnError extends boolean = false>(parameters: {
574
+ chainId: number;
575
+ address: string;
576
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GatePreviewAttributesResponses, GatePreviewAttributesErrors, ThrowOnError, "fields">;
577
+ /**
578
+ * Preview collection tokens
579
+ *
580
+ * Page through a collection's tokens for the SPECIFIC_TOKEN builder.
581
+ */
582
+ previewTokens<ThrowOnError extends boolean = false>(parameters: {
583
+ chainId: number;
584
+ address: string;
585
+ cursor?: string;
586
+ limit?: number;
587
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GatePreviewTokensResponses, GatePreviewTokensErrors, ThrowOnError, "fields">;
588
+ /**
589
+ * Preview a token
590
+ *
591
+ * Resolve a single token to confirm a SPECIFIC_TOKEN condition.
592
+ */
593
+ previewToken<ThrowOnError extends boolean = false>(parameters: {
594
+ chainId: number;
595
+ address: string;
596
+ tokenId: string;
597
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GatePreviewTokenResponses, GatePreviewTokenErrors, ThrowOnError, "fields">;
598
+ /**
599
+ * Preview a currency
600
+ *
601
+ * Resolve the native gas token (no contractAddress) or an ERC-20 for the CURRENCY_BALANCE builder.
602
+ */
603
+ previewCurrency<ThrowOnError extends boolean = false>(parameters: {
604
+ chainId: number;
605
+ contractAddress?: string;
606
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GatePreviewCurrencyResponses, GatePreviewCurrencyErrors, ThrowOnError, "fields">;
607
+ /**
608
+ * Preview a Farcaster user
609
+ *
610
+ * Resolve a numeric fid or @handle to a Farcaster user for the FARCASTER_FOLLOW builder.
611
+ */
612
+ previewFarcaster<ThrowOnError extends boolean = false>(parameters: {
613
+ query: string;
614
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<GatePreviewFarcasterResponses, GatePreviewFarcasterErrors, ThrowOnError, "fields">;
463
615
  }
464
616
  export declare class Mechanic extends HeyApiClient {
465
617
  /**
@@ -515,7 +667,7 @@ export declare class Mechanic extends HeyApiClient {
515
667
  /**
516
668
  * Add mechanic deployment
517
669
  *
518
- * Register a mechanic contract deployment on a specific chain. Upserts if a deployment already exists for the chain.
670
+ * Register a mechanic's contract address on a chain. Replaces the address if that chain already has one.
519
671
  */
520
672
  addDeployment<ThrowOnError extends boolean = false>(parameters: {
521
673
  mechanicId: string;
@@ -527,7 +679,7 @@ export declare class Media extends HeyApiClient {
527
679
  /**
528
680
  * Create media upload session
529
681
  *
530
- * Create a media asset and return the worker upload URL the client should PUT bytes to. Call /:mediaId/process once the PUT completes.
682
+ * Create a pending media asset and return an upload URL with the required request headers.
531
683
  */
532
684
  createUploadSession<ThrowOnError extends boolean = false>(parameters: {
533
685
  kind: MediaKind;
@@ -539,7 +691,7 @@ export declare class Media extends HeyApiClient {
539
691
  /**
540
692
  * Upload media bytes
541
693
  *
542
- * Stream the file body to the worker, which writes it to storage and immediately drives the asset through processing. File assets come back Ready; Directory assets come back Processing (zip extraction running). Call /:mediaId/process to retry a Failed Directory.
694
+ * Write the request body to storage and start processing. Files return Ready; directories return Processing while extraction runs.
543
695
  */
544
696
  upload<ThrowOnError extends boolean = false>(parameters: {
545
697
  mediaId: string;
@@ -547,15 +699,15 @@ export declare class Media extends HeyApiClient {
547
699
  /**
548
700
  * Process a media asset
549
701
  *
550
- * Drive the media asset toward Ready. Call after PUTting bytes to /:mediaId/upload to finalize the upload (File assets become Ready; Directory assets trigger zip extraction). Idempotent — assets that are already Ready or currently Processing are returned as-is. Failed Directory assets re-trigger extraction.
702
+ * Retry processing for a failed directory. The operation is idempotent and leaves Ready or Processing assets unchanged.
551
703
  */
552
704
  process<ThrowOnError extends boolean = false>(parameters: {
553
705
  mediaId: string;
554
706
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaProcessResponses, MediaProcessErrors, ThrowOnError, "fields">;
555
707
  /**
556
- * List children of a Directory media asset
708
+ * List directory files
557
709
  *
558
- * Returns a paginated list of File children (e.g. per-token metadata or extracted archive files).
710
+ * List the extracted files in a directory with cursor pagination.
559
711
  */
560
712
  listChildren<ThrowOnError extends boolean = false>(parameters: {
561
713
  mediaId: string;
@@ -565,7 +717,7 @@ export declare class Media extends HeyApiClient {
565
717
  /**
566
718
  * Delete a media asset
567
719
  *
568
- * Delete the media asset and its R2 objects. Arweave archive locations remain on-chain (immutable) but are no longer referenced. Fails with 409 if still referenced by a collection contract or generative collection code.
720
+ * Delete a media record and its R2 objects. An immutable Arweave archive remains available. Returns 409 when a contract or generative collection still references the media.
569
721
  */
570
722
  delete<ThrowOnError extends boolean = false>(parameters: {
571
723
  mediaId: string;
@@ -581,34 +733,95 @@ export declare class Media extends HeyApiClient {
581
733
  /**
582
734
  * Publish media to archive
583
735
  *
584
- * Mirror the media asset to its immutable archive provider (Arweave). File media publishes the single blob; Directory media publishes a manifest of all children. Idempotent — returns early if already archived.
736
+ * Archive media to Arweave. Files publish one blob; directories publish their children and a manifest. The operation is idempotent.
585
737
  */
586
738
  publish<ThrowOnError extends boolean = false>(parameters: {
587
739
  mediaId: string;
588
740
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaPublishResponses, MediaPublishErrors, ThrowOnError, "fields">;
589
741
  /**
590
- * Get a child File Entity by path
742
+ * Get a child file by path
591
743
  *
592
- * Returns the child File's full Entity (with locations and status). Use `entity.url` to fetch bytes directly from the storage provider.
744
+ * Get an extracted file by path, including its status and storage locations.
593
745
  */
594
746
  getChild<ThrowOnError extends boolean = false>(parameters: {
595
747
  mediaId: string;
596
748
  path: string;
597
749
  }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<MediaGetChildResponses, MediaGetChildErrors, ThrowOnError, "fields">;
598
750
  }
751
+ export declare class Tx extends HeyApiClient {
752
+ /**
753
+ * Get transaction status
754
+ *
755
+ * Get the transaction's domain milestones and their status. The overall status reaches Ready after all expected milestones finish. Use the `/ws` route for live updates.
756
+ */
757
+ status<ThrowOnError extends boolean = false>(parameters: {
758
+ chainId: number;
759
+ txHash: string;
760
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TxStatusResponses, TxStatusErrors, ThrowOnError, "fields">;
761
+ /**
762
+ * Submit a transaction for tracking
763
+ *
764
+ * Submit a broadcast transaction hash for domain processing and milestone tracking. Returns the current snapshot; use the `/ws` route for live updates.
765
+ */
766
+ submit<ThrowOnError extends boolean = false>(parameters: {
767
+ chainId: number;
768
+ txHash: string;
769
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<TxSubmitResponses, TxSubmitErrors, ThrowOnError, "fields">;
770
+ }
771
+ export declare class Profile extends HeyApiClient {
772
+ /**
773
+ * Get authenticated profile
774
+ *
775
+ * Get the private profile for the authenticated account, including its email.
776
+ */
777
+ get<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<ProfileGetResponses, ProfileGetErrors, ThrowOnError, "fields">;
778
+ /**
779
+ * Update authenticated profile
780
+ *
781
+ * Update private profile fields. Avatar media must be an owned, ready User-scope image file.
782
+ */
783
+ update<ThrowOnError extends boolean = false>(parameters?: {
784
+ displayName?: string | null;
785
+ bio?: string | null;
786
+ website?: string | null;
787
+ avatarMediaId?: string | null;
788
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ProfileUpdateResponses, ProfileUpdateErrors, ThrowOnError, "fields">;
789
+ /**
790
+ * Get public profile
791
+ *
792
+ * Get a wallet's public profile. Valid wallet addresses without a registered account return an address-only fallback profile.
793
+ */
794
+ public<ThrowOnError extends boolean = false>(parameters: {
795
+ walletAddress: string;
796
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ProfilePublicResponses, ProfilePublicErrors, ThrowOnError, "fields">;
797
+ /**
798
+ * List public wallet tokens
799
+ *
800
+ * Get a wallet's token holdings across live collections. This is available for every valid EVM address, including addresses without a registered account.
801
+ */
802
+ tokens<ThrowOnError extends boolean = false>(parameters: {
803
+ walletAddress: string;
804
+ page?: number;
805
+ limit?: number;
806
+ sort?: "tokenId" | "name" | "mintedAt";
807
+ order?: "asc" | "desc";
808
+ collectionId?: string;
809
+ search?: string;
810
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<ProfileTokensResponses, ProfileTokensErrors, ThrowOnError, "fields">;
811
+ }
599
812
  export declare class Siwe extends HeyApiClient {
600
813
  /**
601
814
  * Issue a SIWE nonce
602
815
  *
603
- * Issues a single-use, short-lived nonce for use as the `nonce` field of a SIWE (EIP-4361) message.
816
+ * Issue a single-use, short-lived nonce for the `nonce` field of a SIWE (EIP-4361) message.
604
817
  */
605
818
  nonce<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): import("./client").RequestResult<UserSiweNonceResponses, UserSiweNonceErrors, ThrowOnError, "fields">;
606
819
  }
607
820
  export declare class User extends HeyApiClient {
608
821
  /**
609
- * Sign in user
822
+ * Sign in
610
823
  *
611
- * Sign in with a provider credential (Privy id_token or SIWE message + signature) and receive access/refresh tokens plus user.
824
+ * Exchange a Privy ID token or signed SIWE message for Highlight access and refresh tokens.
612
825
  */
613
826
  signin<ThrowOnError extends boolean = false>(parameters: {
614
827
  body: {
@@ -662,16 +875,31 @@ export declare class HighlightClient extends HeyApiClient {
662
875
  client?: Client;
663
876
  key?: string;
664
877
  });
878
+ /**
879
+ * Activate a chain indexer
880
+ *
881
+ * Start or wake indexing for an enabled chain. Administrative use only.
882
+ */
665
883
  postIndexerChainsByChainIdActivate<ThrowOnError extends boolean = false>(parameters: {
666
884
  chainId: number;
667
- }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdActivateResponses, unknown, ThrowOnError, "fields">;
885
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdActivateResponses, PostIndexerChainsByChainIdActivateErrors, ThrowOnError, "fields">;
886
+ /**
887
+ * Reset a chain indexer
888
+ *
889
+ * Move a chain's indexing cursor to a block so later polls reprocess from that point. Administrative use only.
890
+ */
668
891
  postIndexerChainsByChainIdReset<ThrowOnError extends boolean = false>(parameters: {
669
892
  chainId: number;
670
893
  blockNumber: number;
671
- }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdResetResponses, unknown, ThrowOnError, "fields">;
894
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdResetResponses, PostIndexerChainsByChainIdResetErrors, ThrowOnError, "fields">;
895
+ /**
896
+ * Poll a chain indexer
897
+ *
898
+ * Run one indexing cycle for an enabled chain. Administrative use only.
899
+ */
672
900
  postIndexerChainsByChainIdPoll<ThrowOnError extends boolean = false>(parameters: {
673
901
  chainId: number;
674
- }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdPollResponses, unknown, ThrowOnError, "fields">;
902
+ }, options?: Options<never, ThrowOnError>): import("./client").RequestResult<PostIndexerChainsByChainIdPollResponses, PostIndexerChainsByChainIdPollErrors, ThrowOnError, "fields">;
675
903
  private _collection?;
676
904
  get collection(): Collection;
677
905
  private _token?;
@@ -686,6 +914,10 @@ export declare class HighlightClient extends HeyApiClient {
686
914
  get mechanic(): Mechanic;
687
915
  private _media?;
688
916
  get media(): Media;
917
+ private _tx?;
918
+ get tx(): Tx;
919
+ private _profile?;
920
+ get profile(): Profile;
689
921
  private _user?;
690
922
  get user(): User;
691
923
  private _apiKey?;