Class BitBadgesAddressList<T>

Type Parameters

T extends NumberType

Hierarchy (view full)

AddressListDoc<T>
- BitBadgesAddressList

Implements

Constructors

constructor

new BitBadgesAddressList<T>(data): BitBadgesAddressList<T>
Type Parameters
- T extends NumberType
Parameters
- data: iBitBadgesAddressList<T>
Returns BitBadgesAddressList<T>
Overrides AddressListDoc.constructor
- Defined in src/api-indexer/BitBadgesAddressList.ts:63

Properties

_docId

_docId: string

A unique stringified document ID

`Optional`_id

_id?: string

A unique document ID (Mongo DB ObjectID)

addresses

addresses: string[]

The addresses of the address list. If this is a tracker list, the addresses are the tracker IDs.

`Optional`aliasAddress

aliasAddress?: string

The alias BitBadges address of the address list.

claims

claims: ClaimDetails<T>[]

The claims of the address list.

createdBlock

createdBlock: T

The block number when this list was created

createdBy

createdBy: string

The BitBadges address of the user who created this list

customData

customData: string

Arbitrary custom data that can be stored on-chain.

lastUpdated

lastUpdated: T

The timestamp of when this list was last updated (milliseconds since epoch)

listId

listId: string

The ID of the address list.

listsActivity

listsActivity: ListActivityDoc<T>[]

The activity of the address list.

`Optional`metadata

metadata?: Metadata<T>

The metadata of the address list.

`Optional`nsfw

nsfw?: {
reason: string;
}

The NSFW reason if this list is NSFW

`Optional`private

private?: boolean

True if this list is private and will not show up in search results

`Optional`reported

reported?: {
reason: string;
}

The reported reason if this list is reported

updateHistory

updateHistory: iUpdateHistory<T>[]

The update history of this list

uri

uri: string

The URI where to fetch the address list metadata from.

`Optional`viewableWithLink

viewableWithLink?: boolean

True if this list is viewable if queried by the list ID directly

views

views: {
    [viewId: string]: {
        ids: string[];
        pagination: PaginationInfo;
        type: string;
    };
}

The views of the address list.

whitelist

whitelist: boolean

Whether or not to include ONLY the addresses or include all EXCEPT the addresses.

Methods

checkAddress

checkAddress(address): boolean
Checks if a specific account is in the given address list. This means added to a whitelist or NOT included in a blacklist.
Parameters
- address: string
Returns boolean
Remarks
The double negative may get confusing.
Inherited from AddressListDoc.checkAddress
- Defined in src/core/addressLists.ts:46

clone

clone(): BitBadgesAddressList<T>
Deep copies the object and returns a new instance.

Returns BitBadgesAddressList<T>
Implementation of CustomType.clone
Overrides AddressListDoc.clone
- Defined in src/api-indexer/BitBadgesAddressList.ts:79

convert

convert(convertFunction, options?): BitBadgesAddressList
Converts the object to a different NumberType equivalent.
Type Parameters
- U extends NumberType
Parameters
- convertFunction: ((item: NumberType) => U)
 - - (item): U
 - Parameters
 item: NumberType
 Returns U
- Optionaloptions: ConvertOptions
Returns BitBadgesAddressList
Implementation of CustomType.convert
Overrides AddressListDoc.convert
- Defined in src/api-indexer/BitBadgesAddressList.ts:75

equals

equals(other, normalizeNumberTypes?): boolean
Compares this object's fields to another object's fields for equality. Equality is determined by comparing the JSON representations of the objects.

If normalizeNumberTypes is true, then all number types will be compared as strings (i.e. "1n" === "1" === 1). Else, they will be compared as their native types (i.e. 1n !== 1 !== "1").
Type Parameters
- U extends CustomType
Parameters
- other: undefined | null | CustomType
- OptionalnormalizeNumberTypes: boolean
Returns boolean
Implementation of CustomType.equals
Inherited from AddressListDoc.equals
- Defined in src/common/base.ts:71

fetchAllForView

fetchAllForView(api, viewType, viewId): Promise<void>
Fetches all the documents for a specific view. 1 second delay between each fetch to avoid rate limiting.
Parameters
- api: BaseBitBadgesApi<T>
- viewType: "listActivity"
- viewId: string
Returns Promise<void>
- Defined in src/api-indexer/BitBadgesAddressList.ts:177

fetchNextForView

fetchNextForView(api, viewType, viewId): Promise<void>
Fetches the next batch of documents for a specific view. 25 documents are fetched at a time. This updates the view in the class instance, as well as handling the pagination.
Parameters
- api: BaseBitBadgesApi<T>
- viewType: "listActivity"
- viewId: string
Returns Promise<void>
- Defined in src/api-indexer/BitBadgesAddressList.ts:144

getActivityView

getActivityView(viewId): ListActivityDoc<T>[]
Gets the documents array for a specific view.
Parameters
- viewId: string
Returns ListActivityDoc<T>[]
- Defined in src/api-indexer/BitBadgesAddressList.ts:194

getNumberFieldNames

getNumberFieldNames(): string[]
Internal helper method to convert the number fields of the object to a different NumberType equivalent.

Returns string[]
Implementation of CustomType.getNumberFieldNames
Overrides AddressListDoc.getNumberFieldNames
- Defined in src/api-indexer/BitBadgesAddressList.ts:71

getOverlapDetails

getOverlapDetails(addressList): [AddressList, AddressList, AddressList]
Gets the overlap details for two address lists. Returns [inFirstListButNotSecond, inBothLists, inSecondListButNotFirst].
Parameters
- addressList: iAddressList
Returns [AddressList, AddressList, AddressList]
Inherited from AddressListDoc.getOverlapDetails
- Defined in src/core/addressLists.ts:123

getOverlaps

getOverlaps(addressList): AddressList
Gets the addresses that are in both lists.

Note the returned value can be a whitelist or a blacklist, depending on the input lists. For example, all addresses except Bob (blacklist) overlap or just Bob (whitelist) overlap.
Parameters
- addressList: iAddressList
Returns AddressList
Inherited from AddressListDoc.getOverlaps
- Defined in src/core/addressLists.ts:115

getView

getView(viewType, viewId): ListActivityDoc<T>[]
Type safe method to get the documents array for a specific view.
Parameters
- viewType: "listActivity"
- viewId: string
Returns ListActivityDoc<T>[]
- Defined in src/api-indexer/BitBadgesAddressList.ts:187

getViewBookmark

getViewBookmark(viewId): string
Gets the bookmark for a specific view. This is to be passed into the fetchNextForView method.
Parameters
- viewId: string
Returns string
- Defined in src/api-indexer/BitBadgesAddressList.ts:136

getViewPagination

getViewPagination(viewId): PaginationInfo
Gets the pagination for a specific view ({ bookmark, hasMore }).
Parameters
- viewId: string
Returns PaginationInfo
- Defined in src/api-indexer/BitBadgesAddressList.ts:129

hasNumberFields

hasNumberFields(): boolean
Checks if the object has number fields.

Returns boolean
Implementation of CustomType.hasNumberFields
Inherited from AddressListDoc.hasNumberFields
- Defined in src/common/base.ts:85

invert

invert(): this
Inverts the list in-place. Simply done by invert the whitelist property.

Returns this
Inherited from AddressListDoc.invert
- Defined in src/core/addressLists.ts:63

isEmpty

isEmpty(): boolean
Returns boolean
Inherited from AddressListDoc.isEmpty
- Defined in src/core/addressLists.ts:56

isStoredOffChain

isStoredOffChain(): boolean
Returns true if the address list is stored off-chain. Off-chain lists are stored in the database and are not part of the blockchain. They are updatable, deletable, and can be used for surveys. On-chain lists are immutable and are created through blockchain transactions.

Returns boolean
- Defined in src/api-indexer/BitBadgesAddressList.ts:204

remove

remove(addresses): this
Removes addresses from the list in-place.

If this is a whitelist, the address will be removed (if it is currently added). If this is a blacklist, the address will be added (if it is not currently added). Otherwise, it is a no-op since it is already removed.
Parameters
- addresses: string | iAddressList
Returns this
Inherited from AddressListDoc.remove
- Defined in src/core/addressLists.ts:82

toInverted

toInverted(): AddressList
Returns a new list with the addresses inverted.

Returns AddressList
Inherited from AddressListDoc.toInverted
- Defined in src/core/addressLists.ts:71

toJson

toJson(): JsonObject
Converts the object to a JSON object with all primitive types.

Returns JsonObject
Implementation of CustomType.toJson
Inherited from AddressListDoc.toJson
- Defined in src/common/base.ts:63

toJsonString

toJsonString(): string
Converts the object to a JSON string.

Returns string
Implementation of CustomType.toJsonString
Inherited from AddressListDoc.toJsonString
- Defined in src/common/base.ts:67

toProto

toProto(): proto.badges.AddressList
Returns proto.badges.AddressList
Inherited from AddressListDoc.toProto
- Defined in src/core/addressLists.ts:365

toRemoved

toRemoved(addresses): AddressList
Wrapper for remove that returns a new list instead of modifying the current one.
Parameters
- addresses: string | iAddressList
Returns AddressList
Inherited from AddressListDoc.toRemoved
- Defined in src/core/addressLists.ts:105

updateWithNewResponse

updateWithNewResponse(newResponse, forceful?): void
Updates the current list with a new response
Parameters
- newResponse: BitBadgesAddressList<T>
- Optionalforceful: boolean
Returns void
- Defined in src/api-indexer/BitBadgesAddressList.ts:211

viewHasMore

viewHasMore(viewId): boolean
Returns if the view has more pages to be fetched. If we have reached the end of the view, this will return false.
Parameters
- viewId: string
Returns boolean
- Defined in src/api-indexer/BitBadgesAddressList.ts:122

`Static`AllAddresses

AllAddresses(): AddressList
Returns the reserved 'All' address list.

Returns AddressList
Inherited from AddressListDoc.AllAddresses
- Defined in src/core/addressLists.ts:132

`Static`CreateAddressList

CreateAddressList<T>(api, payload): Promise<CreateAddressListsSuccessResponse>
Creates a new address list off-chain. On-chain lists are created through blockchain transactions.

Behind the scenes, this is just an alias for UpdateAddressList.
Type Parameters
- T extends NumberType
Parameters
- api: BaseBitBadgesApi<T>
- payload: CreateAddressListsPayload<T>
Returns Promise<CreateAddressListsSuccessResponse>
- Defined in src/api-indexer/BitBadgesAddressList.ts:249

`Static`DeleteAddressList

DeleteAddressList<T>(api, payload): Promise<DeleteAddressListsSuccessResponse>
Deletes an off-chain address list. On-chain lists are deleted through blockchain transactions.
Type Parameters
- T extends NumberType
Parameters
- api: BaseBitBadgesApi<T>
- payload: DeleteAddressListsPayload
Returns Promise<DeleteAddressListsSuccessResponse>
- Defined in src/api-indexer/BitBadgesAddressList.ts:291

`Static`FetchAndInitialize

FetchAndInitialize<T>(api, options): Promise<BitBadgesAddressList<T>>
Fetches and initializes a BitBadgesAddressList from the API. Must pass in a valid BitBadgesApi instance.
Type Parameters
- T extends NumberType
Parameters
- api: BaseBitBadgesApi<T>
- options: {
 listId: string;
 viewsToFetch?: {
 bookmark: string;
 viewId: string;
 viewType: "listActivity";
 }[];
 }
 - listId: string
 - OptionalviewsToFetch?: {
 bookmark: string;
 viewId: string;
 viewType: "listActivity";
 }[]
Returns Promise<BitBadgesAddressList<T>>
- Defined in src/api-indexer/BitBadgesAddressList.ts:86

`Static`FetchAndInitializeBatch

FetchAndInitializeBatch<T>(api, options): Promise<BitBadgesAddressList<T>[]>
Fetches and initializes a batch of BitBadgesAddressList from the API. Must pass in a valid BitBadgesApi instance.
Type Parameters
- T extends NumberType
Parameters
- api: BaseBitBadgesApi<T>
- options: {
 listId: string;
 viewsToFetch?: {
 bookmark: string;
 viewId: string;
 viewType: "listActivity";
 }[];
 }[]
Returns Promise<BitBadgesAddressList<T>[]>
- Defined in src/api-indexer/BitBadgesAddressList.ts:104

`Static`GetAddressLists

GetAddressLists<T>(api, payload): Promise<GetAddressListsSuccessResponse<T>>
Gets address lists from the API.
Type Parameters
- T extends NumberType
Parameters
- api: BaseBitBadgesApi<T>
- payload: GetAddressListsPayload
Returns Promise<GetAddressListsSuccessResponse<T>>
- Defined in src/api-indexer/BitBadgesAddressList.ts:226

`Static`Reserved

Reserved(addressListId): AddressList
Returns a reserved address list by ID.
Parameters
- addressListId: string
Returns AddressList
Inherited from AddressListDoc.Reserved
- Defined in src/core/addressLists.ts:139

`Static`UpdateAddressList

UpdateAddressList<T>(api, payload): Promise<UpdateAddressListsSuccessResponse>
Updates an off-chain address list. On-chain lists are updated through blockchain transactions.
Type Parameters
- T extends NumberType
Parameters
- api: BaseBitBadgesApi<T>
- payload: UpdateAddressListsPayload<T>
Returns Promise<UpdateAddressListsSuccessResponse>
- Defined in src/api-indexer/BitBadgesAddressList.ts:270

`Static`fromJson

fromJson(jsonValue, options?): AddressList
Parameters
- jsonValue: JsonValue
- Optionaloptions: Partial<JsonReadOptions>
Returns AddressList
Inherited from AddressListDoc.fromJson
- Defined in src/core/addressLists.ts:369

`Static`fromJsonString

fromJsonString(jsonString, options?): AddressList
Parameters
- jsonString: string
- Optionaloptions: Partial<JsonReadOptions>
Returns AddressList
Inherited from AddressListDoc.fromJsonString
- Defined in src/core/addressLists.ts:373

`Static`fromProto

fromProto(item): AddressList
Parameters
- item: proto.badges.AddressList
Returns AddressList
Inherited from AddressListDoc.fromProto
- Defined in src/core/addressLists.ts:377

`Static`generateReservedListId

generateReservedListId(addressList): string
Generates a list ID for a given address list.
Parameters
- addressList: iAddressList
  The address list to generate the ID for
Returns string
Inherited from AddressListDoc.generateReservedListId
- Defined in src/core/addressLists.ts:342

`Static`getOverlapDetails

getOverlapDetails(firstList, secondList): [AddressList, AddressList, AddressList]
Gets the overlap details between two address lists. Returns [inFirstButNotSecond, overlaps, inSecondButNotFirst].
Parameters
- firstList: iAddressList
- secondList: iAddressList
Returns [AddressList, AddressList, AddressList]
Inherited from AddressListDoc.getOverlapDetails
- Defined in src/core/addressLists.ts:222

`Static`getReservedAddressList

getReservedAddressList(addressListId): AddressList
Returns the address list for a list ID, if it is a reserved ID (i.e. Mint, Manager, All, None, validly formatted address, ...)
Parameters
- addressListId: string
Returns AddressList
Inherited from AddressListDoc.getReservedAddressList
- Defined in src/core/addressLists.ts:239

`Static`getReservedTrackerList

getReservedTrackerList(trackerListId): AddressList
Returns the tracker list for a tracker ID list. Little different logic because tracker ID lists can only be reserved IDs (no storage) and can be nonvalid addresses
Parameters
- trackerListId: string
Returns AddressList
Inherited from AddressListDoc.getReservedTrackerList
- Defined in src/core/addressLists.ts:232

Class BitBadgesAddressList<T>

Type Parameters

Hierarchy (view full)

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Type Parameters

Parameters

Returns BitBadgesAddressList<T>

Properties

_docId

Optional_id

addresses

OptionalaliasAddress

claims

createdBlock

createdBy

customData

lastUpdated

listId

listsActivity

Optionalmetadata

Optionalnsfw

Optionalprivate

Optionalreported

updateHistory

uri

OptionalviewableWithLink

views

whitelist

Methods

checkAddress

Parameters

Returns boolean

Remarks

clone

Returns BitBadgesAddressList<T>

convert

Type Parameters

Parameters

Parameters

Returns U

Returns BitBadgesAddressList<U>

equals

Type Parameters

Parameters

Returns boolean

fetchAllForView

Parameters

Returns Promise<void>

fetchNextForView

Parameters

Returns Promise<void>

getActivityView

Parameters

Returns ListActivityDoc<T>[]

getNumberFieldNames

Returns string[]

getOverlapDetails

Parameters

Returns [AddressList, AddressList, AddressList]

getOverlaps

Parameters

Returns AddressList

getView

Parameters

Returns ListActivityDoc<T>[]

getViewBookmark

Parameters

Returns string

getViewPagination

Parameters

Returns PaginationInfo

hasNumberFields

Returns boolean

invert

`Optional`_id

`Optional`aliasAddress

`Optional`metadata

`Optional`nsfw

`Optional`private

`Optional`reported

`Optional`viewableWithLink

`Static`AllAddresses

`Static`CreateAddressList

`Static`DeleteAddressList

`Static`FetchAndInitialize

`Optional`viewsToFetch?: {
bookmark: string;
viewId: string;
viewType: "listActivity";
}[]

`Static`FetchAndInitializeBatch

`Static`GetAddressLists

`Static`Reserved

`Static`UpdateAddressList

`Static`fromJson

`Static`fromJsonString

`Static`fromProto

`Static`generateReservedListId

`Static`getOverlapDetails