Transfer Digital Passport to Another Wallet

Transfer Digital Passport to Target Wallet Address

As a brand, you wish to allow your users to transfer digital passports from a user's wallet to another wallet address. To do so, our API generates the request ownership link.

⚠️
Every new transfer link is based on a new passphrase. That means old links will not work anymore.

URL

To trigger a transfer, use https://custody.arianee.com/{{client}}/{{chainType}}/nft/transfer.

POST - https://custody.arianee.com/{{client}}/{{chainType}}/nft/transfer

Body

Field	Type	Required	Description
`protocolName`	String - `testnet`, `mainnet`, `arianeetestnet`, `mumbai`, `polygon`, `arialabs`, `stadetoulousain`, `ysl`, `testnetSbt`, `arianeeSupernet`, `arianeesbt`, `tezostestnet`, `supernettestnet`, `etherlinktestnet`	✅	Protocol on which the digital passport has been minted. Dig deeper into Arianee Protocols.
`smartAssetId`	String	✅	Digital passport identification number to claim.
`to`	String	✅	Digital passport recipient.

{
    "protocolName": "testnet",
    "smartAssetId": "967188109",
    "to": "0x4febba33415ab41256cbc981c178297f926a6490"
}

📌
If the transfer is initiated by another user than the digital passport's owner, the passphrase is mandatory.

Return Payload

Status Code	Success	Description
`200`	`true`	`true`: The transaction has been sent to the blockchain.

{
    "success": true
}

Errors

Status Code	Return Payload	Description
`400`	`false`	- The digital passport ID must be a string. - Missing passport ID.
`404`	`false`	The wallet may not exist. You are not authenticated.
`500`	`false`	You are not the digital passport owner.

{
    "success": true
}

{
    "success": false,
    "error": "error while transfering the smart asset, make sure you are the owner and that the id is valid"
}

Transfer Digital Passport using Link

URL

Use the https://custody.arianee.com/{{client}}/{{chainType}}/nft/createTransferLink.

POST - https://custody.arianee.com/{{client}}/{{chainType}}/nft/createTransferLink

Body

Field	Type	Required	Description
`protocolName`	String - `testnet`, `mainnet`, `arianeetestnet`, `mumbai`, `polygon`, `arialabs`, `stadetoulousain`, `ysl`, `testnetSbt`, `arianeeSupernet`, `arianeesbt`, `tezostestnet`, `supernettestnet`, `etherlinktestnet`	✅	Protocol on which the digital passport has been minted. Dig deeper into Arianee Protocols.
`smartAsset` → `id`	Object	✅	Digital passport identification number.
params	Object	❌	Other optional parameters such as passphrase.

{
    "protocolName": "testnet",
    "smartAsset" : {
        "id": "33491174"
    },
  "params":{
   	passphrase:"whdj3bun7lo7" // optional, auto-generated 
  }
}

Return Payload

Status Code	Success	Description
`200`	`true`	The `link` is generated.

{
    "link": "https://test.arian.ee/33491174,ombwfl2suu5m"
}

Error

Status Code	Success	Description
`404`	`false`	The wallet may not exist. You are not authenticated.
`403`	`false`	You are not the owner or issuer of this digital passport.
`404`	`false`	No digital passport was found using this ID.