Transfer a single NFT

Transfer ownership of an NFT purchased in FIAT to another account on the Voucher Ledger.

await api.send.transferFiatNft(recipientAvnAddress, nftId);

important

This operation uses a relayer account that the sender authorizes to submit the transfer transaction. You can learn more about relayers HERE.

important

You can get the VL_GATEWAY_URL and Relayer here.

Example

const { AvnApi, SetupMode, SigningMode } = require("avn-api");
const VL_GATEWAY_URL = "https://gateway.testnet.voucherledger.com/";

const singleUserOptions = {
	suri: "0x5392ca60a61aea99fce14358798de93c1bc11c3696a905718738c71fae539c24", // this is from the generated example account
	setupMode: SetupMode.SingleUser,
	signingMode: SigningMode.SuriBased,
};

const avnSdk = new AvnApi(VL_GATEWAY_URL, singleUserOptions);

// replace with the nftID of the NFT you're trying to list.
const NFT_ID = "0xcd...f6";

//This can be the address or public key.
const RECIPIENT_ADDRESS = "5Fb...yTh";

async function main() {
	await avnSdk.init();
	const api = await avnSdk.apis();

	let request_id = await api.send.transferFiatNft(RECIPIENT_ADDRESS, NFT_ID);
	// Returns a request id
	console.log(request_id);
}

(async () => {
	await main();
})();

You have now successfully submitted a transaction to the VL to transfer NFT.

Example Result

f1710fe7-141f-43c1-b1bb-6ec33d9b3e9a

JSON-RPC

REQUEST POST https://VL_GATEWAY_URL/send

HEADERS Content-Type: application/json Authorization': bearer <awtToken>

REQUEST PARAMS

• relayer [required] - a string representing the relayer's SS58 address.
• user [required] - a string representing the user's SS58 address.
• payer [required] - a string representing the payer's SS58 address.
• nftId [required] - a string representing the NFT ID (32 bytes) to check for nonce.
• recipient [required] - a hex string representing the recipient's public key.
• nonce [required] - string integer value of the current proxy nonce of type 'nft'
• proxySignature [required] - a proof signed by the user allowing the transaction to be proxied.
• feePaymentSignature [required] - a proof signed by the payer allowing the relayer fees to be paid.
• paymentNonce [required] - string integer value of the current payment nonce of the payer.

JSON-RPC Example

curl https://VL-GATEWAY-URL/send \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: bearer <awtToken>" \
    -d '{"jsonrpc":"2.0", "method":"proxyTransferFiatNft", "params":{"relayer":"5FbUQ2kJWLo...Gyu6UoZaryTh", "user":"5DAgxVxKmn...rSVJDdMr", "payer":"5DAgxVxKmn...rSVJDdMr", "nftId":"0x3044598a96da039d27802b300ba6197d6a023752efaccf598e62516f6ee7587c", "recipient":"5FgyNN84CzQfwHBUJWvQkr36hiQYEXjDhcUYVx9tCTdgqosF", "nonce":"10", "proxySignature":"0xaa3b454549de3a941e19...d5912f83b1e0c43083b1103f9655c52290221bf590facd9e99a839cafc383c30567055a56c97c8a", "feePaymentSignature":"0x500da1ab75346f...6acd0be0ca93da71bbe55d11f8df8f64f3b99c2c47a053495bf6eb842ecc4fbfad6b87", "paymentNonce":"212"}, "id":1}'

result - a request ID that can be queried for the transaction's status

JSON-RPC Output

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": "5415c92b-57a5-46f7-ba79-57176afb2510"
}

---

tip

You can query the state of your transaction here using the returned request id.

Production Example

Multiple NFTs have changed ownership on the VL, and HERE is a link to the VL Explorer that provides more detail on a transferred NFT. Click on the Advanced tab on the page to view more details on the transaction.