Simple Summary
This document is about the details of the Cosmos network asset namespace and reference for CAIP-19.
Abstract
In CAIP-19 a general asset identification scheme is defined. This is the implementation of CAIP-19 for Cosmos chain native assets and ibc assets.
Motivation
See CAIP-19.
Specification
Cosmos chain Native Asset Namespace
An Asset Namespace called "native" that references Cosmos network blockchain native assets, allowing for unique identification on Cosmos chains with multiple native assets.
Cosmos chain IBC Asset Namespace
An Asset Namespace called "ibc". It references Cosmos network blockchain Inter-Blockchain Communication Protocol assets.
Multiple Native Asset Reference Definition
The Asset Reference format for Cosmos chain native assets is the base denomination of the asset in the current chain_id.
IBC Asset Reference Definition
The Asset Reference format for Cosmos chain ibc assets is the ibc channel identifier for that asset.
Rationale
The Asset Namespace using slip44 for Cosmos chains is insufficient for chains with multiple native assets like osmosis-1. Using the "native" namespace allows multiple native assets to have unique CAIP19s.
Backwards Compatibility
Not applicable.
Test Cases
This is a list of manually composed examples
# Native Atom Asset on the cosmoshub-4 chain
cosmos:cosmoshub-4/slip44:118
# Native Osmosis Asset on the osmosis-1 chain
cosmos:osmosis-1/slip44:118
# Native Ion Asset on the osmosis-1 chain
cosmos:osmosis-1/native:uion
# IBC Atom asset on the osmosis-1 chain
cosmos:osmosis-1/ibc:27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2Copyright
Copyright and related rights waived via CC0.
