@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, Utils, Client | Everything from token symbols, logos, and IBC denominations for all assets you want to support in your application. | | Wallet Connectors | Interchain Kit, Cosmos Kit | Experience the convenience of connecting with a variety of web3 wallets through a single, streamlined interface. | | Signing Clients | InterchainJS, 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 App, 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.