storefront-service-api

GraphQL API Reference

GraphQl endpoints for storefront-service!

API Endpoints

# devel:
https://storefront-service.devel.original.works
# staging:
https://storefront-service.stage.original.works
# prod:
https://storefront-service.original.works

Queries

collectionEntities

Response

Returns a CollectionEntityConnection!

Arguments

Name
Description

Specify to filter the records returned. Default = {}

paging - OffsetPaging!

Limit or page results. Default = {limit: 10}

Specify to sort results. Default = []

Example

Query

Variables

Response

Queries

collectionEntity

Response

Returns a CollectionEntity!

Arguments

Name
Description

id - ID!

The id of the record to find.

Example

Query

Variables

Response

Queries

collectionEntityRelation

Response

Returns a CollectionEntityRelation!

Arguments

Name
Description

id - ID!

The id of the record to find.

Example

Query

Variables

Response

Queries

collectionEntityRelations

Response

Returns a CollectionEntityRelationConnection!

Arguments

Name
Description

Specify to filter the records returned. Default = {}

paging - OffsetPaging!

Limit or page results. Default = {limit: 10}

Specify to sort results. Default = []

Example

Query

Variables

Response

Queries

contactByNickName

Description

Returns a contact by nickname.

Response

Returns a ContactDto!

Arguments

Name
Description

nickName - String!

nick name of a contact

Example

Query

Variables

Response

Queries

contactByWalletAddress

Description

Returns a contact by wallet address.

Response

Returns a ContactDto!

Arguments

Name
Description

walletAddress - String!

wallet address of a contact

Example

Query

Variables

Response

Queries

contacts

Description

Returns contacts of a contactBook entity.

Response

Returns a ContactsDto!

Example

Query

Response

Queries

getEntityByTokenPayload

Response

Returns a CollectionEntity!

Example

Query

Response

Queries

networkConfigByNameV2

Description

Returns networkConfig for given network name

Response

Returns a NetworkConfigV2Model!

Arguments

Name
Description

networkName - NetworkName!

Example

Query

Variables

Response

Queries

networkConfigs

Response

Returns a NetworkConfigConnection!

Arguments

Name
Description

Specify to filter the records returned. Default = {}

paging - OffsetPaging!

Limit or page results. Default = {limit: 10}

Specify to sort results. Default = []

Example

Query

Variables

Response

Queries

networkConfigsV2

Description

Returns list of networkConfigs

Response

Returns [NetworkConfigV2Model!]!

Example

Query

Response

Queries

publicNetworkConfigsV2

Description

Returns list of networkConfigs without sensitive data

Response

Returns [NetworkConfigPublicModel!]!

Example

Query

Response

Queries

testConfig

Response

Returns a String!

Example

Query

Response

Mutations

createContact

Description

Create contact record. Returns record of the contactBook entity.

Response

Returns a ContactDto!

Arguments

Name
Description

nickName - String!

nick name of a contact

walletAddress - String!

wallet address of a contact

Example

Query

Variables

Response

Mutations

createOneCollectionEntity

Response

Returns a CollectionEntity!

Arguments

Name
Description

Example

Query

Variables

Response

Mutations

createRelation

Response

Returns a CollectionEntityRelation!

Arguments

Name
Description

Example

Query

Variables

Response

Mutations

createS3Url

Description

🔒 JWT Token

Creates an s3 url for enterprise's avatar or banner

Response

Returns a S3LinkRes!

Arguments

Name
Description

s3ReqDto - S3LinkReq!

🔒 JWT Token

defines fileName and contentType

Example

Query

Variables

Response

Mutations

deleteContact

Description

Delete contact record. Returns record of the contactBook entity.

Response

Returns a ContactDto!

Arguments

Name
Description

id - Float!

id of a contact

Example

Query

Variables

Response

Mutations

deleteManyCollectionEntities

Response

Returns a DeleteManyResponse!

Arguments

Name
Description

Example

Query

Variables

Response

Mutations

deleteManyRelations

Response

Returns a DeleteManyResponse!

Arguments

Example

Query

Variables

Response

Mutations

deleteOneCollectionEntity

Response

Returns a CollectionEntityDeleteResponse!

Arguments

Name
Description

Example

Query

Variables

Response

Mutations

deleteOneRelation

Response

Returns a CollectionEntityRelationDeleteResponse!

Arguments

Example

Query

Variables

Response

Mutations

updateContact

Description

Update contact record. Returns record of the contactBook entity.

Response

Returns a ContactDto!

Arguments

Name
Description

id - Float!

id of a contact

nickName - String

nick name of a contact

walletAddress - String

wallet address of a contact

Example

Query

Variables

Response

Mutations

updateManyCollectionEntities

Response

Returns an UpdateManyResponse!

Arguments

Name
Description

Example

Query

Variables

Response

Mutations

updateOneCollectionEntity

Response

Returns a CollectionEntity!

Arguments

Name
Description

Example

Query

Variables

Response

Types

Boolean

Description

The Boolean scalar type represents true or false.

Example

Types

CollectionEntity

Description

represents an element of the hierarchy within the enterprise.

Fields

Field Name
Description

avatarUrl - String

avatar url, displayed on the storefront.

bannerUrl - String

banner url, displayed on the storefront.

createdAt - DateTime!

Time at which the object was created.

description - String

Entity description.

email - String

collection entity email.

entityUri - String

Identifier of the entity. This value corresponds to the ID from the revelator database.

id - ID!

Auto-incrementing identifier.

name - String!

Entity name.

networkConfigs - [NetworkConfig!]!

Arguments

filter - NetworkConfigFilter!

Specify to filter the records returned.

sorting - [NetworkConfigSort!]!

Specify to sort results.

redirectDomains - [RedirectDomain!]!

Arguments

filter - RedirectDomainFilter!

Specify to filter the records returned.

sorting - [RedirectDomainSort!]!

Specify to sort results.

tenant - Tenant!

tenantId - ID!

Tenant ID to which artists, enterprise and labels belong.

Specifies the type of entry. Represents the hierarchy level within the enterprise.

updatedAt - DateTime!

Time at which the object was last updated.

Example

Types

CollectionEntityConnection

Fields

Field Name
Description

Array of nodes.

pageInfo - OffsetPageInfo!

Paging information

totalCount - Int!

Fetch total count of records

Example

Types

CollectionEntityDeleteFilter

Fields

Example

Types

CollectionEntityDeleteResponse

Fields

Field Name
Description

avatarUrl - String

avatar url, displayed on the storefront.

bannerUrl - String

banner url, displayed on the storefront.

createdAt - DateTime

Time at which the object was created.

description - String

Entity description.

email - String

collection entity email.

entityUri - String

Identifier of the entity. This value corresponds to the ID from the revelator database.

id - ID

Auto-incrementing identifier.

name - String

Entity name.

tenantId - ID

Tenant ID to which artists, enterprise and labels belong.

Specifies the type of entry. Represents the hierarchy level within the enterprise.

updatedAt - DateTime

Time at which the object was last updated.

Example

Types

CollectionEntityFilter

Fields

Example

Types

CollectionEntityFilterRedirectDomainFilter

Fields

Example

Types

CollectionEntityFilterTenantFilter

Fields

Example

Types

CollectionEntityRelation

Description

represents a relationship between two entities.

Fields

Field Name
Description

childEntityId - String!

Relationship child ID.

createdAt - DateTime!

Time at which the object was created.

id - ID!

Auto-incrementing identifier.

network - NetworkConfig!

parentEntityId - String!

Relationship parent ID.

Specifies the type of the relation. For example: LABEL -> ARTIST.

tenant - Tenant!

tenantId - String!

Tenant ID to which artists, enterprise and labels belong.

updatedAt - DateTime!

Time at which the object was last updated.

Example

Types

CollectionEntityRelationConnection

Fields

Field Name
Description

Array of nodes.

pageInfo - OffsetPageInfo!

Paging information

totalCount - Int!

Fetch total count of records

Example

Types

CollectionEntityRelationDeleteFilter

Fields

Example

Types

CollectionEntityRelationDeleteResponse

Fields

Field Name
Description

childEntityId - String

Relationship child ID.

createdAt - DateTime

Time at which the object was created.

id - ID

Auto-incrementing identifier.

parentEntityId - String

Relationship parent ID.

Specifies the type of the relation. For example: LABEL -> ARTIST.

tenantId - String

Tenant ID to which artists, enterprise and labels belong.

updatedAt - DateTime

Time at which the object was last updated.

Example

Types

CollectionEntityRelationFilter

Fields

Example

Types

CollectionEntityRelationFilterNetworkConfigFilter

Fields

Input Field
Description

activitiesSubgraphUrl - StringFieldComparison

agreementFactoryAddress - StringFieldComparison

agreementSubgraphUrl - StringFieldComparison

alchemyApiKey - StringFieldComparison

defaultStripeFeeInPercent - IntFieldComparison

feeManagerAddress - StringFieldComparison

lendingContractAddress - StringFieldComparison

marketAddress - StringFieldComparison

marketOwner - StringFieldComparison

nativeCoinDecimals - IntFieldComparison

nftSubgraphUrl - StringFieldComparison

payeeVaultFactoryAddress - StringFieldComparison

paymentBatcherFactoryAddress - StringFieldComparison

royaltyLoanFactoryAddress - StringFieldComparison

studioPublicJsonRpcUrl - StringFieldComparison

Example

Types

CollectionEntityRelationFilterTenantFilter

Fields

Example

Types

CollectionEntityRelationSort

Fields

Input Field
Description

Example

Types

CollectionEntityRelationSortFields

Values

Enum Value
Description

childEntityId

createdAt

id

parentEntityId

relationType

tenantId

updatedAt

Example

Types

CollectionEntityRelationType

Values

Enum Value
Description

ENTERPIRSE_ARTIST

ENTERPIRSE_LABEL

LABEL_ARTIST

TENANT_ENTERPRISE

Example

Types

CollectionEntityRelationTypeFilterComparison

Fields

Example

Types

CollectionEntitySort

Fields

Input Field
Description

Example

Types

CollectionEntitySortFields

Values

Enum Value
Description

avatarUrl

bannerUrl

createdAt

description

email

entityUri

id

name

tenantId

type

updatedAt

Example

Types

CollectionEntityType

Values

Enum Value
Description

ARTIST

ENTERPRISE

LABEL

Example

Types

CollectionEntityTypeFilterComparison

Fields

Example

Types

CollectionEntityUpdateFilter

Fields

Example

Types

ContactDto

Description

contact object

Fields

Field Name
Description

createdAt - DateTime!

Time at which the object was created.

id - Float!

Unique identifier for the contact.

nickName - String!

Name of a contact.

ownerUri - String!

Revelator unique identifier for an enterprise.

updatedAt - DateTime!

Time at which the object was last updated.

walletAddress - String!

Wallet address of a contact.

Example

Types

ContactsDto

Fields

Field Name
Description

count - Float!

Example

Types

CreateCollectionEntity

Fields

Input Field
Description

avatarUrl - String

avatar url, displayed on the storefront.

bannerUrl - String

banner url, displayed on the storefront.

description - String

Entity description.

email - String

collection entity email.

entityUri - String

Identifier of the entity. This value corresponds to the ID from the revelator database.

name - String!

Entity name.

networkNames - [NetworkName!]!

Specifies the type of entry. Represents the hierarchy level within the enterprise.

Example

Types

CreateCollectionEntityRelation

Fields

Input Field
Description

childEntityId - String!

Relationship child ID.

parentEntityId - String!

Relationship parent ID.

Specifies the type of the relation. For example: LABEL -> ARTIST.

Example

Types

CreateOneCollectionEntityInput

Fields

Input Field
Description

collectionEntity - CreateCollectionEntity!

The record to create

Example

Types

CurrenciesModel

Fields

Field Name
Description

lendingToken - CurrencyModel!

nativeCoin - CurrencyModel!

otherCurrencies - [CurrencyModel!]!

Example

Types

CurrencyModel

Fields

Field Name
Description

address - String!

decimals - Float!

symbol - String!

Example

Types

DateFieldComparison

Fields

Input Field
Description

Example

Types

DateFieldComparisonBetween

Fields

Input Field
Description

lower - DateTime!

upper - DateTime!

Example

Types

DateTime

Description

A date-time string at UTC, such as 2019-12-03T09:54:33Z, compliant with the date-time format.

Example

Types

DeleteManyCollectionEntitiesInput

Fields

Input Field
Description

Filter to find records to delete

Example

Types

DeleteManyCollectionEntityRelationsInput

Fields

Input Field
Description

Filter to find records to delete

Example

Types

DeleteManyResponse

Fields

Field Name
Description

deletedCount - Int!

The number of records deleted.

Example

Types

DeleteOneCollectionEntityInput

Fields

Input Field
Description

id - ID!

The id of the record to delete.

Example

Types

DeleteOneCollectionEntityRelationInput

Fields

Input Field
Description

id - ID!

The id of the record to delete.

Example

Types

FileType

Values

Enum Value
Description

ENTITY_AVATAR

ENTITY_BANNER

Example

Types

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example

Types

ID

Description

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Example

Types

IDFilterComparison

Fields

Input Field
Description

eq - ID

gt - ID

gte - ID

iLike - ID

in - [ID!]

is - Boolean

isNot - Boolean

like - ID

lt - ID

lte - ID

neq - ID

notILike - ID

notIn - [ID!]

notLike - ID

Example

Types

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example

Types

IntFieldComparison

Fields

Input Field
Description

eq - Int

gt - Int

gte - Int

in - [Int!]

is - Boolean

isNot - Boolean

lt - Int

lte - Int

neq - Int

notIn - [Int!]

Example

Types

IntFieldComparisonBetween

Fields

Input Field
Description

lower - Int!

upper - Int!

Example

Types

NetworkCapabilities

Values

Enum Value
Description

Agreements

NFT

Example

Types

NetworkCapabilitiesFilterComparison

Fields

Example

Types

NetworkCapabilitiesModel

Fields

Field Name
Description

networkCapability - NetworkCapabilities!

List of capabilities | describe what can be done on a given chain.

Example

Types

NetworkCapability

Description

Network capability

Fields

Field Name
Description

networkCapability - NetworkCapabilities!

List of capabilities | describe what can be done on a given chain.

Example

Types

NetworkCapabilityFilter

Fields

Example

Types

NetworkCapabilitySort

Fields

Input Field
Description

Example

Types

NetworkCapabilitySortFields

Values

Enum Value
Description

networkCapability

Example

Types

NetworkConfig

Description

Network configuration object

Fields

Field Name
Description

activitiesSubgraphUrl - String!

activities subgraph url address

agreementFactoryAddress - String!

agreement factory eth address

agreementSubgraphUrl - String!

agreements subgraph url address

alchemyApiKey - String!

Alchemy API key

capabilities - [NetworkCapability!]!

Arguments

filter - NetworkCapabilityFilter!

Specify to filter the records returned.

sorting - [NetworkCapabilitySort!]!

Specify to sort results.

chainId - Int!

blockchain identifier

createdAt - DateTime!

Time at which the object was created.

defaultStripeFeeInPercent - Int!

Default stripe fee %

dmmAddress - String

Dynamic Modular Metadata contract address

feeManagerAddress - String!

fee manager contract eth address

id - ID!

Auto-incrementing identifier.

jsonRpcUrl - String!

json rpc url address use to connect to the node

lendingContractAddress - String!

lending contract eth address

marketAddress - String

Nft-market eth contract address

marketOwner - String

Nft-market owner eth address

nativeCoin - String!

Native currency code

nativeCoinDecimals - Int!

Native currency decimal value

networkName - NetworkName!

Name of the blockchain network on which the transaction occurs

nftSubgraphUrl - String

Nft-subgraph url address

payeeVaultFactoryAddress - String

Address of Payment Batcher Factory contract

paymentBatcherFactoryAddress - String

Address of Payment Batcher Factory contract

royaltyLoanFactoryAddress - String

Address of Royalty Loan Factory contract

studioPublicJsonRpcUrl - String!

json rpc url address for studio frontend app use to connect to the node

updatedAt - DateTime!

Time at which the object was last updated.

Example

Types

NetworkConfigConnection

Fields

Field Name
Description

Array of nodes.

pageInfo - OffsetPageInfo!

Paging information

totalCount - Int!

Fetch total count of records

Example

Types

NetworkConfigFilter

Fields

Input Field
Description

activitiesSubgraphUrl - StringFieldComparison

agreementFactoryAddress - StringFieldComparison

agreementSubgraphUrl - StringFieldComparison

alchemyApiKey - StringFieldComparison

defaultStripeFeeInPercent - IntFieldComparison

feeManagerAddress - StringFieldComparison

lendingContractAddress - StringFieldComparison

marketAddress - StringFieldComparison

marketOwner - StringFieldComparison

nativeCoinDecimals - IntFieldComparison

nftSubgraphUrl - StringFieldComparison

payeeVaultFactoryAddress - StringFieldComparison

paymentBatcherFactoryAddress - StringFieldComparison

royaltyLoanFactoryAddress - StringFieldComparison

studioPublicJsonRpcUrl - StringFieldComparison

Example

Types

NetworkConfigFilterNetworkCapabilityFilter

Fields

Example

Types

NetworkConfigPublicModel

Fields

Field Name
Description

List of capabilities | describe what can be done on a given chain.

chainId - Float!

blockchain identifier

isTestNet - Boolean!

is blockchain a testnet

networkName - NetworkName!

Name of the blockchain network on which the transaction occurs

studioPublicJsonRpcUrl - String!

json rpc url address for studio frontend app use to connect to the node

Example

Types

NetworkConfigSort

Fields

Input Field
Description

Example

Types

NetworkConfigSortFields

Values

Enum Value
Description

activitiesSubgraphUrl

agreementFactoryAddress

agreementSubgraphUrl

alchemyApiKey

chainId

createdAt

defaultStripeFeeInPercent

dmmAddress

feeManagerAddress

id

jsonRpcUrl

lendingContractAddress

marketAddress

marketOwner

nativeCoin

nativeCoinDecimals

networkName

nftSubgraphUrl

payeeVaultFactoryAddress

paymentBatcherFactoryAddress

royaltyLoanFactoryAddress

studioPublicJsonRpcUrl

updatedAt

Example

Types

NetworkConfigV2Model

Fields

Field Name
Description

agreementFactoryAddress - String!

agreement factory eth address

agreementSubgraphUrl - String!

agreements subgraph url address

List of capabilities | describe what can be done on a given chain.

chainId - Float!

blockchain identifier

createdAt - DateTime!

Time at which the object was created.

currencies - CurrenciesModel

explorer - String!

blockchain explorer for review transactions

feeManagerAddress - String!

fee manager contract eth address

id - String!

Auto-incrementing identifier.

ipfsEndpoint - String!

ipfs endpoint url use to upload files and factsheets

isTestNet - Boolean!

is blockchain a testnet

jsonRpcUrl - String!

json rpc url address use to connect to the node

lendingContractAddress - String!

lending contract eth address

marketAddress - String

Nft-market eth contract address

marketOwner - String

Nft-market owner eth address

networkName - NetworkName!

Name of the blockchain network on which the transaction occurs

nftSubgraphUrl - String

Nft-subgraph url address

updatedAt - DateTime!

Time at which the object was last updated.

Example

Types

NetworkName

Values

Enum Value
Description

amoy

base

baseSepolia

binance

bnbtest

ethereum

goerli

kovan

local

mainnet

mumbai

ownet

polygon

ropsten

sepolia

shibuya

test

Example

Types

NetworkNameFilterComparison

Fields

Input Field
Description

Example

Types

NumberFieldComparison

Fields

Input Field
Description

eq - Float

gt - Float

gte - Float

is - Boolean

isNot - Boolean

lt - Float

lte - Float

neq - Float

notIn - [Float!]

Example

Types

NumberFieldComparisonBetween

Fields

Input Field
Description

lower - Float!

upper - Float!

Example

Types

OffsetPageInfo

Fields

Field Name
Description

hasNextPage - Boolean

true if paging forward and there are more records.

hasPreviousPage - Boolean

true if paging backwards and there are more records.

Example

Types

OffsetPaging

Fields

Input Field
Description

limit - Int

Limit the number of records returned

offset - Int

Offset to start returning records from

Example

Types

RedirectDomain

Fields

Field Name
Description

domain - String!

Example

Types

RedirectDomainFilter

Fields

Example

Types

RedirectDomainSort

Fields

Input Field
Description

Example

Types

RedirectDomainSortFields

Values

Enum Value
Description

domain

Example

Types

S3LinkReq

Fields

Input Field
Description

contentType - String!

mime type of the file -> image/jpeg

entityId - String!

The ID of the record to update

fileName - String!

the file name must contain its extension -> [name].jpg

imageType - FileType!

indicates the type of image uploaded (banner or avatar).

Example

Types

S3LinkRes

Fields

Field Name
Description

uploadUrl - String!

Example

Types

SortDirection

Description

Sort Directions

Values

Enum Value
Description

ASC

DESC

Example

Types

SortNulls

Description

Sort Nulls Options

Values

Enum Value
Description

NULLS_FIRST

NULLS_LAST

Example

Types

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example

Types

StringFieldComparison

Fields

Input Field
Description

eq - String

gt - String

gte - String

iLike - String

is - Boolean

isNot - Boolean

like - String

lt - String

lte - String

neq - String

notILike - String

notIn - [String!]

notLike - String

Example

Types

Tenant

Description

Tenant ID to which artists, enterprise and labels belong.

Fields

Field Name
Description

createdAt - DateTime!

Time at which the object was created.

id - ID!

Auto-incrementing identifier.

minPaymentBatcherBalanceInUSDC - Float

Min payment batcher balance value

name - String!

Tenant name.

paymentBatcherAddress - String

Address of the contract user by tenant to make royalty payments.

tenantUri - String!

Identifier of the tenant. This value corresponds to the tenant ID from the revelator database.

updatedAt - DateTime!

Time at which the object was last updated.

Example

Types

UpdateCollectionEntity

Fields

Input Field
Description

avatarUrl - String

avatar url, displayed on the storefront.

bannerUrl - String

banner url, displayed on the storefront.

description - String

Entity description.

email - String

collection entity email.

entityUri - String

Identifier of the entity. This value corresponds to the ID from the revelator database.

name - String

Entity name.

Example

Types

UpdateManyCollectionEntitiesInput

Fields

Input Field
Description

Filter used to find fields to update

The update to apply to all records found using the filter

Example

Types

UpdateManyResponse

Fields

Field Name
Description

updatedCount - Int!

The number of records updated.

Example

Types

UpdateOneCollectionEntityInput

Fields

Input Field
Description

id - ID!

The id of the record to update

The update to apply.

Example

Documentation by Anvil SpectaQL

Last updated

Was this helpful?