> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cosmos Integration

> Use Para Server SDK with Cosmos-based blockchains

export const Link = ({href, label, newTab = false}) => {
  const [isHovered, setIsHovered] = useState(false);
  return <a href={href} target={newTab ? '_blank' : '_self'} rel={newTab ? 'noopener noreferrer' : undefined} className="not-prose inline-block relative text-black font-semibold cursor-pointer border-b-0 no-underline" onMouseEnter={() => setIsHovered(true)} onMouseLeave={() => setIsHovered(false)}>
      {label}
      <span className={`absolute left-0 bottom-0 w-full rounded-sm bg-gradient-to-r from-orange-600 to-purple-600 transition-all duration-300 ${isHovered ? 'h-0.5' : 'h-px'}`} />
    </a>;
};

Para Server SDK seamlessly integrates with Cosmos-based blockchains through the CosmJS library. Once you've set up and authenticated your Para Server client, the Cosmos integration works identically to the client-side implementation.

<Note>
  Before using this integration, ensure you've completed the server setup by importing a client session or creating a pregenerated wallet. See the <Link label="Server Setup Guide" href="/v3/server/setup" /> for details.
</Note>

## Installation

Install the required dependencies for Cosmos integration:

```bash theme={null}
npm install @getpara/cosmjs-v0-integration @cosmjs/stargate @cosmjs/proto-signing @cosmjs/amino @cosmjs/encoding --save-exact
```

## Implementation

The Para integration with CosmJS provides a custom signer that works with Stargate Client:

```typescript theme={null}
import { Para as ParaServer } from "@getpara/server-sdk";
import { createParaProtoSigner } from "@getpara/cosmjs-v0-integration";
import { SigningStargateClient } from "@cosmjs/stargate";

// Para server client (already authenticated)
const paraServer = new ParaServer("YOUR_API_KEY");

// Create the Para Cosmos Signer
const signer = createParaProtoSigner({ para: paraServer, prefix: "cosmos" });

// Connect to the Cosmos network
const rpcUrl = "https://rpc.cosmos.network"; // Replace with your preferred RPC endpoint
const client = await SigningStargateClient.connectWithSigner(rpcUrl, signer);

// Get the wallet address
const address = await signer.getAddress();
console.log(`Wallet address: ${address}`);

// Get account balance
const balance = await client.getBalance(address, "uatom");
console.log(`Balance: ${balance.amount} ${balance.denom}`);

// Send tokens
const recipient = "cosmos1recipient";
const amount = {
  denom: "uatom",
  amount: "100000", // 0.1 ATOM (uatom is microatom, 1 ATOM = 1,000,000 uatom)
};

const result = await client.sendTokens(
  address,
  recipient,
  [amount],
  {
    amount: [{ denom: "uatom", amount: "5000" }],
    gas: "200000",
  }
);

console.log(`Transaction hash: ${result.transactionHash}`);
```

## Chain Support

The Para Cosmos integration supports various Cosmos-based chains. You can specify the chain when creating the signer:

```typescript theme={null}
// For Cosmos Hub
const cosmosSigner = createParaProtoSigner({ para: paraServer, prefix: "cosmos" });

// For Osmosis
const osmosisSigner = createParaProtoSigner({ para: paraServer, prefix: "osmosis" });

// For other supported chains
const otherChainSigner = createParaProtoSigner({ para: paraServer, prefix: "chainName" });
```

## Best Practices

* Use appropriate gas settings for different types of transactions
* Implement proper error handling for network failures
* Consider retry logic for RPC endpoints
* Always verify transaction details before sending

## Learn More

For detailed examples of using Para with Cosmos, including chain-specific operations and advanced transaction types, refer to our web documentation:

<Card title="Web Cosmos Integration Guide" imgUrl="/images/v3/network-cosmos.png" href="/v3/react/guides/web3-operations/cosmos/setup-libraries" description="Comprehensive guide to using Para with Cosmos ecosystem" horizontal />

## Examples

Explore our server-side Cosmos integration examples:

<Card title="Cosmos Server Example" imgUrl="/images/v3/network-cosmos.png" href="https://github.com/getpara/examples-hub/blob/3.0.0/server/with-node/src/routes/signWithCosmJS.ts" description="Complete example of using Para with CosmJS in a Node.js server" horizontal />