Numbers Protocol

The Numbers Protocol is a groundbreaking asset-centric cross-network protocol that has gained trust and usage in various domains such as art, music, NFT platforms, and the metaverse. It is also venturing into applications for AI companies to trace digital media provenance. With the Numbers Protocol blockchain connector integrated into VDP, developers can seamlessly integrate third-party blockchain services. This integration brings data verifiability and traceability, marking a significant advancement in secure data management.

The Numbers Protocol blockchain connector allows users to convert a wide range of data into Web3 assets. By utilizing this connector, your data file will be pinned on the IPFS network with on-chain records through the Numbers Gateway, ensuring permanent storage. Additionally, the assets generated can be easily accessed and explored using the Numbers Search Engine. To see an example of a Web3 asset created using this connector, click here.

Generated Web3 asset sample using Stability AI AI connector (Stable Diffusion XL) on Numbers Search Engine using Numbers blockchain connector
Generated Web3 asset sample using Stability AI AI connector (Stable Diffusion XL) on Numbers Search Engine using Numbers blockchain connector

#Release Stage

Alpha

#Resource Configuration

The resource configuration is used for setting up the connection to NumbersProtocol. For the up-to-date configuration, refer to here.

FieldTypeNote
capture_token*stringFill your Capture token in the Capture App. To access your tokens, you need a Capture App account, and you can sign in with an email or wallet to acquire the Capture Token.

#No-code Setup

PREREQUISITES

To create a Numbers Protocol blockchain connector, you'll first need to create a Capture Account. Then, check the documentation about how to aquire Capture Token.

New accounts are granted 3 NUM credits, the native token of the decentralized photo network. NUM tokens are used in the process of converting data into Web3 assets, and new users can register up to 120 assets at no cost.

To create a Numbers Protocol blockchain connector on VDP:

  1. Go to the Resource page and click Add Resource
  2. Select Numbers Protocol
  3. In the configuration page, fill an ID for Numbers connecotor resource, this will be the unique identifier of this connector
  4. [Optional] Give a short description of your connector in the Description field
  5. Fill the following information and click Set up
    • Fill Capture token. Follow the Capture App documentation to aquire your capture token

#Low-code Setup

  1. Create a Numbers Protocol blockchain connector:
cURL
Copy

curl --location 'http://localhost:8080/vdp/v1alpha/users/<user-id>/connecotor-resources'
--header 'Authorization: Bearer <Your-API-Token>'
--data '{
"id": "my-numbers",
"connector_definition_name": "connector-definitions/blockchain-numbers",
"configuration": {
"capture_token": "<capture-token>"
}
}'

For other operations, please refer to the VDP Protobufs.

#Connector Configuration

The connector configuration is used for setting up the input data and parameters of this component. The configuration is configured in pipeline recipe, please refer to pipeline for more details.

FieldTypeNote
input.images*array[string]The images you want to upload to blockchain in base64 format
input.asset_creatorstringName of the asset creator.
input.abstractstringA summary or abstract of the asset.
input.custom.digital_source_typestringSpecify the type of the source. More details see here
input.custom.mining_preferencestringDesignates the selection made by the asset creators or licensed owners to decide if the asset is suitable for inclusion in a data mining or AI/ML training workflow. More details see here
input.custom.generated_throughstringURL of the service that is used to generate the content.
input.custom.generated_bystringThe AI model used to generate the content.
input.custom.creator_walletstringThe Wallet address of the asset creator.
input.custom.license.namestringLicense of the asset file.
input.custom.license.documentstringURL of the asset file.

When using the Numbers Protocol blockchain connector in your pipeline, certain fields of the input data need to be filled to trigger the pipeline effectively. Here are the expected input and output data fields for the Numbers Protocol blockchain connector.

#No-code Setup

#Low-code Setup

This is a sample configuration in the pipeline recipe.


{
"configuration": {
"input": {
"images": ["{ start.image }", "/9j/xxxx"],
"asset_creator": "Xiaofei Du",
"abstract": "Xiaofei's Web3 creation",
"custom": {
"digital_source_type": "trainedAlgorithmicMedia",
"mining_preference": "notAllowed",
"generated_by": "Stability AI's Stable Diffusion XL 1.0",
"license": {
"name": "CC BY-SA",
"document": "https://creativecommons.org/licenses/by-sa/4.0"
}
}
}
}
}

#Expected Input Data Fields

The expected input data fields has similar strucutre as input fields of connector configuration.

FieldTypeNote
inputs[idx].images*array[string]The images you want to upload to blockchain in base64 format
inputs[idx].asset_creatorstringName of the asset creator.
inputs[idx].abstractstringA summary or abstract of the asset.
inputs[idx].custom.digital_source_typestringSpecify the type of the source. More details see here
inputs[idx].custom.mining_preferencestringDesignates the selection made by the asset creators or licensed owners to decide if the asset is suitable for inclusion in a data mining or AI/ML training workflow. More details see here
inputs[idx].custom.generated_throughstringURL of the service that is used to generate the content.
inputs[idx].custom.generated_bystringThe AI model used to generate the content.
inputs[idx].custom.creator_walletstringThe Wallet address of the asset creator.
inputs[idx].custom.license.namestringLicense of the asset file.
inputs[idx].custom.license.documentstringURL of the asset file.

{
"inputs": [
{
"images": ["/9j/xxxx", "/9j/xxxx"],
"asset_creator": "Xiaofei Du",
"abstract": "Xiaofei's Web3 creation",
"custom": {
"digital_source_type": "trainedAlgorithmicMedia",
"mining_preference": "notAllowed",
"generated_by": "Stability AI's Stable Diffusion XL 1.0",
"license": {
"name": "CC BY-SA",
"document": "https://creativecommons.org/licenses/by-sa/4.0"
}
}
}
]
}

#Expected Output Data Fields

Output data fieldTypeDescription
asset_urls*array[string]Asset profile links on Numbers Search Engine

{
"outputs": [
{
"asset_urls": [
"https://nftsearch.site/asset-profile?cid=bafybeih2hysv22xywwsuodt5dnjjizvnywvf66mlqs3anq7d7ja7f6ywte",
"https://nftsearch.site/asset-profile?cid=bafybeih2hysv22xywwsuodt5dnjjizvnywvf66mlqs3anq7d7ja7f6ywte"
]
}
]
}

By following the guideline, you can effectively integrate with the Numbers Protocol to register your assets on the blockchain.

Last updated: 1/8/2024, 8:56:57 AM