Skip to content

feat(ows-signer): add Cardano chain support (CIP-1852, Ed25519-BIP32, bech32) #186

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

Open
adacapo21 wants to merge 3 commits into
base: main
Choose a base branch
from
Open

feat(ows-signer): add Cardano chain support (CIP-1852, Ed25519-BIP32, bech32) #186

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
cb92a34
feat(ows-signer): add Cardano chain support (CIP-1852, Ed25519-BIP32,…
adacapo21 Apr 4, 2026
899ae8e
feat(ows-lib): add Cardano broadcast support via Koios API
adacapo21 Apr 4, 2026
0cf1b8b
fix(config): update default rpc count for cardano chains
adacapo21 Apr 15, 2026
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
61 changes: 61 additions & 0 deletions ows/Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

54 changes: 52 additions & 2 deletions ows/crates/ows-core/src/chain.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,11 @@ pub enum ChainType {
Sui,
Xrpl,
Nano,
Cardano,
}

/// All supported chain families, used for universal wallet derivation.
pub const ALL_CHAIN_TYPES: [ChainType; 10] = [
pub const ALL_CHAIN_TYPES: [ChainType; 11] = [
ChainType::Evm,
ChainType::Solana,
ChainType::Bitcoin,
Expand All @@ -31,6 +32,7 @@ pub const ALL_CHAIN_TYPES: [ChainType; 10] = [
ChainType::Sui,
ChainType::Xrpl,
ChainType::Nano,
ChainType::Cardano,
];

/// A specific chain (e.g. "ethereum", "arbitrum") with its family type and CAIP-2 ID.
Expand Down Expand Up @@ -190,6 +192,21 @@ pub const KNOWN_CHAINS: &[Chain] = &[
chain_type: ChainType::Evm,
chain_id: "eip155:999",
},
Chain {
name: "cardano",
chain_type: ChainType::Cardano,
chain_id: "cardano:mainnet",
},
Chain {
name: "cardano-preprod",
chain_type: ChainType::Cardano,
chain_id: "cardano:preprod",
},
Chain {
name: "cardano-preview",
chain_type: ChainType::Cardano,
chain_id: "cardano:preview",
},
];

/// Parse a chain string into a `Chain`. Accepts:
Expand Down Expand Up @@ -254,6 +271,7 @@ pub fn parse_chain(s: &str) -> Result<Chain, String> {
EVM: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, plasma, etherlink\n \
Solana: solana\n \
Bitcoin: bitcoin\n \
Cardano: cardano, cardano-preprod, cardano-preview\n \
Other: cosmos, tron, ton, sui, filecoin, spark, xrpl, nano\n\n\
Or use a CAIP-2 ID (eip155:8453) or bare EVM chain ID (8453)"
))
Expand All @@ -279,6 +297,7 @@ impl ChainType {
ChainType::Sui => "sui",
ChainType::Xrpl => "xrpl",
ChainType::Nano => "nano",
ChainType::Cardano => "cardano",
}
}

Expand All @@ -296,6 +315,7 @@ impl ChainType {
ChainType::Sui => 784,
ChainType::Xrpl => 144,
ChainType::Nano => 165,
ChainType::Cardano => 1815,
}
}

Expand All @@ -313,6 +333,7 @@ impl ChainType {
"sui" => Some(ChainType::Sui),
"xrpl" => Some(ChainType::Xrpl),
"nano" => Some(ChainType::Nano),
"cardano" => Some(ChainType::Cardano),
_ => None,
}
}
Expand All @@ -332,6 +353,7 @@ impl fmt::Display for ChainType {
ChainType::Sui => "sui",
ChainType::Xrpl => "xrpl",
ChainType::Nano => "nano",
ChainType::Cardano => "cardano",
};
write!(f, "{}", s)
}
Expand All @@ -353,6 +375,7 @@ impl FromStr for ChainType {
"sui" => Ok(ChainType::Sui),
"xrpl" => Ok(ChainType::Xrpl),
"nano" => Ok(ChainType::Nano),
"cardano" => Ok(ChainType::Cardano),
_ => Err(format!("unknown chain type: {}", s)),
}
}
Expand Down Expand Up @@ -385,6 +408,7 @@ mod tests {
(ChainType::Sui, "\"sui\""),
(ChainType::Xrpl, "\"xrpl\""),
(ChainType::Nano, "\"nano\""),
(ChainType::Cardano, "\"cardano\""),
] {
let json = serde_json::to_string(&chain).unwrap();
assert_eq!(json, expected);
Expand All @@ -406,6 +430,7 @@ mod tests {
assert_eq!(ChainType::Sui.namespace(), "sui");
assert_eq!(ChainType::Xrpl.namespace(), "xrpl");
assert_eq!(ChainType::Nano.namespace(), "nano");
assert_eq!(ChainType::Cardano.namespace(), "cardano");
}

#[test]
Expand All @@ -421,6 +446,7 @@ mod tests {
assert_eq!(ChainType::Sui.default_coin_type(), 784);
assert_eq!(ChainType::Xrpl.default_coin_type(), 144);
assert_eq!(ChainType::Nano.default_coin_type(), 165);
assert_eq!(ChainType::Cardano.default_coin_type(), 1815);
}

#[test]
Expand All @@ -439,6 +465,10 @@ mod tests {
assert_eq!(ChainType::from_namespace("sui"), Some(ChainType::Sui));
assert_eq!(ChainType::from_namespace("xrpl"), Some(ChainType::Xrpl));
assert_eq!(ChainType::from_namespace("nano"), Some(ChainType::Nano));
assert_eq!(
ChainType::from_namespace("cardano"),
Some(ChainType::Cardano)
);
assert_eq!(ChainType::from_namespace("unknown"), None);
}

Expand Down Expand Up @@ -580,6 +610,26 @@ mod tests {
assert_eq!(chain.chain_id, "eip155:99999");
}

#[test]
fn test_parse_chain_cardano() {
let chain = parse_chain("cardano").unwrap();
assert_eq!(chain.chain_type, ChainType::Cardano);
assert_eq!(chain.chain_id, "cardano:mainnet");

let preprod = parse_chain("cardano-preprod").unwrap();
assert_eq!(preprod.chain_type, ChainType::Cardano);
assert_eq!(preprod.chain_id, "cardano:preprod");

let preview = parse_chain("cardano-preview").unwrap();
assert_eq!(preview.chain_type, ChainType::Cardano);
assert_eq!(preview.chain_id, "cardano:preview");

// CAIP-2 IDs also accepted directly
let via_caip2 = parse_chain("cardano:mainnet").unwrap();
assert_eq!(via_caip2.chain_type, ChainType::Cardano);
assert_eq!(via_caip2.chain_id, "cardano:mainnet");
}

#[test]
fn test_parse_chain_unknown() {
assert!(parse_chain("unknown_chain").is_err());
Expand Down Expand Up @@ -619,7 +669,7 @@ mod tests {

#[test]
fn test_all_chain_types() {
assert_eq!(ALL_CHAIN_TYPES.len(), 10);
assert_eq!(ALL_CHAIN_TYPES.len(), 11);
}

#[test]
Expand Down
26 changes: 25 additions & 1 deletion ows/crates/ows-core/src/config.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,18 @@ impl Config {
"eip155:999".into(),
"https://rpc.hyperliquid.xyz/evm".into(),
);
rpc.insert(
"cardano:mainnet".into(),
"https://api.koios.rest/api/v1".into(),
);
rpc.insert(
"cardano:preprod".into(),
"https://preprod.koios.rest/api/v1".into(),
);
rpc.insert(
"cardano:preview".into(),
"https://preview.koios.rest/api/v1".into(),
);
rpc
}
}
Expand Down Expand Up @@ -222,6 +234,18 @@ mod tests {
config.rpc_url("eip155:999"),
Some("https://rpc.hyperliquid.xyz/evm")
);
assert_eq!(
config.rpc_url("cardano:mainnet"),
Some("https://api.koios.rest/api/v1")
);
assert_eq!(
config.rpc_url("cardano:preprod"),
Some("https://preprod.koios.rest/api/v1")
);
assert_eq!(
config.rpc_url("cardano:preview"),
Some("https://preview.koios.rest/api/v1")
);
}

#[test]
Expand Down Expand Up @@ -264,7 +288,7 @@ mod tests {
fn test_load_or_default_nonexistent() {
let config = Config::load_or_default_from(std::path::Path::new("/nonexistent/config.json"));
// Should have all default RPCs
assert_eq!(config.rpc.len(), 21);
assert_eq!(config.rpc.len(), 24);
assert_eq!(config.rpc_url("eip155:1"), Some("https://eth.llamarpc.com"));
}

Expand Down
Loading