挑战者大7_合约maker是什么意思

一：Logistics Company 功能介绍

• 所有人都可以创建独属于自己的物流公司，按照每百克的价格定价（不满100g的将按照100g计算），当然，公司所有者也可以注销这所公司，但前提是处理完所有的业务。
• 所有人都可以是顾客，提供将要运输的物品信息（主要是重量）进行下单，同时支付费用。
• 类似于现今的各大消费平台，支付的费用不会直接抵达公司的账户下，而是存储在平台的某个地方（在这里，就是 $Sui$ 链上的某个对象中，不提供对该对象内的金额直接提现的功能），只有用户凭借快递单确认收货，或者超过15个周期由公司进行确认收货操作后，对应的款项才会打入公司的账户。
• 只有进入公司账户的收益额，管理者才能够将其提现到自己的钱包，当然，为了该平台的可持续发展，每一笔提现，需要支付给平台创始人 $\text{1}\%$ 的抽成。
• 平台创始人可以通过对抽成得到的收益进行提现。
• 下单后不超过3个周期，顾客可以凭快递单进行退款操作，金额将原封不动退入消费者账户钱包。

二：结构定义

2.1 平台创始人

需要一个Balance<SUI>来存储提成，所以该对象需要共享可变。
但是提现操作只能是创始人自己，因此通过 $One$–$Time$–$Witness$ 来创建一个Publisher在后续调用时表明身份。

// Define ADMIN(one time witness) struct struct ADMIN has drop {} // Define Admin struct struct Admin has key { id: UID, balance: Balance<SUI>, } 

2.2 公司

公司的各项信息都应该透明，尤其是价格方面，所以该对象也应该是共享甚至是可变的，因为当顾客下单后，需要将物品相关信息暂存入公司。
类似的，收益提现以及由公司确认收货操作都需要公司管理者才有权限，因此再创建一个所有者为个人的凭证对象。

// Define CompanyCap struct struct CompanyCap has key { id: UID, } // Define Company struct struct Company has key { id: UID, name: String, price_per_hundred_grams: u64, waiting_for_receipt: LinkedTable<ID, ItemInfo>, can_be_cashed: Balance<SUI>, all_profit: u64, } 

其中用到了LinkedTable，这是一个通过 $Key$–$Value$ 存储的自带的数据结构，拥有头插，尾插，从头部取出，从尾部取出等功能，用来维护待确认收货的物流信息比较合适，具体可以点击查看源码。

2.3 物流

顾客下单后会得到与公司相对应的快递单（通过公司的 $ID$ 进行对应），该快递单不对外公开，仅下单的顾客拥有。
同时生成相对应的信息，包括下单时期以及金额等。

// Define TransportItem struct struct TransportItem has key { id: UID, logistics_company: String, company_id: ID, weight: u64, price: u64, } // Define ItemInfo struct struct ItemInfo has store { epoch: u64, transport_price: Balance<SUI>, } 

三：功能实现

3.1 平台创始人

3.1.1 发布时初始化

在发布该合约的时候自动调用的init函数当中，通过只能在这里使用的 $One$–$Time$–$Witness$ 来创建Publisher，并将其拥有权递交给发布者。
同时，在该函数当中，创建一个共享可变的Admin，用作各大公司提现时获取提成的账户。

// Function to init the publisher and admin fun init(otw: ADMIN, ctx: &mut TxContext) { // create Publisher and transfer it to the sender package::claim_and_keep(otw, ctx); // create Admin and share it with all users transfer::share_object(Admin { id: object::new(ctx), balance: balance::zero(), }); } 

3.1.2 提现

通过Publisher确认身份，当Admin当中的抽成大于零的时候可以对其进行提现（将 $SUI$ 的 $balance$ 包装成 $Coin$ 发送给平台创始人）。

// Function to withdraw(only the publisher can withdraw) public entry fun withdraw(_publisher: &Publisher, admin: &mut Admin, ctx: &mut TxContext) { // get the value amount let amount = balance::value(&admin.balance); // it's necessary to make sure the amount > 0 assert!(amount > 0, ERROR_NOT_BALANCE); // transfer the coin with the all balance to the sender transfer::public_transfer(coin::take(&mut admin.balance, amount, ctx), tx_context::sender(ctx)); } 

3.2 公司

3.2.1 创建公司

不仅要根据信息创建公开的Company，还需要创建仅创建者持有的CompanyCap用作后续的身份凭证（在这里的功能效果类似于上面的Publisher）。

// Function to create company public entry fun create_company(name: String, price_per_hundred_grams: u64, ctx: &mut TxContext) { // create CompanyCap and transfer it to the sender // this is a testament to the company's managers transfer::transfer(CompanyCap { id: object::new(ctx), }, tx_context::sender(ctx)); // create Company and share it with all users transfer::share_object(Company { id: object::new(ctx), name, price_per_hundred_grams, waiting_for_receipt: linked_table::new<ID, ItemInfo>(ctx), can_be_cashed: balance::zero(), all_profit: 0, }); } 

3.2.2 确认收货

只有下单后超过 $\text{15}$ 个周期的货物，公司有权进行确认收货操作。
在此之前，我们先来明确一个隐性的条件，那就是每当有顾客下单，对应的信息被push_back进linked_table，其中所存储的epoch是下单时的值，而下单这个操作本身是有序的，时间也不可能乱序，所以在link_table中所存储的信息，从前到后的epoch理论上来说也应该是非严格递增的。
基于上述理论，在该函数当中，可以通过从前到后的循环进行，直到linked_table为空或者front不满足epoch条件时跳出循环。
为了更清晰明了地演示一步步地取值过程，这里采用了loop无限循环（要注意其跳出循环的条件，因为合约发布时并不能明确这是否是正确的），如果对取值以及数据之间调用比较熟悉的，可以直接将跳出循环的条件写在一起当做判决用while。
当然，想要进行这一操作，需要你拥有对应公司的管理员权限，也就是CompanyCap。

// Function to unconfirmed receipt items with confirmation epoch greater than 15 // Company managers can only confirm the company's transport items public entry fun confirm_items(_company_cap: &CompanyCap, company: &mut Company, ctx: &mut TxContext) { // get the now epoch let now_epoch = tx_context::epoch(ctx); // to be confirmed list let items = &mut company.waiting_for_receipt; // theoretically, the linked table is sorted according to epoch // because when user call function, linked_table push_back, this is orderly in itself loop { // items need to be not empty if (linked_table::is_empty(items)) break; // linked_table::front -> &Option<Element> // option::borrow -> &Element // in this module, Element is ID let key = *option::borrow(linked_table::front(items)); // linked_table::borrow -> &Value // in this module, Value is ItemInfo let transport_epoch = linked_table::borrow(items, key).epoch; // the front item's epoch is longer than 15 if (transport_epoch + 15 >= now_epoch) break; // pop the front and get the ItemInfo let (_, item_info) = linked_table::pop_front(items); // destroy ItemInfo and get the price let ItemInfo { epoch: _, transport_price, } = item_info; // add to the all_profit company.all_profit = company.all_profit + balance::value(&transport_price); // add the profit balance::join(&mut company.can_be_cashed, transport_price); }; } 

3.2.3 提现

需要管理员权限CompanyCap才可调用，这里的关键是需要取出 $\text{1}\%$ 存入Admin，由于 $Move$ 语言目前对浮点数的支持有限，所以这里平台创始人吃点亏，只抽取 $\lfloor \frac{profit}{\text{100}}\rfloor$。

// Function to cash public entry fun cash(_company_cap: &CompanyCap, admin: &mut Admin, company: &mut Company, ctx: &mut TxContext) { // get the amount of balance let can_be_cashed = &mut company.can_be_cashed; let amount = balance::value(can_be_cashed); // check the amount assert!(amount > 0, ERROR_NOT_BALANCE); // admin profit: 1% of the balance let admin_profit = balance::split(can_be_cashed, amount / 100); // add to the admin balance let admin_balance = admin::get_balance_mut(admin); balance::join(admin_balance, admin_profit); // the remaining amount belongs to the company amount = balance::value(can_be_cashed); transfer::public_transfer(coin::take(can_be_cashed, amount, ctx), tx_context::sender(ctx)); } 

3.2.4 注销公司

解构创建的与公司有关的对象，也就是CompanyCap和Company，注意，后者内部的LinkedTable和Balance都需要手动摧毁，如果其中不为空，则会报错，同时恢复到该交易之前的状态。

// Function to destroy company public entry fun destroy_company(company_cap: CompanyCap, company: Company) { // deconstruct the CompanyCap let CompanyCap {id} = company_cap; // delete the id object::delete(id); // deconstruct the Company let Company { id, name: _, price_per_hundred_grams: _, waiting_for_receipt, can_be_cashed, all_profit: _, } = company; // delete the id object::delete(id); // destroy linked_table linked_table::destroy_empty(waiting_for_receipt); // destroy balance balance::destroy_zero(can_be_cashed); } 

3.3 物流

3.3.1 创建（下单）

选择公司，提供物品重量，支付对应的金额（多退少报错），顾客得到仅自己可见的快递单，而对应的信息则存储入Company当中的LinkedTable，其中作为 $Key$ 的 $ID$ 取自对应的快递单，也就是TransportItem。

// Function to create transport item public entry fun create_item(company: &mut Company, weight: u64, sui: Coin<SUI>, ctx: &mut TxContext) { // if the weight is less than 100g, it will be calculated as 100g // in other words: weight / 100 rounded up multiply by price_per_hundred_grams let price = (weight + 99) / 100 * company.price_per_hundred_grams; // check enough price assert!(coin::value(&sui) >= price, ERROR_NOT_ENOUGH_COIN); // split the right price let transport_price = coin::split(&mut sui, price, ctx); // destroy or transfer the remaining coin to the owner if (coin::value(&sui) == 0) { coin::destroy_zero(sui); } else { transfer::public_transfer(sui, tx_context::sender(ctx)); }; // create TransportItem let transport_item = TransportItem { id: object::new(ctx), logistics_company: company.name, company_id: object::id(company), // corresponding company ID weight, price, }; // get the ID through transport_item to achieve a one-on-one relationship let id = object::id(&transport_item); // create ItemInfo let item_infomation = ItemInfo { epoch: tx_context::epoch(ctx), transport_price: coin::into_balance(transport_price), }; // transfer the credentials to the user transfer::transfer(transport_item, tx_context::sender(ctx)); // store the item_info to the company linked_table::push_back(&mut company.waiting_for_receipt, id, item_infomation); } 

3.3.2 退款

下单后不超过 $\text{3}$ 个周期的订单才可以退款，而且TransportItem当中的company_id必须与退款公司相一致，当然，该订单必须存在且未被确认收货。

// Function to refunds if no more than 3 epoch public entry fun refunds(transport_item: TransportItem, company: &mut Company, ctx: &mut TxContext) { // check whether it corresponds to the company assert!(transport_item.company_id == object::id(company), ERROR_NOT_ORDERED_COMPANY); // get waiting_for_receipt let waiting_for_receipt = &mut company.waiting_for_receipt; // get the ID through transport_item let id_key = object::id(&transport_item); // determine whether it is the correct item or whether it is receipted assert!(linked_table::contains(waiting_for_receipt, id_key), ERROR_NOT_ITEM_OR_RECEIPTED); // must not exceed 3 epochs assert!(linked_table::borrow(waiting_for_receipt, id_key).epoch + 3 >= tx_context::epoch(ctx), ERROR_NOT_REFUNDS); // deconstruct the ItemInfo let ItemInfo { epoch: _, transport_price, } = linked_table::remove(waiting_for_receipt, id_key); // get the balance amount let amount = balance::value(&transport_price); // refunds transfer::public_transfer(coin::take(&mut transport_price, amount, ctx), tx_context::sender(ctx)); // destroy the zero balance balance::destroy_zero(transport_price); // destroy TransportItem destroy_transport_item(transport_item); } 

3.3.3 确认收货

通过TransportItem到对应的Company确认收货，成功后快递单将被销毁，而对应的款项将被转移到公司的账户。
如果该信息已经超过了 $\text{15}$ 个周期且物流公司确认收货了，那么此函数仅执行销毁快递单的操作。

// Function to confirm receipt by correct TransportItem public entry fun confirm_receipt(transport_item: TransportItem, company: &mut Company) { // check whether it corresponds to the company assert!(transport_item.company_id == object::id(company), ERROR_NOT_ORDERED_COMPANY); // get waiting_for_receipt let waiting_for_receipt = &mut company.waiting_for_receipt; // get the ID through transport_item let id_key = object::id(&transport_item); // determine whether it is the correct item or whether it is receipted if (linked_table::contains(waiting_for_receipt, id_key)) { // deconstruct the ItemInfo let ItemInfo { epoch: _, transport_price, } = linked_table::remove(waiting_for_receipt, id_key); // add to the all_profit company.all_profit = company.all_profit + balance::value(&transport_price); // add the profit balance::join(&mut company.can_be_cashed, transport_price); }; // destroy TransportItem destroy_transport_item(transport_item); } 

四：发布上链并交互

4.1 发布

• 运行命令

sui client publish --gas-budget

• 重要输出信息

╭──────────────────────────────────────────────────────────────────────────────────────────────────╮ │ Object Changes │ ├──────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Created Objects: │ │ ┌── │ │ │ ObjectID: 0x64adbd96ade6dc79eeec7f5b8caaaa295f162deeb0d │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::package::Publisher │ │ │ Version:  │ │ │ Digest: H9BpBvmMayuLeGwbrtMXgmQiYVFT6LjscSiwpxaRp1jm │ │ └── │ │ ┌── │ │ │ ObjectID: 0xa9c37253c81a63606a697eb6daac5443b2c9063fd61ea7ae010 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::package::UpgradeCap │ │ │ Version:  │ │ │ Digest: H2b31NtMkE4PhtZ1e3VhjS5YqKH8HkpewgyYjHkpqUVT │ │ └── │ │ ┌── │ │ │ ObjectID: 0xde3c0d1745acf9aaad1b79d1fd04fb0fa4943bdea98006af │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::admin::Admin │ │ │ Version:  │ │ │ Digest: 5FPD5bwqPENjnH2TpmKw4pt2pgGyZprteSE5besGyAiC │ │ └── │ │ Mutated Objects: │ │ ┌── │ │ │ ObjectID: 0x6a8d2d47ad669e0ff5d4c4d32ddbdaca375f3eabf454a42701beb1ec06 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: 8RKM8DLrFPWMLFjaE4k5yNCvfbwXFfE57mJFxucUbLLw │ │ └── │ │ Published Objects: │ │ ┌── │ │ │ PackageID: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6 │ │ │ Version: 1 │ │ │ Digest: 8u1KT2dfoqfkFk7C5eoFVkMH7czoph4LoNsY8HupUHiY │ │ │ Modules: admin, company │ │ └── │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ 

• 设置环境变量

export PACKAGE_ID=0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6 export PUBLISHER=0x64adbd96ade6dc79eeec7f5b8caaaa295f162deeb0d export ADMIN=0xde3c0d1745acf9aaad1b79d1fd04fb0fa4943bdea98006af 

4.2 创建公司

• 运行命令

sui client call --package $PACKAGE_ID --module company --function create_company --args NightCandle 100 --gas-budget

• 重要输出信息

╭─────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ Object Changes │ ├─────────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Created Objects: │ │ ┌── │ │ │ ObjectID: 0xbb83fb182eaaa0054dd465eb0fb0e81aa600b053b1577cf49ce0c54898 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::CompanyCap │ │ │ Version:  │ │ │ Digest: 7ZRmFTb4Xe2idgiw3PM5qMEUGGJ5ieg1xeEaepwoyRGZ │ │ └── │ │ ┌── │ │ │ ObjectID: 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::Company │ │ │ Version:  │ │ │ Digest: DZqQn4hw6koM6fjrKUYTDHe7TJnAfPbp7hP9jA93L3Lr │ │ └── │ │ Mutated Objects: │ │ ┌── │ │ │ ObjectID: 0x6a8d2d47ad669e0ff5d4c4d32ddbdaca375f3eabf454a42701beb1ec06 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: 2Z2CDce9ck99QwMT7UtqeAQK4Trr9iLgysnXqF4gjr37 │ │ └── │ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 

• 设置环境变量

export COMPANYCAP=0xbb83fb182eaaa0054dd465eb0fb0e81aa600b053b1577cf49ce0c54898 export COMPANY=0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 

4.3 下单物流

• 切换到另一个用户

sui client switch --address <alias>

• 设置 $Coin$ 环境变量

sui client gas export COIN=0xca1e96b358f722d601accc962dd4f7f75ee122d50e1132d25ee36 

• 运行命令

sui client call --package $PACKAGE_ID --module company --function create_item --args $COMPANY 1 $COIN --gas-budget

• 重要输出信息

╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ Object Changes │ ├─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Created Objects: │ │ ┌── │ │ │ ObjectID: 0x9128a11aaeee12d8a8e625a3fd164aa0772cdb7c6209c0f7 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Object ID: ( 0xfb39822d0d3883ed1a02d720ed6bc1f38a09b8c2b7ad33d00a466dc5 ) │ │ │ ObjectType: 0x2::dynamic_field::Field<0x2::object::ID, 0x2::linked_table::Node<0x2::object::ID, 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::ItemInfo>> │ │ │ Version:  │ │ │ Digest: 3EzLVtMtZj88Q3JzqQU3SkARE6ZBLiwou7csLiJkATdT │ │ └── │ │ ┌── │ │ │ ObjectID: 0xcc9581fae40a69c7e8681a0f497a900a38cc1379abfa2ce783a0d9cb28 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Account Address ( 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb ) │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::TransportItem │ │ │ Version:  │ │ │ Digest: EAtDCZAR8vZiAZ7FWy4bTU2kQn7KUYnT8uRSeUH6bdpQ │ │ └── │ │ Mutated Objects: │ │ ┌── │ │ │ ObjectID: 0xa5e9cc06d7bfb34b49fd2f6631e0fa8124a36030ae5107ebf785fca37c │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Account Address ( 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: J9w5dNToKgigdoc3VtM5KucRKbMZkyVzqM4cuLeLBUDm │ │ └── │ │ ┌── │ │ │ ObjectID: 0xca1e96b358f722d601accc962dd4f7f75ee122d50e1132d25ee36 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Account Address ( 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: 97oxDW1DDton7k1S81HgkoC9rexw7YGvUDXw1aMGKjXd │ │ └── │ │ ┌── │ │ │ ObjectID: 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::Company │ │ │ Version:  │ │ │ Digest: 5hTdm7unYsfMEiopZwHwDDanfvEDwW2cSaY8GtvA462D │ │ └── │ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 

• 设置环境变量

export TRANSPORTITEM=0xcc9581fae40a69c7e8681a0f497a900a38cc1379abfa2ce783a0d9cb28

• **通过查询可以发现，$balancegas$ 少了 $\text{100}$ **

sui client gas

• 类似的，我们再下单一件 $\text{999}g$ 的物品，同时记录对应的 $ObjectID$ 信息

sui client call --package $PACKAGE_ID --module company --function create_item --args $COMPANY 999 $COIN --gas-budget  export TRANSPORTITEM999=0x73a317b42feedca5117a49e59e8d17f8c90cecd8437fbaeb73b20a2 

4.4 退款

• 运行命令

sui client call --package $PACKAGE_ID --module company --function refunds --args $TRANSPORTITEM $COMPANY --gas-budget

• 重要输出信息

╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ Object Changes │ ├─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Created Objects: │ │ ┌── │ │ │ ObjectID: 0x990be8a45b632a81cf7e5ed6dc763b195edbaa994d827e5d6ac6f0db1eedc3d5 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Account Address ( 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: Eo4kQG93h8nUwYCmJbkQ2J7spFPgtZpdx2dWhtvRUp4f │ │ └── │ │ Mutated Objects: │ │ ┌── │ │ │ ObjectID: 0xcbb4b767cc89988c7ef1566b30ce0ed69f367c1a2dc46a394e33c4a358 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Object ID: ( 0xfb39822d0d3883ed1a02d720ed6bc1f38a09b8c2b7ad33d00a466dc5 ) │ │ │ ObjectType: 0x2::dynamic_field::Field<0x2::object::ID, 0x2::linked_table::Node<0x2::object::ID, 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::ItemInfo>> │ │ │ Version:  │ │ │ Digest: BX5RYwdf94HGfqyxqj49LdoxDxFHf19YaSezM6ZLysup │ │ └── │ │ ┌── │ │ │ ObjectID: 0xa5e9cc06d7bfb34b49fd2f6631e0fa8124a36030ae5107ebf785fca37c │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Account Address ( 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: bAY6jemHXqpQ7B9P234ueRHC76mz9sE6FxoYUdjXtP9 │ │ └── │ │ ┌── │ │ │ ObjectID: 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::Company │ │ │ Version:  │ │ │ Digest: 5WNobseyxFD5isae3QDzY4aaT18ysesgfLVbzXfBJK5C │ │ └── │ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 

• 确认余额

sui client gas # output: ╭────────────────────────────────────────────────────────────────────┬────────────────────┬──────────────────╮ │ gasCoinId │ mistBalance (MIST) │ suiBalance (SUI) │ ├────────────────────────────────────────────────────────────────────┼────────────────────┼──────────────────┤ │ 0x990be8a45b632a81cf7e5ed6dc763b195edbaa994d827e5d6ac6f0db1eedc3d5 │ 100 │ 0.00 │ │ 0xa5e9cc06d7bfb34b49fd2f6631e0fa8124a36030ae5107ebf785fca37c │  │ 0.04 │ │ 0xca1e96b358f722d601accc962dd4f7f75ee122d50e1132d25ee36 │  │ 0.00 │ ╰────────────────────────────────────────────────────────────────────┴────────────────────┴──────────────────╯ # 100 is a refund 

4.5 确认收货

• 运行命令

sui client call --package $PACKAGE_ID --module company --function confirm_receipt --args $TRANSPORTITEM999 $COMPANY --gas-budget

• 重要输出信息

╭──────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ Object Changes │ ├──────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Mutated Objects: │ │ ┌── │ │ │ ObjectID: 0xa5e9cc06d7bfb34b49fd2f6631e0fa8124a36030ae5107ebf785fca37c │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Account Address ( 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: 51dpW1fdGD8N4gNNscivJ1Bj4xH6NbviAknscBWJK2U1 │ │ └── │ │ ┌── │ │ │ ObjectID: 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 │ │ │ Sender: 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::Company │ │ │ Version:  │ │ │ Digest: 5VGyDPiy1eQAG41j7QrKtWrUpu3tfsP34d1697B3efys │ │ └── │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯ 

4.6 提现

• 运行命令

sui client call --package $PACKAGE_ID --module company --function cash --args $COMPANYCAP $ADMIN $COMPANY --gas-budget

• 报错

RPC call failed: ErrorObject { 
    code: ServerError(-32002), message: "Transaction execution failed due to issues with transaction inputs, please review the errors and try again: Transaction was not signed by the correct sender: Object 0xbb83fb182eaaa0054dd465eb0fb0e81aa600b053b1577cf49ce0c54898 is owned by account address 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67, but given owner/signer address is 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb.", data: None } Caused by: RPC call failed: ErrorObject { 
    code: ServerError(-32002), message: "Transaction execution failed due to issues with transaction inputs, please review the errors and try again: Transaction was not signed by the correct sender: Object 0xbb83fb182eaaa0054dd465eb0fb0e81aa600b053b1577cf49ce0c54898 is owned by account address 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67, but given owner/signer address is 0xf6029b82e355f627b0e3d8941d63e139c4b73b495a2017ef48aaf17ccb.", data: None } 

因为你不是该公司的管理员，需要先切换至对应用户。

• 运行命令

sui client switch --address <alias> sui client call --package $PACKAGE_ID --module company --function cash --args $COMPANYCAP $ADMIN $COMPANY --gas-budget  

• 重要输出信息

╭─────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ Object Changes │ ├─────────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Created Objects: │ │ ┌── │ │ │ ObjectID: 0xbeeb642a28821f6608f74f4137c7657f0a2ef51fe8081fe680dc275f │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: 8K3U4WEqjzMhjh2RhWFwVYpr35jkroAtXUoHEtSzxdqD │ │ └── │ │ Mutated Objects: │ │ ┌── │ │ │ ObjectID: 0x6a8d2d47ad669e0ff5d4c4d32ddbdaca375f3eabf454a42701beb1ec06 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: CPzvjMrt83jp6UhdpMaJMkid5Z3uqQa46uVGYWBkvzYM │ │ └── │ │ ┌── │ │ │ ObjectID: 0xbb83fb182eaaa0054dd465eb0fb0e81aa600b053b1577cf49ce0c54898 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::CompanyCap │ │ │ Version:  │ │ │ Digest: 9xw1ApyAkSEZjQA24ixvK4h5CGvdpQHxRTLS81SXRNYp │ │ └── │ │ ┌── │ │ │ ObjectID: 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::Company │ │ │ Version:  │ │ │ Digest: AEnTkUuctn8S7eGhDVdhMCBb49pttjjyivBJksqpg9a2 │ │ └── │ │ ┌── │ │ │ ObjectID: 0xde3c0d1745acf9aaad1b79d1fd04fb0fa4943bdea98006af │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::admin::Admin │ │ │ Version:  │ │ │ Digest: 5zoMeLAmpr29RFUxMbAvdNethPXbreEnpJdhzdxFu9kv │ │ └── │ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 

• 确认公司对象

sui client object $COMPANY # outputs ╭───────────────┬─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ objectId │ 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 │ │ version │  │ │ digest │ AEnTkUuctn8S7eGhDVdhMCBb49pttjjyivBJksqpg9a2 │ │ objType │ 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::Company │ │ owner │ ╭────────┬─────────────────────────────────────────╮ │ │ │ │ Shared │ ╭────────────────────────┬────────────╮ │ │ │ │ │ │ │ initial_shared_version │  │ │ │ │ │ │ │ ╰────────────────────────┴────────────╯ │ │ │ │ ╰────────┴─────────────────────────────────────────╯ │ │ prevTx │ HL7sXWFe2bGSHd7sE8VCkksBBzQP3VwuS3NVwWdiRvyM │ │ storageRebate │  │ │ content │ ╭───────────────────┬─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ │ │ │ dataType │ moveObject │ │ │ │ │ type │ 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::Company │ │ │ │ │ hasPublicTransfer │ false │ │ │ │ │ fields │ ╭─────────────────────────┬───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ all_profit │ 1000 │ │ │ │ │ │ │ │ can_be_cashed │ 0 │ │ │ │ │ │ │ │ id │ ╭────┬──────────────────────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ id │ 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 │ │ │ │ │ │ │ │ │ │ ╰────┴──────────────────────────────────────────────────────────────────────╯ │ │ │ │ │ │ │ │ name │ NightCandle │ │ │ │ │ │ │ │ price_per_hundred_grams │ 100 │ │ │ │ │ │ │ │ waiting_for_receipt │ ╭────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ type │ 0x2::linked_table::LinkedTable<0x2::object::ID, 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::company::ItemInfo> │ │ │ │ │ │ │ │ │ │ │ fields │ ╭──────┬───────────────────────────────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ │ │ │ head │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ id │ ╭────┬──────────────────────────────────────────────────────────────────────╮ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ id │ 0xfb39822d0d3883ed1a02d720ed6bc1f38a09b8c2b7ad33d00a466dc5 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ╰────┴──────────────────────────────────────────────────────────────────────╯ │ │ │ │ │ │ │ │ │ │ │ │ │ │ size │ 0 │ │ │ │ │ │ │ │ │ │ │ │ │ │ tail │ │ │ │ │ │ │ │ │ │ │ │ │ │ ╰──────┴───────────────────────────────────────────────────────────────────────────────╯ │ │ │ │ │ │ │ │ │ │ ╰────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │ │ │ │ │ │ │ ╰─────────────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │ │ │ │ ╰───────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ │ ╰───────────────┴─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ 

可以发现，all_profit是 $\text{1000}$，理论上来说，平台发布者赚取 $\text{10}$，公司管理者赚取 $\text{990}$，可以通过sui client gas来查看，当然，你首先需要用Publisher进行提现。

• 运行命令

sui client call --package $PACKAGE_ID --module admin --function withdraw --args $PUBLISHER $ADMIN --gas-budget

• 重要输出信息

╭──────────────────────────────────────────────────────────────────────────────────────────────────╮ │ Object Changes │ ├──────────────────────────────────────────────────────────────────────────────────────────────────┤ │ Created Objects: │ │ ┌── │ │ │ ObjectID: 0xfcf76783c005cda38c7fea70508eb6f6e8e3998dc3f08cb454ec58341 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: 31FWkR7WmpdBEgZCaSsh28Ffs8AFLJQMMz2T7vQT1bHz │ │ └── │ │ Mutated Objects: │ │ ┌── │ │ │ ObjectID: 0x64adbd96ade6dc79eeec7f5b8caaaa295f162deeb0d │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::package::Publisher │ │ │ Version:  │ │ │ Digest: 6XkP1sj42fcPY413r6TrVWxgwCv9qa2ic8wc95t5cgBM │ │ └── │ │ ┌── │ │ │ ObjectID: 0x6a8d2d47ad669e0ff5d4c4d32ddbdaca375f3eabf454a42701beb1ec06 │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Account Address ( 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 ) │ │ │ ObjectType: 0x2::coin::Coin<0x2::sui::SUI> │ │ │ Version:  │ │ │ Digest: UfJzotSMJAFTPQRqtsVwdKpX3qfxcEyVhxa5ZfvJdkU │ │ └── │ │ ┌── │ │ │ ObjectID: 0xde3c0d1745acf9aaad1b79d1fd04fb0fa4943bdea98006af │ │ │ Sender: 0x9e4092b6a894e6b168aa1c6c009f5c1c1fcb83fb95e5aa39144e1d2be4ee0d67 │ │ │ Owner: Shared │ │ │ ObjectType: 0x9bf00314ecf5c82bce70a7afacd600e76ac31d78588d81ed63d2d6::admin::Admin │ │ │ Version:  │ │ │ Digest: EMiBCe4QXLrhEpexZaiV8FGyHVbi6WYnAwCZ1dSvwCxq │ │ └── │ ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯ 

4.7 注销公司

• 运行命令

sui client call --package $PACKAGE_ID --module company --function destroy_company --args $COMPANYCAP $COMPANY --gas-budget

• 确认公司对象

sui client object $COMPANY # outputs Internal error, cannot read the object: Object has been deleted object_id: 0xcab6bc0ebef6ccf8cd18fcb424e3b5ee5d35544e03536aac66a0f8b0a2 at version: SequenceNumber() in digest o#7gyGAp71YXQRoxmFBaHxofQXAipvgHyBKPyxmdSJxyvz 

五：免责声明及其它

本项目仅供学习使用，相关代码逻辑及测试尚不完善，同时也并不能保证其交易安全性，如用于商业用途请自行承担可能的后果。

源码可点击查看，后续可能对代码进行更新与优化，请以 $github$ 上的内容为准。

六：加入组织，共同进步！

• Sui 中文开发群(TG)
• $Move$ 语言学习交流群:

今天的文章
挑战者大7_合约maker是什么意思分享到此就结束了，感谢您的阅读。