neo3 1.0.7

Production-ready Rust SDK for Neo N3 blockchain with high-level API, unified error handling, and enterprise features
Documentation
use std::{collections::HashMap, sync::Arc};

use crate::{
	builder::{AccountSigner, TransactionBuilder},
	neo_clients::JsonRpcProvider,
	neo_contract::{ContractError, NeoIterator, NftContract, TokenTrait},
	neo_protocol::Account,
	Address, Bytes, ContractParameter, NNSName, ScriptHash, ScriptHashExtension, StackItem,
};
use async_trait::async_trait;
use primitive_types::H160;

#[async_trait]
pub trait NonFungibleTokenTrait<'a, P: JsonRpcProvider>: TokenTrait<'a, P> + Send {
	const OWNER_OF: &'static str = "ownerOf";
	const TOKENS_OF: &'static str = "tokensOf";
	const BALANCE_OF: &'static str = "balanceOf";
	const TRANSFER: &'static str = "transfer";
	const TOKENS: &'static str = "tokens";
	const PROPERTIES: &'static str = "properties";

	// Token methods

	async fn balance_of(&mut self, owner: H160) -> Result<i64, ContractError> {
		self.call_function_returning_int(
			<NftContract<P> as NonFungibleTokenTrait<P>>::BALANCE_OF,
			vec![owner.into()],
		)
		.await
	}

	// NFT methods

	async fn tokens_of(&mut self, owner: H160) -> Result<NeoIterator<Bytes, P>, ContractError> {
		let mapper_fn = Arc::new(|item: StackItem| {
			item.as_bytes()
				.ok_or_else(|| ContractError::UnexpectedReturnType("ByteString".to_string()))
		});
		self.call_function_returning_iterator(
			<NftContract<P> as NonFungibleTokenTrait<P>>::TOKENS_OF,
			vec![owner.into()],
			mapper_fn,
		)
		.await
	}

	// Non-divisible NFT methods

	async fn transfer(
		&mut self,
		from: &Account,
		to: ScriptHash,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<P>, ContractError> {
		let mut builder = self.transfer_inner(to, token_id, data).await?;
		let signer = AccountSigner::called_by_entry(from)
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;
		builder
			.set_signers(vec![signer.into()])
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;

		Ok(builder)
	}

	async fn transfer_inner(
		&mut self,
		to: ScriptHash,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<Self::P>, ContractError> {
		self.throw_if_divisible_nft().await?;
		self.invoke_function(
			<NftContract<P> as NonFungibleTokenTrait<P>>::TRANSFER,
			vec![to.into(), token_id.into(), data.unwrap_or_else(ContractParameter::any)],
		)
		.await
	}

	async fn transfer_from_name(
		&mut self,
		from: &Account,
		to: &str,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<P>, ContractError> {
		self.throw_if_sender_is_not_owner(&from.get_script_hash(), &token_id).await?;

		let to_hash = ScriptHash::from_address(to)
			.map_err(|_| ContractError::InvalidAccount("Invalid address".to_string()))?;
		let mut build = self.transfer_inner(to_hash, token_id, data).await?;
		let signer = AccountSigner::called_by_entry(from)
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;
		build
			.set_signers(vec![signer.into()])
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;

		Ok(build)
	}

	async fn transfer_to_name(
		&mut self,
		to: &str,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<P>, ContractError> {
		self.throw_if_divisible_nft().await?;

		let name = NNSName::new(to).map_err(|e| ContractError::InvalidNeoName(e.to_string()))?;
		self.transfer_inner(self.resolve_nns_text_record(&name).await?, token_id, data)
			.await
	}

	async fn build_non_divisible_transfer_script(
		&mut self,
		to: Address,
		token_id: Bytes,
		data: ContractParameter,
	) -> Result<Bytes, ContractError> {
		self.throw_if_divisible_nft().await?;

		self.build_invoke_function_script(
			<NftContract<P> as NonFungibleTokenTrait<P>>::TRANSFER,
			vec![to.into(), token_id.into(), data],
		)
		.await
	}

	async fn owner_of(&mut self, token_id: Bytes) -> Result<H160, ContractError> {
		self.throw_if_divisible_nft().await?;

		self.call_function_returning_script_hash(
			<NftContract<P> as NonFungibleTokenTrait<P>>::OWNER_OF,
			vec![token_id.into()],
		)
		.await
	}

	async fn throw_if_divisible_nft(&mut self) -> Result<(), ContractError> {
		if self.get_decimals().await? != 0 {
			return Err(ContractError::InvalidStateError(
				"This method is only intended for non-divisible NFTs.".to_string(),
			));
		}

		Ok(())
	}

	async fn throw_if_sender_is_not_owner(
		&mut self,
		from: &ScriptHash,
		token_id: &Bytes,
	) -> Result<(), ContractError> {
		let token_owner = self.owner_of(token_id.clone()).await?;
		if token_owner != *from {
			return Err(ContractError::InvalidArgError(
				"The provided from account is not the owner of this token.".to_string(),
			));
		}

		Ok(())
	}

	// Divisible NFT methods

	async fn transfer_divisible(
		&mut self,
		from: &Account,
		to: &ScriptHash,
		amount: i32,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<P>, ContractError> {
		let mut builder = self
			.transfer_divisible_from_hashes(&from.get_script_hash(), to, amount, token_id, data)
			.await?;
		let signer = AccountSigner::called_by_entry(from)
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;
		builder
			.set_signers(vec![signer.into()])
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;
		Ok(builder)
	}

	async fn transfer_divisible_from_hashes(
		&mut self,
		from: &ScriptHash,
		to: &ScriptHash,
		amount: i32,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<P>, ContractError> {
		self.throw_if_non_divisible_nft().await?;

		self.invoke_function(
			<NftContract<P> as NonFungibleTokenTrait<P>>::TRANSFER,
			vec![
				from.into(),
				to.into(),
				amount.into(),
				token_id.into(),
				data.unwrap_or_else(ContractParameter::any),
			],
		)
		.await
	}

	async fn transfer_divisible_from_name(
		&mut self,
		from: &Account,
		to: &str,
		amount: i32,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<P>, ContractError> {
		let name = NNSName::new(to).map_err(|e| ContractError::InvalidNeoName(e.to_string()))?;
		let mut builder = self
			.transfer_divisible_from_hashes(
				&from.get_script_hash(),
				&self.resolve_nns_text_record(&name).await?,
				amount,
				token_id,
				data,
			)
			.await?;
		let signer = AccountSigner::called_by_entry(from)
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;
		builder
			.set_signers(vec![signer.into()])
			.map_err(|err| ContractError::RuntimeError(err.to_string()))?;
		Ok(builder)
	}

	async fn transfer_divisible_to_name(
		&mut self,
		from: &ScriptHash,
		to: &str,
		amount: i32,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<TransactionBuilder<P>, ContractError> {
		self.throw_if_non_divisible_nft().await?;

		let name = NNSName::new(to).map_err(|e| ContractError::InvalidNeoName(e.to_string()))?;
		self.transfer_divisible_from_hashes(
			from,
			&self.resolve_nns_text_record(&name).await?,
			amount,
			token_id,
			data,
		)
		.await
	}

	async fn build_divisible_transfer_script(
		&self,
		from: Address,
		to: Address,
		amount: i32,
		token_id: Bytes,
		data: Option<ContractParameter>,
	) -> Result<Bytes, ContractError> {
		self.build_invoke_function_script(
			<NftContract<P> as NonFungibleTokenTrait<P>>::TRANSFER,
			vec![
				from.into(),
				to.into(),
				amount.into(),
				token_id.into(),
				data.unwrap_or_else(ContractParameter::any),
			],
		)
		.await
	}

	async fn owners_of(
		&mut self,
		token_id: Bytes,
	) -> Result<NeoIterator<Address, P>, ContractError> {
		self.throw_if_non_divisible_nft().await?;

		self.call_function_returning_iterator(
			<NftContract<P> as NonFungibleTokenTrait<P>>::OWNER_OF,
			vec![token_id.into()],
			Arc::new(|item: StackItem| {
				item.as_address()
					.ok_or_else(|| ContractError::UnexpectedReturnType("Address".to_string()))
			}),
		)
		.await
	}

	async fn throw_if_non_divisible_nft(&mut self) -> Result<(), ContractError> {
		if self.get_decimals().await? == 0 {
			return Err(ContractError::InvalidStateError(
				"This method is only intended for divisible NFTs.".to_string(),
			));
		}

		Ok(())
	}

	async fn balance_of_divisible(
		&mut self,
		owner: H160,
		token_id: Bytes,
	) -> Result<i64, ContractError> {
		self.throw_if_non_divisible_nft().await?;

		self.call_function_returning_int(
			<NftContract<P> as NonFungibleTokenTrait<P>>::BALANCE_OF,
			vec![owner.into(), token_id.into()],
		)
		.await
	}

	// Optional methods

	async fn tokens(&mut self) -> Result<NeoIterator<Bytes, P>, ContractError> {
		self.call_function_returning_iterator(
			<NftContract<P> as NonFungibleTokenTrait<P>>::TOKENS,
			vec![],
			Arc::new(|item: StackItem| {
				item.as_bytes()
					.ok_or_else(|| ContractError::UnexpectedReturnType("ByteString".to_string()))
			}),
		)
		.await
	}

	async fn properties(
		&mut self,
		token_id: Bytes,
	) -> Result<HashMap<String, String>, ContractError> {
		let invocation_result = self
			.call_invoke_function(
				<NftContract<P> as NonFungibleTokenTrait<P>>::PROPERTIES,
				vec![token_id.into()],
				vec![],
			)
			.await?;
		self.throw_if_fault_state(&invocation_result)?;

		let stack_item = invocation_result
			.get_first_stack_item()
			.map_err(|e| ContractError::InvalidResponse(e.to_string()))?;
		let map = stack_item.as_map().ok_or_else(|| {
			ContractError::UnexpectedReturnType(stack_item.to_string() + StackItem::MAP_VALUE)
		})?;

		map.iter()
			.map(|(k, v)| {
				let key = k
					.as_string()
					.ok_or_else(|| ContractError::UnexpectedReturnType("String".to_string()))?;
				let value = v
					.as_string()
					.ok_or_else(|| ContractError::UnexpectedReturnType("String".to_string()))?;
				Ok((key, value))
			})
			.collect()
	}

	async fn custom_properties(
		&mut self,
		token_id: Bytes,
	) -> Result<HashMap<String, StackItem>, ContractError> {
		let invocation_result = self
			.call_invoke_function(
				<NftContract<P> as NonFungibleTokenTrait<P>>::PROPERTIES,
				vec![token_id.into()],
				vec![],
			)
			.await?;
		self.throw_if_fault_state(&invocation_result)?;

		let stack_item = invocation_result
			.get_first_stack_item()
			.map_err(|e| ContractError::InvalidResponse(e.to_string()))?;
		let map = stack_item.as_map().ok_or_else(|| {
			ContractError::UnexpectedReturnType(stack_item.to_string() + StackItem::MAP_VALUE)
		})?;

		map.into_iter()
			.map(|(k, v)| {
				let key = k
					.as_string()
					.ok_or_else(|| ContractError::UnexpectedReturnType("String".to_string()))?;
				Ok((key, v.clone()))
			})
			.collect()
	}
}