# MultiversX 内存令牌账本 ## 这解决了什么问题？当合约在单个交易中执行多个代币操作时（例如，交换A→B，然后B→C），您需要跟踪中间余额而不写入存储。对于仅存在于一次调用中的临时状态，存储写入是昂贵的且不必要的。 ## 何时使用场景 |使用分类账？ ---|--- 一笔交易中的多步代币操作 |是的需要跟踪顺序操作之间的余额 |是的单次存款/取款 |不——矫枉过正跨事务必须持续的状态 |否 — 使用存储 ## 核心模式：双数据结构账本使用两种协同工作的结构： * **ManagedMapEncoded** — O(1) 查找余额检查和更新 * **ManagedVec** — 有序迭代进行结算（返回所有代币）使用 multiversx_sc::api::VMApi； pub struct TokenLedger { 余额： ManagedMapEncoded, BigUint>, tokens: ManagedVec>, // 跟踪迭代的插入顺序 } impl TokenLedger { pub fn new() -> 自身 { 自我{ 余额： ManagedMapEncoded::new(), 令牌： ManagedVec::new(), } } /// 从收到的付款中初始化 pub fn from_ payments(付款: &PaymentVec) -> Self { 让 mut ledger = Self::new(); 用于在 payment.iter() { 中付款 ledger.deposit(& payment.token_identifier, payment.amount.as_big_uint()); } 分类帐 } /// 记入代币余额 pub fn Deposit(&mut self, 代币: &TokenId, 金额: &BigUint) { if !self.balances.contains(token) { self.tokens.push(token.clone()); self.balances.put(代币, 金额); } 否则{ 让当前 = self.balances.get(token); self.balances.put(代币, &(当前 + 金额)); } } /// 借记准确金额 pub fnwithdraw(&mut self, 代币: &TokenId, 金额: &BigUint) -> BigUint { 让当前 = self.balance_of(token); require!(current >= *amount, "账本余额不足"); 让 new_balance = &当前 - 金额; 如果 new_balance == 0u64 { self.remove_token(令牌); } 否则{ self.balances.put(token, &new_balance); } 金额.clone() } /// 借记百分比（百万分之一） pub fnwithdraw_percentage(&mut self, token: &TokenId, ppm: u32) -> BigUint { 让balance = self.balance_of(token); 让金额 = (&balance * ppm) / 1_000_000u64; if amount > 0u64 { self.withdraw(token, &amount) } else { BigUint::zero() } } /// 借记全部余额（避免灰尘） pub fnwithdraw_all(&mut self, token: &TokenId) -> BigUint { 让 amount = self.balance_of(token); 如果金额 > 0u64 { self.remove_token(token); } 金额 } /// 检查余额 pub fn Balance_of(&self, 代币: &TokenId) -> BigUint { if !self.balances.contains(token) { 返回 BigUint::zero(); } self.balances.get(令牌) } /// Settle——将所有余额转换为支付对象进行转账 pub fn Settle_all(&self) -> ManagedVec> { 让 mut payment = ManagedVec::new(); 对于 self.tokens.iter() 中的令牌 { 让 amount = self.balances.get(&token); if let Some(non_zero_amount) = NonZeroBigUint::new(amount) { payment.push(Payment::new(token.clone_value(), 0u64, non_zero_amount)); } } 付款 } fn remove_token(&mut self, 令牌: &TokenId) { self.balances.remove(token); // O(N) 扫描 — 对于小标记集（通常 < 10）是可接受的 for (i, t) in self.tokens.iter().enumerate() { 如果 t.as_management_buffer() == token.as_management_buffer() { self.tokens.remove(i); 休息; } } } } ## 用法：多步操作 #[端点(执行步骤)] #[应付] fnexecute_steps(&self, 步骤: ManagedVec>) { 让 payment = self.call_value().all(); 让 mut ledger = TokenLedger::from_ payments(& payments); 对于步骤&steps { // 从账本中提取输入让 input_amount = ledger.withdraw(&step.input_token, &step.amount); // 执行操作（交换、质押等）让输出= self.execute_step(&step, input_amount); // 将结果存回账本 ledger.deposit(&output.token_identifier, output.amount.as_big_uint()); } // 将所有剩余的令牌返回给调用者让剩余 = ledger.settle_all(); if !remaining.is_empty() { self.tx().to(&self.blockchain().get_caller()). payment(&remaining).transfer(); } } ## 使用正确的类型进行结算 ### 不好 // 不要：使用旧类型进行结算 — BigUint 允许零金额支付 fn Settle_bad(&self) -> ManagedVec { 让 mut payment = ManagedVec::new(); 对于 self.tokens.iter() 中的令牌 { 让 amount = self.balances.get(&token); Payments.push(EsdtTokenPayment::new(token.into(), 0, amount)); // 发送金额为零！ } 付款 } ### 好 // DO: 使用 TokenId + NonZeroBigUint — 在类型级别跳过零余额 fn Settle_good(&self) -> ManagedVec<付款> { 让 mut payment = ManagedVec::new(); 对于 self.tokens.iter() 中的令牌 { 让 amount = self.balances.get(&token); if let Some(nz) = NonZeroBigUint::new(amount) { Payments.push(Payment::new(token.clone_value(), 0u64, nz)); } } 付款 } ## 反模式 ### 1\.使用存储作为临时余额 // 错误——对于一次交易中的状态进行昂贵的存储写入 #[storage_mapper("tempBalance")] fn temp_balance(&self, token: &TokenId) -> SingleValueMapper; ### 2\.不清理零余额 // 错误——零余额代币在settle_all迭代期间浪费气体 pub fnwithdraw(&mut self, 代币: &TokenId, 金额: &BigUint) { 让 new_balance = &self.balance_of(token) - 金额； self.balances.put(token, &new_balance); // 留下零条目！ } ### 3\.仅使用 ManagedVec（无地图） // 错误 — 每次余额检查的 O(N) 查找 pub fn Balance_of(&self, 代币: &TokenId) -> BigUint { for (i, t) in self.tokens.iter().enumerate() { if t == token { return self.amounts.get(i); } } BigUint::zero() } ## 气体优化注意事项 1. **ManagedMapEncoded** — 使用堆内存，而不是存储。没有用于读/写的gas。 2. **O(N) 令牌删除** — 在典型的多步骤流程中对于 < 10 个令牌是可接受的。 3. **零余额清理** — 自动删除代币以保持账本紧凑。 4. **批量初始化** — `from_ payments` 有效加载所有传入的代币。 ## 变化生产存储库通过以下方式扩展了此模式： * **结果链接** — 将上一步输出作为下一步输入 * **百分比模式** — 基于 PPM 的部分金额提款 * **选择性结算** - 仅返回特定代币，其余部分作为协议收入 * **金额模式枚举** - 固定/百分比/全部/上一个结果用于灵活的步骤定义

Multiversx Vault 模式

包含技能