NEAR 協議合約

合約地址

合約界面


impl MapCrossChainService {
    pub fn init(map_light_client: String, map_bridge_address: String, wrapped_token: String, near_chain_id: u128) -> Promise;

    pub fn version() -> &'static str;

    #[payable]
    pub fn transfer_in(&mut self, receipt_proof: ReceiptProof, index: usize) -> Promise;

    pub fn transfer_out_token(&mut self, token: String, to: Vec<u8>, amount: U128, to_chain: u128) -> Promise;

    #[payable]
    pub fn transfer_out_native(&mut self, to: Vec<u8>, to_chain: u128) -> Promise;

    #[payable]
    pub fn deposit_out_native(&mut self, to: Vec<u8>);

    #[payable]
    pub fn deploy_mcs_token(&mut self, name: String) -> Promise;

    pub fn is_used_event(&self, order_id: &CryptoHash) -> bool;

    pub fn set_metadata(
        &mut self,
        address: String,
        name: Option<String>,
        symbol: Option<String>,
        reference: Option<String>,
        reference_hash: Option<Base64VecU8>,
        decimals: Option<u8>,
        icon: Option<String>,
    ) -> Promise;

    pub fn controller(&self) -> Option<AccountId>;

    pub fn set_controller(&mut self, controller: AccountId);

    pub fn controller_or_self(&self) -> bool;

    pub fn get_mcs_tokens(&self) -> Vec<(String, HashSet<u128>)>;

    pub fn get_fungible_tokens(&self) -> Vec<(String, HashSet<u128>)>;

    pub fn get_native_token_to_chains(&self) -> HashSet<u128>;

    pub fn add_native_to_chain(&mut self, to_chain: u128);

    pub fn remove_native_to_chain(&mut self, to_chain: u128);

    pub fn add_mcs_token_to_chain(&mut self, token: String, to_chain: u128);

    pub fn remove_mcs_token_to_chain(&mut self, token: String, to_chain: u128);

    pub fn valid_mcs_token_out(&self, token: &String, to_chain: u128) -> bool;

    pub fn add_fungible_token_to_chain(&mut self, token: String, to_chain: u128) -> PromiseOrValue<()>;

    pub fn remove_fungible_token_to_chain(&mut self, token: String, to_chain: u128);

    pub fn valid_fungible_token_out(&self, token: &String, to_chain: u128) -> bool;
}

與合約接口交互

轉入

根據證明數據和事件從 Mapo 轉移到 Near。必須附加足夠的 NEAR 資金來支付證明的存儲費用。

輸入參數

transfer_out_token

Transfer out tokens to other blockchain.

輸入參數

transfer_out_native

Transfer out native token to other blockchain.

輸入參數

deposit_out_native

Deposit out native token to MAP blockchain.

輸入參數

管理界面

初始化

使用配置參數初始化合約。

輸入參數

版本

獲取當前 MCS 合約的版本信息。

deploy_mcs_token

部署 MOS 代幣合約。部署的代幣可以由 MOS 合約鑄造/銷毀。

輸入參數

is_used_event

檢查事件是否被使用。

輸入參數

輸出參數

set_metadata

獲取指定紀元的記錄信息（驗證者、閾值和紀元）。

輸入參數

控制帳戶 controller

獲取MOS 合約的控制帳戶 ID

輸出參數

set_controller

設置 MCS 合約的控制帳戶。

輸入參數

controller_or_self

檢查前任是控制者還是自己。

輸出參數

get_mcs_tokens

獲取已部署的所有MOS代幣和其目標鏈

輸出參數

get_fungible_tokens

獲取所有可置換代幣和其目標鏈

輸出參數

get_native_token_to_chains

獲取所有已註冊的本地代幣目標鏈。

輸出參數

add_native_to_chain

為原生代幣添加目標鏈。

輸入參數

remove_native_to_chain

刪除本地代幣的目標鏈。

輸入參數

add_mcs_token_to_chain

允許 MOS 代幣轉移到目標鏈。

輸入參數

remove_mcs_token_to_chain

從 MOS 代幣的允許列表中刪除目標鏈 ID。

輸入參數

valid_mcs_token_out

檢查是否允許將代幣轉移到目標鏈。

輸入參數

輸出參數

add_fungible_token_to_chain

允許將可置換代幣轉移到目標鏈。

輸入參數

remove_fungible_token_to_chain

從可替代代幣的允許列表中刪除目標鏈 ID。

輸入參數

valid_fungible_token_out

檢查是否允許將代幣轉移到目標鏈。

輸入參數

輸出參數

數據結構

以下是地圖燈客戶端合約的一些主要數據結構。

MapCrossChainService 是地圖跨鏈服務合約。


pub struct MapCrossChainService {
    /// The account of the map light client that we can use to prove
    pub map_client_account: AccountId,
    /// Address of the MAP bridge contract.
    pub map_bridge_address: Address,
    /// Set of created MCSToken contracts.
    pub mcs_tokens: UnorderedMap<String, HashSet<u128>>,
    /// Set of other fungible token contracts.
    pub fungible_tokens: UnorderedMap<String, HashSet<u128>>,
    /// Map of other fungible token contracts and their min storage balance.
    pub fungible_tokens_storage_balance: UnorderedMap<String, u128>,
    /// Map of token contracts and their decimals
    pub token_decimals: UnorderedMap<String, u8>,
    /// Set of other fungible token contracts.
    pub native_to_chains: HashSet<u128>,
    /// Hashes of the events that were already used.
    pub used_events: UnorderedSet<CryptoHash>,
    /// Public key of the account deploying the MCS contract.
    pub owner_pk: PublicKey,
    /// Balance required to register a new account in the MCSToken
    pub mcs_storage_transfer_in_required: Balance,
    // Wrap token for near
    pub wrapped_token: String,
    // Near chain id
    // FIXME: get from env?
    pub near_chain_id: u128,
    // Nonce to generate order id
    pub nonce: u128,
    /// Mask determining all paused functions
    paused: Mask,
}

ReceiptProof包括證明和收據證明。

pub struct ReceiptProof {
    // the block header where the receipt exists
    pub header: Header,
    // the aggregated G2 public key of the signed validators
    pub agg_pk: G2,
    // the receipt to prove
    pub receipt: Receipt,
    // the index of the receipt in the block
    pub key_index: Vec<u8>,
    // the proof to prove the existance of the above receipt
    pub proof: Vec<ProofEntry>,
}

PreviousEVM鏈合約 Next信使

Last updated 1 year ago