Data Marshal Node Gateway Endpoints

The Data Marshal is the node that brokers the trade of data between a Data Creator and a Data Consumer. Learn more about the

When you mint a Data NFT via the (devnet) or via the you will be asked for a Data Marshal gateway endpoint as one of the minting parameters. For example, as you follow this , you will see the following code snippet.

const mintTransaction: Transaction = await dataNftMinter.mint(
    new Address(address),
    "MY_GM_DATA", // Short token Name (between 3 and 20 alphanumeric characters - no spaces)
    "https://data_marshal_URL.com", // The Data Marshal gateway endpoint (see below for options for devnet vs mainnet)
    "https://data_stream_URL.com/protected_data_stream", // The Data Stream URL
    "https://data_preview_URL.com", // the public Data Preview URL
    1500, // // Royalty in % with 2 trailing zeros (e.g. 1500 is 15% or 500 would be 5% or 0 would be 0%. Max is 5000 of 50%)
    5000, // Collection size (supply)
    "My Gaming Data", // Title (between 10 and 60 alphanumeric characters with spaces allowed)
    "My PlayStation gaming data in JSON format", // Description (between 10 and 400 alphanumeric characters with spaces allowed)
    antiSpamTax, // Live Anti Spam Tax value
    {
      nftStorageToken: "XXX" // nft.storage API token
    }
);

On line 4, you will see that you need to provide a Data Marshal gateway endpoint. You can use the following endpoints depending on your environments and use cases that you are building for.

Data Marshal Node Type

Mainnet Endpoint

Devnet Endpoint

Features

Limitations

Achilles

https://api.itheumcloud.com/datamarshalapi/achilles/v1

https://api.itheumcloud-stg.com/datamarshalapi/achilles/v1

Data brokering, Native Auth, Nested Streams, High Scalability

Only supports Data Streams with maximum size of 4.5MB

Brontes

https://api.itheumcloud.com/datamarshalapi/brontes/v1

https://api.itheumcloud-stg.com/datamarshalapi/brontes/v1

Data brokering, Native Auth, Nested Streams, Support Data Streams over 4.5MB

Limited Scalability

Router [Recommended] The router is recommended as it will use the most up to data Data Marshal

https://api.itheumcloud.com/datamarshalapi/router/v1

https://api.itheumcloud-stg.com/datamarshalapi/router/v1

Same as Brontes

PreviousData Marshal Network NextData Marshal Transit Flags and Headers

Last updated 1 year ago

const mintTransaction: Transaction = await dataNftMinter.mint( new Address(address), "MY_GM_DATA", // Short token Name (between 3 and 20 alphanumeric characters - no spaces) "https://data_marshal_URL.com", // The Data Marshal gateway endpoint (see below for options for devnet vs mainnet) "https://data_stream_URL.com/protected_data_stream", // The Data Stream URL "https://data_preview_URL.com", // the public Data Preview URL 1500, // // Royalty in % with 2 trailing zeros (e.g. 1500 is 15% or 500 would be 5% or 0 would be 0%. Max is 5000 of 50%) 5000, // Collection size (supply) "My Gaming Data", // Title (between 10 and 60 alphanumeric characters with spaces allowed) "My PlayStation gaming data in JSON format", // Description (between 10 and 400 alphanumeric characters with spaces allowed) antiSpamTax, // Live Anti Spam Tax value { nftStorageToken: "XXX" // nft.storage API token } );