@interchainjs/injective

Transaction codec and client to communicate with any injective blockchain.

Usage

npm install @interchainjs/injective

Using DirectSigner

Create and use signers for transaction signing and broadcasting:

import { DirectSigner } from '@interchainjs/injective';
import { EthSecp256k1HDWallet } from '@interchainjs/injective';
import { HDPath } from '@interchainjs/types';
 
// Create wallet from mnemonic (Injective uses Ethereum-style addresses)
const wallet = await EthSecp256k1HDWallet.fromMnemonic(mnemonic, {
  derivations: [{
    prefix: "inj",
    hdPath: HDPath.ethereum(0, 0, 0).toString(), // m/44'/60'/0'/0/0
  }]
});
 
const signer = new DirectSigner(wallet, {
  chainId: 'injective-1',
  queryClient: queryClient,
  addressPrefix: 'inj'
});
 
// Sign and broadcast transaction
const result = await signer.signAndBroadcast({
  messages: [{
    typeUrl: '/cosmos.bank.v1beta1.MsgSend',
    value: {
      fromAddress: 'inj1...',
      toAddress: 'inj1...',
      amount: [{ denom: 'inj', amount: '1000000000000000000' }] // 1 INJ
    }
  }],
  fee: {
    amount: [{ denom: 'inj', amount: '500000000000000' }],
    gas: '200000'
  }
});
 
console.log('Transaction hash:', result.transactionHash);

Using with External Wallets

For integration with browser wallets like Keplr or Leap:

import { DirectSigner } from '@interchainjs/injective';
 
// Get offline signer from external wallet
await window.keplr.enable(chainId);
const offlineSigner = window.keplr.getOfflineSigner(chainId);
 
// Create signer with offline signer
const signer = new DirectSigner(offlineSigner, {
  chainId: 'injective-1',
  queryClient: queryClient,
  addressPrefix: 'inj'
});
 
// Use the same signing interface
const result = await signer.signAndBroadcast({
  messages: [/* your messages */],
  fee: { amount: [{ denom: 'inj', amount: '500000000000000' }], gas: '200000' }
});

For more information:

See @interchainjs/auth for wallet creation
See @interchainjs/cosmos-types for message types (Injective uses Cosmos SDK messages)

Implementations

DirectSigner: Protobuf-based signing for optimal performance (@interchainjs/injective)
AminoSigner: JSON-based signing for legacy compatibility (@interchainjs/injective)
EthSecp256k1HDWallet: HD wallet implementation with Ethereum-style addresses (@interchainjs/injective)
InjectiveQueryClient: Query client for Injective RPC endpoints (@interchainjs/injective)

Key Features

Cosmos Compatibility: Uses Cosmos SDK transaction format with Ethereum-style addresses
Unified Interface: Both signers implement IUniSigner with identical methods
Flexible Authentication: Works with both direct wallets and external wallets
Type Safety: Full TypeScript support with proper type inference

For Developers

Understanding the Architecture

To understand how the Injective network implementation fits into the broader InterchainJS architecture:

Auth vs. Wallet vs. Signer - Understanding the three-layer architecture
Tutorial - Using and extending signers

Implementing Custom Networks

If you're implementing support for a new Injective-compatible network or want to understand the architectural patterns used in this implementation:

Network Implementation Guide - Comprehensive guide for implementing blockchain network support
Workflow Builder and Plugins Guide - Plugin-based transaction workflow architecture for extensible transaction building

Interchain JavaScript Stack ⚛️

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

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

Credits

🛠 Built by Hyperweb (formerly Cosmology) — if you like our tools, please checkout and contribute to our github ⚛️ (opens in a new tab)

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.

Overview Overview