Manage Digital Passport

Retrieve owned digital passport(s) for a user

Retrieve the digital passports owned by a user in the wallet associated.

Method

wallet.smartAsset.getOwned(onlyFromBrands?, i18nStrategy?:useLanguages)

Parameter	Type	Required	Description
`language`	`en-US`, `fr-FR`...	❌	Language(s) returned in order of preference.
`onlyFromBrands`	String	❌	Allows to return digital passports owned by the user and issued by the issuer's identity only.

Return Payload

promise returns an array with the digital passport's information.

Parameter	Description
`ArianeeProductCertificateI18N`	Digital passport Schema.
`BlockchainEvent[]`	Gathering of transaction events of the token recorded on the blockchain.
`Event[]`	Event Schema.

[
	{
    data: {
      certificateId: '58824256',
      content: ArianeeProductCertificateI18N,
      rawContent: ArianeeProductCertificateI18N,
      blockchainEvents: BlockchainEvent[],
      imprint: '0xce917f8d652187e7bf162b2c05d4b5439cef04142795eb6e5d2283b6193b8e88',
      isAuthentic: true,
      isRequestable: false,
      issuer: '0x90d181a3e977E8CcD7822B711Bb3A83E79beaEFF',
      owner: '0xa9bc90d24d0b8495043ab5857455444630028caf',
      protocol: { name: "testnet"; chainId: 77 }
    },
    arianeeEvents: Event[]
  }
]

Retrieve digital passport from ID

Retrieve a specific digital passport.

Method

wallet.smartAsset.get(protocol, {id: nftId, passphrase?: passphrase}, i18nStrategy?:useLanguages)

Parameter	Type	Required	Description
`nftId`	Number	✅	Identification number of the digital passport.
`passphrase`	String	❌	A passphrase of the digital passport. Param optional is you are the owner of the digital passport.
`protocol`	`mainnet` or `testnet`	✅	Blockchain network of the digital passport ID.
`language`	`en-US`, `fr-FR`...	❌	Language(s) returned in order of preference.

Result: promise returns an object with the digital passport information.

Parameter	Description
`ArianeeProductCertificateI18N`	Digital Passport Schema.
`BlockchainEvent[]`	Gathering of transaction events of the token recorded on the blockchain.
`Event[]`	Event Schema.

{
    data: {
      certificateId: '58824256',
      content: ArianeeProductCertificateI18N,
      rawContent: ArianeeProductCertificateI18N,
      blockchainEvents: BlockchainEvent[],
      imprint: '0xce917f8d652187e7bf162b2c05d4b5439cef04142795eb6e5d2283b6193b8e88',
      isAuthentic: true,
      isRequestable: false,
      issuer: '0x90d181a3e977E8CcD7822B711Bb3A83E79beaEFF',
      owner: '0xa9bc90d24d0b8495043ab5857455444630028caf',
      protocol: { name: "testnet"; chainId: 77 }
    },
    arianeeEvents: Event[]
  }

Retrieve digital passport from the link

Retrieve the content and data from the deep link of a specific digital passport.

Method

wallet.smartAsset.getFromLink(link, resolveFinalNft?, i18nStrategy?)

Parameter	Type	Required	Description
`link`	String	✅	Deeplink of the digital passport → `https://arian.ee/tokenId,passphrase`
`resolveFinalNft`	Boolean	✅	- `true`: try to add the Arianee Access Token in the request.- `false`: get the landing digital passport.
`language`	`en-US`, `fr-FR`...	❌	Language(s) returned in order of preference.

Return Payload

promise returns an object with the NFT information.

Parameter	Description
`ArianeeProductCertificateI18N`	Digital Passport Schema.
`BlockchainEvent[]`	Gathering of transaction events of the token recorded on the blockchain.
`Event[]`	Event Schema.

{
    data: {
      certificateId: '58824256',
      content: ArianeeProductCertificateI18N,
      rawContent: ArianeeProductCertificateI18N,
      blockchainEvents: BlockchainEvent[],
      imprint: '0xce917f8d652187e7bf162b2c05d4b5439cef04142795eb6e5d2283b6193b8e88',
      isAuthentic: true,
      isRequestable: false,
      issuer: '0x90d181a3e977E8CcD7822B711Bb3A83E79beaEFF',
      owner: '0xa9bc90d24d0b8495043ab5857455444630028caf',
      protocol: { name: "testnet"; chainId: 77 }
    },
    arianeeEvents: Event[]
  }

Create ownership request link

Method

wallet.smartAsset.createRequestLink(network, tokenId, passphrase?)

Parameter	Type	Required	Description
`network`	String	✅	Network of the digital passport.
`tokenId`	Number	✅	Arianee token ID of the digital passport.
`passphrase`	String	✅	Token request passphrase. This param is optional if you are the digital passport owner.

const wallet = new Wallet({ chainType: 'mainnet' });
const nft = await wallet.smartAsset.getOwned();
const proofLink = await nft[0].createProofLink();

Return Payload

The ownership link is returned.

Create proof link

Method

wallet.smartAsset.createProofLink(network, tokenId, passphrase?)

Parameter	Type	Required	Description
`network`	String	✅	Network of the digital passport.
`tokenId`	Number	✅	Arianee token ID of the digital passport.
`passphrase`	String	✅	Token request passphrase. This param is optional if you are the digital passport owner.

const wallet = new Wallet({ chainType: 'mainnet' });
const nft = await wallet.smartAsset.getOwned();
const proofLink = await nft[0].createProofLink();

Return Payload

The proof of ownership link is returned.

Claim digital passport

Method

wallet.smartAsset.claim(network, tokenId, passphrase, receiver?)

Parameter	Type	Required	Description
`network`	String	✅	Network of the digital passport.
`tokenId`	Number	✅	Arianee token ID of the digital passport.
`passphrase`	String	✅	Token request passphrase. This param is optional if you are the digital passport owner.
`receiver`	String	❌	Recipient wallet of the digital passport.

const wallet = new Wallet({ chainType: 'mainnet' });
const nft = await wallet.smartAsset.getFromLink("https://test.arian.ee/762482926,bnj9vdx3kbhj");
await nft.claim();

Return Payload

The transaction request is sent to the blockchain.

Get started with Arianee's recipe 🚀

Transfer digital passport

Transfer a digital passport from the owner's wallet to another.

Method

wallet.smartAsset.transfer(receiver: string)

Parameter	Type	Required	Description
`receiver`	String	✅	The wallet address of the receiver.

Return Payload

promise returns the transaction receipt.