xAccount

The xAccount contract acts as a transceiving point for incoming and outgoing mails.

One potential xAccount user setup

CosmWasm

#[cw_serde]
pub struct InstantiateMsg {
    pub x_account_registry: String,
    pub commanders: Vec<AccountInfo>,
}

#[cw_serde]
pub enum ExecuteMsg {
    SendMail { //mail originator
        outgoing_envelope: Envelope,
        outgoing_letter: Letter,
    },
    ReceiveMail { //mail responder
        vaa: Binary,
    },
    ReceiveMailResponse{ //mail originator processing mail responder's mail
        vaa: Binary
    },
    UpdateConfig {
        x_account_registry: String,
    },

    UpsertCommander{ //none to delete
        id: u64,
        account: Option<AccountInfo>,
    },

    UpsertSubordinate{ //none to delete, and factory is allowed to upsert non-none accounts
        id: u64,
        account: Option<AccountInfo>,
    },
}

#[cw_serde]
pub enum QueryMsg{
    Config{},

    ReadMail{ vaa: Binary},

    FetchMail{ mail_key: Binary},

    DeserializeMail{ serialized_mail: Binary},
}

#[cw_serde]
pub struct ConfigResponse{
    pub x_account_registry: String,
    pub commanders: Vec<AccountInfo>,
    pub subordinates: Vec<AccountInfo>,
}

Solidity

interface xAccount 
    constructor(address registry, MailStructs.AccountInfo memory initialCommander);

    function sendMail(MailStructs.Envelope memory outgoingEnvelope, MailStructs.Letter memory outgoingLetter, uint8 vaaConsistencyLevel) public;

    function sendMail(MailStructs.Envelope memory outgoingEnvelope, MailStructs.Letter memory outgoingLetter) public;

    function receiveMail(bytes memory vaa, uint8 vaaConsistencyLevel) public returns (bytes memory);

    function receiveMail(bytes memory vaa) public;

    function receiveMailResponse(bytes memory vaa) public returns (bytes memory);

    function upsertCommander(uint64 wormholeId, MailStructs.AccountInfo memory account) public;


    function upsertSubordinate(uint64 wormholeId, MailStructs.AccountInfo memory account) public;

    function _assertIncomingVaa(bytes memory vaa, Registry.Config memory registryConfig) internal returns (MailStructs.Mail memory);

    function fetchMail(bytes16 mailKey) public view returns(MailStructs.Mail memory);

    function getCommanders() public view returns (MailStructs.AccountInfo[] memory);

    function getSubordinates() public view returns (MailStructs.AccountInfo[] memory);
}