cosmos-kit

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

⚠️ UPGRADE to 3.0

Cosmos Kit 3.0 and Create Cosmos App 2.0 is here!

Please use interchain-kit, the official successor with improved tooling, broader compatibility, and full Interchain ecosystem support. You can also see create-interchain-app our official starter kit that supports Interchain Kit.

🏁 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

Name	Description
cosmos-kit	Single package for React developers to install Cosmos Kit
@cosmos-kit/core	Core Cosmos Kit functionality
@cosmos-kit/walletconnect	Mobile WalletConnect support for the Cosmos ecosystem
@cosmos-kit/react	React integration with Interchain UI Modal for simple usage
@cosmos-kit/react-lite	A lightweight version of React integration without UI for customization

📦 Wallets

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

🔌 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.

pnpm run build
cd packages/example
pnpm 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.

• /wallet-manager - Index page for wallet functionality
• /wallet-manager/wallet-operate - Operate Wallet Directly
• /wallet-manager/main-wallets - Show All Main Wallets
• /wallet-manager/wallet-manager - Wallet Manager Without Hook
• /wallet-manager/wallet-repos - Show All Wallet Repos
• /wallet-manager/wallet-repo - Show One Wallet Repo

🛠 Developing

Checkout the repository and bootstrap the pnpm workspace:

# Clone the repo.
git clone https://github.com/hyperweb-io/cosmos-kit
cd cosmos-kit
pnpm install

Building

pnpm run build

Publishing

lerna publish
# lerna publish minor
# lerna publish major

Interchain JavaScript Stack

A unified toolkit for building applications and smart contracts in the Interchain ecosystem ⚛️

Category	Tools	Description
Chain Information	Chain Registry, Utils, Client	Everything from token symbols, logos, and IBC denominations for all assets you want to support in your application.
Wallet Connectors	Interchain Kitbeta, Cosmos Kit	Experience the convenience of connecting with a variety of web3 wallets through a single, streamlined interface.
Signing Clients	InterchainJSbeta, CosmJS	A single, universal signing interface for any network
SDK Clients	Telescope	Your Frontend Companion for Building with TypeScript with Cosmos SDK Modules.
Starter Kits	Create Interchain Appbeta, Create Cosmos App	Set up a modern Interchain app by running one command.
UI Kits	Interchain UI	The Interchain Design System, empowering developers with a flexible, easy-to-use UI kit.
Testing Frameworks	Starship	Unified Testing and Development for the Interchain.
TypeScript Smart Contracts	Create Hyperweb App	Build and deploy full-stack blockchain applications with TypeScript
CosmWasm Contracts	CosmWasm TS Codegen	Convert your CosmWasm smart contracts into dev-friendly TypeScript classes.

Credits

🛠 Built by the Constructive team — makers of Hyperweb

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.