Cosmos Provider API

Exodus injects a global API into websites visited by its users at window.exodus.cosmos.

Methods

cosmos.connect(options)

interface ConnectionOptions {
  chainId: string
  onlyIfTrusted?: boolean
}

interface Account {
  address: string // bech32 encoded.
  algo: 'secp256k1' | 'ed25519' | 'sr25519'
  publicKey: Uint8Array
}

cosmos.connect(options: ConnectionOptions): Promise<Account>

Use connect() to request access to the user's account. This will open a pop-up asking the user to approve the connection. If the user approves, Exodus will return account information related to the requested chain ID.

Eagerly Connecting

After the user approves a Web3 site's connection to Exodus, the site becomes trusted, which allows the site to automatically connect (eagerly connect) to Exodus on subsequent visits or page refreshes.

If you want to try to eagerly connect, you can pass the onlyIfTrusted option to connect().

try {
  await window.exodus.cosmos.connect({ chainId: 'cosmos', onlyIfTrusted: true })
} catch (err) {
  // { code: 4001, message: 'User rejected the request.' }
}

tip

When using onlyIfTrusted, Exodus will only connect if the site is trusted. Users will not see a pop-up if they have connected to Exodus before.

cosmos.signAminoTransaction(transaction)

interface Coin {
  amount: string
  denom: string
}

interface Fee {
  amount: Coin[]
  gas: string
  granter?: string
  payer?: string
}

interface AminoMessage {
  type: string
  value: any
}

interface AminoTransaction {
  chainId: string
  fee: Fee
  memo: string
  messages: AminoMessage[]
  sequence: string
  signer: string
}

cosmos.signAminoTransaction(transaction: AminoTransaction): Promise<{ signature: string }>

Use signAminoTransaction() to request the Exodus user to sign an Amino-encoded transaction without submitting it to the network, which returns a Promise that resolves to the bech32 encoded signature of the transaction.

cosmos.signTransaction(transaction)

interface Transaction {
  authInfoBytes: Uint8Array
  bodyBytes: Uint8Array
  chainId: string
  signer: string
}

cosmos.signTransaction(transaction: Transaction): Promise<{ signature: string }>

Use signTransaction() to request the Exodus user to sign a Protobuf-encoded transaction without submitting it to the network. It returns a Promise that resolves to the bech32 encoded signature of the transaction.

cosmos.sendTransaction(chainId, rawTransaction, mode)

enum SendMode {
  Block = 0, // Resolves once a transaction is confirmed.
  Sync = 1, // Resolves once a transaction is successfully submitted to a node.
  Async = 2, // Resolves immediately.
}

type Hash = string // bech32 encoded.

cosmos.sendTransaction(chainId: string, rawTransaction: string, mode?: SendMode): Promise<Hash>

Use sendTransaction() to broadcast a previously signed transaction to the network. If the SendMode parameter is missing, the Sync send mode will be used by default. It returns a Promise that resolves to the bech32 encoded transaction hash.