Creating new NFT series

Creating new NFT series

Creating a new NFT series requires function call to the paras token contract. The media and reference must be an IPFS hash OR an absolute URL.
type TokenMetadata = {
title: string|null, // ex. "Arch Nemesis: Mail Carrier" or "Parcel #5055"
description: string|null, // free-form description
media: string|null, // URL to associated media, preferably to decentralized, content-addressed storage
media_hash: string|null, // Base64-encoded sha256 hash of content referenced by the `media` field. Required if `media` is included.
copies: number|null, // number of copies of this set of metadata in existence when token was minted.
issued_at: number|null, // When token was issued or minted, Unix epoch in milliseconds
expires_at: number|null, // When token expires, Unix epoch in milliseconds
starts_at: number|null, // When token starts being valid, Unix epoch in milliseconds
updated_at: number|null, // When token was last updated, Unix epoch in milliseconds
extra: string|null, // anything extra the NFT wants to store on-chain. Can be stringified JSON.
reference: string|null, // URL to an off-chain JSON file with more info.
reference_hash: string|null // Base64-encoded sha256 hash of JSON from reference field. Required if `reference` is included.
}
// Create new series
// Arguments
// * `token_metadata`: approved account to transfer
// * `price`: initial price, null for "not for sale"
// * `royalty`: map of accountId with royalty percentage
function nft_create_series(
token_metadata: TokenMetadata,
price: string|null,
royalty: HashMap<AccountId, U128>,
): TokenSeriesJson

Important metadata

Metadata
Explanation
title
Example: "Key to Paras", the first minted NFT will have "Key to Paras #1" as the title
media
IPFS hash of an image or GIF
reference
IPFS hash of JSON document
copies
This will determined how many NFTs can be minted

Royalty

Royalty will be divided by 10000, so for 10% royalty, you have to write 1000.
(1000 / 10000 = 0.1)

Using near-cli

near call --accountId projectp.testnet paras-token-v1.testnet nft_create_series '{"creator_id":"projectp.testnet","token_metadata":{"title":"Dark","media":"bafybeifdbvb6yzajogbe4dbn3bgxoli3sp7ol7upfmu2givpvbwufydthu","reference":"bafybeifvzitvju4ftwnkf7w7yakz7i5colcey223uk2ui4t5z3ss7l2od4","copies":100},"price":"1000000000000000000000000","royalty":{"projectp.testnet":100}}' --depositYocto 8540000000000000000000

Using javascript

const nearAPI = require('near-api-js')
const main = async () => {
const config = {
networkId: 'testnet',
nodeUrl: 'https://rpc.testnet.near.org',
walletUrl: 'https://wallet.testnet.near.org',
appName: 'Paras Testnet',
contractName: `paras-token-v2.testnet`
}
try {
// Initializing nearAPI
// Login and init contract
const keyStore = new nearAPI.keyStores.UnencryptedFileSystemKeyStore(
`${process.env.HOME}/.near-credentials/`
)
const connection = await nearAPI.connect({
deps: {
keyStore: keyStore,
},
...config,
})
const account_id = 'orang.testnet'
const account = await connection.account(account_id)
const contract = await new nearAPI.Contract(
account,
config.contractName,
{
changeMethods: [
'nft_create_series'
],
}
)
const formattedParams = {
token_metadata: {
title: 'Dark',
media: 'bafybeifdbvb6yzajogbe4dbn3bgxoli3sp7ol7upfmu2givpvbwufydthu',
reference: 'bafybeifvzitvju4ftwnkf7w7yakz7i5colcey223uk2ui4t5z3ss7l2od4',
copies: 100
},
price: null,
royalty: {
[account_id]: 1000
}
}
const ret = await contract.nft_create_series(
formattedParams,
300000000000000, // attached GAS
"8540000000000000000000"
)
console.log(ret)
} catch (err) {
throw err
}
}
main()