1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
//! Erc1155 standard implementation.
use odra::prelude::*;
use odra::{
casper_types::{bytesrepr::Bytes, U256},
Address
};
pub mod erc1155_base;
pub mod extensions;
pub mod owned_erc1155;
/// The ERC-1155 interface as defined in the standard.
pub trait Erc1155 {
/// Returns the amount of tokens of token type `id` owned by `owner`.
fn balance_of(&self, owner: &Address, id: &U256) -> U256;
/// Batched version of [Erc1155::balance_of](Self::balance_of).
///
/// The length of `owners` and `ids` must be the same.
fn balance_of_batch(&self, owners: Vec<Address>, ids: Vec<U256>) -> Vec<U256>;
/// Allows or denials the `operator` to transfer the caller’s tokens.
///
/// Emits [crate::erc1155::events::ApprovalForAll].
fn set_approval_for_all(&mut self, operator: &Address, approved: bool);
/// Checks if the `operator` is approved to transfer `owner`'s tokens.
fn is_approved_for_all(&self, owner: &Address, operator: &Address) -> bool;
/// Transfers amount tokens of token type id from `from` to `to`.
///
/// Emits [TransferSingle](crate::erc1155::events::TransferSingle).
///
/// If `to` refers to a smart contract, it must implement [Erc1155Receiver::on_erc1155_received](crate::erc1155_receiver::Erc1155Receiver::on_erc1155_received).
fn safe_transfer_from(
&mut self,
from: &Address,
to: &Address,
id: &U256,
amount: &U256,
data: &Option<Bytes>
);
/// Batched version of [Erc1155::safe_transfer_from](Self::safe_transfer_from).
///
/// Emits [TransferBatch](crate::erc1155::events::TransferBatch).
///
/// If `to` refers to a smart contract, it must implement [Erc1155Receiver::on_erc1155_batch_received](crate::erc1155_receiver::Erc1155Receiver::on_erc1155_batch_received).
fn safe_batch_transfer_from(
&mut self,
from: &Address,
to: &Address,
ids: Vec<U256>,
amounts: Vec<U256>,
data: &Option<Bytes>
);
}
/// Erc1155-related Odra events.
pub mod events {
use odra::prelude::*;
use odra::{casper_types::U256, Address};
/// Emitted when a single Erc1155 transfer is performed.
#[odra::event]
pub struct TransferSingle {
/// The operator that called the function.
pub operator: Option<Address>,
/// The address from which the tokens are transferred.
pub from: Option<Address>,
/// The address to which the tokens are transferred.
pub to: Option<Address>,
/// The token id.
pub id: U256,
/// The token amount.
pub value: U256
}
/// Emitted when a batched Erc1155 transfer is performed.
#[odra::event]
pub struct TransferBatch {
/// The operator that called the function.
pub operator: Option<Address>,
/// The address from which the tokens are transferred.
pub from: Option<Address>,
/// The address to which the tokens are transferred.
pub to: Option<Address>,
/// The token ids.
pub ids: Vec<U256>,
/// The token amounts.
pub values: Vec<U256>
}
/// Emitted when the `owner` approves or revokes the `operator`.
#[odra::event]
pub struct ApprovalForAll {
/// The owner of the tokens.
pub owner: Address,
/// The operator that is approved.
pub operator: Address,
/// The approval status.
pub approved: bool
}
}
/// Erc1155-related Odra errors.
pub mod errors {
/// Possible errors in the context of Erc1155.
#[odra::odra_error]
pub enum Error {
/// Collections of addresses and token ids have different length.
AccountsAndIdsLengthMismatch = 30_000,
/// The owner cannot approve himself.
ApprovalForSelf = 30_001,
/// The operator is not allowed to perform the action.
NotAnOwnerOrApproved = 30_002,
/// Insufficient token amount to perform a transaction.
InsufficientBalance = 30_003,
/// Token transfer finished with an error.
TransferRejected = 30_004,
/// Collections of token ids and amounts have different length.
IdsAndAmountsLengthMismatch = 30_005
}
}