SAVITRI-721 : Standard NFT

SAVITRI-721 (SNT1 -- Savitri Non-Fungible Token) est le standard NFT pour le Savitri Network, équivalent à l'ERC-721 d'Ethereum. Chaque jeton possède un identifiant unique et un seul propriétaire.

Interface

Fonction	Paramètres	Retourne	Description
balance_of	owner	u64	Nombre de NFT possédés par une adresse
owner_of	token_id	address	Propriétaire d'un jeton spécifique
transfer_from	from, to, token_id	Result	Transférer un NFT
approve	to, token_id	Result	Approuver une adresse pour transférer le jeton
safe_transfer_from	from, to, token_id	Result	Transfert avec vérifications de sécurité
token_uri	token_id	String	Obtenir l'URI des métadonnées du jeton
mint	to, token_id, uri	Result	Frapper un nouveau NFT

Disposition du Stockage

Plage d'Emplacement	Utilisation	Dérivation
0-99	BaseContract (réservé)	Directe
100+	Propriétaires de jetons	keccak256(100 || token_id)
200+	Soldes de jetons	keccak256(200 || address)
300+	Approbations de jetons	keccak256(300 || token_id)
400+	URIs de jetons	keccak256(400 || token_id)

Le hachage Keccak256 empêche les collisions d'emplacements entre les catégories (par exemple, le token_id 100 n'entrera pas en collision avec l'emplacement de base des soldes).

Frapper un NFT

use savitri_contracts::contracts::standards::savitri721::SAVITRI721;

SAVITRI721::mint(
    &mut contract_storage,
    &storage,
    &recipient,             // [u8; 32]
    42,                     // token_id: u64
    "ipfs://Qm.../meta",   // token URI
    &mut event_system,
    Some(&mut gas_meter),
)?;

Transfert

// Direct transfer
SAVITRI721::transfer_from(
    &mut contract_storage,
    &storage,
    &from,          // current owner
    &to,            // new owner
    42,             // token_id
    &mut event_system,
    Some(&mut gas_meter),
)?;

Interrogation

// Who owns token #42?
let owner = SAVITRI721::owner_of(&contract_storage, &storage, 42)?;

// How many NFTs does this address own?
let count = SAVITRI721::balance_of(&contract_storage, &storage, &address)?;

// Get metadata URI
let uri = SAVITRI721::token_uri(&contract_storage, &storage, 42)?;

Événements

Événement	Champs	Description
Transfer	from, to, token_id	NFT transféré
Approval	owner, approved, token_id	Approbation accordée
Mint	to, token_id	Nouveau NFT frappé

Via le SDK

use savitri_sdk::{ContractClient, Wallet};

let contract = ContractClient::from_url_and_wallet("http://localhost:8545", wallet)?;

// Mint NFT via contract call
let tx = contract.call_contract(
    &nft_contract_address,
    b"mint",
    &encode_mint_args(recipient, token_id, uri),
    Some(0),
).await?;