Home

Awesome

cosmos-kit

<p align="center" width="100%"> <img height="90" src="https://user-images.githubusercontent.com/545047/190171432-5526db8f-9952-45ce-a745-bea4302f912b.svg" /> </p> <p align="center" width="100%"> <a href="https://github.com/cosmology-tech/cosmos-kit/actions/workflows/run-tests.yml"> <img height="20" src="https://github.com/cosmology-tech/cosmos-kit/actions/workflows/run-tests.yml/badge.svg" /> </a> <a href="https://github.com/cosmology-tech/lib-count"> <img height="20" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fcosmology-tech%2Flib-count%2Fmain%2Foutput%2Fbadges%2Fproducts%2Fcosmos-kit%2Ftotal.json"/> </a> <a href="https://github.com/cosmology-tech/lib-count"> <img height="20" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fcosmology-tech%2Flib-count%2Fmain%2Foutput%2Fbadges%2Fproducts%2Fcosmos-kit%2Fmonthly.json"/> </a> <br /> <a href="https://github.com/cosmology-tech/cosmos-kit/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-BSD%203--Clause%20Clear-blue.svg"></a> <a href="https://www.npmjs.com/package/@cosmos-kit/core"><img height="20" src="https://img.shields.io/github/package-json/v/cosmology-tech/cosmos-kit?filename=packages%2Fcore%2Fpackage.json"></a> </p>

Cosmos Kit is a universal wallet adapter for developers to build apps that quickly and easily interact with Cosmos blockchains and wallets.

🏁 Quickstart

Get started quickly by using create-cosmos-app to help you build high-quality Cosmos apps fast!

βš™οΈ Configuration

Check out our docs here to configure CosmosKit.

βš›οΈ CosmJS Signers

If you want to get a cosmjs stargate or cosmwasm signer, here are docs for our hooks

πŸ“¦ Packages

NameDescription
cosmos-kitSingle package for React developers to install Cosmos Kit
@cosmos-kit/coreCore Cosmos Kit functionality
@cosmos-kit/walletconnectMobile WalletConnect support for the Cosmos ecosystem
@cosmos-kit/reactReact integration with Interchain UI Modal for simple usage
@cosmos-kit/react-liteA lightweight version of React integration without UI for customization

πŸ“¦ Wallets

Explore the range of wallet adapters available in our wallets directory.

<p align="center" width="100%"> <a href="https://www.keplr.app/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/keplr.svg" /> </a> <a href="https://www.ledger.com/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/ledger.png" /> </a> <a href="https://www.leapwallet.io/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/leap.png" /> </a> <a href="https://wallet.cosmostation.io/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/cosmostation.png" /> </a> <a href="https://www.ctrl.xyz/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/ctrl.svg" /> </a> <a href="https://www.exodus.com/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/exodus.png" /> </a> <br /> <a href="https://crypto.com/defi-wallet"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/cdcwallet.png" /> </a> <a href="https://www.okx.com/web3"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/okxwallet.svg" /> </a> <a href="https://walletconnect.com/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/wallet-connect.svg" /> </a> <a href="https://chromewebstore.google.com/detail/station-wallet/aiifbnbfobpmeekipheeijimdpnlpgpp?hl=en"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/station.svg" /> </a> <a href="https://trustwallet.com/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/trust.png" /> </a> <a href="https://omni.app/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/omni.png" /> </a> <br /> <a href="https://compasswallet.io/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/compass.png" /> </a> <a href="https://coin98.com/wallet"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/coin98.png" /> </a> <a href="https://chromewebstore.google.com/detail/galaxy-station-wallet/akckefnapafjbpphkefbpkpcamkoaoai?hl=en"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/galaxystation.svg" /> </a> <a href="https://vectis.space/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/vectis.png" /> </a> <a href="https://www.frontier.xyz/"> <img width="30px" src="https://raw.githubusercontent.com/cosmology-tech/cosmos-kit/main/public/images/logos/wallets/frontier.png" /> </a> </p>

πŸ”Œ Integrating Wallets

See our docs on integrating your wallet

πŸš€ Running Example

For high-level examples suitable for most developers, explore our create-cosmos-app. For a deeper, more technical understanding, this repository contains an example, which is also useful when integrating new wallets.

yarn build
cd packages/example
yarn dev

Basic Next.js Example

This example demonstrates a Next.js project that integrates the @cosmos-kit/react wallet adapter. Note that this example has historically been used by multiple teams to test PRs.

"vanilla" example showing how WalletManager works

This example is ideal for developers looking to create integrations for Vue.js, Svelte, or other frameworks. It uses a basic Next.js setup without relying on React-specific hooks, providing a clear model for building custom integrations.

πŸ›  Developing

Checkout the repository and bootstrap the yarn workspace:

# Clone the repo.
git clone https://github.com/cosmology-tech/cosmos-kit
cd cosmos-kit
yarn

Building

yarn build

Publishing

lerna publish
# lerna publish minor
# lerna publish major

Related

Checkout these related projects:

Credits

πŸ›  Built by Cosmology β€”Β if you like our tools, please consider delegating to our validator βš›οΈ

Disclaimer

AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED β€œAS IS”, AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.

No developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.