# Converter

The Converter contract is used to convert between wrapped bAsset tokens (wrapped tokens transferred to Terra via Wormhole bridge) and Anchor collateral bAsset tokens (token registered as Anchor collateral).

The existence of two bAsset tokens is due reward-accruing functionalities required for Anchor collateral tokens, which is not available on Wormhole wrapped tokens (automatically created by Wormhole bridge). 

The Converter contract allows users to convert between the two tokens. Locking Wormhole wrapped tokens mints new Anchor collateral bAsset tokens in 1:1 ratio and vice versa.

## Contract State

### Config

Stores information about the contract configuration.

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct Config {
    pub owner: CanonicalAddr,
    pub anchor_token_address: Option<CanonicalAddr>,
    pub wormhole_token_address: Option<CanonicalAddr>,
}
```

| Key                        | Type          | Description                                        |
| -------------------------- | ------------- | -------------------------------------------------- |
| `owner`                    | CanonicalAddr | Address of contract owner                          |
| `anchor_token_address`\*   | CanonicalAddr | Contract address of Wormhole wrapped token         |
| `wormhole_token_address`\* | CanonicalAddr | Contract address of Anchor bAsset collateral token |

\* = not stored until value registered

## InstantiateMsg

{% tabs %}
{% tab title="Rust" %}

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct InstantiateMsg {
    pub owner: String,
}
```

| Key          | Type   | Description               |
| ------------ | ------ | ------------------------- |
| `owner`      | String | Address of contract owner |
| {% endtab %} |        |                           |

{% tab title="JSON" %}

```json
{
  "owner": "terra1..." 
}
```

| Key           | Type   | Description               |
| ------------- | ------ | ------------------------- |
| `owner`       | String | Address of contract owner |
| {% endtab %}  |        |                           |
| {% endtabs %} |        |                           |

## ExecuteMsg

### `Receive`

Can be called during a CW20 token transfer when the Mint contract is the recipient. Allows the token transfer to execute a Receive Hook as a subsequent action within the same transaction.

{% tabs %}
{% tab title="Rust" %}

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
    Receive {
        sender: String,
        amount: Uint128,
        msg: Binary,
    }
}
```

| Key          | Type    | Description                                   |
| ------------ | ------- | --------------------------------------------- |
| `sender`     | String  | Sender of token transfer                      |
| `amount`     | Uint128 | Amount of tokens received                     |
| `msg`        | Binary  | Base64-encoded string of JSON of Receive Hook |
| {% endtab %} |         |                                               |

{% tab title="JSON" %}

```json
{
  "receive": {
    "sender": "terra1...",
    "amount": "10000000",
    "msg": "eyAiZXhlY3V0ZV9tc2ciOiAiYmxhaCBibGFoIiB9"
  }
}
```

| Key           | Type    | Description                                   |
| ------------- | ------- | --------------------------------------------- |
| `sender`      | String  | Sender of token transfer                      |
| `amount`      | Uint128 | Amount of tokens received                     |
| `msg`         | Binary  | Base64-encoded string of JSON of Receive Hook |
| {% endtab %}  |         |                                               |
| {% endtabs %} |         |                                               |

### RegisterTokens

Registers token contract addresses.

{% tabs %}
{% tab title="Rust" %}

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum ExecuteMsg {
    RegisterTokens {
        wormhole_token_address: String,
        anchor_token_address: String,
    },
}
```

| Key                      | Type   | Description                                        |
| ------------------------ | ------ | -------------------------------------------------- |
| `wormhole_token_address` | String | Contract address of Wormhole wrapped token         |
| `anchor_token_address`   | String | Contract address of Anchor bAsset collateral token |
| {% endtab %}             |        |                                                    |

{% tab title="JSON" %}

```json
{
  "register_tokens": {
    "wormhole_token_address": "terra1...", 
    "anchor_token_address": "terra1..." 
  }
}
```

| Key                      | Type   | Description                                        |
| ------------------------ | ------ | -------------------------------------------------- |
| `wormhole_token_address` | String | Contract address of Wormhole wrapped token         |
| `anchor_token_address`   | String | Contract address of Anchor bAsset collateral token |
| {% endtab %}             |        |                                                    |
| {% endtabs %}            |        |                                                    |

## Receive Hooks

### `ConvertWormholeToAnchor`

Converts Wormhole wrapped tokens to Anchor collateral bAsset tokens.

{% tabs %}
{% tab title="Rust" %}

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum Cw20HookMsg {
    ConvertWormholeToAnchor {}
}
```

| Key          | Type | Description |
| ------------ | ---- | ----------- |
|              |      |             |
| {% endtab %} |      |             |

{% tab title="JSON" %}

```json
{
  "convert_wormhole_to_anchor": {}
}
```

| Key           | Type | Description |
| ------------- | ---- | ----------- |
|               |      |             |
| {% endtab %}  |      |             |
| {% endtabs %} |      |             |

### `ConvertAnchorToWormhole`

Converts Anchor collateral bAsset tokens to Wormhole wrapped tokens.

{% tabs %}
{% tab title="Rust" %}

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum Cw20HookMsg {
    ConvertAnchorToWormhole {}
}
```

| Key          | Type | Description |
| ------------ | ---- | ----------- |
|              |      |             |
| {% endtab %} |      |             |

{% tab title="JSON" %}

```json
{
  "convert_anchor_to_wormhole": {}
}
```

| Key           | Type | Description |
| ------------- | ---- | ----------- |
|               |      |             |
| {% endtab %}  |      |             |
| {% endtabs %} |      |             |

## QueryMsg

### `Config`

Gets the contract configuration.

{% tabs %}
{% tab title="Rust" %}

#### Request

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
#[serde(rename_all = "snake_case")]
pub enum QueryMsg {
    Config {},
}
```

| Key | Type | Description |
| --- | ---- | ----------- |
|     |      |             |

#### Response

```rust
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]
pub struct ConfigResponse {
    pub owner: String,
    pub wormhole_token_address: Option<String>,
    pub anchor_token_address: Option<String>,
}
```

|                            |        |                                             |
| -------------------------- | ------ | ------------------------------------------- |
| `owner`                    | String | Address of contract owner                   |
| `wormhole_token_address`\* | String | Contract address of Wormhole wrapped token  |
| `anchor_token_address`\*   | String | Contract address of Anchor collateral token |

\* = optional
{% endtab %}

{% tab title="JSON" %}

#### Request

```rust
{
  "config": {}
}
```

| Key | Type | Description |
| --- | ---- | ----------- |
|     |      |             |

#### Response

```rust
{
  "owner": "terra1...", 
  "wormhole_token_address": "terra1...", 
  "anchor_token_address": "terra1..." 
}
```

|                            |        |                                             |
| -------------------------- | ------ | ------------------------------------------- |
| `owner`                    | String | Address of contract owner                   |
| `wormhole_token_address`\* | String | Contract address of Wormhole wrapped token  |
| `anchor_token_address`\*   | String | Contract address of Anchor collateral token |

\* = optional
{% endtab %}
{% endtabs %}


---

# 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://docs.anchorprotocol.com/anchor-2/smart-contracts/beth/converter.md?ask=<question>
```

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.