Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

added a caip24 proposal for cosmos caip19 asset namespace to make cos… #111

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

added a caip24 proposal for cosmos caip19 asset namespace to make cos… #111

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 72 additions & 0 deletions CAIPs/caip-24.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
---
caip: 24
title: Asset Reference for the Cosmos Asset Namespace
author: Theobold Frazier
discussions-to: https://github.com/shapeshift/CAIPs/issues/1
status: Draft
type: Standard
created: 2020-02-14
updated: 2020-02-14
requires: 19
---

## 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](https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-19.md).

## 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:27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2
```

## Copyright

Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).