darkfi_money_contract/
lib.rs

1/* This file is part of DarkFi (https://dark.fi)
2 *
3 * Copyright (C) 2020-2025 Dyne.org foundation
4 *
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU Affero General Public License as
7 * published by the Free Software Foundation, either version 3 of the
8 * License, or (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 * GNU Affero General Public License for more details.
14 *
15 * You should have received a copy of the GNU Affero General Public License
16 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
17 */
18
19//! DarkFi Money Contract
20//!
21//! Smart contract implementing money transfers, atomic swaps, token
22//! minting and freezing, and staking/unstaking of consensus tokens.
23
24use darkfi_sdk::error::ContractError;
25
26/// Functions available in the contract
27#[repr(u8)]
28// ANCHOR: money-function
29pub enum MoneyFunction {
30    FeeV1 = 0x00,
31    GenesisMintV1 = 0x01,
32    PoWRewardV1 = 0x02,
33    TransferV1 = 0x03,
34    OtcSwapV1 = 0x04,
35    AuthTokenMintV1 = 0x05,
36    AuthTokenFreezeV1 = 0x06,
37    TokenMintV1 = 0x07,
38}
39// ANCHOR_END: money-function
40
41impl TryFrom<u8> for MoneyFunction {
42    type Error = ContractError;
43
44    fn try_from(b: u8) -> core::result::Result<Self, Self::Error> {
45        match b {
46            0x00 => Ok(Self::FeeV1),
47            0x01 => Ok(Self::GenesisMintV1),
48            0x02 => Ok(Self::PoWRewardV1),
49            0x03 => Ok(Self::TransferV1),
50            0x04 => Ok(Self::OtcSwapV1),
51            0x05 => Ok(Self::AuthTokenMintV1),
52            0x06 => Ok(Self::AuthTokenFreezeV1),
53            0x07 => Ok(Self::TokenMintV1),
54            _ => Err(ContractError::InvalidFunction),
55        }
56    }
57}
58
59/// Internal contract errors
60pub mod error;
61
62/// Call parameters definitions
63pub mod model;
64
65#[cfg(not(feature = "no-entrypoint"))]
66/// WASM entrypoint functions
67pub mod entrypoint;
68
69#[cfg(feature = "client")]
70/// Client API for interaction with this smart contract
71pub mod client;
72
73// These are the different sled trees that will be created
74pub const MONEY_CONTRACT_INFO_TREE: &str = "info";
75pub const MONEY_CONTRACT_COINS_TREE: &str = "coins";
76pub const MONEY_CONTRACT_COIN_ROOTS_TREE: &str = "coin_roots";
77pub const MONEY_CONTRACT_NULLIFIERS_TREE: &str = "nullifiers";
78pub const MONEY_CONTRACT_NULLIFIER_ROOTS_TREE: &str = "nullifier_roots";
79pub const MONEY_CONTRACT_TOKEN_FREEZE_TREE: &str = "token_freezes";
80pub const MONEY_CONTRACT_FEES_TREE: &str = "fees";
81
82// These are keys inside the info tree
83pub const MONEY_CONTRACT_DB_VERSION: &[u8] = b"db_version";
84pub const MONEY_CONTRACT_COIN_MERKLE_TREE: &[u8] = b"coins_tree";
85pub const MONEY_CONTRACT_LATEST_COIN_ROOT: &[u8] = b"last_coins_root";
86pub const MONEY_CONTRACT_LATEST_NULLIFIER_ROOT: &[u8] = b"last_nullifiers_root";
87
88/// Precalculated root hash for a tree containing only a single Fp::ZERO coin.
89/// Used to save gas.
90pub const EMPTY_COINS_TREE_ROOT: [u8; 32] = [
91    0xb8, 0xc1, 0x07, 0x5a, 0x80, 0xa8, 0x09, 0x65, 0xc2, 0x39, 0x8f, 0x71, 0x1f, 0xe7, 0x3e, 0x05,
92    0xb4, 0xed, 0xae, 0xde, 0xf1, 0x62, 0xf2, 0x61, 0xd4, 0xee, 0xd7, 0xcd, 0x72, 0x74, 0x8d, 0x17,
93];
94
95/// zkas fee circuit namespace
96pub const MONEY_CONTRACT_ZKAS_FEE_NS_V1: &str = "Fee_V1";
97/// zkas mint circuit namespace
98pub const MONEY_CONTRACT_ZKAS_MINT_NS_V1: &str = "Mint_V1";
99/// zkas burn circuit namespace
100pub const MONEY_CONTRACT_ZKAS_BURN_NS_V1: &str = "Burn_V1";
101/// zkas token auth mint circuit namespace
102pub const MONEY_CONTRACT_ZKAS_AUTH_TOKEN_MINT_NS_V1: &str = "AuthTokenMint_V1";
103/// zkas token mint circuit namespace
104pub const MONEY_CONTRACT_ZKAS_TOKEN_MINT_NS_V1: &str = "TokenMint_V1";
darkfi_money_contract/lib.rs

darkfi_money_contract/
lib.rs
