# User Guide **1. Preface** On the two blockchains between which realized inter-blockchain communication, any token conforming to the `eosio.token specification` can register and use the IBC channel for inter-blockchain transfer , please refer to [Token Registration and Management](https://github.com/boscore/ibc_contracts/blob/master/docs/Token_Registration_and_Management.md) for more information. This article describes the IBC user interface and given command line examples. **2. "transfer" action** function definition: ``` [[eosio::action]] void transfer( name from, name to, asset quantity, string memo ); ``` *1. "to" account* The "to" account must be the account which deployed ibc.token contract. In BOS-EOS IBC system, the "to" account on both EOS mainnet and BOS mainnet are **bosibc.io**. *Note: StartEOS contributed the EOS mainnet account bosibc.io; as the encouragement for the community contributions.* *2. "quantity"* The token must be registered, and the quantity amount must satisfies this token's quotas, see [Token Quotas](https://github.com/boscore/ibc_contracts/blob/master/docs/User_Guide.md#4-token-quotas). *3. "memo" format* memo format for ibc transaction is very important, because you should provide acceptance accounts on peer chain in memo string. format is: **{account\_name}@{chain\_name} {user-defined string}** Notice the black space between {chain\_name} and {user-defined string}, there is at least one black space here. {user-defined string} is optinal, it can include spaces, special characters, etc. {chain\_name} is defined by "peerchain\_name" in ibc.token's "globals" table. examples: 'bosaccount11\@bos happy new year 2019' 'eosaccount11\@eos' note: if you want to transfer token to "to" account itself, not want a ibc transaction, the memo string must star with "local", otherwise the transaction will fail. source code refer `token::transfer_notify()` and `token::transfer()` in ibc.token contract. **3. Command Line Examples** Transfer 100 EOS from EOS mainnet account `eosaccount` to BOS mainnet `bosaccount` ``` $cleos -u transfer eosaccount bosibc.io "100.0000 EOS" "bosaccount@bos hello!" ``` Withdraw 100 EOS from BOS mainnet account `bosaccount` to EOS mainnet `eosaccount2` ``` $cleos -u transfer -c bosibc.io bosaccount bosibc.io "100.0000 EOS" "eosaccount2@eos hi!" ``` Transfer 100 BOS from BOS mainnet account `bosaccount` to EOS mainnet `eosaccount` ``` $cleos -u transfer bosaccount bosibc.io "100.0000 BOS" "eosaccount@eos hello!" ``` Withdraw 100 BOS from EOS mainnet account `eosaccount` to BOS mainnet `bosaccount2` ``` $cleos -u transfer -c bosibc.io eosaccount bosibc.io "100.0000 BOS" "bosaccount2@bos hi!" ``` After send transfer action, and waiting for **4 to 5 minutes** (if you transfer form EOS mainnet to BOS mainnet, and in the case of BPs schedule replacement, it may need up to 8 minutes) or waiting for about 10 seconds(if you transfer form BOS mainnet to EOS mainnet), then you can go to the peer chains to check if you have received that token. It takes so long time to wait when transfer form EOS mainnet to BOS mainet, because the consensus of EOS mainnet is pipeline-pbft, and it need long time to let a block inter LIB, but only 10 seconds to wait when transfer form BOS mainnet to EOS miannet, because BOS use a very fast finality consensus algorithem, that's batch-pbft. for more IBC theory please refer to [EOSIO IBC Priciple and Design](https://github.com/boscore/ibc_contracts/blob/Documentation/IBC/EOSIO_IBC_Priciple_and_Design.md). So users can transfer assets across the chains by using any existing mobile app eosio wallets, the existing wallets only need to support the ibc.token contract, because the transfer action interface definition of ibc.token contract is exactly the same as that of eosio.token contract **4. Token Quotas** All token quotas are defined in ibc.token contracts, take bosibc.io as an example of ibc.token contract, please refer to [Token Registration and Management](https://github.com/boscore/ibc_contracts/blob/master/docs/Token_Registration_and_Management.md) for detailed explanation. you can get them by following command: ``` $cleos -u get table bosibc.io bosibc.io accepts $cleos -u get table bosibc.io bosibc.io stats $cleos -u get table bosibc.io bosibc.io accepts $cleos -u get table bosibc.io bosibc.io stats ``` **Example Registered Tokens and Their Quotas** The following values are for reference only, possibly inconsistent with settings in ibc.token contracts, please query the contract with above commands for real-time quota. **\*EOS** of EOS mainnet\* | Item | Value | | -------------------------------- | -------------------- | | original token contract | eosio.token | | original token symbol | EOS | | peg token symbol | EOS | | maximum acceptance | 10000000000.0000 EOS | | minimum once forward transfer | **0.2000 EOS** | | maximum once forward transfer | 1000000.0000 EOS | | maximum daily forward transfers | 10000000.0000 EOS | | minimum once reverse withdrawal | **0.2000 EOS** | | maximum once reverse withdrawal | **10000.0000 EOS** | | maximum daily reverse withdrawal | 1000000.0000 EOS | | maximum transfers per minute | 100 | | maximum withdrawals per minute | 100 | | forward transfers success fee | 0 EOS | | reverse withdrawal success fee | **0.1000 EOS** | | forward transfers failed fee | fixed 0.0500 EOS | | reverse withdrawal failed fee | fixed 0.0500 EOS | | project name | - | | project official website | - | **\*BOS** of BOS mainnet\* | Item | Value | | -------------------------------- | -------------------- | | original token contract | eosio.token | | original token symbol | BOS | | peg token symbol | BOS | | maximum acceptance | 10000000000.0000 BOS | | minimum once forward transfer | **0.2000 BOS** | | maximum once forward transfer | 1000000.0000 BOS | | maximum daily forward transfers | 10000000.0000 BOS | | minimum once reverse withdrawal | **0.2000 BOS** | | maximum once reverse withdrawal | **100000.0000 BOS** | | maximum daily reverse withdrawal | 1000000.0000 BOS | | maximum transfers per minute | 100 | | maximum withdrawals per minute | 100 | | forward transfers success fee | 0 BOS | | reverse withdrawal success fee | **0.1000 BOS** | | forward transfers failed fee | fixed 0.0500 BOS | | reverse withdrawal failed fee | fixed 0.0500 BOS | | project name | boscore | | project official website | | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://boscore.gitbook.io/docs/essentials/bos-essentials/ibc-inter-blockchain-communication/user-guide.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.