update: add IBC transfer action to README

Author: KacperKoza343

packages/plugin-cosmos/README.md

@@ -7,15 +7,17 @@ This plugin provides actions and utilities for interacting with Cosmos-compatibl
 ## Development
 
 Prepare Eliza according to [README](../../README.md)
- Add variables required for `@ai16z/plugin-cosmos` :
- ```
+Add variables required for `@ai16z/plugin-cosmos` :
+
+```
 COSMOS_RECOVERY_PHRASE=your recovery phrase words
 COSMOS_AVAILABLE_CHAINS=chain1,chain2,chain3
-  ```
+```
 
 Ensure the appropriate environment variables are added for the plugin. If they are correctly configured, the project will run with `@ai16z/plugin-cosmos`
 
-Run Eliza 
+Run Eliza
+
 ```
 pnpm run dev
 ```
@@ -26,13 +28,12 @@ pnpm run dev
 
 To start using the plugin, you need to provide your **Cosmos account recovery phrases** and the list of **available chains**. Add the following to your `.env` file:
 
-
 ```env
 COSMOS_RECOVERY_PHRASE=your recovery phrase words
 COSMOS_AVAILABLE_CHAINS=chain1,chain2,chain3
 ```
-Ensure that the chain names in `COSMOS_AVAILABLE_CHAINS` match the identifiers from the [chain-registry](https://github.com/cosmos/chain-registry) library for compatibility.
 
+Ensure that the chain names in `COSMOS_AVAILABLE_CHAINS` match the identifiers from the [chain-registry](https://github.com/cosmos/chain-registry) library for compatibility.
 
 ### Using the Cosmos Helper Character
 
@@ -51,9 +52,11 @@ To use the character, pass it with the `--characters` flag:
 ---
 
 ### Custom chain configuration
+
 Plugin allows you to pass you custom chain config to `createCosmosPlugin` function invoked in `../agent/src/index`.
 
 Your custom configuration fulfills the interfaces from `chain-registry`
+
 ```
 import  type { assets, chains } from  "chain-registry";
 
@@ -99,6 +102,46 @@ Yes
 
 4. Action executed.
 
+### Token IBC Transfer
+
+This plugin supports a token transfer action, which allows users to transfer tokens between addresses on Cosmos-compatible blockchains between different chains.
+
+#### Requirements
+
+You need to set both chain that you want to transfer founds between in env file. For example:
+
+```
+COSMOS_AVAILABLE_CHAINS=osmosistestnet,neutrontestnet
+```
+
+If you want to transfer your tokens between Osmosis Testnet and Neutron Testnet
+
+#### Example Prompts
+
+Below are examples of how the ibc transfer action can be initiated and confirmed:
+
+**Example**
+
+1. User input:
+
+```
+Make an IBC transfer 0.0001 OSMO to neutron1nk3uuw6zt5t5aqw5fvujkd54sa4uws9xg2nk82 from osmosistestnet to neutrontestnet
+```
+
+2. Plugin response:
+
+```
+Before making the IBC transfer, I would like to confirm the details. You would like to transfer 0.0001 OSMO from osmosistestnet to neutrontestnet, specifically to the address neutron1nk3uuw6zt5t5aqw5fvujkd54sa4uws9xg2nk82, is that correct?
+```
+
+3. User confirmation:
+
+```
+Yes
+```
+
+4. Action executed.
+
 ---
 
 ## Contribution